diff --git a/deploy/Caddyfile b/deploy/Caddyfile index 05fc2e2..61c4dc4 100644 --- a/deploy/Caddyfile +++ b/deploy/Caddyfile @@ -1,6 +1,8 @@ # HTTPS mit automatischem Zertifikat für Produktion und Testumgebung. # Bis zur eigenen Benutzerverwaltung (Modul 16) schützt eine Anmeldung am Proxy # das Programm; der Name geht als X-Benutzer an die App und ins Änderungsprotokoll. +# Ausnahme: die Kalender-Abos unter /kalender/ (Outlook classic kann sich nicht anmelden); +# sie sind durch ein Geheimnis im Link geschützt, das die App prüft. (anmeldung) { basic_auth { {$APP_BENUTZER} {$APP_PASSWORT_HASH} @@ -9,16 +11,26 @@ {$DOMAIN} { encode gzip - import anmeldung - reverse_proxy app:3000 { - header_up X-Benutzer {http.auth.user.id} + handle /kalender/* { + reverse_proxy app:3000 + } + handle { + import anmeldung + reverse_proxy app:3000 { + header_up X-Benutzer {http.auth.user.id} + } } } {$TEST_DOMAIN} { encode gzip - import anmeldung - reverse_proxy app-test:3000 { - header_up X-Benutzer {http.auth.user.id} + handle /kalender/* { + reverse_proxy app-test:3000 + } + handle { + import anmeldung + reverse_proxy app-test:3000 { + header_up X-Benutzer {http.auth.user.id} + } } } diff --git a/src/domain/ical.ts b/src/domain/ical.ts new file mode 100644 index 0000000..2af498a --- /dev/null +++ b/src/domain/ical.ts @@ -0,0 +1,72 @@ +// Internetkalender (iCalendar, RFC 5545) für das Kalender-Abo in Outlook classic (T11, E15). +// Ganztägige Termine; Outlook holt Änderungen beim nächsten Abgleich ab, nur in eine Richtung. + +import { type Datum, plusTage } from "./datum.js"; + +export interface Termin { + uid: string; + von: Datum; + /** letzter Tag, eingeschlossen */ + bis: Datum; + titel: string; + beschreibung?: string; + ort?: string; + geaendert?: Date; +} + +function text(s: string): string { + return s.replace(/\\/g, "\\\\").replace(/;/g, "\\;").replace(/,/g, "\\,").replace(/\r?\n/g, "\\n"); +} + +/** Zeilen über 75 Byte umbrechen; Folgezeilen beginnen mit einem Leerzeichen. UTF-8-Zeichen bleiben ganz. */ +function falte(zeile: string): string { + const teile: string[] = []; + let aktuell = ""; + let bytes = 0; + for (const z of zeile) { + const n = new TextEncoder().encode(z).length; + if (bytes + n > (teile.length ? 74 : 75)) { + teile.push(aktuell); + aktuell = ""; + bytes = 0; + } + aktuell += z; + bytes += n; + } + teile.push(aktuell); + return teile.join("\r\n "); +} + +const tag = (d: Datum) => d.replaceAll("-", ""); +const zeit = (d: Date) => d.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}/, ""); + +export function kalender(name: string, termine: Termin[], jetzt = new Date()): string { + const z = [ + "BEGIN:VCALENDAR", + "VERSION:2.0", + "PRODID:-//Schaarschmidt Holzbau//Betrieb//DE", + "CALSCALE:GREGORIAN", + "METHOD:PUBLISH", + `X-WR-CALNAME:${text(name)}`, + "X-WR-TIMEZONE:Europe/Berlin", + "REFRESH-INTERVAL;VALUE=DURATION:PT1H", + "X-PUBLISHED-TTL:PT1H", + ]; + for (const t of termine) { + z.push( + "BEGIN:VEVENT", + `UID:${t.uid}`, + `DTSTAMP:${zeit(jetzt)}`, + ...(t.geaendert ? [`LAST-MODIFIED:${zeit(t.geaendert)}`] : []), + `DTSTART;VALUE=DATE:${tag(t.von)}`, + `DTEND;VALUE=DATE:${tag(plusTage(t.bis, 1))}`, + `SUMMARY:${text(t.titel)}`, + ...(t.beschreibung ? [`DESCRIPTION:${text(t.beschreibung)}`] : []), + ...(t.ort ? [`LOCATION:${text(t.ort)}`] : []), + "TRANSP:TRANSPARENT", + "END:VEVENT", + ); + } + z.push("END:VCALENDAR"); + return z.map(falte).join("\r\n") + "\r\n"; +} diff --git a/src/server/app.ts b/src/server/app.ts index cb7bc97..2c34c14 100644 --- a/src/server/app.ts +++ b/src/server/app.ts @@ -3,10 +3,12 @@ import fastifyStatic from "@fastify/static"; import { fileURLToPath } from "node:url"; import path from "node:path"; import { existsSync } from "node:fs"; +import { randomBytes, timingSafeEqual } from "node:crypto"; import { z, ZodError } from "zod"; import { type Client, type Pool, transaktion } from "./db.js"; import { mitNeuplanung, pruefeVerknuepfung, terminplan } from "./terminplan.js"; import { uebersicht } from "./uebersicht.js"; +import { aufgabenKalender, baustellenKalender } from "./kalender.js"; import { TABELLEN } from "./tabellen.js"; import { EinstellungenSchema, type Einstellungen } from "./einstellungen.js"; import { liquiditaet } from "../domain/liquiditaet.js"; @@ -178,6 +180,28 @@ export async function baueApp(o: Optionen): Promise { kontostandErfasst: e.startsaldo !== 0 || e.startsaldoDatum !== null }); }); + // T11: Kalender-Abos. Ohne Anmeldung erreichbar (Outlook classic kann das nicht), geschützt durch das Geheimnis im Link + const KalenderParam = z.object({ token: z.string().min(20).max(100), name: z.enum(["baustellen.ics", "aufgaben.ics"]) }); + app.get("/kalender/:token/:name", async (req, reply) => { + const q = KalenderParam.safeParse(req.params); + const e = await ladeEinstellungen(); + const soll = Buffer.from(e.kalenderToken ?? ""); + const ist = Buffer.from(q.success ? q.data.token : ""); + if (!q.success || !e.kalenderToken || soll.length !== ist.length || !timingSafeEqual(soll, ist)) { + return reply.status(404).send({ fehler: "Nicht gefunden" }); + } + const ics = q.data.name === "baustellen.ics" ? await baustellenKalender(pool, { tage: e.arbeitstage }) : await aufgabenKalender(pool); + return reply.header("content-type", "text/calendar; charset=utf-8").header("cache-control", "no-store").send(ics); + }); + + // Neues Geheimnis für die Kalender-Links; alte Abos hören dann auf zu funktionieren + app.post("/api/kalender/neu", async (req) => { + const e = await ladeEinstellungen(); + const neu = { ...e, kalenderToken: randomBytes(24).toString("base64url") }; + await transaktion(pool, benutzer(req), (c) => c.query("update einstellungen set daten = $1", [neu])); + return { kalenderToken: neu.kalenderToken }; + }); + app.get("/api/terminplan", async () => { const e = await ladeEinstellungen(); return terminplan(pool, { tage: e.arbeitstage }); diff --git a/src/server/einstellungen.ts b/src/server/einstellungen.ts index e64d3c3..69abaac 100644 --- a/src/server/einstellungen.ts +++ b/src/server/einstellungen.ts @@ -27,6 +27,8 @@ export const EinstellungenSchema = z.object({ startsaldo: z.number().int().default(0), startsaldoDatum: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).nullable().default(null), mindestreserve: z.number().int().default(0), + // geheimer Teil der Kalender-Links (T11); Outlook classic kann sich nicht anmelden + kalenderToken: z.string().min(20).nullable().default(null), }); export type Einstellungen = z.infer; diff --git a/src/server/kalender.ts b/src/server/kalender.ts new file mode 100644 index 0000000..8f3d740 --- /dev/null +++ b/src/server/kalender.ts @@ -0,0 +1,61 @@ +// Kalender-Abos für Outlook classic (T11): Baustellen (Vorgänge) und fällige Aufgaben. +// Die Links enthalten ein Geheimnis statt einer Anmeldung, weil Outlook classic sich bei +// Internetkalendern nicht anmelden kann. +import { type Datum, plusTage } from "../domain/datum.js"; +import { type Arbeitswoche, istArbeitstag } from "../domain/kalender.js"; +import { type Termin, kalender } from "../domain/ical.js"; +import type { Pool } from "./db.js"; +import { terminplan } from "./terminplan.js"; + +const IM_KALENDER = new Set(["auftrag", "ausfuehrung"]); + +/** Vorgang in Abschnitte aus zusammenhängenden Arbeitstagen teilen, damit Freitag und Wochenende frei bleiben. */ +export function arbeitsbloecke(von: Datum, bis: Datum, woche: Arbeitswoche): [Datum, Datum][] { + const bloecke: [Datum, Datum][] = []; + let start: Datum | undefined; + let letzter: Datum | undefined; + for (let d = von; d <= bis; d = plusTage(d, 1)) { + if (istArbeitstag(d, woche)) { + start ??= d; + letzter = d; + } else if (start) { + bloecke.push([start, letzter!]); + start = undefined; + } + } + if (start) bloecke.push([start, letzter!]); + return bloecke.length ? bloecke : [[von, bis]]; +} + +export async function baustellenKalender(pool: Pool, woche: Arbeitswoche): Promise { + const tp = await terminplan(pool, woche); + const projektVon = new Map(tp.abschnitte.map((a) => [a.id, tp.projekte.find((p) => p.id === a.projekt_id)])); + const termine: Termin[] = []; + for (const v of tp.vorgaenge) { + const p = projektVon.get(v.abschnitt_id); + if (!p || !IM_KALENDER.has(p.status)) continue; + const bs = tp.besetzungen.filter((b) => b.vorgang_id === v.id); + const personen = (b: (typeof bs)[number]) => (Number(b.personen) !== 1 ? ` ×${String(b.personen).replace(".", ",")}` : ""); + const kurz = bs.map((b) => `${b.kurz}${personen(b)}${b.freigegeben ? "" : "?"}`).join(", "); + const meilenstein = Number(v.dauer) === 0; + const titel = `${meilenstein ? "◆ " : ""}${p.nummer} ${v.name}${kurz ? ` · ${kurz}` : ""}`; + const beschreibung = [ + `Projekt: ${p.nummer} ${p.bezeichnung}`, + p.bauherr ? `Bauherr: ${p.bauherr}` : "", + bs.length ? `Besetzung: ${bs.map((b) => `${b.anzeige}${personen(b)}${b.freigegeben ? "" : " (vorgemerkt)"}`).join("; ")}` : meilenstein ? "" : "Besetzung: noch offen", + meilenstein ? "Meilenstein" : `Dauer: ${Math.ceil(v.dauer)} ${Math.ceil(v.dauer) === 1 ? "Arbeitstag" : "Arbeitstage"}`, + ].filter(Boolean).join("\n"); + arbeitsbloecke(v.anfang, v.ende, woche).forEach(([von, bis], i) => + termine.push({ uid: `${v.id}-${i}@betrieb.schaarschmidt-holzbau.de`, von, bis, titel, beschreibung })); + } + return kalender("Baustellen", termine); +} + +export async function aufgabenKalender(pool: Pool): Promise { + const r = await pool.query(`select a.id, a.text, a.faellig_am, a.geaendert_am, p.nummer from aufgabe a left join projekt p on p.id = a.projekt_id + where a.erledigt_am is null and a.faellig_am is not null`); + return kalender("Aufgaben", r.rows.map((a) => ({ + uid: `${a.id}@betrieb.schaarschmidt-holzbau.de`, von: a.faellig_am, bis: a.faellig_am, + titel: `Aufgabe: ${a.text}${a.nummer ? ` (${a.nummer})` : ""}`, geaendert: a.geaendert_am, + }))); +} diff --git a/src/web/app.ts b/src/web/app.ts index 95b1f9b..b918e90 100644 --- a/src/web/app.ts +++ b/src/web/app.ts @@ -347,6 +347,34 @@ function einsatzHtml(e: Zeile): string { return tabelle + liste; } +// T11: Kalender-Abos für Outlook classic (nur lesen, Outlook holt Änderungen selbst ab) +function kalenderLinks(token: string | null): void { + const ziel = document.getElementById("kalender")!; + const neu = async () => { + if (token && !(await bestaetigen("Neue Links erzeugen? Die bisherigen Abos in Outlook funktionieren dann nicht mehr."))) return; + kalenderLinks((await api<{ kalenderToken: string }>("kalender/neu", "POST")).kalenderToken); + }; + if (!token) { + ziel.innerHTML = `

Die Vorgänge aus dem Terminplan und fällige Aufgaben lassen sich als Internetkalender in Outlook einbinden.

+

`; + ziel.querySelector("button")!.onclick = neu; + return; + } + const link = (name: string) => `${location.origin}/kalender/${token}/${name}`; + ziel.innerHTML = `${[["Baustellen", "baustellen.ics"], ["Aufgaben", "aufgaben.ics"]].map(([titel, datei]) => + ``).join("")} +

In Outlook: Datei → Kontoeinstellungen → Kontoeinstellungen → Internetkalender → Neu, Link einfügen, Name „Baustellen“ bzw. „Aufgaben“. + Outlook holt Änderungen etwa stündlich ab. Wer den Link hat, kann die Termine lesen; gib ihn deshalb nicht weiter.

+

`; + ziel.onclick = async (ev) => { + const b = ev.target as HTMLElement; + if (b.dataset.kopie) { + try { await navigator.clipboard.writeText(b.dataset.kopie); b.textContent = "Kopiert"; } catch { (b.previousElementSibling as HTMLInputElement).select(); } + } + if (b.dataset.a === "neu") neu(); + }; +} + async function daten(): Promise { seite("Daten und Einstellungen"); const e = await api("einstellungen"); @@ -357,7 +385,10 @@ async function daten(): Promise {

Sicherungsdatei aus V70 wählen (projektplaner-sicherung-….json). Geht nur, solange noch nichts erfasst ist.

+

Kalender in Outlook

+

Einstellungen

`); + kalenderLinks(e.kalenderToken); const datei = document.getElementById("v70-datei") as HTMLInputElement; datei.onchange = async () => { const f = datei.files?.[0]; diff --git a/src/web/styles.css b/src/web/styles.css index a6fd2b4..7afe8d5 100644 --- a/src/web/styles.css +++ b/src/web/styles.css @@ -207,3 +207,6 @@ tr.ohne .einsatz { background: #fdecea; color: #7a1c14; } .einsatz-liste { display: block; } .liqui { grid-template-columns: 1fr 1fr; } } +.kalender-link { display: flex; gap: 8px; align-items: center; margin-bottom: 8px; flex-wrap: wrap; } +.kalender-link b { width: 90px; } +.kalender-link input { flex: 1; min-width: 220px; padding: 8px 10px; border: 1px solid var(--linie); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } diff --git a/test/api.test.ts b/test/api.test.ts index 15b3e5c..8add839 100644 --- a/test/api.test.ts +++ b/test/api.test.ts @@ -218,4 +218,16 @@ describe.skipIf(!url)("Übernahme aus V70 über die API", () => { expect(u.einsatz.tage).toHaveLength(8); expect(u.einsatz.zeilen.map((z: { anzeige: string }) => z.anzeige)).toContain("Henning Schaarschmidt"); }); + + it("Kalender-Abo nur mit gültigem Geheimnis", async () => { + expect((await app.inject("/kalender/xxxxxxxxxxxxxxxxxxxxxxxx/baustellen.ics")).statusCode).toBe(404); + const { kalenderToken } = (await app.inject({ method: "POST", url: "/api/kalender/neu" })).json(); + const r = await app.inject(`/kalender/${kalenderToken}/baustellen.ics`); + expect(r.statusCode).toBe(200); + expect(r.headers["content-type"]).toMatch(/text\/calendar/); + expect(r.body).toContain("X-WR-CALNAME:Baustellen"); + expect(r.body).toMatch(/SUMMARY:P-26-\d+/); + expect((await app.inject(`/kalender/${kalenderToken}/aufgaben.ics`)).body).toContain("Aufgabe: Statik anfragen"); + expect((await app.inject(`/kalender/${kalenderToken.slice(0, -1)}${kalenderToken.endsWith("x") ? "y" : "x"}/baustellen.ics`)).statusCode).toBe(404); + }); }); diff --git a/test/ical.test.ts b/test/ical.test.ts new file mode 100644 index 0000000..4ffef96 --- /dev/null +++ b/test/ical.test.ts @@ -0,0 +1,22 @@ +import { describe, expect, it } from "vitest"; +import { kalender } from "../src/domain/ical.js"; +import { arbeitsbloecke } from "../src/server/kalender.js"; +import { STANDARDWOCHE as W } from "../src/domain/kalender.js"; + +describe("Kalender-Abo (T11)", () => { + it("ganztägige Termine, Ende am Folgetag, Sonderzeichen maskiert", () => { + const ics = kalender("Baustellen", [{ uid: "v1@x", von: "2026-10-26", bis: "2026-10-27", titel: "P-26-014 Abbund, Montage; HS" }], new Date("2026-10-19T08:00:00Z")); + expect(ics).toContain("DTSTART;VALUE=DATE:20261026\r\nDTEND;VALUE=DATE:20261028"); + expect(ics).toContain("SUMMARY:P-26-014 Abbund\\, Montage\\; HS"); + expect(ics).toContain("DTSTAMP:20261019T080000Z"); + expect(ics.endsWith("END:VCALENDAR\r\n")).toBe(true); + }); + it("lange Zeilen werden nach 75 Byte gefaltet", () => { + const ics = kalender("K", [{ uid: "u", von: "2026-10-26", bis: "2026-10-26", titel: "Ä".repeat(60) }]); + for (const z of ics.split("\r\n")) expect(new TextEncoder().encode(z).length).toBeLessThanOrEqual(75); + expect(ics.replace(/\r\n /g, "")).toContain("SUMMARY:" + "Ä".repeat(60)); + }); + it("Vorgang über Freitag und Wochenende wird in Arbeitsblöcke geteilt", () => { + expect(arbeitsbloecke("2026-10-21", "2026-10-27", W)).toEqual([["2026-10-21", "2026-10-22"], ["2026-10-26", "2026-10-27"]]); + }); +});