diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..083123f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,65 @@
+# Changelog
+
+Alle notable Änderungen an diesem Projekt werden in dieser Datei dokumentiert.
+Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
+
+## [Unreleased]
+
+### Hinzugefügt
+- `.gitignore` für Betriebssystem-Dateien, Editor-Cache und temporäre Dateien
+- `CHANGELOG.md` zur Dokumentation des Projektverlaufs
+- Git-Repository auf `zuhause.thebille.net:3000` (Gitea) unter `topsith/haus-steuerung`
+- `post-commit`-Hook für automatischen Push nach jedem Commit
+
+## [1.0.0] - 2026-08-06
+
+### Hinzugefügt
+- **V2 (AWP-basiert):** Webbasierte Haussteuerung über AWP-Webserver auf SPS (192.168.0.90)
+  - `indexV2.htm` — Hauptseite mit Iframes
+  - `form.css` — zentrales CSS (Cards, Tables, Buttons, Icon-Buttons)
+  - `lichtV2.htm` — Lichtsteuerung (14 Räume + WLED)
+  - `heizungV2.htm` — Heizungssteuerung (9 Räume mit IST/SOLL min/max)
+  - `steckdosenV2.htm` — Steckdosensteuerung (8 normale + 4 Funksteckdosen)
+  - `rolladen.htm` — Rolladensteuerung (alle Räume + Urlaub-Modus)
+  - `stromzaehler.htm` — Stromzähler mit Canvas-basiertem Leistungs-Chart
+  - `Script/tth_script.js` — Icon-Funktionen (leuchtet, heizt, strom, urlaub)
+  - `images/` — Icons und Bilder
+  - `*_state.html` — SPS-gefüllte Statusdateien
+
+- **V3 (Single-Page, neu):** Parallel zu V2, unberührt
+  - `indexV3.htm` — Produktivseite mit SPS-Web-API-Anbindung (`/api/jsonpc`)
+  - `formV3.css` — CSS für V3 (Grid, Karten, responsive Stromzähler-Bereich)
+  - `Script/tth_v3_api.js` — JavaScript für V3 (Login, Batch-Read, Write-on-Click)
+  - `indexV3_preview.htm` — reine Optik-Vorschau ohne SPS (Dummy-Daten)
+
+- **V4 (aktuell in Entwicklung):**
+  - `indexV4.htm` — aktuelle Hauptseite
+  - `formV4.css` — CSS für V4
+  - `Script/tth_v4.js` — JavaScript für V4
+
+- **Projektdokumentation:** `PROJECT.md` mit vollständiger Dateistruktur, AWP-Variablen und Architektur-Dokumentation
+
+### Architektur V3
+- Keine Iframes, keine AWP-Formulare
+- Kommunikation mit S7-1500 über integrierte Web-API (`/api/jsonrpc`)
+- Lesen per `PlcProgram.Read` (Batch), Schreiben per `PlcProgram.Write`
+- Anmeldung über `Api.Login` mit Token (Benutzer `111`)
+- Status wird zyklisch gelesen und in `lastValues` gepuffert
+- Schreibaktionen erfolgen direkt beim Klick auf Buttons/Inputs
+
+### Charts V3
+- Tacho (`v3_gauge`): Canvas, 180°-Skala, -8000 bis +8000 W
+- Power-Chart (`v3_power_chart`): Letzte 5 Minuten Leistung
+- Daily-Chart (`v3_daily_chart`): Balken für letzte 8 Tage
+
+### Bekannte Einschränkungen
+- Login-Daten (`user: '111'`, `password: '1q2w3e$R'`) im Klartext in `tth_v3_api.js`
+- Heizungs-Validierung nur clientseitig (`min < max`)
+- Keine Rückmeldung, ob Schreibvorgänge in der SPS wirksam wurden
+
+## [0.1.0] - Vor Git-Initialisierung
+
+### Hinzugefügt
+- Erste Version der Web-basierten Haussteuerung (V2)
+- SPS-Anbindung über AWP-Webserver
+- Statische HTML/CSS/JS-Dateien für alle Steuerungsbereiche