← Back
Faizpi

Faizpi/bank-sampah

View on GitHub ↗
Stars
457
Forks
1
Watchers
457
Open issues
0
Contributors
1
Language
PHP
License
—
Default branch
main
Created Sep 11, 2026Updated Sep 13, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Bank Sampah Digital

Bank Sampah Digital adalah aplikasi web untuk mengelola bank sampah. Warga bisa menabung sampah, memantau saldo, mengajukan penjemputan, dan mencairkan saldo. Pengelola bisa mencatat setoran, memverifikasi transaksi, dan melihat laporan.

Aplikasi ini dibuat mobile-first, jadi nyaman dipakai lewat HP saat petugas berada di lapangan.

Siapa saja penggunanya

Warga — mendaftar akun, melihat saldo dan riwayat transaksi, mengajukan penjemputan sampah, mengajukan pencairan saldo, memakai kartu nasabah ber-QR, dan menukar saldo dengan paket sembako.

Petugas — mencari nasabah, mencatat setoran sampah, dan menangani tugas penjemputan.

Bendahara — memverifikasi dan mencatat pencairan saldo, mengunggah bukti pembayaran, serta menyusun laporan.

Admin — mengelola data warga dan pengguna, wilayah (dusun, RW, RT), jenis sampah dan harganya, pengumuman, program, hingga audit dan rekonsiliasi.

Pengunjung — tanpa perlu masuk, siapa pun bisa melihat katalog sampah, daftar harga, pengumuman, dan statistik.

Alur singkat

  1. Warga menyetor sampah yang sudah dipilah.
  2. Petugas mencatat jenis, kondisi, dan berat sampah, lalu transaksi disimpan sebagai bukti.
  3. Saldo warga bertambah sesuai harga yang berlaku saat itu.
  4. Warga bisa mengajukan penjemputan atau mencairkan saldo kapan saja.

Setiap transaksi tercatat rapi dan bisa ditelusuri kembali.

Menjalankan di komputer sendiri

Aplikasi ini memakai Laravel dan MySQL, dan paling mudah dijalankan lewat Laragon.

git clone https://github.com/Faizpi/bank-sampah.git
cd bank-sampah
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm install
npm run build

Atur .env agar menunjuk ke database lokal, lalu arahkan virtual host ke folder public. Aplikasi akan terbuka di:

http://bank-sampah-skripsi.test

Akun percobaan

Saat mode demo lokal aktif (APP_DEMO_MODE), tersedia akun contoh untuk mencoba semua peran. Seluruh akun demo memakai kata sandi yang sama:

Banten123

Kata sandi ini hanya berlaku untuk data demo lokal. Bootstrap produksi (ProductionBootstrapSeeder) tidak memakai kata sandi ini: isi APP_INITIAL_ADMIN_PASSWORD (minimal 12 karakter) di environment privat, dan akun yang sudah ada tidak pernah ditimpa.