diff --git a/src/domain/arbeitszeit.ts b/src/domain/arbeitszeit.ts index fae0733..932bdcb 100644 --- a/src/domain/arbeitszeit.ts +++ b/src/domain/arbeitszeit.ts @@ -1,7 +1,8 @@ -// Umrechnung geplanter Stunden in Arbeitstage (Arbeitszeitkalkulation aus V70). -// Die genaue V70-Rundung wird mit der V70-Datei abgeglichen, sobald sie vorliegt. +// Umrechnung geplanter Stunden in Arbeitstage (Arbeitszeitkalkulation wie V70, calcWith): +// Tage = Stunden ÷ (Stunden pro Tag × Personen × Produktivität), danach gerundet. -export type Rundung = "auf" | "kaufmaennisch" | "halbe"; +/** ganz: auf volle Tage aufrunden; halb: auf halbe Tage aufrunden; keine: auf 2 Stellen runden */ +export type Rundung = "ganz" | "halb" | "keine"; export interface Arbeitszeitkalkulation { stundenProTag: number; @@ -10,31 +11,27 @@ export interface Arbeitszeitkalkulation { rundung: Rundung; } +/** Vorgabe aus V70 (AZK): 8 Std./Tag, 100 %, halbe Tage */ export const STANDARD_KALKULATION: Arbeitszeitkalkulation = { stundenProTag: 8, produktivitaet: 1, - rundung: "auf", + rundung: "halb", }; const EPS = 1e-9; -/** Stunden (Dezimalzahl) in Arbeitstage; mindestens 1 Tag, sobald Stunden > 0 sind. */ -export function stundenZuArbeitstagen(stunden: number, k: Arbeitszeitkalkulation = STANDARD_KALKULATION): number { +/** Stunden in Arbeitstage; 0, wenn keine Stunden geplant sind. Personen unter 1 zählen als 1. */ +export function stundenZuArbeitstagen(stunden: number, k: Arbeitszeitkalkulation = STANDARD_KALKULATION, personen = 1): number { if (!(stunden >= 0)) throw new Error(`Ungültige Stunden: ${stunden}`); if (!(k.stundenProTag > 0) || !(k.produktivitaet > 0)) throw new Error("Ungültige Arbeitszeitkalkulation"); if (stunden === 0) return 0; - const roh = stunden / (k.stundenProTag * k.produktivitaet); - let tage: number; + const roh = stunden / (k.stundenProTag * (personen > 0 ? personen : 1) * k.produktivitaet); switch (k.rundung) { - case "auf": - tage = Math.ceil(roh - EPS); - break; - case "kaufmaennisch": - tage = Math.floor(roh + 0.5 + EPS); - break; - case "halbe": - tage = Math.ceil(roh * 2 - EPS) / 2; - break; + case "ganz": + return Math.ceil(roh - EPS); + case "halb": + return Math.ceil(roh * 2 - EPS) / 2; + case "keine": + return Math.round(roh * 100) / 100; } - return Math.max(tage, k.rundung === "halbe" ? 0.5 : 1); } diff --git a/src/domain/liquiditaet.ts b/src/domain/liquiditaet.ts index 4cb3924..b4f996c 100644 --- a/src/domain/liquiditaet.ts +++ b/src/domain/liquiditaet.ts @@ -1,10 +1,14 @@ -// Liquiditätsvorschau je Woche oder Monat. -// Grundregeln aus V70: Zahlungsziele für Kunden und Material, Umsatzsteuer, laufende Kosten. -// Offene V70-Details (Projektpauschale minus Einzelzahlungen, Freitagsregel bei -// Zahlungsterminen) werden mit der V70-Datei abgeglichen und hier ergänzt. +// Liquiditätsvorschau je Woche oder Monat, Regeln wie V70 (lqEvents): +// - Abschläge sind am Vorgangsende fällig, plus Zahlungsziel; der nicht über Abschläge +// abgerechnete Rest des Umsatzes kommt als Schlussrechnung am Projektende plus Zahlungsziel. +// - Pauschale Projektkosten fallen am Projektstart plus Zahlungsziel an; einzeln erfasste +// Kosten mindern die Pauschale anteilig und zählen zu ihrem eigenen Termin. +// - Zahlungstermine sind Kalendertage, die Freitagsregel gilt dafür nicht. +// - Umsatzsteuer: Zahllast je Zeitraum aus der Summe der Nettobeträge, einmal gerundet. +// Laufende Kosten und Startsaldo kommen neu hinzu (in V70 nicht in der Liquidität). import { type Datum, plusTage, plusMonate, montagDerWoche, monatsErster } from "./datum.js"; -import { type Cent, ustAusNetto, summe } from "./geld.js"; +import { type Cent, ustAusNetto, summe, prozentVon } from "./geld.js"; import { type UstEinstellungen, STANDARD_UST, zeitraumVon, faelligkeit } from "./umsatzsteuer.js"; export type Gruppe = "Projekteinnahmen" | "Projektkosten" | "Laufende Kosten" | "Umsatzsteuer"; @@ -49,7 +53,8 @@ export interface Zahlungsziele { sonstigeTage: number; } -export const STANDARD_ZIELE: Zahlungsziele = { kundenTage: 14, materialTage: 30, fremdTage: 14, sonstigeTage: 0 }; +/** Vorgaben aus V70: Kunden 14 Tage, Projektkosten 7 Tage ab Projektstart */ +export const STANDARD_ZIELE: Zahlungsziele = { kundenTage: 14, materialTage: 7, fremdTage: 7, sonstigeTage: 7 }; export interface Vorschau { ansicht: "woche" | "monat"; @@ -125,27 +130,29 @@ export function bewegungen(d: Daten, v: Vorschau, bis: Datum): Posten[] { const ziele = v.ziele ?? STANDARD_ZIELE; const ust = v.ust ?? STANDARD_UST; const posten: Posten[] = []; - const ustJeZeitraum = new Map(); - const buche = (zeitraum: string, betrag: Cent) => ustJeZeitraum.set(zeitraum, (ustJeZeitraum.get(zeitraum) ?? 0) + betrag); + // Nettobasis der Zahllast je Voranmeldungszeitraum: Einnahmen minus Kosten mit Vorsteuer + const basisJeZeitraum = new Map(); + const buche = (zeitraum: string, netto: Cent) => basisJeZeitraum.set(zeitraum, (basisJeZeitraum.get(zeitraum) ?? 0) + netto); for (const e of d.einnahmen) { const steuer = ustAusNetto(e.netto, ust.satz); const zahltag = e.bezahltAm ?? plusTage(e.termin, e.zahlungszielTage ?? ziele.kundenTage); posten.push({ datum: zahltag, gruppe: "Projekteinnahmen", projekt: e.projekt, bezeichnung: e.bezeichnung, betrag: e.netto + steuer }); - buche(zeitraumVon(ust.versteuerung === "ist" ? zahltag : e.termin, ust.voranmeldung), steuer); + buche(zeitraumVon(ust.versteuerung === "ist" ? zahltag : e.termin, ust.voranmeldung), e.netto); } for (const a of d.ausgaben) { const vorsteuer = a.mitVorsteuer === false ? 0 : ustAusNetto(a.netto, ust.satz); const zahltag = plusTage(a.termin, a.zahlungszielTage ?? zielFuer(a.art, ziele)); posten.push({ datum: zahltag, gruppe: "Projektkosten", projekt: a.projekt, bezeichnung: a.bezeichnung, betrag: -(a.netto + vorsteuer) }); - if (vorsteuer) buche(zeitraumVon(a.termin, ust.voranmeldung), -vorsteuer); + if (a.mitVorsteuer !== false) buche(zeitraumVon(ust.versteuerung === "ist" ? zahltag : a.termin, ust.voranmeldung), -a.netto); } for (const k of d.laufend) { for (const t of termineLaufend(k, v.start < k.start ? v.start : k.start, bis)) { posten.push({ datum: t, gruppe: "Laufende Kosten", bezeichnung: k.bezeichnung, betrag: -k.betrag }); } } - for (const [zeitraum, zahllast] of [...ustJeZeitraum].sort()) { + for (const [zeitraum, basis] of [...basisJeZeitraum].sort()) { + const zahllast = prozentVon(basis, ust.satz); if (zahllast === 0) continue; posten.push({ datum: faelligkeit(zeitraum, ust), @@ -157,6 +164,55 @@ export function bewegungen(d: Daten, v: Vorschau, bis: Datum): Posten[] { return posten; } +/** Ein Projekt mit seinen Pauschalen, Zahlungen und einzeln erfassten Kosten. */ +export interface ProjektPlan { + projekt: string; + umsatz: Cent; + material: Cent; + fremd: Cent; + sonstiges: Cent; + /** erster Start und letztes Ende aller Vorgänge und Meilensteine; ohne Termine fließt das Projekt nicht ein */ + zeitraum?: { start: Datum; ende: Datum }; + /** Abschläge (Termin = Vorgangsende) und einzeln erfasste Einnahmen */ + zahlungen: Einnahme[]; + /** einzeln erfasste Kosten, Termin = Zahlungstermin */ + kosten: Ausgabe[]; +} + +function anteilig(betrag: Cent, zaehler: Cent, nenner: Cent): Cent { + if (zaehler === nenner) return betrag; + const z = BigInt(betrag) * BigInt(zaehler); + const n = BigInt(nenner); + return Number((2n * z + n) / (2n * n)); // kaufmännisch, alle Werte ≥ 0 +} + +/** + * Einnahmen und Ausgaben eines Projekts nach den V70-Regeln (Pauschale minus Einzelposten). + * Liefert undefined, wenn das Projekt noch keine Termine hat. + */ +export function projektBewegungen(p: ProjektPlan): { einnahmen: Einnahme[]; ausgaben: Ausgabe[] } | undefined { + if (!p.zeitraum) return undefined; + const einnahmen = [...p.zahlungen]; + const rest = p.umsatz - summe(p.zahlungen.map((z) => z.netto)); + if (rest > 0) einnahmen.push({ projekt: p.projekt, bezeichnung: "Schlussrechnung (Rest)", netto: rest, termin: p.zeitraum.ende }); + + const ausgaben = [...p.kosten]; + const pauschal = p.material + p.fremd + p.sonstiges; + if (pauschal > 0) { + const bleibt = Math.max(0, pauschal - summe(p.kosten.map((k) => k.netto))); + const teile: [Kostenart, Cent, string, boolean][] = [ + ["material", p.material, "Material (Pauschale)", true], + ["fremd", p.fremd, "Fremdleistung (Pauschale)", false], + ["sonstiges", p.sonstiges, "Sonstiges (Pauschale)", false], + ]; + for (const [art, betrag, bezeichnung, mitVorsteuer] of teile) { + const netto = anteilig(betrag, bleibt, pauschal); + if (netto > 0) ausgaben.push({ projekt: p.projekt, bezeichnung, art, netto, termin: p.zeitraum.start, mitVorsteuer }); + } + } + return { einnahmen, ausgaben }; +} + export function liquiditaet(d: Daten, v: Vorschau): Periode[] { const grenzen = periodenGrenzen(v); if (grenzen.length === 0) return []; diff --git a/src/domain/umsatzsteuer.ts b/src/domain/umsatzsteuer.ts index 7ccbba7..1283a51 100644 --- a/src/domain/umsatzsteuer.ts +++ b/src/domain/umsatzsteuer.ts @@ -13,15 +13,16 @@ export interface UstEinstellungen { satz: number; voranmeldung: Voranmeldung; dauerfristverlaengerung: boolean; - /** Soll: nach Rechnungsdatum. Ist: nach Zahlungseingang (offene Entscheidung E5). */ + /** Soll: nach Rechnungsdatum. Ist: nach Zahlungseingang (E5: Ist-Versteuerung). */ versteuerung: Versteuerung; } +/** Ist-Versteuerung (E5), Dauerfristverlängerung wie in V70 */ export const STANDARD_UST: UstEinstellungen = { satz: 19, voranmeldung: "monatlich", - dauerfristverlaengerung: false, - versteuerung: "soll", + dauerfristverlaengerung: true, + versteuerung: "ist", }; /** Schlüssel des Voranmeldungszeitraums, z. B. "2026-03" oder "2026-Q1". */ diff --git a/src/server/einstellungen.ts b/src/server/einstellungen.ts index 5fb091a..e64d3c3 100644 --- a/src/server/einstellungen.ts +++ b/src/server/einstellungen.ts @@ -4,21 +4,24 @@ export const EinstellungenSchema = z.object({ arbeitstage: z.array(z.number().int().min(1).max(7)).default([1, 2, 3, 4]), stundenProTag: z.number().positive().default(8), produktivitaet: z.number().positive().max(1).default(1), - rundung: z.enum(["auf", "kaufmaennisch", "halbe"]).default("auf"), + // ältere Werte aus dem Grundgerüst werden übernommen + rundung: z + .preprocess((v) => ({ auf: "ganz", halbe: "halb", kaufmaennisch: "keine" })[v as string] ?? v, z.enum(["ganz", "halb", "keine"])) + .default("halb"), zahlungsziele: z .object({ kundenTage: z.number().int().min(0).default(14), - materialTage: z.number().int().min(0).default(30), - fremdTage: z.number().int().min(0).default(14), - sonstigeTage: z.number().int().min(0).default(0), + materialTage: z.number().int().min(0).default(7), + fremdTage: z.number().int().min(0).default(7), + sonstigeTage: z.number().int().min(0).default(7), }) .prefault({}), ust: z .object({ satz: z.number().min(0).default(19), voranmeldung: z.enum(["monatlich", "vierteljaehrlich"]).default("monatlich"), - dauerfristverlaengerung: z.boolean().default(false), - versteuerung: z.enum(["soll", "ist"]).default("soll"), + dauerfristverlaengerung: z.boolean().default(true), + versteuerung: z.enum(["soll", "ist"]).default("ist"), }) .prefault({}), startsaldo: z.number().int().default(0), diff --git a/test/geld.test.ts b/test/geld.test.ts index 928d7c5..23aa0cc 100644 --- a/test/geld.test.ts +++ b/test/geld.test.ts @@ -53,21 +53,23 @@ describe("Zahlungsplan P9", () => { }); }); -describe("Stunden in Arbeitstage", () => { - it("rundet auf ganze Tage", () => { +describe("Stunden in Arbeitstage (wie V70)", () => { + const k = (rundung: "ganz" | "halb" | "keine", produktivitaet = 1) => ({ stundenProTag: 8, produktivitaet, rundung }); + it("Vorgabe: halbe Tage, wie die Projekte in der V70-Sicherung", () => { expect(stundenZuArbeitstagen(0)).toBe(0); - expect(stundenZuArbeitstagen(1)).toBe(1); - expect(stundenZuArbeitstagen(8)).toBe(1); - expect(stundenZuArbeitstagen(8.5)).toBe(2); - expect(stundenZuArbeitstagen(24)).toBe(3); + expect(stundenZuArbeitstagen(17)).toBe(2.5); // Staubschutzmaßnahme + expect(stundenZuArbeitstagen(60)).toBe(7.5); // Aufstockung + expect(stundenZuArbeitstagen(225)).toBe(28.5); // Fassade EFH + expect(stundenZuArbeitstagen(144, undefined, 2)).toBe(9); // Trockenbau, 2 Personen + expect(stundenZuArbeitstagen(110, undefined, 2)).toBe(7); // Unterstellplatz, 2 Personen }); - it("Produktivität verlängert", () => { - expect(stundenZuArbeitstagen(24, { stundenProTag: 8, produktivitaet: 0.75, rundung: "auf" })).toBe(4); - expect(stundenZuArbeitstagen(0.3 * 8 * 10, { stundenProTag: 8, produktivitaet: 0.3, rundung: "auf" })).toBe(10); + it("ganze Tage und Produktivität", () => { + expect(stundenZuArbeitstagen(8.5, k("ganz"))).toBe(2); + expect(stundenZuArbeitstagen(24, k("ganz", 0.75))).toBe(4); + expect(stundenZuArbeitstagen(0.3 * 8 * 10, k("ganz", 0.3))).toBe(10); }); - it("halbe Tage und kaufmännisch", () => { - expect(stundenZuArbeitstagen(10, { stundenProTag: 8, produktivitaet: 1, rundung: "halbe" })).toBe(1.5); - expect(stundenZuArbeitstagen(11, { stundenProTag: 8, produktivitaet: 1, rundung: "kaufmaennisch" })).toBe(1); - expect(stundenZuArbeitstagen(12, { stundenProTag: 8, produktivitaet: 1, rundung: "kaufmaennisch" })).toBe(2); + it("keine Rundung: zwei Nachkommastellen", () => { + expect(stundenZuArbeitstagen(10, k("keine"))).toBe(1.25); + expect(stundenZuArbeitstagen(10, k("keine"), 3)).toBe(0.42); }); }); diff --git a/test/liquiditaet.test.ts b/test/liquiditaet.test.ts index 84e7b28..f0cba0b 100644 --- a/test/liquiditaet.test.ts +++ b/test/liquiditaet.test.ts @@ -1,5 +1,5 @@ import { describe, it, expect } from "vitest"; -import { liquiditaet, periodenGrenzen, termineLaufend } from "../src/domain/liquiditaet.js"; +import { liquiditaet, periodenGrenzen, termineLaufend, projektBewegungen, type ProjektPlan } from "../src/domain/liquiditaet.js"; import { faelligkeit, zeitraumVon } from "../src/domain/umsatzsteuer.js"; describe("Umsatzsteuer-Fälligkeit", () => { @@ -41,26 +41,46 @@ describe("Perioden", () => { describe("Liquiditätsvorschau", () => { const vorschau = { ansicht: "monat" as const, start: "2026-11-01", anzahl: 3, startsaldo: 1_000_000 }; - it("rechnet Einnahmen, Kosten, laufende Kosten und USt centgenau", () => { - const p = liquiditaet( - { - einnahmen: [{ projekt: "26-01", bezeichnung: "Anzahlung", netto: 3_000_000, termin: "2026-11-02" }], - ausgaben: [{ projekt: "26-01", bezeichnung: "KVH", art: "material", netto: 1_000_000, termin: "2026-11-05" }], - laufend: [{ bezeichnung: "Miete", betrag: 80_000, rhythmus: "monatlich", start: "2026-01-03" }], - }, - vorschau, - ); - // November: Anzahlung 35.700 € (Ziel 14 Tage), Miete -800 € + 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[0]!.kontostand).toBe(1_000_000 + 3_570_000 - 80_000); - // Dezember: Material 11.900 € (Ziel 30 Tage -> 05.12.), Miete, USt Nov (5.700 - 1.900 = 3.800) am 10.12. 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], ]); - expect(p[2]!.kontostand).toBe(1_000_000 + 3_570_000 - 1_190_000 - 380_000 - 3 * 80_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", () => { @@ -80,3 +100,41 @@ describe("Liquiditätsvorschau", () => { 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 fließt das Projekt nicht ein", () => { + expect(projektBewegungen({ ...plan, zeitraum: undefined })).toBeUndefined(); + }); +});