How suneetbafna83-ship-it/civicresolver works
CivicResolve supports citizen issue reporting and tracking alongside municipal, department-scoped dispatch. The main flow runs from the portal and report UI through server-side triage, then persists issues for citizen and admin workflows. The README also documents maps, authentication, resilient local storage, exports, localization, and repair-proof handling. Some UI and service links rely on README descriptions or SOURCE INDEX references rather than inspected call sites; unsampled internals are represented cautiously.
Main entry points: App.tsx Workspace Shell · triageService.ts Triage Orchestrator · issueRepository.ts Repository Facade · ReportIssueView.tsx Issue Reporting
Components 24
Civic Workspaces
- Workspace Shell
src/App.tsx - Issue Reporting
src/components/report/ReportIssueView.tsx - Triage Preview
src/components/report/TriagePreviewPanel.tsx - Issue Tracking
src/components/dashboard/TrackIssuesView.tsx - Admin Command Desk
src/components/admin/AdminDashboardView.tsx - Civic Map
src/components/map/CivicMap.tsx
Issue Triage
- Triage Client
src/lib/api/triageClient.ts - Triage Endpoint
api/triage.ts - Triage Orchestrator
api/_lib/triage/triageService.ts - Gemini Classifier
api/_lib/triage/geminiTriage.ts - Heuristic Fallback
api/_lib/triage/heuristicTriage.ts - Triage Cache
api/_lib/triage/triageCache.ts
Issue Operations
- Issue Validation
shared/schemas/issue.ts - Repository Facade
src/lib/repositories/issueRepository.ts - Hybrid Storage
src/lib/repositories/hybridIssueRepository.ts - Firestore Issues
src/lib/repositories/firestoreIssueRepository.ts - Local Issues
src/lib/repositories/localIssueRepository.ts
Identity and Platform
- Authentication Service
src/lib/auth/authService.ts - Receipts and Proof
src/lib/export/civicExport.ts - Localization
src/lib/i18n/translations.ts
Other components
- Citizen
- Municipal Staff
- Google Gemini
- Firebase
Connections 27
- Citizen → Workspace Shell: opens workspace
README.md - Municipal Staff → Workspace Shell: opens workspace
README.md - Workspace Shell → Issue Reporting: presents reporting
README.md - Issue Reporting → Civic Map: selects location
README.md - Issue Reporting → Triage Client: requests triage
README.md - Triage Client → Triage Endpoint: sends request
README.md - Triage Endpoint → Triage Orchestrator: dispatches triage
api/triage.ts - Triage Orchestrator → Gemini Classifier: runs classification
api/_lib/triage/triageService.ts - Triage Orchestrator → Heuristic Fallback: falls back
api/_lib/triage/triageService.ts - Triage Orchestrator → Triage Cache: checks cache
api/_lib/triage/triageService.ts - Gemini Classifier → Google Gemini: calls model
README.md - Triage Orchestrator → Triage Preview: returns result
- Issue Reporting → Repository Facade: submits issue
README.md - Repository Facade → Hybrid Storage: delegates storage
src/lib/repositories/hybridIssueRepository.ts - Hybrid Storage → Firestore Issues: uses cloud store
src/lib/repositories/hybridIssueRepository.ts - Hybrid Storage → Local Issues: falls back locally
src/lib/repositories/hybridIssueRepository.ts - Repository Facade → Issue Validation: validates issues
src/lib/repositories/issueRepository.ts - Firestore Issues → Firebase: reads and writes
README.md - Workspace Shell → Authentication Service: manages sessions
src/App.tsx - Authentication Service → Firebase: authenticates users
README.md - Workspace Shell → Issue Tracking: shows citizen status
README.md - Issue Tracking → Repository Facade: loads issues
- Workspace Shell → Admin Command Desk: shows operations desk
README.md - Admin Command Desk → Repository Facade: updates issues
README.md - Admin Command Desk → Receipts and Proof: exports records
README.md - Workspace Shell → Receipts and Proof: loads repair proofs
src/App.tsx - Workspace Shell → Localization: switches language
src/App.tsx