kaffeekasse-saas/docs/m1-reconstructed-golden-master.md

M1 Rekonstruierter Golden Master

Stand: 2026-07-11

Da kein alter MS-SQL-Datenbankstand verfuegbar ist, wird M1 als rekonstruierter Golden Master aufgebaut. Die Referenz entsteht aus Legacy-Code, Screenshots und kontrollierten Testdaten in der MySQL-Dev-Datenbank.

Ziel

Die wichtigsten fachlichen Regeln werden mit kleinen, nachvollziehbaren Testfaellen festgeschrieben. Diese Tests dienen spaeter als Sicherheitsnetz fuer die SaaS-Umstrukturierung.

Testdaten-Gruppen

Teilnehmer

• Aktives normales Mitglied.
• Aktiver Admin.
• Inaktives Mitglied.
• Mitglied mit PayPal-Namen.
• Mitglied ohne Buchungen.

Buchungen

• Einzahlung mit positivem Betrag.
• Mehrere Einzahlungen an unterschiedlichen Tagen.
• Strichbuchung mit einem Strich.
• Strichbuchung mit zwei Strichen.
• Sammelerfassung fuer mehrere Teilnehmer.
• Web-Strich-Eintrag mit Eintragsart = 2.

Salden

• Positiver Kontostand.
• Negativer Kontostand.
• Nullsaldo.
• Jahreswerte fuer aktuelles Jahr.
• Altdaten aus Vorjahr, die nicht in Jahreswerte fallen.

CSV-Import

• Treffer ueber Name.
• Treffer ueber paypalname.
• Dublette gleicher Teilnehmer, Betrag und Datum.
• Unbekannter Name.
• Negativer oder leerer Betrag.

Hinweise

• Aktiver Hinweis.
• Abgelaufener Hinweis.
• Neuer Hinweis ueber Admin-Formular.

Erwartete Referenzwerte

Fuer jeden Testfall sollen erwartete Werte dokumentiert werden:

• Summe Einzahlungen.
• Summe Kosten.
• Summe Striche.
• Aktueller Stand.
• Jahresstriche.
• Jahreseinzahlungen.
• Jahresausgaben.
• Sichtbarkeit in Listen und Filtern.

Umsetzungsvorschlag

1. database/mysql-dev-schema.sql um stabile Seed-Daten erweitern oder separates Seed-Skript anlegen. Erledigt mit scripts/seed-golden-master.php.
2. scripts/init-mysql-dev.php so erweitern, dass es die Testdaten idempotent anlegt. Entschieden: Golden-Master-Daten bleiben in einem separaten Skript, damit normale Dev-Daten nicht zwangsweise ueberschrieben werden.
3. Ein erstes Vergleichsskript scripts/check-golden-master.php erstellen. Erledigt.
4. Die wichtigsten Seiten per HTTP abrufen und auf erwartete Texte/Werte pruefen.
5. Danach M2 starten: technisches Fundament fuer SaaS-Struktur.

Skripte

• scripts/dev-db.php: gemeinsame DB-Verbindung fuer Dev-Skripte.
• scripts/golden-master-data.php: definierte Testdaten und erwartete Werte.
• scripts/seed-golden-master.php: legt Golden-Master-Testdaten idempotent an.
• scripts/check-golden-master.php: prueft Salden, Jahreswerte, Rollen, Listenfilter, CSV-Lookup und Hinweise.

Ausfuehrung

Mit normal installierter PHP-CLI:

php scripts/seed-golden-master.php
php scripts/check-golden-master.php

In der aktuellen lokalen Umgebung mit entpacktem PHP:

LD_LIBRARY_PATH="$PWD/.local/php/usr/lib/x86_64-linux-gnu" \
  "$PWD/.local/php/usr/bin/php8.3" \
  -c "$PWD/.local/php-dev.ini" \
  scripts/seed-golden-master.php

LD_LIBRARY_PATH="$PWD/.local/php/usr/lib/x86_64-linux-gnu" \
  "$PWD/.local/php/usr/bin/php8.3" \
  -c "$PWD/.local/php-dev.ini" \
  scripts/check-golden-master.php

Die Skripte erwarten die bekannten Dev-Umgebungsvariablen DB_HOST, DB_NAME, DB_USER und DB_PASS.

Abgedeckte Testfaelle

Testfall	Fixture
Admin mit Buchung	gm-admin@test.local
Positiver Saldo mit Vorjahresdaten	gm-positive@test.local
Negativer Saldo	gm-negative@test.local
Nullsaldo	gm-zero@test.local
Inaktives Mitglied	gm-inactive@test.local
PayPal-Name fuer CSV-Lookup	gm-paypal@test.local
Mitglied ohne Buchungen	gm-empty@test.local
Vieltrinker fuer Vorderseite	gm-heavy@test.local
Aktiver Hinweis	[GM] Aktiver Hinweis fuer Golden-Master-Test
Abgelaufener Hinweis	[GM] Abgelaufener Hinweis fuer Golden-Master-Test

Akzeptanzkriterien

• Testdaten sind reproduzierbar.
• Tests koennen mehrfach laufen, ohne Duplikate zu erzeugen.
• Salden und Jahreswerte sind automatisch pruefbar.
• CSV-Importfaelle sind fachlich abgedeckt.
• Die wichtigsten UI-Seiten liefern HTTP 200 ohne PHP-Warnings.

Aktueller Pruefstatus

Stand 2026-07-11:

• scripts/seed-golden-master.php erfolgreich gegen die MySQL-Dev-Datenbank ausgefuehrt.
• scripts/check-golden-master.php erfolgreich ausgefuehrt.
• Zweiter Seed+Check-Lauf erfolgreich, Idempotenz bestaetigt.
• Ergebnis: 104 Assertions bestanden.