M0 Check DB Testdata

2026-07-12 00:12:02 +02:00
parent 2e6d79e896
commit d9e70ce353
19 changed files with 886 additions and 28 deletions
@@ -0,0 +1,146 @@
+# 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:
+
+```bash
+php scripts/seed-golden-master.php
+php scripts/check-golden-master.php
+```
+
+In der aktuellen lokalen Umgebung mit entpacktem PHP:
+
+```bash
+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.