@fin.cx/skr 1.3.0 → 2.0.0

package/dist_ts/skr.txview.js

@@ -0,0 +1,235 @@
+/**
+ * Bridges between the legacy v1 shapes (float euros, numeric posting keys,
+ * debit/credit account pairs) and the v2 ledger (cents, string BU keys,
+ * per-line Gegenkonto):
+ *
+ * - input converters: ITransactionData / IJournalEntry  ->  core.IJournalDraft
+ * - output projections: v2 JournalEntry (lines)  ->  transaction-shaped views
+ *
+ * The Transaction collection is FROZEN in v2 — these projections are what
+ * keeps transaction-style reads working.
+ */
+import * as plugins from './plugins.js';
+import * as core from './core/index.js';
+import { getDbSync } from './skr.database.js';
+import { JOURNAL_ENTRY_COLLECTION } from './skr.period.js';
+const { centsFromFloat } = plugins.calculation;
+/** v1 numeric posting keys that map 1:1 onto the v2 string BU keys */
+const NUMERIC_KEY_MAP = {
+    1: '1',
+    2: '2',
+    3: '3',
+    8: '8',
+    9: '9',
+    18: '18',
+    19: '19',
+    40: '40',
+    91: '91',
+    94: '94',
+};
+export function mapNumericPostingKey(postingKey) {
+    if (postingKey === undefined || postingKey === null)
+        return '';
+    return NUMERIC_KEY_MAP[postingKey] ?? '';
+}
+/**
+ * v1 postTransaction input -> two-line v2 draft. The amount is NOT split into
+ * net/VAT (v1 semantics: vatAmount was informational) so ledger figures stay
+ * identical across the migration.
+ */
+export function transactionDataToDraft(data) {
+    const amountCents = centsFromFloat(data.amount);
+    const vatCents = data.vatAmount ? centsFromFloat(data.vatAmount) : 0;
+    const lines = [
+        {
+            accountNumber: data.debitAccount,
+            counterAccount: data.creditAccount,
+            side: 'debit',
+            amountCents,
+            buKey: '',
+            buchungstext: data.description,
+            belegfeld1: data.reference,
+            costCenter1: data.costCenter,
+        },
+        {
+            accountNumber: data.creditAccount,
+            counterAccount: data.debitAccount,
+            side: 'credit',
+            amountCents,
+            buKey: '',
+            buchungstext: data.description,
+            belegfeld1: data.reference,
+            costCenter1: data.costCenter,
+        },
+    ];
+    lines[0].vatAmountCents = vatCents;
+    return {
+        date: data.date,
+        description: data.description,
+        reference: data.reference,
+        skrType: data.skrType,
+        currency: 'EUR',
+        lines,
+    };
+}
+/**
+ * v1 postJournalEntry input -> v2 draft. Gegenkonto derivation: when one side
+ * of the entry has exactly one line, it is the counter account for every line
+ * of the other side (the dominant v1 usage); otherwise the first line of the
+ * opposite side is used (documented heuristic — v1 stored no Gegenkonto).
+ */
+export function journalInputToDraft(entry) {
+    const debitLines = entry.lines.filter((line) => (line.debit ?? 0) > 0);
+    const creditLines = entry.lines.filter((line) => (line.credit ?? 0) > 0);
+    const counterFor = (side) => {
+        const opposite = side === 'debit' ? creditLines : debitLines;
+        return opposite[0]?.accountNumber ?? '';
+    };
+    const lines = entry.lines.map((line) => {
+        const isDebit = (line.debit ?? 0) > 0;
+        return {
+            accountNumber: line.accountNumber,
+            counterAccount: counterFor(isDebit ? 'debit' : 'credit'),
+            side: isDebit ? 'debit' : 'credit',
+            amountCents: centsFromFloat(isDebit ? line.debit : line.credit),
+            buKey: mapNumericPostingKey(line.postingKey),
+            buchungstext: line.description ?? entry.description,
+            costCenter1: line.costCenter,
+        };
+    });
+    return {
+        date: entry.date,
+        description: entry.description,
+        reference: entry.reference,
+        skrType: entry.skrType,
+        currency: 'EUR',
+        lines,
+    };
+}
+/**
+ * Project a two-line v2 entry back into the classic transaction shape.
+ * Returns null for entries with more than two lines (journal-only view).
+ */
+export function entryToTransactionView(entry) {
+    const debitLine = entry.lines.find((line) => line.side === 'debit');
+    const creditLine = entry.lines.find((line) => line.side === 'credit');
+    if (!debitLine || !creditLine || entry.lines.length !== 2)
+        return null;
+    return {
+        id: entry.id,
+        transactionNumber: entry.journalNumber ?? entry.id,
+        date: entry.date,
+        debitAccount: debitLine.accountNumber,
+        creditAccount: creditLine.accountNumber,
+        amount: (debitLine.amountCents ?? 0) / 100,
+        vatAmount: (debitLine.vatAmountCents ?? 0) / 100,
+        description: entry.description,
+        reference: entry.reference ?? '',
+        skrType: entry.skrType,
+        status: entry.status,
+        period: entry.period ?? '',
+        fiscalYear: entry.fiscalYear ?? entry.date.getUTCFullYear(),
+        costCenter: debitLine.costCenter1 ?? creditLine.costCenter1,
+        reversalOf: entry.reversalOf,
+    };
+}
+function dayRange(params) {
+    const from = params?.dateFrom ? new Date(params.dateFrom) : null;
+    const to = params?.dateTo ? new Date(params.dateTo) : null;
+    if (from)
+        from.setHours(0, 0, 0, 0);
+    if (to)
+        to.setHours(23, 59, 59, 999);
+    return { from, to };
+}
+/**
+ * Load v2 entries of a date range as core drafts (for DATEV export).
+ */
+export async function loadDraftsForExport(skrType, dateFrom, dateTo) {
+    const docs = await getDbSync()
+        .mongoDb.collection(JOURNAL_ENTRY_COLLECTION)
+        .find({
+        skrType,
+        schemaVersion: 2,
+        status: { $in: ['posted', 'finalized'] },
+        date: { $gte: dateFrom, $lte: dateTo },
+    })
+        .sort({ sequenceNumber: 1 })
+        .toArray();
+    return docs.map((doc) => {
+        const entry = doc;
+        return {
+            date: entry.date,
+            description: entry.description,
+            reference: entry.reference,
+            skrType: entry.skrType,
+            currency: 'EUR',
+            lines: entry.lines.map((line) => ({
+                accountNumber: line.accountNumber,
+                counterAccount: line.counterAccount ?? '',
+                side: (line.side ?? 'debit'),
+                amountCents: line.amountCents ?? 0,
+                buKey: (line.buKey ?? ''),
+                buchungstext: line.buchungstext ?? entry.description,
+                belegfeld1: line.belegfeld1,
+                costCenter1: line.costCenter1,
+                docLink: line.docLink,
+            })),
+        };
+    });
+}
+/**
+ * Per-account activity as transaction-shaped line views from v2 entries —
+ * the data source for reports (trial balance, general ledger, cash flow).
+ * Each view carries the line's own side and its Gegenkonto.
+ */
+export async function accountLineViews(accountNumber, skrType, params) {
+    const { from, to } = dayRange(params);
+    const match = {
+        skrType,
+        schemaVersion: 2,
+        status: { $in: ['posted', 'finalized'] },
+        'lines.accountNumber': accountNumber,
+    };
+    if (from || to) {
+        const range = {};
+        if (from)
+            range.$gte = from;
+        if (to)
+            range.$lte = to;
+        match.date = range;
+    }
+    const docs = await getDbSync()
+        .mongoDb.collection(JOURNAL_ENTRY_COLLECTION)
+        .find(match)
+        .sort({ date: 1, sequenceNumber: 1 })
+        .toArray();
+    const views = [];
+    for (const doc of docs) {
+        const entry = doc;
+        for (const line of entry.lines) {
+            if (line.accountNumber !== accountNumber)
+                continue;
+            const isDebit = line.side === 'debit';
+            views.push({
+                id: entry.id,
+                transactionNumber: entry.journalNumber ?? entry.id,
+                date: entry.date,
+                debitAccount: isDebit ? accountNumber : line.counterAccount ?? '',
+                creditAccount: isDebit ? line.counterAccount ?? '' : accountNumber,
+                amount: (line.amountCents ?? 0) / 100,
+                vatAmount: (line.vatAmountCents ?? 0) / 100,
+                description: line.buchungstext ?? entry.description,
+                reference: entry.reference ?? '',
+                skrType: entry.skrType,
+                status: entry.status,
+                period: entry.period ?? '',
+                fiscalYear: entry.fiscalYear ?? entry.date.getUTCFullYear(),
+                costCenter: line.costCenter1,
+                reversalOf: entry.reversalOf,
+            });
+        }
+    }
+    return views;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2tyLnR4dmlldy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3Nrci50eHZpZXcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7R0FVRztBQUNILE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxJQUFJLE1BQU0saUJBQWlCLENBQUM7QUFDeEMsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQzlDLE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBVTNELE1BQU0sRUFBRSxjQUFjLEVBQUUsR0FBRyxPQUFPLENBQUMsV0FBVyxDQUFDO0FBRS9DLHNFQUFzRTtBQUN0RSxNQUFNLGVBQWUsR0FBZ0M7SUFDbkQsQ0FBQyxFQUFFLEdBQUc7SUFDTixDQUFDLEVBQUUsR0FBRztJQUNOLENBQUMsRUFBRSxHQUFHO0lBQ04sQ0FBQyxFQUFFLEdBQUc7SUFDTixDQUFDLEVBQUUsR0FBRztJQUNOLEVBQUUsRUFBRSxJQUFJO0lBQ1IsRUFBRSxFQUFFLElBQUk7SUFDUixFQUFFLEVBQUUsSUFBSTtJQUNSLEVBQUUsRUFBRSxJQUFJO0lBQ1IsRUFBRSxFQUFFLElBQUk7Q0FDVCxDQUFDO0FBRUYsTUFBTSxVQUFVLG9CQUFvQixDQUFDLFVBQW1CO0lBQ3RELElBQUksVUFBVSxLQUFLLFNBQVMsSUFBSSxVQUFVLEtBQUssSUFBSTtRQUFFLE9BQU8sRUFBRSxDQUFDO0lBQy9ELE9BQU8sZUFBZSxDQUFDLFVBQVUsQ0FBQyxJQUFJLEVBQUUsQ0FBQztBQUMzQyxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxzQkFBc0IsQ0FBQyxJQUFzQjtJQUMzRCxNQUFNLFdBQVcsR0FBRyxjQUFjLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ2hELE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLGNBQWMs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

package/dist_ts/skr.types.d.ts

@@ -53,7 +53,41 @@ export interface IJournalEntryLine {
     credit?: number;
     description?: string;
     costCenter?: string;
-    postingKey: TPostingKey;
+    /** v1 numeric DATEV posting key; optional since schemaVersion 2 (see buKey) */
+    postingKey?: TPostingKey;
+    side?: 'debit' | 'credit';
+    amountCents?: number;
+    counterAccount?: string;
+    /** string-typed DATEV BU-Schlüssel ('' = none) */
+    buKey?: string;
+    buchungstext?: string;
+    belegfeld1?: string;
+    costCenter1?: string;
+    docLink?: string;
+    /** informational VAT share carried on the line (v1 compatibility) */
+    vatAmountCents?: number;
+}
+/**
+ * Transaction-shaped projection of a v2 journal entry (or one of its lines).
+ * The Transaction collection is frozen in v2 — reads go through these views.
+ */
+export interface ITransactionView {
+    id: string;
+    transactionNumber: string;
+    date: Date;
+    debitAccount: string;
+    creditAccount: string;
+    amount: number;
+    vatAmount: number;
+    description: string;
+    reference: string;
+    skrType: TSKRType;
+    status: string;
+    period: string;
+    fiscalYear: number;
+    costCenter?: string;
+    /** id of the entry this one reverses (Storno linkage) */
+    reversalOf?: string;
 }
 export interface ITrialBalanceEntry {
     accountNumber: string;

package/dist_ts/skr.verify.d.ts

@@ -0,0 +1,13 @@
+import type { TSKRType } from './skr.types.js';
+export interface IChainVerificationResult {
+    valid: boolean;
+    entriesChecked: number;
+    issues: string[];
+    headHash: string | null;
+}
+/**
+ * Walk sequence 1..N for (skrType, fiscalYear): check gaplessness, recompute
+ * every entry hash from the persisted payload, verify the chain links, and
+ * compare the final hash against the stored chain head.
+ */
+export declare function verifyHashChain(skrType: TSKRType, fiscalYear: number): Promise<IChainVerificationResult>;

package/dist_ts/skr.verify.js

@@ -0,0 +1,84 @@
+/**
+ * Cryptographic audit-trail verification. Prevention of tampering is
+ * best-effort (doc-level guards); detection is this module: recompute the
+ * whole hash chain from the persisted entries and compare against the stored
+ * chain head.
+ */
+import * as core from './core/index.js';
+import { getDbSync } from './skr.database.js';
+import { JOURNAL_ENTRY_COLLECTION } from './skr.period.js';
+import { getSequenceState } from './skr.sequence.js';
+import { buildHashPayload } from './skr.posting.js';
+/**
+ * Walk sequence 1..N for (skrType, fiscalYear): check gaplessness, recompute
+ * every entry hash from the persisted payload, verify the chain links, and
+ * compare the final hash against the stored chain head.
+ */
+export async function verifyHashChain(skrType, fiscalYear) {
+    const issues = [];
+    const collection = getDbSync().mongoDb.collection(JOURNAL_ENTRY_COLLECTION);
+    const docs = await collection
+        .find({ skrType, fiscalYear, schemaVersion: 2 })
+        .sort({ sequenceNumber: 1 })
+        .toArray();
+    const state = await getSequenceState(skrType, fiscalYear);
+    if (docs.length === 0) {
+        return {
+            valid: !state || state.value === 0,
+            entriesChecked: 0,
+            issues: state && state.value !== 0 ? [`sequence counter is ${state.value} but no entries exist`] : [],
+            headHash: state?.headHash ?? null,
+        };
+    }
+    // gaplessness
+    docs.forEach((doc, index) => {
+        const expected = index + 1;
+        if (doc.sequenceNumber !== expected) {
+            issues.push(`sequence gap: expected ${expected}, found ${doc.sequenceNumber}`);
+        }
+    });
+    // chain
+    const genesis = core.genesisHash(skrType, fiscalYear);
+    const chain = docs.map((doc) => ({
+        sequenceNumber: doc.sequenceNumber,
+        prevHash: doc.prevHash,
+        entryHash: doc.entryHash,
+        payload: buildHashPayload({
+            sequenceNumber: doc.sequenceNumber,
+            skrType: doc.skrType,
+            fiscalYear: doc.fiscalYear,
+            date: doc.date,
+            postedAt: doc.postedAt,
+            description: doc.description,
+            reference: doc.reference,
+            taxScenario: doc.taxScenario,
+            currency: doc.currency,
+            reversalOf: doc.reversalOf,
+            lines: (doc.lines ?? []),
+        }),
+    }));
+    const failure = core.verifyChain(chain, genesis);
+    if (failure) {
+        issues.push(failure.reason);
+    }
+    // head comparison
+    const lastHash = chain[chain.length - 1].entryHash;
+    if (!state) {
+        issues.push('no sequence state document found');
+    }
+    else {
+        if (state.headHash !== lastHash) {
+            issues.push(`stored chain head ${state.headHash} !== last entry hash ${lastHash}`);
+        }
+        if (state.value !== docs.length) {
+            issues.push(`sequence counter ${state.value} !== entry count ${docs.length}`);
+        }
+    }
+    return {
+        valid: issues.length === 0,
+        entriesChecked: docs.length,
+        issues,
+        headHash: state?.headHash ?? null,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2tyLnZlcmlmeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3Nrci52ZXJpZnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7O0dBS0c7QUFDSCxPQUFPLEtBQUssSUFBSSxNQUFNLGlCQUFpQixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM5QyxPQUFPLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQVVwRDs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxlQUFlLENBQ25DLE9BQWlCLEVBQ2pCLFVBQWtCO0lBRWxCLE1BQU0sTUFBTSxHQUFhLEVBQUUsQ0FBQztJQUM1QixNQUFNLFVBQVUsR0FBRyxTQUFTLEVBQUUsQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLHdCQUF3QixDQUFDLENBQUM7SUFDNUUsTUFBTSxJQUFJLEdBQUcsTUFBTSxVQUFVO1NBQzFCLElBQUksQ0FBQyxFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsYUFBYSxFQUFFLENBQUMsRUFBRSxDQUFDO1NBQy9DLElBQUksQ0FBQyxFQUFFLGNBQWMsRUFBRSxDQUFDLEVBQUUsQ0FBQztTQUMzQixPQUFPLEVBQUUsQ0FBQztJQUViLE1BQU0sS0FBSyxHQUFHLE1BQU0sZ0JBQWdCLENBQUMsT0FBTyxFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBQzFELElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUN0QixPQUFPO1lBQ0wsS0FBSyxFQUFFLENBQUMsS0FBSyxJQUFJLEtBQUssQ0FBQyxLQUFLLEtBQUssQ0FBQztZQUNsQyxjQUFjLEVBQUUsQ0FBQztZQUNqQixNQUFNLEVBQUUsS0FBSyxJQUFJLEtBQUssQ0FBQyxLQUFLLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLHVCQUF1QixLQUFLLENBQUMsS0FBSyx1QkFBdUIsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFO1lBQ3JHLFFBQVEsRUFBRSxLQUFLLEVBQUUsUUFBUSxJQUFJLElBQUk7U0FDbEMsQ0FBQztJQUNKLENBQUM7SUFFRCxjQUFjO0lBQ2QsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsRUFBRTtRQUMxQixNQUFNLFFBQVEsR0FBRyxLQUFLLEdBQUcsQ0FBQyxDQUFDO1FBQzNCLElBQUksR0FBRyxDQUFDLGNBQWMsS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUNwQyxNQUFNLENBQUMsSUFBSSxDQUFDLDBCQUEwQixRQUFRLFdBQVcsR0FBRyxDQUFDLGNBQWMsRUFBRSxDQUFDLENBQUM7UUFDakYsQ0FBQztJQUNILENBQUMsQ0FBQyxDQUFDO0lBRUgsUUFBUTtJQUNSLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUMsT0FBTyxFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBQ3RELE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDL0IsY0FBYyxFQUFFLEdBQUcsQ0FBQyxjQUF3QjtRQUM1QyxRQUFRLEVBQUUsR0FBRyxDQUFDLFFBQWtCO1FBQ2hDLFNBQVMsRUFBRSxHQUFHLENBQUMsU0FBbUI7UUFDbEMsT0FBTyxFQUFFLGdCQUFnQixDQUFDO1lBQ3hCLGNBQWMsRUFBRSxHQUFHLENBQUMsY0FBd0I7WUFDNUMsT0FBTyxFQUFFLEdBQUcsQ0FBQyxPQUFpQjtZQUM5QixVQUFVLEVBQUUsR0FBRyxDQUFDLFVBQW9CO1lBQ3BDLElBQUksRUFBRSxHQUFHLENBQUMsSUFBWTtZQUN0QixRQUFRLEVBQUUsR0FBRyxDQUFDLFFBQWdCO1lBQzlCLFdBQVcsRUFBRSxHQUFHLENBQUMsV0FBcUI7WUFDdEMsU0FBUyxFQUFFLEdBQUcsQ0FBQyxTQUFtQjtZQUNsQyxXQUFXLEVBQUUsR0FBRyxDQUFDLFdBQXFCO1lBQ3RDLFFBQVEsRUFBRSxHQUFHLENBQUMsUUFBa0I7WUFDaEMsVUFBVSxFQUFFLEdBQUcsQ0FBQyxVQUFvQjtZQUNwQyxLQUFLLEVBQUUsQ0FBQyxHQUFHLENBQUMsS0FBSyxJQUFJLEVBQUUsQ0FBWTtTQUNwQyxDQUFDO0tBQ0gsQ0FBQyxDQUFDLENBQUM7SUFDSixNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsV0FBVyxDQUFDLEtBQUssRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNqRCxJQUFJLE9BQU8sRUFBRSxDQUFDO1FBQ1osTUFBTSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDOUIsQ0FBQztJQUVELGtCQUFrQjtJQUNsQixNQUFNLFFBQVEsR0FBRyxLQUFLLENBQUMsS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7SUFDbkQsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ1gsTUFBTSxDQUFDLElBQUksQ0FBQyxrQ0FBa0MsQ0FBQyxDQUFDO0lBQ2xELENBQUM7U0FBTSxDQUFDO1FBQ04sSUFBSSxLQUFLLENBQUMsUUFBUSxLQUFLLFFBQVEsRUFBRSxDQUFDO1lBQ2hDLE1BQU0sQ0FBQyxJQUFJLENBQUMscUJBQXFCLEtBQUssQ0FBQyxRQUFRLHdCQUF3QixRQUFRLEVBQUUsQ0FBQyxDQUFDO1FBQ3JGLENBQUM7UUFDRCxJQUFJLEtBQUssQ0FBQyxLQUFLLEtBQUssSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ2hDLE1BQU0sQ0FBQyxJQUFJLENBQUMsb0JBQW9CLEtBQUssQ0FBQyxLQUFLLG9CQUFvQixJQUFJLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztRQUNoRixDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU87UUFDTCxLQUFLLEVBQUUsTUFBTSxDQUFDLE1BQU0sS0FBSyxDQUFDO1FBQzFCLGNBQWMsRUFBRSxJQUFJLENBQUMsTUFBTTtRQUMzQixNQUFNO1FBQ04sUUFBUSxFQUFFLEtBQUssRUFBRSxRQUFRLElBQUksSUFBSTtLQUNsQyxDQUFDO0FBQ0osQ0FBQyJ9

package/package.json

@@ -1,16 +1,10 @@
 {
   "name": "@fin.cx/skr",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "description": "SKR03 and SKR04 German accounting standards for double-entry bookkeeping",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "type": "module",
-  "scripts": {
-    "test": "tstest test/ --verbose --logfile --timeout=60 && pnpm run test:published-types",
-    "test:published-types": "pnpm build && pnpm exec tsc --pretty false -p test/fixtures/strict-consumer/tsconfig.json",
-    "build": "tsbuild --web --node",
-    "buildDocs": "tsdoc"
-  },
   "keywords": [
     "skr03",
     "skr04",
@@ -24,28 +18,28 @@
   ],
   "author": "Fin.cx",
   "license": "MIT",
-  "packageManager": "pnpm@10.11.0",
   "dependencies": {
-    "@e-invoice-eu/core": "^3.1.0",
-    "@fin.cx/einvoice": "5.2.0",
-    "@push.rocks/smartdata": "^7.1.7",
-    "@push.rocks/smartfile": "^13.1.2",
-    "@push.rocks/smartfs": "^1.5.0",
-    "@push.rocks/smarthash": "^3.2.6",
+    "@e-invoice-eu/core": "^3.1.1",
+    "@fin.cx/calculation": "^1.1.1",
+    "@fin.cx/einvoice": "6.0.0",
+    "@push.rocks/smartdata": "^7.2.1",
+    "@push.rocks/smartfile": "^13.1.3",
+    "@push.rocks/smartfs": "^1.5.1",
+    "@push.rocks/smarthash": "^3.2.7",
     "@push.rocks/smartlog": "^3.2.2",
     "@push.rocks/smartpath": "^6.0.0",
-    "@push.rocks/smartpdf": "^4.2.0",
+    "@push.rocks/smartpdf": "^4.2.2",
     "@push.rocks/smarttime": "^4.2.3",
     "@push.rocks/smartunique": "^3.0.9",
     "merkletreejs": "^0.6.0",
     "node-forge": "^1.4.0"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^4.4.0",
-    "@git.zone/tsrun": "^2.0.2",
-    "@git.zone/tstest": "^3.6.3",
-    "@push.rocks/qenv": "^6.1.3",
-    "@types/node": "^25.6.0",
+    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsrun": "^2.0.5",
+    "@git.zone/tstest": "^3.6.6",
+    "@push.rocks/qenv": "^6.1.4",
+    "@types/node": "^26.1.1",
     "@types/node-forge": "^1.3.14"
   },
   "repository": {
@@ -67,9 +61,12 @@
     "cli.js",
     ".smartconfig.json",
     "readme.md",
-    "license.md"
+    "license"
   ],
-  "pnpm": {
-    "overrides": {}
+  "scripts": {
+    "test": "tstest test/ --verbose --logfile --timeout=60 && pnpm run test:published-types",
+    "test:published-types": "pnpm build && pnpm exec tsc --pretty false -p test/fixtures/strict-consumer/tsconfig.json",
+    "build": "tsbuild --web --node",
+    "buildDocs": "tsdoc"
   }
-}
+}

package/readme.hints.md

@@ -1,5 +1,42 @@
 # Project Readme Hints
 
+## Dev Environment (2026-07-09)
+
+- Local services are managed by `gitzone services` (@git.zone/cli >= 2.23.0); the old
+  `services.sh` was removed. `gitzone services start` creates MongoDB as a **single-node
+  replica set** (rs0, keyfile auth, mongod on the mapped port inside the container) —
+  required because skr v2 posting uses MongoDB transactions. Verify with
+  `.nogit/debug/check-replicaset.ts` (tsx).
+- Service selection lives in `.smartconfig.json` under `@git.zone/cli.services`;
+  runtime config in `.nogit/env.json`. Old standalone data was backed up to
+  `.nogit/mongodata.pre-replset.bak` (disposable test data).
+- Program plan for the accounting roadmap ("no external tax accountant") is in
+  `readme.plan.md`; M0 = skr v2 core hardening. @fin.cx/calculation ships the cents
+  module (TCents) that skr v2 money handling builds on.
+
+## M0 Phase 2 — stateless core (2026-07-09)
+
+- `ts/core/` is the pure booking core (exported as `core` from the package index):
+  types, BU keys, tax-scenario cascade, account policies, recipes, validation,
+  DATEV EXTF writer, hash chain. Hard rule: core imports only @fin.cx/calculation
+  (+ smarthash for SHA-256) — no smartdata/fs/network.
+- **BU-key corrections vs v1/finance.plus** (cross-checked 2026-07-09): 18/19 =
+  steuerpflichtiger innergemeinschaftlicher Erwerb 7%/19% (§1a UStG); 91/94 =
+  Leistungsempfänger schuldet die Steuer 7%/19% (§13b UStG); 40 = Aufhebung der
+  Automatik. v1's `skr.postingkeys.ts` (numeric keys with partly different meanings)
+  is superseded by `ts/core/core.bukeys.ts`. Official DATEV table (Hilfe-Center doc
+  0904313) is portal-gated — final verification = manual DATEV import per RC.
+- **DATEV EXTF v13 facts** (verified against a DATEV-importable reference file):
+  125 data columns, 31 header fields, field 114 = Festschreibung, decimal-comma
+  amounts, Belegdatum TTMM, text fields quoted, CRLF; file encoding must be CP1252
+  (conversion happens at the IO layer, core emits a JS string).
+  `ts/core/core.datev.captions.ts` is generated from that reference — do not edit.
+- Automatik convention in recipes: a line on an Automatikkonto carries key '' when
+  the entry has no explicit VAT lines, and key '40' when explicit VAT lines exist
+  (automatism must be cancelled so DATEV import doesn't double the tax).
+- PROVISIONAL policy accounts (verify in M-A): reduced-rate Skonto accounts
+  (3731/8731, 5731/4731) and rounding-diff accounts (2700/2300, 4830/6300).
+
 ## Current Status (2025-10-27)
 
 ### Test Results

package/readme.md

@@ -4,6 +4,24 @@
 
 It is built for developers who need a programmable accounting core instead of a pile of CSV glue code: initialize a chart of accounts, post validated transactions and journal entries, generate reports, and archive year-end data in a structured export format.
 
+**Version 2** makes the ledger filing-grade:
+
+- Exact integer-cent amounts internally (no float drift; balance checks are `===`)
+- Atomic posting via MongoDB transactions (replica set required)
+- GoBD audit trail: gapless sequence numbers, SHA-256 hash chain, immutable posted entries, Storno-only corrections
+- Festschreibung: period locking with cryptographic chain verification
+- A pure, stateless booking core (`core` export): BU keys, tax-scenario detection, booking recipes, validation — no database needed
+- DATEV Buchungsstapel export in the real EXTF 700 / Formatversion 13 layout (125 columns)
+
+### Breaking changes in v2
+
+- MongoDB must run as a **replica set** (single-node is fine); `initialize()` fails hard without transaction support. `gitzone services start` creates a suitable MongoDB automatically.
+- `postTransaction()` / `reverseTransaction()` return transaction-shaped views (`ITransactionView`), not `Transaction` documents; the Transaction collection is frozen as a legacy read model.
+- Posted entries are immutable: reversing never mutates the original (`status` stays `posted`; linkage via `reversalOf`).
+- `exportToDATEV()` now emits the EXTF 700 format; persist the string as **CP1252**.
+- `IJournalEntryLine.postingKey` is optional; the v2 line fields (`side`, `amountCents`, `counterAccount`, string `buKey`) are authoritative.
+- Existing v1 data: run `api.migrateToV2()` once (idempotent; keeps all legacy fields; returns a report to archive).
+
 ## Issue Reporting and Security
 
 For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
@@ -29,11 +47,15 @@ For reporting bugs, issues, or security vulnerabilities, please visit [community
 ## Requirements
 
 - Node.js 20+ with ESM support
-- A reachable MongoDB instance
+- A reachable MongoDB instance running as a **replica set** (transactions are
+  mandatory for atomic posting; a single-node replica set is sufficient —
+  `gitzone services start` provides one locally)
 - `pnpm`
 
 The test setup reads MongoDB connection details from `.nogit/` via `@push.rocks/qenv`, but the runtime API only needs a `mongoDbUrl` and an optional `dbName`.
 
+If you use the invoice helpers, pass `invoiceExportPath` to control where content-addressed invoice XML, PDF files, metadata, validation output, and the registry are stored. Without it, invoices are stored under `./exports/invoices` from the current working directory.
+
 ## Installation
 
 ```bash
@@ -48,6 +70,7 @@ import { SkrApi } from '@fin.cx/skr';
 const api = new SkrApi({
   mongoDbUrl: 'mongodb://localhost:27017',
   dbName: 'accounting_demo',
+  invoiceExportPath: './exports/invoices',
 });
 
 await api.initialize('SKR03');
@@ -176,6 +199,73 @@ const ok = api.validateDoubleEntry(100, 100);
 const reversed = await api.reverseTransaction(transactionId);
 ```
 
+Period, balance, and audit helpers:
+
+```ts
+await api.closePeriod('2024-12', '9400');
+
+const bankBalance = await api.getAccountBalance('1200', new Date('2024-12-31'));
+
+await api.recalculateBalances();
+
+const auditFindings = await api.getUnbalancedTransactions();
+```
+
+Account CSV import and export:
+
+```ts
+const imported = await api.importAccountsFromCSV(csvContent);
+const accountCsv = await api.exportAccountsToCSV();
+```
+
+## v2 Ledger: Recipes, Festschreibung, Audit Chain
+
+The stateless core builds validated drafts; the poster writes them atomically:
+
+```ts
+import { SkrApi, core } from '@fin.cx/skr';
+
+const api = new SkrApi({ mongoDbUrl, dbName });
+await api.initialize('SKR03');
+const policy = api.getDefaultPolicy();
+
+// booking recipes are pure functions — usable without any database
+const draft = core.bookVendorInvoice(
+  {
+    date: new Date(),
+    vendorAccount: '70001',
+    grossCents: 11900,
+    scenario: 'domestic_standard',
+    invoiceNumber: 'RE-1001',
+    description: 'Bürobedarf',
+  },
+  policy,
+);
+
+const entry = await api.postDraft(draft); // gapless sequence + hash chain
+const storno = await api.postStorno(entry); // corrections never mutate
+
+await api.festschreibePeriod('2026-03'); // GoBD period lock
+const audit = await api.verifyAuditChain(2026); // recompute the whole chain
+const balance = await api.getAccountBalanceCents('1200'); // exact cents
+
+const { csv, filename } = await api.exportDatevBuchungsstapel({
+  dateFrom: new Date('2026-03-01'),
+  dateTo: new Date('2026-03-31'),
+  consultantNumber: 1001,
+  clientNumber: 456,
+  fiscalYearStart: new Date('2026-01-01'),
+  festschreibung: true,
+});
+// persist csv as CP1252 — DATEV expects ANSI encoding
+```
+
+Also in `core`: `bookCustomerInvoice` (incl. intra-EU supply, export, §13b),
+`bookBankPayment` (Skonto with VAT correction, tolerance write-offs),
+`bookInternalTransfer` (Geldtransit), `bookToSuspense`/`resolveSuspense`,
+`fxDifferenceLines`, `detectTaxScenario` (confidence-scored cascade), the
+BU-key table (`BU_KEY_RULES`), and `validateJournalDraft`.
+
 ## Reports And Exports
 
 Available reporting methods on `SkrApi`:
@@ -256,6 +346,8 @@ The API also exposes:
 - `createInvoiceComplianceReport()`
 - `generateInvoice()`
 
+Invoice imports are stored by content hash, deduplicated, indexed in an NDJSON registry, and searchable by direction, date range, party, amount range, invoice number, and status metadata.
+
 ## Public Exports
 
 Top-level exports include:
@@ -274,6 +366,7 @@ Top-level exports include:
 - `PdfReportGenerator`
 - `SecurityManager`
 - `SKR03_ACCOUNTS`, `SKR04_ACCOUNTS`
+- `SKR03_ACCOUNT_CLASSES`, `SKR04_ACCOUNT_CLASSES`
 
 This makes the package usable as both an application-facing API and a toolkit for custom accounting workflows.