kundencenter/migrations/041_billing_periods.sql
Claude (KI) 9f9c5c4b65 Abrechnungslauf: Entwürfe je Vertragsperiode, genau einmal (#50)
- invoice_billing_periods (PK Vertrag+Periodenbeginn): jede Periode wird
  genau einmal abgerechnet, auch bei parallelen Läufen (INSERT IGNORE in
  der Transaktion). Gelöschter Entwurf gibt die Periode frei (CASCADE),
  Storno hält sie belegt bis zur ausdrücklichen Freigabe
  (POST /invoices/:id/release-periods, Knopf an der stornierten Rechnung).
- Perioden nach Intervall des Preis-Snapshots (monatlich/jährlich, im
  Voraus), nicht über die wirksame Kündigung hinaus; Handrechnungen mit
  contract_id gelten bis zu ihrer Periode als abgerechnet; max. 12 je Lauf.
- Es entstehen nur Entwürfe (je Kunde einer); ausgestellt wird nie
  automatisch. Vorschau + Knopf unter Rechnungen → Fällig; automatischer
  Lauf alle 6 h nur mit Schalter in Einstellungen → Firma (Standard aus).
- Migration 041 (auch invoices.created_by NULL für den automatischen Lauf).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 12:04:01 +02:00

19 lines
1.2 KiB
SQL
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

-- Abrechnungsläufe (#50): jede Vertragsperiode wird genau einmal abgerechnet. Der Primärschlüssel (Vertrag, Periodenbeginn)
-- verhindert Doppelrechnungen auch bei parallelen Läufen. Wird ein ENTWURF gelöscht, wird die Periode wieder frei
-- (ON DELETE CASCADE); eine stornierte Rechnung hält die Periode dagegen belegt, bis das Personal sie ausdrücklich
-- zur erneuten Abrechnung freigibt.
CREATE TABLE invoice_billing_periods (
contract_id CHAR(36) NOT NULL,
period_start DATE NOT NULL,
period_end DATE NOT NULL,
invoice_id CHAR(36) NOT NULL,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
PRIMARY KEY (contract_id, period_start),
INDEX (invoice_id),
FOREIGN KEY (contract_id) REFERENCES contracts(id),
FOREIGN KEY (invoice_id) REFERENCES invoices(id) ON DELETE CASCADE
);
-- Automatischer täglicher Lauf (nur Entwürfe) – standardmäßig AUS, Einschalten unter Einstellungen > Firma.
ALTER TABLE company_settings ADD COLUMN auto_billing_runs TINYINT(1) NOT NULL DEFAULT 0;
-- Vom automatischen Lauf angelegte Entwürfe haben keinen menschlichen Ersteller (Vermerk „Abrechnungslauf“ in note).
ALTER TABLE invoices MODIFY created_by CHAR(36) NULL;