# zedattran/embedded_energymanagement-basetasmota architecture

> Architecture diagram of the GitHub repository zedattran/embedded_energymanagement-basetasmota, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zedattran/embedded_energymanagement-basetasmota
- Repository: https://github.com/zedattran/embedded_energymanagement-basetasmota

## Overview

Smart Home Energy Monitoring and Optimization is a full-stack IoT system: homeowners use a Next.js dashboard to monitor and control CoreIoT-connected Tasmota plugs, manage schedules and budgets, and review forecasts and recommendations. The Flask backend handles authentication, device and energy APIs, chatbot requests, and background polling and schedule execution; it also persists user, device, energy, and optimization data. The README documents the IoT and frontend/backend flow; source-index references and excerpts support the internal registration, route, worker, shared-service, and persistence links shown. Some feature implementation paths are unsampled, so their links are documented rather than inferred from code.

Main entry points: [`backend/app_core/shared.py`](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/shared.py) (IoT and energy services), [`backend/app.py`](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app.py) (Flask application), [`backend/app_core/auth_routes.py`](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/auth_routes.py) (Authentication), [`backend/app_core/api.py`](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/api.py) (API registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user_ui["User experience"]
  node_dashboard["Dashboard pages"]
  node_auth_ui["Login and registration"]
  node_frontend_api["Frontend API client<br/>[api-client.ts]"]
end

subgraph group_backend["Backend services"]
  node_backend_app["Flask application<br/>[app.py]"]
  node_api_routes["API registration<br/>[api.py]"]
  node_auth["Authentication<br/>[auth_routes.py]"]
  node_device_routes["Device and control APIs<br/>[device_routes.py]"]
  node_energy_routes["Energy APIs<br/>[energy_routes.py]"]
  node_chatbot["AI chatbot<br/>[chatbot_api.py]"]
  node_shared["IoT and energy services<br/>[shared.py]"]
  node_workers["Polling and scheduler<br/>[workers.py]"]
  node_sockets["Realtime events<br/>[socket_events.py]"]
  node_email["Email alerts<br/>[email_utils.py]"]
end

subgraph group_optimization["Energy optimization"]
  node_forecast_routes["Forecast and budget APIs<br/>[forecast_routes.py]"]
  node_analysis["Energy analysis<br/>[analysis_routes.py]"]
  node_schedules["Schedule APIs<br/>[schedule_routes.py]"]
  node_forecast_model["Forecast model"]
  node_forecast_server["Forecast server<br/>[forecast_server.py]"]
end

subgraph group_data["Persistence"]
  node_database_facade["Database access<br/>[database.py]"]
  node_user_store[("User records<br/>[db_users.py]")]
  node_mongo[("MongoDB<br/>[db_connection.py]")]
end

subgraph group_iot["IoT platform"]
  node_coreiot["CoreIoT cloud"]
  node_smartplug["Tasmota smart plugs"]
end

node_homeowner(("Homeowner"))

node_homeowner -->|"signs in"| node_auth_ui
node_homeowner -->|"uses"| node_dashboard
node_auth_ui -.->|"requests auth"| node_frontend_api
node_dashboard -.->|"requests data"| node_frontend_api
node_frontend_api -->|"calls HTTP API"| node_backend_app
node_backend_app -->|"registers routes"| node_api_routes
node_backend_app -->|"registers auth"| node_auth
node_backend_app -->|"registers blueprint"| node_chatbot
node_backend_app -->|"registers handlers"| node_sockets
node_backend_app -->|"starts jobs"| node_workers
node_api_routes -->|"registers"| node_device_routes
node_api_routes -->|"registers"| node_energy_routes
node_api_routes -->|"registers"| node_forecast_routes
node_api_routes -->|"registers"| node_schedules
node_api_routes -->|"registers"| node_analysis
node_auth -->|"reads and updates users"| node_database_facade
node_auth -->|"sends verification mail"| node_email
node_device_routes -->|"uses device services"| node_shared
node_device_routes -->|"checks identity"| node_auth
node_energy_routes -->|"uses energy state"| node_shared
node_energy_routes -->|"checks identity"| node_auth
node_forecast_routes -->|"uses device services"| node_shared
node_forecast_routes -->|"checks identity"| node_auth
node_analysis -->|"reads device data"| node_shared
node_analysis -->|"checks identity"| node_auth
node_schedules -->|"uses schedule services"| node_shared
node_schedules -->|"checks identity"| node_auth
node_chatbot -->|"uses device services"| node_shared
node_workers -->|"polls and schedules"| node_shared
node_workers -->|"sends alerts"| node_email
node_workers -->|"persists telemetry"| node_database_facade
node_shared -->|"loads and saves data"| node_database_facade
node_shared -->|"uses forecast client"| node_forecast_server
node_database_facade -->|"re-exports user access"| node_user_store
node_database_facade -->|"initializes indexes"| node_mongo
node_user_store -->|"uses database connection"| node_mongo
node_forecast_server -->|"uses model"| node_forecast_model
node_shared -->|"requests telemetry and RPC"| node_coreiot
node_coreiot -->|"forwards MQTT commands"| node_smartplug
node_smartplug -->|"sends telemetry"| node_coreiot
node_coreiot -->|"provides device data"| node_shared
node_backend_app -->|"serves dashboard API"| node_homeowner
node_backend_app -.->|"emits live updates"| node_sockets
node_forecast_routes -.->|"produces forecasts"| node_forecast_model
node_forecast_routes -.->|"supports optimizer schedules"| node_schedules

click node_dashboard "https://github.com/zedattran/embedded_energymanagement-basetasmota/tree/main/frontend/app/(dashboard)"
click node_auth_ui "https://github.com/zedattran/embedded_energymanagement-basetasmota/tree/main/frontend/app/(auth)"
click node_frontend_api "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/frontend/lib/api-client.ts"
click node_backend_app "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app.py"
click node_api_routes "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/api.py"
click node_auth "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/auth_routes.py"
click node_device_routes "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/device_routes.py"
click node_energy_routes "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/energy_routes.py"
click node_forecast_routes "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/forecast_routes.py"
click node_analysis "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/analysis_routes.py"
click node_schedules "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/schedule_routes.py"
click node_chatbot "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/chatbot_api.py"
click node_shared "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/shared.py"
click node_workers "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/workers.py"
click node_sockets "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/socket_events.py"
click node_email "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/email_utils.py"
click node_forecast_model "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/ml/ensemble_model_improved.py"
click node_forecast_server "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/ml/forecast_server.py"
click node_database_facade "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/database.py"
click node_user_store "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/db_users.py"
click node_mongo "https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/db_connection.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_auth_ui,node_frontend_api toneBlue
class node_backend_app,node_api_routes,node_auth,node_device_routes,node_energy_routes,node_chatbot,node_shared,node_workers,node_sockets,node_email toneAmber
class node_forecast_routes,node_analysis,node_schedules,node_forecast_model,node_forecast_server toneMint
class node_database_facade,node_user_store,node_mongo toneRose
class node_coreiot,node_smartplug,node_homeowner toneIndigo
```

## Components

### User experience

- [Dashboard pages](https://github.com/zedattran/embedded_energymanagement-basetasmota/tree/main/frontend/app/(dashboard)): `frontend/app/(dashboard)`
- [Login and registration](https://github.com/zedattran/embedded_energymanagement-basetasmota/tree/main/frontend/app/(auth)): `frontend/app/(auth)`
- [Frontend API client](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/frontend/lib/api-client.ts): `frontend/lib/api-client.ts`

### Backend services

- [Flask application](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app.py): `backend/app.py`
- [API registration](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/api.py): `backend/app_core/api.py`
- [Authentication](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/auth_routes.py): `backend/app_core/auth_routes.py`
- [Device and control APIs](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/device_routes.py): `backend/app_core/routes/device_routes.py`
- [Energy APIs](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/energy_routes.py): `backend/app_core/routes/energy_routes.py`
- [AI chatbot](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/chatbot_api.py): `backend/app_core/chatbot_api.py`
- [IoT and energy services](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/shared.py): `backend/app_core/shared.py`
- [Polling and scheduler](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/workers.py): `backend/app_core/workers.py`
- [Realtime events](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/socket_events.py): `backend/app_core/socket_events.py`
- [Email alerts](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/email_utils.py): `backend/app_core/email_utils.py`

### Energy optimization

- [Forecast and budget APIs](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/forecast_routes.py): `backend/app_core/routes/forecast_routes.py`
- [Energy analysis](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/analysis_routes.py): `backend/app_core/analysis_routes.py`
- [Schedule APIs](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/app_core/routes/schedule_routes.py): `backend/app_core/routes/schedule_routes.py`
- [Forecast model](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/ml/ensemble_model_improved.py): `backend/ml/ensemble_model_improved.py`
- [Forecast server](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/ml/forecast_server.py): `backend/ml/forecast_server.py`

### Persistence

- [Database access](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/database.py): `backend/database.py`
- [User records](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/db_users.py): `backend/db_users.py`
- [MongoDB](https://github.com/zedattran/embedded_energymanagement-basetasmota/blob/main/backend/db_connection.py): `backend/db_connection.py`

### IoT platform

- **CoreIoT cloud**
- **Tasmota smart plugs**

### Other components

- **Homeowner**

## Connections

- Homeowner → Login and registration: signs in (evidence: `README.md`)
- Homeowner → Dashboard pages: uses (evidence: `README.md`)
- Login and registration → Frontend API client: requests auth
- Dashboard pages → Frontend API client: requests data
- Frontend API client → Flask application: calls HTTP API (evidence: `README.md`)
- Flask application → API registration: registers routes (evidence: `backend/app.py`)
- Flask application → Authentication: registers auth (evidence: `backend/app.py`)
- Flask application → AI chatbot: registers blueprint (evidence: `backend/app.py`)
- Flask application → Realtime events: registers handlers (evidence: `backend/app.py`)
- Flask application → Polling and scheduler: starts jobs (evidence: `backend/app.py`)
- API registration → Device and control APIs: registers (evidence: `backend/app_core/api.py`)
- API registration → Energy APIs: registers (evidence: `backend/app_core/api.py`)
- API registration → Forecast and budget APIs: registers (evidence: `backend/app_core/api.py`)
- API registration → Schedule APIs: registers (evidence: `backend/app_core/api.py`)
- API registration → Energy analysis: registers (evidence: `backend/app_core/api.py`)
- Authentication → Database access: reads and updates users (evidence: `backend/app_core/auth_routes.py`)
- Authentication → Email alerts: sends verification mail (evidence: `backend/app_core/auth_routes.py`)
- Device and control APIs → IoT and energy services: uses device services (evidence: `backend/app_core/routes/device_routes.py`)
- Device and control APIs → Authentication: checks identity (evidence: `backend/app_core/routes/device_routes.py`)
- Energy APIs → IoT and energy services: uses energy state (evidence: `backend/app_core/routes/energy_routes.py`)
- Energy APIs → Authentication: checks identity (evidence: `backend/app_core/routes/energy_routes.py`)
- Forecast and budget APIs → IoT and energy services: uses device services (evidence: `backend/app_core/routes/forecast_routes.py`)
- Forecast and budget APIs → Authentication: checks identity (evidence: `backend/app_core/routes/forecast_routes.py`)
- Energy analysis → IoT and energy services: reads device data (evidence: `backend/app_core/analysis_routes.py`)
- Energy analysis → Authentication: checks identity (evidence: `backend/app_core/analysis_routes.py`)
- Schedule APIs → IoT and energy services: uses schedule services (evidence: `backend/app_core/routes/schedule_routes.py`)
- Schedule APIs → Authentication: checks identity (evidence: `backend/app_core/routes/schedule_routes.py`)
- AI chatbot → IoT and energy services: uses device services (evidence: `backend/app_core/chatbot_api.py`)
- Polling and scheduler → IoT and energy services: polls and schedules (evidence: `backend/app_core/workers.py`)
- Polling and scheduler → Email alerts: sends alerts (evidence: `backend/app_core/workers.py`)
- Polling and scheduler → Database access: persists telemetry (evidence: `backend/app_core/workers.py`)
- IoT and energy services → Database access: loads and saves data (evidence: `backend/app_core/shared.py`)
- IoT and energy services → Forecast server: uses forecast client (evidence: `backend/app_core/shared.py`)
- Database access → User records: re-exports user access (evidence: `backend/database.py`)
- Database access → MongoDB: initializes indexes (evidence: `backend/database.py`)
- User records → MongoDB: uses database connection (evidence: `backend/db_users.py`)
- Forecast server → Forecast model: uses model (evidence: `backend/ml/forecast_server.py`)
- IoT and energy services → CoreIoT cloud: requests telemetry and RPC (evidence: `README.md`)
- CoreIoT cloud → Tasmota smart plugs: forwards MQTT commands (evidence: `README.md`)
- Tasmota smart plugs → CoreIoT cloud: sends telemetry (evidence: `README.md`)
- CoreIoT cloud → IoT and energy services: provides device data (evidence: `README.md`)
- Flask application → Homeowner: serves dashboard API (evidence: `README.md`)
- Flask application → Realtime events: emits live updates (evidence: `backend/app.py`)
- Forecast and budget APIs → Forecast model: produces forecasts
- Forecast and budget APIs → Schedule APIs: supports optimizer schedules
