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:
173
src/domain/liquiditaet.ts
Normal file
173
src/domain/liquiditaet.ts
Normal 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 };
|
||||
});
|
||||
}
|
||||
Reference in New Issue
Block a user