Übernahme der V70-Sicherung und Liquidität aus Projekten nach V70-Regeln
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled

- Import der JSON-Sicherung in ein leeres Programm (eine Transaktion), mit Hinweisliste
- Freitag als Arbeitstag erkannt, alle Termine bleiben gleich
- Liquidität aus Projekten, Vorgängen, Abschlägen und Einzelkosten; Angebote zählen nicht (P5)
- Vergleich gegen einen Nachbau der V70-Rechnung: je Woche und Monat centgenau gleich

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 05:23:45 +00:00
parent 639980a4d1
commit 55fe69dc2b
13 changed files with 1357 additions and 26 deletions

363
src/domain/v70.ts Normal file
View File

@@ -0,0 +1,363 @@
// Übernahme einer Sicherung aus dem Projektplaner V70 (Datei "projektplaner-sicherung-….json").
// Reine Umrechnung ohne Datenbank: liefert die neuen Datensätze mit eigenen Schlüsseln
// für die Verknüpfungen und eine Liste von Hinweisen auf alles, was nicht 1:1 passt.
import { type Datum, wochentag } from "./datum.js";
import { type Cent } from "./geld.js";
import { type Arbeitswoche, arbeitstageZwischen, endeNachDauer, feiertag } from "./kalender.js";
import { type Rundung } from "./arbeitszeit.js";
import { type Kostenart, type Rhythmus } from "./liquiditaet.js";
// --- Aufbau der V70-Sicherung (nur die Felder, die übernommen werden) ---
export interface V70Task {
id: string;
t: "a" | "v";
par?: string;
name: string;
start?: string;
end?: string;
ms?: boolean;
dep?: string | null;
typ?: string;
lag?: number;
abs?: number;
pers?: number;
std?: number;
no?: number;
kontakt?: unknown;
}
export interface V70Projekt {
name: string;
nr?: string;
bauherr?: string;
umsatz?: number;
material?: number;
fremd?: number;
sonst?: number;
mann?: number;
tage?: number;
zb?: string;
std?: number;
status?: string;
farbe?: string;
arch?: boolean;
tasks?: V70Task[];
}
export interface V70Posten {
id?: string;
p: number | string;
t: string;
b: number;
d?: string;
}
export interface V70Firmenkosten {
t: string;
g?: string;
c?: string;
b: number;
d?: string;
r?: number;
}
export interface V70Sicherung {
format: "projektplaner";
version?: number;
gesichert?: string;
projekte: V70Projekt[];
kontakte: { name: string; tel?: string; mail?: string }[];
kosten: V70Posten[];
einnahmen?: V70Posten[];
zahlungsziel?: number;
materialziel?: number;
firmenkosten_monatlich: V70Firmenkosten[];
firmenkosten_einmalig: V70Firmenkosten[];
arbeitszeit?: { h?: number; eff?: number; rund?: string };
aufgaben?: unknown[];
}
// --- Ergebnis ---
export type Projektstatus = "anfrage" | "angebot" | "auftrag" | "ausfuehrung" | "abgerechnet" | "gewaehrleistung" | "abgeschlossen";
export interface Uebernahme {
einstellungen: {
arbeitstage: number[];
stundenProTag: number;
produktivitaet: number;
rundung: Rundung;
zahlungsziele: { kundenTage: number; materialTage: number; fremdTage: number; sonstigeTage: number };
};
kontakte: { schluessel: string; name: string; rolle: "bauherr" | "sonstige"; telefon?: string; email?: string }[];
projekte: {
schluessel: string; nummer: string; bezeichnung: string; bauherr?: string; status: Projektstatus;
umsatz_netto: Cent; material_kosten: Cent; fremd_kosten: Cent; sonstige_kosten: Cent;
farbe?: string; reihenfolge: number; personen?: number; soll_stunden?: number; soll_tage?: number;
}[];
abschnitte: { schluessel: string; projekt: string; name: string; ist_meilenstein: boolean; reihenfolge: number }[];
vorgaenge: {
schluessel: string; abschnitt: string; name: string; start: Datum; dauer: number;
stunden?: number; personen?: number; reihenfolge: number;
}[];
verknuepfungen: { vorgang: string; vorgaenger: string; art: "EA" | "AA" | "EE" | "AE"; verzoegerung: number }[];
zahlungen: {
projekt: string; vorgang?: string; art: "abschlag"; bezeichnung: string; netto: Cent; termin: Datum; zahlungsziel_tage?: number;
}[];
kosten: { projekt: string; art: Kostenart; bezeichnung: string; netto: Cent; termin: Datum; mit_vorsteuer: boolean; zahlungsziel_tage: number }[];
laufend: { bezeichnung: string; gruppe?: string; kategorie: string; betrag: Cent; rhythmus: Rhythmus; start: Datum }[];
hinweise: string[];
}
const DATUM = /^\d{4}-\d{2}-\d{2}$/;
/** Euro-Betrag aus V70 (Gleitkommazahl) in Cent, kaufmännisch gerundet über die Dezimaldarstellung. */
export function euroZuCent(euro: number | undefined): Cent {
if (euro === undefined || euro === null || !Number.isFinite(euro)) return 0;
const text = String(Math.abs(euro));
let cent: number;
if (/e/i.test(text)) cent = Math.round(Math.abs(euro) * 100);
else {
const [ganz, nachkomma = ""] = text.split(".");
const z = (nachkomma + "000").slice(0, 3);
cent = Number(ganz) * 100 + Number(z.slice(0, 2)) + (Number(z[2]) >= 5 ? 1 : 0);
}
return euro < 0 ? -cent : cent;
}
const STATUS: Record<string, Projektstatus> = {
Angebot: "angebot",
Auftrag: "auftrag",
Geplant: "auftrag",
"In Arbeit": "ausfuehrung",
Abgeschlossen: "abgeschlossen",
};
const RHYTHMUS: Record<number, Rhythmus> = { 1: "monatlich", 3: "vierteljaehrlich", 12: "jaehrlich" };
/** Prüft grob, ob die Datei eine V70-Sicherung ist; wirft sonst einen verständlichen Fehler. */
export function pruefeSicherung(d: unknown): V70Sicherung {
const s = d as Partial<V70Sicherung> | null;
if (!s || s.format !== "projektplaner" || !Array.isArray(s.projekte) || !Array.isArray(s.kosten) || !Array.isArray(s.firmenkosten_monatlich)) {
throw new Error("Diese Datei ist keine Sicherung des Projektplaners V70.");
}
return { kontakte: [], firmenkosten_einmalig: [], einnahmen: [], ...s } as V70Sicherung;
}
function istBlatt(p: V70Projekt, t: V70Task): boolean {
return t.t === "v" || !(p.tasks ?? []).some((k) => k.t === "v" && k.par === t.id);
}
function hatTermin(t: V70Task): t is V70Task & { start: string; end: string } {
return !!t.start && !!t.end && DATUM.test(t.start) && DATUM.test(t.end);
}
/**
* V70 kennt einen Schalter "Freitag frei". Liegt ein Termin auf einem Freitag (ohne Feiertag),
* war der Schalter aus und es wurde Mo–Fr geplant; sonst Mo–Do.
*/
export function erkenneArbeitswoche(s: V70Sicherung): { woche: Arbeitswoche; freitage: Datum[] } {
const freitage = new Set<Datum>();
for (const p of s.projekte) {
for (const t of p.tasks ?? []) {
if (!hatTermin(t) || !istBlatt(p, t)) continue;
for (const d of [t.start, t.end]) if (wochentag(d) === 5 && !feiertag(d)) freitage.add(d);
}
}
return { woche: { tage: freitage.size ? [1, 2, 3, 4, 5] : [1, 2, 3, 4] }, freitage: [...freitage].sort() };
}
export function uebernimmV70(roh: unknown): Uebernahme {
const s = pruefeSicherung(roh);
const hinweise: string[] = [];
const { woche, freitage } = erkenneArbeitswoche(s);
if (freitage.length) {
hinweise.push(`In V70 war „Freitag frei“ aus: ${freitage.length} Termine liegen auf einem Freitag. Übernommen als Arbeitswoche Mo–Fr, damit alle Termine gleich bleiben.`);
}
const az = s.arbeitszeit ?? {};
const rundung: Rundung = az.rund === "ganz" || az.rund === "keine" ? az.rund : "halb";
const zz = Math.max(0, Number(s.zahlungsziel ?? 14) || 0);
const mz = s.materialziel === undefined ? 7 : Math.max(0, Number(s.materialziel) || 0);
const u: Uebernahme = {
einstellungen: {
arbeitstage: woche.tage,
stundenProTag: az.h && az.h > 0 ? az.h : 8,
produktivitaet: az.eff && az.eff > 0 ? Math.min(az.eff, 100) / 100 : 1,
rundung,
zahlungsziele: { kundenTage: zz, materialTage: mz, fremdTage: mz, sonstigeTage: mz },
},
kontakte: [], projekte: [], abschnitte: [], vorgaenge: [], verknuepfungen: [], zahlungen: [], kosten: [], laufend: [],
hinweise,
};
// Kontakte aus V70 und Bauherren (dort nur Text) als eigene Kontakte
const kontaktNachName = new Map<string, string>();
s.kontakte.forEach((k, i) => {
if (!k?.name?.trim()) return;
const schluessel = `k${i}`;
u.kontakte.push({ schluessel, name: k.name.trim(), rolle: "sonstige", telefon: k.tel || undefined, email: k.mail || undefined });
kontaktNachName.set(k.name.trim(), schluessel);
});
const bauherr = (name?: string): string | undefined => {
const n = name?.trim();
if (!n) return undefined;
const vorhanden = kontaktNachName.get(n);
if (vorhanden) return vorhanden;
const schluessel = `b${kontaktNachName.size}`;
u.kontakte.push({ schluessel, name: n, rolle: "bauherr" });
kontaktNachName.set(n, schluessel);
return schluessel;
};
// Projektnummern: "26-014" -> P-26-014 ab Auftrag, A-26-014 im Angebot; ohne Nummer Platzhalter
const vergeben = new Set<string>();
let ohneNummer = 0;
const nummer = (p: V70Projekt, status: Projektstatus): string => {
const prefix = status === "angebot" || status === "anfrage" ? "A" : "P";
const nr = (p.nr ?? "").trim();
let n: string;
if (!nr || nr === "0") {
n = `${prefix}-OHNE-${++ohneNummer}`;
hinweise.push(`„${p.name}“ hatte keine Projektnummer; vorläufig ${n}, bitte vergeben.`);
} else n = `${prefix}-${nr}`;
let eindeutig = n;
for (let i = 2; vergeben.has(eindeutig); i++) eindeutig = `${n}-${i}`;
if (eindeutig !== n) hinweise.push(`Nummer ${n} kam doppelt vor; „${p.name}“ heißt jetzt ${eindeutig}.`);
vergeben.add(eindeutig);
return eindeutig;
};
// V70-Task-Id -> Schlüssel des Vorgangs, der dafür im Terminplan steht
const vorgangZuTask = new Map<string, string>();
const offeneVerknuepfungen: { task: V70Task; projekt: V70Projekt }[] = [];
s.projekte.forEach((p, pi) => {
const schluessel = `p${pi}`;
let status = STATUS[p.status ?? ""] ?? "auftrag";
if (!STATUS[p.status ?? ""]) hinweise.push(`„${p.name}“: unbekannter Status „${p.status ?? ""}“, als Auftrag übernommen.`);
if (p.arch) status = "abgeschlossen";
u.projekte.push({
schluessel,
nummer: nummer(p, status),
bezeichnung: p.name?.trim() || `Projekt ${pi + 1}`,
bauherr: bauherr(p.bauherr),
status,
umsatz_netto: euroZuCent(p.umsatz),
material_kosten: euroZuCent(p.material),
fremd_kosten: euroZuCent(p.fremd),
sonstige_kosten: euroZuCent(p.sonst),
farbe: /^#[0-9a-f]{6}$/i.test(p.farbe ?? "") ? p.farbe : undefined,
reihenfolge: pi,
personen: p.mann && p.mann > 0 ? p.mann : undefined,
soll_stunden: p.zb === "std" && p.std !== undefined ? p.std : undefined,
soll_tage: p.tage !== undefined ? p.tage : undefined,
});
const tasks = [...(p.tasks ?? [])].sort((a, b) => (a.no ?? 0) - (b.no ?? 0));
const abschnittZuTask = new Map<string, string>();
const vorgang = (t: V70Task, abschnitt: string, meilenstein: boolean) => {
if (!hatTermin(t)) {
if (euroZuCent(t.abs) > 0) hinweise.push(`„${p.name}“ / „${t.name}“: Abschlag ohne Termin, nicht übernommen (fehlt in V70 auch in der Liquidität).`);
if (t.dep) hinweise.push(`„${p.name}“ / „${t.name}“: hat keinen Termin, die Verknüpfung zum Vorgänger entfällt.`);
return;
}
const vs = `v${u.vorgaenge.length}`;
const dauer = meilenstein ? 0 : arbeitstageZwischen(t.start, t.end, woche);
if (endeNachDauer(t.start, dauer, woche) !== t.end || (!meilenstein && dauer === 0)) {
hinweise.push(`„${p.name}“ / „${t.name}“: ${t.start} bis ${t.end} passt nicht auf die Arbeitstage, bitte prüfen.`);
}
u.vorgaenge.push({
schluessel: vs, abschnitt, name: t.name?.trim() || "Vorgang", start: t.start, dauer: Math.max(dauer, meilenstein ? 0 : 1),
stunden: t.std !== undefined && t.std > 0 ? t.std : undefined,
personen: t.pers && t.pers > 0 ? t.pers : undefined,
reihenfolge: t.no ?? 0,
});
vorgangZuTask.set(t.id, vs);
const abs = euroZuCent(t.abs);
if (abs > 0) u.zahlungen.push({ projekt: schluessel, vorgang: vs, art: "abschlag", bezeichnung: `Abschlag ${t.name}`.trim(), netto: abs, termin: t.end });
if (t.dep) offeneVerknuepfungen.push({ task: t, projekt: p });
if (t.kontakt !== undefined && t.kontakt !== null && t.kontakt !== "") {
hinweise.push(`„${p.name}“ / „${t.name}“: zugeordneter Kontakt bitte neu zuweisen.`);
}
};
// Abschnitte zuerst, dann Vorgänge in ihrer Reihenfolge
for (const t of tasks.filter((x) => x.t === "a")) {
const as = `a${u.abschnitte.length}`;
const meilenstein = !!t.ms;
u.abschnitte.push({ schluessel: as, projekt: schluessel, name: t.name?.trim() || "Abschnitt", ist_meilenstein: meilenstein, reihenfolge: t.no ?? 0 });
abschnittZuTask.set(t.id, as);
// Abschnitt ohne Vorgänge mit eigenem Termin: in V70 ein Balken, hier ein gleichnamiger Vorgang
if (istBlatt(p, t)) vorgang(t, as, meilenstein);
}
for (const t of tasks.filter((x) => x.t === "v")) {
let as = t.par ? abschnittZuTask.get(t.par) : undefined;
if (!as) {
as = `a${u.abschnitte.length}`;
u.abschnitte.push({ schluessel: as, projekt: schluessel, name: "Ohne Abschnitt", ist_meilenstein: false, reihenfolge: t.no ?? 0 });
if (t.par) abschnittZuTask.set(t.par, as);
hinweise.push(`„${p.name}“ / „${t.name}“: gehörte zu keinem Abschnitt, steht jetzt unter „Ohne Abschnitt“.`);
}
vorgang(t, as, !!t.ms);
}
});
for (const { task, projekt } of offeneVerknuepfungen) {
const vorgaenger = vorgangZuTask.get(task.dep!);
const art = (["EA", "AA", "EE", "AE"] as const).find((a) => a === (task.typ ?? "EA"));
if (!vorgaenger || !art) {
hinweise.push(`„${projekt.name}“ / „${task.name}“: Vorgänger nicht gefunden oder ohne Termin, Verknüpfung entfällt.`);
continue;
}
u.verknuepfungen.push({ vorgang: vorgangZuTask.get(task.id)!, vorgaenger, art, verzoegerung: Math.round(task.lag ?? 0) });
}
// Einzelkosten und -einnahmen hängen in V70 an der Listenposition des Projekts
const projektVon = (x: V70Posten, was: string): string | undefined => {
const i = Number(x.p);
if (!Number.isInteger(i) || !s.projekte[i]) {
hinweise.push(`${was} „${x.t}“ (${x.b} €) gehört zu keinem Projekt und wurde nicht übernommen.`);
return undefined;
}
if (!x.d || !DATUM.test(x.d)) {
hinweise.push(`${was} „${x.t}“ (${x.b} €) hat kein Datum; in V70 zählt sie nicht und wurde nicht übernommen.`);
return undefined;
}
return `p${i}`;
};
for (const k of s.kosten) {
const projekt = projektVon(k, "Kosten");
if (!projekt) continue;
// V70 bucht Einzelkosten am eingetragenen Tag und ohne Vorsteuer ("wie eingegeben")
u.kosten.push({ projekt, art: "material", bezeichnung: k.t?.trim() || "Kosten", netto: euroZuCent(k.b), termin: k.d!, mit_vorsteuer: false, zahlungsziel_tage: 0 });
}
for (const e of s.einnahmen ?? []) {
const projekt = projektVon(e, "Einnahme");
if (!projekt) continue;
u.zahlungen.push({ projekt, art: "abschlag", bezeichnung: e.t?.trim() || "Einnahme", netto: euroZuCent(e.b), termin: e.d!, zahlungsziel_tage: 0 });
}
for (const f of s.firmenkosten_monatlich) {
const rhythmus = RHYTHMUS[Number(f.r ?? 1)];
if (!rhythmus || !f.d || !DATUM.test(f.d)) {
hinweise.push(`Laufende Kosten „${f.t}“: ${!rhythmus ? `Rhythmus alle ${f.r} Monate gibt es noch nicht` : "ohne erstes Fälligkeitsdatum"}, nicht übernommen.`);
continue;
}
u.laufend.push({ bezeichnung: f.t.trim(), gruppe: f.g?.trim() || undefined, kategorie: f.c?.trim() || "Sonstiges", betrag: euroZuCent(f.b), rhythmus, start: f.d });
}
for (const f of s.firmenkosten_einmalig) {
if (!f.d || !DATUM.test(f.d)) {
hinweise.push(`Einmalige Kosten „${f.t}“ ohne Datum, nicht übernommen.`);
continue;
}
u.laufend.push({ bezeichnung: f.t.trim(), gruppe: f.g?.trim() || undefined, kategorie: f.c?.trim() || "Sonstiges", betrag: euroZuCent(f.b), rhythmus: "einmalig", start: f.d });
}
if (s.aufgaben?.length) hinweise.push(`${s.aufgaben.length} Aufgaben aus V70 werden mit Stufe 1 übernommen.`);
return u;
}