# subin31-j/electricity-consumption-anamoly-detection-ml architecture

> Architecture diagram of the GitHub repository subin31-j/electricity-consumption-anamoly-detection-ml, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/subin31-j/electricity-consumption-anamoly-detection-ml
- Repository: https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml

## Overview

ECAD is a historical electricity-consumption anomaly-analysis web application, not a live meter service. Users authenticate, then submit a demo consumer number or upload a dataset; the backend normalizes the data, runs anomaly models, and exposes results, visualizations, comparisons, history, and reports. Admins use a role-protected console. The README documents the shared analysis pipeline; sampled API and entrypoint files establish several dispatches, but unsampled implementations limit evidence for some internal links.

Main entry points: [`backend/app/main.py`](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/main.py) (API application), [`backend/app/db/session.py`](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/db/session.py) (Database sessions), [`backend/app/api/analysis.py`](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/analysis.py) (Analysis routes), [`backend/app/services/analysis_runner.py`](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/analysis_runner.py) (Analysis runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_frontend["React application<br/>[App.jsx]"]
  node_auth_ui["Auth context<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[apiClient.js]"]
  node_analysis_ui["Analysis views"]
  node_consumer_service["Consumer service<br/>[consumerService.js]"]
  node_analysis_service["Analysis service<br/>[analysisService.js]"]
  node_dataset_service["Dataset service<br/>[datasetService.js]"]
end

subgraph group_api["Backend API"]
  node_main["API application<br/>[main.py]"]
  node_auth_api["Authentication routes<br/>[auth.py]"]
  node_consumer_api["Consumer routes<br/>[consumers.py]"]
  node_dataset_api["Dataset routes<br/>[datasets.py]"]
  node_analysis_api["Analysis routes<br/>[analysis.py]"]
  node_reports_api["Report routes<br/>[reports.py]"]
  node_admin_api["Admin routes<br/>[admin.py]"]
  node_reporting["Report generation<br/>[reporting.py]"]
end

subgraph group_analysis["Analysis pipeline"]
  node_preprocessing["Preprocessing<br/>[preprocessing.py]"]
  node_features["Feature engineering"]
  node_runner["Analysis runner<br/>[analysis_runner.py]"]
  node_detection["Anomaly models"]
end

subgraph group_identity["Identity and access"]
  node_auth_security["Token security<br/>[security.py]"]
  node_access["User and role guards<br/>[deps.py]"]
end

subgraph group_records["Persistent records"]
  node_db_session["Database sessions<br/>[session.py]"]
  node_analysis_record[("Analysis records<br/>[analysis.py]")]
  node_user_record[("User records<br/>[user.py]")]
end

node_user(("User"))

node_user -->|"uses"| node_frontend
node_frontend -->|"provides auth"| node_auth_ui
node_frontend -.->|"calls API services"| node_api_client
node_user -->|"submits consumer"| node_consumer_service
node_user -->|"uploads dataset"| node_dataset_service
node_consumer_service -->|"sends requests"| node_api_client
node_analysis_service -->|"sends requests"| node_api_client
node_dataset_service -.->|"sends requests"| node_api_client
node_api_client -->|"HTTP requests"| node_main
node_analysis_ui -.->|"loads results"| node_analysis_service
node_main -->|"registers router"| node_auth_api
node_main -->|"registers router"| node_consumer_api
node_main -->|"registers router"| node_dataset_api
node_main -->|"registers router"| node_analysis_api
node_main -->|"registers router"| node_reports_api
node_main -->|"registers router"| node_admin_api
node_auth_api -->|"verifies and signs"| node_auth_security
node_auth_api -->|"resolves current user"| node_access
node_access -->|"decodes token"| node_auth_security
node_access -->|"loads user"| node_user_record
node_auth_api -->|"uses session"| node_db_session
node_consumer_api -->|"starts analysis"| node_runner
node_consumer_api -->|"preprocesses input"| node_preprocessing
node_dataset_api -->|"preprocesses upload"| node_preprocessing
node_analysis_api -->|"runs analysis"| node_runner
node_analysis_api -->|"preprocesses input"| node_preprocessing
node_runner -->|"engineers features"| node_features
node_runner -->|"scores models"| node_detection
node_runner -.->|"persists results"| node_analysis_record
node_analysis_api -->|"uses session"| node_db_session
node_analysis_api -->|"reads analysis"| node_analysis_record
node_consumer_api -->|"uses session"| node_db_session
node_dataset_api -->|"uses session"| node_db_session
node_reports_api -->|"generates report"| node_reporting
node_reports_api -->|"uses session"| node_db_session
node_admin_api -->|"uses session"| node_db_session

click node_frontend "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/auth/AuthContext.jsx"
click node_api_client "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/apiClient.js"
click node_analysis_ui "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/components/analysis/AnalysisResultsView.jsx"
click node_consumer_service "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/consumerService.js"
click node_analysis_service "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/analysisService.js"
click node_dataset_service "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/datasetService.js"
click node_main "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/main.py"
click node_auth_api "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/auth.py"
click node_consumer_api "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/consumers.py"
click node_dataset_api "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/datasets.py"
click node_analysis_api "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/analysis.py"
click node_reports_api "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/reports.py"
click node_admin_api "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/admin.py"
click node_preprocessing "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/preprocessing.py"
click node_features "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/feature_engineering.py"
click node_runner "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/analysis_runner.py"
click node_detection "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/anomaly_detection.py"
click node_auth_security "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/core/security.py"
click node_access "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/core/deps.py"
click node_db_session "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/db/session.py"
click node_analysis_record "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/models/analysis.py"
click node_user_record "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/models/user.py"
click node_reporting "https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/reporting.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_frontend,node_auth_ui,node_api_client,node_analysis_ui,node_consumer_service,node_analysis_service,node_dataset_service,node_user toneBlue
class node_main,node_auth_api,node_consumer_api,node_dataset_api,node_analysis_api,node_reports_api,node_admin_api,node_reporting toneAmber
class node_preprocessing,node_features,node_runner,node_detection toneMint
class node_auth_security,node_access toneRose
class node_db_session,node_analysis_record,node_user_record toneIndigo
```

## Components

### Web application

- [React application](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth context](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/auth/AuthContext.jsx): `frontend/src/auth/AuthContext.jsx`
- [API client](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/apiClient.js): `frontend/src/services/apiClient.js`
- [Analysis views](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/components/analysis/AnalysisResultsView.jsx): `frontend/src/components/analysis/AnalysisResultsView.jsx`
- [Consumer service](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/consumerService.js): `frontend/src/services/consumerService.js`
- [Analysis service](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/analysisService.js): `frontend/src/services/analysisService.js`
- [Dataset service](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/frontend/src/services/datasetService.js): `frontend/src/services/datasetService.js`

### Backend API

- [API application](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication routes](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Consumer routes](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/consumers.py): `backend/app/api/consumers.py`
- [Dataset routes](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/datasets.py): `backend/app/api/datasets.py`
- [Analysis routes](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/analysis.py): `backend/app/api/analysis.py`
- [Report routes](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/reports.py): `backend/app/api/reports.py`
- [Admin routes](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/api/admin.py): `backend/app/api/admin.py`
- [Report generation](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/reporting.py): `backend/app/services/reporting.py`

### Analysis pipeline

- [Preprocessing](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/preprocessing.py): `backend/app/services/preprocessing.py`
- [Feature engineering](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/feature_engineering.py): `backend/app/services/feature_engineering.py`
- [Analysis runner](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/analysis_runner.py): `backend/app/services/analysis_runner.py`
- [Anomaly models](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/services/anomaly_detection.py): `backend/app/services/anomaly_detection.py`

### Identity and access

- [Token security](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [User and role guards](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/core/deps.py): `backend/app/core/deps.py`

### Persistent records

- [Database sessions](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [Analysis records](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/models/analysis.py): `backend/app/models/analysis.py`
- [User records](https://github.com/subin31-j/electricity-consumption-anamoly-detection-ml/blob/main/backend/app/models/user.py): `backend/app/models/user.py`

### Other components

- **User**

## Connections

- User → React application: uses
- React application → Auth context: provides auth (evidence: `frontend/src/App.jsx`)
- React application → API client: calls API services
- User → Consumer service: submits consumer
- User → Dataset service: uploads dataset
- Consumer service → API client: sends requests (evidence: `frontend/src/services/consumerService.js`)
- Analysis service → API client: sends requests (evidence: `frontend/src/services/analysisService.js`)
- Dataset service → API client: sends requests
- API client → API application: HTTP requests
- Analysis views → Analysis service: loads results
- API application → Authentication routes: registers router (evidence: `backend/app/main.py`)
- API application → Consumer routes: registers router (evidence: `backend/app/main.py`)
- API application → Dataset routes: registers router (evidence: `backend/app/main.py`)
- API application → Analysis routes: registers router (evidence: `backend/app/main.py`)
- API application → Report routes: registers router (evidence: `backend/app/main.py`)
- API application → Admin routes: registers router (evidence: `backend/app/main.py`)
- Authentication routes → Token security: verifies and signs (evidence: `backend/app/api/auth.py`)
- Authentication routes → User and role guards: resolves current user (evidence: `backend/app/api/auth.py`)
- User and role guards → Token security: decodes token (evidence: `backend/app/core/deps.py`)
- User and role guards → User records: loads user (evidence: `backend/app/core/deps.py`)
- Authentication routes → Database sessions: uses session (evidence: `backend/app/api/auth.py`)
- Consumer routes → Analysis runner: starts analysis (evidence: `backend/app/api/consumers.py`)
- Consumer routes → Preprocessing: preprocesses input (evidence: `backend/app/api/consumers.py`)
- Dataset routes → Preprocessing: preprocesses upload (evidence: `backend/app/api/datasets.py`)
- Analysis routes → Analysis runner: runs analysis (evidence: `backend/app/api/analysis.py`)
- Analysis routes → Preprocessing: preprocesses input (evidence: `backend/app/api/analysis.py`)
- Analysis runner → Feature engineering: engineers features
- Analysis runner → Anomaly models: scores models
- Analysis runner → Analysis records: persists results
- Analysis routes → Database sessions: uses session (evidence: `backend/app/api/analysis.py`)
- Analysis routes → Analysis records: reads analysis (evidence: `backend/app/api/analysis.py`)
- Consumer routes → Database sessions: uses session (evidence: `backend/app/api/consumers.py`)
- Dataset routes → Database sessions: uses session (evidence: `backend/app/api/datasets.py`)
- Report routes → Report generation: generates report (evidence: `backend/app/api/reports.py`)
- Report routes → Database sessions: uses session (evidence: `backend/app/api/reports.py`)
- Admin routes → Database sessions: uses session (evidence: `backend/app/api/admin.py`)
