Dokumentation
Spezifikation, Architekturentscheidungen und Datenlizenzen des Projekts
Dokumentation
Spezifikation und Architektur
Architekturübersicht
Dienste, Datenflüsse und Speicher — vom Abruf der Quellen bis zur Oberfläche.
ARCHITECTURE.md
Build-Spezifikation
Der verbindliche Vertrag: Datenbankschema, API-Verträge, CLI und Testumfang.
docs/BUILD_SPEC.md
Design-System
Palette, Typografie, Dichte und Komponentenvokabular der Oberfläche.
docs/DESIGN_SYSTEM.md
Umsetzungsplan
Reihenfolge der Ausbaustufen und was in jeder Stufe fertig sein muss.
IMPLEMENTATION_PLAN.md
Dokumentation
Daten und Modelle
Datenquellen
Jede externe Quelle mit Endpunkt, Aktualisierungstakt und Ausweichweg.
docs/data/sources.md
Energiemodell
Physikalisches Basismodell, Merkmale des ML-Modells und Bewertungsverfahren.
docs/ml/energy-model.md
Ladeplanung
Wie Ladestopps ausgewählt und begründet werden — ohne externen Solver.
docs/ml/charging-optimisation.md
Analytische Schicht (dbt)
Staging-, Intermediate- und Mart-Modelle samt verbindlicher Tests.
dbt/README.md
Prüfung der Datenquellen
Rechercheprotokoll: welche Quelle tatsächlich erreichbar ist und unter welchen Bedingungen.
docs/research/2026-09-14-data-source-verification.md
Dokumentation
Architekturentscheidungen
Jede ADR hält Kontext, Entscheidung und Konsequenzen fest — einschließlich der verworfenen Alternativen.
ADR-Verzeichnis
Übersicht aller Architekturentscheidungen mit Status.
docs/adr/README.md
Lizenz
Lizenzen und Namensnennung
Die Apache-2.0-Lizenz des Quellcodes gilt nicht für die eingelesenen Datensätze. Jede Quelle behält ihre eigenen Bedingungen; die folgenden Namensnennungen sind verpflichtend.
Datenlizenzen
Bedingungen jeder Quelle und die Trennung von Code- und Datenlizenz.
DATA_LICENSES.md
Quellcode-Lizenz
Apache 2.0 — gilt für den Code, nicht für die eingelesenen Datensätze.
LICENSE