SNLO – Spittank.net Ladeorganisation¶

Laden organisiert.

SNLO – Spittank.net Ladeorganisation ist eine lokale Webapp/PWA für nutzerbezogene Ladeübersichten und Kostenaufstellungen aus beliebig vielen EVCC-Instanzen. EVCC bleibt für Wallboxen, PV- und Batteriemessung, Fahrzeugerkennung, Lademodi und reale Sitzungskosten verantwortlich. SNLO ergänzt Nutzer, Fahrzeuge, Zahler, Tarife, Aufschläge, Statistiken und druckbare Übersichten.

Einstieg¶

Schnellstart: lokale Installation mit Docker Compose
Konfiguration: Umgebungsvariablen, EVCC, Tarife, Fahrzeuge und Betrieb
OpenID Connect: gruppengesteuerte Anmeldung für Nutzer und Administratoren
Forgejo, Pages und Registry: CI, Zensical-Dokumentation und Container-Releases

Kernfunktionen¶

Nutzer¶

Dashboard für Heute, Monat, Jahr und Gesamt
Energie, Stromkosten, Aufschläge, Solaranteil, Batterienutzung und Gesamtkosten
eigene laufende Ladesitzung mit Fahrzeug, Tarif, Leistung, Energie und Kosten
datensparsame Anzeige Belegt bei einer fremden aktiven Sitzung
Filter auf Fahrzeuge, für die der angemeldete Nutzer zahlender Nutzer ist
Sitzungslisten und druckbare Zeitraumsauswertungen
EVCC-Lademodus und EVCC-Fahrzeugzuordnung
optional direkte KEBA-P30-Freigabe über eine verschlüsselt hinterlegte RFID

Administration¶

beliebig viele EVCC-Instanzen anlegen, bearbeiten, testen, synchronisieren und löschen
interne Fahrzeuge mit EVCC-Fahrzeugen mehrerer Instanzen verknüpfen
mehrere berechtigte Nutzer je Fahrzeug sowie einen zeitabhängigen zahlenden Nutzer festlegen
benannte Tarife und Nutzer/Zeitraum/Tarif-Zuordnungen verwalten
historische Tarife nach Warnung ändern und betroffene Sitzungen neu berechnen
Druckansichten beliebiger Nutzer sowie administrative CSV-Auswertungen
OIDC-Gruppen für Nutzer und Administratoren
Audit-Protokoll

Abrechnungsmodell¶

Ein Tarif besteht aus vier optionalen Aufschlägen je Kilowattstunde:

Aufschlag	Berechnungsbasis
Allgemein	gesamte geladene Energie
Solar	EVCC-Solaranteil
Netzbezug	Sitzungsenergie abzüglich EVCC-Solaranteil
Batterie	positive Batterieentladung während des tatsächlichen Ladens, höchstens die Sitzungsenergie

Jede Komponente kann separat unter Aufschläge erscheinen oder in die sichtbaren Stromkosten eingerechnet werden. Nutzer sehen nie den unveränderten EVCC-Rohpreis als eigene Kennzahl. Einen Monatsbeitrag gibt es nicht.

Architektur¶

Browser / PWA ---- OIDC Identity Provider
      |
      v
FastAPI API -------- PostgreSQL
      |                  ^
      |                  |
      +---- EVCC-Steuerung
      +---- optionale KEBA-RFID-Befehle
                         |
Collector ---------------+
  |        |        |
EVCC A   EVCC B   EVCC n

Der Compose-Stack verwendet ein gemeinsames SNLO-Image für:

migrate: Alembic-Migrationen
api: FastAPI und PWA
worker: EVCC-Collector und Sitzungsimport

Die PostgreSQL-Datenbank bleibt ein separates Standardimage.

Lizenz¶

SNLO ist unter der GNU Affero General Public License, Version 3 (AGPL-3.0-only) veröffentlicht. Details und der vollständige Lizenztext sind unter Lizenz beschrieben.

Version¶

Diese Dokumentation gehört zu SNLO 0.5.12.