// Abarbeitungsgrad im Terminplan (Henning, 20.10.2026): je Vorgang „% erledigt“, daraus der Stand von Abschnitt // und Projekt (gewichtet nach Stunden) und die Warnung „im Verzug“, wenn weniger erledigt ist als nach dem Kalender // zu erwarten. Grundlage auch für Abschläge nach Abarbeitungsstand (E24). import { type Datum, plusTage } from "./datum.js"; import { type Arbeitswoche, arbeitstageZwischen, wocheVon } from "./kalender.js"; /** Ab so vielen Prozentpunkten Rückstand gilt ein Vorgang als im Verzug */ export const VERZUG_AB = 10; interface FVorgang { anfang: Datum; ende: Datum; dauer: number; stunden?: number | null; fortschritt?: number | null; freitage?: Datum[] | null; } /** Wie viel Prozent bis gestern geschafft sein sollten (gleichmäßig über die Arbeitstage verteilt) */ export function sollFortschritt(v: FVorgang, heute: Datum, woche: Arbeitswoche): number { if (v.anfang >= heute) return 0; if (v.ende < heute) return 100; const w = wocheVon(v, woche); const gesamt = arbeitstageZwischen(v.anfang, v.ende, w); if (gesamt <= 0) return 100; return Math.round((arbeitstageZwischen(v.anfang, plusTage(heute, -1), w) / gesamt) * 100); } /** Im Verzug: Ende überschritten und nicht fertig, oder deutlich weniger erledigt als erwartet */ export function imVerzug(v: FVorgang, heute: Datum, woche: Arbeitswoche): boolean { const ist = v.fortschritt ?? 0; if (ist >= 100) return false; if (v.ende < heute) return true; return sollFortschritt(v, heute, woche) - ist >= VERZUG_AB; } /** * Stand mehrerer Vorgänge (Abschnitt, Projekt): nach Stunden gewichtet, ohne Stunden nach Dauer; * nur Meilensteine zählen gleich. Ohne Vorgänge null. */ export function gesamtFortschritt(vs: FVorgang[]): number | null { if (!vs.length) return null; const gewicht = (v: FVorgang) => (Number(v.stunden) > 0 ? Number(v.stunden) : v.dauer > 0 ? v.dauer : 0); const summe = vs.reduce((s, v) => s + gewicht(v), 0); if (summe <= 0) return Math.round(vs.reduce((s, v) => s + (v.fortschritt ?? 0), 0) / vs.length); return Math.round(vs.reduce((s, v) => s + gewicht(v) * (v.fortschritt ?? 0), 0) / summe); }