fix: Improve provider update error handling and add VRM provider settings validation (#887)

* fix: improve error handling for provider updates

Distinguishes failures of active providers from inactive ones.
Propagates errors only for enabled providers, allowing execution
to continue if a non-active provider fails, which avoids unnecessary
interruptions and improves robustness.

* fix: add provider settings validation for forecast requests

Prevents potential runtime errors by checking if provider settings are configured
before accessing forecast credentials.

Raises a clear error when settings are missing to help with debugging misconfigurations.

* refactor(load): move provider settings to top-level fields

Transitions load provider settings from a nested "provider_settings" object with provider-specific keys to dedicated top-level fields.\n\nRemoves the legacy "provider_settings" mapping and updates migration logic to ensure backward compatibility with existing configurations.

* docs: update version numbers and documantation

---------

Co-authored-by: Normann <github@koldrack.com>

src/akkudoktoreos/server/dash/prediction.py

@@ -154,9 +154,7 @@ def LoadForecast(predictions: pd.DataFrame, config: dict, date_time_tz: str, dar
     source = ColumnDataSource(predictions)
     provider = config["load"]["provider"]
     if provider == "LoadAkkudoktorAdjusted":
-        year_energy = config["load"]["provider_settings"]["LoadAkkudoktor"][
-            "loadakkudoktor_year_energy_kwh"
-        ]
+        year_energy = config["load"]["loadakkudoktor"]["loadakkudoktor_year_energy_kwh"]
         provider = f"{provider}, {year_energy} kWh"
 
     plot = figure(

src/akkudoktoreos/server/eos.py

@@ -54,7 +54,7 @@ from akkudoktoreos.optimization.genetic.geneticparams import (
 from akkudoktoreos.optimization.genetic.geneticsolution import GeneticSolution
 from akkudoktoreos.optimization.optimization import OptimizationSolution
 from akkudoktoreos.prediction.elecprice import ElecPriceCommonSettings
-from akkudoktoreos.prediction.load import LoadCommonProviderSettings, LoadCommonSettings
+from akkudoktoreos.prediction.load import LoadCommonSettings
 from akkudoktoreos.prediction.loadakkudoktor import LoadAkkudoktorCommonSettings
 from akkudoktoreos.prediction.pvforecast import PVForecastCommonSettings
 from akkudoktoreos.server.rest.cli import cli_apply_args_to_config, cli_parse_args
@@ -1074,10 +1074,8 @@ async def fastapi_gesamtlast(request: GesamtlastRequest) -> list[float]:
         },
         "load": {
             "provider": "LoadAkkudoktorAdjusted",
-            "provider_settings": {
-                "LoadAkkudoktor": {
-                    "loadakkudoktor_year_energy_kwh": request.year_energy,
-                },
+            "loadakkudoktor": {
+                "loadakkudoktor_year_energy_kwh": request.year_energy,
             },
         },
         "measurement": {
@@ -1174,10 +1172,8 @@ async def fastapi_gesamtlast_simple(year_energy: float) -> list[float]:
     settings = SettingsEOS(
         load=LoadCommonSettings(
             provider="LoadAkkudoktor",
-            provider_settings=LoadCommonProviderSettings(
-                LoadAkkudoktor=LoadAkkudoktorCommonSettings(
-                    loadakkudoktor_year_energy_kwh=year_energy / 1000,  # Convert to kWh
-                ),
+            loadakkudoktor=LoadAkkudoktorCommonSettings(
+                loadakkudoktor_year_energy_kwh=year_energy / 1000,  # Convert to kWh
             ),
         )
     )