
Aplikasi buku tabungan digital berbasis web untuk membantu pengelolaan bank sampah secara rapi, transparan, dan mudah digunakan. Petugas dapat mencatat setoran sampah maupun penarikan saldo dari komputer atau ponsel, sementara nasabah dapat memantau saldo, mutasi, serta kontribusi lingkungannya kapan saja.
Aplikasi buku tabungan digital berbasis web untuk membantu pengelolaan bank sampah secara rapi, transparan, dan mudah digunakan. Petugas dapat mencatat setoran sampah maupun penarikan saldo dari komputer atau ponsel, sementara nasabah dapat memantau saldo, mutasi, serta kontribusi lingkungannya kapan saja.
Dibangun dengan Astro 7 (SSR), Prisma 7, PostgreSQL, dan shadcn/ui — dapat dipasang gratis di Vercel + Neon maupun di VPS sendiri menggunakan Docker Compose. Seluruh identitas bank sampah (nama, kontak, warna tema, hingga jenjang penghargaan nasabah) bisa disesuaikan langsung dari halaman Pengaturan tanpa mengubah kode.
Source code: github.com/bozid95/app-bank-sampah
ALLOWED_DOMAINSUntuk mencoba aplikasi secara langsung, gunakan kredensial berikut: akses ke : https://app-bank-sampah.vercel.app
| Peran | Username | Password |
|---|---|---|
| Admin / Petugas | admin | admin-test |
| Nasabah | dodo | user-test |
Catatan: Jika Anda memasang aplikasi ini untuk penggunaan nyata, pastikan segera mengganti password bawaan demi keamanan data.
ClientRouter + prefetch), indikator progress bar & skeleton loading, serta pembaruan parsial (partial swap) khusus area tabel/daftar saat ganti bulan, pencarian, atau pindah halaman paginasi sehingga kartu profil dan form tetap stabil.1.500) dan koma untuk desimal; berat sampah mendukung titik maupun koma (1.5 atau 1,5 kg).Halaman utama admin merangkum total saldo seluruh nasabah, perkembangan jumlah nasabah, total sampah masuk, grafik arus kas 30 hari, komposisi sampah bulan berjalan, ringkasan transaksi terbaru, hingga estimasi emisi CO₂ yang berhasil dicegah bersama warga.

Seluruh halaman dan data terlindungi oleh login berbasis sesi. Pada halaman nasabah, petugas bisa mencari data dengan cepat, melihat profil lengkap beserta lencana level penghargaan, memantau saldo berjalan, dan membuka bukti tiap transaksi.




Menekan tombol Cetak di halaman Buku Tabungan (baik oleh petugas maupun nasabah) otomatis menghasilkan dokumen berformat rekening koran ukuran A4 lengkap dengan kop organisasi, saldo awal & akhir periode saat filter bulan dipilih, ringkasan saldo, nomor bukti, tabel mutasi kronologis, catatan kaki, dan ruang pengesahan petugas.
Pada halaman Riwayat Transaksi, admin juga dapat memilih bulan dan mencetak Laporan Mutasi Global untuk seluruh nasabah, dilengkapi ringkasan arus kas, rekap berat & nilai per jenis sampah, serta kolom pengesahan Bendahara dan Ketua.





Pengelola dapat mengatur akun akses petugas maupun nasabah, memindahkan data dari buku catatan manual melalui file Excel (.xlsx), serta menyesuaikan seluruh identitas dan aturan aplikasi melalui 3 tab pengaturan.





Dirancang nyaman dibuka dari layar ponsel dan dapat dipasang ke layar utama (PWA). Nasabah dapat menyembunyikan saldo, menyalin nomor rekening dengan sekali ketuk, memantau progres level penghargaan beserta dampak lingkungannya, serta mengecek harga sampah yang berlaku.



Seluruh menu operasional petugas juga tersedia dalam tata letak responsif dengan navigasi bawah agar pencatatan tetap praktis dilakukan langsung di lokasi penimbangan.






-pooler) → DATABASE_URL-pooler) → DATABASE_URL_UNPOOLEDcp .env.example .env # sesuaikan DATABASE_URL, DATABASE_URL_UNPOOLED, ADMIN_PASSWORD
npm install
npx prisma migrate deploy # atau `npm run db:migrate` saat pengembangan
npm run db:seed # membuat akun admin awal & contoh jenis sampah
npm run dev # buka http://localhost:4321
DATABASE_URL dan DATABASE_URL_UNPOOLED akan terisi otomatis, atau isi manual di Settings → Environment Variables).vercel-build (prisma migrate deploy && astro build), sehingga skema database otomatis diperbarui setiap deploy..env yang mengarah ke database produksi:npm run db:seed
Catatan untuk Vercel:
vercel.json sudah mengatur region fungsi ke Singapore (sin1) agar dekat dengan Indonesia dan satu region dengan database Neon Singapore.prisma.config.ts otomatis mengarahkan migrasi ke koneksi Direct Neon (tanpa -pooler), dan vercel-build menonaktifkan advisory lock agar migrasi berjalan mulus di Vercel.*.vercel.app terdaftar otomatis di allowedDomains. Jika memakai domain sendiri, tambahkan ALLOWED_DOMAINS="banksampah.desaku.id" di Environment Variables lalu redeploy.secure tanpa perlu mengisi COOKIE_SECURE.Untuk menjalankan aplikasi sekaligus PostgreSQL di server/VPS sendiri:
.env.example menjadi .env, lalu isi bagian 1, 2, dan 3A (ADMIN_PASSWORD, ALLOWED_DOMAINS, POSTGRES_PASSWORD, APP_PORT):
ALLOWED_DOMAINS="banksampah.desaku.id" dan biarkan COOKIE_SECURE="".ALLOWED_DOMAINS="IP_VPS_ANDA" dan COOKIE_SECURE="false".app menyala):cp .env.example .env
nano .env
docker compose up -d --build
docker compose exec app npm run db:seed
http://IP_VPS:4321 (atau arahkan reverse proxy ke 127.0.0.1:4321). Data PostgreSQL tersimpan persisten pada Docker volume pgdata.Masuk sebagai admin lalu buka menu Pengaturan. Semua perubahan tersimpan di database (AppConfig) sehingga langsung aktif tanpa perlu build ulang:
| Tab | Yang Bisa Diatur | Dampak di Aplikasi |
|---|---|---|
| Umum | Nama aplikasi, nama organisasi, slogan, alamat, telepon, email, catatan kaki struk | Judul halaman, sidebar, halaman login, manifest PWA, kop & kaki struk / rekening koran |
| Tampilan & Aturan | Mode tema aplikasi (Terang/Gelap/Sistem), 8 preset skema warna & kustom, live preview kartu, awalan no. rekening, zona waktu (WIB/WITA/WIT), batas peringatan berat setor (kg) & penarikan (Rp) | Seluruh tema tampilan, kartu, sidebar, warna PWA, format waktu, serta peringatan di lembar konfirmasi |
| Level Penghargaan | Nama gelar, batas minimal berat kumulatif (kg), pesan apresiasi (Level 1–5) | Beranda nasabah (/me) & lencana profil di buku tabungan |
Menu Impor & Ekspor menyediakan template .xlsx (terdiri dari sheet Data dan Petunjuk) untuk mempermudah migrasi data lama maupun pencadangan berkala:
Urutan impor yang disarankan: jenis sampah → nasabah → pengguna → transaksi. Untuk memindahkan saldo awal dari buku manual, masukkan sebagai transaksi SETOR tanpa jenis sampah (isi kolom Jumlah).
Aturan impor:
ALLOWED_DOMAINSAstro 7 memverifikasi header Host terhadap daftar security.allowedDomains. Jika domain atau IP yang digunakan untuk membuka aplikasi belum didaftarkan, seluruh pengiriman form (POST) akan ditolak dengan status 403. Nilai ini dibaca pada saat proses build, jadi pastikan melakukan build/deploy ulang setiap kali mengubahnya.
Dockerfile # build multi-stage untuk deploy Docker / VPS
docker-compose.yml # layanan app + PostgreSQL untuk VPS sendiri
vercel.json # konfigurasi region Vercel Functions (Singapore / sin1)
prisma.config.ts # konfigurasi Prisma CLI (URL migrasi Direct Neon & seed)
prisma/schema.prisma # model: User, Session, LoginAttempt, Customer, WasteType, Transaction, DepositItem, AppConfig
prisma/seed.ts # seed admin awal & contoh jenis sampah
src/middleware.ts # autentikasi, pembatasan peran, header keamanan & muat AppConfig
src/lib/ # logika server (prisma, auth, config, format, period, ecoImpact, transactions, dataTransfer, spreadsheet, pagination)
src/components/ui/ # komponen dasar shadcn/ui
src/components/app/ # shell desktop, CustomerPicker, tombol tautan
src/components/views/ # tampilan halaman desktop, form, struk, rekening koran (nasabah & global), kartu dampak lingkungan
src/components/mobile/ # komponen tampilan ponsel
src/pages/ # seluruh halaman & endpoint Astro (admin, nasabah /me, menu, manifest PWA)
docs/screenshots/ # tangkapan layar dokumentasi
httpOnly + SameSite=Lax (hanya hash SHA-256 disimpan di DB), kata sandi memakai bcrypt (cost 12, maks. 72 karakter), serta pembatas percobaan login gagal tersimpan di database (LoginAttempt).checkOrigin), header keamanan HTTP (X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy), serta sanitasi sel untuk mencegah formula injection saat ekspor Excel.prisma.$transaction, harga per kg disalin ke tiap DepositItem, dan koreksi transaksi memakai pencatatan pembalik (void + reversal) sehingga jejak audit tetap utuh.client:visible dan pencarian nasabah client:load), dipadukan dengan Astro ClientRouter, prefetch, skeleton loading, serta partial DOM swap untuk filter, pencarian, dan paginasi.Dirilis di bawah lisensi MIT.