# ch1n7u/bcnp architecture

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

- Interactive diagram: https://gitdiagram.com/ch1n7u/bcnp
- Repository: https://github.com/ch1n7u/bcnp

## Overview

Bharat Cyber Nyay Portal is a multi-role cybercrime reporting and case-tracking application. Citizens register or sign in, file reports, submit evidence, and track case progress; administrators assign cases and investigators update status and notes. The portal also documents anonymous reporting and analytics capabilities. The map follows the frontend-to-API boundary and sampled backend calls; some feature connections are documented in the README rather than verified in sampled implementation. The database is Supabase-backed, with evidence files handled through Supabase Storage.

Main entry points: [`backend/src/routes/index.js`](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/index.js) (Route Registry), [`frontend/src/app`](https://github.com/ch1n7u/bcnp/tree/main/frontend/src/app) (Portal Pages), [`backend/src/config/db.js`](https://github.com/ch1n7u/bcnp/blob/main/backend/src/config/db.js) (Supabase Database), [`backend/src/controllers/authController.js`](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/authController.js) (Identity Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Citizen Portal"]
  node_portal["Portal Pages"]
  node_authui["Authentication UI<br/>[AuthForm.jsx]"]
  node_reportui["Report Submission<br/>[ReportForm.jsx]"]
  node_caseui["Case Dashboards"]
  node_trackerui["Case Tracking UI<br/>[CaseTracker.jsx]"]
  node_authstate["Auth Context<br/>[AuthContext.js]"]
  node_apiclient["API Client<br/>[api.js]"]
end

subgraph group_api["API and Access"]
  node_apiapp["Express App<br/>[app.js]"]
  node_routes["Route Registry<br/>[index.js]"]
  node_authroutes["Auth Routes<br/>[authRoutes.js]"]
  node_caseroutes["Case Routes<br/>[caseRoutes.js]"]
  node_adminroutes["Admin Routes<br/>[adminRoutes.js]"]
  node_reportroutes["Report Routes<br/>[reportRoutes.js]"]
  node_evidenceroutes["Evidence Routes<br/>[evidenceRoutes.js]"]
  node_analyticsroutes["Analytics Routes<br/>[analyticsRoutes.js]"]
  node_authcontroller["Identity Operations<br/>[authController.js]"]
end

subgraph group_cases["Case Operations"]
  node_casecontroller["Case Management<br/>[caseController.js]"]
  node_admincontroller["Administration<br/>[adminController.js]"]
  node_reportcontroller["Report Intake"]
  node_evidencecontroller["Evidence Handling"]
  node_trackingcontroller["Public Tracking"]
  node_analyticscontroller["Portal Analytics"]
end

subgraph group_platform["Data and Services"]
  node_database[("Supabase Database<br/>[db.js]")]
  node_userrecord["User Model<br/>[userModel.js]"]
  node_timeline["Case Timeline"]
  node_audit["Audit Logging<br/>[auditLogger.js]"]
  node_mailer["Email Delivery<br/>[mailer.js]"]
  node_storage["Evidence File Storage"]
end

node_citizen(("Citizen"))
node_investigator(("Investigator"))
node_administrator(("Administrator"))
node_supabase[("Supabase Service")]

node_citizen -->|"uses"| node_portal
node_investigator -->|"uses"| node_portal
node_administrator -->|"uses"| node_portal
node_portal -.->|"offers sign-in"| node_authui
node_portal -.->|"offers reporting"| node_reportui
node_portal -.->|"offers case tools"| node_caseui
node_portal -.->|"offers tracking"| node_trackerui
node_authui -->|"updates"| node_authstate
node_authui -->|"calls"| node_apiclient
node_reportui -.->|"submits reports"| node_apiclient
node_trackerui -.->|"requests status"| node_apiclient
node_apiclient -->|"sends API requests"| node_apiapp
node_apiapp -->|"mounts"| node_routes
node_routes -->|"registers"| node_authroutes
node_routes -->|"registers"| node_caseroutes
node_routes -->|"registers"| node_adminroutes
node_routes -->|"registers"| node_reportroutes
node_routes -->|"registers"| node_evidenceroutes
node_routes -->|"registers"| node_analyticsroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_caseroutes -->|"dispatches"| node_casecontroller
node_adminroutes -->|"dispatches"| node_admincontroller
node_reportroutes -.->|"dispatches"| node_reportcontroller
node_evidenceroutes -.->|"dispatches"| node_evidencecontroller
node_analyticsroutes -.->|"dispatches"| node_analyticscontroller
node_authcontroller -->|"looks up users"| node_userrecord
node_userrecord -->|"queries"| node_database
node_authcontroller -->|"reads and writes"| node_database
node_authcontroller -->|"sends welcome email"| node_mailer
node_authcontroller -->|"records events"| node_audit
node_casecontroller -->|"reads and writes"| node_database
node_casecontroller -->|"records case events"| node_timeline
node_casecontroller -->|"records actions"| node_audit
node_timeline -->|"persists timeline"| node_database
node_evidencecontroller -->|"stores evidence metadata"| node_database
node_evidencecontroller -->|"uploads and downloads"| node_storage
node_evidencecontroller -->|"records uploads"| node_timeline
node_evidencecontroller -->|"records uploads"| node_audit
node_database -->|"connects to"| node_supabase
node_storage -->|"uses file storage"| node_supabase

click node_portal "https://github.com/ch1n7u/bcnp/tree/main/frontend/src/app"
click node_authui "https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/AuthForm.jsx"
click node_reportui "https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/ReportForm.jsx"
click node_caseui "https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/AdminCaseAssignment.jsx"
click node_trackerui "https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/CaseTracker.jsx"
click node_authstate "https://github.com/ch1n7u/bcnp/blob/main/frontend/src/context/AuthContext.js"
click node_apiclient "https://github.com/ch1n7u/bcnp/blob/main/frontend/src/lib/api.js"
click node_apiapp "https://github.com/ch1n7u/bcnp/blob/main/backend/src/app.js"
click node_routes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/index.js"
click node_authroutes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/authRoutes.js"
click node_caseroutes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/caseRoutes.js"
click node_adminroutes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/adminRoutes.js"
click node_reportroutes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/reportRoutes.js"
click node_evidenceroutes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/evidenceRoutes.js"
click node_analyticsroutes "https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/analyticsRoutes.js"
click node_authcontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/authController.js"
click node_casecontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/caseController.js"
click node_admincontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/adminController.js"
click node_reportcontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/reportController.js"
click node_evidencecontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/evidenceController.js"
click node_trackingcontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/trackingController.js"
click node_analyticscontroller "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/analyticsController.js"
click node_database "https://github.com/ch1n7u/bcnp/blob/main/backend/src/config/db.js"
click node_userrecord "https://github.com/ch1n7u/bcnp/blob/main/backend/src/models/userModel.js"
click node_timeline "https://github.com/ch1n7u/bcnp/blob/main/backend/src/services/caseTimelineService.js"
click node_audit "https://github.com/ch1n7u/bcnp/blob/main/backend/src/services/auditLogger.js"
click node_mailer "https://github.com/ch1n7u/bcnp/blob/main/backend/src/utils/mailer.js"
click node_storage "https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/evidenceController.js"

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_portal,node_authui,node_reportui,node_caseui,node_trackerui,node_authstate,node_apiclient toneBlue
class node_apiapp,node_routes,node_authroutes,node_caseroutes,node_adminroutes,node_reportroutes,node_evidenceroutes,node_analyticsroutes,node_authcontroller,node_supabase toneAmber
class node_casecontroller,node_admincontroller,node_reportcontroller,node_evidencecontroller,node_trackingcontroller,node_analyticscontroller toneMint
class node_database,node_userrecord,node_timeline,node_audit,node_mailer,node_storage toneRose
class node_citizen,node_investigator,node_administrator toneIndigo
```

## Components

### Citizen Portal

- [Portal Pages](https://github.com/ch1n7u/bcnp/tree/main/frontend/src/app): `frontend/src/app`
- [Authentication UI](https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/AuthForm.jsx): `frontend/src/components/AuthForm.jsx`
- [Report Submission](https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/ReportForm.jsx): `frontend/src/components/ReportForm.jsx`
- [Case Dashboards](https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/AdminCaseAssignment.jsx): `frontend/src/components/AdminCaseAssignment.jsx`
- [Case Tracking UI](https://github.com/ch1n7u/bcnp/blob/main/frontend/src/components/CaseTracker.jsx): `frontend/src/components/CaseTracker.jsx`
- [Auth Context](https://github.com/ch1n7u/bcnp/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [API Client](https://github.com/ch1n7u/bcnp/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`

### API and Access

- [Express App](https://github.com/ch1n7u/bcnp/blob/main/backend/src/app.js): `backend/src/app.js`
- [Route Registry](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Auth Routes](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Case Routes](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/caseRoutes.js): `backend/src/routes/caseRoutes.js`
- [Admin Routes](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/adminRoutes.js): `backend/src/routes/adminRoutes.js`
- [Report Routes](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/reportRoutes.js): `backend/src/routes/reportRoutes.js`
- [Evidence Routes](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/evidenceRoutes.js): `backend/src/routes/evidenceRoutes.js`
- [Analytics Routes](https://github.com/ch1n7u/bcnp/blob/main/backend/src/routes/analyticsRoutes.js): `backend/src/routes/analyticsRoutes.js`
- [Identity Operations](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`

### Case Operations

- [Case Management](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/caseController.js): `backend/src/controllers/caseController.js`
- [Administration](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Report Intake](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/reportController.js): `backend/src/controllers/reportController.js`
- [Evidence Handling](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/evidenceController.js): `backend/src/controllers/evidenceController.js`
- [Public Tracking](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/trackingController.js): `backend/src/controllers/trackingController.js`
- [Portal Analytics](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/analyticsController.js): `backend/src/controllers/analyticsController.js`

### Data and Services

- [Supabase Database](https://github.com/ch1n7u/bcnp/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [User Model](https://github.com/ch1n7u/bcnp/blob/main/backend/src/models/userModel.js): `backend/src/models/userModel.js`
- [Case Timeline](https://github.com/ch1n7u/bcnp/blob/main/backend/src/services/caseTimelineService.js): `backend/src/services/caseTimelineService.js`
- [Audit Logging](https://github.com/ch1n7u/bcnp/blob/main/backend/src/services/auditLogger.js): `backend/src/services/auditLogger.js`
- [Email Delivery](https://github.com/ch1n7u/bcnp/blob/main/backend/src/utils/mailer.js): `backend/src/utils/mailer.js`
- [Evidence File Storage](https://github.com/ch1n7u/bcnp/blob/main/backend/src/controllers/evidenceController.js): `backend/src/controllers/evidenceController.js`

### Other components

- **Citizen**
- **Investigator**
- **Administrator**
- **Supabase Service**

## Connections

- Citizen → Portal Pages: uses
- Investigator → Portal Pages: uses
- Administrator → Portal Pages: uses
- Portal Pages → Authentication UI: offers sign-in
- Portal Pages → Report Submission: offers reporting
- Portal Pages → Case Dashboards: offers case tools
- Portal Pages → Case Tracking UI: offers tracking
- Authentication UI → Auth Context: updates (evidence: `frontend/src/components/AuthForm.jsx`)
- Authentication UI → API Client: calls (evidence: `frontend/src/components/AuthForm.jsx`)
- Report Submission → API Client: submits reports
- Case Tracking UI → API Client: requests status
- API Client → Express App: sends API requests
- Express App → Route Registry: mounts (evidence: `backend/src/app.js`)
- Route Registry → Auth Routes: registers (evidence: `backend/src/routes/index.js`)
- Route Registry → Case Routes: registers (evidence: `backend/src/routes/index.js`)
- Route Registry → Admin Routes: registers (evidence: `backend/src/routes/index.js`)
- Route Registry → Report Routes: registers (evidence: `backend/src/routes/index.js`)
- Route Registry → Evidence Routes: registers (evidence: `backend/src/routes/index.js`)
- Route Registry → Analytics Routes: registers (evidence: `backend/src/routes/index.js`)
- Auth Routes → Identity Operations: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Case Routes → Case Management: dispatches (evidence: `backend/src/routes/caseRoutes.js`)
- Admin Routes → Administration: dispatches (evidence: `backend/src/routes/adminRoutes.js`)
- Report Routes → Report Intake: dispatches
- Evidence Routes → Evidence Handling: dispatches
- Analytics Routes → Portal Analytics: dispatches
- Identity Operations → User Model: looks up users (evidence: `backend/src/controllers/authController.js`)
- User Model → Supabase Database: queries (evidence: `backend/src/models/userModel.js`)
- Identity Operations → Supabase Database: reads and writes (evidence: `backend/src/controllers/authController.js`)
- Identity Operations → Email Delivery: sends welcome email (evidence: `backend/src/controllers/authController.js`)
- Identity Operations → Audit Logging: records events (evidence: `backend/src/controllers/authController.js`)
- Case Management → Supabase Database: reads and writes (evidence: `backend/src/controllers/caseController.js`)
- Case Management → Case Timeline: records case events (evidence: `backend/src/controllers/caseController.js`)
- Case Management → Audit Logging: records actions (evidence: `backend/src/controllers/caseController.js`)
- Case Timeline → Supabase Database: persists timeline (evidence: `backend/src/services/caseTimelineService.js`)
- Evidence Handling → Supabase Database: stores evidence metadata (evidence: `backend/src/controllers/evidenceController.js`)
- Evidence Handling → Evidence File Storage: uploads and downloads (evidence: `backend/src/controllers/evidenceController.js`)
- Evidence Handling → Case Timeline: records uploads (evidence: `backend/src/controllers/evidenceController.js`)
- Evidence Handling → Audit Logging: records uploads (evidence: `backend/src/controllers/evidenceController.js`)
- Supabase Database → Supabase Service: connects to (evidence: `backend/src/config/db.js`)
- Evidence File Storage → Supabase Service: uses file storage (evidence: `backend/src/controllers/evidenceController.js`)
