Files
Betriebsf-hrungssoftware/test/liquiditaet.test.ts
Claude 83828c12f8
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
Haken „zählt“: Posten dauerhaft aus der Liquidität nehmen (0.41.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-10-26 09:34:21 +00:00

219 lines
12 KiB
TypeScript

import { describe, it, expect } from "vitest";
import { liquiditaet, periodenGrenzen, termineLaufend, projektBewegungen, type ProjektPlan } from "../src/domain/liquiditaet.js";
import { faelligkeit, zeitraumVon } from "../src/domain/umsatzsteuer.js";
import { lage, laeuftHeute, laufendJeMonat } from "../src/domain/lage.js";
describe("Umsatzsteuer-Fälligkeit", () => {
it("10. des Folgemonats, Wochenende verschiebt auf Montag", () => {
expect(faelligkeit("2026-09", { dauerfristverlaengerung: false })).toBe("2026-10-12"); // 10.10. ist Sa
expect(faelligkeit("2026-10", { dauerfristverlaengerung: false })).toBe("2026-11-10"); // Di
});
it("Freitag bleibt Freitag (Freitagsregel gilt nicht)", () => {
expect(faelligkeit("2026-06", { dauerfristverlaengerung: false })).toBe("2026-07-10"); // Fr
});
it("Dauerfristverlängerung und Jahreswechsel", () => {
expect(faelligkeit("2026-12", { dauerfristverlaengerung: true })).toBe("2027-02-10");
expect(faelligkeit("2026-Q4", { dauerfristverlaengerung: false })).toBe("2027-01-11"); // 10.01.27 So
});
it("Zeitraum", () => {
expect(zeitraumVon("2026-05-31", "vierteljaehrlich")).toBe("2026-Q2");
});
});
describe("Perioden", () => {
it("Wochen beginnen montags", () => {
expect(periodenGrenzen({ ansicht: "woche", start: "2026-10-15", anzahl: 2 })).toEqual([
{ von: "2026-10-12", bis: "2026-10-18" },
{ von: "2026-10-19", bis: "2026-10-25" },
]);
});
it("Monate", () => {
expect(periodenGrenzen({ ansicht: "monat", start: "2026-12-15", anzahl: 2 })).toEqual([
{ von: "2026-12-01", bis: "2026-12-31" },
{ von: "2027-01-01", bis: "2027-01-31" },
]);
});
it("laufende Kosten vierteljährlich mit Ende", () => {
expect(termineLaufend({ bezeichnung: "Vers.", betrag: 1, rhythmus: "vierteljaehrlich", start: "2026-01-15", ende: "2026-09-30" }, "2026-01-01", "2026-12-31"))
.toEqual(["2026-01-15", "2026-04-15", "2026-07-15"]);
});
});
describe("Liquiditätsvorschau", () => {
const vorschau = { ansicht: "monat" as const, start: "2026-11-01", anzahl: 3, startsaldo: 1_000_000 };
const daten = {
einnahmen: [{ projekt: "26-01", bezeichnung: "Anzahlung", netto: 3_000_000, termin: "2026-11-02" }],
ausgaben: [{ projekt: "26-01", bezeichnung: "KVH", art: "material" as const, netto: 1_000_000, termin: "2026-11-05" }],
laufend: [{ bezeichnung: "Miete", betrag: 80_000, rhythmus: "monatlich" as const, start: "2026-01-03" }],
};
it("Vorgaben wie V70: Ziele 14/7 Tage, Ist-Versteuerung mit Dauerfristverlängerung", () => {
const p = liquiditaet(daten, vorschau);
// November: Anzahlung 35.700 € am 16.11., Material 11.900 € am 12.11., Miete -800 €
expect(p[0]!.einnahmen).toBe(3_570_000);
expect(p[0]!.ausgaben).toBe(-80_000 - 1_190_000);
expect(p[1]!.posten.map((x) => [x.datum, x.gruppe, x.betrag])).toEqual([["2026-12-03", "Laufende Kosten", -80_000]]);
// USt November (5.700 - 1.900 = 3.800) mit Dauerfrist am 10.01.27, Sonntag -> 11.01.
expect(p[2]!.posten.map((x) => [x.datum, x.gruppe, x.betrag])).toEqual([
["2027-01-03", "Laufende Kosten", -80_000],
["2027-01-11", "Umsatzsteuer", -380_000],
]);
expect(p[2]!.kontostand).toBe(1_000_000 + 3_570_000 - 1_190_000 - 380_000 - 3 * 80_000);
});
it("Soll-Versteuerung ohne Dauerfrist, eigene Zahlungsziele", () => {
const p = liquiditaet(daten, {
...vorschau,
ziele: { kundenTage: 14, materialTage: 30, fremdTage: 14, sonstigeTage: 0 },
ust: { satz: 19, voranmeldung: "monatlich", dauerfristverlaengerung: false, versteuerung: "soll" },
});
expect(p[0]!.ausgaben).toBe(-80_000);
expect(p[1]!.posten.map((x) => [x.datum, x.gruppe, x.betrag])).toEqual([
["2026-12-03", "Laufende Kosten", -80_000],
["2026-12-05", "Projektkosten", -1_190_000],
["2026-12-10", "Umsatzsteuer", -380_000],
]);
});
it("Zahllast je Monat aus der Nettosumme, nur einmal gerundet", () => {
// 3 x 0,05 € netto: je Posten gerundet wären es 3 x 0,01 €, richtig sind 0,0285 € -> 0,03 €
const e = (t: string) => ({ bezeichnung: "x", netto: 5, termin: t, zahlungszielTage: 0 });
const ust = { satz: 19, voranmeldung: "monatlich" as const, dauerfristverlaengerung: false, versteuerung: "ist" as const };
const p = liquiditaet({ einnahmen: [e("2026-11-02"), e("2026-11-03"), e("2026-11-04")], ausgaben: [], laufend: [] }, { ...vorschau, ust });
expect(p[1]!.posten.filter((x) => x.gruppe === "Umsatzsteuer").map((x) => x.betrag)).toEqual([-3]);
});
it("Ist-Versteuerung verschiebt die USt in den Zahlungsmonat", () => {
const p = liquiditaet(
{ einnahmen: [{ bezeichnung: "Schluss", netto: 1_000_000, termin: "2026-11-25" }], ausgaben: [], laufend: [] },
{ ...vorschau, ust: { satz: 19, voranmeldung: "monatlich", dauerfristverlaengerung: false, versteuerung: "ist" } },
);
// Zahlung 09.12. -> USt Dezember fällig 11.01.2027 (10.01. ist Sonntag)
expect(p[2]!.posten).toEqual([{ datum: "2027-01-11", gruppe: "Umsatzsteuer", bezeichnung: "USt-Vorauszahlung 2026-12", betrag: -190_000 }]);
});
it("bezahlte Einnahme zählt am Zahltag", () => {
const p = liquiditaet(
{ einnahmen: [{ bezeichnung: "A", netto: 100, termin: "2026-10-01", bezahltAm: "2026-11-30" }], ausgaben: [], laufend: [] },
vorschau,
);
expect(p[0]!.einnahmen).toBe(119);
});
});
describe("Projekt nach V70-Regeln", () => {
const plan: ProjektPlan = {
projekt: "P-26-001", umsatz: 10_000_000, material: 2_000_000, fremd: 1_000_000, sonstiges: 0,
zeitraum: { start: "2026-11-02", ende: "2026-11-20" },
zahlungen: [{ projekt: "P-26-001", bezeichnung: "Abschlag Abbund", netto: 4_000_000, termin: "2026-11-10" }],
kosten: [{ projekt: "P-26-001", bezeichnung: "Leimbinder", art: "material", netto: 600_000, termin: "2026-11-15", mitVorsteuer: false }],
};
it("Rest als Schlussrechnung am Projektende, Pauschale anteilig gemindert am Projektstart", () => {
const b = projektBewegungen(plan);
expect(b.einnahmen.map((e) => [e.bezeichnung, e.netto, e.termin])).toEqual([
["Abschlag Abbund", 4_000_000, "2026-11-10"],
["Schlussrechnung (Rest)", 6_000_000, "2026-11-20"],
]);
// 30.000 € Pauschale - 6.000 € Einzelkosten = 80 %
expect(b.ausgaben.map((a) => [a.bezeichnung, a.netto, a.termin, a.mitVorsteuer])).toEqual([
["Leimbinder", 600_000, "2026-11-15", false],
["Material (Pauschale)", 1_600_000, "2026-11-02", true],
["Fremdleistung (Pauschale)", 800_000, "2026-11-02", false],
]);
});
it("Anteile kaufmännisch gerundet, Summe bleibt exakt", () => {
const b = projektBewegungen({ ...plan, material: 33_333, fremd: 66_667, kosten: [{ ...plan.kosten[0]!, netto: 100 }] });
expect(b.ausgaben.slice(1).map((a) => a.netto)).toEqual([33_300, 66_600]);
});
it("Einzelkosten über der Pauschale: keine Pauschale mehr; voll abgerechnet: kein Rest", () => {
const b = projektBewegungen({ ...plan, zahlungen: [{ ...plan.zahlungen[0]!, netto: 10_000_000 }], kosten: [{ ...plan.kosten[0]!, netto: 4_000_000 }] });
expect(b.einnahmen).toHaveLength(1);
expect(b.ausgaben).toHaveLength(1);
});
it("ohne Termine zählen nur die Einzelposten", () => {
expect(projektBewegungen({ ...plan, zeitraum: undefined })).toEqual({ einnahmen: plan.zahlungen, ausgaben: plan.kosten });
});
});
describe("Lage der Liquidität (Henning, 21.10.2026)", () => {
const daten = {
einnahmen: [
{ projekt: "P-26-014", bezeichnung: "1. Rate", netto: 1_000_000, termin: "2026-09-20", zahlungszielTage: 14, gestellt: true },
{ projekt: "P-26-014", bezeichnung: "alte Rate", netto: 500_000, termin: "2026-09-01", zahlungszielTage: 14, bezahlt: true },
{ projekt: "P-26-014", bezeichnung: "2. Rate", netto: 2_000_000, termin: "2026-11-16", zahlungszielTage: 14 },
],
ausgaben: [{ projekt: "P-26-014", bezeichnung: "Holz", art: "material" as const, netto: 1_200_000, termin: "2026-10-26", zahlungszielTage: 7 }],
laufend: [
{ bezeichnung: "Miete", betrag: 300_000, rhythmus: "monatlich" as const, start: "2026-01-01" },
{ bezeichnung: "Versicherung", betrag: 120_000, rhythmus: "jaehrlich" as const, start: "2026-03-01" },
],
};
const v = { ansicht: "woche" as const, start: "2026-10-21", anzahl: 13, startsaldo: 2_000_000, offeneAb: "2026-10-21" };
it("offene Einnahmen mit vergangenem Zahltag sind überfällig und zählen heute; bezahlte nicht", () => {
const w = liquiditaet(daten, v);
const alle = w.flatMap((p) => p.posten);
const rate = alle.find((p) => p.bezeichnung === "1. Rate")!;
expect(rate).toMatchObject({ datum: "2026-10-21", ueberfaelligSeit: "2026-10-04", gestellt: true });
expect(alle.find((p) => p.bezeichnung === "alte Rate")).toBeUndefined();
// ohne offeneAb bleibt es wie bisher
expect(liquiditaet(daten, { ...v, offeneAb: undefined }).flatMap((p) => p.posten).find((p) => p.bezeichnung === "1. Rate")).toBeUndefined();
});
it("jährliche Kosten mit erster Zahlung in den nächsten 12 Monaten laufen schon (Henning, 21.10.2026)", () => {
const h = "2026-10-21";
expect(laeuftHeute({ rhythmus: "jaehrlich", start: "2027-01-02" }, h)).toBe(true);
expect(laeuftHeute({ rhythmus: "jaehrlich", start: "2027-11-01" }, h)).toBe(false);
expect(laeuftHeute({ rhythmus: "vierteljaehrlich", start: "2027-01-15" }, h)).toBe(true);
expect(laeuftHeute({ rhythmus: "monatlich", start: "2027-01-01" }, h)).toBe(false);
expect(laeuftHeute({ rhythmus: "monatlich", start: "2026-01-01", ende: "2026-10-01" }, h)).toBe(false);
expect(laeuftHeute({ rhythmus: "einmalig", start: "2026-11-01" }, h)).toBe(false);
expect(laufendJeMonat([{ bezeichnung: "Kammer", betrag: 120_000, rhythmus: "jaehrlich", start: "2027-01-02" }], h)).toBe(10_000);
});
it("Mindestgrenze aus den laufenden Kosten, Tiefpunkt mit Grund", () => {
expect(laufendJeMonat(daten.laufend, "2026-10-21")).toBe(310_000);
const w = liquiditaet(daten, v);
const l = lage(w, 2_000_000, 310_000);
expect(l.frei).toBe(1_690_000);
expect(l.tief!.kontostand).toBe(Math.min(...w.map((p) => p.kontostand)));
expect(l.grund[0]?.bezeichnung).toBe("Holz");
expect(l.ampel).toBe(l.tief!.kontostand < 0 ? "rot" : l.tief!.kontostand < 310_000 ? "gelb" : "gruen");
});
});
describe("Haken „zählt“ (Henning, 26.10.2026)", () => {
const vorschau = { ansicht: "monat" as const, start: "2026-11-01", anzahl: 1, startsaldo: 0, ust: { satz: 19, versteuerung: "ist" as const, voranmeldung: "monatlich" as const, dauerfristverlaengerung: false } };
it("ohne Haken: sichtbar unter ohne, aber in keiner Summe und nicht in der Umsatzsteuer", () => {
const p = liquiditaet({
einnahmen: [{ bezeichnung: "Abschlag", netto: 100_000, termin: "2026-11-02", zahlungszielTage: 0, quelle: "zahlung:a" },
{ bezeichnung: "Doppelt", netto: 50_000, termin: "2026-11-03", zahlungszielTage: 0, quelle: "zahlung:b", zaehltNicht: true }],
ausgaben: [],
laufend: [{ id: "l1", bezeichnung: "Miete", betrag: 1_000, rhythmus: "monatlich", start: "2026-11-05", ohneTermine: ["2026-11-05"] }],
}, vorschau);
expect(p[0]!.einnahmen).toBe(119_000);
expect(p[0]!.ausgaben).toBe(0);
expect(p[0]!.posten.map((x) => x.quelle)).toEqual(["zahlung:a"]);
expect(p[0]!.ohne!.map((x) => [x.quelle, x.zaehltNicht])).toEqual([["zahlung:b", true], ["lk:l1:2026-11-05", true]]);
// Zahllast nur aus dem Abschlag; die Vorauszahlung November ist erst im Dezember fällig
const d = liquiditaet({ einnahmen: [{ bezeichnung: "Doppelt", netto: 50_000, termin: "2026-11-03", zaehltNicht: true }], ausgaben: [], laufend: [] }, { ...vorschau, anzahl: 2 });
expect(d.flatMap((x) => x.posten)).toEqual([]);
});
it("Pauschale und Rest einzeln abschaltbar, Einzelposten mindern die Pauschale weiter", () => {
const b = projektBewegungen({
projekt: "P-26-013", id: "p1", ohne: ["material"], umsatz: 1_000_000, material: 985_100, fremd: 0, sonstiges: 0,
zeitraum: { start: "2026-11-02", ende: "2026-11-20" }, zahlungen: [],
kosten: [{ projekt: "P-26-013", bezeichnung: "Holz", art: "material", netto: 500_000, termin: "2026-11-02", quelle: "kosten:k1", zaehltNicht: true }],
});
expect(b.ausgaben.map((a) => [a.bezeichnung, a.netto, a.quelle, a.zaehltNicht])).toEqual([
["Holz", 500_000, "kosten:k1", true], ["Material (Pauschale)", 485_100, "pauschale:p1:material", true]]);
expect(b.einnahmen[0]).toMatchObject({ quelle: "rest:p1" });
expect(b.einnahmen[0]!.zaehltNicht).toBeUndefined();
});
});