Files
Betriebsf-hrungssoftware/test/jahresplan.test.ts
Claude 1d1ba3ace4
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
Stufe 5: Jahresplanung mit Versionen, 12 Monaten, Plan/Ist und BWA-Import (0.22.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-10-21 21:20:22 +00:00

194 lines
11 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Jahresfinanzplanung (Stufe 5): Treppe, Monatsplan, Vorschläge, BWA einlesen, Plan/Ist und Liquiditäts-Vorschau
import { describe, it, expect, beforeAll, afterAll } from "vitest";
import { readFileSync } from "node:fs";
import type { FastifyInstance } from "fastify";
import { type PlanDaten, leererPlan, rechne, vorschlaege, knappText, verteile, annuitaet, planPosten } from "../src/domain/jahresplan.js";
import { liesBwa, istWerte, zuordnungVorschlag, planIst, betrag } from "../src/domain/bwa.js";
import { erstellePool, type Pool } from "../src/server/db.js";
import { migriere } from "../src/server/migrate.js";
import { baueApp } from "../src/server/app.js";
import { ersterFreitag, saisonAus } from "../src/server/jahresplan.js";
/** das Beispiel aus dem Entwurf (finanzen/entwurf-jahresplan) */
function entwurf(): PlanDaten {
const d = leererPlan({ stundensatz: 6200, materialEinkauf: 12_000_000, subEinkauf: 6_000_000, laufendMonat: 320_000, preissteigerung: 0,
werbungMonat: 25_000, afaBisher: 50_000, kontostandStart: 1_308_000, mindestgrenze: 600_000, steuerQuartal: 200_000 });
d.mitarbeiter = [
{ id: "h", name: "Henning", art: "inhaber", stunden: 900, brutto: 450_000, faktor: 1, eintritt: 1, austritt: 12, neu: false },
{ id: "g1", name: "Geselle 1", art: "angestellt", stunden: 1400, brutto: 340_000, faktor: 1.25, eintritt: 4, austritt: 12, neu: true },
{ id: "g2", name: "Geselle 2", art: "angestellt", stunden: 1400, brutto: 340_000, faktor: 1.25, eintritt: 4, austritt: 12, neu: true },
];
d.investitionen = [{ id: "t", name: "Transporter", betrag: 4_500_000, monat: 3, art: "kredit", anzahlung: 900_000, laufzeit: 60, zins: 5, rate: 0, nutzungsdauer: 6 }];
return d;
}
const bwaText = () => new TextDecoder("windows-1252").decode(readFileSync(new URL("./daten/datev-bwa-muster.xls", import.meta.url)));
describe("Jahresplan rechnen", () => {
it("Treppe wie im Entwurf: 3.000 Std × 62 € + Material/Sub = 390.000 € Umsatz, Rohertrag 210.000 €", () => {
const t = rechne(entwurf()).treppe;
expect(t.stunden).toBe(3000);
expect(t.umsatz).toBe(39_000_000);
expect(t.rohertrag).toBe(21_000_000);
expect(t.personalWerbung).toBe(13_350_000);
expect(t.quotePersonal).toBe(63.6);
expect(t.ampelPersonal).toBe("rot");
// Gewinn = Rohertrag − Personal/Werbung − laufende Kosten (mit Zinsen) − AfA
expect(t.gewinn).toBe(t.rohertrag - t.personalWerbung - t.laufend - t.afa);
expect(t.quoteGewinn).toBeCloseTo(14.3, 1);
expect(t.luecke).toBe(Math.ceil(t.rohertrag * 0.2) - t.gewinn);
});
it("Monatsplan: Umsatz nach Saison, Summe genau, knappster Monat April", () => {
const r = rechne(entwurf());
expect(r.monate.umsatz.reduce((a, b) => a + b, 0)).toBe(39_000_000);
expect(r.monate.umsatz[0]).toBe(1_560_000);
expect(r.monate.personal[2]).toBe(0);
expect(r.monate.personal[3]).toBe(850_000);
expect(r.tief.monat).toBe(4);
const k = knappText(entwurf(), r);
expect(k.satz).toMatch(/^Am knappsten wird es Ende April mit 7\.30\d €/);
expect(k.grund).toContain("Transporter wird angezahlt");
});
it("Kredit: Anzahlung im Kaufmonat, danach Annuität; AfA ab dem Kaufmonat", () => {
const r = rechne(entwurf());
const v = r.investitionen[0]!;
expect(v.rate).toBe(annuitaet(3_600_000, 5, 60));
expect(v.abfluss[2]).toBe(900_000);
expect(v.abfluss[3]).toBe(v.rate);
expect(v.afaJahr).toBe(Math.round((4_500_000 / 72) * 10));
});
it("verteile hält die Summe", () => {
expect(verteile(100, [1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0])).toEqual([34, 33, 33, 0, 0, 0, 0, 0, 0, 0, 0, 0]);
});
it("Vorschläge schließen die Lücke jeder für sich", () => {
const v = vorschlaege(entwurf());
expect(v.map((x) => x.id)).toEqual(["satz", "material", "sub"]);
for (const x of v) expect(rechne(x.daten).treppe.luecke).toBe(0);
expect(v[0]!.text).toBe("Stundensatz 62 € → 67 €");
});
it("Vorschau für die Liquidität: nur der Rest über den echten Posten, ab dem nächsten Monat", () => {
const echte = [{ datum: "2027-05-20", gruppe: "Projekteinnahmen" as const, bezeichnung: "Abschlag", betrag: 2_380_000 }];
const p = planPosten(echte, [{ jahr: 2027, daten: entwurf() }], "2027-04-10", 19);
expect(p.some((x) => x.datum.startsWith("2027-04"))).toBe(false);
const mai = p.find((x) => x.bezeichnung === "Plan: weitere Einnahmen Mai 2027")!;
expect(mai.betrag).toBe(3_900_000 - 2_000_000);
expect(p.find((x) => x.bezeichnung === "Plan: Löhne neue Mitarbeiter Mai 2027")!.betrag).toBe(-850_000);
});
});
describe("BWA einlesen", () => {
it("liest das DATEV-Muster: August 2026, Zeilen mit Monats- und kumulierten Werten", () => {
const b = liesBwa(bwaText());
expect(b).toMatchObject({ jahr: 2026, monat: 8, art: "Einnahmen-Ausgaben-BWA" });
const z = (n: number) => b.zeilen.find((x) => x.zeile === n)!;
expect(z(1040)).toMatchObject({ monat: 5_965_391, kumuliert: 11_534_880, summe: false });
expect(z(1040).konten[1]).toMatchObject({ konto: "440000", kumuliert: 11_265_581 });
expect(z(1280)).toMatchObject({ monat: 21_385, kumuliert: 204_711 });
expect(z(1060).summe).toBe(true);
expect(z(1660).summe).toBe(true);
});
it("ordnet die Zeilen vor und rechnet Ist-Werte", () => {
const b = liesBwa(bwaText());
const zu = new Map(b.zeilen.map((z) => [z.zeile, zuordnungVorschlag(z)]));
expect(zu.get(1230)).toBe("material");
expect(zu.get(1800)).toBe("unternehmerlohn");
expect(zu.get(1100)).toBe("ignorieren");
const ist = istWerte(b.zeilen, zu, true);
expect(ist.umsatz).toBe(11_840_480);
expect(ist.material).toBe(4_136_701 + 80_695);
});
it("Beträge mit Tausenderpunkt und Minus", () => {
expect(betrag("59.653,91")).toBe(5_965_391);
expect(betrag("-0,01")).toBe(-1);
expect(betrag("")).toBeNull();
});
it("Plan/Ist färbt ab 5 % Abweichung", () => {
const r = rechne(entwurf());
const { zeilen, kennzahlen } = planIst(r, { umsatz: 3_900_000, material: 2_135_000, personal: 850_000, unternehmerlohn: 450_000, werbung: 25_000, laufend: 330_000, afa: 0, tilgung: 0, investition: 0, steuer: 0 }, 5, false);
const m = zeilen.find((z) => z.id === "material")!;
expect(m.stufe).toBe("rot");
expect(zeilen.find((z) => z.id === "umsatz")!.stufe).toBe("");
expect(kennzahlen.map((k) => k.id)).toEqual(["rohertrag", "personal", "gewinn"]);
});
it("Saison aus Vorjahresumsätzen und erster Freitag", () => {
expect(saisonAus([1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]).reduce((a, b) => a + b, 0)).toBe(100);
expect(ersterFreitag(2026, 11)).toBe("2026-11-06");
expect(ersterFreitag(2027, 1)).toBe("2027-01-01");
});
});
const url = process.env.TEST_DATABASE_URL;
describe.skipIf(!url)("Jahresplan über die API", () => {
let pool: Pool;
let app: FastifyInstance;
beforeAll(async () => {
pool = erstellePool(url!);
await pool.query("drop schema public cascade; create schema public;");
await migriere(pool);
app = await baueApp({ pool, webOrdner: "/gibt-es-nicht", anmeldung: "testversion" });
});
afterAll(async () => { await app?.close(); await pool?.end(); });
it("erste Version ist Basis und gilt; weitere Versionen, Basis bleibt", async () => {
await app.inject({ method: "POST", url: "/api/laufende-kosten", payload: { bezeichnung: "Gehalt Eigner", kategorie: "Personalkosten Henning", betrag: 400_000, rhythmus: "monatlich", start: "2026-01-01" } });
await app.inject({ method: "POST", url: "/api/laufende-kosten", payload: { bezeichnung: "Versicherung", kategorie: "Versicherung", betrag: 120_000, rhythmus: "jaehrlich", start: "2026-01-01" } });
const b = await app.inject({ method: "POST", url: "/api/jahresplan", payload: { jahr: 2027 } });
expect(b.statusCode, b.body).toBe(201);
expect(b.json()).toMatchObject({ basis: true, gilt: true, name: "Basis" });
const d = b.json().daten as PlanDaten;
expect(d.annahmen.laufendMonat).toBe(10_000);
expect(d.mitarbeiter[0]).toMatchObject({ art: "inhaber", brutto: 400_000 });
const v = await app.inject({ method: "POST", url: "/api/jahresplan", payload: { jahr: 2027, von: b.json().id, name: "Mit 3. Geselle" } });
expect(v.json()).toMatchObject({ basis: false, gilt: false });
const g = await app.inject({ method: "PATCH", url: `/api/jahresplan/${v.json().id}`, payload: { gilt: true } });
expect(g.json().gilt).toBe(true);
expect((await app.inject({ method: "DELETE", url: `/api/jahresplan/${b.json().id}` })).statusCode).toBe(409);
expect((await app.inject({ method: "DELETE", url: `/api/jahresplan/${v.json().id}` })).statusCode).toBe(204);
const l = (await app.inject("/api/jahresplan?jahr=2027")).json();
expect(l.versionen).toHaveLength(1);
expect(l.versionen[0].gilt).toBe(true);
});
it("Finanzsitzung als Aufgabe, nur einmal je Monat", async () => {
await app.inject("/api/jahresplan?jahr=2027");
await app.inject("/api/jahresplan?jahr=2027");
const a = (await app.inject("/api/aufgaben")).json().filter((x: { text: string }) => x.text.startsWith("Finanzsitzung"));
expect(a).toHaveLength(1);
expect(new Date(a[0].faellig_am).getUTCDay() === 5 || typeof a[0].faellig_am === "string").toBe(true);
});
it("BWA einlesen, Zuordnung ändern, Plan/Ist", async () => {
await app.inject({ method: "POST", url: "/api/jahresplan", payload: { jahr: 2026 } });
const r = await app.inject({ method: "POST", url: "/api/bwa", payload: { dateiname: "bwa.xls", inhalt: bwaText() } });
expect(r.statusCode, r.body).toBe(201);
expect(r.json()).toMatchObject({ jahr: 2026, monat: 8 });
const pi = (await app.inject("/api/jahresplan/planist?jahr=2026&monat=8&kumuliert=1")).json();
expect(pi.zeilen.find((z: { id: string }) => z.id === "umsatz").ist).toBe(11_840_480);
await app.inject({ method: "PUT", url: "/api/bwa/zuordnung/1050", payload: { planzeile: "ignorieren" } });
const pi2 = (await app.inject("/api/jahresplan/planist?jahr=2026&monat=8&kumuliert=1")).json();
expect(pi2.zeilen.find((z: { id: string }) => z.id === "umsatz").ist).toBe(11_534_880);
const n = await app.inject({ method: "PUT", url: "/api/finanzmonat/2026/8", payload: { notizen: { material: "Holz teurer" }, erledigt: ["bwa"] } });
expect(n.json()).toMatchObject({ notizen: { material: "Holz teurer" }, erledigt: ["bwa"] });
const kaputt = await app.inject({ method: "POST", url: "/api/bwa", payload: { inhalt: "kein HTML" } });
expect(kaputt.statusCode).toBe(400);
});
it("Liquidität rechnet den geltenden Plan als Vorschau mit; Mitarbeiter dürfen nicht", async () => {
const r = (await app.inject("/api/liquiditaet?ansicht=monat&anzahl=24")).json();
expect(r.flatMap((p: { posten: { gruppe: string }[] }) => p.posten).some((x: { gruppe: string }) => x.gruppe === "Jahresplan")).toBe(true);
const sicherung = (await app.inject("/api/export")).json();
expect(sicherung.daten.jahresplaene.length).toBeGreaterThan(0);
expect(sicherung.daten.finanz_monate.length).toBeGreaterThan(0);
});
});