How chis132060/barangay_ai works
Smart Barangay is a resident-services platform with an administrative portal, resident PWA, FastAPI backend, and AI-assisted knowledge services. Residents and staff use the web experiences to access requests, records, announcements, certificates, and assistance; the backend handles API workflows and connects to shared data and AI capabilities. The graph preserves the documented RAG, memory, and provider stages, plus administration and communication features. Some frontend-to-backend and storage links are shown from README documentation; unsampled implementation details are not inferred.
Main entry points: (dashboard)/layout.tsx Admin Portal · main.py FastAPI Backend · orchestrator.py RAG Orchestrator · (app)/layout.tsx Resident PWA
Components 22
Administration
- Admin Portal
apps/admin-portal/app/(dashboard)/layout.tsx - Resident Records
apps/admin-portal/app/(dashboard)/residents/actions.ts - Roles & Access
apps/admin-portal/app/(dashboard)/administration/rbac-actions.ts - Business Services
apps/admin-portal/app/(dashboard)/business/actions.ts - Communications
apps/admin-portal/app/(dashboard)/communication/actions.ts - Documents & Requests
apps/admin-portal/app/(dashboard)/documents/actions.ts
Resident Services
- Resident PWA
apps/resident-pwa/app/(app)/layout.tsx - Service Requests
apps/resident-pwa/app/(app)/requests/actions.ts - Chat Interface
apps/resident-pwa/app/api/chat/route.ts
Backend API
- FastAPI Backend
apps/api/main.py - RAG Endpoints
apps/api/routers/rag_router.py - GraphQL API
apps/api/graphql_api/schema.py
AI Knowledge Services
- RAG Orchestrator
apps/api/services/orchestrator.py - Hybrid Retrieval
apps/api/services/ai/retrieval/hybrid_search.py - Conversation Memory
apps/api/services/memory/memory_service.py - AI Provider Manager
apps/api/services/ai/manager.py - AI Policy Engine
apps/api/services/ai/policy/policy_engine.py
Platform Integrations
- Supabase Data
apps/api/services/supabase_service.py - Knowledge Index
- Firebase Notifications
Other components
- Barangay Staff
- Residents
Connections 23
- Residents → Resident PWA: use
README.md - Barangay Staff → Admin Portal: use
README.md - Resident PWA → FastAPI Backend: access
README.md - Admin Portal → FastAPI Backend: access
README.md - Resident PWA → Service Requests: submit requests
README.md - Resident PWA → Chat Interface: ask questions
README.md - Admin Portal → Resident Records: manage records
README.md - Admin Portal → Roles & Access: manage access
- Admin Portal → Business Services: manage services
README.md - Admin Portal → Communications: manage announcements
README.md - Admin Portal → Documents & Requests: process certificates
README.md - FastAPI Backend → RAG Endpoints: mounts routes
apps/api/main.py - FastAPI Backend → GraphQL API: mounts schema
apps/api/main.py - RAG Endpoints → RAG Orchestrator: invoke
apps/api/routers/rag_router.py - RAG Endpoints → Supabase Data: audit via service
apps/api/routers/rag_router.py - RAG Orchestrator → Hybrid Retrieval: retrieve context
apps/api/services/orchestrator.py - RAG Orchestrator → Conversation Memory: retrieve context
apps/api/services/orchestrator.py - RAG Orchestrator → AI Provider Manager: generate responses
apps/api/services/orchestrator.py - RAG Orchestrator → Supabase Data: read/write data
apps/api/services/orchestrator.py - FastAPI Backend → Supabase Data: use shared data
README.md - FastAPI Backend → Knowledge Index: use knowledge index
README.md - FastAPI Backend → Firebase Notifications: send notifications
README.md - AI Provider Manager → AI Policy Engine: policy gate