Files
Betriebsf-hrungssoftware/src/domain/personal.ts
Claude 8634791c68
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
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
2026-10-20 06:52:48 +00:00

132 lines
5.6 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// M8: Arbeitszeitmodell je Person mit Gültig-ab-Datum, M4: Abwesenheiten, M10: Urlaubskonto.
// Grundlage für Zeiterfassung (Soll), Dauer aus Verfügbarkeit (T15) und Auslastung (T16).
import { type Datum, jahrVon, plusTage, wochentag } from "./datum.js";
import { feiertag } from "./kalender.js";
export interface Modell {
kontakt_id: string;
gueltig_ab: Datum;
/** Stunden Mo … So */
stunden: number[];
}
export type AbwesenheitArt = "urlaub" | "krank" | "schule" | "frei" | "sperre";
export interface Abwesenheit {
id?: string;
kontakt_id: string;
art: AbwesenheitArt;
von: Datum;
bis: Datum;
/** halber Urlaubstag (nur bei einem einzelnen Tag) */
halbtag?: boolean;
/** stundengenau, z. B. „Do nur bis 12 Uhr“ oder Arzttermin: so viele Stunden fehlen je Tag; leer = ganzer Tag */
stunden?: number | null;
status: "beantragt" | "genehmigt" | "abgelehnt";
}
export const ABWESENHEIT_TEXT: Record<AbwesenheitArt, string> = {
urlaub: "Urlaub", krank: "Krank", schule: "Berufsschule", frei: "Frei", sperre: "Nicht verfügbar",
};
/** Ohne eigenes Modell: Mo–Fr je stundenProTag (Vorgabe 8) */
export const standardStunden = (stundenProTag = 8): number[] => [1, 2, 3, 4, 5, 6, 7].map((t) => (t <= 5 ? stundenProTag : 0));
/** Das Modell, das an einem Tag gilt: das mit dem spätesten Gültig-ab bis zu diesem Tag */
export function modellAm(modelle: Modell[], kontaktId: string, d: Datum): Modell | undefined {
let treffer: Modell | undefined;
for (const m of modelle) {
if (m.kontakt_id !== kontaktId || m.gueltig_ab > d) continue;
if (!treffer || m.gueltig_ab > treffer.gueltig_ab) treffer = m;
}
return treffer;
}
/** 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));
if (a.halbtag) return soll / 2;
return soll;
}
/** Wirksame Abwesenheiten: genehmigt. Beantragter Urlaub sperrt noch nicht (M10). */
export const wirksam = (a: Abwesenheit) => a.status === "genehmigt";
export interface Tag {
datum: Datum;
soll: number;
frei: number;
/** Abwesenheiten an diesem Tag, wirksame zuerst */
abwesend: Abwesenheit[];
feiertag?: string;
}
/** Verfügbarkeit einer Person je Tag im Zeitraum */
export function verfuegbarkeit(modelle: Modell[], abwesenheiten: Abwesenheit[], kontaktId: string, von: Datum, bis: Datum, stundenProTag = 8): Tag[] {
const eigene = abwesenheiten.filter((a) => a.kontakt_id === kontaktId && a.status !== "abgelehnt" && a.bis >= von && a.von <= bis);
const aus: Tag[] = [];
for (let d = von; d <= bis; d = plusTage(d, 1)) {
const soll = sollStunden(modelle, kontaktId, d, stundenProTag);
const heute = eigene.filter((a) => a.von <= d && a.bis >= d).sort((a, b) => Number(wirksam(b)) - Number(wirksam(a)));
const weg = heute.filter(wirksam).reduce((s, a) => s + abwesendStunden(a, soll), 0);
aus.push({ datum: d, soll, frei: Math.max(0, soll - weg), abwesend: heute, feiertag: feiertag(d)?.name });
}
return aus;
}
/** Urlaubstage einer Abwesenheit in einem Jahr: Tage mit Soll > 0 (keine Feiertage, keine freien Tage), halber Tag = 0,5 */
export function urlaubstage(a: Abwesenheit, modelle: Modell[], jahr: number, stundenProTag = 8, nurBis?: Datum, nurAb?: Datum): number {
let n = 0;
for (let d = a.von; d <= a.bis; d = plusTage(d, 1)) {
if (jahrVon(d) !== jahr || (nurBis && d > nurBis) || (nurAb && d < nurAb)) continue;
if (sollStunden(modelle, a.kontakt_id, d, stundenProTag) > 0) n += a.halbtag ? 0.5 : 1;
}
return n;
}
export interface Urlaubskonto {
jahr: number;
anspruch: number;
uebertrag: number;
/** genehmigt und schon vorbei (bis einschließlich heute) */
genommen: number;
/** genehmigt und noch in der Zukunft */
geplant: number;
beantragt: number;
rest: number;
}
export function urlaubskonto(kontaktId: string, jahr: number, heute: Datum, anspruch: number, uebertrag: number,
abwesenheiten: Abwesenheit[], modelle: Modell[], stundenProTag = 8): Urlaubskonto {
const urlaub = abwesenheiten.filter((a) => a.kontakt_id === kontaktId && a.art === "urlaub");
let genommen = 0, geplant = 0, beantragt = 0;
const morgen = plusTage(heute, 1);
for (const a of urlaub) {
if (a.status === "genehmigt") {
genommen += urlaubstage(a, modelle, jahr, stundenProTag, heute);
geplant += urlaubstage(a, modelle, jahr, stundenProTag, undefined, morgen);
} else if (a.status === "beantragt") beantragt += urlaubstage(a, modelle, jahr, stundenProTag);
}
return { jahr, anspruch, uebertrag, genommen, geplant, beantragt, rest: anspruch + uebertrag - genommen - geplant };
}
/** „Mo 8 · Di 8 · Mi 8 · Do 8 · Fr 6 = 38 Std.“ ohne freie Tage */
export function modellText(stunden: number[]): string {
const namen = ["Mo", "Di", "Mi", "Do", "Fr", "Sa", "So"];
const zahl = (h: number) => String(h).replace(".", ",");
const teile = stunden.map((h, i) => (h > 0 ? `${namen[i]} ${zahl(h)}` : "")).filter(Boolean);
return `${teile.join(" · ")} = ${zahl(stunden.reduce((s, h) => s + h, 0))} Std.`;
}