Merge remote-tracking branch 'origin/codex/fehler-im-ladealgorithmus-untersuchen' into feat/optimization-interval-15min

# Conflicts:
#	CHANGELOG.md

Author: chloepriceless

CHANGELOG.md

@@ -8,11 +8,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Added
 
+- New PV forecast providers giving operators more cloud forecast sources to choose from in
+  addition to Akkudoktor, VRM and Import:
+  - `PVForecastPVNode` — native 15-minute forecasts from the pvnode.com API.
+  - `PVForecastForecastSolar` — forecasts from the free Forecast.Solar API.
+  - `PVForecastSolcast` — forecasts from the Solcast rooftop-site API.
 - 15-minute optimization interval for the genetic optimizer. `optimization.interval`
   now accepts 900 (15 min) in addition to the default 3600 (1 hour), letting the
   optimizer schedule on a quarter-hour grid for 15-minute dynamic electricity
   tariffs. Device power caps and the solution/plan serializers are slot-aware; the
-  default 3600 s interval keeps the previous hourly behaviour.
+  default 3600 s interval keeps the previous hourly behaviour. The new sub-hourly PV
+  providers (pvnode, Forecast.Solar, Solcast) feed their native resolution straight
+  into the quarter-hour grid.
 
 ## 0.3.0 (2026-03-17)
 

docs/_generated/configelecprice.md

@@ -13,6 +13,7 @@
 | energycharts | `EOS_ELECPRICE__ENERGYCHARTS` | `ElecPriceEnergyChartsCommonSettings` | `rw` | `required` | Energy Charts provider settings. |
 | provider | `EOS_ELECPRICE__PROVIDER` | `Optional[str]` | `rw` | `None` | Electricity price provider id of provider to be used. |
 | providers | | `list[str]` | `ro` | `N/A` | Available electricity price provider ids. |
+| tibber | `EOS_ELECPRICE__TIBBER` | `ElecPriceTibberCommonSettings` | `rw` | `required` | Tibber electricity price provider settings. |
 | vat_rate | `EOS_ELECPRICE__VAT_RATE` | `Optional[float]` | `rw` | `1.19` | VAT rate factor applied to electricity price when charges are used. |
 :::
 <!-- pyml enable line-length -->
@@ -39,6 +40,10 @@
            },
            "energycharts": {
                "bidding_zone": "DE-LU"
+           },
+           "tibber": {
+               "access_token": null,
+               "home_id": null
            }
        }
    }
@@ -68,9 +73,14 @@
            "energycharts": {
                "bidding_zone": "DE-LU"
            },
+           "tibber": {
+               "access_token": null,
+               "home_id": null
+           },
            "providers": [
                "ElecPriceAkkudoktor",
                "ElecPriceEnergyCharts",
+               "ElecPriceTibber",
                "ElecPriceFixed",
                "ElecPriceImport"
            ]
@@ -79,6 +89,37 @@
 ```
 <!-- pyml enable line-length -->
 
+### Common settings for the Tibber electricity price provider
+
+<!-- pyml disable line-length -->
+:::{table} elecprice::tibber
+:widths: 10 10 5 5 30
+:align: left
+
+| Name | Type | Read-Only | Default | Description |
+| ---- | ---- | --------- | ------- | ----------- |
+| access_token | `Optional[str]` | `rw` | `None` | Tibber API access token. |
+| home_id | `Optional[str]` | `rw` | `None` | Tibber home id to read prices from. |
+:::
+<!-- pyml enable line-length -->
+
+<!-- pyml disable no-emphasis-as-heading -->
+**Example Input/Output**
+<!-- pyml enable no-emphasis-as-heading -->
+
+<!-- pyml disable line-length -->
+```json
+   {
+       "elecprice": {
+           "tibber": {
+               "access_token": "tibber_pat_...",
+               "home_id": "00000000-0000-0000-0000-000000000000"
+           }
+       }
+   }
+```
+<!-- pyml enable line-length -->
+
 ### Common settings for Energy Charts electricity price provider
 
 <!-- pyml disable line-length -->

docs/_generated/configexample.md

@@ -110,6 +110,10 @@
            },
            "energycharts": {
                "bidding_zone": "DE-LU"
+           },
+           "tibber": {
+               "access_token": null,
+               "home_id": null
            }
        },
        "ems": {
@@ -187,7 +191,10 @@
            "provider": "PVForecastAkkudoktor",
            "provider_settings": {
                "PVForecastImport": null,
-               "PVForecastVrm": null
+               "PVForecastVrm": null,
+               "PVForecastPVNode": null,
+               "PVForecastForecastSolar": null,
+               "PVForecastSolcast": null
            },
            "planes": [
                {

docs/_generated/configpvforecast.md

@@ -31,7 +31,10 @@
            "provider": "PVForecastAkkudoktor",
            "provider_settings": {
                "PVForecastImport": null,
-               "PVForecastVrm": null
+               "PVForecastVrm": null,
+               "PVForecastPVNode": null,
+               "PVForecastForecastSolar": null,
+               "PVForecastSolcast": null
            },
            "planes": [
                {
@@ -96,7 +99,10 @@
            "provider": "PVForecastAkkudoktor",
            "provider_settings": {
                "PVForecastImport": null,
-               "PVForecastVrm": null
+               "PVForecastVrm": null,
+               "PVForecastPVNode": null,
+               "PVForecastForecastSolar": null,
+               "PVForecastSolcast": null
            },
            "planes": [
                {
@@ -148,6 +154,9 @@
            "providers": [
                "PVForecastAkkudoktor",
                "PVForecastVrm",
+               "PVForecastPVNode",
+               "PVForecastForecastSolar",
+               "PVForecastSolcast",
                "PVForecastImport"
            ],
            "planes_peakpower": [
@@ -183,6 +192,105 @@
 ```
 <!-- pyml enable line-length -->
 
+### Common settings for the Solcast PV forecast provider
+
+<!-- pyml disable line-length -->
+:::{table} pvforecast::provider_settings::PVForecastSolcast
+:widths: 10 10 5 5 30
+:align: left
+
+| Name | Type | Read-Only | Default | Description |
+| ---- | ---- | --------- | ------- | ----------- |
+| api_key | `str` | `rw` | `` | Solcast API key (Bearer auth). Required. |
+| site_id | `str` | `rw` | `` | Solcast rooftop site (resource) id. Required. |
+:::
+<!-- pyml enable line-length -->
+
+<!-- pyml disable no-emphasis-as-heading -->
+**Example Input/Output**
+<!-- pyml enable no-emphasis-as-heading -->
+
+<!-- pyml disable line-length -->
+```json
+   {
+       "pvforecast": {
+           "provider_settings": {
+               "PVForecastSolcast": {
+                   "api_key": "your-solcast-key",
+                   "site_id": "abcd-1234-efgh-5678"
+               }
+           }
+       }
+   }
+```
+<!-- pyml enable line-length -->
+
+### Common settings for the Forecast.Solar PV forecast provider
+
+<!-- pyml disable line-length -->
+:::{table} pvforecast::provider_settings::PVForecastForecastSolar
+:widths: 10 10 5 5 30
+:align: left
+
+| Name | Type | Read-Only | Default | Description |
+| ---- | ---- | --------- | ------- | ----------- |
+| api_key | `Optional[str]` | `rw` | `None` | Forecast.Solar API key. Optional — the public endpoint works without a key (lower rate limit). |
+:::
+<!-- pyml enable line-length -->
+
+<!-- pyml disable no-emphasis-as-heading -->
+**Example Input/Output**
+<!-- pyml enable no-emphasis-as-heading -->
+
+<!-- pyml disable line-length -->
+```json
+   {
+       "pvforecast": {
+           "provider_settings": {
+               "PVForecastForecastSolar": {
+                   "api_key": null
+               }
+           }
+       }
+   }
+```
+<!-- pyml enable line-length -->
+
+### Common settings for the pvnode.com PV forecast provider
+
+<!-- pyml disable line-length -->
+:::{table} pvforecast::provider_settings::PVForecastPVNode
+:widths: 10 10 5 5 30
+:align: left
+
+| Name | Type | Read-Only | Default | Description |
+| ---- | ---- | --------- | ------- | ----------- |
+| api_key | `str` | `rw` | `` | pvnode.com API key (Bearer auth). Required. |
+| forecast_days | `int` | `rw` | `2` | Forecast horizon in days (1-7, capped by the pvnode plan). |
+| site_id | `Optional[str]` | `rw` | `None` | pvnode.com site id of the saved plant ('Anlagen-ID'). When set, the saved (possibly calibrated) site is used. Leave empty to send the configured pvforecast.planes inline instead. |
+:::
+<!-- pyml enable line-length -->
+
+<!-- pyml disable no-emphasis-as-heading -->
+**Example Input/Output**
+<!-- pyml enable no-emphasis-as-heading -->
+
+<!-- pyml disable line-length -->
+```json
+   {
+       "pvforecast": {
+           "provider_settings": {
+               "PVForecastPVNode": {
+                   "api_key": "pvn_live_xxxxxxxxxxxxxxxx",
+                   "site_id": "abcd-1234",
+                   "forecast_days": 2
+               }
+           }
+       }
+   }
+```
+<!-- pyml enable line-length -->
+
 ### Common settings for PV forecast VRM API
 
 <!-- pyml disable line-length -->
@@ -258,7 +366,10 @@
 
 | Name | Type | Read-Only | Default | Description |
 | ---- | ---- | --------- | ------- | ----------- |
+| PVForecastForecastSolar | `Optional[akkudoktoreos.prediction.pvforecastforecastsolar.PVForecastForecastSolarCommonSettings]` | `rw` | `None` | PVForecastForecastSolar settings |
 | PVForecastImport | `Optional[akkudoktoreos.prediction.pvforecastimport.PVForecastImportCommonSettings]` | `rw` | `None` | PVForecastImport settings |
+| PVForecastPVNode | `Optional[akkudoktoreos.prediction.pvforecastpvnode.PVForecastPVNodeCommonSettings]` | `rw` | `None` | PVForecastPVNode settings |
+| PVForecastSolcast | `Optional[akkudoktoreos.prediction.pvforecastsolcast.PVForecastSolcastCommonSettings]` | `rw` | `None` | PVForecastSolcast settings |
 | PVForecastVrm | `Optional[akkudoktoreos.prediction.pvforecastvrm.PVForecastVrmCommonSettings]` | `rw` | `None` | PVForecastVrm settings |
 :::
 <!-- pyml enable line-length -->
@@ -273,7 +384,10 @@
        "pvforecast": {
            "provider_settings": {
                "PVForecastImport": null,
-               "PVForecastVrm": null
+               "PVForecastVrm": null,
+               "PVForecastPVNode": null,
+               "PVForecastForecastSolar": null,
+               "PVForecastSolcast": null
            }
        }
    }

docs/_generated/openapi.md

@@ -1,6 +1,6 @@
 # Akkudoktor-EOS
 
-**Version**: `v0.3.0.dev2604141105859917`
+**Version**: `v0.3.0.dev2607071966322885`
 
 <!-- pyml disable line-length -->
 **Description**: This project provides a comprehensive solution for simulating and optimizing an energy system based on renewable energy sources. With a focus on photovoltaic (PV) systems, battery storage (batteries), load management (consumer requirements), heat pumps, electric vehicles, and consideration of electricity price data, this system enables forecasting and optimization of energy flow and costs over a specified period.

docs/akkudoktoreos/prediction.md

@@ -373,6 +373,9 @@ Configuration options:
 
     - `PVForecastAkkudoktor`: Retrieves from Akkudoktor.net.
     - `PVForecastVrm`: Retrieves data from the VRM API by Victron Energy.
+    - `PVForecastPVNode`: Retrieves native 15-minute forecasts from the pvnode.com API.
+    - `PVForecastForecastSolar`: Retrieves forecasts from the free Forecast.Solar API.
+    - `PVForecastSolcast`: Retrieves forecasts from the Solcast rooftop-site API.
     - `PVForecastImport`: Imports from a file or JSON string or by endpoint data provision.
 
   - `planes[].surface_tilt`: Tilt angle from horizontal plane. Ignored for two-axis tracking.
@@ -401,6 +404,12 @@ Configuration options:
   - `planes[].strings_per_inverter`: Number of the strings of the inverter of this plane.
   - `provider_settings.import_file_path`: Path to the file to import PV forecast data from.
   - `provider_settings.import_json`: JSON string, dictionary of PV forecast value lists.
+  - `provider_settings.PVForecastPVNode.api_key`: pvnode.com API key.
+  - `provider_settings.PVForecastPVNode.site_id`: pvnode.com saved-site id. Leave empty for inline mode.
+  - `provider_settings.PVForecastPVNode.forecast_days`: Forecast horizon in days (1-7).
+  - `provider_settings.PVForecastForecastSolar.api_key`: Forecast.Solar API key (optional).
+  - `provider_settings.PVForecastSolcast.api_key`: Solcast API key.
+  - `provider_settings.PVForecastSolcast.site_id`: Solcast rooftop resource (site) id.
 
 ---
 
@@ -604,6 +613,84 @@ The PV forecast data must be provided in one of the formats described in
 The data may additionally or solely be provided by the
 **PUT** `/v1/prediction/import/PVForecastImport` endpoint.
 
+### PVForecastPVNode Provider
+
+The `PVForecastPVNode` provider retrieves native 15-minute PV power forecasts from the
+[pvnode.com](https://pvnode.com) V2 API. Register a site in the pvnode web app and store the API
+key together with the site id in the EOS configuration (saved-site mode). Alternatively, leave the
+site id empty to send the configured `planes` geometry inline.
+
+```python
+    {
+        "pvforecast": {
+            "provider": "PVForecastPVNode",
+            "provider_settings": {
+                "PVForecastPVNode": {
+                    "api_key": "your-pvnode-key",
+                    "site_id": "your-site-id",
+                    "forecast_days": 2
+                }
+            }
+        }
+    }
+```
+
+The prediction keys for the PV forecast data are:
+
+- `pvforecast_ac_power`: Total AC power (W).
+- `pvforecast_dc_power`: Total DC power (W).
+
+### PVForecastForecastSolar Provider
+
+The `PVForecastForecastSolar` provider retrieves PV power forecasts from the free
+[Forecast.Solar](https://forecast.solar) API. No API key is required for the public endpoint; an
+optional key raises the rate limit. The location is taken from `general.latitude`/`longitude` and
+the system geometry from the configured `planes` (one request per plane, summed per timestamp).
+
+```python
+    {
+        "pvforecast": {
+            "provider": "PVForecastForecastSolar",
+            "provider_settings": {
+                "PVForecastForecastSolar": {
+                    "api_key": null
+                }
+            }
+        }
+    }
+```
+
+The prediction keys for the PV forecast data are:
+
+- `pvforecast_ac_power`: Total AC power (W).
+- `pvforecast_dc_power`: Total DC power (W).
+
+### PVForecastSolcast Provider
+
+The `PVForecastSolcast` provider retrieves PV power forecasts from the
+[Solcast](https://solcast.com) rooftop-site API. Register a rooftop site in the Solcast web app and
+store the API key together with the resource (site) id in the EOS configuration. Note that the free
+tier limits the number of API calls per day.
+
+```python
+    {
+        "pvforecast": {
+            "provider": "PVForecastSolcast",
+            "provider_settings": {
+                "PVForecastSolcast": {
+                    "api_key": "your-solcast-key",
+                    "site_id": "your-resource-id"
+                }
+            }
+        }
+    }
+```
+
+The prediction keys for the PV forecast data are:
+
+- `pvforecast_ac_power`: Total AC power (W).
+- `pvforecast_dc_power`: Total DC power (W).
+
 ## Weather Prediction
 
 Prediction keys: