Gutschrift: separater Lieferschein-Nummernkreis (GoBD, luecken-frei)

Pentester R142: Uebergang Geld->betragsloser Sachwert setzte die schon
vergebene Gutschriftsnummer auf null -> Luecke in der GS-Serie.

Loesung: betragsloser Sachwert = Lieferschein mit eigener
Lieferscheinnummer aus separatem Nummernkreis.

- Schema: CreditNote.deliveryNoteNumber (nullbar, unique) + neues Model
  DeliveryNoteNumberRange (Default-Praefix 'LS-') + Migration.
- deliveryNoteNumberRange.service (mirror, eigener Zaehler, FOR UPDATE).
- Nummern lazy pro Serie, NIE freigeben: Uebergaenge behalten die
  jeweils vergebene Nummer der anderen Serie reserviert -> kein
  Doppelverbrauch, keine Luecke. effectiveNumber() liefert je nach Typ
  die passende (LS/GS) fuer Anzeige/PDF/Audit.
- Endpunkte GET/PUT /credit-notes/delivery-note-number-range; Settings-
  Seite verwaltet jetzt beide Nummernkreise. PDF-Titel 'Sachwert-
  Uebergabe', Dateiname lieferschein-...
- Frontend: Typ + displayNumber in Liste/Modal.

Verifiziert: Sachwert 0 -> LS-Nr, GS-Zaehler unberuehrt; Geld -> GS-Nr;
Uebergaenge behalten beide Nummern (kein Neuverbrauch, keine Luecke).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

backend/src/services/creditNote.service.ts

@@ -5,6 +5,7 @@
 import prisma from '../lib/prisma.js';
 import { ApiError } from '../utils/apiError.js';
 import { assignNextNumber } from './creditNoteNumberRange.service.js';
+import { assignNextNumber as assignNextDeliveryNoteNumber } from './deliveryNoteNumberRange.service.js';
 import { deleteUploadByRelativePath } from '../utils/fileCleanup.js';
 import { CreditNoteType, CreditNoteCustomerType, CreditNoteAmountBasis } from '@prisma/client';
 
@@ -45,11 +46,22 @@ export function computeAmounts(params: {
 }
 
 // Betragsloser Sachwert = reine Übergabe/Lieferschein (keine Rechnung,
-// keine USt, keine Gutschriftsnummer, kein ZUGFeRD).
-function isNonMonetary(n: { type: CreditNoteType; amountGross: number }): boolean {
+// keine USt, kein ZUGFeRD; eigene Lieferscheinnummer statt Gutschriftsnummer).
+export function isNonMonetary(n: { type: CreditNoteType; amountGross: number }): boolean {
   return n.type === 'SACHWERT' && n.amountGross === 0;
 }
 
+// Die je nach aktuellem Typ „gültige" Belegnummer: Lieferscheinnummer bei
+// betragslosem Sachwert, sonst Gutschriftsnummer.
+export function effectiveNumber(cn: {
+  type: CreditNoteType;
+  amountGross: number;
+  number: string | null;
+  deliveryNoteNumber: string | null;
+}): string | null {
+  return isNonMonetary(cn) ? cn.deliveryNoteNumber : cn.number;
+}
+
 const ALLOWED_TYPES = new Set(['GELD', 'SACHWERT']);
 const ALLOWED_CUSTOMER_TYPES = new Set(['PRIVAT', 'FIRMA']);
 const ALLOWED_BASIS = new Set(['NETTO', 'BRUTTO']);
@@ -223,14 +235,18 @@ export async function createCreditNote(
   if (normalized.payoutBankCardId) {
     await assertBankCardBelongsToContract(contractId, normalized.payoutBankCardId);
   }
-  // Betragsloser Sachwert = Lieferschein → KEINE Gutschriftsnummer vergeben
-  // (Nummernkreis-Zähler bleibt unangetastet). Sonst nächste Nummer ziehen.
-  const number = isNonMonetary(normalized) ? null : await assignNextNumber();
+  // Betragsloser Sachwert = Lieferschein → eigene Lieferscheinnummer aus dem
+  // separaten Kreis; der Gutschrift-Zähler bleibt unangetastet. Sonst echte
+  // Gutschrift → Gutschriftsnummer.
+  const nonMonetary = isNonMonetary(normalized);
+  const number = nonMonetary ? null : await assignNextNumber();
+  const deliveryNoteNumber = nonMonetary ? await assignNextDeliveryNoteNumber() : null;
 
   return prisma.creditNote.create({
     data: {
       contractId,
       number,
+      deliveryNoteNumber,
       ...normalized,
       createdBy,
     },
@@ -247,21 +263,24 @@ export async function updateCreditNote(id: number, input: CreateCreditNoteInput)
     await assertBankCardBelongsToContract(existing.contractId, normalized.payoutBankCardId);
   }
 
-  // Nummer an den (neuen) monetären Status anpassen:
-  //  - wird betragsloser Sachwert (Lieferschein) → Nummer entfernen,
-  //  - wird eine echte Gutschrift und hatte noch keine Nummer → jetzt vergeben,
-  //  - sonst bestehende Nummer beibehalten (einmal vergeben = fix).
+  // Nummern lazy pro Serie vergeben und NIE wieder freigeben (keine Lücken,
+  // GoBD): je nach aktuellem Typ bekommt der Beleg bei Bedarf die fehlende
+  // Nummer der passenden Serie; eine bereits vergebene Nummer der anderen
+  // Serie bleibt am Beleg reserviert (nicht angezeigt), damit ein späteres
+  // Zurückwechseln keine neue Nummer verbraucht.
+  const nonMonetary = isNonMonetary(normalized);
   let number = existing.number;
-  if (isNonMonetary(normalized)) {
-    number = null;
-  } else if (number === null) {
-    number = await assignNextNumber();
+  let deliveryNoteNumber = existing.deliveryNoteNumber;
+  if (nonMonetary) {
+    if (deliveryNoteNumber === null) deliveryNoteNumber = await assignNextDeliveryNoteNumber();
+  } else {
+    if (number === null) number = await assignNextNumber();
   }
 
   // Ein evtl. schon erzeugtes PDF ist nach inhaltlicher Änderung veraltet →
   // Pfad leeren. Reihenfolge (R140): erst DB-Update, DANN die alte Datei
   // löschen – schlägt das Update fehl, bleibt die Datei.
-  const updated = await prisma.creditNote.update({ where: { id }, data: { ...normalized, number, pdfPath: null } });
+  const updated = await prisma.creditNote.update({ where: { id }, data: { ...normalized, number, deliveryNoteNumber, pdfPath: null } });
   deleteUploadByRelativePath(existing.pdfPath);
   return updated;
 }