Files
Betriebsf-hrungssoftware/src/domain/fortschritt.ts
Claude feb19241c5
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
0.19.0: einzelne Freitage je Vorgang freigeben
Nur für diesen Vorgang zählt der Freitag als Arbeitstag (Dauer, Ende, Nachfolger,
Auslastung, Kalender-Abo, Wer macht was, Einsätze am Handy).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-10-21 16:34:10 +00:00

48 lines
2.1 KiB
TypeScript

// 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);
}