feat: add bidding zone to energy charts price prediction (#765)

Energy charts supports bidding zones. Allow to specifiy the bidding zone in the configuration.

Extend and simplify ElecPrice configuration structure and setup config migration to automatically
update the configuration file.

Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>

src/akkudoktoreos/prediction/elecpriceenergycharts.py

@@ -7,21 +7,44 @@ format, enabling consistent access to forecasted and historical electricity pric
 """
 
 from datetime import datetime
+from enum import Enum
 from typing import Any, List, Optional, Union
 
 import numpy as np
 import pandas as pd
 import requests
 from loguru import logger
-from pydantic import ValidationError
+from pydantic import Field, ValidationError
 from statsmodels.tsa.holtwinters import ExponentialSmoothing
 
+from akkudoktoreos.config.configabc import SettingsBaseModel
 from akkudoktoreos.core.cache import cache_in_file
 from akkudoktoreos.core.pydantic import PydanticBaseModel
 from akkudoktoreos.prediction.elecpriceabc import ElecPriceProvider
 from akkudoktoreos.utils.datetimeutil import to_datetime, to_duration
 
 
+class EnergyChartsBiddingZones(str, Enum):
+    """Energy Charts Bidding Zones."""
+
+    AT = "AT"
+    BE = "BE"
+    CH = "CH"
+    CZ = "CZ"
+    DE_LU = "DE-LU"
+    DE_AT_LU = "DE-AT-LU"
+    DK1 = "DK1"
+    DK2 = "DK2"
+    FR = "FR"
+    HU = "HU"
+    IT_North = "IT-NORTH"
+    NL = "NL"
+    NO2 = "NO2"
+    PL = "PL"
+    SE4 = "SE4"
+    SI = "SI"
+
+
 class EnergyChartsElecPrice(PydanticBaseModel):
     license_info: str
     unix_seconds: List[int]
@@ -30,6 +53,21 @@ class EnergyChartsElecPrice(PydanticBaseModel):
     deprecated: bool
 
 
+class ElecPriceEnergyChartsCommonSettings(SettingsBaseModel):
+    """Common settings for Energy Charts electricity price provider."""
+
+    bidding_zone: EnergyChartsBiddingZones = Field(
+        default=EnergyChartsBiddingZones.DE_LU,
+        json_schema_extra={
+            "description": (
+                "Bidding Zone: 'AT', 'BE', 'CH', 'CZ', 'DE-LU', 'DE-AT-LU', 'DK1', 'DK2', 'FR', "
+                "'HU', 'IT-NORTH', 'NL', 'NO2', 'PL', 'SE4' or 'SI'"
+            ),
+            "examples": ["AT"],
+        },
+    )
+
+
 class ElecPriceEnergyCharts(ElecPriceProvider):
     """Fetch and process electricity price forecast data from Energy-Charts.
 
@@ -95,7 +133,8 @@ class ElecPriceEnergyCharts(ElecPriceProvider):
             )
 
         last_date = to_datetime(self.end_datetime, as_string="YYYY-MM-DD")
-        url = f"{source}/price?bzn=DE-LU&start={start_date}&end={last_date}"
+        bidding_zone = str(self.config.elecprice.energycharts.bidding_zone)
+        url = f"{source}/price?bzn={bidding_zone}&start={start_date}&end={last_date}"
         response = requests.get(url, timeout=30)
         logger.debug(f"Response from {url}: {response}")
         response.raise_for_status()  # Raise an error for bad responses