From a3bb310cea766fd2e27dc07a60dce222326d76a1 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 19 Oct 2026 19:07:03 +0000 Subject: [PATCH] Projektordner in der Nextcloud anlegen und je nach Status verschieben (P10) Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz --- deploy/.env.beispiel | 2 + deploy/docker-compose.yml | 3 ++ src/server/app.ts | 27 ++++++++++ src/server/index.ts | 6 ++- src/server/nextcloud.ts | 103 ++++++++++++++++++++++++++++++++++++++ src/web/app.ts | 12 +++-- test/api.test.ts | 36 +++++++++++++ test/falsche-nextcloud.ts | 36 +++++++++++++ test/nextcloud.test.ts | 35 +++++++++++++ 9 files changed, 256 insertions(+), 4 deletions(-) create mode 100644 src/server/nextcloud.ts create mode 100644 test/falsche-nextcloud.ts create mode 100644 test/nextcloud.test.ts diff --git a/deploy/.env.beispiel b/deploy/.env.beispiel index 3f21de2..3cb5ea2 100644 --- a/deploy/.env.beispiel +++ b/deploy/.env.beispiel @@ -14,3 +14,5 @@ BACKUP_UHRZEIT=02:30 NEXTCLOUD_URL=https://cloud.example.de/remote.php/dav/files/henning/Sicherungen/betrieb NEXTCLOUD_BENUTZER=henning NEXTCLOUD_PASSWORT=app-passwort-aus-nextcloud +# Ordner, in dem „01 Angebot“, „02 laufende Projekte“, „03 Gewährl.-Projekte“ und „04 Archiv“ liegen (P10) +NEXTCLOUD_PROJEKTE_URL=https://cloud.example.de/remote.php/dav/files/henning/Projekte diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml index 13798e1..c3d8fd5 100644 --- a/deploy/docker-compose.yml +++ b/deploy/docker-compose.yml @@ -41,6 +41,9 @@ services: image: ${IMAGE}:${APP_VERSION} environment: DATABASE_URL: postgres://betrieb:${DB_PASSWORT}@db:5432/betrieb + NEXTCLOUD_PROJEKTE_URL: ${NEXTCLOUD_PROJEKTE_URL:-} + NEXTCLOUD_BENUTZER: ${NEXTCLOUD_BENUTZER:-} + NEXTCLOUD_PASSWORT: ${NEXTCLOUD_PASSWORT:-} depends_on: db: { condition: service_healthy } db: diff --git a/src/server/app.ts b/src/server/app.ts index 2c34c14..f100abe 100644 --- a/src/server/app.ts +++ b/src/server/app.ts @@ -9,6 +9,7 @@ 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 { type Nextcloud, ordnerAbgleichen } from "./nextcloud.js"; import { TABELLEN } from "./tabellen.js"; import { EinstellungenSchema, type Einstellungen } from "./einstellungen.js"; import { liquiditaet } from "../domain/liquiditaet.js"; @@ -19,6 +20,8 @@ import { VERSION } from "./version.js"; export interface Optionen { pool: Pool; + /** P10: Projektordner in der Nextcloud; ohne Zugang wird nichts angelegt */ + nextcloud?: Nextcloud; webOrdner?: string; logger?: boolean; } @@ -56,6 +59,28 @@ export async function baueApp(o: Optionen): Promise { return { ok: true, version: VERSION }; }); + // P10: Ordner nach dem Speichern abgleichen. Ein Fehler in der Nextcloud macht die Änderung nicht + // rückgängig; der Hinweis kommt mit zurück, und der Abgleich lässt sich wiederholen. + async function mitOrdner(p: Record, wer: string): Promise> { + if (!o.nextcloud) return p; + try { + const pfad = await ordnerAbgleichen(o.nextcloud, p as { nummer: string; bezeichnung: string; status: string }, p.nextcloud_link ?? null); + if (pfad === p.nextcloud_link) return p; + return await transaktion(pool, wer, async (c) => (await c.query("update projekt set nextcloud_link = $2 where id = $1 returning *", [p.id, pfad])).rows[0]); + } catch (err) { + app.log.warn(err); + return { ...p, ordner_fehler: `Projektordner in der Nextcloud: ${(err as Error).message}` }; + } + } + + app.post("/api/projekte/:id/ordner", async (req, reply) => { + const { id } = IdParam.parse(req.params); + const p = (await pool.query("select * from projekt where id = $1", [id])).rows[0]; + if (!p) return reply.status(404).send({ fehler: "Nicht gefunden" }); + if (!o.nextcloud) return reply.status(409).send({ fehler: "Für die Projektordner ist kein Nextcloud-Zugang eingerichtet." }); + return mitOrdner(p, benutzer(req)); + }); + // Änderungen an Vorgängen und Verknüpfungen planen die Nachfolger in derselben Transaktion neu const PLAN = new Set(["vorgang", "vorgang_vorgaenger"]); async function geplant(c: Client, tabelle: string, fn: () => Promise, bewegt: string[] = []): Promise { @@ -89,6 +114,7 @@ export async function baueApp(o: Optionen): Promise { spalten.map((s) => daten[s]), )).rows[0]); }); + if (t.name === "projekt") return reply.status(201).send(await mitOrdner(row, benutzer(req))); return reply.status(201).send(row); }); @@ -108,6 +134,7 @@ export async function baueApp(o: Optionen): Promise { [id, ...spalten.map((s) => daten[s])], )).rows[0], t.name === "vorgang" && daten.start !== undefined ? [id] : []); }); + if (row && t.name === "projekt" && (daten.nummer || daten.bezeichnung || daten.status)) return mitOrdner(row, benutzer(req)); return row ?? reply.status(404).send({ fehler: "Nicht gefunden" }); }); diff --git a/src/server/index.ts b/src/server/index.ts index 701c4a0..3e34f8b 100644 --- a/src/server/index.ts +++ b/src/server/index.ts @@ -1,6 +1,7 @@ import { erstellePool } from "./db.js"; import { migriere } from "./migrate.js"; import { baueApp } from "./app.js"; +import { Nextcloud } from "./nextcloud.js"; const url = process.env.DATABASE_URL; if (!url) { @@ -10,7 +11,10 @@ if (!url) { const pool = erstellePool(url); await migriere(pool, (t) => console.log(t)); -const app = await baueApp({ pool, logger: true }); +// P10: Ordner der Projekte; gleicher Zugang wie für die Sicherung, eigene Adresse +const { NEXTCLOUD_PROJEKTE_URL: ncUrl, NEXTCLOUD_BENUTZER: ncBenutzer, NEXTCLOUD_PASSWORT: ncPasswort } = process.env; +const nextcloud = ncUrl && ncBenutzer && ncPasswort ? new Nextcloud({ url: ncUrl, benutzer: ncBenutzer, passwort: ncPasswort }) : undefined; +const app = await baueApp({ pool, logger: true, nextcloud }); const port = Number(process.env.PORT ?? 3000); await app.listen({ host: "0.0.0.0", port }); diff --git a/src/server/nextcloud.ts b/src/server/nextcloud.ts new file mode 100644 index 0000000..a9cbe8e --- /dev/null +++ b/src/server/nextcloud.ts @@ -0,0 +1,103 @@ +// P10: Projektordner in Hennings Nextcloud anlegen und je nach Status verschieben (WebDAV, App-Passwort). +// Statusordner und Unterordner wie in seiner Ablage (Henning, 18./19.10.2026). + +export interface NextcloudZugang { + /** WebDAV-Adresse des Ordners, in dem „01 Angebot“ … „04 Archiv“ liegen */ + url: string; + benutzer: string; + passwort: string; +} + +export const STATUSORDNER: Record = { + anfrage: "01 Angebot", + angebot: "01 Angebot", + auftrag: "02 laufende Projekte", + ausfuehrung: "02 laufende Projekte", + abgerechnet: "02 laufende Projekte", + gewaehrleistung: "03 Gewährl.-Projekte", + abgeschlossen: "04 Archiv", +}; + +export const UNTERORDNER = ["01 Auftrag", "01 Auftrag/03 Stundenlohnarb.", "02 Umsetzung", "03 Bilder"]; + +/** „P-26-020 Terrassendachsanierung“; Schrägstriche und Steuerzeichen sind in Ordnernamen nicht erlaubt. */ +export function ordnerName(nummer: string, bezeichnung: string): string { + return `${nummer} ${bezeichnung}`.replace(/[\\/:*?"<>|\u0000-\u001f]/g, "-").replace(/\s+/g, " ").trim(); +} + +export function zielPfad(p: { nummer: string; bezeichnung: string; status: string }): string { + return `${STATUSORDNER[p.status] ?? STATUSORDNER.anfrage}/${ordnerName(p.nummer, p.bezeichnung)}`; +} + +const kodiert = (pfad: string) => pfad.split("/").map(encodeURIComponent).join("/"); + +export class Nextcloud { + constructor(private z: NextcloudZugang, private abruf: typeof fetch = fetch) {} + + private adresse(pfad: string): string { + return `${this.z.url.replace(/\/+$/, "")}/${kodiert(pfad)}`; + } + + private async anfrage(methode: string, pfad: string, kopf: Record = {}, body?: string): Promise { + return this.abruf(this.adresse(pfad), { + method: methode, + headers: { authorization: `Basic ${btoa(`${this.z.benutzer}:${this.z.passwort}`)}`, ...kopf }, + body, + }); + } + + async gibtEs(pfad: string): Promise { + const r = await this.anfrage("PROPFIND", pfad, { depth: "0" }); + if (r.status === 404) return false; + if (r.ok || r.status === 207) return true; + throw new Error(`Nextcloud antwortet mit ${r.status} für ${pfad}`); + } + + /** Namen der Unterordner (eine Ebene) */ + async liste(pfad: string): Promise { + const r = await this.anfrage("PROPFIND", pfad, { depth: "1" }); + if (r.status === 404) return []; + if (r.status !== 207) throw new Error(`Nextcloud antwortet mit ${r.status} für ${pfad}`); + const xml = await r.text(); + const basis = new URL(this.adresse(pfad)).pathname.replace(/\/+$/, ""); + return [...xml.matchAll(/([^<]+)<\/d:href>/gi)] + .map((m) => decodeURIComponent(m[1]!).replace(/\/+$/, "")) + .filter((h) => h !== decodeURIComponent(basis) && h.startsWith(decodeURIComponent(basis))) + .map((h) => h.slice(decodeURIComponent(basis).length + 1)); + } + + async ordner(pfad: string): Promise { + const r = await this.anfrage("MKCOL", pfad); + if (!(r.status === 201 || r.status === 405)) throw new Error(`Ordner ${pfad} ließ sich nicht anlegen (${r.status})`); + } + + async verschiebe(von: string, nach: string): Promise { + const r = await this.anfrage("MOVE", von, { destination: this.adresse(nach), overwrite: "F" }); + if (!(r.status === 201 || r.status === 204)) throw new Error(`${von} ließ sich nicht nach ${nach} verschieben (${r.status})`); + } +} + +/** + * Bringt den Ordner eines Projekts an die richtige Stelle. `bisher` ist der zuletzt bekannte Pfad + * (projekt.nextcloud_link). Ohne bekannten Pfad wird ein vorhandener Ordner mit derselben Nummer in + * den Statusordnern gesucht und übernommen, sonst ein neuer mit Unterordnern angelegt. + * Gibt den neuen Pfad zurück. + */ +export async function ordnerAbgleichen(nc: Nextcloud, p: { nummer: string; bezeichnung: string; status: string }, bisher: string | null): Promise { + const ziel = zielPfad(p); + if (bisher === ziel && (await nc.gibtEs(ziel))) return ziel; + let quelle = bisher && (await nc.gibtEs(bisher)) ? bisher : null; + if (!quelle) { + for (const s of new Set(Object.values(STATUSORDNER))) { + const treffer = (await nc.liste(s)).find((n) => n === p.nummer || n.startsWith(`${p.nummer} `)); + if (treffer) { quelle = `${s}/${treffer}`; break; } + } + } + await nc.ordner(ziel.split("/")[0]!); + if (quelle && quelle !== ziel) await nc.verschiebe(quelle, ziel); + if (!quelle) { + await nc.ordner(ziel); + for (const u of UNTERORDNER) await nc.ordner(`${ziel}/${u}`); + } + return ziel; +} diff --git a/src/web/app.ts b/src/web/app.ts index b918e90..90e6ea6 100644 --- a/src/web/app.ts +++ b/src/web/app.ts @@ -118,12 +118,17 @@ function bestaetigen(frage: string): Promise { async function bearbeiten(pfad: string, titel: string, felder: Feld[], zeile: Zeile | null, vorgaben: Zeile = {}): Promise { const e = await dialog(titel, felder, zeile ?? vorgaben, !!zeile); if (!e) return false; + let antwort: Zeile | undefined; if (e.aktion === "loeschen") await api(`${pfad}/${zeile!.id}`, "DELETE"); - else if (zeile) await api(`${pfad}/${zeile.id}`, "PATCH", e.daten); - else await api(pfad, "POST", { ...vorgaben, ...e.daten }); + else if (zeile) antwort = await api(`${pfad}/${zeile.id}`, "PATCH", e.daten); + else antwort = await api(pfad, "POST", { ...vorgaben, ...e.daten }); + // gespeichert, aber z. B. der Projektordner in der Nextcloud hat nicht geklappt + if (antwort?.ordner_fehler) hinweisNachLaden = antwort.ordner_fehler; return true; } +let hinweisNachLaden = ""; + function tabelle(spalten: { titel: string; wert: (z: Zeile) => string; klasse?: string }[], zeilen: Zeile[], klick?: (z: Zeile) => void): HTMLTableElement { const t = document.createElement("table"); t.innerHTML = `${spalten.map((s) => `${esc(s.titel)}`).join("")} @@ -137,7 +142,8 @@ function tabelle(spalten: { titel: string; wert: (z: Zeile) => string; klasse?: // Kopf wie bei Plancraft: Titel links, Hauptknopf rechts; darunter eine Leiste für Filter function seite(titel: string, knopf?: { text: string; aktion: () => void }): HTMLElement { - inhalt.innerHTML = `

${esc(titel)}

`; + inhalt.innerHTML = `

${esc(titel)}

${hinweisNachLaden ? `
${esc(hinweisNachLaden)}
` : ""}`; + hinweisNachLaden = ""; if (knopf) { const b = document.createElement("button"); b.className = "haupt"; diff --git a/test/api.test.ts b/test/api.test.ts index 8add839..ddd699a 100644 --- a/test/api.test.ts +++ b/test/api.test.ts @@ -1,5 +1,6 @@ // Prüft Server und Datenbank zusammen. Läuft nur mit TEST_DATABASE_URL (lokal und in der CI). import { describe, it, expect, beforeAll, afterAll } from "vitest"; +import { falscheNextcloud } from "./falsche-nextcloud.js"; import type { FastifyInstance } from "fastify"; import { erstellePool, type Pool } from "../src/server/db.js"; import { migriere } from "../src/server/migrate.js"; @@ -231,3 +232,38 @@ describe.skipIf(!url)("Übernahme aus V70 über die API", () => { expect((await app.inject(`/kalender/${kalenderToken.slice(0, -1)}${kalenderToken.endsWith("x") ? "y" : "x"}/baustellen.ics`)).statusCode).toBe(404); }); }); + +describe.skipIf(!url)("Projektordner in der Nextcloud über die API", () => { + let pool: Pool; + let app: FastifyInstance; + const f = falscheNextcloud(); + + beforeAll(async () => { + pool = erstellePool(url!); + await pool.query("drop schema public cascade; create schema public;"); + await migriere(pool); + app = await baueApp({ pool, webOrdner: "/gibt-es-nicht", nextcloud: f.nc }); + }); + afterAll(async () => { + await app?.close(); + await pool?.end(); + }); + + it("neues Projekt bekommt einen Ordner, Statuswechsel verschiebt ihn", async () => { + const p = (await app.inject({ method: "POST", url: "/api/projekte", payload: { nummer: "A-26-130", bezeichnung: "Carport Most", status: "angebot" } })).json(); + expect(p.nextcloud_link).toBe("01 Angebot/A-26-130 Carport Most"); + const q = (await app.inject({ method: "PATCH", url: `/api/projekte/${p.id}`, payload: { nummer: "P-26-021", status: "auftrag" } })).json(); + expect(q.nextcloud_link).toBe("02 laufende Projekte/P-26-021 Carport Most"); + expect(f.relativ()).toContain("02 laufende Projekte/P-26-021 Carport Most/02 Umsetzung"); + }); + + it("Fehler der Nextcloud verhindert das Speichern nicht", async () => { + f.ordner.clear(); // Wurzel fehlt: jede Anlage schlägt fehl + const r = await app.inject({ method: "POST", url: "/api/projekte", payload: { nummer: "A-26-131", bezeichnung: "Gaube", status: "angebot" } }); + expect(r.statusCode).toBe(201); + expect(r.json().ordner_fehler).toMatch(/Nextcloud/); + f.ordner.add(f.wurzel); + const nochmal = (await app.inject({ method: "POST", url: `/api/projekte/${r.json().id}/ordner` })).json(); + expect(nochmal.nextcloud_link).toBe("01 Angebot/A-26-131 Gaube"); + }); +}); diff --git a/test/falsche-nextcloud.ts b/test/falsche-nextcloud.ts new file mode 100644 index 0000000..325a7cd --- /dev/null +++ b/test/falsche-nextcloud.ts @@ -0,0 +1,36 @@ +import { Nextcloud } from "../src/server/nextcloud.js"; + +/** Kleine WebDAV-Nachbildung im Speicher: nur Ordner, wie Nextcloud sie beantwortet */ +export function falscheNextcloud(basis = "https://cloud.test/remote.php/dav/files/henning/Projekte") { + const ordner = new Set(); + const pfad = (u: string) => decodeURIComponent(new URL(u).pathname).replace(/\/+$/, ""); + const wurzel = pfad(basis); + ordner.add(wurzel); + const abruf = (async (u: string | URL, init?: RequestInit) => { + const p = pfad(String(u)); + const kopf = (init?.headers ?? {}) as Record; + const eltern = p.slice(0, p.lastIndexOf("/")); + switch (init?.method) { + case "PROPFIND": { + if (!ordner.has(p)) return new Response(null, { status: 404 }); + const kinder = kopf.depth === "1" ? [...ordner].filter((o) => o.startsWith(p + "/") && !o.slice(p.length + 1).includes("/")) : []; + const hrefs = [p, ...kinder].map((o) => `${o.split("/").map(encodeURIComponent).join("/")}/`).join(""); + return new Response(`${hrefs}`, { status: 207 }); + } + case "MKCOL": + if (ordner.has(p)) return new Response(null, { status: 405 }); + if (!ordner.has(eltern)) return new Response(null, { status: 409 }); + ordner.add(p); + return new Response(null, { status: 201 }); + case "MOVE": { + const ziel = pfad(kopf.destination!); + if (!ordner.has(p) || ordner.has(ziel) || !ordner.has(ziel.slice(0, ziel.lastIndexOf("/")))) return new Response(null, { status: 409 }); + for (const o of [...ordner]) if (o === p || o.startsWith(p + "/")) { ordner.delete(o); ordner.add(ziel + o.slice(p.length)); } + return new Response(null, { status: 201 }); + } + } + return new Response(null, { status: 400 }); + }) as typeof fetch; + const relativ = () => [...ordner].filter((o) => o !== wurzel).map((o) => o.slice(wurzel.length + 1)).sort(); + return { nc: new Nextcloud({ url: basis, benutzer: "henning", passwort: "geheim" }, abruf), ordner, wurzel, relativ }; +} diff --git a/test/nextcloud.test.ts b/test/nextcloud.test.ts new file mode 100644 index 0000000..ccfff2b --- /dev/null +++ b/test/nextcloud.test.ts @@ -0,0 +1,35 @@ +import { describe, expect, it } from "vitest"; +import { ordnerAbgleichen, ordnerName } from "../src/server/nextcloud.js"; +import { falscheNextcloud } from "./falsche-nextcloud.js"; + +describe("Projektordner in der Nextcloud (P10)", () => { + it("Ordnername ohne verbotene Zeichen", () => { + expect(ordnerName("P-26-020", "Terrassendach / Carport")).toBe("P-26-020 Terrassendach - Carport"); + }); + + it("legt neu an mit Unterordnern und verschiebt nach Status und Umbenennung", async () => { + const f = falscheNextcloud(); + const p = { nummer: "A-26-120", bezeichnung: "Terrassendachsanierung", status: "angebot" }; + let pfad = await ordnerAbgleichen(f.nc, p, null); + expect(pfad).toBe("01 Angebot/A-26-120 Terrassendachsanierung"); + expect(f.relativ()).toContain("01 Angebot/A-26-120 Terrassendachsanierung/01 Auftrag/03 Stundenlohnarb."); + // Angebot angenommen: neue Nummer und Status Auftrag + pfad = await ordnerAbgleichen(f.nc, { ...p, nummer: "P-26-020", status: "auftrag" }, pfad); + expect(pfad).toBe("02 laufende Projekte/P-26-020 Terrassendachsanierung"); + expect(f.relativ()).toContain("02 laufende Projekte/P-26-020 Terrassendachsanierung/03 Bilder"); + expect(f.relativ().some((o) => o.startsWith("01 Angebot/"))).toBe(false); + pfad = await ordnerAbgleichen(f.nc, { ...p, nummer: "P-26-020", status: "gewaehrleistung" }, pfad); + expect(pfad).toBe("03 Gewährl.-Projekte/P-26-020 Terrassendachsanierung"); + }); + + it("übernimmt einen vorhandenen Ordner mit gleicher Nummer statt einen zweiten anzulegen", async () => { + const f = falscheNextcloud(); + f.ordner.add(`${f.wurzel}/02 laufende Projekte`); + f.ordner.add(`${f.wurzel}/02 laufende Projekte/P-26-014 Bohlentausch Stadt`); + f.ordner.add(`${f.wurzel}/02 laufende Projekte/P-26-014 Bohlentausch Stadt/Fotos`); + const pfad = await ordnerAbgleichen(f.nc, { nummer: "P-26-014", bezeichnung: "Bohlentausch", status: "abgeschlossen" }, null); + expect(pfad).toBe("04 Archiv/P-26-014 Bohlentausch"); + expect(f.relativ()).toContain("04 Archiv/P-26-014 Bohlentausch/Fotos"); + expect(f.relativ().filter((o) => o.includes("P-26-014"))).toHaveLength(2); + }); +});