Stufe 0: Grundgerüst mit Rechenkern, Datenbank, Oberfläche und Docker-Betrieb

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-17 16:37:54 +00:00
commit 92d26baa4b
45 changed files with 6143 additions and 0 deletions

173
src/domain/liquiditaet.ts Normal file
View File

@@ -0,0 +1,173 @@
// 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.
import { type Datum, plusTage, plusMonate, montagDerWoche, monatsErster } from "./datum.js";
import { type Cent, ustAusNetto, summe } from "./geld.js";
import { type UstEinstellungen, STANDARD_UST, zeitraumVon, faelligkeit } from "./umsatzsteuer.js";
export type Gruppe = "Projekteinnahmen" | "Projektkosten" | "Laufende Kosten" | "Umsatzsteuer";
export type Kostenart = "material" | "fremd" | "sonstiges";
export type Rhythmus = "einmalig" | "monatlich" | "vierteljaehrlich" | "jaehrlich";
export interface Einnahme {
projekt?: string;
bezeichnung: string;
netto: Cent;
/** Rechnungs- bzw. geplanter Termin */
termin: Datum;
zahlungszielTage?: number;
bezahltAm?: Datum;
}
export interface Ausgabe {
projekt?: string;
bezeichnung: string;
art: Kostenart;
netto: Cent;
termin: Datum;
zahlungszielTage?: number;
/** false z. B. bei Subunternehmern im Reverse-Charge oder Kleinunternehmern */
mitVorsteuer?: boolean;
}
export interface LaufendeKosten {
bezeichnung: string;
kategorie?: string;
/** Betrag, der vom Konto abgeht */
betrag: Cent;
rhythmus: Rhythmus;
start: Datum;
ende?: Datum;
}
export interface Zahlungsziele {
kundenTage: number;
materialTage: number;
fremdTage: number;
sonstigeTage: number;
}
export const STANDARD_ZIELE: Zahlungsziele = { kundenTage: 14, materialTage: 30, fremdTage: 14, sonstigeTage: 0 };
export interface Vorschau {
ansicht: "woche" | "monat";
start: Datum;
anzahl: number;
startsaldo: Cent;
ziele?: Zahlungsziele;
ust?: UstEinstellungen;
}
export interface Posten {
datum: Datum;
gruppe: Gruppe;
projekt?: string;
bezeichnung: string;
/** positiv = Eingang, negativ = Ausgang */
betrag: Cent;
}
export interface Periode {
von: Datum;
bis: Datum;
einnahmen: Cent;
ausgaben: Cent;
saldo: Cent;
kontostand: Cent;
posten: Posten[];
}
function zielFuer(art: Kostenart, z: Zahlungsziele): number {
return art === "material" ? z.materialTage : art === "fremd" ? z.fremdTage : z.sonstigeTage;
}
const MONATE_JE_RHYTHMUS: Record<Exclude<Rhythmus, "einmalig">, number> = {
monatlich: 1,
vierteljaehrlich: 3,
jaehrlich: 12,
};
/** Alle Termine einer laufenden Kostenposition zwischen von und bis (eingeschlossen). */
export function termineLaufend(k: LaufendeKosten, von: Datum, bis: Datum): Datum[] {
if (k.rhythmus === "einmalig") return k.start >= von && k.start <= bis ? [k.start] : [];
const schritt = MONATE_JE_RHYTHMUS[k.rhythmus];
const ende = k.ende && k.ende < bis ? k.ende : bis;
const termine: Datum[] = [];
for (let i = 0; ; i++) {
const t = plusMonate(k.start, i * schritt);
if (t > ende) break;
if (t >= von) termine.push(t);
}
return termine;
}
export function periodenGrenzen(v: Pick<Vorschau, "ansicht" | "start" | "anzahl">): { von: Datum; bis: Datum }[] {
const grenzen: { von: Datum; bis: Datum }[] = [];
let von = v.ansicht === "woche" ? montagDerWoche(v.start) : monatsErster(v.start);
for (let i = 0; i < v.anzahl; i++) {
const naechste = v.ansicht === "woche" ? plusTage(von, 7) : plusMonate(von, 1);
grenzen.push({ von, bis: plusTage(naechste, -1) });
von = naechste;
}
return grenzen;
}
export interface Daten {
einnahmen: Einnahme[];
ausgaben: Ausgabe[];
laufend: LaufendeKosten[];
}
/** Alle Zahlungsbewegungen mit ihrem Zahltag, ohne Zeitraumfilter (außer laufende Kosten). */
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);
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);
}
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);
}
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()) {
if (zahllast === 0) continue;
posten.push({
datum: faelligkeit(zeitraum, ust),
gruppe: "Umsatzsteuer",
bezeichnung: `${zahllast > 0 ? "USt-Vorauszahlung" : "USt-Erstattung"} ${zeitraum}`,
betrag: -zahllast,
});
}
return posten;
}
export function liquiditaet(d: Daten, v: Vorschau): Periode[] {
const grenzen = periodenGrenzen(v);
if (grenzen.length === 0) return [];
const alle = bewegungen(d, v, grenzen[grenzen.length - 1]!.bis);
let kontostand = v.startsaldo;
return grenzen.map(({ von, bis }) => {
const posten = alle.filter((p) => p.datum >= von && p.datum <= bis).sort((a, b) => a.datum.localeCompare(b.datum));
const einnahmen = summe(posten.filter((p) => p.betrag > 0).map((p) => p.betrag));
const ausgaben = summe(posten.filter((p) => p.betrag < 0).map((p) => p.betrag));
const saldo = einnahmen + ausgaben;
kontostand += saldo;
return { von, bis, einnahmen, ausgaben, saldo, kontostand, posten };
});
}