josh/BarangaySystem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3fbeb0ca770cb19aedef0d393981728de4645fb2
BarangaySystem/README.md
Jonathan Sykes 19fec0933b
Some checks failed
tests / PHP 8.2 (swoole-5.1.6) (push) Has been cancelled
Details
tests / PHP 8.3 (swoole-5.1.6) (push) Has been cancelled
Details
tests / PHP 8.4 (swoole-6.0) (push) Has been cancelled
Details
feat: Phase 1 bootstrap — adapt BukidBountyApp as BarangaySystem 
- Replace UserTypes with barangay roles (super_admin, punong_barangay,
  kagawad, secretary, treasurer, sk_chairperson, sk_councilor, tanod,
  bhw, daycare_worker, staff, resident, audit)
- Replace UserActions with barangay-specific permissions (residents,
  households, blotters, documents, fee payments, projects, budget)
- Replace modules config with barangay modules (residents, households,
  blotters, documents, certificates, projects, budget, announcements,
  accounting, chapters, qr_payment, subscriptions, landing_pages)
- Update app name, seeders, and landing page to barangay defaults
- Add new enums: DocumentStatus, BlotterStatus, PaymentStatus
- Add 6 new migrations: residents, households, blotters, document
  requests, projects, budget
- Add RequestTypeSeeder with default certificate fee schedule
- Update README with BarangaySystem stack, roles, and remotes
2026-06-06 18:47:20 +08:00

2.0 KiB
Raw Blame History

BarangaySystem

Barangay Management & Governance Platform built on Hypervel (Laravel-compatible on Hyperf/Swoole) + Vue 3 SPA.

Stack

Layer Technology
Backend Hypervel (PHP 8.x, Hyperf/Swoole)
Frontend Vue 3 SPA + Pinia
Database MySQL
Cache/Session Redis
Auth JWT (lcobucci) + Session dual guard
File Storage Multi-disk (local/S3) with CDN pipeline
Queue Redis-backed

Core Modules

  • Resident & Household Management — resident profiles, household registry
  • Document/Certificate Requests — Clearance, Residency, Indigency, Good Moral, Business Clearance + QR PH payment
  • Blotter / Incident System — filing, hearings, resolution tracking
  • Barangay Projects — infrastructure, livelihood, health, education projects
  • Budget & Finance — income/expense recording, fiscal year reports
  • Geography Hierarchy — Region → Province → City/Municipality → Barangay → Purok
  • QR PH Payment — InstaPay/QRPH for document fees (GCash, Maya, and all major banks)
  • Announcements — barangay bulletins
  • Admin Console — system settings, branding, module toggles, user management, logs, backups
  • Accounting — chart of accounts, journal entries, financial reports

User Roles

Role Description
super_admin System owner / platform administrator
punong_barangay Barangay Captain
kagawad Barangay Councilor
secretary Barangay Secretary
treasurer Barangay Treasurer
sk_chairperson SK Chairperson
sk_councilor SK Councilor
tanod Barangay Tanod
bhw Barangay Health Worker
daycare_worker Daycare Worker
staff Administrative Staff
resident Registered Resident
audit Internal Auditor

Git Remotes

primary   ssh://git@git.hesed.sbs:6611/BarangaySystem
origin    ssh://git@git2.hesed.sbs:6612/josh/BarangaySystem.git

Setup

cp .env.example .env
composer install
npm install
php artisan migrate --seed
npm run build