Files
opencrm/backend/prisma/migrations/20260806100000_credit_notes/migration.sql
T
duffyduckandClaude Opus 4.8 f1c37a7d25 Gutschriften Phase 1: Backend (Modell, Nummernkreis, CRUD, USt-Rechnung)
Neues Feature Gutschriftsverwaltung (Subventionen am Vertrag):

- Modelle CreditNote + CreditNoteNumberRange + Enums (GELD/SACHWERT,
  PRIVAT/FIRMA, NETTO/BRUTTO) + Migration (IF NOT EXISTS, auf Dev
  angewandt).
- USt pro Gutschrift waehlbar (vatRelevant + Basis Netto/Brutto +
  Satz); Netto/USt/Brutto werden berechnet und getrennt gespeichert
  (ZUGFeRD-tauglich). Kundentyp Privat/Firma aus Kunde vorbelegt.
- Nummernkreis in Settings verwaltbar; Nummernvergabe transaktional
  mit SELECT ... FOR UPDATE (keine Doppelvergabe). Bsp GS-2026-0001.
- Service/Controller/Routes: GET/POST /contracts/:id/credit-notes,
  GET .../defaults, GET/PUT/DELETE /credit-notes/:id,
  GET/PUT /credit-notes/number-range. Portal-Token geblockt (interner
  Bereich), CREATE/UPDATE/DELETE auditiert.

Verifiziert: USt-Rechnung (200 netto->238, 200 brutto->168,07+31,93)
und fortlaufende Nummernvergabe.

Phase 2 (Vertrag-UI + Beleg-Upload + Nummernkreis-UI) und Phase 3
(PDF + ZUGFeRD) folgen.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-08-06 09:03:42 +02:00

50 lines
2.4 KiB
SQL

-- Gutschriften (Subventionen) zu einem Vertrag: Geldbetrag (Überweisung)
-- oder Sachwert. USt pro Gutschrift wählbar (vatRelevant + Basis Netto/Brutto).
-- ZUGFeRD-taugliches Datenmodell (Netto/USt/Brutto getrennt).
-- ON DELETE CASCADE: wird der Vertrag gelöscht, verschwinden die Gutschriften.
CREATE TABLE IF NOT EXISTS `CreditNote` (
`id` INT NOT NULL AUTO_INCREMENT,
`contractId` INT NOT NULL,
`number` VARCHAR(191) NOT NULL,
`type` ENUM('GELD', 'SACHWERT') NOT NULL,
`sachwertDescription` VARCHAR(191) NULL,
`customerType` ENUM('PRIVAT', 'FIRMA') NOT NULL,
`vatRelevant` BOOLEAN NOT NULL DEFAULT false,
`amountBasis` ENUM('NETTO', 'BRUTTO') NOT NULL DEFAULT 'BRUTTO',
`vatRate` DOUBLE NOT NULL DEFAULT 19,
`amountNet` DOUBLE NOT NULL DEFAULT 0,
`amountVat` DOUBLE NOT NULL DEFAULT 0,
`amountGross` DOUBLE NOT NULL DEFAULT 0,
`currency` VARCHAR(191) NOT NULL DEFAULT 'EUR',
`creditDate` DATETIME(3) NOT NULL,
`place` VARCHAR(191) NULL,
`signedAt` DATETIME(3) NULL,
`goodsReceived` BOOLEAN NOT NULL DEFAULT false,
`receiptPath` VARCHAR(191) NULL,
`pdfPath` VARCHAR(191) NULL,
`notes` TEXT NULL,
`createdBy` VARCHAR(191) NULL,
`createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
`updatedAt` DATETIME(3) NOT NULL,
PRIMARY KEY (`id`),
UNIQUE INDEX `CreditNote_number_key` (`number`),
INDEX `CreditNote_contractId_idx` (`contractId`),
CONSTRAINT `CreditNote_contractId_fkey` FOREIGN KEY (`contractId`)
REFERENCES `Contract` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- Nummernkreis (Einzel-Zeile, in den Einstellungen verwaltbar).
CREATE TABLE IF NOT EXISTS `CreditNoteNumberRange` (
`id` INT NOT NULL AUTO_INCREMENT,
`prefix` VARCHAR(191) NOT NULL DEFAULT 'GS-',
`includeYear` BOOLEAN NOT NULL DEFAULT true,
`separator` VARCHAR(191) NOT NULL DEFAULT '-',
`padding` INT NOT NULL DEFAULT 4,
`nextNumber` INT NOT NULL DEFAULT 1,
`resetYearly` BOOLEAN NOT NULL DEFAULT true,
`currentYear` INT NULL,
`updatedAt` DATETIME(3) NOT NULL,
PRIMARY KEY (`id`)
) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;