数字垃圾银行（Bank Sampah Digital）

Bank Sampah Digital 是一款用于管理垃圾银行（bank sampah）的 Web 应用。居民可以存入垃圾、查看余额、申请上门回收以及提取余额。管理人员可以记录存入、核验交易并查看报表。

该应用采用移动优先（mobile-first）设计，方便工作人员在外场作业时通过手机舒适使用。

用户有哪些

居民 — 注册账户、查看余额和交易记录、申请上门回收垃圾、申请余额提现、使用带二维码的会员卡，以及用余额兑换基本生活物资包（sembako）。

工作人员 — 查找客户、记录垃圾存入、处理上门回收任务，并在流动服务中办理兑换。

出纳 — 核验并记录余额提现、上传付款凭证，以及编制报表。

管理员 — 管理居民和用户数据、区域（dusun、RW、RT）、垃圾类型及其价格、公告、项目，直至审计与对账。

访客 — 无需登录，任何人都可以查看垃圾目录、价格表、流动服务时间表、公告和统计数据。

简要流程

1. 居民存入已分类的垃圾。
2. 工作人员记录垃圾的类型、状况和重量，交易将被保存为凭证。
3. 居民余额按当时生效的价格相应增加。
4. 居民可以随时申请上门回收或提取余额。

每笔交易都被完整记录，且可追溯。

在本地电脑上运行

该应用使用 Laravel 和 MySQL，最简单的运行方式是通过 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

配置 .env 指向本地数据库，然后将虚拟主机指向 public 文件夹。应用将在以下地址打开：

http://bank-sampah-skripsi.test

测试账户

初始数据加载后，提供示例账户用于试用所有角色。所有账户使用相同密码：

Banten123

正式使用前请先更换此密码。