쓰레기 은행 관리를 위한 디지털 웹 애플리케이션
Faizpi/bank-sampah
GitHub쓰레기 수거 및 관리를 디지털화한 웹 애플리케이션으로, 시민들이 폐기물을 기부하고 적립된 포인트를 체계적으로 관리할 수 있게 합니다.
- 시민 외에도 담당자, 재무 관리자 등 다양한 역할을 지원하며, 폐기물 기부부터 포인트 적립 및 인출까지 모든 거래 과정을 투명하게 기록하고 추적합니다.
- 현장 작업자가 스마트폰으로 쉽게 사용할 수 있도록 모바일 환경에 최적화되어 있어, 지역 사회의 폐기물 순환 시스템을 효율적으로 개선하는 데 기여할 전망입니다.
- 모든 거래 과정이 상세히 기록되고 추적 가능하며, 사용자 역할(시민/담당자/관리자)별 권한 분리가 명확하게 이루어진 것이 특징입니다.
Bank Sampah Digital은 쓰레기 은행(bank sampah)의 운영을 관리하기 위해 개발된 웹 애플리케이션입니다. 이 앱을 통해 시민들은 쓰레기를 기부하고, 적립된 잔액을 모니터링하며, 수거 요청 및 잔액 인출 신청 등의 활동이 가능합니다. 관리자 측면에서는 입금 기록을 작성하고, 거래를 검증하며, 상세한 보고서를 확인할 수 있습니다. 특히 현장 작업자가 스마트폰으로 사용하기 편리하도록 모바일 우선(mobile-first) 방식으로 설계되었습니다.
애플리케이션은 사용자 역할에 따라 기능이 명확히 분리되어 있습니다. 시민(Warga)은 계정 등록, 거래 내역 확인, QR 카드를 이용한 쓰레기 기부 및 포인트 교환 등을 할 수 있으며, 담당자(Petugas)는 쓰레기를 기록하고 수거 업무를 처리합니다. 재무 관리자(Bendahara)는 잔액 인출을 검증하고 보고서를 작성하며, 관리자(Admin)는 사용자 데이터와 지역 정보를 전반적으로 관리할 수 있습니다.
이 시스템은 Laravel과 MySQL 기반으로 구축되었으며, 로컬 환경에서 실행하는 과정이 안내되어 있습니다. 사용자는 Git 클론 후 Composer 설치, 환경 변수 설정(`cp .env.example .env`), 그리고 마이그레이션 및 시딩 과정을 거쳐 애플리케이션을 구동해야 합니다. 또한 `.env` 파일을 수정하여 로컬 데이터베이스를 지정하고 가상 호스트를 `public` 폴더로 연결하는 작업이 필요합니다.