0.19.0: einzelne Freitage je Vorgang freigeben
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

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
This commit is contained in:
Claude
2026-10-21 16:34:10 +00:00
parent b2624e48e8
commit feb19241c5
31 changed files with 186 additions and 59 deletions

View File

@@ -18,7 +18,8 @@ export interface Bezug {
/** Datum, das sich aus dem Vorgang ergibt */
export function bezugsTermin(v: PlanVorgang, art: BezugArt, tage: number, woche: Arbeitswoche): Datum {
const d = art === "AA" ? anfang(v, woche) : ende(v, woche);
return tage === 0 ? naechsterArbeitstag(d, woche) : verschiebeArbeitstage(d, tage, woche);
// ohne Versatz genau am Anfang oder Ende, auch wenn das ein freigegebener Freitag ist
return tage === 0 ? d : verschiebeArbeitstage(d, tage, woche);
}
/** Versatz in Arbeitstagen, damit das Datum `ziel` herauskommt (z. B. nach dem Ziehen der Raute) */

View File

@@ -2,7 +2,7 @@
// 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 } from "./kalender.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;
@@ -13,15 +13,17 @@ interface FVorgang {
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 gesamt = arbeitstageZwischen(v.anfang, v.ende, woche);
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), woche) / gesamt) * 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 */

View File

@@ -59,14 +59,25 @@ export function feiertag(d: Datum): Feiertag | undefined {
export interface Arbeitswoche {
/** Wochentage 1 = Montag … 7 = Sonntag, an denen gearbeitet wird */
tage: number[];
/** einzelne zusätzliche Arbeitstage, z. B. ein freigegebener Freitag eines Vorgangs */
extra?: Datum[];
}
export const STANDARDWOCHE: Arbeitswoche = { tage: [1, 2, 3, 4] };
export function istArbeitstag(d: Datum, woche: Arbeitswoche = STANDARDWOCHE): boolean {
if (woche.extra?.includes(d)) return true;
return woche.tage.includes(wochentag(d)) && !feiertag(d);
}
/**
* Kalender eines Vorgangs (Henning, 21.10.2026): einzelne Freitage lassen sich je Vorgang freigeben; nur für diesen
* Vorgang zählen sie als Arbeitstag (Dauer, Ende, Auslastung, Einsätze), für alle anderen bleibt der Freitag Reserve.
*/
export function wocheVon(v: { freitage?: Datum[] | null }, woche: Arbeitswoche): Arbeitswoche {
return v.freitage?.length ? { tage: woche.tage, extra: [...(woche.extra ?? []), ...v.freitage] } : woche;
}
/** Bankarbeitstag (Mo–Fr ohne Feiertag), z. B. für Steuerfälligkeiten. Freitagsregel gilt hier nicht. */
export function istBankarbeitstag(d: Datum): boolean {
return wochentag(d) <= 5 && !feiertag(d);

View File

@@ -3,7 +3,7 @@
// 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 Arbeitswoche, feiertag, istArbeitstag, naechsterArbeitstag, wocheVon } from "./kalender.js";
import { type Abwesenheit, type Modell, abwesendStunden, sollStunden, wirksam } from "./personal.js";
export interface KapBesetzung {
@@ -63,19 +63,20 @@ export function dauerAusKapazitaet(start: Datum, stunden: number, kapazitaet: (d
}
/** 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 {
export function dauerNachBesetzung(v: { id: string; start: Datum; stunden?: number | null; freitage?: Datum[] | 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);
return dauerAusKapazitaet(v.start, Number(v.stunden), (d) => bs.reduce((s, b) => s + leistung(p, b, d).frei, 0), wocheVon(v, 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[] {
export function reduzierteTage(v: { id: string; anfang: Datum; ende: Datum; freitage?: Datum[] | null }, besetzungen: KapBesetzung[], p: Personaldaten, woche: Arbeitswoche): Datum[] {
const w = wocheVon(v, woche);
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;
if (!istArbeitstag(d, w)) 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);
@@ -94,19 +95,26 @@ export interface Woche {
/**
* 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).
* Ein freigegebener Freitag zählt nur für die Leute, die an diesem Vorgang eingeteilt sind, geplant und verfügbar.
*/
export function auslastung(von: Datum, bis: Datum, team: string[], vorgaenge: { id: string; anfang: Datum; ende: Datum; dauer: number }[],
export function auslastung(von: Datum, bis: Datum, team: string[], vorgaenge: { id: string; anfang: Datum; ende: Datum; dauer: number; freitage?: Datum[] | null }[],
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>();
const extra = new Set(vorgaenge.flatMap((v) => v.freitage ?? []));
for (let d = von; d <= bis; d = plusTage(d, 1)) {
if (!istArbeitstag(d, woche)) continue;
const firmentag = istArbeitstag(d, woche);
if (!firmentag && !extra.has(d)) continue;
// am freigegebenen Freitag nur die Vorgänge, die ihn freigegeben haben, und deren Leute
const dabei = firmentag ? null : new Set(eigene.filter((b) => vById.get(b.vorgang_id)?.freitage?.includes(d)).map((b) => b.kontakt_id!));
if (dabei && !dabei.size) 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) {
if (dabei && !dabei.has(pers.kontakt_id)) continue;
const f = freiAm(p, pers.kontakt_id, d);
pers.verfuegbar += f;
w.verfuegbar += f;
@@ -114,6 +122,7 @@ export function auslastung(von: Datum, bis: Datum, team: string[], vorgaenge: {
for (const b of eigene) {
const v = vById.get(b.vorgang_id);
if (!v || v.anfang > d || v.ende < d) continue;
if (!firmentag && !v.freitage?.includes(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;

View File

@@ -3,7 +3,7 @@
import { type Datum } from "./datum.js";
import { type Cent } from "./geld.js";
import { type Arbeitswoche, endeNachDauer } from "./kalender.js";
import { type Arbeitswoche, endeNachDauer, wocheVon } from "./kalender.js";
import { type BezugArt, bezugsTermin } from "./bezug.js";
import { type Daten, type Einnahme, type Ausgabe, type Kostenart, type LaufendeKosten, projektBewegungen } from "./liquiditaet.js";
@@ -64,8 +64,8 @@ export interface Bestand {
/** P5: Anfragen und Angebote fließen nicht in die Liquidität (V70 hat sie mitgerechnet). */
export const OHNE_LIQUIDITAET = new Set(["anfrage", "angebot"]);
export function vorgangsEnde(v: Pick<BestandVorgang, "start" | "dauer">, woche: Arbeitswoche): Datum {
return endeNachDauer(v.start, Math.ceil(v.dauer), woche);
export function vorgangsEnde(v: Pick<BestandVorgang, "start" | "dauer"> & { freitage?: Datum[] | null }, woche: Arbeitswoche): Datum {
return endeNachDauer(v.start, Math.ceil(v.dauer), wocheVon(v, woche));
}
/** Ein noch nicht gestellter Abschlag wandert mit dem Ende seines Vorgangs. */

View File

@@ -4,7 +4,7 @@
// liegt. Nach vorn rücken nur Nachfolger, die vorher direkt am Vorgänger hingen („eng“).
import { type Datum } from "./datum.js";
import { type Arbeitswoche, endeNachDauer, naechsterArbeitstag, verschiebeArbeitstage } from "./kalender.js";
import { type Arbeitswoche, endeNachDauer, naechsterArbeitstag, verschiebeArbeitstage, wocheVon } from "./kalender.js";
export type Art = "EA" | "AA" | "EE" | "AE";
@@ -13,6 +13,8 @@ export interface PlanVorgang {
start: Datum;
/** Arbeitstage; angefangene Tage zählen voll; 0 = Meilenstein */
dauer: number;
/** Freitage, an denen dieser Vorgang ausnahmsweise ausgeführt wird */
freitage?: Datum[] | null;
}
export interface Verknuepfung {
@@ -26,11 +28,11 @@ export interface Verknuepfung {
const tage = (v: PlanVorgang) => Math.ceil(v.dauer);
export function anfang(v: PlanVorgang, woche: Arbeitswoche): Datum {
return naechsterArbeitstag(v.start, woche);
return naechsterArbeitstag(v.start, wocheVon(v, woche));
}
export function ende(v: PlanVorgang, woche: Arbeitswoche): Datum {
return endeNachDauer(v.start, tage(v), woche);
return endeNachDauer(v.start, tage(v), wocheVon(v, woche));
}
/** V70 offW: n Arbeitstage nach (n > 0) oder vor (n < 0) dem Tag; 0 = der Tag oder der nächste Arbeitstag. */
@@ -40,19 +42,22 @@ function versatz(d: Datum, n: number, woche: Arbeitswoche): Datum {
/** Start, der sich ergibt, wenn der Vorgang an `endeAm` endet. */
function startFuerEnde(v: PlanVorgang, endeAm: Datum, woche: Arbeitswoche): Datum {
const e = naechsterArbeitstag(endeAm, woche);
return tage(v) <= 1 ? e : verschiebeArbeitstage(e, -(tage(v) - 1), woche);
const w = wocheVon(v, woche);
const e = naechsterArbeitstag(endeAm, w);
return tage(v) <= 1 ? e : verschiebeArbeitstage(e, -(tage(v) - 1), w);
}
/** Frühester Start, den eine Verknüpfung dem Nachfolger erlaubt. */
export function startNachVerknuepfung(v: PlanVorgang, vorgaenger: PlanVorgang, k: Verknuepfung, woche: Arbeitswoche): Datum {
const lg = k.verzoegerung;
const meilenstein = tage(v) === 0;
// gezählt wird im Kalender des Nachfolgers: ein freigegebener Freitag des Nachfolgers kann sein Start sein
const w = wocheVon(v, woche);
switch (k.art) {
case "EA": return versatz(ende(vorgaenger, woche), meilenstein ? lg : 1 + lg, woche);
case "AA": return versatz(anfang(vorgaenger, woche), lg, woche);
case "EE": return startFuerEnde(v, versatz(ende(vorgaenger, woche), lg, woche), woche);
case "AE": return startFuerEnde(v, versatz(anfang(vorgaenger, woche), lg, woche), woche);
case "EA": return versatz(ende(vorgaenger, woche), meilenstein ? lg : 1 + lg, w);
case "AA": return versatz(anfang(vorgaenger, woche), lg, w);
case "EE": return startFuerEnde(v, versatz(ende(vorgaenger, woche), lg, w), woche);
case "AE": return startFuerEnde(v, versatz(anfang(vorgaenger, woche), lg, w), woche);
}
}

View File

@@ -1,7 +1,7 @@
// Startseite (Ü3, Ü7, Ü8): Aufgaben wie in V70 gruppiert, Warnungen und wer was wann wo macht.
import { type Datum, plusTage, wochentag } from "./datum.js";
import { type Arbeitswoche, istArbeitstag } from "./kalender.js";
import { type Arbeitswoche, istArbeitstag, wocheVon } from "./kalender.js";
import { type Besetzung, wer } from "./einsatz.js";
export interface Aufgabe {
@@ -36,6 +36,7 @@ export interface UeVorgang {
anfang: Datum;
ende: Datum;
projekt: string;
freitage?: Datum[] | null;
}
export interface UeBesetzung extends Besetzung {
@@ -58,11 +59,12 @@ export interface Einsatzzeile {
}
/** Ü8: je Person (und Platzhalter) die Vorgänge an den nächsten Arbeitstagen; dazu Vorgänge ohne Besetzung. */
export function einsatzMatrix(vorgaenge: UeVorgang[], besetzungen: UeBesetzung[], tage: Datum[]): { zeilen: Einsatzzeile[]; ohne: Einsatzzeile } {
export function einsatzMatrix(vorgaenge: UeVorgang[], besetzungen: UeBesetzung[], tage: Datum[], woche?: Arbeitswoche): { zeilen: Einsatzzeile[]; ohne: Einsatzzeile } {
const zeilen = new Map<string, Einsatzzeile>();
const ohne: Einsatzzeile = { wer: "", anzeige: "Noch nicht besetzt", tage: tage.map(() => []) };
for (const v of vorgaenge) {
const idx = tage.map((d, i) => (d >= v.anfang && d <= v.ende ? i : -1)).filter((i) => i >= 0);
// an einem freigegebenen Freitag nur die Vorgänge, die ihn freigegeben haben
const idx = tage.map((d, i) => (d >= v.anfang && d <= v.ende && (!woche || istArbeitstag(d, wocheVon(v, woche))) ? i : -1)).filter((i) => i >= 0);
if (!idx.length) continue;
const bs = besetzungen.filter((b) => b.vorgang_id === v.id);
const eintrag = (vorgemerkt: boolean) => ({ vorgang: v.id, name: v.name, projekt: v.projekt, vorgemerkt });