# vedantkarne/sme-ipo-drhp-generator architecture

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

- Interactive diagram: https://gitdiagram.com/vedantkarne/sme-ipo-drhp-generator
- Repository: https://github.com/vedantkarne/sme-ipo-drhp-generator

## Overview

Nirmaan AI guides SME promoters through company-data capture, eligibility screening, document ingestion, evidence-grounded DRHP drafting, review, and export. The graph combines the documented capabilities with source-index-supported relationships; several screen implementations and backend integrations were not sampled, so their internal links are omitted rather than inferred.

Main entry points: [`src/api/server.py`](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/server.py) (FastAPI application), [`src/agent/orchestrator.py`](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/orchestrator.py) (DRHP agent), [`frontend/src/App.jsx`](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/frontend/src/App.jsx) (Role-based application), [`src/api/document_upload_router.py`](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/document_upload_router.py) (Document upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_webapp["Role-based application<br/>[App.jsx]"]
  node_company_screens["Company workflow screens"]
  node_canvas["Document canvas"]
  node_canvas_api["Canvas API client<br/>[canvasApi.js]"]
end

subgraph group_api["Application API"]
  node_api_server["FastAPI application<br/>[server.py]"]
  node_auth["Authentication and access<br/>[auth_router.py]"]
  node_session["Session and eligibility routes<br/>[session_router.py]"]
  node_upload["Document upload"]
  node_finance["Finance review<br/>[finance_router.py]"]
  node_legal_review["Legal review"]
end

subgraph group_drafting["Drafting and review"]
  node_eligibility["Eligibility engine<br/>[checker.py]"]
  node_agent["DRHP agent<br/>[orchestrator.py]"]
  node_generation["Section assembly"]
  node_consistency["Consistency checks"]
end

subgraph group_knowledge["Evidence and data"]
  node_ingestion["Document parsing and chunking"]
  node_retrieval["Hybrid evidence retrieval"]
  node_embedder["BGE-M3 embeddings<br/>[bge_m3_embedder.py]"]
  node_vector_store[("Chroma vector store<br/>[vector_store.py]")]
  node_records[("Company and DRHP records<br/>[schema.py]")]
  node_db_session[("SQLite persistence<br/>[db_session.py]")]
end

node_promoter(("SME promoter"))
node_reviewers(("Professional reviewers"))
node_groq["Groq language model"]

node_promoter -->|"uses"| node_webapp
node_reviewers -->|"review in"| node_webapp
node_webapp -->|"routes to"| node_company_screens
node_webapp -->|"opens"| node_canvas
node_canvas -->|"uses"| node_canvas_api
node_canvas_api -->|"uses credentials"| node_auth
node_api_server -->|"registers routes"| node_auth
node_api_server -->|"registers routes"| node_session
node_api_server -->|"registers routes"| node_upload
node_api_server -->|"registers routes"| node_finance
node_api_server -->|"registers routes"| node_legal_review
node_session -->|"runs check"| node_eligibility
node_api_server -->|"runs drafting"| node_agent
node_api_server -->|"runs checks"| node_consistency
node_agent -->|"validates draft"| node_consistency
node_agent -->|"requests drafting"| node_groq
node_agent -.->|"retrieves evidence"| node_retrieval
node_upload -->|"processes uploads"| node_ingestion
node_upload -->|"stores chunks"| node_vector_store
node_ingestion -->|"embeds corpus"| node_embedder
node_ingestion -->|"indexes corpus"| node_vector_store
node_retrieval -->|"embeds queries"| node_embedder
node_retrieval -->|"searches"| node_vector_store
node_db_session -->|"maps schema"| node_records
node_auth -->|"uses sessions"| node_db_session
node_api_server -->|"reads and writes"| node_db_session
node_legal_review -->|"reads review state"| node_records
node_generation -.->|"assembles document"| node_records

click node_webapp "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/frontend/src/App.jsx"
click node_company_screens "https://github.com/vedantkarne/sme-ipo-drhp-generator/tree/main/frontend/src/screens"
click node_canvas "https://github.com/vedantkarne/sme-ipo-drhp-generator/tree/main/frontend/src/canvas/document"
click node_canvas_api "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/frontend/src/canvas/services/canvasApi.js"
click node_api_server "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/server.py"
click node_auth "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/auth_router.py"
click node_session "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/session_router.py"
click node_upload "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/document_upload_router.py"
click node_finance "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/finance_router.py"
click node_legal_review "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/legal_review_router.py"
click node_eligibility "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/eligibility/checker.py"
click node_agent "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/orchestrator.py"
click node_generation "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/document_assembler.py"
click node_consistency "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/consistency_checker.py"
click node_ingestion "https://github.com/vedantkarne/sme-ipo-drhp-generator/tree/main/src/ingestion"
click node_retrieval "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/retrieval/hybrid_retriever.py"
click node_embedder "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/retrieval/bge_m3_embedder.py"
click node_vector_store "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/retrieval/vector_store.py"
click node_records "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/extraction/schema.py"
click node_db_session "https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/extraction/db_session.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_webapp,node_company_screens,node_canvas,node_canvas_api,node_reviewers toneBlue
class node_api_server,node_auth,node_session,node_upload,node_finance,node_legal_review toneAmber
class node_eligibility,node_agent,node_generation,node_consistency toneMint
class node_ingestion,node_retrieval,node_embedder,node_vector_store,node_records,node_db_session toneRose
class node_promoter,node_groq toneIndigo
```

## Components

### User experience

- [Role-based application](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Company workflow screens](https://github.com/vedantkarne/sme-ipo-drhp-generator/tree/main/frontend/src/screens): `frontend/src/screens`
- [Document canvas](https://github.com/vedantkarne/sme-ipo-drhp-generator/tree/main/frontend/src/canvas/document): `frontend/src/canvas/document`
- [Canvas API client](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/frontend/src/canvas/services/canvasApi.js): `frontend/src/canvas/services/canvasApi.js`

### Application API

- [FastAPI application](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/server.py): `src/api/server.py`
- [Authentication and access](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/auth_router.py): `src/api/auth_router.py`
- [Session and eligibility routes](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/session_router.py): `src/api/session_router.py`
- [Document upload](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/document_upload_router.py): `src/api/document_upload_router.py`
- [Finance review](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/finance_router.py): `src/api/finance_router.py`
- [Legal review](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/api/legal_review_router.py): `src/api/legal_review_router.py`

### Drafting and review

- [Eligibility engine](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/eligibility/checker.py): `src/eligibility/checker.py`
- [DRHP agent](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/orchestrator.py): `src/agent/orchestrator.py`
- [Section assembly](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/document_assembler.py): `src/agent/document_assembler.py`
- [Consistency checks](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/agent/consistency_checker.py): `src/agent/consistency_checker.py`

### Evidence and data

- [Document parsing and chunking](https://github.com/vedantkarne/sme-ipo-drhp-generator/tree/main/src/ingestion): `src/ingestion`
- [Hybrid evidence retrieval](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/retrieval/hybrid_retriever.py): `src/retrieval/hybrid_retriever.py`
- [BGE-M3 embeddings](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/retrieval/bge_m3_embedder.py): `src/retrieval/bge_m3_embedder.py`
- [Chroma vector store](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/retrieval/vector_store.py): `src/retrieval/vector_store.py`
- [Company and DRHP records](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/extraction/schema.py): `src/extraction/schema.py`
- [SQLite persistence](https://github.com/vedantkarne/sme-ipo-drhp-generator/blob/main/src/extraction/db_session.py): `src/extraction/db_session.py`

### Other components

- **SME promoter**
- **Professional reviewers**
- **Groq language model**

## Connections

- SME promoter → Role-based application: uses (evidence: `README.md`)
- Professional reviewers → Role-based application: review in (evidence: `README.md`)
- Role-based application → Company workflow screens: routes to (evidence: `frontend/src/App.jsx`)
- Role-based application → Document canvas: opens (evidence: `frontend/src/App.jsx`)
- Document canvas → Canvas API client: uses (evidence: `frontend/src/canvas/CanvasRoot.jsx`)
- Canvas API client → Authentication and access: uses credentials (evidence: `frontend/src/canvas/services/canvasApi.js`)
- FastAPI application → Authentication and access: registers routes (evidence: `src/api/server.py`)
- FastAPI application → Session and eligibility routes: registers routes (evidence: `src/api/server.py`)
- FastAPI application → Document upload: registers routes (evidence: `src/api/server.py`)
- FastAPI application → Finance review: registers routes (evidence: `src/api/server.py`)
- FastAPI application → Legal review: registers routes (evidence: `src/api/server.py`)
- Session and eligibility routes → Eligibility engine: runs check (evidence: `src/api/session_router.py`)
- FastAPI application → DRHP agent: runs drafting (evidence: `src/api/server.py`)
- FastAPI application → Consistency checks: runs checks (evidence: `src/api/server.py`)
- DRHP agent → Consistency checks: validates draft (evidence: `src/agent/orchestrator.py`)
- DRHP agent → Groq language model: requests drafting (evidence: `src/agent/orchestrator.py`)
- DRHP agent → Hybrid evidence retrieval: retrieves evidence
- Document upload → Document parsing and chunking: processes uploads (evidence: `src/api/document_upload_router.py`)
- Document upload → Chroma vector store: stores chunks (evidence: `src/api/document_upload_router.py`)
- Document parsing and chunking → BGE-M3 embeddings: embeds corpus (evidence: `src/ingestion/runners/main_ingestion_runner.py`)
- Document parsing and chunking → Chroma vector store: indexes corpus (evidence: `src/ingestion/runners/main_ingestion_runner.py`)
- Hybrid evidence retrieval → BGE-M3 embeddings: embeds queries (evidence: `src/retrieval/hybrid_retriever.py`)
- Hybrid evidence retrieval → Chroma vector store: searches (evidence: `src/retrieval/hybrid_retriever.py`)
- SQLite persistence → Company and DRHP records: maps schema (evidence: `src/extraction/db_session.py`)
- Authentication and access → SQLite persistence: uses sessions (evidence: `src/api/auth_router.py`)
- FastAPI application → SQLite persistence: reads and writes (evidence: `src/api/server.py`)
- Legal review → Company and DRHP records: reads review state (evidence: `src/api/legal_review_router.py`)
- Section assembly → Company and DRHP records: assembles document
