// 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); }); });