Usage

bedienung/administrator.md

@@ -2,30 +2,38 @@
 title: Administrator-Zugang
 layout: page
 parent: Bedienung
+nav_order: 1
 ---
 
-Der Administrator-Zugang gewährleistet, dass nur autorisierte Benutzer bestimmte kritische Funktionen von SOLECTRUS ausführen können. Zu den gegenwärtig geschützten Funktionen gehören:
+# Administrator-Zugang
+
+Einige Bereiche von SOLECTRUS sind geschützt und nur für autorisierte Benutzer zugänglich. Dazu gehören:
 
 - Festlegung der Strompreise, der Einspeisevergütung und weiterer Optionen
 - Durchführung der Registrierung
+- Abschließen eines Sponsoring-Abos
+
+Diese Funktionen sind dem Administrator vorbehalten. Die normalen Benutzer haben nur Lesezugriff und können keine Einstellungen ändern.
 
-Ohne vorherigen Admin-Login hat ein Benutzer nur Lesezugriff und kann dementsprechend keine Einstellungen ändern.
+Die Anmeldung erfolgt über das Seitenmenü und sieht dann so aus:
 
 <img src="{{ site.baseurl }}/assets/images/login.png" alt="Login" class="mx-auto w-full max-w-2xl rounded-full border-8 border-indigo-300" />
 
-Übrigens: Wie du hier sehen kannst, ist es wirklich nur ein Passwort. Aus Gründen der Einfachheit gibt es keinen Benutzernamen oder E-Mail-Adresse.
+Wie man hier sehen kann, ist es wirklich nur ein Passwort. Aus Gründen der Einfachheit gibt es keinen Benutzernamen oder E-Mail-Adresse. Das Passwort kann einer weiteren Person mitgeteilt werden, die dann ebenfalls Zugriff auf die Einstellungen erhält.
 
-Diese Funktion ist besonders nützlich, wenn deine Installation von SOLECTRUS von mehreren Benutzern genutzt wird, insbesondere wenn sie über das Internet zugänglich ist. Als Administrator kannst du sicherstellen, dass niemand außer dir die Einstellungen ändert.
+Diese Funktion ist besonders nützlich, wenn eine Installation von SOLECTRUS von mehreren Benutzern genutzt wird, insbesondere wenn sie über das Internet zugänglich ist. Es wird dadurch sichergestellt, dass nur berechtigte Personen Zugriff auf die Einstellungen haben.
 
 ### Festlegen und Ändern des Passwortes
 
 Das Passwort für den Administrator-Zugang wird während der Installation von SOLECTRUS festgelegt und befindet sich in der `.env`-Datei:
 
 ```bash
 # ...
-#
-# Password to login as administrator, required to manage settings like historical prices
-ADMIN_PASSWORD=my-secret-login-password
+ADMIN_PASSWORD=me1n-gehe1mes-passw0rt
 ```
 
-Möchtest du das Passwort ändern, ist dies ausschließlich über die Bearbeitung der `.env`-Datei möglich. Nachdem du es dort geändert hast, muss SOLECTRUS neu gestartet werden, damit die Änderung wirksam wird.
+Eine Änderung des Passworts ist über die Bearbeitung der `.env`-Datei möglich. Nachdem es dort geändert wurde, muss SOLECTRUS neu gestartet werden, damit die Änderung wirksam wird:
+
+```
+docker-compose up -d
+```

bedienung/ersparnis-berechnung.md

@@ -2,35 +2,33 @@
 title: Ersparnis-Berechnung
 layout: page
 parent: Bedienung
+nav_order: 3
 ---
 
-# Berechnung der Ersparnis durch die Photovoltaikanlage
-
-## Die zwei Komponenten der Ersparnis
+# Ersparnis durch die Photovoltaikanlage
 
 Die Einsparung, die durch den Betrieb der PV-Anlage erzielt wird, besteht grundsätzlich aus zwei Komponenten:
 
 1. Einsparung durch Reduzierung des aus dem Netz bezogenen Stroms
 2. Einsparung durch Erhalt einer Einspeisevergütung für den ins Netz abgegebenen Strom
 
-SOLECTRUS berechnet die Ersparnis aus einer Gegenüberstellung zweier Szenarien: Die aktuelle Situation (d.h. **mit** PV-Anlage) wird mit einem theoretischen Szenario verglichen, bei dem man **keine** PV-Anlage hat, aber den exakt gleichen Stromverbrauch verursacht. SOLECTRUS macht also einen Vorher-Nachher-Vergleich und bildet die Differenz. Das sieht dann so aus (im Beispiel für das Jahr 2022):
+SOLECTRUS berechnet die Ersparnis aus einer Gegenüberstellung zweier Szenarien: Die aktuelle Situation (d.h. **mit** PV-Anlage) wird mit einem theoretischen Szenario verglichen, bei dem man **keine** PV-Anlage hat, aber den exakt gleichen Stromverbrauch verursacht. SOLECTRUS macht also einen Vorher-Nachher-Vergleich und bildet die Differenz. Das sieht dann so aus (im Beispiel ein einzelnes Jahr):
 
 <img
-  src="{{ site.baseurl }}/assets/images/ersparnis.png"
-  alt="Einsparung durch PV-Anlage"
-  class="mx-auto w-full max-w-2xl rounded-full border-8 border-indigo-300"
+src="{{ site.baseurl }}/assets/images/ersparnis.png"
+alt="Ersparnis durch PV-Anlage"
 />
 
 ## Berechnung der Ersparnis
 
 Die Berechnung erfolgt in drei Schritten:
 
-1. **Mit PV-Anlage**: Es werden zunächst die Kosten berechnet, die durch den Bezug von Strom tatsächlich entstehen (siehe auch die Erläuterungen zur [Kosten-Berechnung](/faq/kosten-berechnung/)). Der Betrag ist immer negativ, hier im Beispiel sind es `-386 €`. Außerdem erhält man eine Einspeisevergütung für den Überschuss (hier `624 €`, positiv). Zusammen ergibt das den "Solarpreis" als Summe, wobei die Vorzeichen zu beachten sind (hier: `-386 € + 624 € = 238 €`). Der Solarpreis ist meist positiv, kann aber je nach gewähltem Zeitraum auch negativ sein, z.B. im Winter, wenn der Strombezug mehr kostet als die Einspeisevergütung einbringt.
+1. **Mit PV-Anlage**: Es werden zunächst die Kosten berechnet, die durch den Bezug von Strom tatsächlich entstehen (siehe auch die Erläuterungen zur [Kosten-Berechnung](/bedienung/kosten-berechnung/)). Der Betrag ist immer negativ, hier im Beispiel sind es `-386 €`. Außerdem erhält man eine Einspeisevergütung für den Überschuss (hier `624 €`, positiv). Zusammen ergibt das den "Solarpreis" als Summe, wobei die Vorzeichen zu beachten sind (hier: `-386 € + 624 € = 238 €`). Der Solarpreis ist meist positiv, kann aber je nach gewähltem Zeitraum auch negativ sein, z.B. im Winter, wenn der Strombezug mehr kostet als die Einspeisevergütung einbringt.
 
 2. **Ohne PV-Anlage**: Der Strom für den gesamten Verbrauch muss gekauft werden und es gibt natürlich keine Einspeisevergütung. Gerechnet wird `(Hausverbrauch + Wallbox) * Strompreis`. In Beispiel ergibt sich ein "Vergleichspreis" (immer negativ) mit den theoretischen Strombezugskosten von `1.857 €`. Berücksichtigt werden bei der Berechnung die sich im Zeitverlauf ändernden Strompreise.
 
 3. **Vergleich**: Die mit der PV-Anlage erzielte Ersparnis ist nun die Differenz zwischen Solarpreis und Vergleichspreis. Weil der Solarpreis sowohl positiv (Sommer) als auch negativ (Winter) sein kann, sind die Vorzeichen wichtig. Im Beispiel wird gerechnet: \
-   `238 € - (- 1.857 €) = 2.095 €`. Das bedeutet: Dadurch, dass du eine PV-Anlage hast, hast du im gewählten Zeitraum 2095 € mehr im Geldbeutel, als wenn du keine PV-Anlage hättest.
+   `238 € - (- 1.857 €) = 2.095 €`. Das bedeutet: Dadurch, dass man eine PV-Anlage hast, hat man im gewählten Zeitraum 2095 € mehr im Geldbeutel, als wenn man keine PV-Anlage hätte.
 
 Zusammengefasst lässt sich die Formel wie folgt darstellen:
 
@@ -39,36 +37,25 @@ Ersparnis (€) = (Hausverbrauch + Wallbox - Strombezug) * Strompreis +
                 Einspeisung * Einspeisevergütung
 ```
 
-Da sich der Strompreis im Zeitverlauf ändern kann, wird diese Berechnung für jeden Teilzeitraum einzeln durchgeführt und das Ganze dann aufsummiert.
+Da sich der Strompreis im Zeitverlauf üblicherweise ändert, wird diese Berechnung für jeden Teilzeitraum einzeln durchgeführt und das Ganze dann aufsummiert, d.h. tatsächlich ist die Berechnung etwas komplexer.
 
-:::caution
+## Anteil des Speichers an der Ersparnis
 
-Diese Berechnungsformel unterscheidet sich von der SENEC-App, die in der aktuellen Version v4.3.2 aus mir nicht verständlichen Gründen die **Speicherentladung** (anstatt des **Strombezugs**) mit einbezieht und folgende Formel verwendet:
+Zum Schluss errechnet SOLECTRUS, welchen Anteil der Stromspeicher (Akku) an der Ersparnis hat. Hierfür wird folgende Formel verwendet:
 
 ```
-Ersparnis (€) = (Hausverbrauch + Wallbox + Speicherentladung) * Strompreis +
-                Einspeisung * Einspeisevergütung
+Ersparnis durch Akku (€) =   Akkuentnahme (kWh) * Strompreis (€/kWh)
+                           - Akkubeladung (kWh) * Einspeisevergütung (€/kWh)
 ```
 
-Dies ist aus meiner Sicht **falsch** und ergibt eine zu hohe Ersparnis.
+Die Idee ist hier, dass man einerseits den aus dem Akku entnommenen Strom nicht kaufen muss, also den Strompreis einspart. Andererseits verliert man aber auch die Einspeisevergütung für die Strommenge, mit der man den Akku auflädt.
 
-:::
-
-## Anteil des Speichers an der Ersparnis
-
-Zum Schluss errechnet SOLECTRUS, welchen Anteil der Stromspeicher (Akku) an der Ersparnis hat:
-
-```
-Ersparnis durch Akku (€) =
-    Akkuentnahme (kWh) * Strompreis (€/kWh)
-  - Akkubeladung (kWh) * Einspeisevergütung (€/kWh)
-```
+Die Akku-Ersparnis ist also der Betrag, der gespart wird, weil man einen Akku hat - gegenüber der Situation, eine PV-Anlage ohne Akku zu betreiben. Anders ausgedrückt: Mit diesem Betrag amortisiert sich die Investition in den Akku.
 
-Die Idee ist hier, dass man einerseits den aus dem Akku entnommenen Strom nicht kaufen muss, also den Strompreis einspart. Andererseits verliert man aber auch die Einspeisevergütung für die Strommenge, mit der man den Akku auflädt. Die Akku-Ersparnis ist also der Betrag, der gespart wird, weil man einen Akku hat - gegenüber der Situation, eine PV-Anlage ohne Akku zu betreiben. Anders ausgedrückt: Mit diesem Betrag amortisiert sich die Investition in den Akku.\
 Der Betrag wird schließlich noch prozentual ins Verhältnis zur vorher ausgerechneten Gesamtersparnis gesetzt.
 
 ## Zugrunde liegende Annahmen
 
 Zu beachten ist, dass diese Berechnung die Anfangsinvestitionen in die PV-Anlage nicht berücksichtigt und auch Wartungskosten, Versicherungsprämien etc. nicht mit einfließen.
 
-Ebenfalls unberücksichtigt bleibt, dass der Speicher einen nicht unerheblichen Eigenverbrauch hat und somit der Hausverbrauch höher ist, als wenn man keine PV-Anlage bzw. keinen Stromspeicher hätte.
+Ebenfalls unberücksichtigt bleibt, dass der Speicher einen nicht unerheblichen Eigenverbrauch hat und somit der Hausverbrauch höher ist, als wenn man keine PV-Anlage bzw. keinen Stromspeicher hätte. Da sich dies aber nicht genau beziffern lässt, wird dieser Effekt in der Berechnung nicht berücksichtigt.

bedienung/index.md

@@ -4,4 +4,6 @@ layout: page
 nav_order: 5
 ---
 
-todo
+# Bedienung von SOLECTRUS
+
+Die Bedienung von SOLECTRUS ist größtenteils selbsterklärend. Dennoch gibt es einige Funktionen, die nicht auf den ersten Blick ersichtlich sind. In diesem Abschnitt werden einige dieser Funktionen erklärt.

bedienung/kosten-berechnung.md

@@ -2,72 +2,73 @@
 title: Kosten-Berechnung
 layout: page
 parent: Bedienung
+nav_order: 2
 ---
 
-# Berechnung der entstandenen Stromkosten
+# Kosten durch den Stromverbrauch
 
-SOLECTRUS berechnet Kosten, die für den Verbrauch von Strom anfallen, wobei zwischen Netzbezug und Eigenverbrauch unterschieden wird. Diese werden für den ausgewählten Zeitraum dargestellt, hier ein Beispiel:
+SOLECTRUS berechnet Kosten, die für den Verbrauch von Strom anfallen, wobei zwischen **Netzbezug** und **Eigenverbrauch** unterschieden wird. Die Darstellung erfolgt für jeden beliebigen Zeitraum, z.B. für einen Monat oder ein Jahr. Hier ein Beispiel:
 
 <img
   src="{{ site.baseurl }}/assets/images/kosten.png"
   alt="Kostenberechnung"
-  class="mx-auto w-full max-w-lg rounded-full border-8 border-indigo-300"
 />
 
-Teil der Kosten ist die entgangene Einspeisevergütung, die beim Eigenverbrauch entsteht, wenn der erzeugte Strom nicht ins Netz eingespeist wird. Dieser Teil der Berechnung ist optional und kann auch deaktiviert werden.
+{: .note}
 
-:::note
+Die hier beschriebene Berechnung gilt ab Version `0.16`. Frühere Versionen haben die Kosten anders dargestellt.
 
-Die hier beschriebene Berechnung gilt ab Version `0.16.0`. Frühere Versionen haben die Kosten anders dargestellt.
+## Strompreise als Grundlagen
 
-:::
-
-Berechnungsgrundlage sind die eingestellten Strompreise, die sich regelmäßig ändern können. Auch hierzu ein Beispiel:
+Berechnungsgrundlage sind, neben dem gemessenen Netzbezug und dem Eigenverbrauch insbesondere die eingestellten Strompreise. Auch hierzu ein Beispiel:
 
 <img
   src="{{ site.baseurl }}/assets/images/strompreise.png"
   alt="Strompreise"
-  class="mx-auto w-full max-w-2xl rounded-full border-8 border-indigo-300"
 />
 
-Die Berechnung erfolgt in drei Schritten:
+## Opportunitätskosten
 
-1. Ermittlung der Strompreise, die für den ausgewählten Zeitraum gelten - hier also für ein Jahr. Hat sich der Preis im gewählten Zeitraum geändert, wird das berücksichtigt, indem der Zeitraum in einzelne Abschnitte aufgeteilt wird. Hier im Beispiel ist das der Fall: Der Strompreis bewegte sich zwischen `0,2545 €/kWh` und `0,3244 €/kWh`. Insgesamt hat sich der Preis zweimal geändert, es gab also drei verschiedene Preise. Somit sind drei Zeitabschnitte zu bilden.
+Teil der Kosten ist die entgangene Einspeisevergütung (Opportunitätskosten), die beim Eigenverbrauch dadurch entstehen, wenn der erzeugte Strom nicht ins Netz eingespeist wird. Dieser Teil der Berechnung ist optional und kann in den Einstellungen auch deaktiviert werden.
+
+<img
+  src="{{ site.baseurl }}/assets/images/opportunitaetskosten.png"
+  alt="Opportunitätskosten"
+/>
 
-2. Für jeden Zeitabschnitt wird der Stromverbrauch in kWh aus den Messwerten ermittelt. Im Beispiel sind es aufsummiert `1.335 kWh`. Die Einzelverbräuche der Zeitabschnitte werden aus Gründen der Einfachheit nicht dargestellt. Gleiches gilt für den Eigenverbrauch, im Beispiel sind es `4.926 kWh`.
+## Die Berechnung im Detail
 
-3. Die Netzbezugskosten ergeben sich für jeden Zeitabschnitt durch Multiplikation von Stromverbrauch und Strompreis. Zum Schluss wird alles aufaddiert. Im Beispiel resultieren daraus `386 €`. Hinzu kommt die entgangene Einspeisevergütung, im Beispiel `418 €`. Die Gesamtkosten betragen also `804 €`. Diese Kosten sind entstanden, um die benötigten Verbraucher mit Strom zu versorgen.
+Die Berechnung erfolgt in mehreren Schritten:
 
-<h2>Power-Splitter</h2>
+1. Ermittlung der Strompreise, die für den ausgewählten Zeitraum gelten - hier also für ein Jahr. Hat sich der Preis im gewählten Zeitraum geändert, wird das berücksichtigt, indem der Zeitraum in einzelne Abschnitte aufgeteilt wird. Hier im Beispiel ist das der Fall: Der Strompreis bewegte sich zwischen `0,2545 €/kWh` und `0,3244 €/kWh`. Insgesamt hat sich der Preis zweimal geändert, es gab also drei verschiedene Preise. Somit sind drei Zeitabschnitte zu bilden.
 
-Mit dem [Power-Splitter](/features/#power-splitter) gibt es ein mächtiges Werkzeug, um die tatsächlichen Kosten der großen Verbraucher Haus, Wärmepumpe und E-Auto **separat** zu berechnen.
+2. Für jeden Zeitabschnitt wird der Netzbezug in kWh aus den Messwerten ermittelt. Im Beispiel sind es aufsummiert `1.335 kWh`. Analog wird der Eigenverbrauch ermittelt (aus der Differenz von Erzeugung und Einspeisung), im Beispiel sind es `4.926 kWh`.
 
-Beim Verbrauch entsteht üblicherweise ein Mix aus Eigenverbrauch (grüner Strom) und Netzbezug. Diese Aufteilung wird vom Power-Splitter für jeden der großen Verbraucher ermittelt und aufsummiert.
+3. Die Netzbezugskosten ergeben sich für jeden Zeitabschnitt durch Multiplikation von Stromverbrauch und Strompreis. Zum Schluss wird alles aufaddiert. Im Beispiel resultieren daraus `386 €`.
 
-:::note
+   Wenn die Berechnung der Opportunitätskosten aktiviert ist, geht es noch weiter:
 
-Die Berechnung erfolgt &dash; grob skizziert &dash; in etwa so:
+4. Hinzu kommt die entgangene Einspeisevergütung, also der Eigenverbrauch multipliziert mit der Einspeisevergütung. Im Beispiel sind das `418 €`.
 
-Im Minutentakt wird der insgesamt bezogene Netzstrom (in Watt) ermittelt. Dieser wird anteilig auf die im gleichen Zeitabschnitt aktiven Verbraucher verteilt. Dabei wird das E-Auto erstrangig behandelt, da man dieses meist bewusst lädt. Der verbliebene Rest (sofern vorhanden) wird dann anteilig auf Haus und Wärmepumpe verteilt.
+5. Die Gesamtkosten betragen also `804 €`. Diese Kosten sind entstanden, um die benötigten Verbraucher mit Strom zu versorgen.
 
-Insgesamt ist damit für jede Minute bekannt, welcher Verbraucher welchen Anteil am Netzbezug hat.
+## Mehr Details mit dem Power-Splitter
 
-:::
+Dargestellt wurden bislang die **Gesamtkosten**, die im gewählten Zeitraum entstanden sind (im Beispiel `804 €`). Wenn man wissen möchte, wie viel davon auf die einzelnen Verbraucher entfällt, z.B. das Haus, die Wärmepumpe oder das E-Auto, dann kommt der [Power-Splitter](/referenz/power-splitter) ins Spiel.
+
+Beim Verbrauch entsteht üblicherweise ein Mix aus Eigenverbrauch (grüner Strom) und Netzbezug. Diese Aufteilung wird vom Power-Splitter für jeden der großen Verbraucher ermittelt und aufsummiert.
 
 Aus dem Anteil werden dann die echten Stromkosten dieser Verbraucher ermittelt, die sich aus Netzbezug und entgangener Einspeisevergütung (optional) zusammensetzen. Hier ein Beispiel für das E-Auto in einem Jahr:
 
 <img
-  src="{{ site.baseurl }}/assets/images/power-splitter-car.png"
-  alt="Power-Splitter"
-  class="mx-auto w-full max-w-xs rounded-full border-8 border-indigo-300"
+src="{{ site.baseurl }}/assets/images/power-splitter-car.png"
+alt="Power-Splitter"
 />
 
-In diesem Beispiel hat das E-Auto etwa 2 MWh im Jahr über die Wallbox bezogen. 69% davon war grüner Strom, wurde also selbst über die PV-Anlage erzeugt. Der kleinere rote Teil des Balkens zeigt den Netzbezug an.
-
-Die Summe aus Netzbezug und entgangener Einspeisevergütung beträgt `314 €`, wobei die jeweils gültigen Strompreise berücksichtigt werden. So kennt man jetzt die Stromkosten für ein Jahr Autofahren.
+Hier hat das E-Auto etwa 2 MWh im Jahr über die Wallbox bezogen. 69% davon war grüner Strom, wurde also selbst über die PV-Anlage erzeugt. Der kleinere rote Teil des Balkens zeigt den Netzbezug an.
 
-:::caution
+Die Summe aus Netzbezug und entgangener Einspeisevergütung beträgt `314 €`, wobei die jeweils gültigen Strompreise berücksichtigt werden. So kennt man jetzt die Stromkosten, die das E-Auto über die Wallbox verursacht hat.
 
-Zu beachten ist bei diesem Beispiel, dass externe Ladungen (z.B. an öffentlichen Ladesäulen) hier nicht berücksichtigt werden, da es dafür keine Messwerte gibt. Zukünftige Versionen werden diese Lücke schließen, indem externe Beladungen manuell erfasst werden können.
+{: .important}
 
-:::
+Zu beachten ist bei diesem Beispiel, dass externe Ladungen (z.B. an öffentlichen Ladesäulen) hier nicht berücksichtigt werden, da es dafür keine Messwerte gibt. Es ist geplant, dass zukünftige Versionen von SOLECTRUS diese Lücke schließen werden, indem externe Beladungen manuell erfasst werden können.