Stundenliste fürs Steuerbüro als CSV (0.10.0)
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:
@@ -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
123
src/domain/stundenliste.ts
Normal 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";
|
||||
}
|
||||
Reference in New Issue
Block a user