How nikunjgoyal0344-coder/ertmac-nwis works
eRTMAC-NWIS is an offset-well intelligence product for drilling operations: engineers compare nearby wells and historical incidents, assess hazards ahead of the bit, and review recommended mitigations. The README describes spatial matching, predictive risk, report intelligence, and governance capabilities; sampled backend code confirms dataset serving, document upload, parsing, and risk calculations. Several frontend modules and integrations are represented by their documented roles because their implementation was not sampled, so their internal wiring is not inferred.
Main entry points: App.tsx Operations Console · RiskEngineSimulator.tsx Hydraulics Simulator · risk_engine.py Look-Ahead Risk Engine · DocumentIngestionStudio.tsx Report Ingestion Studio
Components 19
Drilling Intelligence
- Operations Console
frontend/src/App.tsx - Well Radar
frontend/src/components/GeospatialRadar2D.tsx - 3D Well Twin
frontend/src/components/Subsurface3DMap.tsx - Well Log Comparison
frontend/src/components/WellLogComparison.tsx - Risk Intelligence
frontend/src/components/Phase3RiskIntelligence.tsx - Hydraulics Simulator
frontend/src/components/RiskEngineSimulator.tsx - Look-Ahead Risk Engine
backend/app/core/risk_engine.py - Spatial Engine
backend/app/core/geospatial.py - XAI Alert Review
frontend/src/components/ExplainAlertModal.tsx
Report Intelligence
- Report Ingestion Studio
frontend/src/components/DocumentIngestionStudio.tsx - PDF Entity Parser
backend/app/core/pdf_parser.py - Institutional Memory Search
frontend/src/components/InstitutionalMemoryRAG.tsx
Service And Data
- Well Dataset
backend/data/nwis_dataset.json - Document Upload API
backend/app/main.py - Ingest Handler
api/ingest.js
Security And Governance
- Security Command Center
frontend/src/components/SecurityCommandCenter.tsx - Governance And Trends
frontend/src/components/Phase4GovernanceAndTrends.tsx - Audit API
api/audit.js
Other components
- Drilling Engineer
Connections 18
- Drilling Engineer → Operations Console: uses
- Operations Console → Well Radar: presents
- Operations Console → 3D Well Twin: presents
- Operations Console → Well Log Comparison: presents
- Operations Console → Risk Intelligence: presents
- Operations Console → Hydraulics Simulator: presents
- Operations Console → Report Ingestion Studio: presents
- Operations Console → Institutional Memory Search: presents
- Operations Console → XAI Alert Review: opens
- Operations Console → Security Command Center: presents
- Operations Console → Governance And Trends: presents
- Spatial Engine → Well Dataset: reads
- Look-Ahead Risk Engine → Risk Intelligence: calculates risk for
- Hydraulics Simulator → Look-Ahead Risk Engine: evaluates scenarios with
- Report Ingestion Studio → Document Upload API: uploads reports to
- Document Upload API → PDF Entity Parser: parses report text with
- Drilling Engineer → Ingest Handler: submits report to
- Operations Console → Audit API: records audit events via