Main version 2024.12.0

dao/CHANGELOG.md

@@ -1,6 +1,58 @@
 # Changelog 刀 DAO
 # Day Ahead Optimizer
 
+# [V2024.12.0] 
+# LET OP
+De energiebelasting wijzigt per 1 januari 2025.<br>
+Neem deze over van onderstaande lijst in je instellingen:<br>
+```
+    "energy taxes delivery": {
+      "2022-01-01": 0.06729,
+      "2023-01-01": 0.12599,
+      "2024-01-01": 0.10880,
+      "2025-01-01": 0.10154
+    },
+    "energy taxes redelivery": {
+      "2022-01-01": 0.06729,
+      "2023-01-01": 0.12599,
+      "2024-01-01": 0.10880,
+      "2025-01-01": 0.10154
+    },
+```
+# Breaking change
+There is an extra optional parameter when calling an api-report: **expected**.<br>
+When you call the api without `expected` or `expected=0` (default value) then only **recorded** values 
+are reported and the expected part of the json-result will be empty.
+When you call with the parameter `expected=1` then the expected values are reported in the expected 
+part of the json-result.<br>
+For periods with the interval "hour", there will be no change.
+But for periodes with the interval "day" or "month" this can lead to new results. 
+For instance when you call the api for period "deze_week", without the parameter "expected" you get this result:<br>
+```{ "message":"Success", "recorded": [{"time":"2024-12-02 00:00","value":36.7450000558},{"time":"2024-12-03 00:00","value":19.1840000708},{"time":"2024-12-04 00:00","value":36.8009995644},{"time":"2024-12-05 00:00","value":19.7590002147},{"time":"2024-12-06 00:00","value":43.3299993972},{"time":"2024-12-07 00:00","value":24.9570001736},{"time":"2024-12-08 00:00","value":6.462}], "expected" : [] }```<br>
+But when you call it with "expected=1" then you get:<br>
+```{ "message":"Success", "recorded": [{"time":"2024-12-02 00:00","value":36.7450000558},{"time":"2024-12-03 00:00","value":19.1840000708},{"time":"2024-12-04 00:00","value":36.8009995644},{"time":"2024-12-05 00:00","value":19.7590002147},{"time":"2024-12-06 00:00","value":43.3299993972},{"time":"2024-12-07 00:00","value":24.9570001736}], "expected" : [{"time":"2024-12-08 00:00","value":14.282395}] }```<br>
+The total consumption of "2024-12-08" is now mentioned in the expexted part, because a part of the consumption is expected.
+
+# Other changes
+- "optimal lower level" is not used anymore: it was too difficult and too complex to understand and
+didn't give enough good results
+- The calculated cycle costs  are (per battery) logged (level info).
+- There was a general error in api-calls, fixed.
+- There is an error reported in a api-call: `http://<ip-adres>:5000/api/report/cost/deze_maand`. <br>This error is fixed?
+- Fixed error api call "netto_cost"
+- Scheduling of boiler can be postponed via a ha-entity
+- when boiler is heated bij the heat pump for room-heating then there can only be "one" heating 
+function in an hour, therefore is a new setting introduced in the boiler-section: "boiler heated 
+by heatpump". This setting can be "True" or "False"
+- the code is brought inline with PEP 8 (Style Guide for Python Code)
+- Scheduling of heatpump can be set via a ha-entity
+- Scheduling of heatpump can be achieved in three ways:
+  - on/off
+  - heat curve adjustment
+  - calculated power
+- When setting a state of an entity failed then an error message is written in the log 
+  (name of the entity, new failed value)
+
 ## [V2024.11.1]
 - Fixed an error when getting Tibber-data when using a Tibber pulse: 
 only data before today are stored
@@ -420,7 +472,7 @@ Zie DOCS.md
 
 ### Removed
 De functionaliteit om via de websocket in HA een berekening te starten is verwijderd.
-Dat kan nu via een rest-command: /api/run
+Dat kan nu via een rest-command: `/api/run`
 
 
 ## [v0.3.1] - 2023-09-12
@@ -495,7 +547,7 @@ Dit is hersteld.
 Dit heeft twee voordelen: <br>
   - het rekent veel sneller
   - er wordt makkelijker tussen twee "stages" geinterpoleerd. <br>
-  Als dit goed bevalt, zal het ook worden geimplementeerd voor het ontladen (van dc naar ac) en van dc naar batterij en vice versa.<br>
+  Als dit goed bevalt, zal het ook worden geimplementeerd voor het ontladen (van `dc` naar `ac`) en van `dc` naar batterij en vice versa.<br>
 - de prijzengrafieken zijn in blokvorm en uitgelijnd met de verbruiksgrafieken
 
 
@@ -531,7 +583,7 @@ De loggings zijn te vinden in data\log\dashboard.log.
 - versienummer in bestand _version.py
 - check op voldoende aantal rijen bij prognose data (dynamische prijzen en meteo)
     - bij 2 rijen of minder wordt er niet gerekend<br>
-    - bij 3 tot 8 rijen wordt er wel gerekend maar wordt er wel een waarschuwing afgegeven 
+    - bij 3 tot 8 rijen wordt er wel gerekend, maar wordt er wel een waarschuwing afgegeven 
 
 - een changelog
 - naar keuze datum-tijd of alleen tijd input helper voor aangeven wanneer een elektrische auto geladen moet zijn
@@ -548,7 +600,7 @@ gaf het programma verkeerde resultaten voor dat eerste uur. Dit is gefixed.
 - laden auto wordt alleen uitgezet als auto thuis is (en aangesloten) 
 - ongebruikte instellingen uit DOCS.md gehaald
 - navigatieknoppen in webserver bij "home" omgezet
-- menu optie **Meteo** in webserver voorzien van toelichting "in ontwikkeling"
+- menuoptie **Meteo** in webserver voorzien van toelichting "in ontwikkeling"
 - notificatie via Home Assistant toegevoegd. Zie voor meer informatie DOCS.md bij **notification entity**
 - in het instellingenbestand options.json is de naam van de entity aanduiding veranderd: <br>
 `"entity ready time"` wordt `"entity ready datetime"`
@@ -557,8 +609,8 @@ gaf het programma verkeerde resultaten voor dat eerste uur. Dit is gefixed.
 
 ### Issues
 Als het programma draait in scheduler-mode wordt een websocket geopend naar HA zodat vanuit HA een 
-optimaliserings berekening kan worden gestart.
-Als HA stopt (bijv voor een update) dan blijft de websocket "in de lucht" maar is niet meer effectief.
+optimaliseringsberekening kan worden gestart.
+Als HA stopt (bijv. voor een update) dan blijft de websocket "in de lucht" maar is niet meer effectief.
 
 ### Removed