Doku: zentrale Billing-Referenz und Status-Sync Phase 9D

- Neues Dokument docs/user-admin/Billing-und-Rechnungskreise.md:
  hybride Rechnungskreise (STR-/MAN-/Archiv), Tarif-Datenmodell,
  MAN-Faelligkeitslauf, USt-Regeln, Befehle/Scheduler, Konfiguration
  (billing.php + Cashier-ENV) und offene Punkte
- README-Index + STATUS-ABGLEICH (Finanzen-Sektion) aktualisiert
- PROGRESS-Eintrag Phase 9D (Datenmodell, Rechnungskreise,
  Grandfather-Migration, USt)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-06-12 11:02:45 +00:00
parent 894a9436b0
commit 62e6b7e70f
4 changed files with 189 additions and 2 deletions

View file

@ -5,6 +5,44 @@
---
## 2026-06-12 · Phase 9D · Tarif-Datenmodell, Rechnungskreise & USt ✅
Zentrale Doku: `docs/user-admin/Billing-und-Rechnungskreise.md`.
Plan: `docs/PHASE-9-FLOW-UND-TARIFE-PLAN.md` (9D ✅, 9E in Arbeit).
**Tarif-Datenmodell**
- Laravel Cashier ^16.5 (freigegeben), `User` ist Billable,
Cashier-Migrationen published + ausgeführt.
- `plans` (4 Tiers, Netto-Preise, Kontingente, Tageslimits, Seeder),
`single_purchases` (Einzel-PM, Extra-PM, Boost, PDF-Nachweis).
- `hasActiveBooking()` prüft hybrid: Cashier-Abo bezahlter
Einmalkauf aktive Legacy-Vereinbarung.
**Hybride Rechnungskreise (Entscheidung 12.06.)**
- `InvoiceNumberGenerator`: atomare fortlaufende Nummern, STR- (Stripe)
/ MAN- (manuell); Alt-Archiv `legacy_invoices` bleibt unverändert.
- MAN-Fälligkeitslauf `billing:generate-manual-invoices` (täglich
04:30): Periodenende → Rechnung mit Adress-Snapshot → Periode weiter.
**Legacy-Migration (P6.6, Runbook entsperrt)**
- `legacy:grandfather-subscriptions`: aktive jährliche Vereinbarungen
aus dem Rechnungsarchiv (22 im Test-Snapshot, 4 sofort fällig) als
`grandfathered` nach `user_payment_options` — Replay-fähig für den
Lauf kurz vor Relaunch.
**USt (Einwand 12.06.: alle neuen Preise netto; Legacy war brutto)**
- `VatResolver`: DE immer Steuer, EU nur mit USt-ID befreit (Reverse
Charge + Pflichthinweis `invoices.tax_note`), Drittland befreit.
- `vat_id` an Rechnungsadresse + Rechnungs-Snapshot; Netto-Ableitung
der Legacy-Beträge (199 € brutto → 167,23 € netto + 31,77 € USt —
Brutto bleibt für DE-Bestandskunden identisch).
- Offen: VIES-Validierung, PDF-Layout, Steuerberater-Abnahme.
**Verifikation**: Suite 490 passed / 4 skipped (39 neue Billing-Tests
über 4 Commits). Pint clean. Dry-Runs gegen Echtdaten validiert.
---
## 2026-06-12 · Phase 9 · Veröffentlichungs-Flow Block 1 (9A9C) ✅
Plan-Doc: `docs/PHASE-9-FLOW-UND-TARIFE-PLAN.md`. Grundlage: