# yess1ne/esprit-pidev-4ds3-2026-networkml architecture

> Architecture diagram of the GitHub repository yess1ne/esprit-pidev-4ds3-2026-networkml, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yess1ne/esprit-pidev-4ds3-2026-networkml
- Repository: https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml

## Overview

This is a Next.js network QoS operations dashboard. Users navigate an overview and focused anomaly, topology, and RL-agent views; API routes query InfluxDB and return processed operational data. The sampled overview renders live topology, while several panel-to-endpoint fetch relationships are not shown in the excerpts, so those links are marked unverified. The README is empty; documented capabilities are inferred from the repository’s route and component names.

Main entry points: [`lib/influxdb.ts`](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/lib/influxdb.ts) (InfluxDB query access), [`app/page.tsx`](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/page.tsx) (Dashboard shell), [`app/api/live-topology/route.ts`](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/live-topology/route.ts) (Live topology API), [`components/dashboard/overview-panel.tsx`](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/overview-panel.tsx) (Overview panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_dashboard["Dashboard shell<br/>[page.tsx]"]
  node_overview["Overview panel<br/>[overview-panel.tsx]"]
  node_anomaly_panel["Anomaly detection"]
  node_severity_panel["Anomaly severity"]
  node_location_panel["Anomaly location"]
  node_rl_panel["RL agent panel<br/>[rl-agent-panel.tsx]"]
  node_topology_view["Topology view<br/>[live-topology.tsx]"]
  node_header["Dashboard header<br/>[header.tsx]"]
  node_sidebar["Navigation sidebar<br/>[sidebar.tsx]"]
end

subgraph group_api["Operations APIs"]
  node_overview_api["Overview API<br/>[route.ts]"]
  node_anomaly_api["Anomaly API<br/>[route.ts]"]
  node_severity_api["Severity API<br/>[route.ts]"]
  node_location_api["Location API<br/>[route.ts]"]
  node_topology_api["Live topology API<br/>[route.ts]"]
  node_health_api["Network health API<br/>[route.ts]"]
  node_rl_api["RL agent API<br/>[route.ts]"]
  node_sla_api["SLA optimization API<br/>[route.ts]"]
  node_report_api["LLM reporting API<br/>[route.ts]"]
end

subgraph group_data["Telemetry access"]
  node_influx_access["InfluxDB query access<br/>[influxdb.ts]"]
end

subgraph group_domain["Network model"]
  node_topology_model["Network topology model"]
end

node_operator(("Network operator"))
node_influx[("InfluxDB")]

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_overview
node_dashboard -->|"renders"| node_anomaly_panel
node_dashboard -->|"renders"| node_severity_panel
node_dashboard -->|"renders"| node_location_panel
node_dashboard -->|"renders"| node_rl_panel
node_dashboard -->|"renders"| node_header
node_dashboard -->|"renders"| node_sidebar
node_overview -.->|"fetches data"| node_topology_api
node_topology_view -.->|"fetches data"| node_topology_api
node_anomaly_panel -.->|"fetches data"| node_anomaly_api
node_severity_panel -.->|"fetches data"| node_severity_api
node_location_panel -.->|"fetches data"| node_location_api
node_rl_panel -.->|"fetches data"| node_rl_api
node_overview_api -->|"queries"| node_influx_access
node_anomaly_api -->|"queries"| node_influx_access
node_severity_api -->|"queries"| node_influx_access
node_location_api -->|"queries"| node_influx_access
node_topology_api -->|"queries"| node_influx_access
node_topology_api -->|"reads topology"| node_topology_model
node_health_api -->|"queries"| node_influx_access
node_rl_api -->|"queries"| node_influx_access
node_sla_api -->|"queries"| node_influx_access
node_report_api -->|"queries"| node_influx_access
node_influx_access -->|"executes queries"| node_influx

click node_dashboard "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/page.tsx"
click node_overview "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/overview-panel.tsx"
click node_anomaly_panel "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/anomaly-detection-panel.tsx"
click node_severity_panel "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/anomaly-severity-panel.tsx"
click node_location_panel "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/anomaly-location-panel.tsx"
click node_rl_panel "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/rl-agent-panel.tsx"
click node_topology_view "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/live-topology.tsx"
click node_header "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/header.tsx"
click node_sidebar "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/sidebar.tsx"
click node_overview_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/overview/route.ts"
click node_anomaly_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/anomaly-detection/route.ts"
click node_severity_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/anomaly-severity/route.ts"
click node_location_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/anomaly-location/route.ts"
click node_topology_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/live-topology/route.ts"
click node_health_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/network-health/route.ts"
click node_rl_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/rl-agent/route.ts"
click node_sla_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/sla-optimization/route.ts"
click node_report_api "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/llm-reporting/route.ts"
click node_influx_access "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/lib/influxdb.ts"
click node_topology_model "https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/lib/network-topology.ts"

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_dashboard,node_overview,node_anomaly_panel,node_severity_panel,node_location_panel,node_rl_panel,node_topology_view,node_header,node_sidebar toneBlue
class node_overview_api,node_anomaly_api,node_severity_api,node_location_api,node_topology_api,node_health_api,node_rl_api,node_sla_api,node_report_api,node_influx toneAmber
class node_influx_access toneMint
class node_topology_model toneRose
class node_operator toneIndigo
```

## Components

### Dashboard UI

- [Dashboard shell](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/page.tsx): `app/page.tsx`
- [Overview panel](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/overview-panel.tsx): `components/dashboard/overview-panel.tsx`
- [Anomaly detection](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/anomaly-detection-panel.tsx): `components/dashboard/anomaly-detection-panel.tsx`
- [Anomaly severity](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/anomaly-severity-panel.tsx): `components/dashboard/anomaly-severity-panel.tsx`
- [Anomaly location](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/anomaly-location-panel.tsx): `components/dashboard/anomaly-location-panel.tsx`
- [RL agent panel](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/rl-agent-panel.tsx): `components/dashboard/rl-agent-panel.tsx`
- [Topology view](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/live-topology.tsx): `components/dashboard/live-topology.tsx`
- [Dashboard header](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/header.tsx): `components/dashboard/header.tsx`
- [Navigation sidebar](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/components/dashboard/sidebar.tsx): `components/dashboard/sidebar.tsx`

### Operations APIs

- [Overview API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/overview/route.ts): `app/api/overview/route.ts`
- [Anomaly API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/anomaly-detection/route.ts): `app/api/anomaly-detection/route.ts`
- [Severity API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/anomaly-severity/route.ts): `app/api/anomaly-severity/route.ts`
- [Location API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/anomaly-location/route.ts): `app/api/anomaly-location/route.ts`
- [Live topology API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/live-topology/route.ts): `app/api/live-topology/route.ts`
- [Network health API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/network-health/route.ts): `app/api/network-health/route.ts`
- [RL agent API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/rl-agent/route.ts): `app/api/rl-agent/route.ts`
- [SLA optimization API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/sla-optimization/route.ts): `app/api/sla-optimization/route.ts`
- [LLM reporting API](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/app/api/llm-reporting/route.ts): `app/api/llm-reporting/route.ts`

### Telemetry access

- [InfluxDB query access](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/lib/influxdb.ts): `lib/influxdb.ts`

### Network model

- [Network topology model](https://github.com/yess1ne/esprit-pidev-4ds3-2026-networkml/blob/master/lib/network-topology.ts): `lib/network-topology.ts`

### Other components

- **Network operator**
- **InfluxDB**

## Connections

- Network operator → Dashboard shell: uses
- Dashboard shell → Overview panel: renders (evidence: `app/page.tsx`)
- Dashboard shell → Anomaly detection: renders (evidence: `app/page.tsx`)
- Dashboard shell → Anomaly severity: renders (evidence: `app/page.tsx`)
- Dashboard shell → Anomaly location: renders (evidence: `app/page.tsx`)
- Dashboard shell → RL agent panel: renders (evidence: `app/page.tsx`)
- Dashboard shell → Dashboard header: renders (evidence: `app/page.tsx`)
- Dashboard shell → Navigation sidebar: renders (evidence: `app/page.tsx`)
- Overview panel → Live topology API: fetches data
- Topology view → Live topology API: fetches data
- Anomaly detection → Anomaly API: fetches data
- Anomaly severity → Severity API: fetches data
- Anomaly location → Location API: fetches data
- RL agent panel → RL agent API: fetches data
- Overview API → InfluxDB query access: queries (evidence: `app/api/overview/route.ts`)
- Anomaly API → InfluxDB query access: queries (evidence: `app/api/anomaly-detection/route.ts`)
- Severity API → InfluxDB query access: queries (evidence: `app/api/anomaly-severity/route.ts`)
- Location API → InfluxDB query access: queries (evidence: `app/api/anomaly-location/route.ts`)
- Live topology API → InfluxDB query access: queries (evidence: `app/api/live-topology/route.ts`)
- Live topology API → Network topology model: reads topology (evidence: `app/api/live-topology/route.ts`)
- Network health API → InfluxDB query access: queries (evidence: `app/api/network-health/route.ts`)
- RL agent API → InfluxDB query access: queries (evidence: `app/api/rl-agent/route.ts`)
- SLA optimization API → InfluxDB query access: queries (evidence: `app/api/sla-optimization/route.ts`)
- LLM reporting API → InfluxDB query access: queries (evidence: `app/api/llm-reporting/route.ts`)
- InfluxDB query access → InfluxDB: executes queries (evidence: `lib/influxdb.ts`)
