How enzofernandezz11/software-quality-0x43 works
This is an end-to-end IoT room-monitoring and access-control system: ESP32 firmware samples sensors and accepts keypad PINs, a Flask API processes telemetry and authentication, PostgreSQL-backed repositories retain readings and audits, and a Next.js dashboard presents live status, history, security logs, and room settings. The central workflow runs from device sampling through HTTP submission and backend persistence to dashboard polling. The graph also preserves authentication and configuration branches. Some routes and UI wiring are unsampled, so uncertain connections are omitted or marked unverified.
Main entry points: networkClient.cpp Network client · dashboard_controller.py Dashboard API · sensors.service.ts API service · main.cpp Device loop
Components 30
ESP32 firmware
- Device loop
firmware/esp32/src/main.cpp - Device config
firmware/esp32/include/appConfig.hpp - Sensor acquisition
firmware/esp32/src/sensors/sensorService.cpp - Reading types
firmware/esp32/include/sensors/sensorTypes.hpp - Network client
firmware/esp32/src/network/networkClient.cpp - Network types
firmware/esp32/include/network/networkTypes.hpp
Flask backend
- Flask app
backend/flask/final_project/app/__init__.py - Telemetry API
backend/flask/final_project/app/controllers/telemetry_controller.py - Dashboard API
backend/flask/final_project/app/controllers/dashboard_controller.py - Authentication API
backend/flask/final_project/app/controllers/auth_controller.py - Room config API
backend/flask/final_project/app/controllers/config_controller.py - Telemetry processing
backend/flask/final_project/app/services/processing_service.py - Authentication service
backend/flask/final_project/app/services/auth_service.py - Auth strategies
backend/flask/final_project/app/services/auth_strategies.py - Sensor service
backend/flask/final_project/app/services/sensors_service.py
Persistence and domain
- Database extension
backend/flask/final_project/app/extensions.py - Sensor repository
backend/flask/final_project/app/repositories/sensors_repository.py - Config repository
backend/flask/final_project/app/repositories/config_repository.py - Audit repository
backend/flask/final_project/app/repositories/auth_repository.py - Domain entities
backend/flask/final_project/app/models/entities
Dashboard
- Dashboard client
frontend/dashboard/src/components/DashboardClient.tsx - Sensor polling
frontend/dashboard/src/hooks/useSensorPolling.ts - API service
frontend/dashboard/src/services/sensors.service.ts - Dashboard types
frontend/dashboard/src/types/sensor.types.ts - History view
frontend/dashboard/src/app/history/page.tsx - Settings view
frontend/dashboard/src/app/settings/page.tsx - Access monitoring
frontend/dashboard/src/hooks/useAccessMonitoring.ts - Access notifications
frontend/dashboard/src/components/widgets/AccessNotifications.tsx
Other components
- Room user
- PostgreSQL
Connections 39
- Room user → Device loop: enters PIN
firmware/esp32/src/main.cpp - Device loop → Sensor acquisition: polls and reads
firmware/esp32/src/main.cpp - Device loop → Network client: submits telemetry
firmware/esp32/src/main.cpp - Device loop → Network client: validates PIN
firmware/esp32/src/main.cpp - Device loop → Device config: uses config
firmware/esp32/src/main.cpp - Sensor acquisition → Reading types: produces readings
- Network client → Reading types: serializes readings
- Network client → Network types: uses types
- Network client → Device config: uses config
- Network client → Telemetry API: posts telemetry
- Network client → Authentication API: sends PIN
- Flask app → Telemetry API: registers routes
backend/flask/final_project/app/__init__.py - Flask app → Dashboard API: registers routes
backend/flask/final_project/app/__init__.py - Flask app → Authentication API: registers routes
backend/flask/final_project/app/__init__.py - Flask app → Room config API: registers routes
backend/flask/final_project/app/__init__.py - Dashboard API → Sensor repository: queries readings
backend/flask/final_project/app/controllers/dashboard_controller.py - Dashboard API → Config repository: loads config
backend/flask/final_project/app/controllers/dashboard_controller.py - Dashboard API → Telemetry processing: calculates baseline
backend/flask/final_project/app/controllers/dashboard_controller.py - Dashboard API → Audit repository: loads audit logs
backend/flask/final_project/app/controllers/dashboard_controller.py - Authentication API → Authentication service: authenticates PIN
backend/flask/final_project/app/controllers/auth_controller.py - Authentication API → Config repository: updates room mode
backend/flask/final_project/app/controllers/auth_controller.py - Authentication service → Auth strategies: delegates validation
backend/flask/final_project/app/services/auth_service.py - Authentication service → Domain entities: records audit
backend/flask/final_project/app/services/auth_service.py - Sensor service → Sensor repository: uses repository
backend/flask/final_project/app/services/sensors_service.py - Sensor repository → Database extension: uses session
backend/flask/final_project/app/repositories/sensors_repository.py - Config repository → Database extension: uses session
backend/flask/final_project/app/repositories/config_repository.py - Audit repository → Database extension: uses session
backend/flask/final_project/app/repositories/auth_repository.py - Sensor repository → Domain entities: queries readings
backend/flask/final_project/app/repositories/sensors_repository.py - Config repository → Domain entities: queries config
backend/flask/final_project/app/repositories/config_repository.py - Audit repository → Domain entities: queries audits
backend/flask/final_project/app/repositories/auth_repository.py - Database extension → PostgreSQL: persists data
- Dashboard client → Sensor polling: uses polling
- Sensor polling → API service: fetches metrics
frontend/dashboard/src/hooks/useSensorPolling.ts - API service → Dashboard types: uses response types
frontend/dashboard/src/services/sensors.service.ts - API service → Dashboard API: requests dashboard data
- History view → API service: loads history
- Settings view → API service: reads config
- Access monitoring → API service: loads audits
- Access notifications → Access monitoring: displays events