# vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp architecture

> Architecture diagram of the GitHub repository vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp
- Repository: https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp

## Overview

This is a web-based network resilience and failure-investigation platform. Users build or load a topology, inspect routing intelligence, run probe campaigns, inject faults, and investigate observed failures; the system then supports causal analysis, reduction, reproduction, and what-if analysis, with history for review. The README documents the backend REST workflow and the integrated investigation stages. Source excerpts confirm several core calls and data relationships; some UI-to-API and unsampled capability links are documented only at a high level, so they are cited to the README rather than inferred from names.

Main entry points: [`backend/experiment/investigation.py`](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/experiment/investigation.py) (Investigation orchestrator), [`frontend/app/page.tsx`](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/page.tsx) (Workspace and history), [`backend/topology/network.py`](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/topology/network.py) (Network topology), [`backend/reproduction/reproducer.py`](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/reproduction/reproducer.py) (Failure reproducer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web workspace"]
  node_webapp["Workspace and history<br/>[page.tsx]"]
  node_project["Project state"]
  node_canvas["Topology editor<br/>[NetworkCanvas.tsx]"]
  node_intelligence_ui["Intelligence view"]
  node_testing_ui["Test and observe"]
  node_fault_ui["Fault investigation"]
  node_causal_ui["Causal resilience"]
  node_reduction_ui["Reduction and reproduction<br/>[ReductionView.tsx]"]
  node_whatif_ui["What-if analysis<br/>[WhatIfView.tsx]"]
end

subgraph group_api["API and investigation"]
  node_api["REST API<br/>[main.py]"]
  node_investigation["Investigation orchestrator<br/>[investigation.py]"]
  node_campaign["Test campaign<br/>[campaign.py]"]
end

subgraph group_network["Network analysis"]
  node_topology[("Network topology<br/>[network.py]")]
  node_intelligence["Routing intelligence<br/>[engine.py]"]
  node_simulation["Probe simulator<br/>[simulator.py]"]
end

subgraph group_failure["Fault and diagnosis"]
  node_fault["Fault injection<br/>[fault_injection.py]"]
  node_diagnosis["Evidence diagnosis<br/>[engine.py]"]
end

subgraph group_validation["Causal validation"]
  node_signature["Failure signature<br/>[signature.py]"]
  node_causal["Causal dependencies<br/>[dependency.py]"]
  node_reducer["Topology reducer<br/>[reducer.py]"]
  node_reproducer["Failure reproducer<br/>[reproducer.py]"]
  node_whatif["Resilience simulation<br/>[what_if.py]"]
end

node_user(("Network engineer"))

node_user -->|"uses"| node_webapp
node_webapp -->|"manages state"| node_project
node_webapp -->|"renders"| node_canvas
node_webapp -->|"renders"| node_intelligence_ui
node_webapp -->|"renders"| node_testing_ui
node_webapp -->|"renders"| node_fault_ui
node_webapp -->|"renders"| node_causal_ui
node_webapp -->|"renders"| node_reduction_ui
node_webapp -->|"renders"| node_whatif_ui
node_project -->|"calls REST"| node_api
node_canvas -->|"uses topology state"| node_project
node_intelligence_ui -->|"uses project state"| node_project
node_api -->|"routes workflow"| node_investigation
node_investigation -->|"runs analysis"| node_intelligence
node_investigation -->|"runs tests"| node_campaign
node_investigation -->|"injects faults"| node_fault
node_investigation -->|"diagnoses handoff"| node_diagnosis
node_investigation -->|"generates signature"| node_signature
node_investigation -->|"builds dependencies"| node_causal
node_investigation -->|"reduces topology"| node_reducer
node_investigation -->|"validates reproduction"| node_reproducer
node_investigation -->|"runs what-if"| node_whatif
node_intelligence -->|"analyzes graph"| node_topology
node_campaign -->|"runs probes"| node_simulation
node_simulation -->|"reads network"| node_topology
node_fault -->|"changes state"| node_topology
node_diagnosis -->|"observes probes"| node_simulation
node_diagnosis -->|"examines network"| node_topology
node_causal -->|"derives from"| node_signature
node_reducer -->|"compares behavior"| node_signature
node_reducer -->|"preserves dependencies"| node_causal
node_reproducer -->|"runs reduction"| node_reducer
node_reproducer -->|"checks signature"| node_signature
node_reproducer -->|"checks dependencies"| node_causal
node_whatif -->|"simulates changes"| node_topology
node_whatif -->|"evaluates paths"| node_intelligence

click node_webapp "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/page.tsx"
click node_project "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/context/NetworkProjectContext.tsx"
click node_canvas "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/NetworkCanvas.tsx"
click node_intelligence_ui "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/NetworkIntelligenceView.tsx"
click node_testing_ui "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/TestAndObserveView.tsx"
click node_fault_ui "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/FailureInvestigationView.tsx"
click node_causal_ui "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/CausalAnalysisView.tsx"
click node_reduction_ui "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/ReductionView.tsx"
click node_whatif_ui "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/WhatIfView.tsx"
click node_api "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/main.py"
click node_investigation "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/experiment/investigation.py"
click node_campaign "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/orchestration/campaign.py"
click node_topology "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/topology/network.py"
click node_intelligence "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/intelligence/engine.py"
click node_simulation "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/simulation/simulator.py"
click node_fault "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/diagnosis/fault_injection.py"
click node_diagnosis "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/diagnosis/engine.py"
click node_signature "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/failure/signature.py"
click node_causal "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/causal/dependency.py"
click node_reducer "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/reduction/reducer.py"
click node_reproducer "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/reproduction/reproducer.py"
click node_whatif "https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/resilience/what_if.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_webapp,node_project,node_canvas,node_intelligence_ui,node_testing_ui,node_fault_ui,node_causal_ui,node_reduction_ui,node_whatif_ui toneBlue
class node_api,node_investigation,node_campaign toneAmber
class node_topology,node_intelligence,node_simulation toneMint
class node_fault,node_diagnosis toneRose
class node_signature,node_causal,node_reducer,node_reproducer,node_whatif,node_user toneIndigo
```

## Components

### Web workspace

- [Workspace and history](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/page.tsx): `frontend/app/page.tsx`
- [Project state](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/context/NetworkProjectContext.tsx): `frontend/app/context/NetworkProjectContext.tsx`
- [Topology editor](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/NetworkCanvas.tsx): `frontend/app/components/NetworkCanvas.tsx`
- [Intelligence view](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/NetworkIntelligenceView.tsx): `frontend/app/components/NetworkIntelligenceView.tsx`
- [Test and observe](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/TestAndObserveView.tsx): `frontend/app/components/TestAndObserveView.tsx`
- [Fault investigation](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/FailureInvestigationView.tsx): `frontend/app/components/FailureInvestigationView.tsx`
- [Causal resilience](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/CausalAnalysisView.tsx): `frontend/app/components/CausalAnalysisView.tsx`
- [Reduction and reproduction](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/ReductionView.tsx): `frontend/app/components/ReductionView.tsx`
- [What-if analysis](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/frontend/app/components/WhatIfView.tsx): `frontend/app/components/WhatIfView.tsx`

### API and investigation

- [REST API](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/main.py): `backend/main.py`
- [Investigation orchestrator](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/experiment/investigation.py): `backend/experiment/investigation.py`
- [Test campaign](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/orchestration/campaign.py): `backend/orchestration/campaign.py`

### Network analysis

- [Network topology](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/topology/network.py): `backend/topology/network.py`
- [Routing intelligence](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/intelligence/engine.py): `backend/intelligence/engine.py`
- [Probe simulator](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/simulation/simulator.py): `backend/simulation/simulator.py`

### Fault and diagnosis

- [Fault injection](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/diagnosis/fault_injection.py): `backend/diagnosis/fault_injection.py`
- [Evidence diagnosis](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/diagnosis/engine.py): `backend/diagnosis/engine.py`

### Causal validation

- [Failure signature](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/failure/signature.py): `backend/failure/signature.py`
- [Causal dependencies](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/causal/dependency.py): `backend/causal/dependency.py`
- [Topology reducer](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/reduction/reducer.py): `backend/reduction/reducer.py`
- [Failure reproducer](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/reproduction/reproducer.py): `backend/reproduction/reproducer.py`
- [Resilience simulation](https://github.com/vivekbsutar/design-and-development-of-an-interactive-web-based-routing-simulator-for-rip-ospf-and-bgp/blob/main/backend/resilience/what_if.py): `backend/resilience/what_if.py`

### Other components

- **Network engineer**

## Connections

- Network engineer → Workspace and history: uses (evidence: `README.md`)
- Workspace and history → Project state: manages state (evidence: `frontend/app/page.tsx`)
- Workspace and history → Topology editor: renders (evidence: `frontend/app/page.tsx`)
- Workspace and history → Intelligence view: renders (evidence: `frontend/app/page.tsx`)
- Workspace and history → Test and observe: renders (evidence: `frontend/app/page.tsx`)
- Workspace and history → Fault investigation: renders (evidence: `frontend/app/page.tsx`)
- Workspace and history → Causal resilience: renders (evidence: `frontend/app/page.tsx`)
- Workspace and history → Reduction and reproduction: renders (evidence: `frontend/app/page.tsx`)
- Workspace and history → What-if analysis: renders (evidence: `README.md`)
- Project state → REST API: calls REST (evidence: `frontend/app/context/NetworkProjectContext.tsx`)
- Topology editor → Project state: uses topology state (evidence: `frontend/app/components/NetworkCanvas.tsx`)
- Intelligence view → Project state: uses project state (evidence: `frontend/app/components/NetworkIntelligenceView.tsx`)
- REST API → Investigation orchestrator: routes workflow (evidence: `README.md`)
- Investigation orchestrator → Routing intelligence: runs analysis (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Test campaign: runs tests (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Fault injection: injects faults (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Evidence diagnosis: diagnoses handoff (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Failure signature: generates signature (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Causal dependencies: builds dependencies (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Topology reducer: reduces topology (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Failure reproducer: validates reproduction (evidence: `backend/experiment/investigation.py`)
- Investigation orchestrator → Resilience simulation: runs what-if (evidence: `backend/experiment/investigation.py`)
- Routing intelligence → Network topology: analyzes graph (evidence: `backend/intelligence/engine.py`)
- Test campaign → Probe simulator: runs probes (evidence: `backend/orchestration/campaign.py`)
- Probe simulator → Network topology: reads network (evidence: `backend/simulation/simulator.py`)
- Fault injection → Network topology: changes state (evidence: `backend/diagnosis/fault_injection.py`)
- Evidence diagnosis → Probe simulator: observes probes
- Evidence diagnosis → Network topology: examines network (evidence: `backend/diagnosis/engine.py`)
- Causal dependencies → Failure signature: derives from (evidence: `backend/causal/dependency.py`)
- Topology reducer → Failure signature: compares behavior (evidence: `backend/reduction/reducer.py`)
- Topology reducer → Causal dependencies: preserves dependencies (evidence: `backend/reduction/reducer.py`)
- Failure reproducer → Topology reducer: runs reduction (evidence: `backend/reproduction/reproducer.py`)
- Failure reproducer → Failure signature: checks signature (evidence: `backend/reproduction/reproducer.py`)
- Failure reproducer → Causal dependencies: checks dependencies (evidence: `backend/reproduction/reproducer.py`)
- Resilience simulation → Network topology: simulates changes (evidence: `backend/resilience/what_if.py`)
- Resilience simulation → Routing intelligence: evaluates paths (evidence: `backend/resilience/what_if.py`)
