Personal: Stammdaten, Arbeitszeitmodell, Abwesenheiten, Urlaubskonto (0.8.0)
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

Stufe 2, Schritt 2 (M1, M8, M4, M10-Konto). Modelle mit Gültig-ab, Abwesenheiten
ganztags, halbtags oder stundengenau, Verfügbarkeit je Tag als Grundlage für
T15/T16. Lohnkosten je Stunde nur für den Inhaber (nurInhaber in TABELLEN).

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:33:33 +00:00
parent bc5e15339a
commit 859a076e83
13 changed files with 709 additions and 9 deletions

127
src/domain/personal.ts Normal file
View File

@@ -0,0 +1,127 @@
// 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;
}
/** Vertragliche Stunden an einem Tag (Feiertage 0) */
export function sollStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
if (feiertag(d)) return 0;
const m = modellAm(modelle, kontaktId, d);
return (m?.stunden ?? standardStunden(stundenProTag))[wochentag(d) - 1] ?? 0;
}
/** 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.`;
}