How gitnonta/smartenergy works
Smart Energy Monitoring Dashboard receives AI205 meter telemetry through MQTT, processes and stores time-series data, then serves live updates and query results to a React dashboard. Users can inspect live electrical measurements, historical energy summaries and alerts; supporting branches cover authentication and administration, AI chat, device firmware, and customizable layouts. The README documents the MQTT-to-WebSocket flow; sampled source confirms several backend service and frontend context relationships. Some feature implementations were not sampled, so their internal links are omitted rather than inferred.
Main entry points: index.js Route registration · App.tsx Application routing · server.js API and WebSocket server · ingestor.js Telemetry ingestor
Components 31
Telemetry and storage
- Telemetry ingestor
backend/src/ingestor.js - Time-series store
backend/src/services/influxdb.js - Alert processing
backend/src/services/alertService.js - Line messaging
backend/src/services/lineMessagingService.js
Backend API
- API and WebSocket server
backend/src/server.js - Route registration
backend/src/routes/index.js - Energy endpoints
backend/src/routes/energyRoutes.js - Energy calculations
backend/src/services/energyCalculation.js
Identity and admin
- Authentication endpoints
backend/src/routes/authRoutes.js - Session management
backend/src/services/sessionService.js - Activity audit
backend/src/services/activityLogger.js - User and session database
backend/src/services/db.js - User management API
backend/src/routes/userRoutes.js - Login view
frontend/src/features/auth/LoginPage.tsx - User administration
frontend/src/features/admin/UserManagementPage.tsx
Dashboard experience
- Application routing
frontend/src/App.tsx - Dashboard shell
frontend/src/components/AppShell.tsx - Live telemetry view
frontend/src/features/dashboard/DashboardPage.tsx - Live data context
frontend/src/context/WebSocketContext.tsx - WebSocket client
frontend/src/services/webSocketClient.ts - Historical data access
frontend/src/services/influxService.ts - Alerts view
frontend/src/features/alerts/AlertsPage.tsx
Product extensions
- AI chat
backend/src/services/aiChatService.js - Chat widget
frontend/src/components/ChatWidget.tsx - Firmware management
frontend/src/components/DeviceFirmwareManager.tsx - Firmware operations
backend/src/services/firmwareManager.js - Dashboard layouts
backend/src/services/layoutService.js - Layout endpoints
backend/src/routes/layoutRoutes.js
Other components
- AI205 meter
- MQTT broker
- Dashboard user
Connections 31
- AI205 meter → MQTT broker: publishes telemetry
README.md - MQTT broker → Telemetry ingestor: delivers MQTT
README.md - Telemetry ingestor → Time-series store: writes measurements
backend/src/ingestor.js - Telemetry ingestor → Alert processing: checks alerts
backend/src/ingestor.js - Telemetry ingestor → Line messaging: sends notifications
backend/src/ingestor.js - API and WebSocket server → Time-series store: queries data
backend/src/server.js - API and WebSocket server → Route registration: mounts routes
backend/src/server.js - Route registration → Energy endpoints: registers route
backend/src/routes/index.js - Energy endpoints → Energy calculations: uses calculations
backend/src/routes/energyRoutes.js - Route registration → Authentication endpoints: registers route
backend/src/routes/index.js - Authentication endpoints → Session management: creates sessions
backend/src/routes/authRoutes.js - Authentication endpoints → Activity audit: logs activity
backend/src/routes/authRoutes.js - Session management → User and session database: reads and updates
backend/src/services/sessionService.js - Activity audit → User and session database: writes audit data
backend/src/services/activityLogger.js - Route registration → User management API: registers route
backend/src/routes/index.js - API and WebSocket server → Dashboard user: streams live data
README.md - Dashboard user → Application routing: uses dashboard
README.md - Application routing → Dashboard shell: renders shell
frontend/src/App.tsx - Application routing → Live telemetry view: routes dashboard
frontend/src/App.tsx - Application routing → Alerts view: routes alerts
frontend/src/App.tsx - Application routing → Login view: routes login
frontend/src/App.tsx - Application routing → User administration: routes administration
frontend/src/App.tsx - Dashboard shell → Live data context: uses live context
frontend/src/components/AppShell.tsx - Live data context → WebSocket client: connects client
frontend/src/context/WebSocketContext.tsx - Live data context → API and WebSocket server: receives WebSocket data
README.md - Historical data access → API and WebSocket server: requests historical data
README.md - Route registration → AI chat: registers chat service
backend/src/routes/index.js - Dashboard shell → Chat widget: renders widget
frontend/src/components/AppShell.tsx - Firmware management → Firmware operations: requests firmware operations
- Route registration → Layout endpoints: registers route
backend/src/routes/index.js - Layout endpoints → Dashboard layouts: uses layout service