# heera0812/drillsarthi architecture

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

- Interactive diagram: https://gitdiagram.com/heera0812/drillsarthi
- Repository: https://github.com/heera0812/drillsarthi

## Overview

eRTMAC-NWIS is an offline well-document intelligence system. Users upload scanned drilling reports; the backend rasterizes and extracts page text, well fields, and hazards, then indexes and stores the results for corpus browsing, mapping, risk checks, reports, and cited DrillMind answers. Human corrections are saved and preferred for later use. The graph follows the documented upload and query capabilities; some page-to-endpoint wiring is represented only at the API-client boundary because not every router implementation was excerpted.

Main entry points: [`ertmac-nwis/src/App.jsx`](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/App.jsx) (React application), [`backend/main.py`](https://github.com/heera0812/drillsarthi/blob/main/backend/main.py) (FastAPI app), [`ertmac-nwis/src/api/client.js`](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/api/client.js) (HTTP client), [`backend/src/unified_parser.py`](https://github.com/heera0812/drillsarthi/blob/main/backend/src/unified_parser.py) (VLM extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_app["React application<br/>[App.jsx]"]
  node_upload_ui["Upload<br/>[Upload.jsx]"]
  node_corpus_ui["Corpus review<br/>[Corpus.jsx]"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.jsx]"]
  node_map_ui["Well map<br/>[MapVisualise.jsx]"]
  node_risk_ui["Risk monitor<br/>[RiskMonitor.jsx]"]
  node_drillmind_ui["DrillMind chat<br/>[DrillMind.jsx]"]
  node_reports_ui["Summary reports<br/>[SummaryReports.jsx]"]
  node_well_ui["Well intelligence"]
  node_api_client["HTTP client<br/>[client.js]"]
end

subgraph group_api["Backend API"]
  node_backend["FastAPI app<br/>[main.py]"]
  node_upload_api["Upload endpoint<br/>[upload.py]"]
  node_corpus_api["Corpus endpoint<br/>[corpus.py]"]
  node_review_api["Review endpoint<br/>[review.py]"]
  node_risk_api["Risk endpoint<br/>[risk.py]"]
  node_map_api["Map endpoint<br/>[wells_map.py]"]
  node_dashboard_api["Dashboard endpoint<br/>[dashboard.py]"]
  node_chat_api["Chat endpoint<br/>[drillmind.py]"]
end

subgraph group_ingestion["Document ingestion"]
  node_rasterizer["PDF rasterizer<br/>[pdf_processor.py]"]
  node_extractor["VLM extraction<br/>[unified_parser.py]"]
  node_figures["Figure extraction"]
  node_tables["Table reconstruction<br/>[table_parser.py]"]
end

subgraph group_intelligence["Search and analysis"]
  node_hazard["Hazard proximity<br/>[hazard_monitor.py]"]
  node_rag["Grounded RAG<br/>[rag_engine.py]"]
end

subgraph group_storage["Persistence"]
  node_sqlite[("SQLite corpus<br/>[database.py]")]
  node_vector[("Qdrant vector index<br/>[vector_store.py]")]
end

node_user(("User"))
node_ollama{{"Local Ollama model"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_upload_ui
node_app -->|"routes to"| node_corpus_ui
node_app -->|"routes to"| node_dashboard_ui
node_app -->|"routes to"| node_map_ui
node_app -->|"routes to"| node_risk_ui
node_app -->|"routes to"| node_drillmind_ui
node_app -->|"routes to"| node_reports_ui
node_app -->|"routes to"| node_well_ui
node_upload_ui -->|"sends requests"| node_api_client
node_corpus_ui -->|"sends requests"| node_api_client
node_dashboard_ui -->|"sends requests"| node_api_client
node_map_ui -->|"sends requests"| node_api_client
node_risk_ui -->|"sends requests"| node_api_client
node_drillmind_ui -->|"sends requests"| node_api_client
node_reports_ui -->|"sends requests"| node_api_client
node_well_ui -->|"sends requests"| node_api_client
node_api_client -.->|"HTTP requests"| node_backend
node_backend -->|"mounts"| node_upload_api
node_backend -->|"mounts"| node_corpus_api
node_backend -->|"mounts"| node_review_api
node_backend -->|"mounts"| node_risk_api
node_backend -->|"mounts"| node_map_api
node_backend -->|"mounts"| node_dashboard_api
node_backend -->|"mounts"| node_chat_api
node_upload_api -->|"rasterizes PDF"| node_rasterizer
node_upload_api -->|"starts extraction"| node_extractor
node_rasterizer -->|"provides page images"| node_extractor
node_extractor -->|"requests extraction"| node_ollama
node_extractor -->|"extracts figures"| node_figures
node_extractor -->|"reconstructs tables"| node_tables
node_extractor -->|"stores extracted records"| node_sqlite
node_extractor -->|"indexes page text"| node_vector
node_review_api -->|"reads and saves corrections"| node_sqlite
node_review_api -->|"renders tables"| node_tables
node_corpus_api -->|"reads corpus"| node_sqlite
node_dashboard_api -->|"reads totals"| node_sqlite
node_map_api -->|"reads wells"| node_sqlite
node_risk_api -->|"checks proximity"| node_hazard
node_hazard -.->|"reads hazards"| node_sqlite
node_chat_api -->|"asks question"| node_rag
node_rag -->|"retrieves passages"| node_vector
node_rag -->|"looks up well names"| node_sqlite
node_rag -->|"generates grounded answer"| node_ollama

click node_app "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/App.jsx"
click node_upload_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/Upload.jsx"
click node_corpus_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/Corpus.jsx"
click node_dashboard_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/Dashboard.jsx"
click node_map_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/MapVisualise.jsx"
click node_risk_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/RiskMonitor.jsx"
click node_drillmind_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/DrillMind.jsx"
click node_reports_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/SummaryReports.jsx"
click node_well_ui "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/WellIntelligence.jsx"
click node_api_client "https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/api/client.js"
click node_backend "https://github.com/heera0812/drillsarthi/blob/main/backend/main.py"
click node_upload_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/upload.py"
click node_corpus_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/corpus.py"
click node_review_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/review.py"
click node_risk_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/risk.py"
click node_map_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/wells_map.py"
click node_dashboard_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/dashboard.py"
click node_chat_api "https://github.com/heera0812/drillsarthi/blob/main/backend/routers/drillmind.py"
click node_rasterizer "https://github.com/heera0812/drillsarthi/blob/main/backend/src/pdf_processor.py"
click node_extractor "https://github.com/heera0812/drillsarthi/blob/main/backend/src/unified_parser.py"
click node_figures "https://github.com/heera0812/drillsarthi/blob/main/backend/src/figure_extractor.py"
click node_tables "https://github.com/heera0812/drillsarthi/blob/main/backend/src/table_parser.py"
click node_sqlite "https://github.com/heera0812/drillsarthi/blob/main/backend/src/database.py"
click node_vector "https://github.com/heera0812/drillsarthi/blob/main/backend/src/vector_store.py"
click node_hazard "https://github.com/heera0812/drillsarthi/blob/main/backend/src/hazard_monitor.py"
click node_rag "https://github.com/heera0812/drillsarthi/blob/main/backend/src/rag_engine.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_upload_ui,node_corpus_ui,node_dashboard_ui,node_map_ui,node_risk_ui,node_drillmind_ui,node_reports_ui,node_well_ui,node_api_client,node_user toneBlue
class node_backend,node_upload_api,node_corpus_api,node_review_api,node_risk_api,node_map_api,node_dashboard_api,node_chat_api toneAmber
class node_rasterizer,node_extractor,node_figures,node_tables toneMint
class node_hazard,node_rag toneRose
class node_sqlite,node_vector,node_ollama toneIndigo
```

## Components

### User interface

- [React application](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/App.jsx): `ertmac-nwis/src/App.jsx`
- [Upload](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/Upload.jsx): `ertmac-nwis/src/pages/Upload.jsx`
- [Corpus review](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/Corpus.jsx): `ertmac-nwis/src/pages/Corpus.jsx`
- [Dashboard](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/Dashboard.jsx): `ertmac-nwis/src/pages/Dashboard.jsx`
- [Well map](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/MapVisualise.jsx): `ertmac-nwis/src/pages/MapVisualise.jsx`
- [Risk monitor](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/RiskMonitor.jsx): `ertmac-nwis/src/pages/RiskMonitor.jsx`
- [DrillMind chat](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/DrillMind.jsx): `ertmac-nwis/src/pages/DrillMind.jsx`
- [Summary reports](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/SummaryReports.jsx): `ertmac-nwis/src/pages/SummaryReports.jsx`
- [Well intelligence](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/pages/WellIntelligence.jsx): `ertmac-nwis/src/pages/WellIntelligence.jsx`
- [HTTP client](https://github.com/heera0812/drillsarthi/blob/main/ertmac-nwis/src/api/client.js): `ertmac-nwis/src/api/client.js`

### Backend API

- [FastAPI app](https://github.com/heera0812/drillsarthi/blob/main/backend/main.py): `backend/main.py`
- [Upload endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/upload.py): `backend/routers/upload.py`
- [Corpus endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/corpus.py): `backend/routers/corpus.py`
- [Review endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/review.py): `backend/routers/review.py`
- [Risk endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/risk.py): `backend/routers/risk.py`
- [Map endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/wells_map.py): `backend/routers/wells_map.py`
- [Dashboard endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/dashboard.py): `backend/routers/dashboard.py`
- [Chat endpoint](https://github.com/heera0812/drillsarthi/blob/main/backend/routers/drillmind.py): `backend/routers/drillmind.py`

### Document ingestion

- [PDF rasterizer](https://github.com/heera0812/drillsarthi/blob/main/backend/src/pdf_processor.py): `backend/src/pdf_processor.py`
- [VLM extraction](https://github.com/heera0812/drillsarthi/blob/main/backend/src/unified_parser.py): `backend/src/unified_parser.py`
- [Figure extraction](https://github.com/heera0812/drillsarthi/blob/main/backend/src/figure_extractor.py): `backend/src/figure_extractor.py`
- [Table reconstruction](https://github.com/heera0812/drillsarthi/blob/main/backend/src/table_parser.py): `backend/src/table_parser.py`

### Search and analysis

- [Hazard proximity](https://github.com/heera0812/drillsarthi/blob/main/backend/src/hazard_monitor.py): `backend/src/hazard_monitor.py`
- [Grounded RAG](https://github.com/heera0812/drillsarthi/blob/main/backend/src/rag_engine.py): `backend/src/rag_engine.py`

### Persistence

- [SQLite corpus](https://github.com/heera0812/drillsarthi/blob/main/backend/src/database.py): `backend/src/database.py`
- [Qdrant vector index](https://github.com/heera0812/drillsarthi/blob/main/backend/src/vector_store.py): `backend/src/vector_store.py`

### Other components

- **User**
- **Local Ollama model**

## Connections

- User → React application: uses (evidence: `README.md`)
- React application → Upload: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → Corpus review: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → Dashboard: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → Well map: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → Risk monitor: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → DrillMind chat: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → Summary reports: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- React application → Well intelligence: routes to (evidence: `ertmac-nwis/src/App.jsx`)
- Upload → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/Upload.jsx`)
- Corpus review → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/Corpus.jsx`)
- Dashboard → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/Dashboard.jsx`)
- Well map → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/MapVisualise.jsx`)
- Risk monitor → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/RiskMonitor.jsx`)
- DrillMind chat → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/DrillMind.jsx`)
- Summary reports → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/SummaryReports.jsx`)
- Well intelligence → HTTP client: sends requests (evidence: `ertmac-nwis/src/pages/WellIntelligence.jsx`)
- HTTP client → FastAPI app: HTTP requests
- FastAPI app → Upload endpoint: mounts (evidence: `backend/main.py`)
- FastAPI app → Corpus endpoint: mounts (evidence: `backend/main.py`)
- FastAPI app → Review endpoint: mounts (evidence: `backend/main.py`)
- FastAPI app → Risk endpoint: mounts (evidence: `backend/main.py`)
- FastAPI app → Map endpoint: mounts (evidence: `backend/main.py`)
- FastAPI app → Dashboard endpoint: mounts (evidence: `backend/main.py`)
- FastAPI app → Chat endpoint: mounts (evidence: `backend/main.py`)
- Upload endpoint → PDF rasterizer: rasterizes PDF (evidence: `backend/routers/upload.py`)
- Upload endpoint → VLM extraction: starts extraction (evidence: `backend/routers/upload.py`)
- PDF rasterizer → VLM extraction: provides page images (evidence: `README.md`)
- VLM extraction → Local Ollama model: requests extraction (evidence: `README.md`)
- VLM extraction → Figure extraction: extracts figures (evidence: `backend/src/unified_parser.py`)
- VLM extraction → Table reconstruction: reconstructs tables (evidence: `backend/src/unified_parser.py`)
- VLM extraction → SQLite corpus: stores extracted records (evidence: `backend/src/unified_parser.py`)
- VLM extraction → Qdrant vector index: indexes page text (evidence: `backend/src/unified_parser.py`)
- Review endpoint → SQLite corpus: reads and saves corrections (evidence: `backend/routers/review.py`)
- Review endpoint → Table reconstruction: renders tables (evidence: `backend/routers/review.py`)
- Corpus endpoint → SQLite corpus: reads corpus (evidence: `backend/routers/corpus.py`)
- Dashboard endpoint → SQLite corpus: reads totals (evidence: `backend/routers/dashboard.py`)
- Map endpoint → SQLite corpus: reads wells (evidence: `backend/routers/wells_map.py`)
- Risk endpoint → Hazard proximity: checks proximity (evidence: `backend/routers/risk.py`)
- Hazard proximity → SQLite corpus: reads hazards
- Chat endpoint → Grounded RAG: asks question (evidence: `backend/routers/drillmind.py`)
- Grounded RAG → Qdrant vector index: retrieves passages (evidence: `backend/src/rag_engine.py`)
- Grounded RAG → SQLite corpus: looks up well names (evidence: `backend/src/rag_engine.py`)
- Grounded RAG → Local Ollama model: generates grounded answer (evidence: `backend/src/rag_engine.py`)
