# rahul-d14092007-code/india-progress-tracker architecture

> Architecture diagram of the GitHub repository rahul-d14092007-code/india-progress-tracker, 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/rahul-d14092007-code/india-progress-tracker
- Repository: https://github.com/rahul-d14092007-code/india-progress-tracker

## Overview

India Progress Tracker is a citizen-facing portal for exploring government projects, ministries, officials, states, schemes, budgets, grievances, and resource maps. The main workflow is browsing dashboard and domain pages, which draw on shared datasets and API routes; project APIs can also use Prisma-backed storage. A separate restricted admin portal supports authentication and management routes. README and the source index establish several capabilities and module references, but many page implementations and service integrations were not sampled, so uncertain runtime links are omitted.

Main entry points: [`src/app/page.tsx`](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/page.tsx) (Dashboard), [`src/components/IndiaInteractiveResourceMap.tsx`](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/components/IndiaInteractiveResourceMap.tsx) (Interactive maps), [`admin-portal/src/index.ts`](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/index.ts) (Admin server), [`src/app/api/v1/officials/route.ts`](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/v1/officials/route.ts) (Officials API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public portal"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_domain_pages["Domain pages"]
  node_analytics["Analytics<br/>[page.tsx]"]
  node_grievances_ui["Grievances UI<br/>[page.tsx]"]
  node_maps["Interactive maps"]
  node_charts["Charts<br/>[Charts.tsx]"]
  node_api_routes["Portal APIs"]
  node_officials_api["Officials API<br/>[route.ts]"]
  node_district_api["District API<br/>[route.ts]"]
  node_project_api["Projects API<br/>[route.ts]"]
end

subgraph group_domain["National data"]
  node_official_data["Officials records"]
  node_gov_heads["Government heads<br/>[gov-heads.ts]"]
  node_shared_data["Core datasets<br/>[data.ts]"]
  node_projects_data["Projects dataset"]
  node_ministries_data["Ministries dataset"]
  node_states_data["States and districts"]
  node_resource_data["Resource locations"]
  node_goi_client["Government API client<br/>[goi-api.ts]"]
  node_prisma["Prisma access<br/>[prisma.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_app["Admin server<br/>[index.ts]"]
  node_admin_auth["Admin authentication<br/>[auth.routes.ts]"]
  node_admin_security["Auth and roles<br/>[auth.middleware.ts]"]
  node_admin_projects["Project management<br/>[projects.routes.ts]"]
  node_admin_users["User management<br/>[users.routes.ts]"]
end

subgraph group_services["Project services"]
  node_project_service["Project controller"]
  node_project_db[("Project database<br/>[database.ts]")]
  node_project_cache[("Redis cache<br/>[redis.ts]")]
end

node_citizens(("Citizens"))
node_external_gov_data["Government data API"]
node_admin_operator(("Authorized administrators"))

node_citizens -->|"browse"| node_dashboard
node_citizens -->|"explore"| node_domain_pages
node_dashboard -->|"reads"| node_shared_data
node_dashboard -->|"requests"| node_goi_client
node_dashboard -->|"renders"| node_maps
node_dashboard -->|"renders"| node_charts
node_maps -->|"reads"| node_resource_data
node_maps -->|"reads"| node_states_data
node_maps -->|"reads"| node_shared_data
node_citizens -->|"query"| node_officials_api
node_officials_api -->|"reads"| node_official_data
node_officials_api -->|"reads"| node_gov_heads
node_citizens -->|"query"| node_district_api
node_district_api -->|"reads"| node_states_data
node_district_api -->|"reads"| node_shared_data
node_citizens -->|"query"| node_project_api
node_project_api -->|"fallback reads"| node_projects_data
node_project_api -->|"queries"| node_prisma
node_goi_client -->|"fetches"| node_external_gov_data
node_admin_operator -->|"accesses"| node_admin_app
node_admin_app -->|"mounts"| node_admin_auth
node_admin_app -->|"mounts"| node_admin_projects
node_admin_app -->|"mounts"| node_admin_users
node_admin_auth -->|"signs tokens"| node_admin_security
node_admin_projects -->|"checks roles"| node_admin_security
node_admin_users -->|"checks roles"| node_admin_security
node_project_service -->|"queries"| node_project_db
node_project_service -->|"uses cache"| node_project_cache

click node_dashboard "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/page.tsx"
click node_domain_pages "https://github.com/rahul-d14092007-code/india-progress-tracker/tree/main/src/app"
click node_analytics "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/analytics/page.tsx"
click node_grievances_ui "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/grievances/page.tsx"
click node_maps "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/components/IndiaInteractiveResourceMap.tsx"
click node_charts "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/components/Charts.tsx"
click node_api_routes "https://github.com/rahul-d14092007-code/india-progress-tracker/tree/main/src/app/api"
click node_officials_api "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/v1/officials/route.ts"
click node_district_api "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/v1/districts/route.ts"
click node_project_api "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/projects/route.ts"
click node_official_data "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/constitutional-officials.ts"
click node_gov_heads "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/gov-heads.ts"
click node_shared_data "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/data.ts"
click node_projects_data "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/full-projects-data.ts"
click node_ministries_data "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/full-ministries-data.ts"
click node_states_data "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/full-states-data.ts"
click node_resource_data "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/data/india-resources-geo.ts"
click node_goi_client "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/goi-api.ts"
click node_prisma "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/prisma.ts"
click node_admin_app "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/index.ts"
click node_admin_auth "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/routes/auth.routes.ts"
click node_admin_security "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/middleware/auth.middleware.ts"
click node_admin_projects "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/routes/projects.routes.ts"
click node_admin_users "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/routes/users.routes.ts"
click node_project_service "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/services/project-service/src/controllers/project.controller.ts"
click node_project_db "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/services/project-service/src/config/database.ts"
click node_project_cache "https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/services/project-service/src/config/redis.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_dashboard,node_domain_pages,node_analytics,node_grievances_ui,node_maps,node_charts,node_api_routes,node_officials_api,node_district_api,node_project_api toneBlue
class node_official_data,node_gov_heads,node_shared_data,node_projects_data,node_ministries_data,node_states_data,node_resource_data,node_goi_client,node_prisma toneAmber
class node_admin_app,node_admin_auth,node_admin_security,node_admin_projects,node_admin_users,node_external_gov_data toneMint
class node_project_service,node_project_db,node_project_cache toneRose
class node_citizens,node_admin_operator toneIndigo
```

## Components

### Public portal

- [Dashboard](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Domain pages](https://github.com/rahul-d14092007-code/india-progress-tracker/tree/main/src/app): `src/app`
- [Analytics](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/analytics/page.tsx): `src/app/analytics/page.tsx`
- [Grievances UI](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/grievances/page.tsx): `src/app/grievances/page.tsx`
- [Interactive maps](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/components/IndiaInteractiveResourceMap.tsx): `src/components/IndiaInteractiveResourceMap.tsx`
- [Charts](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/components/Charts.tsx): `src/components/Charts.tsx`
- [Portal APIs](https://github.com/rahul-d14092007-code/india-progress-tracker/tree/main/src/app/api): `src/app/api`
- [Officials API](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/v1/officials/route.ts): `src/app/api/v1/officials/route.ts`
- [District API](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/v1/districts/route.ts): `src/app/api/v1/districts/route.ts`
- [Projects API](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/app/api/projects/route.ts): `src/app/api/projects/route.ts`

### National data

- [Officials records](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/constitutional-officials.ts): `src/lib/constitutional-officials.ts`
- [Government heads](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/gov-heads.ts): `src/lib/gov-heads.ts`
- [Core datasets](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/data.ts): `src/lib/data.ts`
- [Projects dataset](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/full-projects-data.ts): `src/lib/full-projects-data.ts`
- [Ministries dataset](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/full-ministries-data.ts): `src/lib/full-ministries-data.ts`
- [States and districts](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/full-states-data.ts): `src/lib/full-states-data.ts`
- [Resource locations](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/data/india-resources-geo.ts): `src/data/india-resources-geo.ts`
- [Government API client](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/goi-api.ts): `src/lib/goi-api.ts`
- [Prisma access](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`

### Administration

- [Admin server](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/index.ts): `admin-portal/src/index.ts`
- [Admin authentication](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/routes/auth.routes.ts): `admin-portal/src/routes/auth.routes.ts`
- [Auth and roles](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/middleware/auth.middleware.ts): `admin-portal/src/middleware/auth.middleware.ts`
- [Project management](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/routes/projects.routes.ts): `admin-portal/src/routes/projects.routes.ts`
- [User management](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/admin-portal/src/routes/users.routes.ts): `admin-portal/src/routes/users.routes.ts`

### Project services

- [Project controller](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/services/project-service/src/controllers/project.controller.ts): `services/project-service/src/controllers/project.controller.ts`
- [Project database](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/services/project-service/src/config/database.ts): `services/project-service/src/config/database.ts`
- [Redis cache](https://github.com/rahul-d14092007-code/india-progress-tracker/blob/main/services/project-service/src/config/redis.ts): `services/project-service/src/config/redis.ts`

### Other components

- **Citizens**
- **Government data API**
- **Authorized administrators**

## Connections

- Citizens → Dashboard: browse (evidence: `README.md`)
- Citizens → Domain pages: explore (evidence: `README.md`)
- Dashboard → Core datasets: reads (evidence: `src/app/page.tsx`)
- Dashboard → Government API client: requests (evidence: `src/app/page.tsx`)
- Dashboard → Interactive maps: renders (evidence: `src/app/page.tsx`)
- Dashboard → Charts: renders (evidence: `src/app/page.tsx`)
- Interactive maps → Resource locations: reads (evidence: `src/components/IndiaInteractiveResourceMap.tsx`)
- Interactive maps → States and districts: reads (evidence: `src/components/IndiaInteractiveResourceMap.tsx`)
- Interactive maps → Core datasets: reads (evidence: `src/components/IndiaInteractiveResourceMap.tsx`)
- Citizens → Officials API: query (evidence: `README.md`)
- Officials API → Officials records: reads (evidence: `src/app/api/v1/officials/route.ts`)
- Officials API → Government heads: reads (evidence: `src/app/api/v1/officials/route.ts`)
- Citizens → District API: query (evidence: `README.md`)
- District API → States and districts: reads (evidence: `src/app/api/v1/districts/route.ts`)
- District API → Core datasets: reads (evidence: `src/app/api/v1/districts/route.ts`)
- Citizens → Projects API: query (evidence: `src/app/api/projects/route.ts`)
- Projects API → Projects dataset: fallback reads (evidence: `src/app/api/projects/route.ts`)
- Projects API → Prisma access: queries (evidence: `src/app/api/projects/route.ts`)
- Government API client → Government data API: fetches
- Authorized administrators → Admin server: accesses (evidence: `admin-portal/src/index.ts`)
- Admin server → Admin authentication: mounts (evidence: `admin-portal/src/index.ts`)
- Admin server → Project management: mounts (evidence: `admin-portal/src/index.ts`)
- Admin server → User management: mounts (evidence: `admin-portal/src/index.ts`)
- Admin authentication → Auth and roles: signs tokens (evidence: `admin-portal/src/routes/auth.routes.ts`)
- Project management → Auth and roles: checks roles (evidence: `admin-portal/src/routes/projects.routes.ts`)
- User management → Auth and roles: checks roles (evidence: `admin-portal/src/routes/users.routes.ts`)
- Project controller → Project database: queries (evidence: `services/project-service/src/controllers/project.controller.ts`)
- Project controller → Redis cache: uses cache (evidence: `services/project-service/src/controllers/project.controller.ts`)
