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:
@@ -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);
|
||||
}
|
||||
|
||||
@@ -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 [];
|
||||
|
||||
@@ -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". */
|
||||
|
||||
@@ -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),
|
||||
|
||||
Reference in New Issue
Block a user