fbb7e3ff37
Complete adaptation from BukidBountyApp to Philippine barangay governance: - Barangay models: Resident, Household, HouseholdMember, Blotter, BlotterHearing, DocumentRequest, RequestPayment, RequestType, BarangayProject, BarangayBudget - Controllers: ResidentController, HouseholdController, BlotterController, BlotterHearingController, DocumentRequestController, RequestTypeController, ProjectController, BudgetController, QRPHController, AdminConsoleController, UserController, FileController, ChapterController, LoginController - Vue pages: Home, ManageResidents, ResidentProfile, ManageHouseholds, ManageBlotters, BlotterDetail, RequestDocument, ManageDocumentRequests, DocumentRequestDetail, ManageRequestTypes, ManageProjects, BudgetLedger, AdminConsole - Barangay roles: PunongBarangay, Kagawad, Secretary, Treasurer, SK, Tanod, BHW, Staff, Resident - UserPermissions matrix rewritten with barangay-specific permission mappings - VueRouteMap replaced with barangay SPA routes - UserActions enum references corrected across all controllers - Removed all market/cooperative/POS/subscription code and models
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