How ilmaan-ahamed/civicpulse-lk works
CivicPulse LK is a civic-issue reporting and resolution application. The main workflow is citizen report submission, verification, assignment to an agency, field inspection, and resolution; dashboards and public transparency expose progress. Role-based pages also support agency management, NGO pledges, notifications, and administration. The README is a generic Next.js starter and does not document product capabilities; this map relies on the supplied tree and sampled API source, so uncertain subsystem wiring is omitted.
Main entry points: db.ts Application database · auth-guard.ts Role authorization · reports/route.ts Report API · verifications/route.ts Verifications
Components 22
User experience
- Role-based pages
src/app/dashboard/citizen/page.tsx - Report submission
src/app/dashboard/citizen/report/page.tsx - Agency console
src/app/(protected)/ds-console/agencies/page.tsx
Reports and verification
- Report API
src/app/api/reports/route.ts - Report management
src/app/api/reports/[id]/route.ts - Issue creation
src/lib/db/issue.ts - AI triage
src/lib/ai/triage.ts - Verification queue
src/app/api/verification-queue/route.ts - Verifications
src/app/api/verifications/route.ts - Trust scoring
src/lib/trust-score.ts
Resolution operations
- Agency management
src/app/api/agencies/route.ts - Assignments
src/app/api/assignments/route.ts - Field inspections
src/app/api/inspections/route.ts - NGO pledges
src/app/api/pledges/route.ts
Transparency and insights
- Dashboard data
src/app/api/dashboard/route.ts - Dashboard views
src/components/dashboard/dashboard-client.tsx - Public transparency
src/app/transparency/page.tsx
Shared platform
- Notifications
src/lib/tracking/notifications.ts - Role authorization
src/lib/auth-guard.ts - Application database
src/lib/db.ts
Other components
- Citizen
- Civic staff
Connections 25
- Citizen → Role-based pages: uses
- Civic staff → Role-based pages: uses
- Role-based pages → Report submission: opens
- Report submission → Report API: submits
- Report API → Issue creation: creates via
- Report API → Application database: queries
- Report management → Application database: reads and updates
- Verification queue → Application database: queries
- Verifications → Application database: reads and writes
- Verifications → Trust scoring: updates score
- Agency management → Application database: reads and writes
- Agency console → Agency management: manages
- Assignments → Application database: reads and writes
- Assignments → Notifications: notifies
- Field inspections → Application database: reads and writes
- NGO pledges → Application database: reads and writes
- Dashboard data → Application database: queries
- Dashboard views → Dashboard data: fetches
- Public transparency → Dashboard data: fetches
- Report API → Role authorization: authorizes
- Report management → Role authorization: authorizes
- Verifications → Role authorization: authorizes
- Assignments → Role authorization: authorizes
- Field inspections → Role authorization: authorizes
- NGO pledges → Role authorization: authorizes