How archi-mukh-64/aether-moil-prototype works
MOIL is a mining intelligence command center for mine operators and leadership. Its user workflow runs from selecting a mine or stress scenario in the React workspace, through alerting, risk analysis, forecasting and recommended operational response, to dashboards, decision records and reports. Separate branches cover equipment health, anomaly detection, exploration and reserve prospectivity, national mine comparisons, telemetry, and AI trust. The README documents the six engines and backend gateway; sampled excerpts confirm selected forecast, exploration, national-radar and composite-risk behavior. Unsampled route-to-service details are represented only at the documented gateway boundary.
Main entry points: App.jsx Application shell · apiClient.js API client · main.py FastAPI gateway · database.py Operational database
Components 24
Command Center
- Application shell
frontend/src/App.jsx - Mine workspace
frontend/src/pages/CommandCenterPage.jsx - Alert center
frontend/src/pages/AlertEnginePage.jsx - Scenario lab
frontend/src/pages/ScenarioLabPage.jsx - Reserve radar
frontend/src/pages/ReserveRadarPage.jsx - Reports
frontend/src/pages/ReportsPage.jsx - API client
frontend/src/services/api/apiClient.js
API Gateway
- FastAPI gateway
backend/main.py - Alert & forecast APIs
backend/routes/alert.py - Scenario & protocol APIs
backend/routes/scenarios.py - Earth & reserve APIs
backend/routes/reserve.py - Report APIs
backend/routes/reports.py
Operational Intelligence
- Risk, forecast & anomaly
backend/services/forecast_service.py - Equipment health
backend/services/equipment_service.py - Prescriptive response
backend/services/protocol_service.py
Earth & Strategy
- Exploration targeting
backend/services/exploration_engine.py - National mine radar
backend/services/national_radar_engine.py - PDF/PPT reporting
backend/services/pdf_report_service.py
State & Governance
- AI trust governance
models/trust/trust_engine.py - Composite risk engine
models/common/multi_risk_engine.py - Operational database
backend/database/database.py
Other components
- Mine operator
- Mine telemetry
- Satellite & geology data
Connections 29
- Mine operator → Application shell: uses
- Application shell → Mine workspace: opens
- Application shell → Alert center: navigates
- Application shell → Scenario lab: navigates
- Application shell → Reserve radar: navigates
- Application shell → Reports: navigates
- Mine workspace → API client: requests data
- Alert center → API client: requests forecasts
- Scenario lab → API client: submits scenarios
- Reserve radar → API client: requests targets
- Reports → API client: requests reports
- API client → FastAPI gateway: REST requests
- FastAPI gateway → Alert & forecast APIs: dispatches
- FastAPI gateway → Scenario & protocol APIs: dispatches
- FastAPI gateway → Earth & reserve APIs: dispatches
- FastAPI gateway → Report APIs: dispatches
- Alert & forecast APIs → Risk, forecast & anomaly: invokes
- Risk, forecast & anomaly → Composite risk engine: evaluates risk
- Composite risk engine → AI trust governance: calculates trust
- Scenario & protocol APIs → Prescriptive response: invokes
- Earth & reserve APIs → Exploration targeting: invokes
- Earth & reserve APIs → National mine radar: invokes
- Report APIs → PDF/PPT reporting: generates reports
- Mine telemetry → Equipment health: supplies signals
- Satellite & geology data → Exploration targeting: informs targets
- Risk, forecast & anomaly → Operational database: reads/writes
- Equipment health → Operational database: reads/writes
- Prescriptive response → Operational database: reads/writes
- PDF/PPT reporting → Operational database: reads records