sales tax

migrations/add-sales-tax-district-breakdown.sql

@@ -0,0 +1,19 @@
+-- Speichert die Distrikt-Aufschlüsselung einer Sales-Tax-Periode zum Zeitpunkt
+-- des Speicherns. Die Aufschlüsselung liegt in der getTaxSummary()-Antwort bereits
+-- vor (accounting-service.js:438-466) und wurde bisher im Frontend verworfen.
+--
+-- Rein additiv: die vier Aggregat-Spalten (total_sales, nontaxable_sales,
+-- taxable_sales, tax_collected) und ihre Werte bleiben unangetastet.
+--
+-- Bestandszeilen bleiben bewusst NULL. Sie werden NICHT rückwirkend per
+-- Live-Abfrage befuellt — deren Datumsfenster weicht ab (Datums-Roundtrip in
+-- accounting-service.js:393). Altperioden laufen dauerhaft über die als
+-- indikativ gekennzeichnete Live-Anzeige.
+--
+-- Idempotent: mehrfach ausführbar.
+
+ALTER TABLE sales_tax_periods
+    ADD COLUMN IF NOT EXISTS district_breakdown JSONB;
+
+COMMENT ON COLUMN sales_tax_periods.district_breakdown IS
+    'Snapshot der Distrikt-Aufschlüsselung beim Speichern. NULL = kein Snapshot vorhanden (Altperiode), Anzeige faellt auf indikative Live-Werte zurueck.';