mirror of
https://github.com/jpawlowski/hass.tibber_prices.git
synced 2026-03-29 21:03:40 +00:00
21 lines
887 B
Markdown
21 lines
887 B
Markdown
# Architecture
|
|
|
|
> **Note:** This guide is under construction. For now, please refer to [`AGENTS.md`](../../AGENTS.md) for detailed architecture information.
|
|
|
|
## Core Components
|
|
|
|
### Data Flow
|
|
1. `TibberPricesApiClient` - GraphQL API client
|
|
2. `TibberPricesDataUpdateCoordinator` - Update orchestration & caching
|
|
3. Price enrichment functions - Statistical calculations
|
|
4. Entity platforms - Sensors and binary sensors
|
|
5. Custom services - API endpoints
|
|
|
|
### Key Patterns
|
|
|
|
- **Dual translation system**: `/translations/` (HA schema) + `/custom_translations/` (extended)
|
|
- **Price enrichment**: 24h trailing/leading averages, ratings, differences
|
|
- **Quarter-hour precision**: Entity updates on 00/15/30/45 boundaries
|
|
- **Intelligent caching**: User data (24h), price data (calendar day validation)
|
|
|
|
See [`AGENTS.md`](../../AGENTS.md) "Architecture Overview" section for complete details.
|