How dineshrajdhanapathydd/civicflow-ai works
CivicFlow AI turns citizen text and photos into analyzed reports, groups duplicates into prioritized community issues, and exposes progress through staff controls and a dashboard. Citizens and staff use a React app backed by an API Lambda and DynamoDB; analysis also uses Rekognition and Bedrock. Ask CivicFlow is documented as a separate Strands-based Python agent. The excerpts show much of the Node analysis flow; some frontend routes, agent wiring, and AWS deployment links are supported only by the README, so those relationships are cited there.
Main entry points: handler.ts API router · repo.ts DynamoDB access · analyze.ts Analysis pipeline · clustering.ts Issue clustering
Components 29
Community app
- Report form
frontend/src/pages/ReportForm.tsx - Issue views
frontend/src/pages/IssueDetails.tsx - Dashboard view
frontend/src/pages/Dashboard.tsx - Ask view
frontend/src/pages/Ask.tsx - API client
frontend/src/lib/api.ts
API and records
- API router
backend/src/handler.ts - Report management
backend/src/services/reports.ts - Image uploads
backend/src/services/uploads.ts - DynamoDB access
backend/src/data/repo.ts - Dashboard stats
backend/src/services/dashboard.ts
Issue analysis
- Analysis pipeline
backend/src/services/analyze.ts - Text evidence
backend/src/services/textEvidence.ts - Image analysis
backend/src/services/vision.ts - AI reasoning
backend/src/services/bedrock.ts - Issue clustering
backend/src/services/clustering.ts - Duplicate matching
backend/src/services/similarity.ts - Priority model
backend/src/services/priority.ts
Ask CivicFlow
- Ask service
backend/src/services/ask.ts - Data tools
backend/src/services/agentTools.ts - Agent Lambda
backend-agent/handler.py - Strands agent
backend-agent/agent.py - Agent data access
backend-agent/civicflow_data.py
AWS services
- DynamoDB
- Amazon Rekognition
- Amazon Bedrock
- Amazon S3
- AWS deployment
infra/lib/civicflow-stack.ts
Other components
- Citizen
- Staff
Connections 37
- Citizen → Report form: submits evidence
README.md - Staff → Issue views: updates status
README.md - Report form → API client: sends requests
frontend/src/pages/ReportForm.tsx - Issue views → API client: loads and updates
frontend/src/pages/IssueDetails.tsx - Dashboard view → API client: loads statistics
frontend/src/pages/Dashboard.tsx - Ask view → API client: asks question
frontend/src/pages/Ask.tsx - API client → API router: calls API
README.md - API router → Report management: creates and reads
backend/src/handler.ts - API router → Image uploads: requests upload URL
backend/src/handler.ts - API router → Analysis pipeline: starts analysis
backend/src/handler.ts - API router → Issue clustering: loads issue details
backend/src/handler.ts - API router → DynamoDB access: updates status
backend/src/handler.ts - API router → Dashboard stats: gets statistics
backend/src/handler.ts - API router → Ask service: handles questions
backend/src/handler.ts - Report management → DynamoDB access: persists reports
backend/src/services/reports.ts - DynamoDB access → DynamoDB: reads and writes
backend/src/data/repo.ts - Image uploads → Amazon S3: presigns image upload
README.md - Analysis pipeline → DynamoDB access: loads and saves reports
backend/src/services/analyze.ts - Analysis pipeline → Text evidence: extracts evidence
backend/src/services/analyze.ts - Analysis pipeline → Image analysis: analyzes image
backend/src/services/analyze.ts - Image analysis → Amazon Rekognition: detects image labels
README.md - Analysis pipeline → AI reasoning: fuses evidence
backend/src/services/analyze.ts - AI reasoning → Amazon Bedrock: reasons over evidence
README.md - AI reasoning → Text evidence: uses heuristic fallback
backend/src/services/bedrock.ts - Analysis pipeline → Issue clustering: clusters analyzed report
backend/src/services/analyze.ts - Issue clustering → Duplicate matching: matches reports
backend/src/services/clustering.ts - Issue clustering → Priority model: computes priority
backend/src/services/clustering.ts - Issue clustering → DynamoDB access: stores issues and links
backend/src/services/clustering.ts - Dashboard stats → DynamoDB access: aggregates records
backend/src/services/dashboard.ts - Ask service → Data tools: retrieves live data
backend/src/services/ask.ts - Data tools → DynamoDB access: queries records
backend/src/services/agentTools.ts - Agent Lambda → Strands agent: invokes agent
backend-agent/handler.py - Strands agent → Agent data access: uses data tools
backend-agent/agent.py - AWS deployment → API router: deploys Lambda
README.md - AWS deployment → Agent Lambda: deploys agent Lambda
README.md - AWS deployment → DynamoDB: provisions store
README.md - AWS deployment → Amazon S3: provisions buckets
README.md