# brihansahoo/mplads_backend architecture

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

- Interactive diagram: https://gitdiagram.com/brihansahoo/mplads_backend
- Repository: https://github.com/brihansahoo/mplads_backend

## Overview

MPLADS Risk Monitor is a FastAPI backend for MP and district-management users to authenticate and work with public-project proposals, risk indicators, dashboards, reports, and documents. The main workflow is an API request routed to a feature router, authenticated where applicable, then handled by a service that reads or writes Supabase-backed data; project creation also invokes risk scoring and document uploads. The graph includes documented router and service calls plus source-index-supported dependencies. Several service implementations and routers were not excerpted, so their internal behavior is not expanded.

Main entry points: [`database/database.py`](https://github.com/brihansahoo/mplads_backend/blob/main/database/database.py) (Supabase client), [`auth/auth.py`](https://github.com/brihansahoo/mplads_backend/blob/main/auth/auth.py) (Token authentication), [`main.py`](https://github.com/brihansahoo/mplads_backend/blob/main/main.py) (FastAPI app), [`services/project_service.py`](https://github.com/brihansahoo/mplads_backend/blob/main/services/project_service.py) (Project lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routing"]
  node_application["FastAPI app<br/>[main.py]"]
  node_dashboard_router["Dashboard routes"]
  node_project_router["Project routes<br/>[projects_route.py]"]
  node_document_router["Document routes<br/>[document_router.py]"]
  node_report_router["Report routes<br/>[report_route.py]"]
  node_user_router["User routes<br/>[user_router.py]"]
end

subgraph group_identity["Identity and users"]
  node_auth["Token authentication<br/>[auth.py]"]
  node_user_service["User accounts<br/>[user_service.py]"]
  node_user_schema["User request schemas<br/>[user_schema.py]"]
end

subgraph group_projects["Project oversight"]
  node_dashboard_service["Dashboard metrics"]
  node_project_service["Project lifecycle<br/>[project_service.py]"]
  node_risk_service["Risk scoring<br/>[risk_service.py]"]
  node_project_schema["Project and risk schemas<br/>[project_schema.py]"]
  node_document_service["Document retrieval"]
  node_report_service["Project reporting<br/>[reports_service.py]"]
end

subgraph group_data["Data and integrations"]
  node_cloudinary_service["File upload service"]
  node_database[("Supabase client<br/>[database.py]")]
  node_settings["Runtime settings<br/>[config.py]"]
end

node_client(("API client"))
node_supabase[("Supabase")]

node_client -->|"sends requests"| node_application
node_application -->|"registers routes"| node_dashboard_router
node_application -->|"registers routes"| node_project_router
node_application -->|"registers routes"| node_document_router
node_application -->|"registers routes"| node_report_router
node_application -->|"registers routes"| node_user_router
node_dashboard_router -->|"depends on"| node_auth
node_dashboard_router -->|"calls metrics"| node_dashboard_service
node_project_router -->|"depends on"| node_auth
node_project_router -->|"calls project logic"| node_project_service
node_project_router -->|"uses schemas"| node_project_schema
node_document_router -->|"depends on"| node_auth
node_document_router -->|"calls retrieval"| node_document_service
node_report_router -->|"depends on"| node_auth
node_report_router -->|"calls reports"| node_report_service
node_user_router -->|"depends on"| node_auth
node_user_router -->|"calls account logic"| node_user_service
node_user_router -->|"accepts requests"| node_user_schema
node_user_service -->|"creates tokens"| node_auth
node_auth -->|"reads JWT settings"| node_settings
node_project_service -->|"queries projects"| node_database
node_project_service -->|"scores projects"| node_risk_service
node_project_service -->|"uploads files"| node_cloudinary_service
node_project_service -->|"uses project models"| node_project_schema
node_dashboard_service -->|"queries projects"| node_database
node_dashboard_service -->|"uses project types"| node_project_schema
node_document_service -->|"queries documents"| node_database
node_report_service -->|"queries report data"| node_database
node_user_service -->|"queries accounts"| node_database
node_user_service -->|"uses account models"| node_user_schema
node_database -->|"reads connection settings"| node_settings
node_database -->|"creates client"| node_supabase
node_cloudinary_service -->|"reads credentials"| node_settings

click node_application "https://github.com/brihansahoo/mplads_backend/blob/main/main.py"
click node_dashboard_router "https://github.com/brihansahoo/mplads_backend/blob/main/routers/dashboard_router.py"
click node_project_router "https://github.com/brihansahoo/mplads_backend/blob/main/routers/projects_route.py"
click node_document_router "https://github.com/brihansahoo/mplads_backend/blob/main/routers/document_router.py"
click node_report_router "https://github.com/brihansahoo/mplads_backend/blob/main/routers/report_route.py"
click node_user_router "https://github.com/brihansahoo/mplads_backend/blob/main/routers/user_router.py"
click node_auth "https://github.com/brihansahoo/mplads_backend/blob/main/auth/auth.py"
click node_user_service "https://github.com/brihansahoo/mplads_backend/blob/main/services/user_service.py"
click node_user_schema "https://github.com/brihansahoo/mplads_backend/blob/main/schemas/user_schema.py"
click node_dashboard_service "https://github.com/brihansahoo/mplads_backend/blob/main/services/dashboard_service.py"
click node_project_service "https://github.com/brihansahoo/mplads_backend/blob/main/services/project_service.py"
click node_risk_service "https://github.com/brihansahoo/mplads_backend/blob/main/ml_model/service/risk_service.py"
click node_project_schema "https://github.com/brihansahoo/mplads_backend/blob/main/schemas/project_schema.py"
click node_document_service "https://github.com/brihansahoo/mplads_backend/blob/main/services/document_service.py"
click node_report_service "https://github.com/brihansahoo/mplads_backend/blob/main/services/reports_service.py"
click node_cloudinary_service "https://github.com/brihansahoo/mplads_backend/blob/main/services/cloudinary_service.py"
click node_database "https://github.com/brihansahoo/mplads_backend/blob/main/database/database.py"
click node_settings "https://github.com/brihansahoo/mplads_backend/blob/main/config/config.py"

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_application,node_dashboard_router,node_project_router,node_document_router,node_report_router,node_user_router,node_client toneBlue
class node_auth,node_user_service,node_user_schema,node_supabase toneAmber
class node_dashboard_service,node_project_service,node_risk_service,node_project_schema,node_document_service,node_report_service toneMint
class node_cloudinary_service,node_database,node_settings toneRose
```

## Components

### API routing

- [FastAPI app](https://github.com/brihansahoo/mplads_backend/blob/main/main.py): `main.py`
- [Dashboard routes](https://github.com/brihansahoo/mplads_backend/blob/main/routers/dashboard_router.py): `routers/dashboard_router.py`
- [Project routes](https://github.com/brihansahoo/mplads_backend/blob/main/routers/projects_route.py): `routers/projects_route.py`
- [Document routes](https://github.com/brihansahoo/mplads_backend/blob/main/routers/document_router.py): `routers/document_router.py`
- [Report routes](https://github.com/brihansahoo/mplads_backend/blob/main/routers/report_route.py): `routers/report_route.py`
- [User routes](https://github.com/brihansahoo/mplads_backend/blob/main/routers/user_router.py): `routers/user_router.py`

### Identity and users

- [Token authentication](https://github.com/brihansahoo/mplads_backend/blob/main/auth/auth.py): `auth/auth.py`
- [User accounts](https://github.com/brihansahoo/mplads_backend/blob/main/services/user_service.py): `services/user_service.py`
- [User request schemas](https://github.com/brihansahoo/mplads_backend/blob/main/schemas/user_schema.py): `schemas/user_schema.py`

### Project oversight

- [Dashboard metrics](https://github.com/brihansahoo/mplads_backend/blob/main/services/dashboard_service.py): `services/dashboard_service.py`
- [Project lifecycle](https://github.com/brihansahoo/mplads_backend/blob/main/services/project_service.py): `services/project_service.py`
- [Risk scoring](https://github.com/brihansahoo/mplads_backend/blob/main/ml_model/service/risk_service.py): `ml_model/service/risk_service.py`
- [Project and risk schemas](https://github.com/brihansahoo/mplads_backend/blob/main/schemas/project_schema.py): `schemas/project_schema.py`
- [Document retrieval](https://github.com/brihansahoo/mplads_backend/blob/main/services/document_service.py): `services/document_service.py`
- [Project reporting](https://github.com/brihansahoo/mplads_backend/blob/main/services/reports_service.py): `services/reports_service.py`

### Data and integrations

- [File upload service](https://github.com/brihansahoo/mplads_backend/blob/main/services/cloudinary_service.py): `services/cloudinary_service.py`
- [Supabase client](https://github.com/brihansahoo/mplads_backend/blob/main/database/database.py): `database/database.py`
- [Runtime settings](https://github.com/brihansahoo/mplads_backend/blob/main/config/config.py): `config/config.py`

### Other components

- **API client**
- **Supabase**

## Connections

- API client → FastAPI app: sends requests (evidence: `main.py`)
- FastAPI app → Dashboard routes: registers routes (evidence: `main.py`)
- FastAPI app → Project routes: registers routes (evidence: `main.py`)
- FastAPI app → Document routes: registers routes (evidence: `main.py`)
- FastAPI app → Report routes: registers routes (evidence: `main.py`)
- FastAPI app → User routes: registers routes (evidence: `main.py`)
- Dashboard routes → Token authentication: depends on (evidence: `routers/dashboard_router.py`)
- Dashboard routes → Dashboard metrics: calls metrics (evidence: `routers/dashboard_router.py`)
- Project routes → Token authentication: depends on (evidence: `routers/projects_route.py`)
- Project routes → Project lifecycle: calls project logic (evidence: `routers/projects_route.py`)
- Project routes → Project and risk schemas: uses schemas (evidence: `routers/projects_route.py`)
- Document routes → Token authentication: depends on (evidence: `routers/document_router.py`)
- Document routes → Document retrieval: calls retrieval (evidence: `routers/document_router.py`)
- Report routes → Token authentication: depends on (evidence: `routers/report_route.py`)
- Report routes → Project reporting: calls reports (evidence: `routers/report_route.py`)
- User routes → Token authentication: depends on (evidence: `routers/user_router.py`)
- User routes → User accounts: calls account logic (evidence: `routers/user_router.py`)
- User routes → User request schemas: accepts requests (evidence: `routers/user_router.py`)
- User accounts → Token authentication: creates tokens (evidence: `services/user_service.py`)
- Token authentication → Runtime settings: reads JWT settings (evidence: `auth/auth.py`)
- Project lifecycle → Supabase client: queries projects (evidence: `services/project_service.py`)
- Project lifecycle → Risk scoring: scores projects (evidence: `services/project_service.py`)
- Project lifecycle → File upload service: uploads files (evidence: `services/project_service.py`)
- Project lifecycle → Project and risk schemas: uses project models (evidence: `services/project_service.py`)
- Dashboard metrics → Supabase client: queries projects (evidence: `services/dashboard_service.py`)
- Dashboard metrics → Project and risk schemas: uses project types (evidence: `services/dashboard_service.py`)
- Document retrieval → Supabase client: queries documents (evidence: `services/document_service.py`)
- Project reporting → Supabase client: queries report data (evidence: `services/reports_service.py`)
- User accounts → Supabase client: queries accounts (evidence: `services/user_service.py`)
- User accounts → User request schemas: uses account models (evidence: `services/user_service.py`)
- Supabase client → Runtime settings: reads connection settings (evidence: `database/database.py`)
- Supabase client → Supabase: creates client (evidence: `database/database.py`)
- File upload service → Runtime settings: reads credentials (evidence: `services/cloudinary_service.py`)
