How akashwagh07/resolveit works
ResolveIt is a civic-complaint platform that takes citizen reports through AI-assisted understanding and deterministic scoring/routing, then supports assignment, repair evidence, approval, and citizen confirmation or dispute. The React app serves citizen, officer, and admin workflows; the FastAPI backend owns the decision and action paths. The README documents the closed-loop stages and review/audit capabilities. Some backend action, verification, and dashboard implementations were not excerpted, so those branches are shown only where the README or SOURCE INDEX supports them.
Main entry points: App.jsx Role-based app · pipeline.py Intake pipeline · api.js API client · agent2.py Decision agent
Components 24
User workflows
- Role-based app
frontend/src/App.jsx - Report issue
frontend/src/pages/ReportIssuePage.jsx - Complaint detail
frontend/src/pages/ComplaintDetailPage.jsx - Officer dashboard
frontend/src/pages/OfficerDashboard.jsx - Admin dashboards
frontend/src/pages/AdminDashboard.jsx - API client
frontend/src/lib/api.js
Complaint intake
- Complaint endpoints
backend/app/routers/complaints.py - Intake pipeline
backend/app/pipeline.py - Media and Gemini
backend/app/llm.py
Analysis and routing
- Complaint classifier
backend/app/agents/agent1.py - Decision agent
backend/app/agents/agent2.py - Severity and priority
backend/app/engines/severity.py - Department routing
backend/app/engines/department.py
Resolution lifecycle
- Validated commands
backend/app/commands.py - Command executor
backend/app/executor.py - Action endpoints
backend/app/routers/actions.py - Resolution verification
backend/app/verification.py
Identity and persistence
- Identity endpoints
backend/app/routers/auth.py - Demo identity
backend/app/auth.py - Civic data models
backend/app/models.py - SQL database
backend/app/database.py
Other components
- Citizen
- Officer
- Administrator
Connections 29
- Citizen → Role-based app: uses
- Officer → Role-based app: uses
- Administrator → Role-based app: uses
- Role-based app → Report issue: routes to
frontend/src/App.jsx - Role-based app → Complaint detail: routes to
frontend/src/App.jsx - Role-based app → Officer dashboard: routes to
frontend/src/App.jsx - Role-based app → Admin dashboards: routes to
frontend/src/App.jsx - Report issue → API client: submits through
frontend/src/pages/ReportIssuePage.jsx - Complaint detail → API client: loads and acts through
frontend/src/pages/ComplaintDetailPage.jsx - Officer dashboard → API client: uses
- Admin dashboards → API client: uses
frontend/src/pages/AdminDashboard.jsx - API client → Complaint endpoints: requests complaints
frontend/src/lib/api.js - Complaint endpoints → Intake pipeline: submits report to
backend/app/routers/complaints.py - Intake pipeline → Media and Gemini: validates media with
backend/app/pipeline.py - Intake pipeline → Complaint classifier: classifies with
backend/app/pipeline.py - Intake pipeline → Decision agent: requests decision from
backend/app/pipeline.py - Decision agent → Severity and priority: scores severity
backend/app/agents/agent2.py - Decision agent → Department routing: routes category
backend/app/agents/agent2.py - Decision agent → Validated commands: creates command
backend/app/agents/agent2.py - Intake pipeline → Command executor: executes command
backend/app/pipeline.py - Action endpoints → Command executor: dispatches actions
backend/app/routers/actions.py - Action endpoints → Resolution verification: uses verification
backend/app/routers/actions.py - Action endpoints → Validated commands: validates actions
backend/app/routers/actions.py - Complaint endpoints → Civic data models: reads and writes
backend/app/routers/complaints.py - Command executor → Civic data models: updates complaint state
- Civic data models → SQL database: persists in
backend/app/models.py - Identity endpoints → Demo identity: resolves caller
backend/app/routers/auth.py - Identity endpoints → Civic data models: lists demo users
backend/app/routers/auth.py - Role-based app → Demo identity: maintains client session
frontend/src/App.jsx