# nguyentanphong-12022k5/do_an architecture

> Architecture diagram of the GitHub repository nguyentanphong-12022k5/do_an, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nguyentanphong-12022k5/do_an
- Repository: https://github.com/nguyentanphong-12022k5/do_an

## Overview

NetOps & Infrastructure Portal combines a React dashboard with an Express backend for device inventory, discovery, polling, metric history, alerts, forecasting, and remote SSH commands. The main monitoring flow is: administrators view devices in the dashboard; the backend polls registered devices, checks reachability and gathers SNMP metrics, stores results, and sends configured alerts. Dashboard metric-history and device-management requests pass through the HTTP routes and controllers. The README documents the end-to-end polling and dashboard behavior; unsampled integrations are included only where the tree or documentation supports them.

Main entry points: [`backend/src/controllers/device.controller.ts`](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/controllers/device.controller.ts) (Device Controller), [`backend/src/workers/poller.worker.ts`](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/workers/poller.worker.ts) (Polling Worker), [`backend/src/server.ts`](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/server.ts) (HTTP Server), [`backend/src/repositories/device.repository.ts`](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/repositories/device.repository.ts) (Device Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Portal"]
  node_dashboard["Dashboard<br/>[App.tsx]"]
end

subgraph group_api["API &amp; Device Ops"]
  node_http["HTTP Server<br/>[server.ts]"]
  node_device_routes["Device Routes<br/>[device.routes.ts]"]
  node_device_controller["Device Controller"]
  node_device_service["Device Service<br/>[device.service.ts]"]
  node_netops_routes["NetOps Routes<br/>[netops.routes.ts]"]
  node_netops_controller["NetOps Controller"]
  node_ssh["SSH Commands<br/>[ssh.service.ts]"]
end

subgraph group_monitoring["Monitoring &amp; Alerts"]
  node_discovery["Network Discovery"]
  node_poller["Polling Worker<br/>[poller.worker.ts]"]
  node_monitor["Monitoring Service"]
  node_email["Email Alerts<br/>[email.service.ts]"]
  node_ai["Capacity Forecasting<br/>[ai.service.ts]"]
end

subgraph group_data["Persistence"]
  node_device_repo["Device Repository"]
  node_metric_repo["Metric Repository"]
  node_db_config["Database Pool<br/>[db.ts]"]
end

node_admin(("Administrator"))
node_postgres[("PostgreSQL")]
node_managed_devices{{"Managed Network Devices"}}
node_mail_service["Email Provider"]

node_admin -->|"uses"| node_dashboard
node_dashboard -->|"requests API"| node_http
node_http -->|"mounts"| node_device_routes
node_http -->|"mounts"| node_netops_routes
node_http -->|"starts worker"| node_poller
node_device_routes -->|"dispatches"| node_device_controller
node_device_controller -->|"manages devices"| node_device_service
node_device_controller -->|"scans networks"| node_discovery
node_device_controller -->|"reads history"| node_metric_repo
node_device_controller -->|"requests forecast"| node_ai
node_discovery -->|"checks SNMP"| node_monitor
node_discovery -->|"finds or adds"| node_device_repo
node_netops_routes -->|"dispatches"| node_netops_controller
node_netops_controller -->|"loads devices"| node_device_repo
node_netops_controller -->|"executes command"| node_ssh
node_ssh -.->|"runs remote command"| node_managed_devices
node_poller -->|"loads inventory"| node_device_repo
node_poller -->|"checks and collects"| node_monitor
node_poller -->|"stores metrics"| node_metric_repo
node_poller -->|"sends alerts"| node_email
node_monitor -->|"pings and queries SNMP"| node_managed_devices
node_email -.->|"sends email"| node_mail_service
node_device_repo -->|"queries"| node_db_config
node_metric_repo -->|"queries"| node_db_config
node_db_config -->|"connects"| node_postgres

click node_dashboard "https://github.com/nguyentanphong-12022k5/do_an/blob/main/web/src/App.tsx"
click node_http "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/server.ts"
click node_device_routes "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/routes/device.routes.ts"
click node_device_controller "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/controllers/device.controller.ts"
click node_device_service "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/device.service.ts"
click node_discovery "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/discovery.service.ts"
click node_netops_routes "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/routes/netops.routes.ts"
click node_netops_controller "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/controllers/netops.controller.ts"
click node_ssh "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/ssh.service.ts"
click node_poller "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/workers/poller.worker.ts"
click node_monitor "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/monitoring.service.ts"
click node_email "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/email.service.ts"
click node_ai "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/ai.service.ts"
click node_device_repo "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/repositories/device.repository.ts"
click node_metric_repo "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/repositories/metric.repository.ts"
click node_db_config "https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/config/db.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 toneBlue
class node_http,node_device_routes,node_device_controller,node_device_service,node_netops_routes,node_netops_controller,node_ssh,node_postgres toneAmber
class node_discovery,node_poller,node_monitor,node_email,node_ai toneMint
class node_device_repo,node_metric_repo,node_db_config toneRose
class node_admin,node_managed_devices,node_mail_service toneIndigo
```

## Components

### Web Portal

- [Dashboard](https://github.com/nguyentanphong-12022k5/do_an/blob/main/web/src/App.tsx): `web/src/App.tsx`

### API & Device Ops

- [HTTP Server](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Device Routes](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/routes/device.routes.ts): `backend/src/routes/device.routes.ts`
- [Device Controller](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/controllers/device.controller.ts): `backend/src/controllers/device.controller.ts`
- [Device Service](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/device.service.ts): `backend/src/services/device.service.ts`
- [NetOps Routes](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/routes/netops.routes.ts): `backend/src/routes/netops.routes.ts`
- [NetOps Controller](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/controllers/netops.controller.ts): `backend/src/controllers/netops.controller.ts`
- [SSH Commands](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/ssh.service.ts): `backend/src/services/ssh.service.ts`

### Monitoring & Alerts

- [Network Discovery](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/discovery.service.ts): `backend/src/services/discovery.service.ts`
- [Polling Worker](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/workers/poller.worker.ts): `backend/src/workers/poller.worker.ts`
- [Monitoring Service](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/monitoring.service.ts): `backend/src/services/monitoring.service.ts`
- [Email Alerts](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/email.service.ts): `backend/src/services/email.service.ts`
- [Capacity Forecasting](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/services/ai.service.ts): `backend/src/services/ai.service.ts`

### Persistence

- [Device Repository](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/repositories/device.repository.ts): `backend/src/repositories/device.repository.ts`
- [Metric Repository](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/repositories/metric.repository.ts): `backend/src/repositories/metric.repository.ts`
- [Database Pool](https://github.com/nguyentanphong-12022k5/do_an/blob/main/backend/src/config/db.ts): `backend/src/config/db.ts`

### Other components

- **Administrator**
- **PostgreSQL**
- **Managed Network Devices**
- **Email Provider**

## Connections

- Administrator → Dashboard: uses (evidence: `README.md`)
- Dashboard → HTTP Server: requests API (evidence: `web/src/App.tsx`)
- HTTP Server → Device Routes: mounts (evidence: `backend/src/server.ts`)
- HTTP Server → NetOps Routes: mounts (evidence: `backend/src/server.ts`)
- HTTP Server → Polling Worker: starts worker (evidence: `backend/src/server.ts`)
- Device Routes → Device Controller: dispatches (evidence: `backend/src/routes/device.routes.ts`)
- Device Controller → Device Service: manages devices (evidence: `backend/src/controllers/device.controller.ts`)
- Device Controller → Network Discovery: scans networks (evidence: `backend/src/controllers/device.controller.ts`)
- Device Controller → Metric Repository: reads history (evidence: `backend/src/controllers/device.controller.ts`)
- Device Controller → Capacity Forecasting: requests forecast (evidence: `backend/src/controllers/device.controller.ts`)
- Network Discovery → Monitoring Service: checks SNMP (evidence: `backend/src/services/discovery.service.ts`)
- Network Discovery → Device Repository: finds or adds (evidence: `backend/src/services/discovery.service.ts`)
- NetOps Routes → NetOps Controller: dispatches (evidence: `backend/src/routes/netops.routes.ts`)
- NetOps Controller → Device Repository: loads devices (evidence: `backend/src/controllers/netops.controller.ts`)
- NetOps Controller → SSH Commands: executes command (evidence: `backend/src/controllers/netops.controller.ts`)
- SSH Commands → Managed Network Devices: runs remote command
- Polling Worker → Device Repository: loads inventory (evidence: `backend/src/workers/poller.worker.ts`)
- Polling Worker → Monitoring Service: checks and collects (evidence: `backend/src/workers/poller.worker.ts`)
- Polling Worker → Metric Repository: stores metrics (evidence: `backend/src/workers/poller.worker.ts`)
- Polling Worker → Email Alerts: sends alerts (evidence: `backend/src/workers/poller.worker.ts`)
- Monitoring Service → Managed Network Devices: pings and queries SNMP (evidence: `backend/src/services/monitoring.service.ts`)
- Email Alerts → Email Provider: sends email
- Device Repository → Database Pool: queries (evidence: `backend/src/repositories/device.repository.ts`)
- Metric Repository → Database Pool: queries (evidence: `backend/src/repositories/metric.repository.ts`)
- Database Pool → PostgreSQL: connects (evidence: `backend/src/config/db.ts`)
