# ravulavenkatasriram/eco-ai architecture

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

- Interactive diagram: https://gitdiagram.com/ravulavenkatasriram/eco-ai
- Repository: https://github.com/ravulavenkatasriram/eco-ai

## Overview

ECO-AI is an energy-monitoring and intelligence application: users view energy, weather, and appliance data, manage datasets, and access forecasts, anomaly alerts, reports, and efficiency recommendations. The frontend routes those workflows through a shared API client to FastAPI endpoints; backend services provide analytics, dataset handling, forecasting, and ML orchestration over relational records. The graph combines sampled source and SOURCE INDEX references with README capabilities. Several endpoint and service implementations were not excerpted, so their internal links are omitted rather than inferred.

Main entry points: [`Eco Ai/backend/app/services/analytics.py`](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/analytics.py) (Energy analytics), [`Eco Ai/backend/app/api/endpoints`](https://github.com/ravulavenkatasriram/eco-ai/tree/main/Eco%20Ai/backend/app/api/endpoints) (Domain endpoints), [`Eco Ai/backend/app/services/ml/service.py`](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/service.py) (ML orchestration), [`Eco Ai/backend/app/services/generator.py`](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/generator.py) (Data generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_app["Page routing<br/>[App.tsx]"]
  node_pages["Workflow pages"]
  node_client["API client<br/>[api.ts]"]
end

subgraph group_api["API workflows"]
  node_router["API router<br/>[router.py]"]
  node_endpoints["Domain endpoints"]
end

subgraph group_intelligence["Analytics and intelligence"]
  node_datasets["Dataset handling<br/>[dataset_service.py]"]
  node_analytics["Energy analytics<br/>[analytics.py]"]
  node_forecast["Forecasting"]
  node_ml["ML orchestration<br/>[service.py]"]
  node_features["ML features<br/>[features.py]"]
  node_predictor["Model prediction<br/>[predictor.py]"]
  node_registry["Model registry<br/>[registry.py]"]
  node_anomaly["Anomaly detection"]
  node_reporting["Report generation<br/>[reports_engine.py]"]
  node_generator["Data generation<br/>[generator.py]"]
end

subgraph group_data["Data and persistence"]
  node_dbconfig["Database sessions<br/>[database.py]"]
  node_store[("Relational database")]
  node_energy["Energy readings<br/>[energy.py]"]
  node_weather["Weather readings<br/>[weather.py]"]
  node_appliances["Appliance records<br/>[appliance.py]"]
  node_alerts["Alert records<br/>[alert.py]"]
  node_datasetmodel["Dataset records<br/>[dataset.py]"]
  node_settings["Settings records<br/>[setting.py]"]
  node_mlrecords["Model records<br/>[ml_model.py]"]
end

node_user(("Energy user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_pages
node_pages -.->|"requests data"| node_client
node_client -->|"calls API"| node_endpoints
node_router -->|"registers"| node_endpoints
node_endpoints -->|"handles datasets"| node_datasets
node_endpoints -->|"uses analytics"| node_analytics
node_endpoints -->|"invokes ML"| node_ml
node_forecast -->|"uses analytics"| node_analytics
node_ml -->|"uses features"| node_features
node_ml -->|"uses predictor"| node_predictor
node_ml -->|"uses registry"| node_registry
node_datasets -->|"reads and writes"| node_datasetmodel
node_analytics -->|"reads"| node_energy
node_analytics -->|"reads"| node_weather
node_analytics -->|"reads"| node_appliances
node_analytics -->|"scopes by"| node_datasetmodel
node_analytics -->|"checks active dataset"| node_settings
node_generator -->|"generates"| node_energy
node_generator -->|"generates"| node_weather
node_generator -->|"generates"| node_appliances
node_ml -->|"manages models"| node_mlrecords
node_dbconfig -->|"connects"| node_store
node_analytics -.->|"detects anomalies"| node_anomaly
node_endpoints -.->|"serves reports"| node_reporting
node_endpoints -.->|"serves alerts"| node_alerts
node_energy -.->|"persists in"| node_store
node_weather -.->|"persists in"| node_store
node_appliances -.->|"persists in"| node_store
node_alerts -.->|"persists in"| node_store
node_datasetmodel -.->|"persists in"| node_store
node_settings -.->|"persists in"| node_store
node_mlrecords -.->|"persists in"| node_store

click node_app "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/frontend/src/App.tsx"
click node_pages "https://github.com/ravulavenkatasriram/eco-ai/tree/main/Eco%20Ai/frontend/src/pages"
click node_client "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/frontend/src/services/api.ts"
click node_router "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/api/router.py"
click node_endpoints "https://github.com/ravulavenkatasriram/eco-ai/tree/main/Eco%20Ai/backend/app/api/endpoints"
click node_datasets "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/dataset_service.py"
click node_analytics "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/analytics.py"
click node_forecast "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/forecast_service.py"
click node_ml "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/service.py"
click node_features "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/features.py"
click node_predictor "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/predictor.py"
click node_registry "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/registry.py"
click node_anomaly "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/anomaly_detector.py"
click node_reporting "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/reports_engine.py"
click node_generator "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/generator.py"
click node_dbconfig "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/core/database.py"
click node_energy "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/energy.py"
click node_weather "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/weather.py"
click node_appliances "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/appliance.py"
click node_alerts "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/alert.py"
click node_datasetmodel "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/dataset.py"
click node_settings "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/setting.py"
click node_mlrecords "https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/ml_model.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_app,node_pages,node_client,node_user toneBlue
class node_router,node_endpoints toneAmber
class node_datasets,node_analytics,node_forecast,node_ml,node_features,node_predictor,node_registry,node_anomaly,node_reporting,node_generator toneMint
class node_dbconfig,node_store,node_energy,node_weather,node_appliances,node_alerts,node_datasetmodel,node_settings,node_mlrecords toneRose
```

## Components

### User interface

- [Page routing](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/frontend/src/App.tsx): `Eco Ai/frontend/src/App.tsx`
- [Workflow pages](https://github.com/ravulavenkatasriram/eco-ai/tree/main/Eco%20Ai/frontend/src/pages): `Eco Ai/frontend/src/pages`
- [API client](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/frontend/src/services/api.ts): `Eco Ai/frontend/src/services/api.ts`

### API workflows

- [API router](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/api/router.py): `Eco Ai/backend/app/api/router.py`
- [Domain endpoints](https://github.com/ravulavenkatasriram/eco-ai/tree/main/Eco%20Ai/backend/app/api/endpoints): `Eco Ai/backend/app/api/endpoints`

### Analytics and intelligence

- [Dataset handling](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/dataset_service.py): `Eco Ai/backend/app/services/dataset_service.py`
- [Energy analytics](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/analytics.py): `Eco Ai/backend/app/services/analytics.py`
- [Forecasting](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/forecast_service.py): `Eco Ai/backend/app/services/forecast_service.py`
- [ML orchestration](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/service.py): `Eco Ai/backend/app/services/ml/service.py`
- [ML features](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/features.py): `Eco Ai/backend/app/services/ml/features.py`
- [Model prediction](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/predictor.py): `Eco Ai/backend/app/services/ml/predictor.py`
- [Model registry](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/ml/registry.py): `Eco Ai/backend/app/services/ml/registry.py`
- [Anomaly detection](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/anomaly_detector.py): `Eco Ai/backend/app/services/anomaly_detector.py`
- [Report generation](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/reports_engine.py): `Eco Ai/backend/app/services/reports_engine.py`
- [Data generation](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/services/generator.py): `Eco Ai/backend/app/services/generator.py`

### Data and persistence

- [Database sessions](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/core/database.py): `Eco Ai/backend/app/core/database.py`
- **Relational database**
- [Energy readings](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/energy.py): `Eco Ai/backend/app/models/energy.py`
- [Weather readings](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/weather.py): `Eco Ai/backend/app/models/weather.py`
- [Appliance records](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/appliance.py): `Eco Ai/backend/app/models/appliance.py`
- [Alert records](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/alert.py): `Eco Ai/backend/app/models/alert.py`
- [Dataset records](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/dataset.py): `Eco Ai/backend/app/models/dataset.py`
- [Settings records](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/setting.py): `Eco Ai/backend/app/models/setting.py`
- [Model records](https://github.com/ravulavenkatasriram/eco-ai/blob/main/Eco%20Ai/backend/app/models/ml_model.py): `Eco Ai/backend/app/models/ml_model.py`

### Other components

- **Energy user**

## Connections

- Energy user → Page routing: uses (evidence: `Eco Ai/frontend/src/App.tsx`)
- Page routing → Workflow pages: routes to (evidence: `Eco Ai/frontend/src/App.tsx`)
- Workflow pages → API client: requests data (evidence: `Eco Ai/frontend/src/pages/ForecastPage.tsx`)
- API client → Domain endpoints: calls API (evidence: `Eco Ai/frontend/src/services/api.ts`)
- API router → Domain endpoints: registers (evidence: `Eco Ai/backend/app/api/router.py`)
- Domain endpoints → Dataset handling: handles datasets (evidence: `Eco Ai/backend/app/api/endpoints/datasets.py`)
- Domain endpoints → Energy analytics: uses analytics (evidence: `Eco Ai/backend/app/api/endpoints/appliances_api.py`)
- Domain endpoints → ML orchestration: invokes ML (evidence: `Eco Ai/backend/app/api/endpoints/future_intelligence.py`)
- Forecasting → Energy analytics: uses analytics (evidence: `Eco Ai/backend/app/services/forecast_service.py`)
- ML orchestration → ML features: uses features (evidence: `Eco Ai/backend/app/services/ml/service.py`)
- ML orchestration → Model prediction: uses predictor (evidence: `Eco Ai/backend/app/services/ml/service.py`)
- ML orchestration → Model registry: uses registry (evidence: `Eco Ai/backend/app/services/ml/service.py`)
- Dataset handling → Dataset records: reads and writes (evidence: `Eco Ai/backend/app/services/dataset_service.py`)
- Energy analytics → Energy readings: reads (evidence: `Eco Ai/backend/app/services/analytics.py`)
- Energy analytics → Weather readings: reads (evidence: `Eco Ai/backend/app/services/analytics.py`)
- Energy analytics → Appliance records: reads (evidence: `Eco Ai/backend/app/services/analytics.py`)
- Energy analytics → Dataset records: scopes by (evidence: `Eco Ai/backend/app/services/analytics.py`)
- Energy analytics → Settings records: checks active dataset (evidence: `Eco Ai/backend/app/services/analytics.py`)
- Data generation → Energy readings: generates (evidence: `Eco Ai/backend/app/services/generator.py`)
- Data generation → Weather readings: generates (evidence: `Eco Ai/backend/app/services/generator.py`)
- Data generation → Appliance records: generates (evidence: `Eco Ai/backend/app/services/generator.py`)
- ML orchestration → Model records: manages models (evidence: `Eco Ai/backend/app/services/ml/service.py`)
- Database sessions → Relational database: connects (evidence: `Eco Ai/backend/app/core/database.py`)
- Energy analytics → Anomaly detection: detects anomalies
- Domain endpoints → Report generation: serves reports
- Domain endpoints → Alert records: serves alerts (evidence: `Eco Ai/backend/app/api/endpoints/future_intelligence.py`)
- Energy readings → Relational database: persists in
- Weather readings → Relational database: persists in
- Appliance records → Relational database: persists in
- Alert records → Relational database: persists in
- Dataset records → Relational database: persists in
- Settings records → Relational database: persists in
- Model records → Relational database: persists in
