# djupadhyay2008/swach-navsari architecture

> Architecture diagram of the GitHub repository djupadhyay2008/swach-navsari, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/djupadhyay2008/swach-navsari
- Repository: https://github.com/djupadhyay2008/swach-navsari

## Overview

S.W.A.C.H. Navsari is a civic-cleanliness platform connecting residents, municipal staff, and sanitation workers. Its central workflow is complaint submission, municipal review and assignment, field work with completion evidence, and municipal verification or rework. The graph includes the citizen, operations, and worker portals, plus authentication, validation, and Supabase data access. Connections reflect the router, sampled imports and calls, or README workflow statements; unsampled feature internals are represented at their existing directories.

Main entry points: [`src/app/router.tsx`](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/app/router.tsx) (Application routes), [`src/features/admin/adminService.ts`](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/admin/adminService.ts) (Municipal operations service), [`src/lib/supabase/client.ts`](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/lib/supabase/client.ts) (Supabase client), [`src/pages/ReportIssuePage.tsx`](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/ReportIssuePage.tsx) (Submit complaint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_citizen["Citizen services"]
  node_citizen_report["Submit complaint"]
  node_citizen_reports["Personal reports<br/>[MyReportsPage.tsx]"]
  node_public_tracking["Public tracking"]
  node_community["Cleanup activities<br/>[CommunityPage.tsx]"]
end

subgraph group_operations["Municipal operations"]
  node_admin_queue["Complaint review"]
  node_admin_detail["Complaint detail"]
  node_admin_assignments["Staff assignments"]
  node_admin_verification["Completion verification"]
  node_admin_insights["Maps and reporting"]
  node_admin_service["Municipal operations service<br/>[adminService.ts]"]
  node_analytics["Operational analytics<br/>[index.ts]"]
end

subgraph group_field["Worker operations"]
  node_worker_portal["Worker task portal"]
  node_worker_service["Worker task service<br/>[workerService.ts]"]
end

subgraph group_platform["Shared platform"]
  node_router["Application routes<br/>[router.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
  node_validation["Report validation<br/>[reports.ts]"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
  node_supabase[("Supabase backend")]
  node_report_service["Complaint data service<br/>[reportsService.ts]"]
end

node_resident(("Resident"))
node_admin_user(("Municipal official"))
node_worker_user(("Sanitation worker"))

node_resident -->|"submits complaint"| node_citizen_report
node_resident -->|"follows reports"| node_citizen_reports
node_resident -->|"tracks complaint"| node_public_tracking
node_resident -->|"explores activities"| node_community
node_admin_user -->|"reviews complaints"| node_admin_queue
node_admin_user -->|"assigns work"| node_admin_assignments
node_admin_user -->|"reviews evidence"| node_admin_verification
node_worker_user -->|"works assigned tasks"| node_worker_portal
node_router -->|"routes to"| node_citizen_report
node_router -->|"routes to"| node_citizen_reports
node_router -->|"routes to"| node_public_tracking
node_router -->|"routes to"| node_community
node_router -->|"guards route"| node_worker_portal
node_router -->|"routes to"| node_admin_queue
node_router -->|"routes to"| node_admin_detail
node_router -->|"routes to"| node_admin_assignments
node_router -->|"routes to"| node_admin_verification
node_router -->|"routes to"| node_admin_insights
node_citizen_report -->|"validates input"| node_validation
node_citizen_report -->|"submits report"| node_report_service
node_citizen_reports -->|"loads reports"| node_report_service
node_public_tracking -->|"queries tracking"| node_supabase_client
node_report_service -->|"reads and writes"| node_supabase_client
node_worker_portal -->|"loads tasks"| node_worker_service
node_worker_service -->|"queries tasks"| node_supabase_client
node_admin_queue -->|"loads complaint data"| node_admin_service
node_admin_detail -->|"manages complaint"| node_admin_service
node_admin_assignments -->|"manages assignments"| node_admin_service
node_admin_service -->|"queries operations"| node_supabase_client
node_admin_service -->|"gets media URLs"| node_report_service
node_admin_service -->|"checks overdue status"| node_analytics
node_auth -->|"uses client"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_admin_user -->|"views operations"| node_admin_insights
node_worker_user -->|"submits evidence"| node_worker_portal

click node_router "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/app/router.tsx"
click node_auth "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/auth/AuthContext.tsx"
click node_validation "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/lib/validation/reports.ts"
click node_supabase_client "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/lib/supabase/client.ts"
click node_citizen_report "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/ReportIssuePage.tsx"
click node_citizen_reports "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/MyReportsPage.tsx"
click node_public_tracking "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/TrackComplaintPage.tsx"
click node_community "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/CommunityPage.tsx"
click node_admin_queue "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminReportsPage.tsx"
click node_admin_detail "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminReportDetailPage.tsx"
click node_admin_assignments "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminAssignmentsPage.tsx"
click node_admin_verification "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminVerificationsPage.tsx"
click node_admin_insights "https://github.com/djupadhyay2008/swach-navsari/tree/main/src/pages/admin"
click node_admin_service "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/admin/adminService.ts"
click node_worker_portal "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/WorkerPortalPage.tsx"
click node_worker_service "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/worker/workerService.ts"
click node_report_service "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/reports/reportsService.ts"
click node_analytics "https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/analytics/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_citizen_report,node_citizen_reports,node_public_tracking,node_community toneBlue
class node_admin_queue,node_admin_detail,node_admin_assignments,node_admin_verification,node_admin_insights,node_admin_service,node_analytics toneAmber
class node_worker_portal,node_worker_service toneMint
class node_router,node_auth,node_validation,node_supabase_client,node_supabase,node_report_service,node_worker_user toneRose
class node_resident,node_admin_user toneIndigo
```

## Components

### Citizen services

- [Submit complaint](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/ReportIssuePage.tsx): `src/pages/ReportIssuePage.tsx`
- [Personal reports](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/MyReportsPage.tsx): `src/pages/MyReportsPage.tsx`
- [Public tracking](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/TrackComplaintPage.tsx): `src/pages/TrackComplaintPage.tsx`
- [Cleanup activities](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/CommunityPage.tsx): `src/pages/CommunityPage.tsx`

### Municipal operations

- [Complaint review](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminReportsPage.tsx): `src/pages/admin/AdminReportsPage.tsx`
- [Complaint detail](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminReportDetailPage.tsx): `src/pages/admin/AdminReportDetailPage.tsx`
- [Staff assignments](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminAssignmentsPage.tsx): `src/pages/admin/AdminAssignmentsPage.tsx`
- [Completion verification](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/admin/AdminVerificationsPage.tsx): `src/pages/admin/AdminVerificationsPage.tsx`
- [Maps and reporting](https://github.com/djupadhyay2008/swach-navsari/tree/main/src/pages/admin): `src/pages/admin`
- [Municipal operations service](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/admin/adminService.ts): `src/features/admin/adminService.ts`
- [Operational analytics](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/analytics/index.ts): `src/features/analytics/index.ts`

### Worker operations

- [Worker task portal](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/pages/WorkerPortalPage.tsx): `src/pages/WorkerPortalPage.tsx`
- [Worker task service](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/worker/workerService.ts): `src/features/worker/workerService.ts`

### Shared platform

- [Application routes](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/app/router.tsx): `src/app/router.tsx`
- [Authentication](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/auth/AuthContext.tsx): `src/features/auth/AuthContext.tsx`
- [Report validation](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/lib/validation/reports.ts): `src/lib/validation/reports.ts`
- [Supabase client](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/lib/supabase/client.ts): `src/lib/supabase/client.ts`
- **Supabase backend**
- [Complaint data service](https://github.com/djupadhyay2008/swach-navsari/blob/main/src/features/reports/reportsService.ts): `src/features/reports/reportsService.ts`

### Other components

- **Resident**
- **Municipal official**
- **Sanitation worker**

## Connections

- Resident → Submit complaint: submits complaint (evidence: `README.md`)
- Resident → Personal reports: follows reports (evidence: `README.md`)
- Resident → Public tracking: tracks complaint (evidence: `README.md`)
- Resident → Cleanup activities: explores activities (evidence: `README.md`)
- Municipal official → Complaint review: reviews complaints (evidence: `README.md`)
- Municipal official → Staff assignments: assigns work (evidence: `README.md`)
- Municipal official → Completion verification: reviews evidence (evidence: `README.md`)
- Sanitation worker → Worker task portal: works assigned tasks (evidence: `README.md`)
- Application routes → Submit complaint: routes to (evidence: `src/app/router.tsx`)
- Application routes → Personal reports: routes to (evidence: `src/app/router.tsx`)
- Application routes → Public tracking: routes to (evidence: `src/app/router.tsx`)
- Application routes → Cleanup activities: routes to (evidence: `src/app/router.tsx`)
- Application routes → Worker task portal: guards route (evidence: `src/app/router.tsx`)
- Application routes → Complaint review: routes to (evidence: `src/app/router.tsx`)
- Application routes → Complaint detail: routes to (evidence: `src/app/router.tsx`)
- Application routes → Staff assignments: routes to (evidence: `src/app/router.tsx`)
- Application routes → Completion verification: routes to (evidence: `src/app/router.tsx`)
- Application routes → Maps and reporting: routes to (evidence: `src/app/router.tsx`)
- Submit complaint → Report validation: validates input (evidence: `src/pages/ReportIssuePage.tsx`)
- Submit complaint → Complaint data service: submits report (evidence: `src/pages/ReportIssuePage.tsx`)
- Personal reports → Complaint data service: loads reports (evidence: `src/features/reports/reportsService.ts`)
- Public tracking → Supabase client: queries tracking (evidence: `src/pages/TrackComplaintPage.tsx`)
- Complaint data service → Supabase client: reads and writes (evidence: `src/features/reports/reportsService.ts`)
- Worker task portal → Worker task service: loads tasks (evidence: `src/pages/WorkerPortalPage.tsx`)
- Worker task service → Supabase client: queries tasks (evidence: `src/features/worker/workerService.ts`)
- Complaint review → Municipal operations service: loads complaint data (evidence: `src/pages/admin/AdminReportsPage.tsx`)
- Complaint detail → Municipal operations service: manages complaint (evidence: `src/pages/admin/AdminReportDetailPage.tsx`)
- Staff assignments → Municipal operations service: manages assignments (evidence: `src/pages/admin/AdminAssignmentsPage.tsx`)
- Municipal operations service → Supabase client: queries operations (evidence: `src/features/admin/adminService.ts`)
- Municipal operations service → Complaint data service: gets media URLs (evidence: `src/features/admin/adminService.ts`)
- Municipal operations service → Operational analytics: checks overdue status (evidence: `src/features/admin/adminService.ts`)
- Authentication → Supabase client: uses client (evidence: `src/features/auth/AuthContext.tsx`)
- Supabase client → Supabase backend: connects to (evidence: `src/lib/supabase/client.ts`)
- Municipal official → Maps and reporting: views operations (evidence: `README.md`)
- Sanitation worker → Worker task portal: submits evidence (evidence: `README.md`)
