Kalender-Abos Baustellen und Aufgaben für Outlook classic, Caddy lässt /kalender ohne Anmeldung durch

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-19 19:04:14 +00:00
parent 8a4fbafa65
commit c2bbeff713
9 changed files with 245 additions and 6 deletions

View File

@@ -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}
}
}
}

72
src/domain/ical.ts Normal file
View File

@@ -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";
}

View File

@@ -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<FastifyInstance> {
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 });

View File

@@ -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<typeof EinstellungenSchema>;

61
src/server/kalender.ts Normal file
View File

@@ -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<string> {
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<string> {
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,
})));
}

View File

@@ -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 = `<p class="hinweis">Die Vorgänge aus dem Terminplan und fällige Aufgaben lassen sich als Internetkalender in Outlook einbinden.</p>
<p><button class="haupt">Kalender-Links erzeugen</button></p>`;
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]) =>
`<div class="kalender-link"><b>${titel}</b><input readonly value="${esc(link(datei!))}"><button class="neben" data-kopie="${esc(link(datei!))}">Kopieren</button></div>`).join("")}
<p class="hinweis">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.</p>
<p><button class="neben" data-a="neu">Neue Links erzeugen</button></p>`;
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<void> {
seite("Daten und Einstellungen");
const e = await api<Zeile>("einstellungen");
@@ -357,7 +385,10 @@ async function daten(): Promise<void> {
<p class="hinweis">Sicherungsdatei aus V70 wählen (projektplaner-sicherung-….json). Geht nur, solange noch nichts erfasst ist.</p>
<p><input type="file" id="v70-datei" accept=".json,application/json"></p>
<div id="v70-ergebnis"></div>
<h2>Kalender in Outlook</h2>
<div id="kalender"></div>
<h2>Einstellungen</h2>`);
kalenderLinks(e.kalenderToken);
const datei = document.getElementById("v70-datei") as HTMLInputElement;
datei.onchange = async () => {
const f = datei.files?.[0];

View File

@@ -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; }

View File

@@ -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);
});
});

22
test/ical.test.ts Normal file
View File

@@ -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"]]);
});
});