Stundenliste fürs Steuerbüro als CSV (0.10.0)
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

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-20 06:52:48 +00:00
parent e4754f329a
commit 8634791c68
10 changed files with 285 additions and 19 deletions

View File

@@ -43,13 +43,17 @@ export function modellAm(modelle: Modell[], kontaktId: string, d: Datum): Modell
return treffer;
}
/** Vertragliche Stunden an einem Tag (Feiertage 0) */
export function sollStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
if (feiertag(d)) return 0;
/** Stunden laut Arbeitszeitmodell, auch an Feiertagen (für die Feiertagsvergütung) */
export function vertragsStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
const m = modellAm(modelle, kontaktId, d);
return (m?.stunden ?? standardStunden(stundenProTag))[wochentag(d) - 1] ?? 0;
}
/** Vertragliche Stunden an einem Tag (Feiertage 0) */
export function sollStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
return feiertag(d) ? 0 : vertragsStunden(modelle, kontaktId, d, stundenProTag);
}
/** Stunden, die eine Abwesenheit an einem Tag wegnimmt, höchstens das Soll */
export function abwesendStunden(a: Abwesenheit, soll: number): number {
if (a.stunden != null) return Math.min(soll, Math.max(0, a.stunden));

123
src/domain/stundenliste.ts Normal file
View File

@@ -0,0 +1,123 @@
// M5: Stundenliste für das Steuerbüro (Herr Seeler macht die Lohnabrechnung).
// Ein Monat, je angestelltem Mitarbeiter eine Zeile je Tag mit Arbeit, Abwesenheit oder Feiertag und eine Summenzeile.
// Für Excel: Semikolon, Dezimalkomma, UTF-8 mit BOM.
import { type Datum, formatDatum, plusTage, wochentag } from "./datum.js";
import { feiertag } from "./kalender.js";
import { type Abwesenheit, ABWESENHEIT_TEXT, type AbwesenheitArt, type Modell, abwesendStunden, vertragsStunden, wirksam } from "./personal.js";
export interface Person {
kontakt_id: string;
name: string;
personalnummer?: string | null;
eintritt?: Datum | null;
austritt?: Datum | null;
}
export interface Buchung {
kontakt_id: string;
datum: Datum;
beginn: string;
ende: string;
/** von Hand eingetragene Pause plus Abzug nach M3 */
pause_min: number;
netto_min: number;
baustellen: string;
notiz?: string | null;
}
export interface Summe {
ist: number;
soll: number;
abwesend: number;
/** Ist + Abwesend − Soll */
saldo: number;
/** Tage je Art, Feiertage unter "feiertag" */
tage: Partial<Record<AbwesenheitArt | "feiertag", number>>;
}
const WOCHENTAGE = ["Mo", "Di", "Mi", "Do", "Fr", "Sa", "So"];
const KOPF = ["Personalnr.", "Name", "Datum", "Tag", "Beginn", "Ende", "Pause Min.", "Arbeitszeit Std.", "Soll Std.",
"Abwesenheit", "Abwesend Std.", "Baustellen", "Bemerkung"];
export const zahl = (h: number) => (Math.round(h * 100) / 100).toFixed(2).replace(".", ",");
const feld = (x: string | number) => {
const s = String(x);
return /[;"\n\r]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
};
const zeile = (werte: (string | number)[]) => werte.map(feld).join(";");
export function monatsletzter(monat: string): Datum {
const [j, m] = monat.split("-").map(Number) as [number, number];
return plusTage(`${m === 12 ? j + 1 : j}-${String(m === 12 ? 1 : m + 1).padStart(2, "0")}-01`, -1);
}
const TAGE_TEXT: [AbwesenheitArt | "feiertag", string, string][] = [
["urlaub", "Urlaub", "Urlaub"], ["krank", "Krank", "Krank"], ["schule", "Berufsschule", "Berufsschule"],
["feiertag", "Feiertag", "Feiertage"], ["frei", "Frei", "Frei"], ["sperre", "Nicht verfügbar", "Nicht verfügbar"],
];
export function tageText(tage: Summe["tage"]): string {
return TAGE_TEXT.filter(([k]) => tage[k]).map(([k, eins, mehr]) => {
const n = tage[k]!;
return `${eins === mehr || n === 1 ? eins : mehr} ${zahl(n).replace(/,00$/, "").replace(/,50$/, ",5")} ${n === 1 ? "Tag" : "Tage"}`;
}).join(", ");
}
/** Die Zeilen einer Person; leere Tage (kein Soll, nichts gebucht) fallen weg */
export function personMonat(p: Person, monat: string, buchungen: Buchung[], modelle: Modell[], abwesenheiten: Abwesenheit[], stundenProTag = 8, stichtag?: Datum) {
const von = `${monat}-01`, letzter = monatsletzter(monat);
const bis = stichtag && stichtag < letzter ? stichtag : letzter;
const zeilen: string[][] = [];
const s: Summe = { ist: 0, soll: 0, abwesend: 0, saldo: 0, tage: {} };
const eigene = abwesenheiten.filter((a) => a.kontakt_id === p.kontakt_id && wirksam(a));
for (let d = von; d <= bis; d = plusTage(d, 1)) {
const beschaeftigt = (!p.eintritt || d >= p.eintritt) && (!p.austritt || d <= p.austritt);
const vertrag = beschaeftigt ? vertragsStunden(modelle, p.kontakt_id, d, stundenProTag) : 0;
const b = buchungen.find((x) => x.kontakt_id === p.kontakt_id && x.datum === d);
const ft = feiertag(d);
const weg: [string, number][] = [];
if (ft && vertrag > 0) {
weg.push([`Feiertag (${ft.name})`, vertrag]);
s.tage.feiertag = (s.tage.feiertag ?? 0) + 1;
} else if (vertrag > 0) {
for (const a of eigene.filter((x) => x.von <= d && x.bis >= d)) {
const h = abwesendStunden(a, vertrag);
if (h <= 0) continue;
weg.push([`${ABWESENHEIT_TEXT[a.art]}${a.halbtag ? " (halber Tag)" : a.stunden != null ? " (stundenweise)" : ""}`, h]);
s.tage[a.art] = (s.tage[a.art] ?? 0) + (a.stunden != null ? 0 : a.halbtag ? 0.5 : 1);
}
}
if (!b && !weg.length) {
s.soll += vertrag; // fehlende Buchung an einem Arbeitstag zählt als Minus
if (vertrag > 0) zeilen.push([p.personalnummer ?? "", p.name, formatDatum(d), WOCHENTAGE[wochentag(d) - 1]!, "", "", "", zahl(0), zahl(vertrag), "", "", "", "nichts gebucht"]);
continue;
}
const abw = Math.min(vertrag, weg.reduce((x, [, h]) => x + h, 0));
const ist = b ? b.netto_min / 60 : 0;
s.ist += ist; s.soll += vertrag; s.abwesend += abw;
zeilen.push([p.personalnummer ?? "", p.name, formatDatum(d), WOCHENTAGE[wochentag(d) - 1]!,
b?.beginn ?? "", b?.ende ?? "", b ? String(b.pause_min) : "", zahl(ist), zahl(vertrag),
weg.map(([t]) => t).join(", "), weg.length ? zahl(abw) : "", b?.baustellen ?? "", b?.notiz ?? ""]);
}
s.saldo = s.ist + s.abwesend - s.soll;
return { zeilen, summe: s };
}
/**
* Die ganze Liste. „nichts gebucht“ markiert Arbeitstage ohne Buchung und ohne Abwesenheit, damit nichts unbemerkt fehlt.
* Im laufenden Monat endet die Liste am Stichtag (heute), damit Soll und Saldo stimmen.
*/
export function stundenCsv(monat: string, personen: Person[], buchungen: Buchung[], modelle: Modell[], abwesenheiten: Abwesenheit[],
stundenProTag = 8, stichtag?: Datum): string {
const out = [zeile(KOPF)];
for (const p of personen) {
const { zeilen, summe } = personMonat(p, monat, buchungen, modelle, abwesenheiten, stundenProTag, stichtag);
if (!zeilen.length) continue;
out.push(...zeilen.map(zeile));
const [j, m] = monat.split("-");
out.push(zeile([p.personalnummer ?? "", p.name, `Summe ${m}/${j}`, "", "", "", "", zahl(summe.ist), zahl(summe.soll),
tageText(summe.tage), zahl(summe.abwesend), `Mehr-/Minderstunden ${summe.saldo >= 0 ? "+" : ""}${zahl(summe.saldo)}`, ""]));
out.push("");
}
return "" + out.join("\r\n") + "\r\n";
}