Stundenliste fürs Steuerbüro als CSV (0.10.0)
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:
@@ -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
123
src/domain/stundenliste.ts
Normal 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";
|
||||
}
|
||||
@@ -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");
|
||||
|
||||
@@ -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) => {
|
||||
|
||||
@@ -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);
|
||||
|
||||
Reference in New Issue
Block a user