Files
Betriebsf-hrungssoftware/src/domain/kapazitaet.ts
Claude d5f861318b
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
Terminplan: Dauer aus Stunden und Besetzung, Auslastung je Woche (0.12.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-10-20 07:12:26 +00:00

124 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.
// T15: Dauer eines Vorgangs aus seinen Stunden und der tatsächlich verfügbaren Zeit der eingeteilten Personen
// (Arbeitszeitmodell M8, Abwesenheiten M4, Feiertage). T16: Auslastung je Woche, geplant gegen verfügbar.
// Geplant wird im Firmenkalender (Mo–Do); der Freitag bleibt Reserve und zählt nicht mit.
import { type Datum, montagDerWoche, plusTage } from "./datum.js";
import { type Arbeitswoche, feiertag, istArbeitstag, naechsterArbeitstag } from "./kalender.js";
import { type Abwesenheit, type Modell, abwesendStunden, sollStunden, wirksam } from "./personal.js";
export interface KapBesetzung {
vorgang_id: string;
kontakt_id?: string | null;
platzhalter?: string | null;
personen: number;
}
export interface Personaldaten {
modelle: Modell[];
abwesenheiten: Abwesenheit[];
stundenProTag: number;
}
const EPS = 1e-9;
/** Freie Stunden einer Person an einem Tag: Soll laut Modell (Feiertag 0) minus genehmigte Abwesenheiten */
export function freiAm(p: Personaldaten, kontaktId: string, d: Datum): number {
const soll = sollStunden(p.modelle, kontaktId, d, p.stundenProTag);
if (soll <= 0) return 0;
let weg = 0;
for (const a of p.abwesenheiten) if (a.kontakt_id === kontaktId && wirksam(a) && a.von <= d && a.bis >= d) weg += abwesendStunden(a, soll);
return Math.max(0, soll - weg);
}
/** Stunden, die eine Besetzung an einem Tag leistet: voll ohne Abwesenheiten, frei mit. Platzhalter rechnen mit Stunden pro Tag. */
export function leistung(p: Personaldaten, b: Pick<KapBesetzung, "kontakt_id" | "personen">, d: Datum): { voll: number; frei: number } {
const n = Number(b.personen) > 0 ? Number(b.personen) : 1;
if (!b.kontakt_id) {
const h = feiertag(d) ? 0 : p.stundenProTag * n;
return { voll: h, frei: h };
}
return { voll: sollStunden(p.modelle, b.kontakt_id, d, p.stundenProTag) * n, frei: freiAm(p, b.kontakt_id, d) * n };
}
/** Höchstens so viele Arbeitstage wird gesucht; wer länger nicht verfügbar ist, bekommt keine berechnete Dauer */
const MAX_TAGE = 260;
/**
* Arbeitstage, bis die Stunden geleistet sind. Tage ohne Kapazität (Urlaub aller Eingeteilten) liegen im Balken
* und zählen mit. Der letzte Tag zählt halb, wenn höchstens die Hälfte gebraucht wird. undefined ohne Kapazität.
*/
export function dauerAusKapazitaet(start: Datum, stunden: number, kapazitaet: (d: Datum) => number, woche: Arbeitswoche): number | undefined {
if (!(stunden > 0)) return undefined;
let rest = stunden;
let d = naechsterArbeitstag(start, woche);
for (let n = 0; n < MAX_TAGE; n++) {
const k = kapazitaet(d);
if (k > EPS) {
if (rest <= k + EPS) return n + (rest / k <= 0.5 + EPS ? 0.5 : 1);
rest -= k;
}
d = naechsterArbeitstag(plusTage(d, 1), woche);
}
return undefined;
}
/** Dauer eines Vorgangs nach seiner Besetzung; undefined ohne Stunden oder ohne Besetzung */
export function dauerNachBesetzung(v: { id: string; start: Datum; stunden?: number | null }, besetzungen: KapBesetzung[], p: Personaldaten, woche: Arbeitswoche): number | undefined {
const bs = besetzungen.filter((b) => b.vorgang_id === v.id);
if (!bs.length || !(Number(v.stunden) > 0)) return undefined;
return dauerAusKapazitaet(v.start, Number(v.stunden), (d) => bs.reduce((s, b) => s + leistung(p, b, d).frei, 0), woche);
}
/** Tage im Vorgang, an denen die Besetzung nicht voll da ist (Balken heller) */
export function reduzierteTage(v: { id: string; anfang: Datum; ende: Datum }, besetzungen: KapBesetzung[], p: Personaldaten, woche: Arbeitswoche): Datum[] {
const bs = besetzungen.filter((b) => b.vorgang_id === v.id && b.kontakt_id);
if (!bs.length) return [];
const aus: Datum[] = [];
for (let d = v.anfang; d <= v.ende; d = plusTage(d, 1)) {
if (!istArbeitstag(d, woche)) continue;
let voll = 0, frei = 0;
for (const b of bs) { const l = leistung(p, b, d); voll += l.voll; frei += l.frei; }
if (frei < voll - EPS) aus.push(d);
}
return aus;
}
export interface Woche {
/** Montag */
ab: Datum;
geplant: number;
verfuegbar: number;
personen: { kontakt_id: string; geplant: number; verfuegbar: number }[];
}
/**
* T16: je Woche die Stunden, für die das Team eingeplant ist (je Vorgang und Tag das Soll der Person, Urlaub nicht
* abgezogen, damit Einplanung im Urlaub als Überplanung auffällt), gegen die verfügbaren Stunden (Urlaub abgezogen).
*/
export function auslastung(von: Datum, bis: Datum, team: string[], vorgaenge: { id: string; anfang: Datum; ende: Datum; dauer: number }[],
besetzungen: KapBesetzung[], p: Personaldaten, woche: Arbeitswoche): Woche[] {
const imTeam = new Set(team);
const eigene = besetzungen.filter((b) => b.kontakt_id && imTeam.has(b.kontakt_id));
const vById = new Map(vorgaenge.filter((v) => Number(v.dauer) > 0).map((v) => [v.id, v]));
const wochen = new Map<Datum, Woche>();
for (let d = von; d <= bis; d = plusTage(d, 1)) {
if (!istArbeitstag(d, woche)) continue;
const ab = montagDerWoche(d);
let w = wochen.get(ab);
if (!w) wochen.set(ab, (w = { ab, geplant: 0, verfuegbar: 0, personen: team.map((kontakt_id) => ({ kontakt_id, geplant: 0, verfuegbar: 0 })) }));
for (const pers of w.personen) {
const f = freiAm(p, pers.kontakt_id, d);
pers.verfuegbar += f;
w.verfuegbar += f;
}
for (const b of eigene) {
const v = vById.get(b.vorgang_id);
if (!v || v.anfang > d || v.ende < d) continue;
const h = sollStunden(p.modelle, b.kontakt_id!, d, p.stundenProTag) * (Number(b.personen) > 0 ? Number(b.personen) : 1);
w.personen.find((x) => x.kontakt_id === b.kontakt_id)!.geplant += h;
w.geplant += h;
}
}
return [...wochen.values()];
}