# deaththekid1614/netwroxia architecture

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

- Interactive diagram: https://gitdiagram.com/deaththekid1614/netwroxia
- Repository: https://github.com/deaththekid1614/netwroxia

## Overview

Netwroxia is an offline AI network-operations copilot for banking networks. Its main workflow collects network telemetry, predicts faults and time-to-impact, explains risk, and supports incident handling and remediation; operators inspect results in a Streamlit mission-control dashboard. The README also documents beacon readiness, banking-impact analysis, RCA, explainability, analytics, MLOps, and reporting. Some stage links are documented only at a high level; unsampled implementation details are represented by their listed source paths, without asserting unshown calls.

Main entry points: [`ml/inference/predict.py`](https://github.com/deaththekid1614/netwroxia/blob/main/ml/inference/predict.py) (Fault prediction), [`remediation/engine/orchestrator.py`](https://github.com/deaththekid1614/netwroxia/blob/main/remediation/engine/orchestrator.py) (Remediation orchestration), [`incidents/incident_store.py`](https://github.com/deaththekid1614/netwroxia/blob/main/incidents/incident_store.py) (Incident records), [`incidents/incident_engine.py`](https://github.com/deaththekid1614/netwroxia/blob/main/incidents/incident_engine.py) (Incident lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_network["Network inputs"]
  node_network["Bank network"]
  node_telemetry[("Telemetry store")]
  node_beacons["Beacon monitoring"]
  node_readiness["System readiness<br/>[system_check.py]"]
end

subgraph group_prediction["Prediction and copilot"]
  node_fetch["Metric fetching<br/>[fetch_metrics.py]"]
  node_predict["Fault prediction<br/>[predict.py]"]
  node_copilot["Offline copilot<br/>[inference.py]"]
  node_rag[("Knowledge ingestion")]
end

subgraph group_intelligence["Incident intelligence"]
  node_health["Health scoring<br/>[health_score.py]"]
  node_impact["Banking impact<br/>[impact_analyzer.py]"]
  node_rca["Root-cause analysis<br/>[rca_output.py]"]
  node_explain["Risk explanation"]
end

subgraph group_response["Incident response"]
  node_incidents["Incident lifecycle<br/>[incident_engine.py]"]
  node_incident_store[("Incident records<br/>[incident_store.py]")]
  node_remediation["Remediation orchestration<br/>[orchestrator.py]"]
  node_executor["Action executor<br/>[executor.py]"]
  node_guardrails["Approval and rollback<br/>[approval_gate.py]"]
  node_audit[("Audit trail<br/>[audit_logger.py]")]
end

subgraph group_operations["Operator and analytics"]
  node_analytics["KPI and SLA analytics<br/>[sla_tracker.py]"]
  node_mlops["Model monitoring"]
  node_reports["Operational reports<br/>[incident_report.py]"]
  node_dashboard["Mission-control UI<br/>[app.py]"]
  node_pipeline_runner["Dashboard pipeline runner<br/>[pipeline_runner.py]"]
  node_influx_client["Dashboard telemetry client<br/>[influx_client.py]"]
end

node_noc(("NOC engineer"))

node_network -->|"exports metrics"| node_telemetry
node_telemetry -->|"provides metrics"| node_fetch
node_fetch -->|"supplies features"| node_predict
node_predict -->|"feeds predictions"| node_copilot
node_rag -->|"supplies knowledge"| node_copilot
node_predict -->|"informs scoring"| node_health
node_predict -->|"informs impact"| node_impact
node_predict -->|"supports RCA"| node_rca
node_rca -->|"explains risk"| node_explain
node_rca -->|"creates incidents"| node_incidents
node_incidents -->|"updates records"| node_incident_store
node_incidents -->|"logs changes"| node_audit
node_remediation -->|"runs lifecycle"| node_incidents
node_remediation -->|"invokes executor"| node_executor
node_remediation -->|"checks approval"| node_guardrails
node_remediation -->|"records cycle"| node_audit
node_incident_store -->|"supports trends"| node_analytics
node_incident_store -->|"provides incidents"| node_mlops
node_incident_store -->|"provides records"| node_reports
node_audit -->|"provides events"| node_reports
node_guardrails -->|"provides snapshots"| node_reports
node_noc -->|"views operations"| node_dashboard
node_dashboard -->|"runs pipeline"| node_pipeline_runner
node_dashboard -->|"queries telemetry"| node_influx_client
node_pipeline_runner -.->|"runs predictions"| node_predict
node_beacons -.->|"monitors routers"| node_network
node_readiness -.->|"checks readiness"| node_network

click node_beacons "https://github.com/deaththekid1614/netwroxia/blob/main/beacons/beacon_collector.py"
click node_readiness "https://github.com/deaththekid1614/netwroxia/blob/main/beacons/system_check.py"
click node_fetch "https://github.com/deaththekid1614/netwroxia/blob/main/ml/data/fetch_metrics.py"
click node_predict "https://github.com/deaththekid1614/netwroxia/blob/main/ml/inference/predict.py"
click node_copilot "https://github.com/deaththekid1614/netwroxia/blob/main/copilot/llm/inference.py"
click node_rag "https://github.com/deaththekid1614/netwroxia/blob/main/copilot/rag/ingest_documents.py"
click node_health "https://github.com/deaththekid1614/netwroxia/blob/main/analytics/health_score.py"
click node_impact "https://github.com/deaththekid1614/netwroxia/blob/main/impact/impact_analyzer.py"
click node_rca "https://github.com/deaththekid1614/netwroxia/blob/main/rca/rca_output.py"
click node_explain "https://github.com/deaththekid1614/netwroxia/blob/main/explain/explanation_output.py"
click node_incidents "https://github.com/deaththekid1614/netwroxia/blob/main/incidents/incident_engine.py"
click node_incident_store "https://github.com/deaththekid1614/netwroxia/blob/main/incidents/incident_store.py"
click node_remediation "https://github.com/deaththekid1614/netwroxia/blob/main/remediation/engine/orchestrator.py"
click node_executor "https://github.com/deaththekid1614/netwroxia/blob/main/remediation/engine/executor.py"
click node_guardrails "https://github.com/deaththekid1614/netwroxia/blob/main/remediation/guardrails/approval_gate.py"
click node_audit "https://github.com/deaththekid1614/netwroxia/blob/main/audit/audit_logger.py"
click node_analytics "https://github.com/deaththekid1614/netwroxia/blob/main/analytics/sla_tracker.py"
click node_mlops "https://github.com/deaththekid1614/netwroxia/blob/main/mlops/performance_tracker.py"
click node_reports "https://github.com/deaththekid1614/netwroxia/blob/main/reports/incident_report.py"
click node_dashboard "https://github.com/deaththekid1614/netwroxia/blob/main/dashboard/app.py"
click node_pipeline_runner "https://github.com/deaththekid1614/netwroxia/blob/main/dashboard/utils/pipeline_runner.py"
click node_influx_client "https://github.com/deaththekid1614/netwroxia/blob/main/dashboard/utils/influx_client.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_network,node_telemetry,node_beacons,node_readiness toneBlue
class node_fetch,node_predict,node_copilot,node_rag toneAmber
class node_health,node_impact,node_rca,node_explain toneMint
class node_incidents,node_incident_store,node_remediation,node_executor,node_guardrails,node_audit toneRose
class node_analytics,node_mlops,node_reports,node_dashboard,node_pipeline_runner,node_influx_client,node_noc toneIndigo
```

## Components

### Network inputs

- **Bank network**
- **Telemetry store**
- [Beacon monitoring](https://github.com/deaththekid1614/netwroxia/blob/main/beacons/beacon_collector.py): `beacons/beacon_collector.py`
- [System readiness](https://github.com/deaththekid1614/netwroxia/blob/main/beacons/system_check.py): `beacons/system_check.py`

### Prediction and copilot

- [Metric fetching](https://github.com/deaththekid1614/netwroxia/blob/main/ml/data/fetch_metrics.py): `ml/data/fetch_metrics.py`
- [Fault prediction](https://github.com/deaththekid1614/netwroxia/blob/main/ml/inference/predict.py): `ml/inference/predict.py`
- [Offline copilot](https://github.com/deaththekid1614/netwroxia/blob/main/copilot/llm/inference.py): `copilot/llm/inference.py`
- [Knowledge ingestion](https://github.com/deaththekid1614/netwroxia/blob/main/copilot/rag/ingest_documents.py): `copilot/rag/ingest_documents.py`

### Incident intelligence

- [Health scoring](https://github.com/deaththekid1614/netwroxia/blob/main/analytics/health_score.py): `analytics/health_score.py`
- [Banking impact](https://github.com/deaththekid1614/netwroxia/blob/main/impact/impact_analyzer.py): `impact/impact_analyzer.py`
- [Root-cause analysis](https://github.com/deaththekid1614/netwroxia/blob/main/rca/rca_output.py): `rca/rca_output.py`
- [Risk explanation](https://github.com/deaththekid1614/netwroxia/blob/main/explain/explanation_output.py): `explain/explanation_output.py`

### Incident response

- [Incident lifecycle](https://github.com/deaththekid1614/netwroxia/blob/main/incidents/incident_engine.py): `incidents/incident_engine.py`
- [Incident records](https://github.com/deaththekid1614/netwroxia/blob/main/incidents/incident_store.py): `incidents/incident_store.py`
- [Remediation orchestration](https://github.com/deaththekid1614/netwroxia/blob/main/remediation/engine/orchestrator.py): `remediation/engine/orchestrator.py`
- [Action executor](https://github.com/deaththekid1614/netwroxia/blob/main/remediation/engine/executor.py): `remediation/engine/executor.py`
- [Approval and rollback](https://github.com/deaththekid1614/netwroxia/blob/main/remediation/guardrails/approval_gate.py): `remediation/guardrails/approval_gate.py`
- [Audit trail](https://github.com/deaththekid1614/netwroxia/blob/main/audit/audit_logger.py): `audit/audit_logger.py`

### Operator and analytics

- [KPI and SLA analytics](https://github.com/deaththekid1614/netwroxia/blob/main/analytics/sla_tracker.py): `analytics/sla_tracker.py`
- [Model monitoring](https://github.com/deaththekid1614/netwroxia/blob/main/mlops/performance_tracker.py): `mlops/performance_tracker.py`
- [Operational reports](https://github.com/deaththekid1614/netwroxia/blob/main/reports/incident_report.py): `reports/incident_report.py`
- [Mission-control UI](https://github.com/deaththekid1614/netwroxia/blob/main/dashboard/app.py): `dashboard/app.py`
- [Dashboard pipeline runner](https://github.com/deaththekid1614/netwroxia/blob/main/dashboard/utils/pipeline_runner.py): `dashboard/utils/pipeline_runner.py`
- [Dashboard telemetry client](https://github.com/deaththekid1614/netwroxia/blob/main/dashboard/utils/influx_client.py): `dashboard/utils/influx_client.py`

### Other components

- **NOC engineer**

## Connections

- Bank network → Telemetry store: exports metrics
- Telemetry store → Metric fetching: provides metrics
- Metric fetching → Fault prediction: supplies features (evidence: `ml/inference/predict.py`)
- Fault prediction → Offline copilot: feeds predictions
- Knowledge ingestion → Offline copilot: supplies knowledge
- Fault prediction → Health scoring: informs scoring
- Fault prediction → Banking impact: informs impact
- Fault prediction → Root-cause analysis: supports RCA
- Root-cause analysis → Risk explanation: explains risk
- Root-cause analysis → Incident lifecycle: creates incidents (evidence: `incidents/incident_engine.py`)
- Incident lifecycle → Incident records: updates records (evidence: `incidents/incident_engine.py`)
- Incident lifecycle → Audit trail: logs changes (evidence: `incidents/incident_engine.py`)
- Remediation orchestration → Incident lifecycle: runs lifecycle (evidence: `remediation/engine/orchestrator.py`)
- Remediation orchestration → Action executor: invokes executor (evidence: `remediation/engine/orchestrator.py`)
- Remediation orchestration → Approval and rollback: checks approval (evidence: `remediation/engine/orchestrator.py`)
- Remediation orchestration → Audit trail: records cycle (evidence: `remediation/engine/orchestrator.py`)
- Incident records → KPI and SLA analytics: supports trends (evidence: `analytics/trend_engine.py`)
- Incident records → Model monitoring: provides incidents (evidence: `mlops/performance_tracker.py`)
- Incident records → Operational reports: provides records (evidence: `reports/incident_report.py`)
- Audit trail → Operational reports: provides events (evidence: `reports/incident_report.py`)
- Approval and rollback → Operational reports: provides snapshots (evidence: `reports/incident_report.py`)
- NOC engineer → Mission-control UI: views operations
- Mission-control UI → Dashboard pipeline runner: runs pipeline (evidence: `dashboard/app.py`)
- Mission-control UI → Dashboard telemetry client: queries telemetry (evidence: `dashboard/app.py`)
- Dashboard pipeline runner → Fault prediction: runs predictions
- Beacon monitoring → Bank network: monitors routers
- System readiness → Bank network: checks readiness