presseportale/docs
Kevin Adametz 38fab64e10 Phase 9E (Backbone): Stripe-Produkt-Sync und Webhook-Verarbeitung mit STR-Spiegelung
- billing:sync-stripe-plans: legt die Tarife als Netto-Produkte/Preise
  (tax_behavior exclusive, EUR) in Stripe an und pflegt die IDs zurueck
  nach plans; idempotent, --dry-run. Gegen Stripe Test-Mode ausgefuehrt —
  alle 4 Tiers verknuepft.
- ProcessStripeWebhook (Listener auf Cashier WebhookReceived):
  - invoice.payment_succeeded -> Spiegelung in den lokalen STR-Kreis
    (fortlaufende Nummer via InvoiceNumberGenerator, Adress-Snapshot
    bevorzugt aus dem Stripe-Payload inkl. lokaler USt-ID, Status paid,
    idempotent gegen doppelte Zustellung)
  - checkout.session.completed -> markiert den referenzierten
    single_purchases-Datensatz als bezahlt (Metadata single_purchase_id)
- CASHIER_CURRENCY=eur (+ Locale de_DE); Cashier-Webhook-Route aktiv
- Doku: Billing-Referenz §7 + Phase-9-Plan (9E-Backbone) aktualisiert

Offen fuer 9E-Rest: Checkout-Flows (Abo + Einmalkauf), Webhook-Endpoint
im Stripe-Dashboard + STRIPE_WEBHOOK_SECRET, Slot-Logik auf
Plan-Kontingent (fachliche Frage: Grandfathered = unbegrenzt?).

Tests: StripeWebhookProcessingTest (7, inkl. Event-Wiring).
Suite: 497 passed, 4 skipped. Pint clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 11:07:09 +00:00
..
konzept Doku: Status-Sync 11./12.06., Decision-Update Preisstruktur und Phase-9-Plan 2026-06-12 09:20:22 +00:00
user-admin Phase 9E (Backbone): Stripe-Produkt-Sync und Webhook-Verarbeitung mit STR-Spiegelung 2026-06-12 11:07:09 +00:00
Decision-Update Preisstruktur & Veröffentlichungs-Flow.md USt-Behandlung: Netto-Preise, VatResolver und Steuer-Ausweis im MAN-Kreis 2026-06-12 10:58:43 +00:00
Echte öffentliche Unterseiten.md 29-05-2026 Optimierungen Fixes am Code 2026-05-29 12:42:05 +00:00
KI-UND-ENTWICKLER-WORKFLOW.md 29-05-2026 Optimierungen Fixes am Code 2026-05-29 12:42:05 +00:00
PHASE-8-USER-PANEL-PLAN.md Doku: Status-Sync 11./12.06., Decision-Update Preisstruktur und Phase-9-Plan 2026-06-12 09:20:22 +00:00
PHASE-9-FLOW-UND-TARIFE-PLAN.md Phase 9E (Backbone): Stripe-Produkt-Sync und Webhook-Verarbeitung mit STR-Spiegelung 2026-06-12 11:07:09 +00:00
README.md Doku: zentrale Billing-Referenz und Status-Sync Phase 9D 2026-06-12 11:02:45 +00:00
STATUS-ABGLEICH-USER-PANEL.md Doku: zentrale Billing-Referenz und Status-Sync Phase 9D 2026-06-12 11:02:45 +00:00

docs/ — Konzept- und Status-Dokumente

Stand: 11.06.2026 — Phase 8 (User-Panel-Konsolidierung) und die KI-Prüf-Pipeline (Klassifikation + Content-Score, Phasen 05) sind abgeschlossen. Nächster großer Block: Zahlung/Tarife + Veröffentlichungs-Flow laut Decision-Update.

Diese README ist der schnellste Einstieg in den docs/-Ordner. Sie verlinkt die zentralen Dokumente und sortiert sie nach „Was ist der aktuelle Stand?" vs. „Was ist konzeptueller Zielzustand?".

Schneller Einstieg

Frage Doku
Was ist im Code, was ist Konzept, was fehlt? STATUS-ABGLEICH-USER-PANEL.md
Was gilt für Preise, Kontingente und den Veröffentlichungs-Flow zum Launch? Decision-Update Preisstruktur & Veröffentlichungs-Flow.md
Wie wird das umgesetzt (aktueller Plan)? PHASE-9-FLOW-UND-TARIFE-PLAN.md
Wie funktioniert die KI-Prüfung (Klassifikation, Score, Audit)? user-admin/Entwicklungsplan KI-Pruefung und Veroeffentlichung.md
Was ist pro Phase erledigt, was offen? user-admin/checkliste-user-backend.md
Welche Hub-Flux-Phasen sind durch? ../dev/frontend/hub-flux/PROGRESS.md

Aufbau

Top-Level — Status & Entscheidungen

user-admin/ — User-/Admin-Backend

Konzept und Status-Dokumentation für das User- und Admin-Backend.

konzept/ — Strategie & Marke

Strategische Konzepte und Updates. Sie beschreiben Themen, die teilweise oder noch gar nicht gebaut sind. Jedes Update hat oben einen IST-Stand-Hinweis.

Lesehilfe

In den überarbeiteten Dokumenten finden sich folgende Markierungen:

Marker Bedeutung
IST-Stand JJJJ-MM-TT Kompakte Notiz oben am Abschnitt, was im Code tatsächlich umgesetzt ist.
Phase 1 / Phase 7 / Phase 8 Abgeschlossene Roadmap-Blöcke: Grund-User-Backend, PM-Form-Refactor, User-Panel-Konsolidierung.
KI-Pipeline (Phasen 05) Klassifikation, Routing, Content-Score — abgeschlossen 11.06.2026, siehe Entwicklungsplan.
Hub-Flux Visuelle Migrationsphase des User Backends, gepflegt in dev/frontend/hub-flux/.
Phase 2 / Phase 3 Später — Magic-Link-Flow, Re-Check/Redigieren, Trust-Score, Notice-and-Action, Statistik.
Launch-Block (offen) Zahlung/Tarife, Submit-Gate, Slot-Verbrauch bei Veröffentlichung — siehe Decision-Update.

Wie pflegen wir die Doku?

  • Wenn sich der Code so weit ändert, dass ein Konzept-Abschnitt nicht mehr stimmt, kommt eine IST-Stand-Box an den Abschnitt, statt den Konzept-Text zu löschen. So bleibt die ursprüngliche Zielvorstellung lesbar.
  • Entscheidungen, die frühere Konzept-Festlegungen ersetzen, kommen als eigenes Decision-Update auf Top-Level; die überschriebenen Abschnitte bekommen einen Verweis darauf.
  • Jeder Phasen-Abschluss aktualisiert
    • user-admin/checkliste-user-backend.md (Erledigt-Block),
    • STATUS-ABGLEICH-USER-PANEL.md (Abgleich),
    • dev/frontend/hub-flux/PROGRESS.md (Tagebuch),
    • und ggf. die Detail-Doku in dev/frontend/hub-flux/.
  • Neue große Themen bekommen ein eigenes Plan-Dokument auf docs/-Top-Level (z. B. PHASE-8-USER-PANEL-PLAN.md).