How cavejoshua/barangay-eng-shill- works
Smart Barangay is a community and local-administration web application. Residents enter through the community portal to authenticate and access services; administrators use a separate dashboard to manage records and service requests. The backend routes API requests into domain modules, which use Supabase for persistence and supporting services for mail, image uploads, auditing, and security. The README is only the Vite template, so product capabilities are inferred from the source tree and sampled code; unsampled UI and domain internals limit certainty about their detailed interactions.
Main entry points: data.js API routes · Auditlog.js Audit logging · App.tsx Portal router · CommunityDashboard.tsx Community dashboard
Components 31
Web application
- Portal router
src/App.tsx - Community portal
src/components/UI/Community_GUI/Community.tsx - Community authentication
src/components/UI/Community_GUI/CommunityAuthentication.tsx - Community dashboard
src/components/UI/Community_GUI/CommunityDashboard.tsx - Community documents
src/components/UI/Community_GUI/CommunityDocument.tsx - Community incidents
src/components/UI/Community_GUI/CommunityIncident.tsx - Admin dashboard
src/components/buttons - Resident records UI
src/components/buttons/Resident_modal.tsx - Document engine
src/components/buttons/Tools/Document_tools/Document_Engine.ts - API client
src/components/UI/api.ts
API and governance
- HTTP server
server.js - API routes
data.js
Domain services
- Account management
Account_Management.js - Resident records
Residents_record.js - Official accounts
Officials.js - Official login
Officials_login.js - Resident login
Resident_login.js - Document requests
Document.js - Incident blotter
Blotter.js - Households
Household.js - Announcements
Announcement.js - Notifications
notification.js - Audit logging
Auditlog.js - Email delivery
Mailer.js - Image uploads
cloud.js
Security and operations
- Security regulator
Regulator.js - Intrusion detection
IDS.js - Intrusion prevention
IPS.js
Other components
- Resident
- Barangay staff
- Supabase
Connections 38
- Resident → Community portal: opens portal
- Barangay staff → Portal router: opens portal
src/App.tsx - Portal router → Community portal: renders
src/App.tsx - Portal router → Community dashboard: renders
src/App.tsx - Community portal → Community authentication: uses
- Community dashboard → Community documents: offers
- Community dashboard → Community incidents: offers
- Community dashboard → API client: requests data
- Resident records UI → API client: calls
src/components/buttons/Resident_modal.tsx - Document engine → Document requests: updates status
src/components/buttons/Tools/Document_tools/Document_Engine.ts - Portal router → API client: imports
src/App.tsx - HTTP server → API routes: mounts routes
server.js - HTTP server → Security regulator: starts pulse
server.js - API routes → Account management: dispatches to
data.js - API routes → Resident records: dispatches to
data.js - API routes → Official accounts: dispatches to
data.js - API routes → Official login: dispatches to
data.js - API routes → Resident login: dispatches to
data.js - API routes → Document requests: dispatches to
data.js - API routes → Incident blotter: dispatches to
data.js - API routes → Households: dispatches to
data.js - API routes → Announcements: dispatches to
data.js - API routes → Notifications: dispatches to
data.js - API routes → Image uploads: uploads images
data.js - API routes → Audit logging: records activity
data.js - API routes → Supabase: queries
data.js - Document requests → Audit logging: logs activity
Document.js - Document requests → Email delivery: sends notices
Document.js - Incident blotter → Audit logging: logs activity
Blotter.js - Incident blotter → Email delivery: sends notices
Blotter.js - Official accounts → Audit logging: logs activity
Officials.js - Official accounts → Email delivery: sends notices
Officials.js - Official login → Audit logging: logs activity
Officials_login.js - Resident login → Audit logging: logs activity
Resident_login.js - Resident records → Audit logging: logs activity
Residents_record.js - Households → Audit logging: logs activity
Household.js - Security regulator → Intrusion detection: scans requests
Regulator.js - Security regulator → Intrusion prevention: handles threats
Regulator.js