# tejass06/civic-lssue-reporting-and-resolution-system. architecture

> Architecture diagram of the GitHub repository tejass06/civic-lssue-reporting-and-resolution-system., generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tejass06/civic-lssue-reporting-and-resolution-system.
- Repository: https://github.com/tejass06/civic-lssue-reporting-and-resolution-system.

## Overview

PragatiSetu is a civic-issue reporting and resolution system: citizens submit location- and photo-backed reports, while municipal departments review, assign, and update them. The graph includes the Flutter citizen app, React administration portal, ASP.NET API, MongoDB persistence, and Cloudinary image storage. The sampled API and web source show key calls; the mobile implementation was not sampled, so its feature links are documented at README level rather than inferred from unseen code.

Main entry points: [`pragatisetu-web/pragatisetu/src/apiService.js`](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/apiService.js) (Web API client), [`PragatiSetu.API/Services/IssueService.cs`](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Services/IssueService.cs) (Issue and user service), [`pragatisetu-web/pragatisetu/src/Dashboard.jsx`](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/Dashboard.jsx) (Issue dashboard), [`pragatisetu-web/pragatisetu/src/App.jsx`](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/App.jsx) (Portal routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_citizen["Citizen app"]
  node_citizen["Report and tracking app"]
end

subgraph group_adminweb["Admin portal"]
  node_webapp["Portal routing<br/>[App.jsx]"]
  node_layout["Portal layout<br/>[MainLayout.jsx]"]
  node_sidebar["Department navigation<br/>[Sidebar.jsx]"]
  node_signin["Department sign-in<br/>[SignIn.jsx]"]
  node_dashboard["Issue dashboard<br/>[Dashboard.jsx]"]
  node_reportsmap["Issue map<br/>[ReportsMap.jsx]"]
  node_reportslist["Issue list<br/>[ReportsList.jsx]"]
  node_details["Issue details<br/>[ReportDetails.jsx]"]
  node_statscards["Statistics cards<br/>[StatsCards.jsx]"]
  node_users["User management<br/>[UserManagement.jsx]"]
  node_apiclient["Web API client<br/>[apiService.js]"]
end

subgraph group_backend["API services"]
  node_issuescontroller["Issue endpoints"]
  node_authcontroller["Authentication<br/>[AuthController.cs]"]
  node_admincontroller["Admin endpoints<br/>[AdminController.cs]"]
  node_uploadcontroller["Image endpoint"]
  node_issueservice["Issue and user service<br/>[IssueService.cs]"]
  node_imageservice["Image upload service"]
  node_issuemodel["Issue model<br/>[Issue.cs]"]
  node_statsmodel["Issue statistics model<br/>[IssueStats.cs]"]
  node_usermodel["User model<br/>[User.cs]"]
end

subgraph group_data["Persistence and media"]
  node_mongodb[("MongoDB")]
  node_cloudinary["Cloudinary"]
end

node_citizens(("Citizens"))
node_staff(("Department staff"))

node_citizens -->|"file reports"| node_citizen
node_citizen -.->|"submit and track"| node_issuescontroller
node_staff -->|"manage issues"| node_webapp
node_webapp -->|"routes to"| node_signin
node_webapp -->|"renders"| node_layout
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_users
node_layout -->|"renders"| node_sidebar
node_dashboard -->|"fetches reports"| node_apiclient
node_dashboard -->|"renders"| node_reportsmap
node_dashboard -->|"renders"| node_reportslist
node_dashboard -->|"renders selection"| node_details
node_dashboard -->|"renders"| node_statscards
node_details -->|"updates issue"| node_apiclient
node_reportslist -->|"uses API"| node_apiclient
node_reportsmap -->|"uses API"| node_apiclient
node_statscards -->|"fetches statistics"| node_apiclient
node_users -->|"manages accounts"| node_apiclient
node_apiclient -->|"calls issue routes"| node_issuescontroller
node_apiclient -->|"calls login"| node_authcontroller
node_apiclient -->|"calls admin routes"| node_admincontroller
node_issuescontroller -->|"delegates issue operations"| node_issueservice
node_authcontroller -->|"looks up user"| node_issueservice
node_admincontroller -->|"manages users"| node_issueservice
node_uploadcontroller -->|"uploads image"| node_imageservice
node_issueservice -->|"reads and writes"| node_mongodb
node_imageservice -->|"uploads image"| node_cloudinary
node_issueservice -->|"persists"| node_issuemodel
node_issueservice -->|"persists"| node_usermodel
node_issueservice -->|"builds statistics"| node_statsmodel

click node_citizen "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./tree/main/pragatisetu-app/lib"
click node_webapp "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/App.jsx"
click node_layout "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/MainLayout.jsx"
click node_sidebar "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/Sidebar.jsx"
click node_signin "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/SignIn.jsx"
click node_dashboard "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/Dashboard.jsx"
click node_reportsmap "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/ReportsMap.jsx"
click node_reportslist "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/ReportsList.jsx"
click node_details "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/ReportDetails.jsx"
click node_statscards "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/StatsCards.jsx"
click node_users "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/UserManagement.jsx"
click node_apiclient "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/apiService.js"
click node_issuescontroller "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/IssuesController.cs"
click node_authcontroller "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/AuthController.cs"
click node_admincontroller "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/AdminController.cs"
click node_uploadcontroller "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/UploadController.cs"
click node_issueservice "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Services/IssueService.cs"
click node_imageservice "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Services/ImageUploadService.cs"
click node_issuemodel "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Models/Issue.cs"
click node_statsmodel "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Models/IssueStats.cs"
click node_usermodel "https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Models/User.cs"

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 toneBlue
class node_webapp,node_layout,node_sidebar,node_signin,node_dashboard,node_reportsmap,node_reportslist,node_details,node_statscards,node_users,node_apiclient toneAmber
class node_issuescontroller,node_authcontroller,node_admincontroller,node_uploadcontroller,node_issueservice,node_imageservice,node_issuemodel,node_statsmodel,node_usermodel toneMint
class node_mongodb,node_cloudinary toneRose
class node_citizens,node_staff toneIndigo
```

## Components

### Citizen app

- [Report and tracking app](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./tree/main/pragatisetu-app/lib): `pragatisetu-app/lib`

### Admin portal

- [Portal routing](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/App.jsx): `pragatisetu-web/pragatisetu/src/App.jsx`
- [Portal layout](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/MainLayout.jsx): `pragatisetu-web/pragatisetu/src/MainLayout.jsx`
- [Department navigation](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/Sidebar.jsx): `pragatisetu-web/pragatisetu/src/Sidebar.jsx`
- [Department sign-in](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/SignIn.jsx): `pragatisetu-web/pragatisetu/src/SignIn.jsx`
- [Issue dashboard](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/Dashboard.jsx): `pragatisetu-web/pragatisetu/src/Dashboard.jsx`
- [Issue map](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/ReportsMap.jsx): `pragatisetu-web/pragatisetu/src/ReportsMap.jsx`
- [Issue list](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/ReportsList.jsx): `pragatisetu-web/pragatisetu/src/ReportsList.jsx`
- [Issue details](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/ReportDetails.jsx): `pragatisetu-web/pragatisetu/src/ReportDetails.jsx`
- [Statistics cards](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/StatsCards.jsx): `pragatisetu-web/pragatisetu/src/StatsCards.jsx`
- [User management](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/UserManagement.jsx): `pragatisetu-web/pragatisetu/src/UserManagement.jsx`
- [Web API client](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/pragatisetu-web/pragatisetu/src/apiService.js): `pragatisetu-web/pragatisetu/src/apiService.js`

### API services

- [Issue endpoints](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/IssuesController.cs): `PragatiSetu.API/Controllers/IssuesController.cs`
- [Authentication](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/AuthController.cs): `PragatiSetu.API/Controllers/AuthController.cs`
- [Admin endpoints](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/AdminController.cs): `PragatiSetu.API/Controllers/AdminController.cs`
- [Image endpoint](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Controllers/UploadController.cs): `PragatiSetu.API/Controllers/UploadController.cs`
- [Issue and user service](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Services/IssueService.cs): `PragatiSetu.API/Services/IssueService.cs`
- [Image upload service](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Services/ImageUploadService.cs): `PragatiSetu.API/Services/ImageUploadService.cs`
- [Issue model](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Models/Issue.cs): `PragatiSetu.API/Models/Issue.cs`
- [Issue statistics model](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Models/IssueStats.cs): `PragatiSetu.API/Models/IssueStats.cs`
- [User model](https://github.com/tejass06/civic-lssue-reporting-and-resolution-system./blob/main/PragatiSetu.API/Models/User.cs): `PragatiSetu.API/Models/User.cs`

### Persistence and media

- **MongoDB**
- **Cloudinary**

### Other components

- **Citizens**
- **Department staff**

## Connections

- Citizens → Report and tracking app: file reports (evidence: `README.md`)
- Report and tracking app → Issue endpoints: submit and track
- Department staff → Portal routing: manage issues (evidence: `README.md`)
- Portal routing → Department sign-in: routes to (evidence: `pragatisetu-web/pragatisetu/src/App.jsx`)
- Portal routing → Portal layout: renders (evidence: `pragatisetu-web/pragatisetu/src/App.jsx`)
- Portal routing → Issue dashboard: routes to (evidence: `pragatisetu-web/pragatisetu/src/App.jsx`)
- Portal routing → User management: routes to (evidence: `pragatisetu-web/pragatisetu/src/App.jsx`)
- Portal layout → Department navigation: renders (evidence: `pragatisetu-web/pragatisetu/src/MainLayout.jsx`)
- Issue dashboard → Web API client: fetches reports (evidence: `pragatisetu-web/pragatisetu/src/Dashboard.jsx`)
- Issue dashboard → Issue map: renders (evidence: `pragatisetu-web/pragatisetu/src/Dashboard.jsx`)
- Issue dashboard → Issue list: renders (evidence: `pragatisetu-web/pragatisetu/src/Dashboard.jsx`)
- Issue dashboard → Issue details: renders selection (evidence: `pragatisetu-web/pragatisetu/src/Dashboard.jsx`)
- Issue dashboard → Statistics cards: renders (evidence: `pragatisetu-web/pragatisetu/src/Dashboard.jsx`)
- Issue details → Web API client: updates issue (evidence: `pragatisetu-web/pragatisetu/src/ReportDetails.jsx`)
- Issue list → Web API client: uses API (evidence: `pragatisetu-web/pragatisetu/src/ReportsList.jsx`)
- Issue map → Web API client: uses API (evidence: `pragatisetu-web/pragatisetu/src/ReportsMap.jsx`)
- Statistics cards → Web API client: fetches statistics (evidence: `pragatisetu-web/pragatisetu/src/StatsCards.jsx`)
- User management → Web API client: manages accounts (evidence: `pragatisetu-web/pragatisetu/src/UserManagement.jsx`)
- Web API client → Issue endpoints: calls issue routes (evidence: `pragatisetu-web/pragatisetu/src/apiService.js`)
- Web API client → Authentication: calls login (evidence: `pragatisetu-web/pragatisetu/src/apiService.js`)
- Web API client → Admin endpoints: calls admin routes (evidence: `pragatisetu-web/pragatisetu/src/apiService.js`)
- Issue endpoints → Issue and user service: delegates issue operations (evidence: `PragatiSetu.API/Controllers/IssuesController.cs`)
- Authentication → Issue and user service: looks up user (evidence: `PragatiSetu.API/Controllers/AuthController.cs`)
- Admin endpoints → Issue and user service: manages users (evidence: `PragatiSetu.API/Controllers/AdminController.cs`)
- Image endpoint → Image upload service: uploads image (evidence: `PragatiSetu.API/Controllers/UploadController.cs`)
- Issue and user service → MongoDB: reads and writes (evidence: `PragatiSetu.API/Services/IssueService.cs`)
- Image upload service → Cloudinary: uploads image (evidence: `PragatiSetu.API/Services/ImageUploadService.cs`)
- Issue and user service → Issue model: persists (evidence: `PragatiSetu.API/Services/IssueService.cs`)
- Issue and user service → User model: persists (evidence: `PragatiSetu.API/Services/IssueService.cs`)
- Issue and user service → Issue statistics model: builds statistics (evidence: `PragatiSetu.API/Services/IssueService.cs`)
