M2 Umsetzung

2026-07-12 01:07:35 +02:00
parent 66bdd38d54
commit 174fff6f31
10 changed files with 430 additions and 35 deletions
@@ -0,0 +1,102 @@
+# M2 Technisches Fundament
+
+Stand: 2026-07-12
+
+M2 fuehrt die technischen Grundbausteine fuer den SaaS-Umbau ein, ohne das
+Legacy-Verhalten oder das bestehende Design zu veraendern.
+
+## Ziel
+
+- Versionierte Datenbankmigrationen statt loser Schema-Ausfuehrung.
+- Zentrales Bootstrap fuer Umgebung, Session und CSRF-Helper.
+- Bestehende Legacy-Seiten bleiben kompatibel.
+- Layout-Trennung wird vorbereitet, aber noch nicht in bestehende Seiten
+  hineingezogen.
+
+## Umgesetzte Bausteine
+
+### Bootstrap
+
+- `app/bootstrap.php` definiert zentrale Helfer:
+  - `app_env()`
+  - `app_is_dev()`
+  - `app_start_session()`
+  - `app_csrf_token()`
+  - `app_csrf_field()`
+  - `app_verify_csrf()`
+  - `app_require_csrf()`
+- `config.php` laedt den Bootstrap und startet die Session mit sicheren
+  Cookie-Optionen.
+- Sessions werden standardmaessig unter `var/sessions` abgelegt, weil die
+  lokale PHP-Umgebung keinen beschreibbaren Systempfad garantiert. `var/` ist
+  von Git ignoriert. Der Pfad kann ueber `APP_SESSION_PATH` ueberschrieben
+  werden.
+- CSRF ist bewusst noch nicht global erzwungen. Die vorhandenen POST-Seiten
+  werden spaeter einzeln umgestellt, damit keine Formulare oder Spezialflows
+  brechen.
+
+### Migrationen
+
+- `database/migrations/0001_legacy_mysql_baseline.sql` bildet die bisherige
+  MySQL-Dev-Baseline als erste versionierte Migration ab.
+- `scripts/dev-db.php` verwaltet `schema_migrations` und fuehrt neue
+  Migrationen idempotent aus.
+- `scripts/migrate.php` ist der direkte Runner fuer Migrationen.
+- `scripts/init-mysql-dev.php` nutzt ab jetzt ebenfalls die Migrationslogik.
+
+### Layout
+
+- `header.php` und `footer.php` bleiben vorerst Legacy-Wrapper.
+- Die spaetere Trennung in Public-Layout und App-Layout wird erst umgesetzt,
+  wenn die neue Route-/View-Struktur steht.
+- Die bestehende HTML5-UP-Struktur, Sidebar und Assets bleiben unveraendert.
+
+## Ausfuehrung
+
+Mit normaler PHP-CLI:
+
+```bash
+php scripts/migrate.php
+php scripts/init-mysql-dev.php
+php scripts/check-golden-master.php
+php scripts/http-smoke.php
+```
+
+In der aktuellen lokalen Umgebung:
+
+```bash
+LD_LIBRARY_PATH="$PWD/.local/php/usr/lib/x86_64-linux-gnu:$PWD/.local/php/usr/lib/x86_64-linux-gnu/sasl2" \
+  "$PWD/.local/php/usr/bin/php8.3" \
+  -c "$PWD/.local/php-dev.ini" \
+  scripts/migrate.php
+```
+
+Die Skripte erwarten die bekannten Dev-Umgebungsvariablen `DB_HOST`, `DB_NAME`,
+`DB_USER` und `DB_PASS`. `scripts/init-mysql-dev.php` braucht zusaetzlich
+`DEV_AUTH_EMAIL`.
+
+## Aktueller Pruefstatus
+
+- Migration `0001_legacy_mysql_baseline.sql` erfolgreich angewendet.
+- Zweiter Migrationslauf meldet: Datenbank ist aktuell.
+- PHP-Syntax fuer Bootstrap, Migrationen, Init-Skript und Config ist sauber.
+- Session-Start laeuft in der lokalen Dev-Umgebung ohne PHP-Warnings ueber
+  `var/sessions`.
+- Golden Master weiterhin gruen mit 104 Assertions.
+- HTTP-Smoke weiterhin gruen mit 14 sicheren Seiten.
+
+## Bewusste Grenzen
+
+- Keine Tenant-/User-/Rollen-Tabellen in M2. Diese gehoeren zu M3.
+- Keine globale CSRF-Erzwingung in M2. Die Absicherung der POST-Seiten erfolgt
+  schrittweise.
+- Kein Layout-Umbau in M2. Die visuelle Struktur bleibt stabil.
+- PDF-/Mail-/Jahresprozesse bleiben als M6-Themen offen.
+
+## Naechste Schritte
+
+1. POST-Seiten einzeln mit `app_csrf_field()` und `app_require_csrf()`
+   absichern.
+2. Eine duenne View-/Layout-Struktur vorbereiten, ohne Header/Footer-Markup
+   sofort zu verschieben.
+3. Danach M3 starten: Tenants, User, Registrierung, Login und Rollen.