# gallikattip-pixel/sih26103 architecture

> Architecture diagram of the GitHub repository gallikattip-pixel/sih26103, 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/gallikattip-pixel/sih26103
- Repository: https://github.com/gallikattip-pixel/sih26103

## Overview

INFRAPLUS is an infrastructure-project monitoring and risk-analysis platform. Officers authenticate, then explore executive dashboard metrics and project listings or inspect a project’s 360° details; the risk audit exposes the deterministic scoring, while the assistant provides grounded AI answers. The React client calls FastAPI, whose services retrieve project data from Firebase, calculate risk, aggregate dashboard metrics, and handle document storage. Gemini supplies explanations, not official risk scores. Connections beyond the sampled excerpts are included only where the README documents them; unsampled implementation details are not inferred.

Main entry points: [`backend/app/api/chat.py`](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/chat.py) (AI chat API), [`frontend/src/services/api.ts`](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/services/api.ts) (API client), [`backend/app/services/project_service.py`](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/project_service.py) (Project analytics), [`backend/app/api/projects.py`](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/projects.py) (Projects API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Officer application"]
  node_auth_ui["Authentication UI<br/>[AuthContext.tsx]"]
  node_firebase_web["Firebase web client<br/>[firebase.ts]"]
  node_app_routes["Application routes<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_dashboard_ui["Executive dashboard<br/>[DashboardPage.tsx]"]
  node_projects_ui["Project explorer<br/>[ProjectsPage.tsx]"]
  node_detail_ui["Project 360 view"]
  node_risk_ui["Risk audit portal<br/>[RiskEnginePage.tsx]"]
  node_assistant_ui["AI assistant"]
end

subgraph group_backend["API and domain services"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_dashboard_api["Dashboard API<br/>[dashboard.py]"]
  node_projects_api["Projects API<br/>[projects.py]"]
  node_chat_api["AI chat API<br/>[chat.py]"]
  node_storage_api["Document API<br/>[storage.py]"]
  node_project_service["Project analytics<br/>[project_service.py]"]
  node_risk_engine["Deterministic risk engine<br/>[risk_engine.py]"]
  node_dashboard_service["Dashboard aggregation"]
  node_query_engine["Domain query matching<br/>[query_engine.py]"]
  node_gemini_service["Grounded AI service<br/>[gemini_service.py]"]
  node_storage_service["Document storage<br/>[storage_service.py]"]
  node_project_models["Project domain models<br/>[project.py]"]
end

subgraph group_data["Persistence and integrations"]
  node_firebase_service["Firebase data access"]
  node_realtime_db[("Firebase Realtime DB")]
  node_cloud_storage[("Cloud document storage")]
  node_gemini["Google Gemini"]
end

subgraph group_platform["Backend controls"]
  node_security["Token verification<br/>[security.py]"]
  node_rate_limiter["Rate limiter<br/>[rate_limiter.py]"]
end

node_officer(("Officer"))

node_officer -->|"uses"| node_app_routes
node_app_routes -->|"provides auth"| node_auth_ui
node_auth_ui -->|"uses"| node_firebase_web
node_officer -->|"views metrics"| node_dashboard_ui
node_officer -->|"explores projects"| node_projects_ui
node_officer -->|"inspects project"| node_detail_ui
node_officer -->|"audits risk"| node_risk_ui
node_officer -->|"asks questions"| node_assistant_ui
node_dashboard_ui -->|"requests metrics"| node_api_client
node_risk_ui -->|"requests projects"| node_api_client
node_api_client -->|"HTTP requests"| node_dashboard_api
node_api_client -->|"HTTP requests"| node_projects_api
node_api_client -->|"HTTP requests"| node_chat_api
node_api_client -->|"HTTP requests"| node_storage_api
node_auth_api -->|"verifies tokens"| node_security
node_auth_api -->|"uses"| node_firebase_service
node_dashboard_api -->|"calls"| node_dashboard_service
node_dashboard_service -->|"aggregates projects"| node_project_service
node_projects_api -->|"calls"| node_project_service
node_chat_api -->|"retrieves project data"| node_project_service
node_chat_api -->|"matches questions"| node_query_engine
node_chat_api -->|"gets risk metrics"| node_risk_engine
node_chat_api -->|"requests grounded answers"| node_gemini_service
node_storage_api -->|"handles documents"| node_storage_service
node_project_service -->|"reads project data"| node_firebase_service
node_firebase_service -->|"reads and writes"| node_realtime_db
node_project_service -->|"calculates risk"| node_risk_engine
node_project_service -->|"parses records"| node_project_models
node_risk_engine -->|"scores projects"| node_project_models
node_dashboard_service -->|"uses domain records"| node_project_models
node_storage_service -->|"stores metadata"| node_firebase_service
node_storage_service -->|"stores documents"| node_cloud_storage
node_gemini_service -->|"generates explanations"| node_gemini
node_projects_api -->|"requires authorization"| node_security
node_chat_api -->|"requires authorization"| node_security
node_projects_api -->|"limits requests"| node_rate_limiter
node_chat_api -->|"limits requests"| node_rate_limiter
node_storage_api -->|"requires roles"| node_security
node_storage_api -->|"limits uploads"| node_rate_limiter

click node_auth_ui "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/context/AuthContext.tsx"
click node_firebase_web "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/services/firebase.ts"
click node_app_routes "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/services/api.ts"
click node_dashboard_ui "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/DashboardPage.tsx"
click node_projects_ui "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/ProjectsPage.tsx"
click node_detail_ui "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/ProjectDetailPage.tsx"
click node_risk_ui "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/RiskEnginePage.tsx"
click node_assistant_ui "https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/AiAssistantPage.tsx"
click node_auth_api "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/auth.py"
click node_dashboard_api "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/dashboard.py"
click node_projects_api "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/projects.py"
click node_chat_api "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/chat.py"
click node_storage_api "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/storage.py"
click node_project_service "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/project_service.py"
click node_risk_engine "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/risk_engine.py"
click node_dashboard_service "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/dashboard_service.py"
click node_query_engine "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/query_engine.py"
click node_gemini_service "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/gemini_service.py"
click node_storage_service "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/storage_service.py"
click node_firebase_service "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/firebase_service.py"
click node_security "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/core/security.py"
click node_rate_limiter "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/core/rate_limiter.py"
click node_project_models "https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/models/project.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_auth_ui,node_firebase_web,node_app_routes,node_api_client,node_dashboard_ui,node_projects_ui,node_detail_ui,node_risk_ui,node_assistant_ui toneBlue
class node_auth_api,node_dashboard_api,node_projects_api,node_chat_api,node_storage_api,node_project_service,node_risk_engine,node_dashboard_service,node_query_engine,node_gemini_service,node_storage_service,node_project_models toneAmber
class node_firebase_service,node_realtime_db,node_cloud_storage,node_gemini toneMint
class node_security,node_rate_limiter toneRose
class node_officer toneIndigo
```

## Components

### Officer application

- [Authentication UI](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Firebase web client](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/services/firebase.ts): `frontend/src/services/firebase.ts`
- [Application routes](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Executive dashboard](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/DashboardPage.tsx): `frontend/src/pages/DashboardPage.tsx`
- [Project explorer](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/ProjectsPage.tsx): `frontend/src/pages/ProjectsPage.tsx`
- [Project 360 view](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/ProjectDetailPage.tsx): `frontend/src/pages/ProjectDetailPage.tsx`
- [Risk audit portal](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/RiskEnginePage.tsx): `frontend/src/pages/RiskEnginePage.tsx`
- [AI assistant](https://github.com/gallikattip-pixel/sih26103/blob/main/frontend/src/pages/AiAssistantPage.tsx): `frontend/src/pages/AiAssistantPage.tsx`

### API and domain services

- [Authentication API](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Dashboard API](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/dashboard.py): `backend/app/api/dashboard.py`
- [Projects API](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/projects.py): `backend/app/api/projects.py`
- [AI chat API](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/chat.py): `backend/app/api/chat.py`
- [Document API](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/api/storage.py): `backend/app/api/storage.py`
- [Project analytics](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/project_service.py): `backend/app/services/project_service.py`
- [Deterministic risk engine](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/risk_engine.py): `backend/app/services/risk_engine.py`
- [Dashboard aggregation](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/dashboard_service.py): `backend/app/services/dashboard_service.py`
- [Domain query matching](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/query_engine.py): `backend/app/services/query_engine.py`
- [Grounded AI service](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/gemini_service.py): `backend/app/services/gemini_service.py`
- [Document storage](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/storage_service.py): `backend/app/services/storage_service.py`
- [Project domain models](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/models/project.py): `backend/app/models/project.py`

### Persistence and integrations

- [Firebase data access](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/services/firebase_service.py): `backend/app/services/firebase_service.py`
- **Firebase Realtime DB**
- **Cloud document storage**
- **Google Gemini**

### Backend controls

- [Token verification](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Rate limiter](https://github.com/gallikattip-pixel/sih26103/blob/main/backend/app/core/rate_limiter.py): `backend/app/core/rate_limiter.py`

### Other components

- **Officer**

## Connections

- Officer → Application routes: uses
- Application routes → Authentication UI: provides auth (evidence: `frontend/src/App.tsx`)
- Authentication UI → Firebase web client: uses (evidence: `frontend/src/context/AuthContext.tsx`)
- Officer → Executive dashboard: views metrics
- Officer → Project explorer: explores projects
- Officer → Project 360 view: inspects project
- Officer → Risk audit portal: audits risk (evidence: `frontend/src/pages/RiskEnginePage.tsx`)
- Officer → AI assistant: asks questions
- Executive dashboard → API client: requests metrics (evidence: `frontend/src/pages/DashboardPage.tsx`)
- Risk audit portal → API client: requests projects (evidence: `frontend/src/pages/RiskEnginePage.tsx`)
- API client → Dashboard API: HTTP requests
- API client → Projects API: HTTP requests
- API client → AI chat API: HTTP requests
- API client → Document API: HTTP requests
- Authentication API → Token verification: verifies tokens (evidence: `backend/app/api/auth.py`)
- Authentication API → Firebase data access: uses (evidence: `backend/app/api/auth.py`)
- Dashboard API → Dashboard aggregation: calls (evidence: `backend/app/api/dashboard.py`)
- Dashboard aggregation → Project analytics: aggregates projects (evidence: `backend/app/services/dashboard_service.py`)
- Projects API → Project analytics: calls (evidence: `backend/app/api/projects.py`)
- AI chat API → Project analytics: retrieves project data (evidence: `backend/app/api/chat.py`)
- AI chat API → Domain query matching: matches questions (evidence: `backend/app/api/chat.py`)
- AI chat API → Deterministic risk engine: gets risk metrics (evidence: `backend/app/api/chat.py`)
- AI chat API → Grounded AI service: requests grounded answers (evidence: `backend/app/api/chat.py`)
- Document API → Document storage: handles documents (evidence: `backend/app/api/storage.py`)
- Project analytics → Firebase data access: reads project data (evidence: `backend/app/services/project_service.py`)
- Firebase data access → Firebase Realtime DB: reads and writes
- Project analytics → Deterministic risk engine: calculates risk (evidence: `backend/app/services/project_service.py`)
- Project analytics → Project domain models: parses records (evidence: `backend/app/services/project_service.py`)
- Deterministic risk engine → Project domain models: scores projects (evidence: `backend/app/services/risk_engine.py`)
- Dashboard aggregation → Project domain models: uses domain records (evidence: `backend/app/services/dashboard_service.py`)
- Document storage → Firebase data access: stores metadata (evidence: `backend/app/services/storage_service.py`)
- Document storage → Cloud document storage: stores documents
- Grounded AI service → Google Gemini: generates explanations
- Projects API → Token verification: requires authorization (evidence: `backend/app/api/projects.py`)
- AI chat API → Token verification: requires authorization (evidence: `backend/app/api/chat.py`)
- Projects API → Rate limiter: limits requests (evidence: `backend/app/api/projects.py`)
- AI chat API → Rate limiter: limits requests (evidence: `backend/app/api/chat.py`)
- Document API → Token verification: requires roles (evidence: `backend/app/api/storage.py`)
- Document API → Rate limiter: limits uploads (evidence: `backend/app/api/storage.py`)
