Files
Betriebsf-hrungssoftware/src/domain/v70.ts
Claude f3dd3678f6
Some checks failed
Prüfung / tests (push) Has been cancelled
Prüfung / container (push) Has been cancelled
0.36.0: Status Intern mit I-Nummern und Ordner 05 Intern, Eckdaten unten und einklappbar
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
2026-10-24 05:49:21 +00:00

399 lines
17 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.
// Ü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, formatDatum } from "./datum.js";
import { type Cent } from "./geld.js";
import { type Arbeitswoche, arbeitstageZwischen, endeNachDauer, feiertag, naechsterArbeitstag } 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?: V70Aufgabe[];
}
/** Aufgabe im Aufgabenblock: t Text, d fällig, k Kontakt (freier Text), p Projekt als Listenposition */
export interface V70Aufgabe {
id?: string; t?: string; d?: string; k?: string; p?: number | string | null; done?: boolean; doneAt?: number;
}
// --- Ergebnis ---
export type Projektstatus = "anfrage" | "angebot" | "auftrag" | "ausfuehrung" | "abgerechnet" | "gewaehrleistung" | "abgeschlossen" | "intern";
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 }[];
aufgaben: { text: string; faellig_am?: Datum; projekt?: string; erledigt_am?: string }[];
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() };
}
/** Henning, 19.10.2026: der Freitag ist immer Reserve- und Bürotag, geplant wird Mo–Do. */
export const MO_BIS_DO: Arbeitswoche = { tage: [1, 2, 3, 4] };
/**
* `woche` ist die Arbeitswoche im neuen Programm. Die Dauer jedes Vorgangs wird in der
* Arbeitswoche von V70 gezählt und in der neuen Woche neu terminiert; was sich dadurch
* verschiebt, steht in den Hinweisen.
*/
export function uebernimmV70(roh: unknown, woche: Arbeitswoche = MO_BIS_DO): Uebernahme {
const s = pruefeSicherung(roh);
const hinweise: string[] = [];
const { woche: alteWoche, freitage } = erkenneArbeitswoche(s);
const verschoben: string[] = [];
if (freitage.length && !woche.tage.includes(5)) {
hinweise.push(`In V70 war „Freitag frei“ aus (Termine an ${freitage.length} Freitagen). Freitag ist jetzt Reserve- und Bürotag, deshalb verschieben sich Vorgänge.`);
}
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: [], aufgaben: [],
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 gezaehlt = meilenstein ? 0 : arbeitstageZwischen(t.start, t.end, alteWoche);
if (endeNachDauer(t.start, gezaehlt, alteWoche) !== t.end || (!meilenstein && gezaehlt === 0)) {
hinweise.push(`„${p.name}“ / „${t.name}“: ${formatDatum(t.start)} bis ${formatDatum(t.end)} passt nicht auf die Arbeitstage, bitte prüfen.`);
}
const dauer = Math.max(gezaehlt, meilenstein ? 0 : 1);
const start = naechsterArbeitstag(t.start, woche);
const ende = endeNachDauer(start, dauer, woche);
if (start !== t.start || ende !== t.end) {
verschoben.push(`${p.name} / ${t.name}: ${formatDatum(t.start)}–${formatDatum(t.end)} → ${formatDatum(start)}–${formatDatum(ende)}`);
}
u.vorgaenge.push({
schluessel: vs, abschnitt, name: t.name?.trim() || "Vorgang", start, dauer,
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: ende });
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);
}
});
if (verschoben.length) {
hinweise.push(`Verschoben, Folgevorgänge bitte prüfen: ${verschoben.join("; ")}.`);
}
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 });
}
for (const a of s.aufgaben ?? []) {
const text = [a.t?.trim(), a.k?.trim() ? `(${a.k.trim()})` : ""].filter(Boolean).join(" ");
if (!text) continue;
const pi = a.p === "" || a.p === null || a.p === undefined ? -1 : Number(a.p);
u.aufgaben.push({
text,
faellig_am: a.d && DATUM.test(a.d) ? a.d : undefined,
projekt: pi >= 0 && pi < s.projekte.length ? `p${pi}` : undefined,
erledigt_am: a.done ? new Date(a.doneAt || Date.now()).toISOString() : undefined,
});
}
return u;
}