# youssefbm2104/2bgreen architecture

> Architecture diagram of the GitHub repository youssefbm2104/2bgreen, 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/youssefbm2104/2bgreen
- Repository: https://github.com/youssefbm2104/2bgreen

## Overview

2bGreen presents French electricity-grid data as decision support for citizens, DevOps teams, and regional officials. The principal flow is ODRÉ data ingestion, real-time and historical processing, storage and serving, then persona-specific platform APIs and Angular pages. The graph includes the documented alert, API-key, and regional-target capabilities. Some integrations and feature implementations are unsampled; those links rely on the README’s architecture and status descriptions rather than inspected call sites.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/app.routes.ts) (Role-based routing), [`grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/api/SnapshotController.java`](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/api/SnapshotController.java) (Snapshot API), [`grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcSpeedSnapshotRepository.java`](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcSpeedSnapshotRepository.java) (Live snapshots), [`platform/src/main/java/com/twobgreen/platform/advisory/infrastructure/TrafficLightController.java`](https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/advisory/infrastructure/TrafficLightController.java) (Traffic light)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Grid intelligence"]
  node_pollers["Grid pollers"]
  node_odreclient["ODRÉ client<br/>[OdreClient.java]"]
  node_speed[("Live snapshots")]
  node_stream["Snapshot streams"]
  node_batch["History batches"]
  node_batchstore[("History storage")]
  node_snapshotapi["Snapshot API"]
  node_snapshot["Grid snapshot model<br/>[GridSnapshot.java]"]
end

subgraph group_platform["Platform services"]
  node_auth["OIDC and roles<br/>[auth.config.ts]"]
  node_routing["Role-based routing<br/>[app.routes.ts]"]
end

subgraph group_citizen["Citizen experience"]
  node_traffic["Traffic light"]
  node_alerts["Clean-grid alerts<br/>[alerts.ts]"]
  node_notifications["In-app notifications"]
  node_notificationui["Notification bell"]
end

subgraph group_devops["DevOps experience"]
  node_keys["API key management<br/>[api-keys.ts]"]
  node_intensityapi["Intensity API"]
end

subgraph group_official["Regional experience"]
  node_dashboard["Regional dashboard"]
  node_dashboardui["Dashboard page"]
  node_targets["Target management<br/>[ManageTargets.java]"]
  node_targetui["Targets page<br/>[targets.ts]"]
end

node_odre[("ODRÉ data")]
node_frontend(("Web user"))

node_frontend -->|"signs in"| node_auth
node_frontend -->|"opens workspace"| node_routing
node_routing -.->|"routes citizen"| node_traffic
node_routing -->|"routes citizen"| node_alerts
node_routing -->|"routes DevOps"| node_keys
node_routing -.->|"routes official"| node_dashboardui
node_routing -->|"routes official"| node_targetui
node_alerts -.->|"manages alerts"| node_notifications
node_notificationui -.->|"displays notices"| node_notifications
node_keys -.->|"uses API key"| node_intensityapi
node_dashboardui -->|"loads dashboard"| node_dashboard
node_targetui -->|"manages targets"| node_targets
node_odre -->|"serves grid data"| node_odreclient
node_pollers -.->|"fetches readings"| node_odreclient
node_pollers -.->|"stores live data"| node_speed
node_stream -.->|"processes snapshots"| node_speed
node_batch -.->|"fetches history"| node_odreclient
node_batch -.->|"stores history"| node_batchstore
node_speed -.->|"serves snapshots"| node_snapshotapi
node_batchstore -.->|"serves history"| node_snapshotapi
node_snapshotapi -.->|"provides readings"| node_traffic
node_snapshotapi -.->|"provides readings"| node_dashboard
node_traffic -.->|"returns advice"| node_frontend
node_intensityapi -.->|"reads grid data"| node_snapshotapi

click node_pollers "https://github.com/youssefbm2104/2bgreen/tree/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/poller"
click node_odreclient "https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/odre/OdreClient.java"
click node_speed "https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcSpeedSnapshotRepository.java"
click node_stream "https://github.com/youssefbm2104/2bgreen/tree/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/stream"
click node_batch "https://github.com/youssefbm2104/2bgreen/tree/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/batch"
click node_batchstore "https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcBatchSnapshotRepository.java"
click node_snapshotapi "https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/api/SnapshotController.java"
click node_snapshot "https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/domain/GridSnapshot.java"
click node_auth "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/core/auth/auth.config.ts"
click node_routing "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/app.routes.ts"
click node_traffic "https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/advisory/infrastructure/TrafficLightController.java"
click node_alerts "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/citizen/alerts/alerts.ts"
click node_notifications "https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/delivery/application/InAppNotificationService.java"
click node_notificationui "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/layout/notifications/notification-bell.ts"
click node_keys "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/devops/api-keys/api-keys.ts"
click node_intensityapi "https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/automation/infrastructure/CarbonIntensityController.java"
click node_dashboard "https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/regional/application/GetRegionalDashboard.java"
click node_dashboardui "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/official/regional-dashboard/regional-dashboard.ts"
click node_targets "https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/regional/application/ManageTargets.java"
click node_targetui "https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/official/targets/targets.ts"

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_pollers,node_odreclient,node_speed,node_stream,node_batch,node_batchstore,node_snapshotapi,node_snapshot,node_frontend toneBlue
class node_auth,node_routing,node_odre toneAmber
class node_traffic,node_alerts,node_notifications,node_notificationui toneMint
class node_keys,node_intensityapi toneRose
class node_dashboard,node_dashboardui,node_targets,node_targetui toneIndigo
```

## Components

### Grid intelligence

- [Grid pollers](https://github.com/youssefbm2104/2bgreen/tree/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/poller): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/poller`
- [ODRÉ client](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/odre/OdreClient.java): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/odre/OdreClient.java`
- [Live snapshots](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcSpeedSnapshotRepository.java): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcSpeedSnapshotRepository.java`
- [Snapshot streams](https://github.com/youssefbm2104/2bgreen/tree/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/stream): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/stream`
- [History batches](https://github.com/youssefbm2104/2bgreen/tree/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/batch): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/batch`
- [History storage](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcBatchSnapshotRepository.java): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/persistence/JdbcBatchSnapshotRepository.java`
- [Snapshot API](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/api/SnapshotController.java): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/infrastructure/api/SnapshotController.java`
- [Grid snapshot model](https://github.com/youssefbm2104/2bgreen/blob/main/grid-intelligence/src/main/java/com/twobgreen/gridintelligence/domain/GridSnapshot.java): `grid-intelligence/src/main/java/com/twobgreen/gridintelligence/domain/GridSnapshot.java`

### Platform services

- [OIDC and roles](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/core/auth/auth.config.ts): `frontend/src/app/core/auth/auth.config.ts`
- [Role-based routing](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`

### Citizen experience

- [Traffic light](https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/advisory/infrastructure/TrafficLightController.java): `platform/src/main/java/com/twobgreen/platform/advisory/infrastructure/TrafficLightController.java`
- [Clean-grid alerts](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/citizen/alerts/alerts.ts): `frontend/src/app/features/citizen/alerts/alerts.ts`
- [In-app notifications](https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/delivery/application/InAppNotificationService.java): `platform/src/main/java/com/twobgreen/platform/delivery/application/InAppNotificationService.java`
- [Notification bell](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/layout/notifications/notification-bell.ts): `frontend/src/app/layout/notifications/notification-bell.ts`

### DevOps experience

- [API key management](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/devops/api-keys/api-keys.ts): `frontend/src/app/features/devops/api-keys/api-keys.ts`
- [Intensity API](https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/automation/infrastructure/CarbonIntensityController.java): `platform/src/main/java/com/twobgreen/platform/automation/infrastructure/CarbonIntensityController.java`

### Regional experience

- [Regional dashboard](https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/regional/application/GetRegionalDashboard.java): `platform/src/main/java/com/twobgreen/platform/regional/application/GetRegionalDashboard.java`
- [Dashboard page](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/official/regional-dashboard/regional-dashboard.ts): `frontend/src/app/features/official/regional-dashboard/regional-dashboard.ts`
- [Target management](https://github.com/youssefbm2104/2bgreen/blob/main/platform/src/main/java/com/twobgreen/platform/regional/application/ManageTargets.java): `platform/src/main/java/com/twobgreen/platform/regional/application/ManageTargets.java`
- [Targets page](https://github.com/youssefbm2104/2bgreen/blob/main/frontend/src/app/features/official/targets/targets.ts): `frontend/src/app/features/official/targets/targets.ts`

### Other components

- **ODRÉ data**
- **Web user**

## Connections

- Web user → OIDC and roles: signs in (evidence: `frontend/src/app/core/auth/auth.config.ts`)
- Web user → Role-based routing: opens workspace (evidence: `frontend/src/app/app.routes.ts`)
- Role-based routing → Traffic light: routes citizen (evidence: `README.md`)
- Role-based routing → Clean-grid alerts: routes citizen
- Role-based routing → API key management: routes DevOps
- Role-based routing → Dashboard page: routes official
- Role-based routing → Targets page: routes official
- Clean-grid alerts → In-app notifications: manages alerts (evidence: `README.md`)
- Notification bell → In-app notifications: displays notices (evidence: `README.md`)
- API key management → Intensity API: uses API key (evidence: `README.md`)
- Dashboard page → Regional dashboard: loads dashboard
- Targets page → Target management: manages targets
- ODRÉ data → ODRÉ client: serves grid data (evidence: `README.md`)
- Grid pollers → ODRÉ client: fetches readings
- Grid pollers → Live snapshots: stores live data (evidence: `README.md`)
- Snapshot streams → Live snapshots: processes snapshots (evidence: `README.md`)
- History batches → ODRÉ client: fetches history (evidence: `README.md`)
- History batches → History storage: stores history (evidence: `README.md`)
- Live snapshots → Snapshot API: serves snapshots (evidence: `README.md`)
- History storage → Snapshot API: serves history (evidence: `README.md`)
- Snapshot API → Traffic light: provides readings (evidence: `README.md`)
- Snapshot API → Regional dashboard: provides readings (evidence: `README.md`)
- Traffic light → Web user: returns advice (evidence: `README.md`)
- Intensity API → Snapshot API: reads grid data (evidence: `README.md`)
