Stufe 0: Grundgerüst mit Rechenkern, Datenbank, Oberfläche und Docker-Betrieb

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-17 16:37:54 +00:00
commit 92d26baa4b
45 changed files with 6143 additions and 0 deletions

123
src/domain/kalender.ts Normal file
View File

@@ -0,0 +1,123 @@
// Feiertage Schleswig-Holstein und Arbeitstage des Betriebs.
// Regel aus V70: gearbeitet wird Montag bis Donnerstag. Freitag ist immer frei
// (Büro, Aufräumen, Reserve), Wochenende und Feiertage zählen nicht.
import { type Datum, datum, plusTage, wochentag, jahrVon } from "./datum.js";
export interface Feiertag {
datum: Datum;
name: string;
}
/** Ostersonntag nach der Gaußschen Osterformel (gregorianisch, anonymer Algorithmus). */
export function ostersonntag(jahr: number): Datum {
const a = jahr % 19;
const b = Math.floor(jahr / 100);
const c = jahr % 100;
const d = Math.floor(b / 4);
const e = b % 4;
const f = Math.floor((b + 8) / 25);
const g = Math.floor((b - f + 1) / 3);
const h = (19 * a + b - d - g + 15) % 30;
const i = Math.floor(c / 4);
const k = c % 4;
const l = (32 + 2 * e + 2 * i - h - k) % 7;
const m = Math.floor((a + 11 * h + 22 * l) / 451);
const monat = Math.floor((h + l - 7 * m + 114) / 31);
const tag = ((h + l - 7 * m + 114) % 31) + 1;
return datum(jahr, monat, tag);
}
const cache = new Map<number, Feiertag[]>();
/** Gesetzliche Feiertage in Schleswig-Holstein. Reformationstag gilt seit 2018. */
export function feiertageSH(jahr: number): Feiertag[] {
const vorhanden = cache.get(jahr);
if (vorhanden) return vorhanden;
const ostern = ostersonntag(jahr);
const liste: Feiertag[] = [
{ datum: datum(jahr, 1, 1), name: "Neujahr" },
{ datum: plusTage(ostern, -2), name: "Karfreitag" },
{ datum: plusTage(ostern, 1), name: "Ostermontag" },
{ datum: datum(jahr, 5, 1), name: "Tag der Arbeit" },
{ datum: plusTage(ostern, 39), name: "Christi Himmelfahrt" },
{ datum: plusTage(ostern, 50), name: "Pfingstmontag" },
{ datum: datum(jahr, 10, 3), name: "Tag der Deutschen Einheit" },
...(jahr >= 2018 ? [{ datum: datum(jahr, 10, 31), name: "Reformationstag" }] : []),
{ datum: datum(jahr, 12, 25), name: "1. Weihnachtstag" },
{ datum: datum(jahr, 12, 26), name: "2. Weihnachtstag" },
];
liste.sort((x, y) => x.datum.localeCompare(y.datum));
cache.set(jahr, liste);
return liste;
}
export function feiertag(d: Datum): Feiertag | undefined {
return feiertageSH(jahrVon(d)).find((f) => f.datum === d);
}
export interface Arbeitswoche {
/** Wochentage 1 = Montag … 7 = Sonntag, an denen gearbeitet wird */
tage: number[];
}
export const STANDARDWOCHE: Arbeitswoche = { tage: [1, 2, 3, 4] };
export function istArbeitstag(d: Datum, woche: Arbeitswoche = STANDARDWOCHE): boolean {
return woche.tage.includes(wochentag(d)) && !feiertag(d);
}
/** 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);
}
/** Der Tag selbst, falls Arbeitstag, sonst der nächste Arbeitstag. */
export function naechsterArbeitstag(d: Datum, woche: Arbeitswoche = STANDARDWOCHE): Datum {
let x = d;
for (let i = 0; i < 400; i++) {
if (istArbeitstag(x, woche)) return x;
x = plusTage(x, 1);
}
throw new Error("Kein Arbeitstag gefunden");
}
export function naechsterBankarbeitstag(d: Datum): Datum {
let x = d;
while (!istBankarbeitstag(x)) x = plusTage(x, 1);
return x;
}
/**
* Verschiebt um n Arbeitstage (n darf negativ sein). Ausgangspunkt ist der Tag selbst;
* n = 0 liefert ihn unverändert.
*/
export function verschiebeArbeitstage(d: Datum, n: number, woche: Arbeitswoche = STANDARDWOCHE): Datum {
let x = d;
const schritt = n >= 0 ? 1 : -1;
let rest = Math.abs(n);
while (rest > 0) {
x = plusTage(x, schritt);
if (istArbeitstag(x, woche)) rest--;
}
return x;
}
/**
* Letzter Arbeitstag eines Vorgangs, der am Start (bzw. dem nächsten Arbeitstag) beginnt
* und `dauer` Arbeitstage dauert. Dauer 0 ist ein Meilenstein: Ende = Start.
*/
export function endeNachDauer(start: Datum, dauer: number, woche: Arbeitswoche = STANDARDWOCHE): Datum {
if (!Number.isInteger(dauer) || dauer < 0) throw new Error(`Ungültige Dauer: ${dauer}`);
const beginn = naechsterArbeitstag(start, woche);
if (dauer === 0) return beginn;
return verschiebeArbeitstage(beginn, dauer - 1, woche);
}
/** Anzahl Arbeitstage von `von` bis `bis`, beide eingeschlossen. 0, wenn bis vor von liegt. */
export function arbeitstageZwischen(von: Datum, bis: Datum, woche: Arbeitswoche = STANDARDWOCHE): number {
if (bis < von) return 0;
let n = 0;
for (let x = von; x <= bis; x = plusTage(x, 1)) if (istArbeitstag(x, woche)) n++;
return n;
}