Sichere Rechnungs- und Livepfad ab und dokumentiere die Entscheidungen zum Verkaufsstart
CI Feature / test (push) Successful in 2m52s

Eine Bestellung auf Rechnung lässt sich auch mit dem Stripe-Treiber nicht per Karte
bezahlen; der Betreiber, der den Zahlungseingang bestätigt, wird an der Zahlung
festgehalten; im Livebetrieb ist der alte Einzelkauf ohne Pflichtangaben gesperrt und
placeFromCart verlangt die Zustimmungen. ADR-47, Domänenmodell, Lizenzlogik,
Kernabläufe, Szenarien, Fachanforderungen und DEPLOYMENT nachgeführt.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-22 20:11:24 +01:00
1 parent f0287eec2f
commit 69a22deb1f
16 files changed
+139 -15

No files matched your search

+21 -1
View File
@@ -61,7 +61,7 @@ ## Stripe-Sandbox (nur Test, Etappe 1)
**Zurück zum Testweg:** `PAYMENT_DRIVER=test` setzen und neu ausrollen. Offene Stripe-Bestellungen bleiben offen.
**Grenzen:** Erstattungen laufen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox.
**Grenzen (Stand Etappe 1; die Erstattung ist seit dem Verkaufsstart-Stand vorbereitet, siehe „Verkaufsstart: Freigabe und Betrieb“):** Erstattungen liefen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox.
## Trennung Test und Prod (beide auf llm-node)
| | Test | Prod |
@@ -142,3 +142,23 @@ ## Annahmen und offene Punkte
- **Queue:** Datenbank-Queue (`QUEUE_CONNECTION=database`), kein Redis. Reicht für den Start. Der Worker erlaubt einem Auftrag bis zu einer Stunde (`--timeout=3600`). Das App-Image enthält `ffmpeg`. Die Queue leitet daraus Vorschaubilder und, wenn die Datei lesbar ist, drei HLS-Qualitätsstufen nach `derived/` ab. Fehlt die Ableitung, bleibt die gespeicherte Datei über den bisherigen berechtigten Abruf lesbar. Der Web-Prozess schreibt diese Ableitungen nicht.
- **Gate vor Prod:** Merge-Schutz ist eine Gitea-Einstellung und gehört nicht in die Workflows.
- **Umzug Test auf den Pi:** Werte oben in `deploy-test.yml` ändern (Label `ubuntu-latest`, Guard auf `raspberrypi5`/`aarch64`, Pfade, Port). Das Dockerfile baut auch für ARM64. Vorher Speicherlage auf dem Pi klären.
## Verkaufsstart: Freigabe und Betrieb (Stand 24.11.2026, vorbereitet, nicht freigegeben)
Die Produktivfreigabe liegt bei Lars. Der Code enthält sie nicht; er erlaubt sie nur, wenn **alle** Bedingungen erfüllt sind (`App\Domain\Commerce\Shop::live()`):
| Bedingung | Wo gesetzt |
|---|---|
| `SHOP_LIVE_RELEASE=true` | `/etc/luf/prod.env` (Standard: aus; nie im Repository) |
| `PAYMENT_DRIVER=stripe` | `/etc/luf/prod.env` |
| `STRIPE_SECRET=sk_live_…` (Live-Schlüssel; in Produktion sind Testschlüssel nie live, außerhalb der Produktion sind Live-Schlüssel verboten) | `/etc/luf/prod.env` |
| `STRIPE_WEBHOOK_SECRET` des Live-Endpunkts, Adresse `https://lara-und-felix.de/stripe/webhook` (Ereignisse mindestens `checkout.session.completed`, `checkout.session.expired`, `checkout.session.async_payment_succeeded`, `checkout.session.async_payment_failed`) | `/etc/luf/prod.env`, Stripe-Dashboard |
| Veröffentlichte CMS-Seiten `/agb`, `/lizenzbedingungen`, `/widerruf`, `/impressum`, `/datenschutz` | Webpräsenz (Redaktion, Text von der Rechtsberatung) |
Weitere Einstellungen: `SHOP_INVOICE` (Standard an: Kauf auf Rechnung für Organisationen), `SHOP_PRICE_NOTE` (Preis- und Steuerhinweis im Warenkorb, Standard „Alle Preise in Euro.“), `STRIPE_TAX_RATE_ID` (im Preis enthaltener Steuersatz; Steuerstatus offen, OPEN-06). Die Verwaltungsseite **Verkauf → Verkaufsstart** zeigt den Zustand ohne Schlüssel.
- **Erstattung bei Stripe:** `Checkout::refund` ruft vor dem Entzug der Rechte `POST /v1/refunds` (Vollbetrag, Idempotenzschlüssel `luf-refund-<Bestellung>-<Zahlung>`) auf; schlägt das fehl, bleibt die Bestellung unverändert. Dafür muss der API-Schlüssel das Recht „Refunds: write“ haben (bei eingeschränktem Schlüssel `rk_…` prüfen). Die Zahlungsabsicht (`payment_intent`) wird aus der signierten Meldung gespeichert, sonst bei Stripe abgefragt.
- **Rechnungsweg:** Vereine bestellen „auf Rechnung“; der Betreiber erstellt die Rechnung manuell und bestätigt den Zahlungseingang unter **Verkauf → Bestellungen**.
- **Migration** `2026_11_24_100000_add_discounts_licence_scope_and_sales_start`: rein ergänzend (neue Tabellen `discount_codes`, `discount_code_targets`, `discount_code_releases`; neue Spalten an `offers`, `offer_versions`, `orders`, `order_lines`, `payments`). Nichts wird gelöscht oder umbenannt.
- **Rollback:** setzt nur den Code zurück. Der frühere Code kennt Rabatt und Rechnungsweg nicht; vorher offene Bestellungen mit Rabatt oder Zahlungsweg „Rechnung“ stornieren oder abwickeln.
- **Was vor der Freigabe fehlt (Lars bzw. Rechtsberatung):** finale Texte (AGB, Lizenzbedingungen je Zweck, Widerrufsbelehrung samt Muster-Widerrufsformular, Impressum, Datenschutzerklärung), Prüfung des Wortlauts der Zustimmungen im Checkout (Entwurf `2026-11-24-entwurf`), Steuerstatus und Belegangaben (OPEN-06, E-11: Rechnungsvorlage mit Pflichtangaben, Rechnungsnummernkreis, Steuerausweis), Live-Stripe-Konto mit Webhook, Aufbewahrungsfristen (E-16), Auftragsverarbeitung mit Stripe, ein gesondert beauftragter Sicherheitstest (16, Abschnitt 6.3).