垃圾分类也能“存钱取款”？这款开源系统让社区废品回收像银行一样规范高效

你是否见过这样的场景：社区老人把分好类的塑料瓶、纸板、旧衣服攒了几周，却只能低价卖给流动收废品小贩，既没记录、也没定价依据，更无法追溯收益？Bank Sampah Digital（数字垃圾银行）正是为解决这一痛点而生的国产开源系统——它不是简单的数据录入工具，而是一套覆盖居民端、巡回收运员、财务人员和管理员的全流程数字化回收管理平台。项目以“移动优先”设计，真正让基层环保工作者在田间地头用手机就能完成扫码登记、现场称重、实时入账，让每公斤可回收物都变成居民账户里可查、可提、可兑换的“绿色资产”。

核心功能

居民端“扫码开户+余额可视”：居民注册后生成专属带二维码的电子会员卡，扫码即可查看当前积分余额、历史交易明细（含日期、品类、重量、单价、到账金额），彻底告别手写台账易丢失、难核对的问题。
一键发起上门回收预约：居民可随时在线提交回收申请，注明地址、品类、预估重量及期望时间；系统自动推送至对应片区巡回收运员，支持接单、改期、完成确认闭环，大幅提升响应效率与服务体验。
实物兑换与现金提现双通道：居民不仅能将账户余额直接兑换成米面油等生活物资（后台可配置“10元=1kg大米”等规则），还能申请提现，由财务人员审核后打款并上传凭证，资金流全程留痕、可审计。
一线人员移动端现场作业：收运员使用手机访问系统，扫描居民二维码→选择回收品类→输入实测重量→拍照留存→一键提交，所有操作离线缓存、联网即同步，无须额外安装App，适配安卓/iOS浏览器。
多层级权限精细化管理：区分居民、收运员、出纳（Bendahara）、管理员四类角色，权限颗粒度细至“仅能查看本RT辖区数据”“仅可审核本RW提现申请”，避免越权操作，满足街道办、合作社、NGO等组织治理需求。
动态价格体系与区域化配置：管理员可按品类（如PET瓶、瓦楞纸、铝罐）、按时间段（如季度调价）、按区域（如城区/乡村不同收购价）灵活设置回收单价，价格变动自动生效于新交易，历史订单仍保留原价，保障公平性。
免登录公众门户：访客无需注册即可浏览公开信息——包括最新回收价格表、巡回服务日历（标注哪天到哪个村委）、环保公告、月度回收总量统计图，增强社区透明度与参与感。
全链路可追溯审计日志：每一笔交易均绑定操作人、设备IP、时间戳、前后状态快照（如称重前/后照片），支持按居民ID、日期、品类、操作类型多维检索，满足财政补贴申报、第三方审计等合规要求。

技术亮点

Laravel框架构建高可靠性后端：采用成熟稳定的PHP生态代表Laravel 9+，内置Eloquent ORM、队列任务、事件广播等能力，确保高并发下交易数据一致性；迁移命令（php artisan migrate --seed）一键初始化完整业务数据，降低部署门槛。
真正“移动优先”的PWA级体验：未强制依赖原生App，而是通过响应式布局+Service Worker缓存，使收运员在弱网甚至临时断网环境下仍可流畅录入、暂存数据，网络恢复后自动同步，完美适配农村信号不稳定场景。
零配置本地开发环境：官方明确推荐Laragon作为首选本地运行方案（Windows用户友好），5行命令即可完成克隆、依赖安装、密钥生成、数据库填充与前端构建，比Docker或手动配置AMP环境更轻量、更适合基层IT人员快速上手。
模块化业务逻辑设计：代码按角色职责清晰分层（如app/Http/Controllers/Resident/、app/Http/Controllers/Officer/），各模块解耦，便于社区开发者按需定制——例如仅启用居民端+价格查询，屏蔽提现功能，适配学校环保社团轻量场景。

适合哪些人用

本系统专为中国基层环保实践者打造，尤其适合三类主体：
① 社区/村委会工作人员：可替代Excel手工记账，解决“谁家交了多少、该付多少、何时该去收”全靠脑子记的混乱现状；
② 社会组织与环保NGO：如深圳“零废弃联盟”在城中村推广时，用该系统为200+低收入家庭建立回收账户，每月自动生成兑换清单，减少人工核算误差；
③ 高校环境专业师生：项目已作为印尼某高校毕业设计落地案例，国内高校可基于其二次开发——例如接入智能称重硬件API、增加碳积分换算模块，成为课程实践优质基座。

快速上手

推荐Windows用户使用Laragon（一键集成Nginx+MySQL+PHP），Mac/Linux用户可用Laravel Sail。关键步骤如下：

执行命令：git clone https://github.com/Faizpi/bank-sampah.git && cd bank-sampah && composer install
复制环境配置：cp .env.example .env，修改DB_DATABASE、DB_USERNAME、DB_PASSWORD为你本地MySQL账号
生成密钥并初始化数据库：php artisan key:generate && php artisan migrate --seed
构建前端资源：npm install && npm run build
在Laragon中添加虚拟主机bank-sampah-skripsi.test，根目录指向public/文件夹

访问 http://bank-sampah-skripsi.test 即可进入系统，使用README中提供的默认账号（密码统一为 Banten123）体验全部角色功能。

同类对比 / 注意事项

相比国内常见的“垃圾分类小程序”（如住建部试点平台），Bank Sampah Digital更聚焦经济激励闭环——不仅记录分类行为，更打通“称重→计价→入账→兑换→提现”全链条；而对比国外开源项目（如WasteNot），它深度适配中国基层治理结构（RT/RW/村委层级）、人民币结算习惯及微信生态兼容性（QR码即微信可扫）。
需注意：项目暂未内置微信支付/支付宝对接，提现需人工打款；数据库默认使用MySQL，若需迁移到PostgreSQL需自行调整迁移文件；首次部署后务必修改默认密码并禁用演示账号，生产环境建议启用HTTPS及IP白名单。