Dokumentiere die Nachbesserung der Shop-Verwaltung mit Prüfung auf luf-test
Abnahmeprotokoll Etappe 1 um Befund, Änderungen, Klickfolge, Testkauf bis zum Download,
schmale Ansichten, Tastatur, offene Entscheidungen und Belege (23 Bilder) ergänzt.
Geprüfter Stand: 9701777 auf luf-test.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
No files matched your search
@@ -1,7 +1,53 @@
|
||||
# Abnahme Etappe 1: Testkauf vom Shop bis zum lizenzgeprüften Download
|
||||
|
||||
Stand: 21.11.2026. **Geprüfter Code-Stand:** lokaler Arbeitsbaum auf `develop` (HEAD `6c8bbee`) mit den Änderungen dieser Etappe, **nicht committet, nicht gepusht**. Geprüft wurde lokal mit einer eigenen SQLite-Demo-Datenbank und echtem Browser (Playwright, Chromium), Breiten 1440, 760 und 390 px. **Nicht auf `luf-test` geprüft:** Ein Push nach `develop` war nicht beauftragt, und der Verein für den Vereinskauf muss dort von Lars angelegt werden (siehe „Offene Punkte“). Der Auftrag erteilt keine Produktivfreigabe, und der Shop ist in Produktion abgeschaltet. Vorlage: [ux-abnahme-vorlage](../regeln/ux-abnahme-vorlage.md). Auftrag: „Entwicklungsauftrag für Etappe 1“ in [16_MVP_Slice](../../../architektur/16_MVP_Slice.md), Fälle aus der „Shop-Abnahme“ in [14_Szenarien_Matrix](../../../architektur/14_Szenarien_Matrix.md).
|
||||
Stand: 21.11.2026. **Geprüfter Code-Stand:** lokaler Arbeitsbaum auf `develop` (HEAD `6c8bbee`) mit den Änderungen dieser Etappe, **nicht committet, nicht gepusht**. Geprüft wurde lokal mit einer eigenen SQLite-Demo-Datenbank und echtem Browser (Playwright, Chromium), Breiten 1440, 760 und 390 px. **Stand dieses Abschnitts: lokal geprüft.** Die Nachbesserung auf `luf-test` steht im Abschnitt „Nachbesserung Shop-Verwaltung“ unten; der Vereinskauf ist dort weiterhin nicht geprüft, weil der Verein von Lars angelegt werden muss (siehe „Offene Punkte“). Der Auftrag erteilt keine Produktivfreigabe, und der Shop ist in Produktion abgeschaltet. Vorlage: [ux-abnahme-vorlage](../regeln/ux-abnahme-vorlage.md). Auftrag: „Entwicklungsauftrag für Etappe 1“ in [16_MVP_Slice](../../../architektur/16_MVP_Slice.md), Fälle aus der „Shop-Abnahme“ in [14_Szenarien_Matrix](../../../architektur/14_Szenarien_Matrix.md).
|
||||
|
||||
## Nachbesserung Shop-Verwaltung (Abnahmebefund von Lars, 21.11.2026)
|
||||
|
||||
**Geprüfter Commit:** `9701777` auf `develop`, ausgerollt auf `luf-test` (Branch `feature/shop-verwaltung-abnahme`, enthält `4e0760d`). Das Deployment ist an der neuen Oberfläche erkannt, nicht an einem Workflow-Status: Der Gitea-Lauf war ohne API-Token nicht einsehbar. Den Stand `9701777` belegt der Abschnitt „Name und Beschreibung“ am Begleitmaterial-Artikel. Geprüft wurde im echten Browser (Edge über Playwright) auf `luf-test`, Breiten 1440, 760 und 390 px. Verwaltung mit einem Katalogverwalter-Konto samt TOTP, Kauf mit dem regulären Mitgliederkonto von Lars.
|
||||
|
||||
**Befund und Reproduktion.** Anlegen mit einem Namen funktionierte, danach fehlte der Weg zum kaufbaren Angebot. Auf `luf-test` am Artikel „Tora“ (ohne Stand) nachgestellt: einzige sichtbare Aktion „Redaktion bearbeiten“ ([Bild 01](etappe-1/nachbesserung/01-vorher-artikel-ohne-einstieg.png)). Der Inhalt ließ sich nur über „Weitere Aktionen → Stand veröffentlichen“ festlegen. Der Dialog hieß „Wurzel“, die Liste war unsortiert, und das Pflichtfeld „Einordnung“ fragte, warum dies „derselbe Lizenzartikel und kein neues Produkt“ sei ([Bild 02](etappe-1/nachbesserung/02-vorher-dialog-wurzel.png)). Pakete und Angebote nannten in den Auswahllisten nur Kennungen, auch von Artikeln ohne Stand. Nirgends stand, was zur Veröffentlichung fehlt. Im Code zusätzlich gefunden: Ein Angebot ließ sich auf einen Artikel ohne Stand aktivieren, Käufer hätten nichts erhalten. Ein Angebot erscheint im Shop nur über eine Produktseite, also ein Programm mit Anzeigefreigabe. Auch das sagte die Oberfläche nicht.
|
||||
|
||||
**Änderungen** (alles im bestehenden Verwaltungsdesign, ein gemeinsamer Baustein statt je Objekt eine Kopie, Standard 14, Abschnitt 9):
|
||||
|
||||
- **„Bis zur Veröffentlichung“** auf Lizenzartikel, Paket und Angebot (`PublicationReadiness`, `verwaltung/voraussetzungen.blade.php`): „Nächster Schritt“, je Schritt Zustand als Text und Symbol (Erledigt, Offen, Empfohlen) und ein Knopf dorthin. Das Angebot prüft fünf Schritte: Position und Preis, Inhalt vorhanden, Kauf mit Preis, Produktseite zugeordnet, Produktseite öffentlich.
|
||||
- **Artikel:** „Inhalt festlegen“ als Hauptaktion im Kopf. Dialog „Freigegebener Inhalt“ (gruppiert nach Medien und Dokumente, Module und Programme) statt „Wurzel“, Einordnung beim ersten Stand vorbelegt, Knopf „Stand veröffentlichen“.
|
||||
- **Auswahllisten** nennen Name, Kennung und Stand. Artikel ohne Stand sind gekennzeichnet („noch ohne Stand, nicht verwendbar“). Produktseiten nennen, ob sie im Shop auffindbar sind. Paketfassungen nennen ihre Artikel.
|
||||
- **Absicherung:** Die Angebotsmaske lehnt Artikel ohne Stand ab, auch in Paketen, mit Erklärung und Weg zum Artikel. Das ist eine Oberflächenprüfung. `OfferService` ist unverändert (siehe Entscheidungen).
|
||||
- **Erfolgsmeldungen** nennen den nächsten Schritt oder bestätigen, dass die Option kaufbar und im Shop auffindbar ist.
|
||||
- **Namen im Shop:** Der Leistungsumfang zeigte die Kennung, obwohl die Redaktion den Namen aus dem Inhalt übernimmt. Er löst den Namen jetzt wie die Redaktion auf: eigener Name, Name des Inhalts, Arbeitstitel, zuletzt Kennung.
|
||||
- **Darstellungsfehler im Browser gefunden und behoben:** Die Symbole der Schritte waren riesig (fiel in den Tests nicht auf).
|
||||
|
||||
**Klickfolge auf luf-test** (alle Objekte entstanden in der regulären Verwaltung, vorhandene Inhalte und Konten dienten als Ausgangsdaten):
|
||||
|
||||
| Schritt | Ergebnis | Beleg |
|
||||
|---|---|---|
|
||||
| Artikel anlegen, „Inhalt festlegen“ | Artikel mit „Lara im Park“ (Film) und „Trainerunterlage Abstand“ (Text) als Stand 1. Meldung „Stand 1 ist veröffentlicht“ | Bilder [03](etappe-1/nachbesserung/03-artikel-ohne-stand-naechster-schritt.png), [04](etappe-1/nachbesserung/04-dialog-inhalt-festlegen.png), [05](etappe-1/nachbesserung/05-artikel-mit-stand.png) |
|
||||
| Angebot anlegen, „Fassung aktivieren“ | Option „Privatlizenz Film“, 12,00 €, Produktseite „Programm Abstand“. Fünf Schritte „Erledigt“. Meldung nennt: im Shop auffindbar | [06](etappe-1/nachbesserung/06-angebot-leer-naechster-schritt.png), [07](etappe-1/nachbesserung/07-angebot-maske.png), [08](etappe-1/nachbesserung/08-angebot-aktiv-voraussetzungen-erfuellt.png) |
|
||||
| Paket anlegen, Artikel wählen, veröffentlichen | Paketfassung 1 aus zwei Artikeln. „Jeder enthaltene Artikel hat einen Inhalt“ erledigt | [09](etappe-1/nachbesserung/09-paket-leer-naechster-schritt.png), [10](etappe-1/nachbesserung/10-paket-maske-artikelauswahl.png), [11](etappe-1/nachbesserung/11-paket-veroeffentlicht.png) |
|
||||
| Eigenes Angebot für das Paket | „Paketlizenz Film und Begleitmaterial“, 19,00 €, eigene Produktseite „UX-Prüfung, nur Test“ | [13](etappe-1/nachbesserung/13-paketangebot-aktiv.png) |
|
||||
| Rechteprofil anlegen | Es gab nur ein Profil, und es erlaubte nur „ansehen“. Neues Profil „ansehen und laden“ in der Verwaltung angelegt, beide Angebote darauf umgestellt (Fassung 2, später Fassung 3) | [12](etappe-1/nachbesserung/12-rechteprofil-ansehen-und-laden.png) |
|
||||
| Auffindbarkeit im Shop | `/shop` zeigt beide Produkte („ab 12,00 €“, „ab 19,00 €“), die Suche findet „Abstand“. Die Produktseiten zeigen Preis, Eignung, Laufzeit und je Artikel die Rechte. Das Paket führt beide enthaltenen Artikel auf | [14](etappe-1/nachbesserung/14-shop-beide-angebote.png), [15](etappe-1/nachbesserung/15-produktseite-paketangebot.png) |
|
||||
| Testkauf mit regulärem Mitgliederkonto | Warenkorb vor der Anmeldung gefüllt und nach der Anmeldung erhalten, Summe 31,00 €, Kasse, „Bestellung anlegen“, „Testzahlung bestätigen“: Bestellung 6 bezahlt | [16](etappe-1/nachbesserung/16-warenkorb.png), [17](etappe-1/nachbesserung/17-kasse.png), [18](etappe-1/nachbesserung/18-bestellung-bezahlt.png) |
|
||||
| Download | Die Programmseite in der Bibliothek zeigt „Laden“. Der Film kam als Datei (73.027.826 Bytes) | [19](etappe-1/nachbesserung/19-bibliothek-programm-mit-laden.png) |
|
||||
|
||||
Zwei frühere Testkäufe (Bestellungen 4 und 5) liefen mit Artikeln aus Einzelmedien und zeigten die Grenze unten („Laden“ fehlt). Die Artikel für den Download-Nachweis (Programm und Modul) und das zweite Paket entstanden danach auf demselben Weg. Die Angebote wurden dafür auf Fassung 3 umgestellt, was zugleich den Ablauf „Option ändern“ belegt.
|
||||
|
||||
**Schmale Ansicht und Tastatur.** Kein horizontaler Überlauf bei 760 und 390 px (Artikel, Paket, Angebot, Maske, Shop, Produktseiten): Bilder [20](etappe-1/nachbesserung/20-schmal-390-angebot.png), [21](etappe-1/nachbesserung/21-schmal-760-artikel.png), [22](etappe-1/nachbesserung/22-schmal-390-produktseite.png). Tab erreicht „Inhalt festlegen“, „Redaktion bearbeiten“ und „Angebote öffnen“ mit sichtbarem Fokusrahmen (3 px solid). Enter am Schritt öffnet den Dialog, Esc schließt ihn ([Bild 23](etappe-1/nachbesserung/23-tastatur-fokus-schritt.png)).
|
||||
|
||||
**Tests.** `php artisan test`: **439 grün**, Pint bestanden. Neu: `ShopVerwaltungAbnahmeTest` (11 Tests). Ein Bestandstest geändert und im Commit begründet: `OrganizationPurchaseTest::test_membership_boundaries_decide_the_club_access` setzte die Uhrzeit erst nach der Bestellung auf 12:00 UTC und scheiterte dadurch nach 12:00 UTC. Die feste Uhrzeit gilt jetzt vorher, die Assertions bleiben.
|
||||
|
||||
**Zur Entscheidung durch Lars (nicht umgesetzt):**
|
||||
|
||||
1. **Domänenregel statt Oberflächenprüfung.** `OfferService::activate` prüft den Stand des Artikels weiterhin nicht. Wer das Angebot nicht über die Maske anlegt, kann einen Artikel ohne Inhalt verkaufen. Eine Prüfung im Domänenmodell ändert eine Verkaufsregel und braucht deine Freigabe.
|
||||
2. **Einzelmedium-Artikel haben in der Bibliothek kein „Laden“.** Die Artikelseite bietet bei Film nur „Vollbild“, bei Text nur „Ansehen“. „Laden“ gibt es nur auf Programm- und Modulseiten. Ein Artikel aus einem einzelnen Film lässt sich also kaufen, aber nicht laden, auch wenn das Rechteprofil „laden“ erlaubt. Für den Verkaufsstart sollte das entschieden werden.
|
||||
3. **Rechteprofil und Download.** Die Angebotsmaske sagt nicht, dass ein Profil ohne „laden“ später keinen Download ergibt. Ein Hinweis dazu wäre eine kleine Erweiterung.
|
||||
4. **Produktseite für Pakete.** Der Shop kennt nur Programme als Produktseite. Das Paketangebot hing deshalb an einem vorhandenen Programm („UX-Prüfung, nur Test“). Eine eigene Produktseite für Pakete ist eine Fachfrage.
|
||||
5. **Begleitmaterial als Text.** Das Begleitmaterial ist ein Text und bietet nur „Ansehen“. Einen PDF-Download habe ich daher nicht geprüft.
|
||||
|
||||
**Nicht geprüft:** Zoom, Bildschirmleser, echte E-Mail-Bestätigung (das Mitgliederkonto bestand), Vereinskauf, Erstattung und Abbruch der Testzahlung im Browser, Parallelität, PDF-Download. Verwaltung und Shop wurden nicht mit Hochkontrast geprüft.
|
||||
|
||||
**Aufräumen auf luf-test:** Die Testdaten „Abnahme E1 …“ (vier Lizenzartikel, zwei Pakete, zwei Angebote, ein Rechteprofil, drei Bestellungen für das Mitgliederkonto von Lars) können nach der Abnahme archiviert werden.
|
||||
## Aufgabe und Maßstab
|
||||
|
||||
- **Nutzeraufgabe:** Eine Einzelperson bestellt zwei Angebote in einer Bestellung. Ein Verein erwirbt eine Mehrfachlizenz. Beide laden danach Film und Begleitmaterial aus der Bibliothek. Der Betreiber bearbeitet und aktiviert eine Lizenzoption im Angebotsarbeitsplatz.
|
||||
|
||||
|
After Width: | Height: | Size: 102 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 162 KiB |
|
After Width: | Height: | Size: 137 KiB |
|
After Width: | Height: | Size: 177 KiB |
|
After Width: | Height: | Size: 184 KiB |
|
After Width: | Height: | Size: 110 KiB |
|
After Width: | Height: | Size: 235 KiB |
|
After Width: | Height: | Size: 136 KiB |
|
After Width: | Height: | Size: 111 KiB |
|
After Width: | Height: | Size: 145 KiB |
|
After Width: | Height: | Size: 86 KiB |
|
After Width: | Height: | Size: 285 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 138 KiB |
|
After Width: | Height: | Size: 101 KiB |
|
After Width: | Height: | Size: 112 KiB |
|
After Width: | Height: | Size: 345 KiB |
|
After Width: | Height: | Size: 1.1 MiB |
|
After Width: | Height: | Size: 209 KiB |
|
After Width: | Height: | Size: 161 KiB |
|
After Width: | Height: | Size: 115 KiB |
|
After Width: | Height: | Size: 119 KiB |