0.49.0: Anschrift mit z. Hd. und Briefanrede in Angeboten, Rechnungsanschrift im Projekt
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
This commit is contained in:
Claude
2026-11-08 14:12:56 +00:00
parent 2c1d571c94
commit cfa656e98f
12 changed files with 259 additions and 7 deletions

105
src/domain/brief.ts Normal file
View File

@@ -0,0 +1,105 @@
// Anschrift mit „z. Hd.“ und Briefanrede (Henning, 08.11.2026) für Angebote, Kostenvoranschläge und die
// Rechnungsanschrift. Kunde ist eine Person oder ein übergeordneter Kontakt (Firma, Behörde, Familie, Ehepaar, WEG).
import type { Anschrift } from "./kontaktdaten.js";
export interface BriefKontakt {
name: string;
anrede?: string | null;
titel?: string | null;
/** null: Person */
art?: string | null;
/** frei eingetragene Firma einer Person */
firma?: string | null;
adressen?: Anschrift[] | null;
}
/** Ein Mensch, der zum Kunden oder zum Projekt gehört, mit seinen Zuständigkeiten (haupt, rechnungen, baustelle, planung) */
export interface BriefPerson {
kontakt: BriefKontakt;
/** Ansprechpartner im Projekt: Zuständigkeiten dort; null: nicht im Projekt eingetragen */
imProjekt: string[] | null;
/** Ansprechpartner des Kunden (übergeordneter Kontakt): Zuständigkeiten dort; null: gehört nicht dazu */
imKunden: string[] | null;
}
export interface Empfaenger {
/** Anschriftzeilen, die erste ist der Name */
zeilen: string[];
/** „z. Hd. Herrn Dipl.-Ing. Jan Petersen“ oder null */
zHd: string | null;
/** „Sehr geehrter Herr Petersen,“ */
anrede: string;
}
/** z. Hd. nur bei Firmen, Behörden und Eigentümergemeinschaften; Familie und Ehepaar stehen schon mit Namen in der Anschrift */
const MIT_ZHD = new Set(["firma", "behoerde", "weg"]);
const DAMEN_HERREN = "Sehr geehrte Damen und Herren,";
const t = (s: string | null | undefined) => (s ?? "").trim();
/** Nachname: letztes Wort, „Petersen“ aus „Jan Petersen“ */
export const nachname = (name: string) => t(name).split(/\s+/).at(-1) ?? "";
/** „Herrn Dr. Jan Petersen“, „Frau Anna Petersen“, „Familie Petersen“ */
export function anschriftName(k: BriefKontakt): string {
const a = t(k.anrede);
const vor = a === "Herr" ? "Herrn" : a === "Frau" ? "Frau" : "";
if (a === "Familie" || a === "Eheleute") return `${a} ${nachname(k.name)}`;
return [vor, t(k.titel), t(k.name)].filter(Boolean).join(" ");
}
/** „Sehr geehrter Herr Dr. Petersen,“ – ohne passende Anrede null */
export function persoenlicheAnrede(k: BriefKontakt): string | null {
const a = t(k.anrede), n = [t(k.titel), nachname(k.name)].filter(Boolean).join(" ");
if (!nachname(k.name)) return null;
if (a === "Herr") return `Sehr geehrter Herr ${n},`;
if (a === "Frau") return `Sehr geehrte Frau ${n},`;
if (a === "Familie") return `Sehr geehrte Familie ${nachname(k.name)},`;
if (a === "Eheleute") return `Sehr geehrte Eheleute ${nachname(k.name)},`;
return null;
}
/** Adresse für den Zweck: zur Rechnung die Rechnungsadresse, sonst die Hauptadresse */
function adresse(k: BriefKontakt, zweck: "angebot" | "rechnung"): string[] {
const l = (k.adressen ?? []).filter((a) => t(a.strasse) || t(a.plz) || t(a.ort) || t(a.postfach));
const a = (zweck === "rechnung" ? l.find((x) => x.typ === "rechnung") : undefined) ?? l.find((x) => x.haupt) ?? l[0];
if (!a) return [];
const land = t(a.land);
return [
t(a.postfach) && !t(a.strasse) ? t(a.postfach) : t(a.strasse), t(a.zusatz),
[t(a.plz), t(a.ort)].filter(Boolean).join(" "),
land && !/^(deutschland|germany|de|d)$/i.test(land) ? land.toUpperCase() : "",
].filter(Boolean);
}
/** Wer bekommt das Schreiben persönlich: zuerst im Projekt, dann beim Kunden; zur Rechnung zuerst „Rechnungen“, dann „Haupt“ */
function zuHaenden(leute: BriefPerson[], zweck: "angebot" | "rechnung"): BriefPerson | undefined {
for (const z of zweck === "rechnung" ? ["rechnungen", "haupt"] : ["haupt"]) {
const p = leute.find((x) => x.imProjekt?.includes(z)) ?? leute.find((x) => x.imKunden?.includes(z));
if (p) return p;
}
return undefined;
}
export function empfaenger(kunde: BriefKontakt | null, leute: BriefPerson[], zweck: "angebot" | "rechnung" = "angebot"): Empfaenger {
if (!kunde) return { zeilen: [], zHd: null, anrede: DAMEN_HERREN };
const art = kunde.art ?? null;
if (!art) {
// Person: „Herrn Dr. Jan Petersen“, Anrede aus Anrede und Titel
return { zeilen: [anschriftName(kunde), ...(t(kunde.firma) ? [t(kunde.firma)] : []), ...adresse(kunde, zweck)], zHd: null, anrede: persoenlicheAnrede(kunde) ?? DAMEN_HERREN };
}
if (art === "familie" || art === "ehepaar") {
// „Sehr geehrte Frau X, sehr geehrter Herr X“ aus den Ansprechpartnern mit Anrede, Frauen zuerst
const mit = leute.filter((p) => p.imKunden !== null && ["Frau", "Herr"].includes(t(p.kontakt.anrede)))
.sort((a, b) => (t(a.kontakt.anrede) === "Frau" ? 0 : 1) - (t(b.kontakt.anrede) === "Frau" ? 0 : 1));
const teile = mit.map((p) => persoenlicheAnrede(p.kontakt)!.replace(/,$/, ""));
const anrede = teile.length
? `${teile.map((x, i) => (i === 0 ? x : x.replace(/^Sehr/, "sehr"))).join(", ")},`
: /^familie\s+\S/i.test(t(kunde.name)) ? `Sehr geehrte ${t(kunde.name)},` : DAMEN_HERREN;
return { zeilen: [t(kunde.name), ...adresse(kunde, zweck)], zHd: null, anrede };
}
// Firma, Behörde, WEG: z. Hd. des Ansprechpartners, Anrede persönlich an ihn
const p = MIT_ZHD.has(art) ? zuHaenden(leute, zweck) : undefined;
const zHd = p ? `z. Hd. ${anschriftName(p.kontakt)}` : null;
return {
zeilen: [t(kunde.name), ...(zHd ? [zHd] : []), ...adresse(kunde, zweck)], zHd,
anrede: (p && persoenlicheAnrede(p.kontakt)) ?? DAMEN_HERREN,
};
}

View File

@@ -1,6 +1,7 @@
// Stufe 3a (Henning, 20.10.2026): Angebote mit Kalkulation. Anlegen mit festgeschriebenen Sätzen (A36),
// Versandprüfung (A14), Kalkulationsstand beim Versand und bei Auftrag (A19), „Angebot annehmen“ macht aus dem
// Projekt den Auftrag mit Abschnitten, Vorgängen und Zahlungsplan (A4, P9).
import { empfaengerLaden } from "./empfaenger.js";
import type { FastifyInstance, FastifyRequest } from "fastify";
import { z } from "zod";
import { type Client, type Pool, transaktion } from "./db.js";
@@ -59,7 +60,9 @@ export async function ladeAngebot(c: Pick<Pool, "query">, id: string, e: Einstel
const saetze = saetzeVon(angebot, e);
const titel = t.rows as KTitel[], positionen = p.rows as (KPosition & { langtext?: string | null })[], kosten = k.rows as KKosten[];
const ergebnis = berechneAngebot({ ust_satz: e.ust.satz }, titel, positionen, kosten, saetze);
return { angebot, titel, positionen, kosten, saetze, ergebnis };
// Anschrift mit z. Hd. und Briefanrede (0.49); festgeschrieben gilt der Stand vom Versand
const empfaenger = await empfaengerLaden(c, angebot.projekt_id);
return { angebot, titel, positionen, kosten, saetze, ergebnis, empfaenger };
}
function pruefung(x: NonNullable<Awaited<ReturnType<typeof ladeAngebot>>>) {
@@ -73,7 +76,7 @@ function stand(x: NonNullable<Awaited<ReturnType<typeof ladeAngebot>>>, anlass:
anlass, am: new Date().toISOString(), von: wer, saetze: x.saetze,
netto: x.ergebnis.netto, brutto: x.ergebnis.brutto, stunden: x.ergebnis.stunden, kosten: x.ergebnis.kosten,
kostenarten: x.ergebnis.kostenarten, titel: x.titel, positionen: x.positionen.map((p) => ({ ...p, ergebnis: x.ergebnis.positionen[p.id] })),
kosten_zeilen: x.kosten,
kosten_zeilen: x.kosten, empfaenger: x.empfaenger,
};
}

View File

@@ -37,6 +37,7 @@ import { type BezugArt, bezugsTage } from "../domain/bezug.js";
import { formatDatum, plusTage } from "../domain/datum.js";
import { eigeneAdressen, kartenAdressen, zusammen } from "./adressen.js";
import { prioritaetenLaden } from "./prioritaet.js";
import { empfaengerLaden } from "./empfaenger.js";
import { type Anschrift, type Listen, type Nummer, einarbeiten, einzelfelder, listenBereinigt, rollenId } from "../domain/kontaktdaten.js";
export interface Optionen {
@@ -727,6 +728,12 @@ export async function baueApp(o: Optionen): Promise<FastifyInstance> {
});
// Projekt-Priorität A/B/C (Henning, 08.11.2026): Vorschlag aus Ertrag, Kunde und Dringlichkeit, selbst gesetzt gilt
app.get("/api/prioritaeten", async () => prioritaetenLaden(pool, await ladeEinstellungen()));
// Anschrift mit z. Hd. und Briefanrede (Henning, 08.11.2026); zweck=rechnung nimmt Rechnungsadresse und „Rechnungen“-Ansprechpartner
app.get("/api/projekte/:id/empfaenger", async (req) => {
const { id } = z.object({ id: z.uuid() }).parse(req.params);
const { zweck } = z.object({ zweck: z.enum(["angebot", "rechnung"]).default("angebot") }).parse(req.query);
return empfaengerLaden(pool, id, zweck);
});
// Übernahme aus dem Projektplaner V70 (JSON-Sicherung), nur in ein leeres Programm
app.post("/api/import/v70", async (req, reply) => {

17
src/server/empfaenger.ts Normal file
View File

@@ -0,0 +1,17 @@
// Anschrift mit „z. Hd.“ und Briefanrede eines Projekts aus Kunde, Ansprechpartnern im Projekt und beim Kunden
import type { Pool } from "./db.js";
import { type BriefPerson, type Empfaenger, empfaenger } from "../domain/brief.js";
export async function empfaengerLaden(c: Pick<Pool, "query">, projektId: string, zweck: "angebot" | "rechnung" = "angebot"): Promise<Empfaenger> {
const kunde = (await c.query(`select k.id, k.name, k.anrede, k.titel, k.art, k.firma, k.adressen from projekt p join kontakt k on k.id = p.bauherr_id where p.id = $1`, [projektId])).rows[0];
if (!kunde) return empfaenger(null, [], zweck);
const leute = (await c.query(`select k.id, k.name, k.anrede, k.titel, k.art, k.firma, k.adressen, ap.zustaendig as im_projekt, z.zustaendig as im_kunden,
coalesce(ap.reihenfolge, 1000) as r1, coalesce(z.reihenfolge, 1000) as r2
from kontakt k
left join projekt_ansprechpartner ap on ap.kontakt_id = k.id and ap.projekt_id = $1
left join kontakt_zugehoerigkeit z on z.person_id = k.id and z.gruppe_id = $2
where ap.id is not null or z.id is not null
order by r1, r2, k.name`, [projektId, kunde.id])).rows;
const personen: BriefPerson[] = leute.map((r) => ({ kontakt: r, imProjekt: r.im_projekt ?? null, imKunden: r.im_kunden ?? null }));
return empfaenger(kunde, personen, zweck);
}

View File

@@ -3,6 +3,7 @@
// Position mit Reitern (Langtext, Aufmaß, Kalkulation, Zuschläge & Preis, Mehr). Rechts Reiter für Bausteine, Leistungen, KI, Vorgaben, Prüfung.
// Jede Änderung wird sofort gespeichert und neu gerechnet; nach dem Versand ist das Angebot festgeschrieben (A19).
import type { Empfaenger } from "../domain/brief.js";
import { formatEuro, parseEuro } from "../domain/geld.js";
import { EINHEITEN, KOSTENARTEN, KOSTENART_NAME, POSITIONSARTEN, POSITIONSART_NAME, lohnartOptionen, lohnartenVon, standardLohnart, umgebungVon } from "../domain/kalkulation.js";
import { benenneUm, zahlDeutsch } from "../domain/formel.js";
@@ -1109,7 +1110,12 @@ function briefkopf(d: Zeile, z: Zustand): string {
const frei = a.status === "entwurf";
const feld = feldBau(frei);
const ort = [a.baustelle_strasse, [a.baustelle_plz, a.baustelle_ort].filter(Boolean).join(" ")].filter(Boolean).join(", ");
const empf = a.bauherr_name ? `<b>${esc(a.bauherr_name)}</b>${a.bauherr_firma ? `<br>${esc(a.bauherr_firma)}` : ""}` : '<span class="fehler">kein Bauherr eingetragen</span>';
// Anschrift mit z. Hd. und Briefanrede (0.49); festgeschrieben gilt der Stand vom Versand
const stand = ((a.staende ?? []) as Zeile[]).filter((x) => x.empfaenger).at(-1);
const em = (frei ? d.empfaenger : stand?.empfaenger ?? d.empfaenger) as Empfaenger | undefined;
const empf = a.bauherr_name && em?.zeilen.length
? em.zeilen.map((x, i) => (i === 0 ? `<b>${esc(x)}</b>` : x === em.zHd ? `<span class="am-zhd">${esc(x)}</span>` : esc(x))).join("<br>")
: a.bauherr_name ? `<b>${esc(a.bauherr_name)}</b>${a.bauherr_firma ? `<br>${esc(a.bauherr_firma)}` : ""}` : '<span class="fehler">kein Bauherr eingetragen</span>';
const festText = frei ? "" : `<p class="hinweis am-fest">Festgeschrieben${a.versendet_am ? `, versendet am ${dat(a.versendet_am)}` : ""}${a.entschieden_am ? `, ${a.status === "angenommen" ? "angenommen" : "abgelehnt"} am ${dat(a.entschieden_am)}` : ""}.</p>`;
// solange eine Position offen ist, nur eine Zeile
if (z.aktiv && d.positionen.some((p: Zeile) => p.id === z.aktiv && !p.textzeile)) {
@@ -1121,6 +1127,7 @@ function briefkopf(d: Zeile, z: Zustand): string {
<label><span class="l">Gültig bis (Bindefrist)</span><input type="date" data-k="angebote:x:bindefrist" value="${esc(a.bindefrist ?? "")}"${frei ? "" : " disabled"}></label></div>
<label class="am-f"><span class="l">Betreff</span>${feld("angebote:x:betreff", a.betreff ?? "", { platz: `z. B. ${a.projekt_name}`, titel: "Betreff" })}</label>
<div class="am-f"><span class="l">Leistungsort</span><div class="am-box">${ort ? esc(ort) : '<span class="hinweis">Baustelle im Projekt eintragen</span>'}</div></div></div>
${em ? `<p class="am-anrede" title="Aus Kunde und Ansprechpartnern; ändern im Kontakt (Anrede, Titel) oder im Projekt (Ansprechpartner „Haupt“)">${esc(em.anrede)}</p>` : ""}
${fliesstext("angebote:x:kopftext", a.kopftext, "Einleitung, z. B. Sehr geehrte Damen und Herren, vielen Dank für Ihre Anfrage …", frei, "Einleitung")}`;
}

View File

@@ -1,5 +1,6 @@
// Oberfläche. Die Reiter folgen dem Lastenheft; Projektseite und Listen nach Vorbild Plancraft.
import type { Empfaenger } from "../domain/brief.js";
import { kalenderwoche, terminplanSeite } from "./gantt.js";
import { terminplanHandy, vorgangImTerminplan } from "./terminhandy.js";
import { type DialogPruefung, type Feld, type Zeile, MONATSNAMEN, api, bearbeiten, bestaetigen, dat, dialog, esc, euro, heute, hinweis,
@@ -254,7 +255,8 @@ async function projektSeite(id: string): Promise<void> {
const nr = k?.mobil ?? k?.telefon;
return `<div class="pj-ap-zeile"><a href="#kontakt-${esc(a.kontakt_id)}"><b>${esc(k?.name ?? "?")}${(a.zustaendig ?? []).includes("haupt") ? " ★" : ""}</b><small>${esc([z?.funktion, nr].filter(Boolean).join(" · "))}</small></a>
${(a.zustaendig ?? []).map((x: string) => `<span class="kt-zust ${esc(x)}">${esc(ZUST[x] ?? x)}</span>`).join("")}<button class="kt-punkte" data-ap="${esc(a.id)}" aria-label="Ansprechpartner bearbeiten">⋯</button></div>`; }).join("")}
<button class="verweis" data-a="ap-neu">+ Ansprechpartner</button></div>`;
<button class="verweis" data-a="ap-neu">+ Ansprechpartner</button>
${p.bauherr_id ? '<button class="verweis" data-a="rechnung-an">Rechnungsanschrift</button><div class="pj-rechnung-an" hidden></div>' : ""}</div>`;
}
inhalt.innerHTML = `${hinweisHtml()}
@@ -729,6 +731,23 @@ async function projektSeite(id: string): Promise<void> {
else await api(`projekt-ansprechpartner/${apId}`, "PATCH", { zustaendig: r.daten.zustaendig ? [r.daten.zustaendig] : [] });
return neuLaden();
}
// Rechnungsanschrift mit z. Hd. und Anrede zum Übernehmen in das Rechnungsprogramm (0.49)
if (a === "rechnung-an") {
const box = inhalt.querySelector<HTMLElement>(".pj-rechnung-an")!;
if (!box.hidden) { box.hidden = true; return; }
const em = await api<Empfaenger>(`projekte/${id}/empfaenger?zweck=rechnung`);
const text = `${em.zeilen.join("\n")}\n\n${em.anrede}`;
box.innerHTML = `<pre>${esc(text)}</pre><button class="neben" data-a="rechnung-an-kopieren">Kopieren</button>`;
box.hidden = false;
box.dataset.text = text;
return;
}
if (a === "rechnung-an-kopieren") {
const box = inhalt.querySelector<HTMLElement>(".pj-rechnung-an")!;
try { await navigator.clipboard.writeText(box.dataset.text ?? ""); box.querySelector("button")!.textContent = "Kopiert ✓"; }
catch { const r = document.createRange(); r.selectNodeContents(box.querySelector("pre")!); getSelection()?.removeAllRanges(); getSelection()?.addRange(r); }
return;
}
if (a === "ap-neu") {
// die Leute vom Kunden zuerst (Henning, 08.11.2026)
const vomKunden = zug.filter((z) => z.gruppe_id === p.bauherr_id).map((z) => z.person_id as string);

View File

@@ -2177,3 +2177,9 @@ button.klein, a.klein { padding: 5px 10px; font-size: 14px; }
.prio-grund { margin: -6px 0 12px; font-size: 13px; color: var(--leise); max-width: 70em; }
.kt-multi { display: flex; flex-wrap: wrap; align-items: baseline; gap: 6px; margin: 12px 0 0; font-size: 14px; }
.kt-multi small { flex-basis: 100%; color: var(--leise); font-size: 12px; padding-left: 22px; }
/* Anschrift mit z. Hd. und Briefanrede (0.49) */
.am-zhd { color: var(--leise); }
.am-anrede { margin: 14px 0 4px; font-size: 15px; }
.pj-rechnung-an { margin-top: 8px; display: grid; gap: 6px; justify-items: start; }
.pj-rechnung-an pre { margin: 0; padding: 8px 10px; border: 1px solid var(--linie); border-radius: 7px; background: var(--titel-bg); font: inherit; font-size: 14px; white-space: pre-wrap; max-width: 100%; }