Stundenliste fürs Steuerbüro als CSV (0.10.0)
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

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-20 06:52:48 +00:00
parent e4754f329a
commit 8634791c68
10 changed files with 285 additions and 19 deletions

View File

@@ -43,13 +43,17 @@ export function modellAm(modelle: Modell[], kontaktId: string, d: Datum): Modell
return treffer;
}
/** Vertragliche Stunden an einem Tag (Feiertage 0) */
export function sollStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
if (feiertag(d)) return 0;
/** Stunden laut Arbeitszeitmodell, auch an Feiertagen (für die Feiertagsvergütung) */
export function vertragsStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
const m = modellAm(modelle, kontaktId, d);
return (m?.stunden ?? standardStunden(stundenProTag))[wochentag(d) - 1] ?? 0;
}
/** Vertragliche Stunden an einem Tag (Feiertage 0) */
export function sollStunden(modelle: Modell[], kontaktId: string, d: Datum, stundenProTag = 8): number {
return feiertag(d) ? 0 : vertragsStunden(modelle, kontaktId, d, stundenProTag);
}
/** Stunden, die eine Abwesenheit an einem Tag wegnimmt, höchstens das Soll */
export function abwesendStunden(a: Abwesenheit, soll: number): number {
if (a.stunden != null) return Math.min(soll, Math.max(0, a.stunden));

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

@@ -0,0 +1,123 @@
// M5: Stundenliste für das Steuerbüro (Herr Seeler macht die Lohnabrechnung).
// Ein Monat, je angestelltem Mitarbeiter eine Zeile je Tag mit Arbeit, Abwesenheit oder Feiertag und eine Summenzeile.
// Für Excel: Semikolon, Dezimalkomma, UTF-8 mit BOM.
import { type Datum, formatDatum, plusTage, wochentag } from "./datum.js";
import { feiertag } from "./kalender.js";
import { type Abwesenheit, ABWESENHEIT_TEXT, type AbwesenheitArt, type Modell, abwesendStunden, vertragsStunden, wirksam } from "./personal.js";
export interface Person {
kontakt_id: string;
name: string;
personalnummer?: string | null;
eintritt?: Datum | null;
austritt?: Datum | null;
}
export interface Buchung {
kontakt_id: string;
datum: Datum;
beginn: string;
ende: string;
/** von Hand eingetragene Pause plus Abzug nach M3 */
pause_min: number;
netto_min: number;
baustellen: string;
notiz?: string | null;
}
export interface Summe {
ist: number;
soll: number;
abwesend: number;
/** Ist + Abwesend − Soll */
saldo: number;
/** Tage je Art, Feiertage unter "feiertag" */
tage: Partial<Record<AbwesenheitArt | "feiertag", number>>;
}
const WOCHENTAGE = ["Mo", "Di", "Mi", "Do", "Fr", "Sa", "So"];
const KOPF = ["Personalnr.", "Name", "Datum", "Tag", "Beginn", "Ende", "Pause Min.", "Arbeitszeit Std.", "Soll Std.",
"Abwesenheit", "Abwesend Std.", "Baustellen", "Bemerkung"];
export const zahl = (h: number) => (Math.round(h * 100) / 100).toFixed(2).replace(".", ",");
const feld = (x: string | number) => {
const s = String(x);
return /[;"\n\r]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
};
const zeile = (werte: (string | number)[]) => werte.map(feld).join(";");
export function monatsletzter(monat: string): Datum {
const [j, m] = monat.split("-").map(Number) as [number, number];
return plusTage(`${m === 12 ? j + 1 : j}-${String(m === 12 ? 1 : m + 1).padStart(2, "0")}-01`, -1);
}
const TAGE_TEXT: [AbwesenheitArt | "feiertag", string, string][] = [
["urlaub", "Urlaub", "Urlaub"], ["krank", "Krank", "Krank"], ["schule", "Berufsschule", "Berufsschule"],
["feiertag", "Feiertag", "Feiertage"], ["frei", "Frei", "Frei"], ["sperre", "Nicht verfügbar", "Nicht verfügbar"],
];
export function tageText(tage: Summe["tage"]): string {
return TAGE_TEXT.filter(([k]) => tage[k]).map(([k, eins, mehr]) => {
const n = tage[k]!;
return `${eins === mehr || n === 1 ? eins : mehr} ${zahl(n).replace(/,00$/, "").replace(/,50$/, ",5")} ${n === 1 ? "Tag" : "Tage"}`;
}).join(", ");
}
/** Die Zeilen einer Person; leere Tage (kein Soll, nichts gebucht) fallen weg */
export function personMonat(p: Person, monat: string, buchungen: Buchung[], modelle: Modell[], abwesenheiten: Abwesenheit[], stundenProTag = 8, stichtag?: Datum) {
const von = `${monat}-01`, letzter = monatsletzter(monat);
const bis = stichtag && stichtag < letzter ? stichtag : letzter;
const zeilen: string[][] = [];
const s: Summe = { ist: 0, soll: 0, abwesend: 0, saldo: 0, tage: {} };
const eigene = abwesenheiten.filter((a) => a.kontakt_id === p.kontakt_id && wirksam(a));
for (let d = von; d <= bis; d = plusTage(d, 1)) {
const beschaeftigt = (!p.eintritt || d >= p.eintritt) && (!p.austritt || d <= p.austritt);
const vertrag = beschaeftigt ? vertragsStunden(modelle, p.kontakt_id, d, stundenProTag) : 0;
const b = buchungen.find((x) => x.kontakt_id === p.kontakt_id && x.datum === d);
const ft = feiertag(d);
const weg: [string, number][] = [];
if (ft && vertrag > 0) {
weg.push([`Feiertag (${ft.name})`, vertrag]);
s.tage.feiertag = (s.tage.feiertag ?? 0) + 1;
} else if (vertrag > 0) {
for (const a of eigene.filter((x) => x.von <= d && x.bis >= d)) {
const h = abwesendStunden(a, vertrag);
if (h <= 0) continue;
weg.push([`${ABWESENHEIT_TEXT[a.art]}${a.halbtag ? " (halber Tag)" : a.stunden != null ? " (stundenweise)" : ""}`, h]);
s.tage[a.art] = (s.tage[a.art] ?? 0) + (a.stunden != null ? 0 : a.halbtag ? 0.5 : 1);
}
}
if (!b && !weg.length) {
s.soll += vertrag; // fehlende Buchung an einem Arbeitstag zählt als Minus
if (vertrag > 0) zeilen.push([p.personalnummer ?? "", p.name, formatDatum(d), WOCHENTAGE[wochentag(d) - 1]!, "", "", "", zahl(0), zahl(vertrag), "", "", "", "nichts gebucht"]);
continue;
}
const abw = Math.min(vertrag, weg.reduce((x, [, h]) => x + h, 0));
const ist = b ? b.netto_min / 60 : 0;
s.ist += ist; s.soll += vertrag; s.abwesend += abw;
zeilen.push([p.personalnummer ?? "", p.name, formatDatum(d), WOCHENTAGE[wochentag(d) - 1]!,
b?.beginn ?? "", b?.ende ?? "", b ? String(b.pause_min) : "", zahl(ist), zahl(vertrag),
weg.map(([t]) => t).join(", "), weg.length ? zahl(abw) : "", b?.baustellen ?? "", b?.notiz ?? ""]);
}
s.saldo = s.ist + s.abwesend - s.soll;
return { zeilen, summe: s };
}
/**
* Die ganze Liste. „nichts gebucht“ markiert Arbeitstage ohne Buchung und ohne Abwesenheit, damit nichts unbemerkt fehlt.
* Im laufenden Monat endet die Liste am Stichtag (heute), damit Soll und Saldo stimmen.
*/
export function stundenCsv(monat: string, personen: Person[], buchungen: Buchung[], modelle: Modell[], abwesenheiten: Abwesenheit[],
stundenProTag = 8, stichtag?: Datum): string {
const out = [zeile(KOPF)];
for (const p of personen) {
const { zeilen, summe } = personMonat(p, monat, buchungen, modelle, abwesenheiten, stundenProTag, stichtag);
if (!zeilen.length) continue;
out.push(...zeilen.map(zeile));
const [j, m] = monat.split("-");
out.push(zeile([p.personalnummer ?? "", p.name, `Summe ${m}/${j}`, "", "", "", "", zahl(summe.ist), zahl(summe.soll),
tageText(summe.tage), zahl(summe.abwesend), `Mehr-/Minderstunden ${summe.saldo >= 0 ? "+" : ""}${zahl(summe.saldo)}`, ""]));
out.push("");
}
return "" + out.join("\r\n") + "\r\n";
}

View File

@@ -9,6 +9,7 @@ import { type Abzugsart, minuten, rechneTag, uhrzeit } from "../domain/zeit.js";
import { plusTage } from "../domain/datum.js";
import { anfang, ende } from "../domain/terminplan.js";
import { verfuegbarkeit } from "../domain/personal.js";
import { type Buchung, monatsletzter, stundenCsv, zahl } from "../domain/stundenliste.js";
import { ladePersonal } from "./personal.js";
type Abfrage = Pick<Pool, "query">;
@@ -192,6 +193,29 @@ export function registriereZeiten(app: FastifyInstance, pool: Pool, einstellunge
return n ? reply.status(204).send() : reply.status(404).send({ fehler: "Nicht gefunden" });
});
// M5: Stundenliste eines Monats fürs Steuerbüro, nur Angestellte
app.get("/api/zeiten/csv", async (req, reply) => {
const { monat } = z.object({ monat: z.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/, "Monat als JJJJ-MM") }).parse(req.query);
const e = await einstellungen();
const [tage, leute, st] = await Promise.all([
ladeTage(pool, `${monat}-01`, monatsletzter(monat)),
pool.query(`select k.id as kontakt_id, k.name, m.personalnummer, m.eintritt, m.austritt, m.id is not null as stammdaten from kontakt k left join mitarbeiter m on m.kontakt_id = k.id
where k.rolle = 'mitarbeiter' and coalesce(m.angestellt, not exists (select 1 from benutzer b where b.kontakt_id = k.id and b.rolle = 'inhaber'))
order by nullif(m.personalnummer, '') nulls last, k.name`),
ladePersonal(pool),
]);
const buchungen: Buchung[] = tage.map((t) => ({
kontakt_id: t.kontakt_id, datum: t.datum, beginn: t.beginn, ende: t.ende, pause_min: t.pause_min + t.abzug_min, netto_min: t.netto_min, notiz: t.notiz,
baustellen: t.anteile.map((a: { nummer: string | null; vorgang: string | null; taetigkeit: string | null; stunden: number }) =>
[a.nummer ?? "ohne Baustelle", a.vorgang, a.taetigkeit].filter(Boolean).join(" ") + (t.anteile.length > 1 ? ` ${zahl(a.stunden)}` : "")).join("; "),
}));
// Wer weder Personaldaten hat noch Stunden gebucht hat, ist kein Fall für die Lohnabrechnung (z. B. alte Kontakte aus V70)
const personen = leute.rows.filter((p) => p.stammdaten || buchungen.some((b) => b.kontakt_id === p.kontakt_id));
const csv = stundenCsv(monat, personen, buchungen, st.modelle, st.abwesenheiten, e.stundenProTag, heute());
return reply.header("content-type", "text/csv; charset=utf-8").header("cache-control", "no-store")
.header("content-disposition", `attachment; filename="stunden-${monat}.csv"`).send(csv);
});
// Ist-Stunden je Projekt (Projektseite, später Nachkalkulation)
app.get("/api/zeiten/projekte", async () => {
const r = await pool.query("select projekt_id, sum(stunden) as stunden from zeitanteil where projekt_id is not null group by projekt_id");

View File

@@ -2,7 +2,7 @@
// und Büro die Monatsübersicht aller. Ohne Netz bleibt die Buchung im Handy und geht raus, sobald wieder Netz da ist.
import { type Abzugsart, dauerText, minuten, rechneTag, regelPause, uhrzeit } from "../domain/zeit.js";
import { type Zeile, api, dat, esc, heute, inhalt, lies, merke, seite } from "./ui.js";
import { type Zeile, api, dat, dateiSpeichern, esc, heute, inhalt, lies, merke, seite } from "./ui.js";
const WT = ["So", "Mo", "Di", "Mi", "Do", "Fr", "Sa"];
const WT_LANG = ["Sonntag", "Montag", "Dienstag", "Mittwoch", "Donnerstag", "Freitag", "Samstag"];
@@ -252,12 +252,14 @@ export async function stundenSeite(): Promise<void> {
const leiste = inhalt.querySelector(".leiste")!;
leiste.innerHTML = `<div class="tag-wahl"><button class="neben" data-monat="-1" aria-label="Monat davor">‹</button><b>${MONATE[Number(monat.slice(5, 7)) - 1]} ${monat.slice(0, 4)}</b><button class="neben" data-monat="1" aria-label="Monat danach">›</button></div>
<select id="person"><option value="">Alle Personen</option>${d.leute.map((l: Zeile) => `<option value="${l.id}"${l.id === person ? " selected" : ""}>${esc(l.name)}${l.rolle === "subunternehmer" ? " (Sub)" : ""}</option>`).join("")}</select>
<button class="neben" data-a="neu">+ Stunden nachtragen</button>`;
<button class="neben" data-a="neu">+ Stunden nachtragen</button>
<button class="neben" data-a="csv" title="Alle Angestellten, je Tag mit Urlaub, Krankheit und Feiertagen, mit Summen">Stundenliste fürs Steuerbüro</button><span id="csv-meldung" class="hinweis"></span>`;
// Summen je Person: Ist gegen Soll aus dem Arbeitszeitmodell (abzüglich Urlaub, Krankheit, Feiertage)
const jePerson = new Map<string, number>();
for (const t of d.tage) jePerson.set(t.kontakt_id, (jePerson.get(t.kontakt_id) ?? 0) + t.netto_min);
const sollJe = new Map(verf.map((v) => [v.kontakt_id, v.tage.reduce((s: number, t: Zeile) => s + t.frei, 0) * 60]));
// im laufenden Monat nur bis heute, sonst stünde am Monatsanfang ein großes Minus da
const sollJe = new Map(verf.map((v) => [v.kontakt_id, v.tage.filter((t: Zeile) => t.datum <= heute()).reduce((s: number, t: Zeile) => s + t.frei, 0) * 60]));
const leute = d.leute.filter((l: Zeile) => (!person || l.id === person) && (jePerson.has(l.id) || (l.rolle === "mitarbeiter" && sollJe.has(l.id))));
inhalt.insertAdjacentHTML("beforeend", `<div class="summen">${leute.map((l: Zeile) => {
const ist = jePerson.get(l.id) ?? 0, soll = l.angestellt ? sollJe.get(l.id) ?? 0 : 0;
@@ -312,6 +314,11 @@ export async function stundenSeite(): Promise<void> {
void stundenSeite();
}
if (b.dataset.a === "neu") void oeffne(null);
if (b.dataset.a === "csv") {
const meldung = leiste.querySelector<HTMLElement>("#csv-meldung")!;
dateiSpeichern(`zeiten/csv?monat=${monat}`, `stunden-${monat}.csv`)
.then((t) => { meldung.textContent = t; }, (e: Error) => { meldung.textContent = e.message; });
}
});
leiste.querySelector<HTMLSelectElement>("#person")!.onchange = (ev) => { person = (ev.target as HTMLSelectElement).value; void stundenSeite(); };
tabelle.onclick = (ev) => {

View File

@@ -35,6 +35,28 @@ export async function api<T = any>(pfad: string, methode = "GET", body?: unknown
return j as T;
}
/** Eine Datei vom Server holen und speichern lassen (Testversion: über das Speichern der Artifact-Seite). Gibt eine Meldung zurück. */
export async function dateiSpeichern(pfad: string, dateiname: string): Promise<string> {
const kopf: Record<string, string> = {};
const test = lies(TEST_BENUTZER);
if (test) kopf["x-test-benutzer"] = test;
const r = await fetch(`/api/${pfad}`, { headers: kopf });
if (!r.ok) {
const j = await r.json().catch(() => ({}));
throw new Error(j.fehler ?? `Fehler ${r.status}`);
}
const tv = (globalThis as { betriebTestversion?: { datei?(name: string, text: string): Promise<string> } }).betriebTestversion;
// ignoreBOM: das BOM am Anfang muss mit, sonst zeigt Excel die Umlaute falsch
if (tv?.datei) return tv.datei(dateiname, new TextDecoder("utf-8", { ignoreBOM: true }).decode(await r.arrayBuffer()));
const url = URL.createObjectURL(await r.blob());
const a = Object.assign(document.createElement("a"), { href: url, download: dateiname });
document.body.appendChild(a);
a.click();
a.remove();
setTimeout(() => URL.revokeObjectURL(url), 10000);
return "";
}
export const inhalt = document.getElementById("inhalt")!;
export const huelle = document.getElementById("dialog-huelle")!;
export const heute = () => new Date().toISOString().slice(0, 10);