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,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 [];