How senlovey/energy-monitoring-course-work works
Energy Monitoring is a FastAPI application for collecting device electricity readings, viewing filtered activity reports, and administering users and reporting features. The main flow is device simulators or Excel data into the backend, then PostgreSQL-backed aggregation and a browser report. The README documents scheduled simulators, role-based access, and first-run data initialization. Some routes and integrations are represented at the main-module level because their implementations were not fully excerpted; optional mail delivery is unverified.
Main entry points: main.py HTTP application · models.py Data models · database.py Database sessions · importer.py Excel importer
Components 21
Data ingestion
- HTTP application
python_backend/app/main.py - Excel importer
python_backend/app/importer.py - Demo data seeding
python_backend/app/seed.py - Simulator client
python_backend/app/simulator.py
Backend services
- Database sessions
python_backend/app/database.py - Data models
python_backend/app/models.py - PostgreSQL
- Consumption analytics
python_backend/app/services.py - Time utilities
python_backend/app/timeutils.py - Application settings
python_backend/app/config.py - Authentication
python_backend/app/auth.py
Web experience
- React dashboard
python_backend/frontend/src/main.jsx - HTML templates
python_backend/app/templates
Administration and reporting
- Activity and exports
python_backend/app/main.py - Incident management
python_backend/app/main.py - User and settings admin
python_backend/app/main.py - Report scheduling
python_backend/app/main.py
Other components
- User
- Device simulators
- Excel workbook
- Mail service
Connections 23
- Device simulators → HTTP application: posts readings
README.md - Excel workbook → Excel importer: provides workbook
README.md - HTTP application → Excel importer: imports data
python_backend/app/main.py - HTTP application → Demo data seeding: seeds fallback
python_backend/app/main.py - HTTP application → Authentication: checks access
python_backend/app/main.py - HTTP application → Consumption analytics: builds report data
python_backend/app/main.py - HTTP application → Database sessions: opens sessions
python_backend/app/main.py - Database sessions → Application settings: reads database URL
python_backend/app/database.py - Data models → Database sessions: uses model base
python_backend/app/models.py - Excel importer → Data models: creates readings
python_backend/app/importer.py - Demo data seeding → Data models: creates readings
python_backend/app/seed.py - Consumption analytics → Data models: queries readings
python_backend/app/services.py - Data models → Time utilities: timestamps records
python_backend/app/models.py - Database sessions → PostgreSQL: connects
README.md - User → HTTP application: uses application
README.md - HTTP application → HTML templates: renders pages
README.md - HTTP application → React dashboard: serves frontend
README.md - User → Activity and exports: views activity
README.md - Activity and exports → Consumption analytics: requests analytics
python_backend/app/main.py - User → User and settings admin: manages accounts
README.md - User → Incident management: reviews incidents
- User → Report scheduling: configures reports
python_backend/app/main.py - Report scheduling → Mail service: sends reports