Files
Betriebsf-hrungssoftware/src/server/tabellen.ts
Claude 5c1688aba5
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
0.52.0: Zahlungsplan im Angebot, beim Annehmen ins Projekt
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-11-09 20:39:55 +00:00

539 lines
21 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Eingabeprüfung für die Tabellen aus Stufe 0. Feldnamen = Spaltennamen.
import { BELEGARTEN } from "../domain/belege.js";
import { z } from "zod";
import { istViertel } from "../domain/kalender.js";
const datum = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Datum im Format JJJJ-MM-TT");
const cent = z.number().int("Betrag in ganzen Cent");
const id = z.uuid();
const text = z.string().trim().min(1, "darf nicht leer sein");
const optText = z.string().trim().nullable().optional();
// Mengenblatt (A22) als JSON: Werte, Listen, freie Aufmaßzeilen; Formeln bleiben Text, gerechnet wird beim Lesen
const formel = z.string().max(500);
const kurzeFormel = z.string().trim().max(500);
const kuerzel = z.string().trim().max(40);
const blatt = z.object({
vorlage: z.object({ id: z.string().max(80), name: z.string().max(200) }).nullable().optional(),
werte: z.array(z.object({ kz: kuerzel, bez: z.string().max(200).nullable().optional(), einheit: z.string().max(20).nullable().optional(), formel, eingabe: z.boolean().optional() })).max(300),
listen: z.array(z.object({
kz: kuerzel, name: z.string().max(200).nullable().optional(),
spalten: z.array(z.object({ kz: kuerzel, bez: z.string().max(200).nullable().optional(), einheit: z.string().max(20).nullable().optional(), art: z.enum(["text", "zahl"]).optional(), formel: formel.nullable().optional() })).max(20),
zeilen: z.array(z.record(z.string().max(40), z.string().max(500))).max(500),
})).max(20),
zeilen: z.array(z.object({ text: z.string().max(300).nullable().optional(), formel })).max(500),
menge: kurzeFormel.nullable().optional(),
});
// Zeitansatz oder Material einer Vorlage: wird beim Einfügen eine Kostenzeile der Position
const ansatz = z.object({
kostenart: z.enum(["lohn", "material", "geraet", "fahrt", "subunternehmer", "sonstiges"]),
lohnart: z.string().regex(/^[a-z0-9-]{1,40}$/).nullable().optional(),
beschreibung: z.string().max(300).nullable().optional(),
bezug: kurzeFormel.nullable().optional(),
menge: z.number().min(0).max(1e9),
personen: z.number().positive().max(50).optional(),
einheit: z.string().max(20).nullable().optional(),
ek: z.number().int().min(0).nullable().optional(),
faktor: z.number().positive().max(100).optional(),
aktiv: z.boolean().optional(),
/** Artikel aus dem Materialstamm: EK und Einheit kommen von dort */
artikel_id: z.uuid().nullable().optional(),
});
// Kontaktdaten (0.47): beliebig viele Nummern und Adressen mit Typ
const kurz = z.string().max(300).optional().default("");
const nummerEintrag = z.object({ typ: z.string().max(40), wert: z.string().max(300), haupt: z.boolean().optional() });
const anschrift = z.object({ typ: z.string().max(40), strasse: kurz, zusatz: kurz, plz: kurz, ort: kurz, region: kurz, land: kurz, postfach: kurz, haupt: z.boolean().optional() });
const zustaendig = z.array(z.enum(["haupt", "rechnungen", "baustelle", "planung"])).max(4);
export interface Tabelle {
name: string;
pfad: string;
schema: z.ZodObject;
sortierung: string;
/** Felder, die nur der Inhaber sieht und ändert (U2: Löhne) */
nurInhaber?: string[];
}
export const TABELLEN: Tabelle[] = [
{
name: "kontakt",
pfad: "kontakte",
sortierung: "name",
schema: z.object({
name: text,
firma: optText,
// rolle: nur noch zum Lesen und für ältere Teile; gepflegt werden die Rollen (0.47)
rolle: z.string().regex(/^[a-z0-9-]{1,40}$/).optional(),
rollen: z.array(z.string().regex(/^[a-z0-9-]{1,40}$/)).max(30).optional(),
art: z.enum(["firma", "behoerde", "familie", "ehepaar", "weg"]).nullable().optional(),
multiplikator: z.boolean().optional(),
anrede: optText,
titel: optText,
telefone: z.array(nummerEintrag).max(30).optional(),
emails: z.array(nummerEintrag).max(30).optional(),
adressen: z.array(anschrift).max(20).optional(),
telefon: optText,
mobil: optText,
email: optText,
strasse: optText,
plz: optText,
ort: optText,
gewerk: optText,
notiz: optText,
}),
},
// Ansprechpartner übergeordneter Kontakte (0.47)
{
name: "kontakt_zugehoerigkeit",
pfad: "kontakt-zugehoerigkeiten",
sortierung: "gruppe_id, reihenfolge, angelegt_am",
schema: z.object({ gruppe_id: id, person_id: id, funktion: optText, zustaendig: zustaendig.optional(), reihenfolge: z.number().int().optional() }),
},
// 0.15: Kolonnen und Subunternehmer (Henning, 20.10.2026)
{
name: "kolonne",
pfad: "kolonnen",
sortierung: "name",
schema: z.object({
name: text,
leitung_kontakt_id: id.nullable().optional(),
aktiv: z.boolean().optional(),
notiz: optText,
}),
},
{
name: "kolonne_mitglied",
pfad: "kolonnen-mitglieder",
sortierung: "kolonne_id, angelegt_am",
schema: z.object({
kolonne_id: id,
kontakt_id: id,
}),
},
{
name: "subunternehmer",
pfad: "subunternehmer",
sortierung: "angelegt_am",
schema: z.object({
kontakt_id: id,
abrechnung: z.enum(["stunden", "pauschale"]).optional(),
stundensatz: cent.min(0).nullable().optional(),
helfersatz: cent.min(0).nullable().optional(),
zahlungsziel_tage: z.number().int().min(0).max(365).nullable().optional(),
skonto_prozent: z.number().min(0).max(99).nullable().optional(),
skonto_tage: z.number().int().min(0).max(365).nullable().optional(),
einbehalt_prozent: z.number().min(0).max(99).nullable().optional(),
kolonnengroesse: z.number().positive().max(99).nullable().optional(),
freistellung_nr: optText,
freistellung_bis: datum.nullable().optional(),
notiz: optText,
}),
},
{
name: "projekt",
pfad: "projekte",
sortierung: "reihenfolge, nummer",
schema: z.object({
nummer: text,
bezeichnung: text,
bauherr_id: id.nullable().optional(),
status: z.enum(["anfrage", "angebot", "auftrag", "ausfuehrung", "abgerechnet", "gewaehrleistung", "abgeschlossen", "intern"]).optional(),
umsatz_netto: cent.optional(),
material_kosten: cent.optional(),
fremd_kosten: cent.optional(),
sonstige_kosten: cent.optional(),
vertragsart: z.enum(["vob", "bgb"]).nullable().optional(),
abnahme_am: datum.nullable().optional(),
farbe: optText,
nextcloud_link: optText,
reihenfolge: z.number().int().optional(),
personen: z.number().positive().nullable().optional(),
soll_stunden: z.number().min(0).nullable().optional(),
soll_tage: z.number().min(0).nullable().optional(),
baustelle_strasse: optText,
baustelle_plz: optText,
baustelle_ort: optText,
notiz: optText,
prioritaet: z.enum(["A", "B", "C"]).nullable().optional(),
// Raten aus dem angenommenen Angebot (0.52); null = Staffel nach Auftragswert
zahlungsplan_raten: z.array(z.object({ bezeichnung: z.string().trim().min(1).max(120), prozent: z.number().min(0).max(100), ziel: z.enum(["auftrag", "richten", "rest", "schluss"]) })).min(1).max(8).nullable().optional(),
frist: datum.nullable().optional(),
termindruck: z.enum(["witterung", "vertragsstrafe"]).nullable().optional(),
}),
},
// Ansprechpartner im Projekt (0.47), Kunde bleibt bauherr_id
{
name: "projekt_ansprechpartner",
pfad: "projekt-ansprechpartner",
sortierung: "projekt_id, reihenfolge, angelegt_am",
schema: z.object({ projekt_id: id, kontakt_id: id, zustaendig: zustaendig.optional(), reihenfolge: z.number().int().optional() }),
},
// Stufe 3a: Angebote mit Kalkulation (A2, A19, A28, A32, A37); Status und Stände nur über eigene Routen
{
name: "angebot",
pfad: "angebote",
sortierung: "projekt_id, datum, nummer",
schema: z.object({
projekt_id: id,
nummer: text,
belegart: z.enum(BELEGARTEN).optional(),
vorbeleg_id: id.nullable().optional(),
quelle: optText,
ist_vorlage: z.boolean().optional(),
datum: datum.optional(),
bindefrist: datum.nullable().optional(),
betreff: optText,
kopftext: optText,
schlusstext: optText,
wagnis_prozent: z.number().min(0).max(50).optional(),
gewinn_prozent: z.number().min(0).max(50).optional(),
ausfall_prozent: z.number().min(0).max(50).optional(),
saetze: z.object({
stundensaetze: z.record(z.string().regex(/^[a-z0-9-]{1,40}$/), cent.min(0)).optional(),
// Lohnarten aus den Stundensatz-Tabellen und die Version, aus der die Sätze stammen (M17)
lohnarten: z.array(z.object({ id: z.string().regex(/^[a-z0-9-]{1,40}$/), name: z.string().max(120) })).max(40).optional(),
stundensatz_version: z.object({ id: z.string().max(40), name: z.string().max(120), gilt_ab: datum }).nullable().optional(),
zuschlaege: z.object({ lohn: z.number().min(0).max(500), material: z.number().min(0).max(500), geraet: z.number().min(0).max(500), fahrt: z.number().min(0).max(500), subunternehmer: z.number().min(0).max(500), sonstiges: z.number().min(0).max(500) }).partial().optional(),
kilometersatz: z.number().int().min(0).optional(),
mengen: z.object({ verschnitt: z.number().min(0).max(100), oeffnung_ab: z.number().min(0).max(100) }).partial().optional(),
stand: datum.optional(),
}).optional(),
notiz: optText,
// Zahlungsplan im Angebot (0.52); null = Vorschlag aus der Staffel
zahlungsplan: z.array(z.object({ bezeichnung: z.string().trim().min(1).max(120), prozent: z.number().min(0).max(100), ziel: z.enum(["auftrag", "richten", "rest", "schluss"]) })).min(1).max(8).nullable().optional(),
reihenfolge: z.number().int().optional(),
}),
},
{
name: "angebot_titel",
pfad: "angebot-titel",
sortierung: "angebot_id, reihenfolge",
schema: z.object({
angebot_id: id,
oz: optText,
bezeichnung: text,
reihenfolge: z.number().int().optional(),
}),
},
{
name: "angebot_position",
pfad: "angebot-positionen",
sortierung: "angebot_id, reihenfolge",
schema: z.object({
angebot_id: id,
titel_id: id.nullable().optional(),
oz: optText,
kurztext: text,
langtext: optText,
menge: z.number().min(0).max(1e9).optional(),
einheit: text.optional(),
art: z.enum(["normal", "alternativ", "eventual", "eventual_summe"]).optional(),
grundposition_id: id.nullable().optional(),
ep_fest: cent.min(0).nullable().optional(),
mit_kalkulation: z.boolean().optional(),
mit_aufmass: z.boolean().optional(),
aufmass: blatt.nullable().optional(),
textzeile: z.boolean().optional(),
markiert: z.boolean().optional(),
reihenfolge: z.number().int().optional(),
}),
},
{
name: "angebot_kosten",
pfad: "angebot-kosten",
sortierung: "position_id, reihenfolge",
schema: z.object({
position_id: id,
kostenart: z.enum(["lohn", "material", "geraet", "fahrt", "subunternehmer", "sonstiges"]),
lohnart: z.string().regex(/^[a-z0-9-]{1,40}$/).nullable().optional(),
beschreibung: optText,
menge: z.number().min(0).max(1e9).optional(),
einheit: optText,
ek: cent.min(0).nullable().optional(),
faktor: z.number().positive().max(100).optional(),
faktor_grund: optText,
zuschlag_prozent: z.number().min(0).max(500).nullable().optional(),
bezug: kurzeFormel.nullable().optional(),
personen: z.number().positive().max(50).optional(),
aktiv: z.boolean().optional(),
aus_vorlage: z.boolean().optional(),
reihenfolge: z.number().int().optional(),
}),
},
// Materialstamm (Stammdaten, 21.10.2026): DATANORM je Lieferant oder eigene Artikel; Preise in Cent je Preiseinheit
{
name: "artikel",
pfad: "artikel",
sortierung: "lieferant, artikelnummer, bezeichnung",
schema: z.object({
lieferant: z.string().trim().max(100).optional(),
artikelnummer: z.string().trim().max(60).optional(),
bezeichnung: text,
langtext: optText,
warengruppe: optText,
rabattgruppe: optText,
ean: optText,
einheit: optText,
preiseinheit: z.union([z.literal(1), z.literal(10), z.literal(100), z.literal(1000)]).optional(),
preisart: z.enum(["brutto", "netto"]).optional(),
listenpreis: cent.min(0).nullable().optional(),
rabatt: z.number().min(0).max(100).nullable().optional(),
ek: cent.min(0).nullable().optional(),
ek_vorher: cent.nullable().optional(),
herkunft: z.enum(["eigen", "datanorm"]).optional(),
stand: datum.nullable().optional(),
merkliste: z.boolean().optional(),
}),
},
{
name: "lieferant_rabatt",
pfad: "lieferanten-rabatte",
sortierung: "lieferant, rabattgruppe",
schema: z.object({
lieferant: text,
rabattgruppe: text,
bezeichnung: optText,
rabatt: z.number().min(0).max(100),
}),
},
// Mengenvorlagen und Musterpositionen (A23): eigene; die mitgelieferten stehen im Programm (domain/mengenvorlagen.ts)
{
name: "mengenvorlage",
pfad: "mengenvorlagen",
sortierung: "gruppe, reihenfolge, name",
schema: z.object({
art: z.enum(["mengen", "muster"]),
gruppe: text,
name: text,
beschreibung: optText,
kurztext: optText,
langtext: optText,
einheit: optText,
inhalt: blatt.extend({ ansaetze: z.array(ansatz).max(100).default([]) }),
reihenfolge: z.number().int().optional(),
// Leistungen (Stammdaten): Nummer/OZ, Herkunft, „Preis festlegen auf“
nummer: optText,
herkunft: z.enum(["eigen", "gaeb", "plancraft"]).optional(),
ep_fest: cent.min(0).nullable().optional(),
quelle: optText,
notiz: optText,
}),
},
{
name: "abschnitt",
pfad: "abschnitte",
sortierung: "projekt_id, reihenfolge",
schema: z.object({
projekt_id: id,
name: text,
ist_meilenstein: z.boolean().optional(),
reihenfolge: z.number().int().optional(),
erledigt: z.boolean().optional(),
termin: datum.nullable().optional(),
}),
},
{
name: "vorgang",
pfad: "vorgaenge",
sortierung: "abschnitt_id, reihenfolge, start",
schema: z.object({
abschnitt_id: id,
nummer: z.number().int().positive().optional(),
name: text,
start: datum,
// Vierteltage (Henning, 22.10.2026)
dauer: z.number().min(0).refine(istViertel, "Die Dauer geht in Vierteltagen, z. B. 0,25, 0,5 oder 1,75.").optional(),
start_teil: z.number().min(0).max(0.75).refine(istViertel, "Der Tagesteil ist 0, 0,25, 0,5 oder 0,75.").optional(),
stunden: z.number().min(0).nullable().optional(),
kontakt_id: id.nullable().optional(),
reihenfolge: z.number().int().optional(),
fortschritt: z.number().int().min(0).max(100).optional(),
personen: z.number().positive().nullable().optional(),
dauer_fest: z.boolean().optional(),
// einzelne Freitage, an denen dieser Vorgang ausgeführt wird (Henning, 21.10.2026)
freitage: z.array(datum).max(60).optional(),
}),
},
{
name: "vorgang_vorgaenger",
pfad: "verknuepfungen",
sortierung: "vorgang_id",
schema: z.object({
vorgang_id: id,
vorgaenger_id: id,
art: z.enum(["EA", "AA", "EE", "AE"]).optional(),
verzoegerung: z.number().int().optional(),
}),
},
{
name: "besetzung",
pfad: "besetzungen",
sortierung: "vorgang_id, angelegt_am",
schema: z.object({
vorgang_id: id,
kontakt_id: id.nullable().optional(),
platzhalter: optText,
kolonne_id: id.nullable().optional(),
personen: z.number().positive().optional(),
freigegeben: z.boolean().optional(),
}),
},
{
name: "zahlung",
pfad: "zahlungen",
sortierung: "projekt_id, reihenfolge, termin",
schema: z.object({
projekt_id: id,
vorgang_id: id.nullable().optional(),
art: z.enum(["anzahlung", "abschlag", "nachtrag", "schluss", "einbehalt"]).optional(),
bezeichnung: text,
netto: cent,
termin: datum,
status: z.enum(["geplant", "gestellt", "bezahlt"]).optional(),
rechnungsdatum: datum.nullable().optional(),
bezahlt_am: datum.nullable().optional(),
reihenfolge: z.number().int().optional(),
zahlungsziel_tage: z.number().int().min(0).nullable().optional(),
bezug_art: z.enum(["AA", "EE"]).optional(),
bezug_tage: z.number().int().min(-500).max(500).optional(),
freitag: z.boolean().optional(),
rest: z.boolean().optional(),
zaehlt: z.boolean().optional(),
}),
},
{
name: "kosten",
pfad: "kosten",
sortierung: "projekt_id, termin",
schema: z.object({
projekt_id: id,
art: z.enum(["material", "fremd", "sonstiges"]),
bezeichnung: text,
netto: cent,
termin: datum,
kontakt_id: id.nullable().optional(),
mit_vorsteuer: z.boolean().optional(),
status: z.enum(["geplant", "bestellt", "bezahlt"]).optional(),
zahlungsziel_tage: z.number().int().min(0).nullable().optional(),
vorgang_id: id.nullable().optional(),
bezug_art: z.enum(["AA", "EE"]).optional(),
bezug_tage: z.number().int().min(-500).max(500).optional(),
freitag: z.boolean().optional(),
// aus dem Einsatz eines Subunternehmers; false = von Hand geändert, rechnet sich nicht mehr neu
automatisch: z.boolean().optional(),
zaehlt: z.boolean().optional(),
}),
},
{
name: "laufende_kosten",
pfad: "laufende-kosten",
sortierung: "kategorie, bezeichnung",
schema: z.object({
bezeichnung: text,
kategorie: text.optional(),
gruppe: optText,
betrag: cent,
rhythmus: z.enum(["einmalig", "monatlich", "vierteljaehrlich", "jaehrlich"]).optional(),
start: datum,
ende: datum.nullable().optional(),
}),
},
{
name: "aufgabe_kategorie",
pfad: "aufgaben-kategorien",
sortierung: "reihenfolge, name",
schema: z.object({
name: text,
reihenfolge: z.number().int().optional(),
}),
},
{
name: "aufgabe",
pfad: "aufgaben",
sortierung: "erledigt_am nulls first, faellig_am nulls last, angelegt_am",
schema: z.object({
text: text,
faellig_am: datum.nullable().optional(),
langfristig: z.boolean().optional(),
projekt_id: id.nullable().optional(),
kontakt_id: id.nullable().optional(),
kategorie_id: id.nullable().optional(),
erledigt_am: z.iso.datetime({ offset: true }).nullable().optional(),
vorgang_id: id.nullable().optional(),
bezug_art: z.enum(["AA", "EE"]).optional(),
bezug_tage: z.number().int().min(-500).max(500).optional(),
freitag: z.boolean().optional(),
}),
},
// Stufe 2: Personal (M1, M8, M4, M10)
{
name: "mitarbeiter",
pfad: "mitarbeiter",
sortierung: "angelegt_am",
nurInhaber: ["lohn_cent"],
schema: z.object({
kontakt_id: id,
personalnummer: optText,
eintritt: datum.nullable().optional(),
austritt: datum.nullable().optional(),
angestellt: z.boolean().optional(),
lohn_cent: cent.min(0).nullable().optional(),
urlaubstage: z.number().min(0).max(60).optional(),
funktion: z.string().regex(/^[a-z0-9-]{1,40}$/).nullable().optional(),
}),
},
{
name: "arbeitszeitmodell",
pfad: "arbeitszeitmodelle",
sortierung: "kontakt_id, gueltig_ab",
schema: z.object({
kontakt_id: id,
gueltig_ab: datum,
stunden: z.array(z.number().min(0).max(24)).length(7, "Stunden für Montag bis Sonntag"),
}),
},
{
name: "abwesenheit",
pfad: "abwesenheiten",
sortierung: "von, kontakt_id",
schema: z.object({
kontakt_id: id,
art: z.enum(["urlaub", "krank", "schule", "frei", "sperre"]),
von: datum,
bis: datum,
halbtag: z.boolean().optional(),
stunden: z.number().positive().max(24).nullable().optional(),
status: z.enum(["beantragt", "genehmigt", "abgelehnt"]).optional(),
notiz: optText,
antwort: optText,
}),
},
{
name: "urlaubskonto",
pfad: "urlaubskonten",
sortierung: "kontakt_id, jahr",
schema: z.object({
kontakt_id: id,
jahr: z.number().int().min(2000).max(2100),
anspruch: z.number().min(0).max(60).nullable().optional(),
uebertrag: z.number().min(-60).max(60).optional(),
}),
},
];
/** Tabellen mit eigenen Routen (keine allgemeinen), die trotzdem in Sicherung und Umzug gehören.
* Reihenfolge nach Fremdschlüsseln, nach TABELLEN einzuspielen. */
export const NUR_SICHERUNG: { name: string; pfad: string; sortierung: string }[] = [
{ name: "zeiteintrag", pfad: "zeiteintraege", sortierung: "datum, kontakt_id" },
{ name: "kontakt_rolle", pfad: "kontakt_rollen", sortierung: "reihenfolge, name" },
{ name: "zeitanteil", pfad: "zeitanteile", sortierung: "zeiteintrag_id, reihenfolge" },
{ name: "projekt_vorlage", pfad: "projekt_vorlagen", sortierung: "projekt_id, vorlage" },
// Stufe 5: Jahresplan-Versionen, BWA je Monat und die Zuordnung der BWA-Zeilen
{ name: "jahresplan", pfad: "jahresplaene", sortierung: "jahr, basis desc, angelegt_am" },
{ name: "finanz_monat", pfad: "finanz_monate", sortierung: "jahr, monat" },
{ name: "bwa_zuordnung", pfad: "bwa_zuordnungen", sortierung: "zeile" },
// Stundensätze im Personalmodul (M15–M19)
{ name: "stundensatz_version", pfad: "stundensatz_versionen", sortierung: "gilt_ab" },
];