How gwill1337/mona works
MONA provides authenticated device administration and monitoring dashboards backed by a FastAPI service. Users sign in, manage monitored devices, and view periodically refreshed metrics and anomaly results; administrators can also manage users and train models. Background Celery work collects device metrics and performs anomaly analysis, with PostgreSQL holding application and analytics records and Redis supporting sessions and task execution. The README documents these capabilities; several router and UI implementations were not sampled, so their internal call paths are not expanded beyond documented relationships.
Main entry points: main.py FastAPI app · db.py PostgreSQL · api.tsx HTTP client · main.tsx Route setup
Components 24
Web application
- Route setup
frontend/src/main.tsx - Sign-in
frontend/src/Login.tsx - Device admin
frontend/src/pages/DeviceAdmin.tsx - Monitoring dashboard
frontend/src/pages/Dashboard.tsx - User management
frontend/src/pages/UserBoard.tsx - Model controls
frontend/src/components/modelPanel.tsx - HTTP client
frontend/src/api.tsx
API and access
- FastAPI app
mona_core/main.py - Authentication
mona_core/security.py - Device endpoints
mona_core/routers/devices.py - Monitoring endpoints
mona_core/routers/monitoring.py - Model endpoints
mona_core/routers/model.py - User endpoints
mona_core/routers/users.py - Task status
mona_core/routers/tasks.py - Request schemas
mona_core/schemas.py
Collection and analytics
- Background tasks
mona_core/tasks.py - Anomaly modeling
mona_core/ml.py - Task configuration
mona_core/celery_conf.py
Application state
- PostgreSQL
mona_core/db.py - Runtime configuration
mona_core/config.py - Redis
Monitoring integrations
- Node exporter
- Prometheus
Other components
- User
Connections 35
- User → Route setup: opens app
frontend/src/main.tsx - Route setup → Sign-in: routes to
frontend/src/main.tsx - Route setup → Device admin: routes to
frontend/src/main.tsx - Route setup → Monitoring dashboard: routes to
frontend/src/main.tsx - Route setup → User management: routes to
frontend/src/main.tsx - Sign-in → HTTP client: submits credentials
frontend/src/Login.tsx - Device admin → HTTP client: requests devices
frontend/src/pages/DeviceAdmin.tsx - Monitoring dashboard → HTTP client: loads monitoring data
frontend/src/pages/Dashboard.tsx - Monitoring dashboard → Model controls: renders controls
frontend/src/pages/Dashboard.tsx - User management → HTTP client: requests users
frontend/src/pages/UserBoard.tsx - Model controls → HTTP client: requests model actions
frontend/src/components/modelPanel.tsx - HTTP client → FastAPI app: sends API requests
frontend/src/api.tsx - FastAPI app → Authentication: registers auth routes
mona_core/main.py - FastAPI app → Device endpoints: registers routes
mona_core/main.py - FastAPI app → Monitoring endpoints: registers routes
mona_core/main.py - FastAPI app → Model endpoints: registers routes
mona_core/main.py - FastAPI app → User endpoints: registers routes
mona_core/main.py - FastAPI app → Task status: registers routes
mona_core/main.py - Device endpoints → PostgreSQL: reads and writes
mona_core/routers/devices.py - Monitoring endpoints → PostgreSQL: queries metrics
mona_core/routers/monitoring.py - Model endpoints → PostgreSQL: accesses model data
mona_core/routers/model.py - User endpoints → PostgreSQL: reads and writes users
mona_core/routers/users.py - User endpoints → Authentication: removes sessions
mona_core/routers/users.py - Task status → Runtime configuration: queries task result
mona_core/routers/tasks.py - Authentication → PostgreSQL: checks accounts
mona_core/security.py - Authentication → Redis: stores sessions
mona_core/security.py - Background tasks → PostgreSQL: stores collected data
mona_core/tasks.py - Background tasks → Anomaly modeling: runs detection
- Anomaly modeling → PostgreSQL: reads metrics and models
mona_core/ml.py - Task configuration → Runtime configuration: uses settings
mona_core/celery_conf.py - Runtime configuration → Redis: configures broker
mona_core/config.py - Runtime configuration → PostgreSQL: configures connection
mona_core/db.py - Background tasks → Node exporter: collects device metrics
README.md - Prometheus → Node exporter: scrapes targets
README.md - User → Prometheus: views monitoring
README.md