M4 Ledger-Migration fuer Legacy-Buchungen starten

- ledger_entries als tenant-sichere Buchungstabelle ergaenzen
- Legacy-Einzahlungen und Kaffeeverbrauch idempotent spiegeln
- M4-Paritaetscheck und Datenmigrationsdoku ergaenzen

docs/saas-umstrukturierungsplan.md

@@ -283,8 +283,8 @@ Uebersicht:
 | M0 | Baseline | Bestand, Sicherheit und Designreferenz sind dokumentiert |
 | M1 | Golden Master | Legacy-Ergebnisse sind als Vergleichsbasis eingefroren; HTTP-Smoke prueft sichere Seiten |
 | M2 | Technisches Fundament | Abgeschlossen: Migrationen, Bootstrap, Session, CSRF-Helper und Legacy-Schreibseitenschutz stehen |
-| M3 | SaaS-Basis | Tenants, User, Registrierung, Login, Rollen, Mail-Links und zentrale Mandantenauswahl funktionieren |
-| M4 | Datenmigration | Legacy-Daten sind tenant-sicher im Zielmodell abgebildet |
+| M3 | SaaS-Basis | Abgeschlossen: Tenants, User, Registrierung, Login, Rollen, Mail-Links und zentrale Mandantenauswahl funktionieren |
+| M4 | Datenmigration | Gestartet: Ledger-Tabelle, Legacy-Backfill und Paritaetscheck sind umgesetzt |
 | M5 | App-Kern | Dashboard, Striche, Einzahlungen, Mitglieder und Liste laufen |
 | M6 | Betriebsflows | Import, Export, Mail und Jahresprozesse sind auditierbar |
 | M7 | Landingpage | Erste werbliche Seite ist oeffentlich nutzbar; spaetere Ausbaustufen folgen |
@@ -434,6 +434,7 @@ Ergebnis:
 - Rollen und Tenant-Kontext sind serverseitig verfuegbar.
 - Reset- und Verifikationslinks koennen im Dev-Modus geloggt und produktiv ueber
   einen konfigurierten Mail-Transport versendet werden.
+- Status: abgeschlossen fuer den M3-Scope.
 
 Abhaengigkeiten:
 
@@ -446,18 +447,23 @@ Bestehende Kaffeelisten-Daten tenant-sicher uebernehmen.
 
 Schritte:
 
-- Initialen Tenant fuer den bisherigen Bestand anlegen.
-- `kl_Mitarbeiter` nach `participants` migrieren.
-- `admin`-Informationen in `tenant_memberships` oder Admin-Rollen ueberfuehren.
-- `kl_config` nach `tenant_settings` migrieren.
-- `kl_Einzahlungen` und `kl_Kaffeeverbrauch` nach `ledger_entries` migrieren.
-- Legacy-IDs speichern.
-- Salden gegen Golden-Master vergleichen.
+- Initialen Tenant fuer den bisherigen Bestand anlegen: erledigt in M3.
+- `kl_Mitarbeiter` nach `participants` migrieren: erledigt in M3.
+- `admin`-Informationen in `tenant_memberships` oder Admin-Rollen ueberfuehren:
+  erledigt in M3.
+- `kl_config` nach `tenant_settings` migrieren: erledigt in M3.
+- `ledger_entries` als tenant-sichere Buchungstabelle anlegen: erledigt.
+- `kl_Einzahlungen` und `kl_Kaffeeverbrauch` additiv nach `ledger_entries`
+  spiegeln: erster Backfill erledigt.
+- Legacy-IDs speichern: erledigt ueber `legacy_table` und `legacy_id`.
+- Salden gegen Golden-Master vergleichen: Kontrollskript erledigt.
 
 Ergebnis:
 
-- Bestehender Datenbestand ist im neuen Modell abgebildet.
-- Saldenparitaet ist nachweisbar.
+- Bestehender Datenbestand kann im neuen Modell abgebildet werden.
+- Saldenparitaet ist ueber `scripts/check-m4-ledger-migration.php`
+  nachweisbar.
+- Dokumentation: `docs/m4-data-migration.md`.
 
 Abhaengigkeiten: