hass.tibber_prices/docs/development/architecture.md

887 B

Architecture

Note: This guide is under construction. For now, please refer to 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 "Architecture Overview" section for complete details.