Personal: Stammdaten, Arbeitszeitmodell, Abwesenheiten, Urlaubskonto (0.8.0)
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:
127
src/domain/personal.ts
Normal file
127
src/domain/personal.ts
Normal 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.`;
|
||||
}
|
||||
Reference in New Issue
Block a user