19fec0933b
- 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
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