Projektseite wie Plancraft, Zahlungsplan automatisch, Spaltenbreiten im Terminplan (0.6.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:01:09 +00:00
parent 18e3472f45
commit de49fec216
15 changed files with 574 additions and 168 deletions

View File

@@ -7,6 +7,7 @@ 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 { legeZahlungsplanAn, zahlungsplanFest, zahlungsplaeneAutomatisch } from "./zahlungsplan.js";
import { uebersicht } from "./uebersicht.js";
import { aufgabenKalender, baustellenKalender } from "./kalender.js";
import { type Nextcloud, ordnerAbgleichen } from "./nextcloud.js";
@@ -14,8 +15,6 @@ import { TABELLEN } from "./tabellen.js";
import { EinstellungenSchema, type Einstellungen } from "./einstellungen.js";
import { liquiditaet } from "../domain/liquiditaet.js";
import { liquiditaetsDaten } from "../domain/projektplan.js";
import { schlageZahlungsplanVor } from "../domain/geld.js";
import { anfang, ende } from "../domain/terminplan.js";
import { uebernimmV70 } from "../domain/v70.js";
import { speichereUebernahme } from "./v70import.js";
import { pruefeStand, speichereStand } from "./stand.js";
@@ -84,26 +83,48 @@ export async function baueApp(o: Optionen): Promise<FastifyInstance> {
return mitOrdner(p, benutzer(req));
});
// Standard-Zahlungsplan als Meilensteine vorschlagen (P9, Henning 20.10.2026), nur solange das Projekt noch keine Raten hat
// Ablage auf der Projektseite (Henning, 20.10.2026): Inhalt des Nextcloud-Projektordners anzeigen und Dateien öffnen
const AblageAnfrage = z.object({ pfad: z.string().max(500).default("") })
.refine((q) => !q.pfad.split("/").some((t) => t === ".." || t === "."), { message: "Pfad ungültig" });
async function ablagePfad(id: string, unter: string): Promise<string | null> {
const p = (await pool.query("select nextcloud_link from projekt where id = $1", [id])).rows[0];
if (!p) return null;
return [p.nextcloud_link, unter.replace(/^\/+|\/+$/g, "")].filter(Boolean).join("/");
}
app.get("/api/projekte/:id/ablage", async (req, reply) => {
const { id } = IdParam.parse(req.params);
const { pfad } = AblageAnfrage.parse(req.query);
if (!o.nextcloud) return reply.status(409).send({ fehler: "Die Ablage zeigt den Projektordner in der Nextcloud. Das geht, sobald das Programm auf dem Server läuft." });
const p = (await pool.query("select nextcloud_link from projekt where id = $1", [id])).rows[0];
if (!p) return reply.status(404).send({ fehler: "Nicht gefunden" });
if (!p.nextcloud_link) return reply.status(409).send({ fehler: "Für dieses Projekt gibt es noch keinen Ordner in der Nextcloud." });
const eintraege = await o.nextcloud.inhalt((await ablagePfad(id, pfad))!);
if (!eintraege) return reply.status(404).send({ fehler: "Ordner nicht gefunden" });
return { ordner: p.nextcloud_link, pfad, eintraege };
});
app.get("/api/projekte/:id/ablage/datei", async (req, reply) => {
const { id } = IdParam.parse(req.params);
const { pfad } = AblageAnfrage.parse(req.query);
if (!o.nextcloud || !pfad) return reply.status(404).send({ fehler: "Nicht gefunden" });
const voll = await ablagePfad(id, pfad);
if (!voll) return reply.status(404).send({ fehler: "Nicht gefunden" });
const r = await o.nextcloud.datei(voll);
const name = pfad.split("/").at(-1)!;
reply.header("content-type", r.headers.get("content-type") ?? "application/octet-stream");
reply.header("content-disposition", `inline; filename*=UTF-8''${encodeURIComponent(name)}`);
return reply.send(Buffer.from(await r.arrayBuffer()));
});
// Standard-Zahlungsplan von Hand anlegen (P9), z. B. für schon laufende Projekte; nur solange das Projekt keine Raten hat
app.post("/api/projekte/:id/zahlungsplan", async (req, reply) => {
const { id } = IdParam.parse(req.params);
const p = (await pool.query("select id, umsatz_netto from projekt where id = $1", [id])).rows[0];
if (!p) return reply.status(404).send({ fehler: "Nicht gefunden" });
if (!(Number(p.umsatz_netto) > 0)) return reply.status(400).send({ fehler: "Bitte zuerst beim Projekt den Auftragswert (Umsatz netto) eintragen." });
const e = await ladeEinstellungen();
const woche = { tage: e.arbeitstage };
const raten = await transaktion(pool, benutzer(req), async (c) => {
if ((await c.query("select 1 from zahlung where projekt_id = $1 limit 1", [id])).rowCount) return null;
const vs = (await c.query(`select v.id, v.name, v.start, v.dauer from vorgang v join abschnitt a on a.id = v.abschnitt_id where a.projekt_id = $1`, [id])).rows
.map((v) => ({ id: v.id, name: v.name, anfang: anfang({ ...v, dauer: Number(v.dauer) }, woche), ende: ende({ ...v, dauer: Number(v.dauer) }, woche) }));
const vorschlag = schlageZahlungsplanVor(Number(p.umsatz_netto), vs, new Date().toISOString().slice(0, 10));
const neu = [];
for (const [i, z] of vorschlag.entries()) {
neu.push((await c.query(
`insert into zahlung (projekt_id, vorgang_id, art, bezeichnung, netto, termin, status, reihenfolge) values ($1, $2, $3, $4, $5, $6, 'geplant', $7) returning *`,
[id, z.vorgang_id, z.art, z.bezeichnung, z.netto, z.termin, i])).rows[0]);
}
return neu;
return legeZahlungsplanAn(c, id, Number(p.umsatz_netto), { tage: e.arbeitstage });
});
if (!raten) return reply.status(409).send({ fehler: "Das Projekt hat schon einen Zahlungsplan." });
return reply.status(201).send(raten);
@@ -111,11 +132,20 @@ export async function baueApp(o: Optionen): Promise<FastifyInstance> {
// Änderungen an Vorgängen und Verknüpfungen planen die Nachfolger in derselben Transaktion neu
const PLAN = new Set(["vorgang", "vorgang_vorgaenger", "zahlung"]);
async function geplant<T>(c: Client, tabelle: string, fn: () => Promise<T>, bewegt: string[] = []): Promise<T> {
if (!PLAN.has(tabelle)) return fn();
// P12: Projektänderungen legen den Zahlungsplan an oder führen ihn nach; eine Rate von Hand ändern stellt ihn fest
async function geplant<T>(c: Client, tabelle: string, fn: () => Promise<T>, bewegt: string[] = [], zahlungVon?: string): Promise<T> {
const e = await ladeEinstellungen();
return (await mitNeuplanung(c, { tage: e.arbeitstage }, fn, bewegt)).ergebnis;
if (tabelle === "projekt") {
const ergebnis = await fn();
await zahlungsplaeneAutomatisch(c, { tage: e.arbeitstage });
return ergebnis;
}
if (!PLAN.has(tabelle)) return fn();
const aenderung = zahlungVon ? async () => { const r = await fn(); await zahlungsplanFest(c, zahlungVon); return r; } : fn;
return (await mitNeuplanung(c, { tage: e.arbeitstage }, aenderung, bewegt)).ergebnis;
}
const projektDerZahlung = async (c: Client, tabelle: string, id: string) =>
tabelle === "zahlung" ? (await c.query("select projekt_id from zahlung where id = $1", [id])).rows[0]?.projekt_id as string | undefined : undefined;
for (const t of TABELLEN) {
const felder = Object.keys(t.schema.shape);
@@ -140,7 +170,7 @@ export async function baueApp(o: Optionen): Promise<FastifyInstance> {
? `insert into ${t.name} (${spalten.join(", ")}) values (${spalten.map((_, i) => `$${i + 1}`).join(", ")}) returning *`
: `insert into ${t.name} default values returning *`,
spalten.map((s) => daten[s]),
)).rows[0]);
)).rows[0], [], t.name === "zahlung" ? daten.projekt_id as string : undefined);
});
if (t.name === "projekt") return reply.status(201).send(await mitOrdner(row, benutzer(req)));
return reply.status(201).send(row);
@@ -156,11 +186,12 @@ export async function baueApp(o: Optionen): Promise<FastifyInstance> {
const alt = (await c.query("select vorgang_id, vorgaenger_id from vorgang_vorgaenger where id = $1", [id])).rows[0];
if (alt) await pruefeVerknuepfung(c, { ...alt, ...daten } as { vorgang_id: string; vorgaenger_id: string }, id);
}
const zahlungVon = await projektDerZahlung(c, t.name, id);
return geplant(c, t.name, async () =>
(await c.query(
`update ${t.name} set ${spalten.map((s, i) => `${s} = $${i + 2}`).join(", ")} where id = $1 returning *`,
[id, ...spalten.map((s) => daten[s])],
)).rows[0], t.name === "vorgang" && daten.start !== undefined ? [id] : []);
)).rows[0], t.name === "vorgang" && daten.start !== undefined ? [id] : [], zahlungVon);
});
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" });
@@ -169,7 +200,7 @@ export async function baueApp(o: Optionen): Promise<FastifyInstance> {
app.delete(`/api/${t.pfad}/:id`, async (req, reply) => {
const { id } = IdParam.parse(req.params);
const n = await transaktion(pool, benutzer(req), async (c) =>
geplant(c, t.name, async () => (await c.query(`delete from ${t.name} where id = $1`, [id])).rowCount));
geplant(c, t.name, async () => (await c.query(`delete from ${t.name} where id = $1`, [id])).rowCount, [], await projektDerZahlung(c, t.name, id)));
return n ? reply.status(204).send() : reply.status(404).send({ fehler: "Nicht gefunden" });
});
}

View File

@@ -0,0 +1,8 @@
-- P12: Zahlungsplan automatisch (Henning, 20.10.2026). 'auto': vom Programm angelegt, folgt Auftragswert und Terminen;
-- 'fest': von Hand geändert oder schon vorhanden, bleibt wie er ist; leer: noch keiner angelegt.
-- Schon laufende Projekte bekommen keinen automatischen Plan, damit dort keine Anzahlung von heute auftaucht,
-- die längst bezahlt ist; dort lässt er sich auf der Projektseite von Hand anlegen.
alter table projekt add column zahlungsplan text check (zahlungsplan in ('auto', 'fest'));
update projekt set zahlungsplan = 'fest'
where exists (select 1 from zahlung z where z.projekt_id = projekt.id)
or status in ('ausfuehrung', 'abgerechnet', 'gewaehrleistung', 'abgeschlossen');

View File

@@ -8,6 +8,13 @@ export interface NextcloudZugang {
passwort: string;
}
export interface AblageEintrag {
name: string;
ordner: boolean;
groesse: number;
geaendert: string | null;
}
export const STATUSORDNER: Record<string, string> = {
anfrage: "01 Angebot",
angebot: "01 Angebot",
@@ -66,6 +73,37 @@ export class Nextcloud {
.map((h) => h.slice(decodeURIComponent(basis).length + 1));
}
/** Inhalt eines Ordners mit Art, Größe und Änderungsdatum, Ordner zuerst (Ablage auf der Projektseite) */
async inhalt(pfad: string): Promise<AblageEintrag[] | null> {
const r = await this.anfrage("PROPFIND", pfad, { depth: "1" });
if (r.status === 404) return null;
if (r.status !== 207) throw new Error(`Nextcloud antwortet mit ${r.status} für ${pfad}`);
const xml = await r.text();
const basis = decodeURIComponent(new URL(this.adresse(pfad)).pathname.replace(/\/+$/, ""));
const eintraege: AblageEintrag[] = [];
for (const m of xml.matchAll(/<d:response>([\s\S]*?)<\/d:response>/gi)) {
const teil = m[1]!;
const href = decodeURIComponent(/<d:href>([^<]+)<\/d:href>/i.exec(teil)?.[1] ?? "").replace(/\/+$/, "");
if (href === basis || !href.startsWith(basis + "/")) continue;
const wert = (tag: string) => new RegExp(`<d:${tag}>([^<]*)</d:${tag}>`, "i").exec(teil)?.[1];
eintraege.push({
name: href.slice(basis.length + 1),
ordner: /<d:collection\s*\/>/i.test(teil),
groesse: Number(wert("getcontentlength") ?? 0),
geaendert: wert("getlastmodified") ? new Date(wert("getlastmodified")!).toISOString() : null,
});
}
return eintraege.sort((a, b) => Number(b.ordner) - Number(a.ordner) || a.name.localeCompare(b.name, "de"));
}
/** Eine Datei abrufen, um sie durchzureichen */
async datei(pfad: string): Promise<Response> {
const r = await this.anfrage("GET", pfad);
if (r.status === 404) throw Object.assign(new Error("Datei nicht gefunden"), { statusCode: 404 });
if (!r.ok) throw new Error(`Nextcloud antwortet mit ${r.status} für ${pfad}`);
return r;
}
async ordner(pfad: string): Promise<void> {
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})`);

View File

@@ -43,5 +43,11 @@ export async function speichereStand(c: Client, s: Stand): Promise<Record<string
await c.query("update einstellungen set daten = $1", [EinstellungenSchema.parse(s.einstellungen)]);
}
await c.query("select setval('vorgang_nummer_seq', greatest((select max(nummer) from vorgang), 1000))");
// Sicherung von vor 0.6.0: dieselbe Regel wie Migration 006, damit laufende Projekte keinen automatischen Zahlungsplan bekommen
if (!(s.daten.projekte ?? []).some((p) => "zahlungsplan" in p)) {
await c.query(`update projekt set zahlungsplan = 'fest'
where exists (select 1 from zahlung z where z.projekt_id = projekt.id)
or status in ('ausfuehrung', 'abgerechnet', 'gewaehrleistung', 'abgeschlossen')`);
}
return anzahl;
}

View File

@@ -1,5 +1,6 @@
// Terminplan auf dem Server: Laden für das Gantt und Neuplanung der Nachfolger nach jeder
// Änderung an Vorgängen oder Verknüpfungen, in derselben Transaktion.
import { zahlungsplaeneAutomatisch } from "./zahlungsplan.js";
import type { Client, Pool } from "./db.js";
import type { Arbeitswoche } from "../domain/kalender.js";
import { kuerzel, ueberschneidungen } from "../domain/einsatz.js";
@@ -39,6 +40,7 @@ export async function mitNeuplanung<T>(
}
for (const [id, start] of starts) await c.query("update vorgang set start = $2 where id = $1", [id, start]);
await zahlungenNachziehen(c, woche);
await zahlungsplaeneAutomatisch(c, woche);
return { ergebnis, verschoben: [...starts.keys()] };
}
@@ -64,7 +66,7 @@ export async function pruefeVerknuepfung(c: Client, neu: { vorgang_id: string; v
/** Alles, was das Gantt braucht, mit berechnetem Anfang und Ende je Vorgang. */
export async function terminplan(pool: Pool, woche: Arbeitswoche) {
const [projekte, abschnitte, vorgaenge, links, besetzungen, leute, zahlungen] = await Promise.all([
pool.query(`select p.id, p.nummer, p.bezeichnung, p.status, p.farbe, p.reihenfolge, k.name as bauherr
pool.query(`select p.id, p.nummer, p.bezeichnung, p.status, p.farbe, p.reihenfolge, p.umsatz_netto, p.zahlungsplan, k.name as bauherr
from projekt p left join kontakt k on k.id = p.bauherr_id order by p.reihenfolge, p.nummer`),
pool.query("select id, projekt_id, name, ist_meilenstein, reihenfolge from abschnitt order by reihenfolge, name"),
pool.query("select id, abschnitt_id, nummer, name, start, dauer, stunden, personen, kontakt_id, fortschritt, reihenfolge from vorgang order by reihenfolge, nummer"),

View File

@@ -52,6 +52,9 @@ export async function speichereUebernahme(c: Client, u: Uebernahme): Promise<Rec
for (const l of u.laufend) await einfuegen(c, "laufende_kosten", l);
for (const { projekt, ...a } of u.aufgaben) await einfuegen(c, "aufgabe", { ...a, projekt_id: ref(projekt) });
// V70-Zahlen bleiben wie in V70: kein automatischer Zahlungsplan für übernommene Projekte (P12)
await c.query("update projekt set zahlungsplan = 'fest'");
const alt = await c.query<{ daten: unknown }>("select daten from einstellungen limit 1");
const bisher = EinstellungenSchema.parse(alt.rows[0]?.daten ?? {});
const neu = EinstellungenSchema.parse({ ...bisher, ...u.einstellungen, zahlungsziele: u.einstellungen.zahlungsziele });

View File

@@ -0,0 +1,59 @@
// P9/P12: Zahlungsplan automatisch (Henning, 20.10.2026). Sobald ein Projekt einen Auftragswert und Termine hat,
// entstehen die Raten 30/40/20/10 als Meilensteine im Terminplan. Solange niemand sie von Hand ändert, folgen sie
// dem Auftragswert und den Vorgängen (z. B. wenn später ein Vorgang „Richten“ dazukommt). Jede Änderung von Hand
// stellt den Plan auf „fest“; er wird dann nie wieder automatisch angefasst oder neu angelegt.
import type { Client } from "pg";
import { schlageZahlungsplanVor } from "../domain/geld.js";
import { anfang, ende } from "../domain/terminplan.js";
import type { Arbeitswoche } from "../domain/kalender.js";
const heute = () => new Date().toISOString().slice(0, 10);
async function vorschlag(c: Client, projektId: string, umsatz: number, woche: Arbeitswoche) {
const vs = (await c.query(`select v.id, v.name, v.start, v.dauer from vorgang v join abschnitt a on a.id = v.abschnitt_id
where a.projekt_id = $1 order by a.reihenfolge, v.reihenfolge, v.nummer`, [projektId])).rows
.map((v) => ({ id: v.id, name: v.name, anfang: anfang({ ...v, dauer: Number(v.dauer) }, woche), ende: ende({ ...v, dauer: Number(v.dauer) }, woche) }));
return schlageZahlungsplanVor(umsatz, vs, heute());
}
export async function legeZahlungsplanAn(c: Client, projektId: string, umsatz: number, woche: Arbeitswoche): Promise<Record<string, unknown>[]> {
const neu = [];
for (const [i, z] of (await vorschlag(c, projektId, umsatz, woche)).entries()) {
neu.push((await c.query(
`insert into zahlung (projekt_id, vorgang_id, art, bezeichnung, netto, termin, status, reihenfolge) values ($1, $2, $3, $4, $5, $6, 'geplant', $7) returning *`,
[projektId, z.vorgang_id, z.art, z.bezeichnung, z.netto, z.termin, i])).rows[0]);
}
await c.query("update projekt set zahlungsplan = 'auto' where id = $1", [projektId]);
return neu;
}
/** Nach jeder Änderung an Projekten oder Terminen: neue Pläne anlegen, automatische nachführen. */
export async function zahlungsplaeneAutomatisch(c: Client, woche: Arbeitswoche): Promise<void> {
const neu = await c.query<{ id: string; umsatz_netto: string }>(
`select p.id, p.umsatz_netto from projekt p
where p.zahlungsplan is null and p.umsatz_netto > 0
and exists (select 1 from vorgang v join abschnitt a on a.id = v.abschnitt_id where a.projekt_id = p.id)
and not exists (select 1 from zahlung z where z.projekt_id = p.id)`);
for (const p of neu.rows) await legeZahlungsplanAn(c, p.id, Number(p.umsatz_netto), woche);
const auto = await c.query<{ id: string; umsatz_netto: string }>("select id, umsatz_netto from projekt where zahlungsplan = 'auto'");
for (const p of auto.rows) {
const raten = (await c.query("select id, vorgang_id, netto, termin, status from zahlung where projekt_id = $1 order by reihenfolge, termin", [p.id])).rows;
const soll = Number(p.umsatz_netto) > 0 ? await vorschlag(c, p.id, Number(p.umsatz_netto), woche) : [];
if (raten.length !== soll.length || raten.some((z) => z.status !== "geplant")) {
await c.query("update projekt set zahlungsplan = 'fest' where id = $1", [p.id]);
continue;
}
for (const [i, z] of raten.entries()) {
const s = soll[i]!;
if (z.vorgang_id !== s.vorgang_id || Number(z.netto) !== s.netto || z.termin !== s.termin) {
await c.query("update zahlung set vorgang_id = $2, netto = $3, termin = $4 where id = $1", [z.id, s.vorgang_id, s.netto, s.termin]);
}
}
}
}
/** Eine Rate wurde von Hand angelegt, geändert oder gelöscht: der Plan dieses Projekts ist ab jetzt fest. */
export async function zahlungsplanFest(c: Client, projektId: string): Promise<void> {
await c.query("update projekt set zahlungsplan = 'fest' where id = $1 and zahlungsplan is distinct from 'fest'", [projektId]);
}