cannamanage/docs/sprint-12/cannamanage-sprint12-testplan.md

Sprint 12 Test Plan: "Golden Test Standard"

Datum: 18.06.2026
Autor: Patrick Plate / Lumen (Planner)
Status: v1
Basis: cannamanage-sprint12-plan.md

---

Testübersicht

ID	Beschreibung	Typ	Seite	Status
T-01	Document upload end-to-end	E2E	documents	⬜
T-02	Document download triggers file save	E2E	documents	⬜
T-03	Document delete with confirmation	E2E	documents	⬜
T-04	Document upload validation (missing fields)	E2E	documents	⬜
T-05	Document category badges have distinct colors	Visual	documents	⬜
T-06	Document table column widths don't stretch	Visual	documents	⬜
T-07	Board: create position via dialog	E2E	board	⬜
T-08	Board: elect member via dialog	E2E	board	⬜
T-09	Board: remove member with confirmation	E2E	board	⬜
T-10	All pages: no buttons without onClick handlers	Automated	all	⬜
T-11	Documents page loads from API (React Query)	Integration	documents	⬜
T-12	Board page loads from API (React Query)	Integration	board	⬜

Status: ⬜ Offen | ✅ Bestanden | ❌ Fehlgeschlagen | ⏭️ Übersprungen

---

Testfälle

T-01: Document upload end-to-end

Typ: E2E (Playwright)
Datei: e2e/sprint12-documents.spec.ts

Vorbedingungen:

• Mock-Backend läuft oder Frontend-Mock-API aktiv
• Nutzer ist eingeloggt als Admin

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	Upload-Button klicken → Dialog öffnet sich	Dialog mit Titel, Kategorie, Datei-Upload sichtbar
b	Alle Felder ausfüllen + Datei wählen → "Hochladen" klicken	Loading-Spinner erscheint, dann Success-Toast, Dialog schließt
c	Nach Upload: Dokumentenliste wird refresht	Neues Dokument erscheint in der Liste

Nachbedingungen:

• Upload-Mutation wurde mit korrekten Parametern aufgerufen
• QueryClient hat ["documents"] invalidiert

---

T-02: Document download triggers file save

Typ: E2E (Playwright)
Datei: e2e/sprint12-documents.spec.ts

Vorbedingungen:

• Mindestens 1 Dokument in der Liste sichtbar

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	Download-Icon-Button für ein Dokument klicken	Datei-Download wird ausgelöst (Playwright download event)
b	Backend nicht erreichbar → Download klicken	Error-Toast "Download fehlgeschlagen"

Nachbedingungen:

• downloadDocument(id) wurde aufgerufen
• Blob wurde zu download-link konvertiert

---

T-03: Document delete with confirmation

Typ: E2E (Playwright)
Datei: e2e/sprint12-documents.spec.ts

Vorbedingungen:

• Mindestens 1 Dokument in der Liste

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	Delete-Icon klicken	Bestätigungs-Dialog erscheint ("Dokument wirklich löschen?")
b	"Abbrechen" im Dialog	Dialog schließt, Dokument bleibt
c	"Löschen" im Dialog bestätigen	Loading-State, dann Success-Toast, Dokument verschwindet aus Liste

Nachbedingungen:

• deleteDocument(id, clubId) wurde aufgerufen
• Liste wurde refresht (query invalidation)

---

T-04: Document upload validation (missing fields)

Typ: E2E (Playwright)
Datei: e2e/sprint12-documents.spec.ts

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	Upload-Dialog öffnen → sofort "Hochladen" klicken (kein Titel, keine Datei)	Error-Toast "Bitte alle Pflichtfelder ausfüllen", kein API-Call
b	Titel eingeben aber keine Datei → "Hochladen"	Fehler-Hinweis
c	Datei wählen aber kein Titel → "Hochladen"	Fehler-Hinweis

---

T-05: Document category badges have distinct colors

Typ: Visual (Screenshot-Vergleich oder manuell)
Datei: e2e/sprint12-documents.spec.ts (Screenshot)

Szenarien:

#	Kategorie	Erwartete Farbe	Icon vorhanden
a	SATZUNG	Blau (bg-blue-*)	✅ BookOpen
b	PROTOKOLL	Lila (bg-purple-*)	✅ FileText
c	VERTRAG	Amber (bg-amber-*)	✅ FileSignature
d	VERSICHERUNG	Cyan (bg-cyan-*)	✅ Shield
e	GENEHMIGUNG	Grün (bg-green-*)	✅ CheckCircle
f	SONSTIGES	Grau (bg-gray-*)	✅ File

Prüfmethode: Screenshot machen, visuell prüfen dass alle 6 Kategorien klar unterscheidbar sind.

---

T-06: Document table column widths don't stretch

Typ: Visual
Datei: e2e/sprint12-documents.spec.ts (Screenshot)

Szenarien:

#	Viewport	Erwartetes Verhalten
a	Desktop (1280px)	Name-Spalte max 40% breit, truncated bei langen Titeln
b	Tablet (768px)	Table responsive, keine horizontale Scrollbar
c	Mobile (375px)	Graceful wrapping oder collapsed view

---

T-07: Board — create position via dialog

Typ: E2E (Playwright)
Datei: e2e/sprint12-board.spec.ts

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	"Position hinzufügen" → Dialog öffnet	Formular mit Titel, Beschreibung, Reihenfolge
b	Titel "Beisitzer" + Beschreibung + Reihenfolge 6 → Speichern	Success-Toast, Dialog schließt, Position erscheint in Liste
c	Leerer Titel → Speichern	Kein API-Call, Validierung greift

---

T-08: Board — elect member via dialog

Typ: E2E (Playwright)
Datei: e2e/sprint12-board.spec.ts

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	"Mitglied wählen" → Dialog öffnet	Formular mit Position-Select, Member-Select, Datum-Felder
b	Position + Mitglied + Wahldatum + Amtsbeginn ausfüllen → Bestätigen	Success-Toast, Dialog schließt, neues Board-Member in Karten
c	Keine Position gewählt → Bestätigen	Kein API-Call, Validierung

---

T-09: Board — remove member with confirmation

Typ: E2E (Playwright)
Datei: e2e/sprint12-board.spec.ts

Szenarien:

#	Eingabe	Erwartetes Ergebnis
a	UserMinus-Icon auf Board-Member-Card klicken	Bestätigungs-Dialog "Wirklich absetzen?"
b	Bestätigen	Success-Toast, Member-Card verschwindet
c	Abbrechen	Dialog schließt, keine Änderung

---

T-10: All pages — no buttons without onClick handlers

Typ: Automated (Static analysis / Playwright audit)
Datei: e2e/sprint12-button-audit.spec.ts

Ansatz: Playwright-Test der jede Dashboard-Seite navigiert und prüft:

const buttons = await page.locator('button').all()
for (const btn of buttons) {
  // Verify button is either:
  // 1. Inside a <Link> (navigation button)
  // 2. Has an onClick or is type="submit" in a form
  // 3. Is a dialog trigger (data-state attribute)
  const isDisabled = await btn.getAttribute('disabled')
  if (isDisabled) continue // disabled buttons are OK
  
  // Click and verify something happens (no silent no-op)
}

Seiten zu prüfen:

• /documents
• /board
• /members
• /distributions
• /stock
• /grow
• /reports
• /calendar
• /forum
• /info-board
• /finance
• /assemblies
• /compliance
• /audit-log
• /settings/staff

---

T-11: Documents page loads from API (React Query)

Typ: Integration
Datei: e2e/sprint12-documents.spec.ts

Szenarien:

#	Bedingung	Erwartetes Ergebnis
a	Backend erreichbar, Dokumente vorhanden	Dokumente aus API angezeigt (nicht Mock)
b	Backend nicht erreichbar	Mock-Fallback-Daten angezeigt (keine Fehlerseite)
c	Kategorie-Filter gewählt	Query-Key enthält Kategorie, neue Daten geladen

---

T-12: Board page loads from API (React Query)

Typ: Integration
Datei: e2e/sprint12-board.spec.ts

Szenarien:

#	Bedingung	Erwartetes Ergebnis
a	Backend erreichbar	Board-Mitglieder + Positionen aus API
b	Backend nicht erreichbar	Mock-Fallback angezeigt

---

Testdaten

Documents

• Mock-Dokumente sind bereits in documents/page.tsx definiert (5 Dokumente, verschiedene Kategorien)
• Für Upload-Test: beliebige PDF-Datei < 5MB
• Für Download-Test: Mock-Backend muss Blob zurückgeben

Board

• Mock-Board-Mitglieder sind bereits in board/page.tsx definiert (5 Positionen, 5 Mitglieder)
• Für Election-Test: Member-IDs aus Mock-Daten verwenden

---

Testabdeckung

Komponente	E2E	Integration	Visual	Gesamt
Documents (upload)	2	1	0	3
Documents (download)	1	0	0	1
Documents (delete)	1	0	0	1
Documents (UX)	0	0	2	2
Board (create pos)	1	1	0	2
Board (elect)	1	0	0	1
Board (remove)	1	0	0	1
All pages audit	1	0	0	1
Summe	8	2	2	12

---

Playwright Test File Structure

e2e/
├── sprint12-documents.spec.ts    # T-01 through T-06, T-11
├── sprint12-board.spec.ts        # T-07 through T-09, T-12
└── sprint12-button-audit.spec.ts # T-10

Ausführung

cd cannamanage-frontend
npx playwright test e2e/sprint12-*.spec.ts