presseportale/docs
Kevin Adametz d548f4b235 Phase 9D: Tarif-Datenmodell, Cashier und hybride Rechnungskreise STR-/MAN-
Tarif-Datenmodell (Decision-Update):
- plans: Starter/Business/Pro/Agency mit Monats-/Jahrespreis (Jahres =
  10 x Monat), PM-Kontingent, Tageslimit, Stripe-IDs; idempotenter Seeder
- single_purchases: Einzel-PM, Extra-PM, Boost, PDF-Nachweis mit
  Status-Lifecycle und Stripe-Checkout-Referenzen
- laravel/cashier ^16.5 installiert (freigegeben); User ist Billable,
  Cashier-Migrationen published + ausgefuehrt; lokale invoices()-Relation
  ueberschreibt bewusst die Cashier-Methode

Hybride Rechnungskreise (Entscheidung 12.06.2026):
- invoice_number_sequences + InvoiceNumberGenerator: atomare fortlaufende
  Nummern pro Kreis (STR- fuer den neuen Stripe-Shop, MAN- fuer den
  manuellen Legacy-Kreis); Alt-Archiv legacy_invoices bleibt unveraendert
- ManualInvoiceService + billing:generate-manual-invoices (Scheduler
  taeglich 04:30): prueft aktive/grandfathered user_payment_options ohne
  Stripe-Subscription auf erreichtes Periodenende, friert die
  Rechnungsadresse als Snapshot ein, stellt die MAN-Rechnung aus
  (Zahlungsziel billing.manual_due_days) und schaltet die Periode weiter;
  Konditions-Overrides via legacy_conditions, sonst Netto-Preis +
  billing.vat_rate; nicht abrechenbare Faelle werden geloggt und
  beim naechsten Lauf erneut geprueft

Submit-Gate:
- User::hasActiveBooking() prueft jetzt echt (hinter
  billing.enforce_booking): Cashier-Abo, bezahlter Einzel-/Extra-PM-Kauf
  oder laufende Legacy-Vereinbarung (MAN-Kreis)

Suite: 468 passed, 4 skipped (17 neue Billing-Tests). Pint clean.
Offen fuer 9E: Stripe-Checkout/Webhooks, STR-Spiegelung, Slot-Logik auf
Plan-Kontingent, Migration der aktiven Legacy-Zahlungen in
user_payment_options.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 10:15:46 +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 9D: Tarif-Datenmodell, Cashier und hybride Rechnungskreise STR-/MAN- 2026-06-12 10:15:46 +00:00
Decision-Update Preisstruktur & Veröffentlichungs-Flow.md Doku: Status-Sync 11./12.06., Decision-Update Preisstruktur und Phase-9-Plan 2026-06-12 09:20:22 +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 9D: Tarif-Datenmodell, Cashier und hybride Rechnungskreise STR-/MAN- 2026-06-12 10:15:46 +00:00
README.md Doku: Status-Sync 11./12.06., Decision-Update Preisstruktur und Phase-9-Plan 2026-06-12 09:20:22 +00:00
STATUS-ABGLEICH-USER-PANEL.md Phase 9 Block 1: Gelb-Routing Direkt-Live, Slot-Verbrauch bei Veroeffentlichung, Submit-Gate 2026-06-12 09:47:06 +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).