# cb-acc-tech/hackathon2026 architecture

> Architecture diagram of the GitHub repository cb-acc-tech/hackathon2026, 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/cb-acc-tech/hackathon2026
- Repository: https://github.com/cb-acc-tech/hackathon2026

## Overview

RigMind-NWIS is a drilling decision-support platform for correlating an active well with historical hazards, monitoring telemetry, and surfacing evidence and recommendations. The primary workflow initializes a well, streams drilling data, evaluates risk, and retrieves historical evidence; separate capabilities cover spatial/trajectory views, report ingestion, and admin approval. The README documents the broad service relationships; excerpts confirm key routing and calls. Some implementation details are unsampled, so the graph avoids inferring unshown internal interactions.

Main entry points: [`frontend/src/App.jsx`](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/App.jsx) (UI Router), [`backend/src/app.js`](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/app.js) (Express API), [`ai-service/app/main.py`](https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/main.py) (AI Service API), [`frontend/src/context/WellContext.jsx`](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/context/WellContext.jsx) (Well State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operator UI"]
  node_app["UI Router<br/>[App.jsx]"]
  node_authctx["Auth State<br/>[AuthContext.jsx]"]
  node_wellctx["Well State<br/>[WellContext.jsx]"]
  node_login["Login<br/>[LoginPage.jsx]"]
  node_initialize["Well Initialization<br/>[InitializePage.jsx]"]
  node_map["Subsurface Map"]
  node_dashboard["Live Dashboard<br/>[DashboardPage.jsx]"]
  node_knowledge["Knowledge Base"]
  node_adminui["Admin Workflows<br/>[AdminPage.jsx]"]
  node_layout["Application Layout<br/>[MainLayout.jsx]"]
end

subgraph group_backend["Application Backend"]
  node_express["Express API<br/>[app.js]"]
  node_authroutes["Authentication API<br/>[auth.js]"]
  node_authmw["JWT Role Checks<br/>[auth.js]"]
  node_wells["Well Spatial Search<br/>[wells.js]"]
  node_historical["Historical Events<br/>[historical.js]"]
  node_telemetry["Telemetry Streaming<br/>[telemetry.js]"]
  node_dbpool["PostgreSQL Access<br/>[index.js]"]
end

subgraph group_ai["AI Decision Support"]
  node_aiapi["AI Service API<br/>[main.py]"]
  node_risk["Risk Evaluation<br/>[engine.py]"]
  node_geology["Dip Correction<br/>[dip_correction.py]"]
  node_rag["RAG and Reports<br/>[pipeline.py]"]
end

subgraph group_data["Well Knowledge Data"]
  node_database[("PostGIS Well Data<br/>[schema.sql]")]
end

node_engineer(("Field Engineer"))
node_admin(("Data Admin"))
node_vectorstore[("ChromaDB")]
node_llm["Groq / Gemini"]

node_engineer -->|"signs in"| node_login
node_admin -->|"signs in"| node_login
node_app -->|"provides auth"| node_authctx
node_app -->|"provides well state"| node_wellctx
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_initialize
node_app -->|"routes to"| node_map
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_knowledge
node_app -->|"role-gates"| node_adminui
node_app -->|"renders"| node_layout
node_login -->|"updates auth"| node_authctx
node_initialize -->|"sets active well"| node_wellctx
node_map -->|"reads well state"| node_wellctx
node_dashboard -->|"reads telemetry"| node_wellctx
node_dashboard -->|"navigates to"| node_knowledge
node_adminui -->|"reads role"| node_authctx
node_initialize -->|"REST requests"| node_express
node_map -->|"requests correction"| node_express
node_dashboard -->|"requests risk and evidence"| node_express
node_adminui -->|"uploads reports"| node_express
node_wellctx -->|"Socket.IO events"| node_telemetry
node_express -->|"mounts routes"| node_authroutes
node_express -->|"mounts routes"| node_wells
node_express -->|"mounts routes"| node_historical
node_express -->|"initializes"| node_telemetry
node_authroutes -->|"queries users"| node_dbpool
node_authroutes -->|"uses JWT secret"| node_authmw
node_historical -->|"queries events"| node_dbpool
node_historical -->|"verifies requests"| node_authmw
node_wells -->|"queries wells"| node_dbpool
node_express -->|"proxies AI requests"| node_aiapi
node_historical -->|"indexes approved event"| node_aiapi
node_dbpool -->|"queries"| node_database
node_aiapi -->|"evaluates telemetry"| node_risk
node_aiapi -->|"corrects depth"| node_geology
node_aiapi -->|"retrieves and processes reports"| node_rag
node_rag -.->|"indexes and retrieves"| node_vectorstore
node_rag -.->|"generates recommendations"| node_llm

click node_app "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/context/AuthContext.jsx"
click node_wellctx "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/context/WellContext.jsx"
click node_login "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/LoginPage.jsx"
click node_initialize "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/InitializePage.jsx"
click node_map "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/SubsurfaceMapPage.jsx"
click node_dashboard "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_knowledge "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/KnowledgeBasePage.jsx"
click node_adminui "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/AdminPage.jsx"
click node_layout "https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/layouts/MainLayout.jsx"
click node_express "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/app.js"
click node_authroutes "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/routes/auth.js"
click node_authmw "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/middleware/auth.js"
click node_wells "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/routes/wells.js"
click node_historical "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/routes/historical.js"
click node_telemetry "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/websocket/telemetry.js"
click node_dbpool "https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/db/index.js"
click node_aiapi "https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/main.py"
click node_risk "https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/risk/engine.py"
click node_geology "https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/geology/dip_correction.py"
click node_rag "https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/rag/pipeline.py"
click node_database "https://github.com/cb-acc-tech/hackathon2026/blob/main/database/schema.sql"

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_authctx,node_wellctx,node_login,node_initialize,node_map,node_dashboard,node_knowledge,node_adminui,node_layout toneBlue
class node_express,node_authroutes,node_authmw,node_wells,node_historical,node_telemetry,node_dbpool,node_vectorstore toneAmber
class node_aiapi,node_risk,node_geology,node_rag toneMint
class node_database toneRose
class node_engineer,node_admin,node_llm toneIndigo
```

## Components

### Operator UI

- [UI Router](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth State](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Well State](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/context/WellContext.jsx): `frontend/src/context/WellContext.jsx`
- [Login](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Well Initialization](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/InitializePage.jsx): `frontend/src/pages/InitializePage.jsx`
- [Subsurface Map](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/SubsurfaceMapPage.jsx): `frontend/src/pages/SubsurfaceMapPage.jsx`
- [Live Dashboard](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Knowledge Base](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/KnowledgeBasePage.jsx): `frontend/src/pages/KnowledgeBasePage.jsx`
- [Admin Workflows](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/pages/AdminPage.jsx): `frontend/src/pages/AdminPage.jsx`
- [Application Layout](https://github.com/cb-acc-tech/hackathon2026/blob/main/frontend/src/layouts/MainLayout.jsx): `frontend/src/layouts/MainLayout.jsx`

### Application Backend

- [Express API](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication API](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [JWT Role Checks](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Well Spatial Search](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/routes/wells.js): `backend/src/routes/wells.js`
- [Historical Events](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/routes/historical.js): `backend/src/routes/historical.js`
- [Telemetry Streaming](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/websocket/telemetry.js): `backend/src/websocket/telemetry.js`
- [PostgreSQL Access](https://github.com/cb-acc-tech/hackathon2026/blob/main/backend/src/db/index.js): `backend/src/db/index.js`

### AI Decision Support

- [AI Service API](https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/main.py): `ai-service/app/main.py`
- [Risk Evaluation](https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/risk/engine.py): `ai-service/app/risk/engine.py`
- [Dip Correction](https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/geology/dip_correction.py): `ai-service/app/geology/dip_correction.py`
- [RAG and Reports](https://github.com/cb-acc-tech/hackathon2026/blob/main/ai-service/app/rag/pipeline.py): `ai-service/app/rag/pipeline.py`

### Well Knowledge Data

- [PostGIS Well Data](https://github.com/cb-acc-tech/hackathon2026/blob/main/database/schema.sql): `database/schema.sql`

### Other components

- **Field Engineer**
- **Data Admin**
- **ChromaDB**
- **Groq / Gemini**

## Connections

- Field Engineer → Login: signs in (evidence: `README.md`)
- Data Admin → Login: signs in (evidence: `README.md`)
- UI Router → Auth State: provides auth (evidence: `frontend/src/App.jsx`)
- UI Router → Well State: provides well state (evidence: `frontend/src/App.jsx`)
- UI Router → Login: routes to (evidence: `frontend/src/App.jsx`)
- UI Router → Well Initialization: routes to (evidence: `frontend/src/App.jsx`)
- UI Router → Subsurface Map: routes to (evidence: `frontend/src/App.jsx`)
- UI Router → Live Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- UI Router → Knowledge Base: routes to (evidence: `frontend/src/App.jsx`)
- UI Router → Admin Workflows: role-gates (evidence: `frontend/src/App.jsx`)
- UI Router → Application Layout: renders (evidence: `frontend/src/App.jsx`)
- Login → Auth State: updates auth (evidence: `frontend/src/pages/LoginPage.jsx`)
- Well Initialization → Well State: sets active well (evidence: `frontend/src/pages/InitializePage.jsx`)
- Subsurface Map → Well State: reads well state (evidence: `frontend/src/pages/SubsurfaceMapPage.jsx`)
- Live Dashboard → Well State: reads telemetry (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Live Dashboard → Knowledge Base: navigates to (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Admin Workflows → Auth State: reads role (evidence: `frontend/src/pages/AdminPage.jsx`)
- Well Initialization → Express API: REST requests (evidence: `README.md`)
- Subsurface Map → Express API: requests correction (evidence: `README.md`)
- Live Dashboard → Express API: requests risk and evidence (evidence: `README.md`)
- Admin Workflows → Express API: uploads reports (evidence: `README.md`)
- Well State → Telemetry Streaming: Socket.IO events (evidence: `frontend/src/context/WellContext.jsx`)
- Express API → Authentication API: mounts routes (evidence: `backend/src/app.js`)
- Express API → Well Spatial Search: mounts routes (evidence: `backend/src/app.js`)
- Express API → Historical Events: mounts routes (evidence: `backend/src/app.js`)
- Express API → Telemetry Streaming: initializes (evidence: `backend/src/app.js`)
- Authentication API → PostgreSQL Access: queries users (evidence: `backend/src/routes/auth.js`)
- Authentication API → JWT Role Checks: uses JWT secret (evidence: `backend/src/routes/auth.js`)
- Historical Events → PostgreSQL Access: queries events (evidence: `backend/src/routes/historical.js`)
- Historical Events → JWT Role Checks: verifies requests (evidence: `backend/src/routes/historical.js`)
- Well Spatial Search → PostgreSQL Access: queries wells (evidence: `backend/src/routes/wells.js`)
- Express API → AI Service API: proxies AI requests (evidence: `backend/src/app.js`)
- Historical Events → AI Service API: indexes approved event (evidence: `backend/src/routes/historical.js`)
- PostgreSQL Access → PostGIS Well Data: queries (evidence: `README.md`)
- AI Service API → Risk Evaluation: evaluates telemetry (evidence: `ai-service/app/main.py`)
- AI Service API → Dip Correction: corrects depth (evidence: `ai-service/app/main.py`)
- AI Service API → RAG and Reports: retrieves and processes reports (evidence: `ai-service/app/main.py`)
- RAG and Reports → ChromaDB: indexes and retrieves (evidence: `README.md`)
- RAG and Reports → Groq / Gemini: generates recommendations (evidence: `README.md`)
