How kev-003/bataeno-pass-barangay works
Bataeño Pass is a barangay identity and services platform: residents request certificates and manage household information; barangay officials review requests, enforce signing authority, and issue documents; municipal administrators oversee barangay records. The graph includes the documented governance, notification, lineage, NFC/QR, and queued-PDF capabilities. Source excerpts directly establish only selected controller and client notification behavior; other subsystem relationships are shown only where the README documents them.
Main entry points: DocumentController.php Document requests · Livewire Resident portal · ProcessDocumentApproval.php PDF generation job · DocumentTransaction.php Document records
Components 23
Resident services
- Resident portal
app/Livewire - Family lineage
resources/js/components/LineageD3.js
Official operations
- NFC and QR lookup
app/Livewire/Officials - Official panel
app/Filament/Official - Municipal oversight
app/Filament/CityAdmin
Governance and registry
- Terms and delegation
app/Models/Delegation.php - Household registry
app/Models/Household.php
Document services
- Document requests
app/Http/Controllers/DocumentController.php - Approval service
app/Services/DocumentApprovalService.php - Signing authority
app/Services/GovernanceService.php - PDF generation job
app/Jobs/ProcessDocumentApproval.php - Document generation
app/Listeners/GenerateDocument.php - Document records
app/Models/DocumentTransaction.php
Platform infrastructure
- Request notifications
app/Notifications/DocumentRequestReceived.php - Live notifications
resources/js/app.js - Bataeño identity
app/Services/BataenoService.php
Other components
- Resident
- Barangay official
- City admin
- Bataeño Pass
- Application database
- Laravel queue
- Reverb WebSockets
Connections 22
- Resident → Resident portal: uses
- Resident portal → Document requests: submits requests
- Resident portal → Family lineage: views lineage
- Barangay official → Official panel: handles requests
- Barangay official → NFC and QR lookup: looks up residents
- City admin → Municipal oversight: oversees records
- Official panel → Document requests: processes requests
- Document requests → Document records: creates or updates
- Document requests → Signing authority: checks authority
- Document requests → Approval service: requests approval
- Approval service → PDF generation job: dispatches after commit
- PDF generation job → Document generation: generates document
- Document generation → Document records: records issuance
- Document records → Application database: persists records
- Terms and delegation → Application database: stores terms
- Household registry → Application database: stores household data
- Document requests → Request notifications: notifies requesters
- Request notifications → Reverb WebSockets: broadcasts
- Reverb WebSockets → Live notifications: delivers events
- Bataeño identity → Bataeño Pass: authenticates and fetches profiles
- NFC and QR lookup → Bataeño identity: looks up identity
- PDF generation job → Laravel queue: runs asynchronously