# milan-019/sahay_ai architecture

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

- Interactive diagram: https://gitdiagram.com/milan-019/sahay_ai
- Repository: https://github.com/milan-019/sahay_ai

## Overview

Sahay-AI is a FastAPI backend for rural-business feasibility advice and credit navigation. Its principal full-report workflow evaluates a proposed business, matches eligible financing schemes, routes the best offer to a nearby partner, and can add document-readiness status. Separate endpoints expose scheme matching, EMI schedules, DigiLocker verification, and document checks. The graph follows the sampled router calls and documented capabilities; unsampled internals are represented only where the source index or explicit documentation supports them.

Main entry points: [`routers/advisory.py`](https://github.com/milan-019/sahay_ai/blob/main/routers/advisory.py) (Advisory endpoints), [`routers/sih_schemes.py`](https://github.com/milan-019/sahay_ai/blob/main/routers/sih_schemes.py) (Scheme endpoints), [`main.py`](https://github.com/milan-019/sahay_ai/blob/main/main.py) (FastAPI app), [`engine/feasibility.py`](https://github.com/milan-019/sahay_ai/blob/main/engine/feasibility.py) (Feasibility analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_app["FastAPI app<br/>[main.py]"]
  node_advisory_api["Advisory endpoints<br/>[advisory.py]"]
  node_scheme_api["Scheme endpoints<br/>[sih_schemes.py]"]
end

subgraph group_advisory["Business advisory"]
  node_feasibility["Feasibility analysis<br/>[feasibility.py]"]
end

subgraph group_credit["Credit and readiness"]
  node_finance["Scheme and EMI engine<br/>[finance.py]"]
  node_documents["Document readiness"]
end

subgraph group_routing["Partner routing"]
  node_spatial["Partner routing engine<br/>[spatial.py]"]
  node_postgis[("PostGIS database")]
end

node_client(("API client"))
node_osm{{"OpenStreetMap"}}
node_genai{{"Generative AI"}}
node_digilocker{{"DigiLocker service"}}

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_advisory_api
node_app -->|"mounts routes"| node_scheme_api
node_advisory_api -->|"requests analysis"| node_feasibility
node_feasibility -->|"queries competitors"| node_osm
node_feasibility -->|"generates synthesis"| node_genai
node_advisory_api -->|"matches schemes"| node_finance
node_advisory_api -->|"routes application"| node_spatial
node_advisory_api -->|"checks readiness"| node_documents
node_scheme_api -->|"matches and calculates EMI"| node_finance
node_scheme_api -->|"checks documents"| node_documents
node_scheme_api -->|"exchanges tokens and fetches records"| node_digilocker
node_spatial -.->|"queries eligible branches"| node_postgis

click node_app "https://github.com/milan-019/sahay_ai/blob/main/main.py"
click node_advisory_api "https://github.com/milan-019/sahay_ai/blob/main/routers/advisory.py"
click node_scheme_api "https://github.com/milan-019/sahay_ai/blob/main/routers/sih_schemes.py"
click node_feasibility "https://github.com/milan-019/sahay_ai/blob/main/engine/feasibility.py"
click node_finance "https://github.com/milan-019/sahay_ai/blob/main/engine/finance.py"
click node_documents "https://github.com/milan-019/sahay_ai/blob/main/engine/document_readiness.py"
click node_spatial "https://github.com/milan-019/sahay_ai/blob/main/engine/spatial.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_app,node_advisory_api,node_scheme_api,node_client toneBlue
class node_feasibility toneAmber
class node_finance,node_documents toneMint
class node_spatial,node_postgis toneRose
class node_osm,node_genai,node_digilocker toneIndigo
```

## Components

### API workflows

- [FastAPI app](https://github.com/milan-019/sahay_ai/blob/main/main.py): `main.py`
- [Advisory endpoints](https://github.com/milan-019/sahay_ai/blob/main/routers/advisory.py): `routers/advisory.py`
- [Scheme endpoints](https://github.com/milan-019/sahay_ai/blob/main/routers/sih_schemes.py): `routers/sih_schemes.py`

### Business advisory

- [Feasibility analysis](https://github.com/milan-019/sahay_ai/blob/main/engine/feasibility.py): `engine/feasibility.py`

### Credit and readiness

- [Scheme and EMI engine](https://github.com/milan-019/sahay_ai/blob/main/engine/finance.py): `engine/finance.py`
- [Document readiness](https://github.com/milan-019/sahay_ai/blob/main/engine/document_readiness.py): `engine/document_readiness.py`

### Partner routing

- [Partner routing engine](https://github.com/milan-019/sahay_ai/blob/main/engine/spatial.py): `engine/spatial.py`
- **PostGIS database**

### Other components

- **API client**
- **OpenStreetMap**
- **Generative AI**
- **DigiLocker service**

## Connections

- API client → FastAPI app: sends requests (evidence: `main.py`)
- FastAPI app → Advisory endpoints: mounts routes (evidence: `main.py`)
- FastAPI app → Scheme endpoints: mounts routes (evidence: `main.py`)
- Advisory endpoints → Feasibility analysis: requests analysis (evidence: `routers/advisory.py`)
- Feasibility analysis → OpenStreetMap: queries competitors (evidence: `engine/feasibility.py`)
- Feasibility analysis → Generative AI: generates synthesis (evidence: `engine/feasibility.py`)
- Advisory endpoints → Scheme and EMI engine: matches schemes (evidence: `routers/advisory.py`)
- Advisory endpoints → Partner routing engine: routes application (evidence: `routers/advisory.py`)
- Advisory endpoints → Document readiness: checks readiness (evidence: `routers/advisory.py`)
- Scheme endpoints → Scheme and EMI engine: matches and calculates EMI (evidence: `routers/sih_schemes.py`)
- Scheme endpoints → Document readiness: checks documents (evidence: `routers/sih_schemes.py`)
- Scheme endpoints → DigiLocker service: exchanges tokens and fetches records (evidence: `routers/sih_schemes.py`)
- Partner routing engine → PostGIS database: queries eligible branches (evidence: `engine/spatial.py`)
