How blacksnowmartin/netalmoner works
Net Almoner manages network-device configuration backups, history, diffs, and backup-health metrics. The main workflow starts in the React dashboard: users manage devices or request a backup, the FastAPI backup route fetches configuration over SSH and stores the result, and users can inspect history and compare backups. The API also serves device CRUD and dashboard metrics. Edges reflect shown calls, imports listed in the SOURCE INDEX, or documented setup; unsampled frontend and backend wiring is not inferred.
Main entry points: backups.py Backup Routes · metrics.py Metrics Route · devices.py Device Routes · database.py SQLite Database
Components 18
Dashboard
- Dashboard UI
frontend/src/App.jsx - React Mount
frontend/src/main.jsx
API Routes
- FastAPI App
backend/main.py - Metrics Route
backend/app/routers/metrics.py
Backup Services
- Backup Routes
backend/app/routers/backups.py - SSH Config Fetch
backend/app/services/netmiko_ssh.py - Diff Engine
backend/app/services/diff_engine.py
Device Management
- Device Routes
backend/app/routers/devices.py
Persistence and Schemas
- Device Records
backend/app/models/device.py - Backup Records
backend/app/models/backup.py - SQLite Database
backend/app/core/database.py - Device Schemas
backend/app/schemas/device.py - Device Write Schemas
backend/app/schemas/device_internal.py - Backup Schemas
backend/app/schemas/backup.py - Diff Schema
backend/app/schemas/diff.py - Metrics Schemas
backend/app/schemas/metrics.py
Other components
- Operator
- Managed Network Device
Connections 27
- Operator → Dashboard UI: uses
frontend/src/App.jsx - React Mount → Dashboard UI: mounts
frontend/src/main.jsx - Dashboard UI → Device Routes: requests device API
frontend/src/App.jsx - Dashboard UI → Backup Routes: requests backup API
frontend/src/App.jsx - Dashboard UI → Metrics Route: requests dashboard API
frontend/src/App.jsx - FastAPI App → Device Routes: registers
backend/main.py - FastAPI App → Backup Routes: registers
backend/main.py - FastAPI App → Metrics Route: registers
backend/main.py - FastAPI App → SQLite Database: initializes tables
backend/main.py - Device Routes → Device Records: queries and updates
backend/app/routers/devices.py - Device Routes → SQLite Database: uses sessions
backend/app/routers/devices.py - Device Routes → Device Schemas: validates responses
backend/app/routers/devices.py - Device Routes → Device Write Schemas: validates writes
backend/app/routers/devices.py - Backup Routes → Device Records: looks up device
backend/app/routers/backups.py - Backup Routes → Backup Records: reads and saves
backend/app/routers/backups.py - Backup Routes → SQLite Database: uses sessions
backend/app/routers/backups.py - Backup Routes → SSH Config Fetch: fetches configuration
backend/app/routers/backups.py - Managed Network Device → SSH Config Fetch: provides configuration
backend/app/services/netmiko_ssh.py - Backup Routes → Diff Engine: generates comparison
backend/app/routers/backups.py - Backup Routes → Backup Schemas: validates backup data
backend/app/routers/backups.py - Backup Routes → Diff Schema: formats diff response
backend/app/routers/backups.py - Metrics Route → Device Records: reads devices
backend/app/routers/metrics.py - Metrics Route → Backup Records: reads backup history
backend/app/routers/metrics.py - Metrics Route → SQLite Database: uses sessions
backend/app/routers/metrics.py - Metrics Route → Metrics Schemas: builds dashboard response
backend/app/routers/metrics.py - Device Records → SQLite Database: uses ORM base
backend/app/models/device.py - Backup Records → SQLite Database: uses ORM base
backend/app/models/backup.py