Belege die Verkaufsstart-Etappe auf luf-test im Abnahmeprotokoll
Abschnitt im Abnahmeprotokoll mit geprüftem Commit, Workflow-Status, Klickfolge,
Browserbelegen, nicht geprüften Punkten (Verein, PDF, Stripe-Wiederholung, Mail)
und offenen Freigabepunkten. Nur Dokumentation; der Anwendungscode entspricht 69a22de.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
No files matched your search
@@ -2,6 +2,45 @@ # 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. **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).
|
||||
|
||||
## Verkaufsstart-Etappe: Rabattcodes, Nutzerkreis, Pflichtangaben (22.11.2026, auf `luf-test`)
|
||||
|
||||
**Geprüfter Stand:** Commit `69a22de` auf `develop` (Merge ohne eigene Merge-Commit: schneller Vorlauf des Branches `feature/shop-rabatt-lizenz`). **Workflow-Status** (aus der öffentlich lesbaren Gitea-Statusabfrage des Commits, `commits/<sha>/status`): `CI Feature / test` **success**, `Deploy Test / test` **success**, `Deploy Test / deploy` **success**. Ein früherer Lauf des Feature-Branches (`42e0a6b`) schlug fehl, weil `RegistrationTest` einen Faker-Namen mit Apostroph (`O'Hara`) erwartete, den das HTML maskiert; der Name ist jetzt fest (Commit `f0287ee`, Assertion unverändert, Lauf danach grün). Der Produktivzweig `main` wurde nicht berührt, es gibt keine Produktivfreigabe.
|
||||
|
||||
**Tests lokal:** `php artisan test` **675 grün** (Ausgangsstand 604), `pint --test app tests config database routes` bestanden. Neu: `DiscountCalculatorTest`, `DiscountCodeTest`, `LicenceScopeTest`, `BundleProductPageTest`, `SalesStartTest`, `ShopSalesAdminTest`, `LibraryDownloadTest`. Bestandstests geändert und im Commit begründet (Assertionen nicht abgeschwächt): `CartTest`, `MultiLineCheckoutTest`, `OrganizationPurchaseTest` (Schaltfläche „Zahlungspflichtig bestellen“, „Zu zahlen“, Rollenliste, Kasse sendet Zustimmungen), zwei Vergleichsangebote in `CartTest` (Nutzerkreis gehört zum identischen Umfang), `BestandslisteTest` (eine Fassung ohne Nutzerkreis verlangt dessen Angabe beim Bearbeiten), `RegistrationTest` (fester Name). Die Migration lief auf der PostgreSQL von `luf-test` ohne Fehler (`/up` 200, alle neuen Verwaltungsseiten antworten).
|
||||
|
||||
**Geprüft wurde im echten Browser** (Chromium über Playwright mit einem Ablaufskript, das nicht im Repository liegt, weil es Zugangsdaten aus der Umgebung liest; Breiten 1440, 1280 und 390 px). Alle Objekte entstanden über die reguläre Verwaltung (Testkonten über „Benutzer anlegen“ mit Zustimmung von Lars; zwei Konten „Abnahme Konto A“ und „B“, Passwörter nicht im Repository). Stripe lief im Testmodus (Testkarte 4242 …); die Freischaltung kam jeweils durch die signierte Meldung an den Webhook.
|
||||
|
||||
| Fall | Klickfolge und Ergebnis | Belege |
|
||||
|---|---|---|
|
||||
| Vorbereitung | Angebot „Einzelartikel Film“: „Geänderte Fassung aktivieren“, Nutzerkreis „Einzellizenz“ (Fassung 5). Angebot „Paket Film und Begleitmaterial“: Nutzerkreis „Mehrfachlizenz“, 5 Trainer, Produktseite „Eigene Paketseite“ (Fassung 4). Fünf Codes über „Code anlegen“: `ALLG10` (10 %, Warenkorb, allgemein), `NURFILM` (20 %, nur Angebot Einzelartikel Film, allgemein), `ZERTX` (20 %, Warenkorb, freigeschaltete Konten), `ZERTY` (15 %, Warenkorb, freigeschaltete Konten), `ALTCODE` (gültig bis 20.11.2026) | [03](etappe-1/verkaufsstart/03-angebotsmaske-nutzerkreis.jpg), [04](etappe-1/verkaufsstart/04-angebotsmaske-paket-mehrfach.jpg), [05](etappe-1/verkaufsstart/05-code-maske.jpg), [06](etappe-1/verkaufsstart/06-code-seite-zertx.jpg), [07](etappe-1/verkaufsstart/07-code-abgelaufen.jpg) |
|
||||
| 1 Allgemeiner und artikelspezifischer Code | Konto A legt Einzelartikel (Produktseite „Programm Abstand“) und Paket (eigene Paketseite) in den Warenkorb, Kasse. `ALLG10`: Zwischensumme 31,00 €, Rabatt −3,10 €, **Zu zahlen 27,90 €** (beide Positionen). `NURFILM`: Rabatt −2,40 € **nur** auf dem Einzelartikel, **Zu zahlen 28,60 €** | [08](etappe-1/verkaufsstart/08-warenkorb-gemischt.jpg), [09](etappe-1/verkaufsstart/09-kasse-allgemeiner-code.jpg), [10](etappe-1/verkaufsstart/10-kasse-artikelcode-nur-film.jpg) |
|
||||
| 2 Freigabe je Konto und Code | Konto B mit `ZERTX` ohne Freigabe: Erklärung „nicht freigeschaltet“, voller Preis. Konto A vor der Freigabe: gleich. Betreiber schaltet A für `ZERTX` frei (Dialog mit Grundlage): −6,20 € auf 31,00 €. A mit `ZERTY` (nur Freigabe für X): abgelehnt. Nach eigener Freigabe für Y: 15 % (−4,65 €). `ALTCODE`: „abgelaufen (gültig bis 20.11.2026)“. Freigabe für `ZERTX` entzogen: die Kasse erklärt es, „Zahlungspflichtig bestellen“ ist gesperrt, der Code lässt sich nicht erneut einlösen, der Verlauf zeigt die entzogene Freigabe mit Grund. Nach neuer Freigabe wieder einlösbar | [11](etappe-1/verkaufsstart/11-konto-b-ohne-freigabe.jpg), [12](etappe-1/verkaufsstart/12-freigabe-maske.jpg), [13](etappe-1/verkaufsstart/13-konto-a-code-x.jpg), [14](etappe-1/verkaufsstart/14-konto-a-code-y-ohne-freigabe.jpg), [15](etappe-1/verkaufsstart/15-abgelaufener-code.jpg), [16](etappe-1/verkaufsstart/16-nach-entzug-uebersicht.jpg), [17](etappe-1/verkaufsstart/17-freigabe-verlauf.jpg) |
|
||||
| 2 Wiederholte Einlösung | A bestellt zuerst das Paket mit `ZERTX` (Bestellung 11), später den Einzelartikel mit `ZERTX` (Bestellung 12, 9,60 €), beide bezahlt | [29](etappe-1/verkaufsstart/29-zweite-bestellung-bezahlt.jpg) |
|
||||
| 3 Betrag, Abbruch | Bestellübersicht, gespeicherte Bestellung 11, **Stripe-Kasse** („Listenpreis 19,00 €, Rabatt 3,80 €“, Gesamtsumme) und Bestellverwaltung zeigen alle **15,20 €**. Rücksprung aus der Stripe-Kasse: Bestellung bleibt „Offen“, die Bibliothek zeigt nichts. Danach Zahlung mit Testkarte: Bestellung „Bezahlt“ | [18](etappe-1/verkaufsstart/18-bestelluebersicht-paket.jpg), [19](etappe-1/verkaufsstart/19-bestellung-offen.jpg), Stripe-Kasse (Bild nicht abgelegt, sie zeigt Konto- und Händlerangaben), [21](etappe-1/verkaufsstart/21-nach-abbruch.jpg), [22](etappe-1/verkaufsstart/22-bibliothek-ohne-lizenz.jpg), [23](etappe-1/verkaufsstart/23-bestellung-bezahlt.jpg), [24](etappe-1/verkaufsstart/24-bestellverwaltung.jpg) |
|
||||
| 4 Einzel- und Mehrfachlizenz | Die Produktseite des Programms zeigt „Einzellizenz · 1 Trainer“, die Paketseite „Mehrfachlizenz · bis zu 5 Trainer“ und den Paketumfang („Programm Abstand“, „Modul Hilfe“). Kasse, Bestellung, Bestellverwaltung und die Lizenzdetailseite („Meine Lizenzen“ → Details) zeigen den vereinbarten Nutzerkreis, für die Bestellung des Pakets „Mehrfachlizenz · bis zu 5 Trainer“, für die des Einzelartikels „Einzellizenz · 1 Trainer“. Konto B erhält mit dem signierten Downloadlink von A **403** und hat nichts in der Bibliothek | [01](etappe-1/verkaufsstart/01-produktseite-einzellizenz.jpg), [02](etappe-1/verkaufsstart/02-paketseite-mehrfachlizenz.jpg), [25](etappe-1/verkaufsstart/25-bestellung-verwaltung.jpg), [27](etappe-1/verkaufsstart/27-lizenzdetail-mehrfach.jpg), [27b](etappe-1/verkaufsstart/27b-lizenzdetail-einzel.jpg), [28](etappe-1/verkaufsstart/28-konto-b-bibliothek.jpg) |
|
||||
| 5 Kauf bis Download, Rückabwicklung | Produktseite → Kasse mit Zustimmungen → Stripe → Bestellung „Bezahlt“ → Bibliothek → Programmseite mit „Laden“ am Film: **Download `Lara im Park.mp4`, 73.027.826 Bytes, `attachment`**. Rückabwicklung: Betreiber „Bestellung erstatten“ (Begründung) → Stripe-Rückzahlung (Testmodus) angenommen → Bestellung „Erstattet“, Zahlung „erstattet“; danach fehlt das „Laden“ aus der erstatteten Bestellung, „Film ansehen“ aus der zweiten Bestellung bleibt | [26](etappe-1/verkaufsstart/26-programmseite-mit-laden.jpg), [30](etappe-1/verkaufsstart/30-erstattung-maske.jpg), [31](etappe-1/verkaufsstart/31-nach-erstattung.jpg), [32](etappe-1/verkaufsstart/32-programm-nach-erstattung.jpg), [33](etappe-1/verkaufsstart/33-bestellung-erstattet.jpg) |
|
||||
|
||||
**Verwaltungsstandard:** Rabattcodes (Liste, Seite), Bestellungen (Liste, Seite), Verkaufsstart und Angebotsmaske bei 1440 und 390 px ohne horizontalen Überlauf gemessen (Bilder [34](etappe-1/verkaufsstart/34-verkaufsstart.jpg) bis [40](etappe-1/verkaufsstart/40-verkaufsstart-schmal.jpg)); die Kasse ebenso bei 1280 und 390 px ([37](etappe-1/verkaufsstart/37-kasse-schmal.jpg)). Tastatur: Der Freigabe-Dialog öffnet mit Enter und schließt mit Esc ohne Wirkung ([42](etappe-1/verkaufsstart/42-freigabe-dialog-tastatur.jpg)). In der Kasse führt Tab von „Code einlösen“ über Impressum, Datenschutz, beide Zustimmungen zu „Zahlungspflichtig bestellen“, Fokusrahmen 3 px solid ([41](etappe-1/verkaufsstart/41-kasse-tastatur-fokus.jpg)).
|
||||
|
||||
**Nicht auf luf-test geprüft (mit Grund):**
|
||||
|
||||
1. **Vereinskauf** (Verein als Lizenzinhaber, nur das bestellende Konto lädt): Es gibt auf `luf-test` keinen Verein und kein Konto mit Bestellberechtigung; dafür gibt es keine Oberfläche. Lars führt den `ShopDemoSeeder` aus (Zusage in dieser Sitzung), danach ist der Fall zu wiederholen. Belegt ist er durch Tests (`LicenceScopeTest`, `OrganizationPurchaseTest`, `SalesStartTest`) und nur für Konto B als fremdes Konto auf luf-test (403).
|
||||
2. **Begleit-PDF:** Auf `luf-test` gibt es kein PDF-Medium; die Begleitunterlage „Trainerunterlage Abstand“ ist ein Text mit „Ansehen“. Der PDF-Download ist durch `LibraryDownloadTest` belegt (Dateiname, `attachment`, `%PDF`, Ansehen und Laden getrennt, ohne Recht kein Download). Dafür ist ein PDF-Medium auf der Instanz anzulegen.
|
||||
3. **Wiederholte Zahlungsbestätigung auf der Instanz:** Das Signaturgeheimnis liegt nur auf dem Server; Lars wollte das Ereignis nicht aus dem Stripe-Dashboard erneut senden. Belegt durch `StripeSandboxTest` und `SalesStartTest` (genau ein Erwerb je Position bei Wiederholung).
|
||||
4. **E-Mail zur Vertragsbestätigung:** Der Mail-Treiber der Instanz ist `log`. Inhalt belegt durch `SalesStartTest::test_the_confirmation_mail_repeats_scope_discount_and_consent`.
|
||||
5. **Position mit 0 €-Rest bei Stripe** (ein Code, der eine Position vollständig deckt, während der Warenkorb über 0,50 € bleibt): nicht ausprobiert; ob Stripe eine Position mit Betrag 0 annimmt, ist offen.
|
||||
6. Zoom, Bildschirmleser, Hochkontrast, Parallelität mehrerer Bestätigungen, unabhängiger Sicherheitstest (16, 6.3), Rechnungsweg auf der Instanz (kein Verein), Widerrufserklärung im Browser.
|
||||
|
||||
**Befunde bei der Abnahme.** (a) Die Meldung bei fehlender Freigabe nennt den Codenamen nicht (nur „für dein Konto nicht freigeschaltet“); das ist gewollt (kein Hinweis, ob ein Code existiert, ist nicht nötig, der Käufer hat ihn eingegeben). (b) Ein Fehler im Prüfskript (suchte den Codenamen im Meldungstext) wurde am Bild geprüft und im Skript behoben. (c) Auf der Stripe-Kasse erscheint „Umsatzsteuer (19 % inklusive)“, weil auf der Instanz ein Steuersatz hinterlegt ist; das ist Sandbox-Konfiguration und keine Aussage über den Steuerstatus (OPEN-06). (d) Käufe vor dieser Etappe haben keinen Nutzerkreis und zählen deshalb nicht als „Bereits erworben“ gegen neu aktivierte Fassungen mit Nutzerkreis. (e) Nach dem Test bleiben auf `luf-test` stehen: Konten „Abnahme Konto A“ und „B“ (abnahme-a und abnahme-b@example.test), fünf Codes mit Freigaben, die Bestellungen 11 (erstattet) und 12 (bezahlt) sowie die geänderten Angebotsfassungen (Einzelartikel Film Fassung 5, Paket Fassung 4 mit eigener Paketseite). Sie können archiviert beziehungsweise gelöscht werden.
|
||||
|
||||
**Offene Freigabepunkte (Lars bzw. Rechtsberatung):**
|
||||
|
||||
- **Fehlende Rechtstexte** (die Verwaltungsseite „Verkauf → Verkaufsstart“ zeigt den Stand): AGB (`/agb`), Lizenzbedingungen je Zweck (`/lizenzbedingungen`), Widerrufsbelehrung mit Muster-Widerrufsformular (`/widerruf`); Impressum und Datenschutz bestehen als Seiten, ihr Inhalt ist rechtlich zu prüfen. Der **Wortlaut der beiden Zustimmungen** im Checkout (Fassung `2026-11-24-entwurf`) ist ein Entwurf.
|
||||
- **Steuer und Belege (OPEN-06, E-11):** Steuerstatus, Steuerausweis, Rechnungsvorlage mit Pflichtangaben, Rechnungsnummernkreis (der Rechnungsweg bestätigt nur den Zahlungseingang; die Rechnung erstellt der Betreiber außerhalb der Anwendung), Preis-/Steuerhinweis (`SHOP_PRICE_NOTE`).
|
||||
- **Live-Zahlung:** Live-Konto bei Stripe mit Webhook und Schlüssel (`refunds: write`), dann `SHOP_LIVE_RELEASE=true` in `/etc/luf/prod.env` (siehe `docs/betrieb/DEPLOYMENT.md`). Aufbewahrungsfristen (E-16), Auftragsverarbeitung mit Stripe.
|
||||
- **Fachentscheidungen zur Bestätigung** (ADR-47): Rundung je Position gegen Rundung auf der Summe, Verteilung eines Festbetrags und Erstattung bei Einzelrückgabe (Rechenbeispiele dort), Mindestzahlbetrag 0,50 €, Freigabe mit optionalem Ende, Rollen für Rabattcodes und Bestellungen (Katalogverwalter und Kundenbetreuung), Widerruf als Erklärung mit Prüfung durch den Betreiber.
|
||||
- Die früheren offenen Punkte 1 bis 5 der Nachbesserung unten sind erledigt: Domänenregel für Angebote ohne Inhalt (`OfferService::activate`), Download bei reiner Download-Lizenz am Einzelartikel, eigene Produktseite für Pakete. Offen bleibt der Hinweis in der Angebotsmaske, dass ein Rechteprofil ohne „laden“ keinen Download ergibt.
|
||||
|
||||
## Nachbesserung Shop-Verwaltung (Abnahmebefund von Lars, 21.11.2026)
|
||||
|
||||
**Geprüfte Commits** (alle auf `develop`, ausgerollt auf `luf-test`, enthalten `4e0760d`). Die Klickfolge lief über mehrere Stände, weil unterwegs Fehler im Browser auffielen:
|
||||
|
||||
|
After Width: | Height: | Size: 91 KiB |
|
After Width: | Height: | Size: 95 KiB |
|
After Width: | Height: | Size: 146 KiB |
|
After Width: | Height: | Size: 174 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 80 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 162 KiB |
|
After Width: | Height: | Size: 164 KiB |
|
After Width: | Height: | Size: 158 KiB |
|
After Width: | Height: | Size: 62 KiB |
|
After Width: | Height: | Size: 162 KiB |
|
After Width: | Height: | Size: 172 KiB |
|
After Width: | Height: | Size: 162 KiB |
|
After Width: | Height: | Size: 111 KiB |
|
After Width: | Height: | Size: 84 KiB |
|
After Width: | Height: | Size: 154 KiB |
|
After Width: | Height: | Size: 70 KiB |
|
After Width: | Height: | Size: 72 KiB |
|
After Width: | Height: | Size: 65 KiB |
|
After Width: | Height: | Size: 63 KiB |
|
After Width: | Height: | Size: 114 KiB |
|
After Width: | Height: | Size: 98 KiB |
|
After Width: | Height: | Size: 110 KiB |
|
After Width: | Height: | Size: 119 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 65 KiB |
|
After Width: | Height: | Size: 61 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 109 KiB |
|
After Width: | Height: | Size: 59 KiB |
|
After Width: | Height: | Size: 131 KiB |
|
After Width: | Height: | Size: 82 KiB |
|
After Width: | Height: | Size: 114 KiB |
|
After Width: | Height: | Size: 112 KiB |
|
After Width: | Height: | Size: 79 KiB |
|
After Width: | Height: | Size: 91 KiB |
|
After Width: | Height: | Size: 139 KiB |
|
After Width: | Height: | Size: 147 KiB |
|
After Width: | Height: | Size: 58 KiB |