Stufe 5: Jahresplanung mit Versionen, 12 Monaten, Plan/Ist und BWA-Import (0.22.0)
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
This commit is contained in:
Claude
2026-10-21 21:20:22 +00:00
parent ee5b468502
commit 1d1ba3ace4
19 changed files with 6595 additions and 12 deletions

File diff suppressed because it is too large Load Diff

193
test/jahresplan.test.ts Normal file
View File

@@ -0,0 +1,193 @@
// 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);
});
});