How meethjain09/civicresolve works
CivicResolve is a role-based municipal grievance platform. Citizens submit reports with photos and location details; the server validates and persists them immediately, then runs Gemini triage asynchronously to classify, prioritize, and route each ticket. Citizens track progress, department resolvers update status and request reassignment, and administrators manage complaints and staff. The graph combines sampled calls and imports with README-documented capabilities; unsampled client/API wiring and reverse-geocoding provider details are shown only where documented.
Main entry points: route.ts Complaint submission · server.ts Server authentication · admin.ts Privileged data client · triage.ts Multimodal AI triage
Components 25
Role workspaces
- Sign-in and demo
src/components/auth/AuthForm.tsx - Report and track
src/components/citizen/CitizenDashboardClient.tsx - Complaint form
src/components/citizen/ComplaintForm.tsx - Location picker
src/components/citizen/LocationPicker.tsx - Resolver workspace
src/components/resolver/ResolverDashboardClient.tsx - Resolver ticket actions
src/components/resolver/ResolverTicketCard.tsx - Admin workspace
src/components/admin/AdminDashboardClient.tsx - Complaint administration
src/components/admin/AdminComplaintCenter.tsx - Staff directory
src/components/admin/StaffManager.tsx
Application API
- Complaint submission
src/app/api/complaints/route.ts - Resolver updates
src/app/api/resolver/complaints/[id]/route.ts - Admin complaint actions
src/app/api/admin/complaints/[id]/route.ts - Retry AI triage
src/app/api/admin/retry-ai/route.ts - Resolver provisioning
src/app/api/admin/resolvers/route.ts - Reverse geocoding
src/app/api/geocode/reverse/route.ts
Triage and validation
- Complaint validation
src/lib/validation/complaints.ts - Multimodal AI triage
src/lib/gemini/triage.ts
Identity and persistence
- Server authentication
src/lib/supabase/server.ts - Privileged data client
src/lib/supabase/admin.ts
External services
- Supabase database and storage
- Google Gemini
- Nominatim and BigDataCloud
Other components
- Citizens
- Department resolvers
- Municipal administrators
Connections 36
- Citizens → Sign-in and demo: sign in
README.md - Department resolvers → Sign-in and demo: sign in
README.md - Municipal administrators → Sign-in and demo: sign in
README.md - Citizens → Report and track: report and track
README.md - Report and track → Complaint form: renders
src/components/citizen/CitizenDashboardClient.tsx - Complaint form → Location picker: uses
src/components/citizen/ComplaintForm.tsx - Complaint form → Complaint submission: submits report
README.md - Department resolvers → Resolver workspace: manage assigned tickets
README.md - Resolver workspace → Resolver ticket actions: renders
src/components/resolver/ResolverDashboardClient.tsx - Resolver ticket actions → Resolver updates: updates ticket
README.md - Municipal administrators → Admin workspace: manage platform
README.md - Admin workspace → Complaint administration: renders
src/components/admin/AdminDashboardClient.tsx - Admin workspace → Staff directory: renders
src/components/admin/AdminDashboardClient.tsx - Complaint administration → Admin complaint actions: manages tickets
README.md - Complaint administration → Retry AI triage: retries triage
README.md - Staff directory → Resolver provisioning: provisions resolvers
README.md - Complaint submission → Server authentication: authenticates user
src/app/api/complaints/route.ts - Complaint submission → Complaint validation: validates payload
src/app/api/complaints/route.ts - Complaint submission → Privileged data client: persists complaint
src/app/api/complaints/route.ts - Complaint submission → Multimodal AI triage: schedules analysis
src/app/api/complaints/route.ts - Multimodal AI triage → Google Gemini: analyzes evidence
README.md - Complaint submission → Supabase database and storage: inserts report
README.md - Multimodal AI triage → Supabase database and storage: updates triage
README.md - Resolver updates → Server authentication: authenticates user
src/app/api/resolver/complaints/[id]/route.ts - Resolver updates → Privileged data client: updates ticket
src/app/api/resolver/complaints/[id]/route.ts - Admin complaint actions → Server authentication: authenticates user
src/app/api/admin/complaints/[id]/route.ts - Admin complaint actions → Privileged data client: administers records
src/app/api/admin/complaints/[id]/route.ts - Retry AI triage → Multimodal AI triage: invokes triage
src/app/api/admin/retry-ai/route.ts - Retry AI triage → Privileged data client: updates records
src/app/api/admin/retry-ai/route.ts - Resolver provisioning → Privileged data client: manages accounts
src/app/api/admin/resolvers/route.ts - Reverse geocoding → Server authentication: authenticates request
src/app/api/geocode/reverse/route.ts - Location picker → Reverse geocoding: requests address lookup
README.md - Reverse geocoding → Nominatim and BigDataCloud: reverse geocodes
README.md - Sign-in and demo → Server authentication: uses session
src/components/auth/AuthForm.tsx - Server authentication → Supabase database and storage: reads identity
README.md - Privileged data client → Supabase database and storage: uses service role
src/lib/supabase/admin.ts