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>
This commit is contained in:
Claude Opus 4.8
@@ -0,0 +1,49 @@
|
||||
-- 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;
|
||||
@@ -811,6 +811,7 @@ model Contract {
|
||||
historyEntries ContractHistoryEntry[]
|
||||
documents ContractDocument[]
|
||||
invoices Invoice[]
|
||||
creditNotes CreditNote[]
|
||||
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
@@ -946,6 +947,89 @@ model Invoice {
|
||||
@@index([contractId])
|
||||
}
|
||||
|
||||
// ==================== GUTSCHRIFTEN (CREDIT NOTES / SUBVENTIONEN) ====================
|
||||
|
||||
// Art der Gutschrift: Geldbetrag (per Überweisung, in EUR) oder Sachwert
|
||||
// (Smartphone, Elektrogerät …, näher im Textfeld beschrieben).
|
||||
enum CreditNoteType {
|
||||
GELD
|
||||
SACHWERT
|
||||
}
|
||||
|
||||
// Kundentyp zum Zeitpunkt der Gutschrift – bestimmt die USt-Sicht
|
||||
// (Privat rechnet brutto, Firma zieht Vorsteuer). Wird aus dem Kunden
|
||||
// vorbelegt, ist aber pro Gutschrift überschreibbar.
|
||||
enum CreditNoteCustomerType {
|
||||
PRIVAT
|
||||
FIRMA
|
||||
}
|
||||
|
||||
// Basis, auf die sich der eingegebene Betrag bezieht (nur relevant, wenn
|
||||
// vatRelevant = true). Bei NETTO wird die USt aufgeschlagen, bei BRUTTO
|
||||
// herausgerechnet.
|
||||
enum CreditNoteAmountBasis {
|
||||
NETTO
|
||||
BRUTTO
|
||||
}
|
||||
|
||||
model CreditNote {
|
||||
id Int @id @default(autoincrement())
|
||||
contractId Int
|
||||
contract Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)
|
||||
|
||||
number String @unique // aus Nummernkreis, z.B. GS-2026-0001
|
||||
|
||||
type CreditNoteType
|
||||
// Pflicht bei SACHWERT: was wird gewährt (z.B. "Smartphone Samsung A55").
|
||||
sachwertDescription String?
|
||||
|
||||
customerType CreditNoteCustomerType
|
||||
// USt-relevant ja/nein (Steuerberater-Auslegung: Vermittlungsleistung vs.
|
||||
// reiner Abschlussbonus/Entgeltminderung). Bei false: net = brutto, USt = 0.
|
||||
vatRelevant Boolean @default(false)
|
||||
amountBasis CreditNoteAmountBasis @default(BRUTTO)
|
||||
vatRate Float @default(19) // Prozent
|
||||
amountNet Float @default(0)
|
||||
amountVat Float @default(0)
|
||||
amountGross Float @default(0)
|
||||
currency String @default("EUR")
|
||||
|
||||
// Datum der Gutschrift (frei änderbar).
|
||||
creditDate DateTime
|
||||
// Ort der Unterschrift + Unterschrift-/Bestätigungszeitpunkt.
|
||||
place String?
|
||||
signedAt DateTime?
|
||||
// Sachwert: Bestätigung "Ware erhalten".
|
||||
goodsReceived Boolean @default(false)
|
||||
|
||||
// Überweisungsbeleg (nur GELD) – hochgeladene Datei.
|
||||
receiptPath String?
|
||||
// Generiertes Gutschrift-Dokument (PDF bzw. ZUGFeRD-Hybrid) – Phase 3.
|
||||
pdfPath String?
|
||||
|
||||
notes String?
|
||||
createdBy String?
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
@@index([contractId])
|
||||
}
|
||||
|
||||
// Nummernkreis für Gutschriften (Einzel-Zeile, in den Einstellungen
|
||||
// verwaltbar). Nummer wird transaktional vergeben, damit keine Lücken/
|
||||
// Doppelvergaben entstehen.
|
||||
model CreditNoteNumberRange {
|
||||
id Int @id @default(autoincrement())
|
||||
prefix String @default("GS-")
|
||||
includeYear Boolean @default(true)
|
||||
separator String @default("-")
|
||||
padding Int @default(4)
|
||||
nextNumber Int @default(1)
|
||||
resetYearly Boolean @default(true)
|
||||
currentYear Int?
|
||||
updatedAt DateTime @updatedAt
|
||||
}
|
||||
|
||||
// ==================== INTERNET CONTRACT DETAILS ====================
|
||||
|
||||
model InternetContractDetails {
|
||||
|
||||
Reference in New Issue
Block a user