Rechenregeln wie V70: halbe Tage, Ziele 14/7, Ist-Versteuerung, Pauschale minus Einzelposten

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-19 05:16:20 +00:00
parent d6e0ee2270
commit 639980a4d1
6 changed files with 182 additions and 65 deletions

View File

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

View File

@@ -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<string, Cent>();
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<string, Cent>();
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 [];

View File

@@ -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". */

View File

@@ -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),