Stufe 5: Jahresplanung mit Versionen, 12 Monaten, Plan/Ist und BWA-Import (0.22.0)
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:
164
src/domain/bwa.ts
Normal file
164
src/domain/bwa.ts
Normal file
@@ -0,0 +1,164 @@
|
||||
// BWA von Herrn Seeler einlesen (B1): DATEV-Export „BWA-Wertenachweis“, SKR04. Die .xls-Datei ist eine HTML-Tabelle:
|
||||
// Zeile | Bezeichnung | Konto | | Konten-/Zeilenbeschriftung | Fkt. | Monat je Konto | Monat je Zeile | kumuliert je Konto | kumuliert je Zeile.
|
||||
// Summenzeilen nennen statt Konten die Zeilen, aus denen sie bestehen. Beträge in Cent; Kosten stehen positiv.
|
||||
|
||||
import type { Cent } from "./geld.js";
|
||||
import { type Planzeile, PLANZEILEN, type Rechnung, ZIEL_GEWINN, ZIEL_PERSONAL, planWerte } from "./jahresplan.js";
|
||||
|
||||
export interface BwaKonto { konto: string; name: string; monat: Cent; kumuliert: Cent }
|
||||
export interface BwaZeile { zeile: number; bezeichnung: string; monat: Cent; kumuliert: Cent; konten: BwaKonto[]; summe: boolean }
|
||||
export interface Bwa { jahr: number; monat: number; art: string; zeilen: BwaZeile[] }
|
||||
|
||||
export class BwaFehler extends Error {}
|
||||
|
||||
const entities = (s: string) =>
|
||||
s.replace(/ /gi, " ").replace(/&/gi, "&").replace(/</gi, "<").replace(/>/gi, ">").replace(/"/gi, '"')
|
||||
.replace(/&#(\d+);/g, (_, n) => String.fromCharCode(Number(n))).replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCharCode(parseInt(n, 16)));
|
||||
const zelle = (s: string) => entities(s.replace(/<br\s*\/?>/gi, " ").replace(/<[^>]+>/g, "")).replace(/\s+/g, " ").trim();
|
||||
|
||||
/** „59.653,91“ oder „-0,01“ in Cent; leer = null */
|
||||
export function betrag(s: string): Cent | null {
|
||||
const t = s.replace(/\s/g, "");
|
||||
if (!/^-?[\d.]*\d(,\d+)?-?$/.test(t)) return null;
|
||||
const minus = t.startsWith("-") || t.endsWith("-");
|
||||
const [ganz, nach = ""] = t.replace(/-/g, "").replace(/\./g, "").split(",");
|
||||
const c = Number(ganz) * 100 + Number((nach + "00").slice(0, 2));
|
||||
return minus ? -c : c;
|
||||
}
|
||||
|
||||
export function liesBwa(html: string): Bwa {
|
||||
const zeilen = [...html.matchAll(/<tr[^>]*>([\s\S]*?)<\/tr>/gi)].map((m) => [...m[1]!.matchAll(/<t[dh][^>]*>([\s\S]*?)<\/t[dh]>/gi)].map((z) => zelle(z[1]!)));
|
||||
if (!zeilen.length) throw new BwaFehler("In der Datei steht keine Tabelle. Bitte die BWA als .xls aus DATEV (BWA-Wertenachweis) nehmen.");
|
||||
const text = zeilen.map((z) => z.join(" ")).join("\n");
|
||||
const stand = /zum\s+(\d{2})\.(\d{2})\.(\d{4})/.exec(text) ?? /(\w{3})\/(\d{4})/.exec(text);
|
||||
let jahr = 0, monat = 0;
|
||||
if (stand && stand.length === 4) { monat = Number(stand[2]); jahr = Number(stand[3]); }
|
||||
if (!jahr) throw new BwaFehler("Monat und Jahr der BWA nicht gefunden (erwartet „… zum 31.08.2026“).");
|
||||
const art = /(Einnahmen-Ausgaben-BWA|Kurzfristige Erfolgsrechnung|Bewegungsbilanz|Statische Liquidität)/.exec(text)?.[1] ?? "BWA";
|
||||
const aus: BwaZeile[] = [];
|
||||
let akt: BwaZeile | null = null;
|
||||
for (const z of zeilen) {
|
||||
const nr = /^\d{3,4}$/.test(z[0] ?? "") ? Number(z[0]) : null;
|
||||
// Werte stehen in den letzten vier Spalten (Monat Konto/Zeile, kumuliert Konto/Zeile)
|
||||
const w = z.slice(-4).map(betrag);
|
||||
if (nr !== null && z.length >= 6) {
|
||||
akt = { zeile: nr, bezeichnung: z[1] || z[4] || "", monat: w[1] ?? w[0] ?? 0, kumuliert: w[3] ?? w[2] ?? 0, konten: [], summe: false };
|
||||
aus.push(akt);
|
||||
} else if (!akt || !z[2] || z.length < 6) continue;
|
||||
const konto = z[2] ?? "";
|
||||
if (!/^\d{3,}$/.test(konto)) continue;
|
||||
// vierstellig = Verweis auf eine andere Zeile, also eine Summenzeile
|
||||
if (konto.length <= 4) { akt.summe = true; continue; }
|
||||
akt.konten.push({ konto, name: z[4] ?? "", monat: w[0] ?? 0, kumuliert: w[2] ?? 0 });
|
||||
}
|
||||
if (!aus.length) throw new BwaFehler("Keine BWA-Zeilen gefunden. Bitte die BWA als .xls aus DATEV (BWA-Wertenachweis) nehmen.");
|
||||
// Summen wie „Vorläufiges Ergebnis“ ohne Konten, aber mit Gleichheitszeichen oder als Ergebniszeile
|
||||
for (const z of aus) if (/^=|ergebnis|summe|liquiditätsbeitrag|über-\/-unterdeckung|betriebseinnahmen$|betriebsausgaben$|einnahmen-ausgaben-bwa/i.test(z.bezeichnung)) z.summe = true;
|
||||
return { jahr, monat, art, zeilen: aus };
|
||||
}
|
||||
|
||||
// Zuordnung für die Einnahmen-Ausgaben-BWA (Form 43, SKR04), wie in Hennings Muster von Herrn Seeler
|
||||
const VORGABE: Record<number, Planzeile> = {
|
||||
1040: "umsatz", 1050: "umsatz",
|
||||
1230: "material", 1240: "material",
|
||||
1250: "personal",
|
||||
1260: "laufend", 1270: "laufend", 1280: "laufend", 1300: "laufend", 1310: "laufend", 1330: "laufend", 1410: "laufend",
|
||||
1290: "werbung",
|
||||
1320: "afa",
|
||||
1460: "ignorieren", 1681: "ignorieren",
|
||||
1700: "tilgung", 1710: "investition",
|
||||
1800: "unternehmerlohn",
|
||||
1810: "steuer",
|
||||
};
|
||||
|
||||
/** Vorschlag für eine BWA-Zeile: zuerst die bekannte Zeilennummer, sonst nach der Bezeichnung */
|
||||
export function zuordnungVorschlag(z: Pick<BwaZeile, "zeile" | "bezeichnung" | "summe">): Planzeile {
|
||||
if (z.summe) return "ignorieren";
|
||||
if (VORGABE[z.zeile]) return VORGABE[z.zeile]!;
|
||||
const b = z.bezeichnung.toLowerCase();
|
||||
if (/umsatzsteuer|vorsteuer|anzahlung|forderung|verbindlichkeit|privateinlage|darlehen/.test(b)) return "ignorieren";
|
||||
if (/erlös|umsatz/.test(b)) return "umsatz";
|
||||
if (/material|waren|fremdleist/.test(b)) return "material";
|
||||
if (/personal|löhne|gehälter/.test(b)) return "personal";
|
||||
if (/werbe/.test(b)) return "werbung";
|
||||
if (/abschreib|afa/.test(b)) return "afa";
|
||||
if (/privatentnahm/.test(b)) return "unternehmerlohn";
|
||||
if (/tilgung/.test(b)) return "tilgung";
|
||||
if (/raum|fahrzeug|versicherung|beitr|kosten|instandhaltung|werkzeug|zins/.test(b)) return "laufend";
|
||||
return "ignorieren";
|
||||
}
|
||||
|
||||
export interface PlanIstZeile {
|
||||
id: string;
|
||||
text: string;
|
||||
plan: Cent;
|
||||
ist: Cent | null;
|
||||
abweichung: Cent | null;
|
||||
/** in % vom Plan */
|
||||
prozent: number | null;
|
||||
/** Abweichung ab 5 %: gelb, ab 15 % rot; gut = besser als geplant */
|
||||
stufe: "" | "gelb" | "rot" | "gut";
|
||||
/** Kosten: im Plan als negative Zahl gezeigt */
|
||||
kosten: boolean;
|
||||
summe?: boolean;
|
||||
}
|
||||
|
||||
export interface Kennzahl { id: string; text: string; wert: number | null; plan: number; ziel?: number; einheit: "€" | "%"; gut: boolean | null; unter: string }
|
||||
|
||||
/** Ist-Werte je Planzeile aus den BWA-Zeilen: Monat oder kumuliert (Jan bis Monat) */
|
||||
export function istWerte(zeilen: Pick<BwaZeile, "zeile" | "monat" | "kumuliert">[], zuordnung: Map<number, Planzeile>, kumuliert: boolean): Record<string, Cent> {
|
||||
const ist: Record<string, Cent> = Object.fromEntries(PLANZEILEN.map((p) => [p, 0]));
|
||||
for (const z of zeilen) {
|
||||
const p = zuordnung.get(z.zeile);
|
||||
if (!p || p === "ignorieren") continue;
|
||||
ist[p]! += kumuliert ? z.kumuliert : z.monat;
|
||||
}
|
||||
return ist;
|
||||
}
|
||||
|
||||
const ZEILEN: { id: (typeof PLANZEILEN)[number] | "rohertrag" | "ergebnis"; text: string; kosten: boolean; summe?: boolean }[] = [
|
||||
{ id: "umsatz", text: "Umsatzerlöse", kosten: false },
|
||||
{ id: "material", text: "Material und Subunternehmer", kosten: true },
|
||||
{ id: "rohertrag", text: "Rohertrag", kosten: false, summe: true },
|
||||
{ id: "personal", text: "Personalkosten", kosten: true },
|
||||
{ id: "unternehmerlohn", text: "Unternehmerlohn (Privatentnahmen)", kosten: true },
|
||||
{ id: "werbung", text: "Werbekosten", kosten: true },
|
||||
{ id: "laufend", text: "Laufende Kosten (Raum, Fahrzeug, Versicherung, Büro)", kosten: true },
|
||||
{ id: "afa", text: "Abschreibungen", kosten: true },
|
||||
{ id: "ergebnis", text: "Betriebsergebnis", kosten: false, summe: true },
|
||||
{ id: "tilgung", text: "Tilgung Kredite", kosten: true },
|
||||
{ id: "investition", text: "Investitionen", kosten: true },
|
||||
{ id: "steuer", text: "Steuer-Vorauszahlungen (privat)", kosten: true },
|
||||
];
|
||||
|
||||
const ergaenzt = (x: Record<string, Cent>): Record<string, Cent> & { rohertrag: Cent; ergebnis: Cent } => {
|
||||
const rohertrag = x.umsatz! - x.material!;
|
||||
return { ...x, rohertrag, ergebnis: rohertrag - x.personal! - x.unternehmerlohn! - x.werbung! - x.laufend! - x.afa! };
|
||||
};
|
||||
|
||||
export function planIst(r: Rechnung, ist: Record<string, Cent> | null, monat: number, kumuliert: boolean): { zeilen: PlanIstZeile[]; kennzahlen: Kennzahl[] } {
|
||||
const plan = ergaenzt(planWerte(r, monat, kumuliert));
|
||||
const i = ist ? ergaenzt(ist) : null;
|
||||
const zeilen = ZEILEN.map((z): PlanIstZeile => {
|
||||
const p = plan[z.id] ?? 0, w = i ? i[z.id] ?? 0 : null;
|
||||
// Kosten: mehr als geplant ist schlecht; Erlöse und Ergebnis: weniger ist schlecht
|
||||
const abweichung = w === null ? null : z.kosten ? p - w : w - p;
|
||||
const prozent = w === null || !p ? null : Math.round((Math.abs(w - p) / Math.abs(p)) * 1000) / 10;
|
||||
const stufe = abweichung === null || prozent === null || prozent < 5 ? "" : abweichung > 0 ? "gut" : prozent >= 15 ? "rot" : "gelb";
|
||||
return { id: z.id, text: z.text, plan: p, ist: w, abweichung, prozent, stufe, kosten: z.kosten, ...(z.summe ? { summe: true } : {}) };
|
||||
});
|
||||
// Kennzahlen (Roos): Rohertrag, Personal + Werbung vom Rohertrag, Gewinn vom Rohertrag (immer kumuliert)
|
||||
const kum = ergaenzt(planWerte(r, monat, true));
|
||||
const q = (x: Cent, b: Cent) => (b > 0 ? Math.round((x / b) * 100) : null);
|
||||
const pw = (x: Record<string, Cent>) => x.personal! + x.unternehmerlohn! + x.werbung!;
|
||||
const istKum = i && kumuliert ? i : null;
|
||||
const kennzahlen: Kennzahl[] = [
|
||||
{ id: "rohertrag", text: `Rohertrag ${kumuliert ? "bis" : ""}`, wert: i ? i.rohertrag : null, plan: plan.rohertrag, einheit: "€",
|
||||
gut: i ? i.rohertrag >= plan.rohertrag : null, unter: "" },
|
||||
{ id: "personal", text: "Personal + Werbung vom Rohertrag", wert: i ? q(pw(i), i.rohertrag) : null, plan: q(pw(plan), plan.rohertrag) ?? 0, ziel: ZIEL_PERSONAL, einheit: "%",
|
||||
gut: i ? (q(pw(i), i.rohertrag) ?? 999) <= ZIEL_PERSONAL : null, unter: "" },
|
||||
{ id: "gewinn", text: "Gewinn vom Rohertrag", wert: istKum ? q(istKum.ergebnis, istKum.rohertrag) : i ? q(i.ergebnis, i.rohertrag) : null, plan: q(kum.ergebnis, kum.rohertrag) ?? 0, ziel: ZIEL_GEWINN, einheit: "%",
|
||||
gut: i ? (q(i.ergebnis, i.rohertrag) ?? -999) >= ZIEL_GEWINN : null, unter: "" },
|
||||
];
|
||||
return { zeilen, kennzahlen };
|
||||
}
|
||||
Reference in New Issue
Block a user