@superheld/summae-core 0.1.0 → 0.2.0

package/README.md

@@ -20,7 +20,7 @@ const susa = ops.project('trialBalance', { fiscalYear: 2026, throughPeriod: 12 }
 
 **📖 Vollständige Dokumentation** — Installation, Initialisierung, komplette
 API-Referenz (alle Operationen & Projektionen), Value Objects, Fehlerkatalog:
-**[summae-Handbuch](../../../../docs/handbuch/README.md)**.
+**[summae-Handbuch](https://github.com/Superheld/summae/blob/main/docs/handbuch/README.md)**.
 
 > Build aus dem Repo: `pnpm build` (tsup → `dist/`). Im Workspace zeigen die
 > `exports` auf die TS-Source (vitest/tsx ohne Build); beim Publish überschreibt

package/dist/index.cjs

@@ -825,6 +825,13 @@ var FiscalYear = class _FiscalYear {
     const periods = explicitPeriods === null ? _FiscalYear.monthlyPeriods(start, end) : explicitPeriods.map((d) => new Period(d.period, d.start, d.end));
     return new _FiscalYear(id, year, start, end, periods);
   }
+  /**
+   * Aus Persistenz wiederherstellen: Status und Perioden explizit übernehmen
+   * (kein Neuaufbau, keine Validierung) — Pendant zu PHPs `FiscalYear::restore`.
+   */
+  static restore(id, year, start, end, status, periods) {
+    return new _FiscalYear(id, year, start, end, periods, status);
+  }
   static monthlyPeriods(start, end) {
     const periods = [];
     let cursor = start;
@@ -948,7 +955,7 @@ var AuditRecord = class {
 };
 
 // src/ledger/open-item.ts
-var OpenItem = class {
+var OpenItem = class _OpenItem {
   constructor(id, kind, originEntryId, originLineIndex, money, voucherId, openedAt, partnerId = null) {
     this.id = id;
     this.kind = kind;
@@ -968,6 +975,15 @@ var OpenItem = class {
   openedAt;
   partnerId;
   settlementList = [];
+  /**
+   * Aus Persistenz wiederherstellen: bereits validierte Ausgleiche direkt setzen
+   * (keine erneute Prüfung) — Pendant zu PHPs `OpenItem::restore`.
+   */
+  static restore(id, kind, originEntryId, originLineIndex, money, voucherId, openedAt, partnerId, settlements) {
+    const item = new _OpenItem(id, kind, originEntryId, originLineIndex, money, voucherId, openedAt, partnerId);
+    item.settlementList.push(...settlements);
+    return item;
+  }
   settlements() {
     return this.settlementList;
   }
@@ -1840,7 +1856,7 @@ function lastDayOfMonthAfter(base, monthsToAdd) {
     `${String(year).padStart(4, "0")}-${String(month0 + 1).padStart(2, "0")}-${String(lastDay).padStart(2, "0")}`
   );
 }
-var Asset = class {
+var Asset = class _Asset {
   constructor(id, name, assetClass, assetAccount, acquisitionCost, acquiredOn, route, usefulLifeMonths, monthlySchedule, voucherId) {
     this.id = id;
     this.name = name;
@@ -1892,6 +1908,44 @@ var Asset = class {
   recordDepreciation(planMonth, date, amount, entryId) {
     this.depreciations.push({ planMonth, date, amount, entryId });
   }
+  /** AfA-Lebenslauf in persistierbarer Form — Pendant zu PHPs `depreciationsForPersistence`. */
+  depreciationsForPersistence() {
+    return this.depreciations.map((booking) => ({
+      planMonth: booking.planMonth,
+      date: booking.date.iso,
+      amount: booking.amount.toJSON(),
+      entryId: booking.entryId.value
+    }));
+  }
+  /**
+   * Aus Persistenz wiederherstellen: Stammdaten + AfA-Lebenslauf + Abgangsstatus
+   * direkt setzen (keine erneute Prüfung) — Pendant zu PHPs `Asset::restore`.
+   */
+  static restore(id, name, assetClass, assetAccount, acquisitionCost, acquiredOn, route, usefulLifeMonths, monthlySchedule, voucherId, depreciations, disposed, disposedOn) {
+    const asset = new _Asset(
+      id,
+      name,
+      assetClass,
+      assetAccount,
+      acquisitionCost,
+      acquiredOn,
+      route,
+      usefulLifeMonths,
+      monthlySchedule,
+      voucherId
+    );
+    for (const booking of depreciations) {
+      asset.depreciations.push({
+        planMonth: booking.planMonth,
+        date: booking.date,
+        amount: booking.amount,
+        entryId: booking.entryId
+      });
+    }
+    asset.disposed = disposed;
+    asset.disposedOn = disposedOn;
+    return asset;
+  }
   accumulatedDepreciationAt(asOf) {
     let sum = this.acquisitionCost.subtract(this.acquisitionCost);
     for (const booking of this.depreciations) {
@@ -3954,14 +4008,37 @@ var Tenant = class _Tenant {
   ids;
   static inMemory(name, baseCurrency, clock = new SystemClock(), ids, dimensions = DimensionRegistry.empty(), taxCodes = TaxCodeRegistry.empty(), taxProfile = TaxProfile.default(), mappings = MappingRegistry.empty()) {
     const idGen = ids ?? new UuidV7IdGenerator(clock);
-    const accounts = new InMemoryAccountRepository();
-    const fiscalYears = new InMemoryFiscalYearRepository();
-    const vouchers = new InMemoryVoucherRepository();
-    const journal = new InMemoryJournalRepository();
-    const openItems = new InMemoryOpenItemRepository();
-    const assets = new InMemoryAssetRepository();
-    const partners = new InMemoryPartnerRepository();
-    const audit = new InMemoryAuditTrail();
+    return _Tenant.fromPorts(
+      idGen.next(),
+      // Mandanten-ID = erste generierte ID (Determinismus)
+      name,
+      baseCurrency,
+      {
+        accounts: new InMemoryAccountRepository(),
+        fiscalYears: new InMemoryFiscalYearRepository(),
+        vouchers: new InMemoryVoucherRepository(),
+        journal: new InMemoryJournalRepository(),
+        openItems: new InMemoryOpenItemRepository(),
+        assets: new InMemoryAssetRepository(),
+        partners: new InMemoryPartnerRepository(),
+        audit: new InMemoryAuditTrail()
+      },
+      clock,
+      idGen,
+      dimensions,
+      taxCodes,
+      taxProfile,
+      mappings
+    );
+  }
+  /**
+   * Mandant aus beliebigen Ports bauen (Service-Verdrahtung bleibt hier im Kern).
+   * `inMemory` nutzt das mit In-Memory-Ports; der Persistenz-Adapter
+   * (`@superheld/summae-knex`) reicht DB-gestützte Ports herein — derselbe
+   * `Tenant`, nur andere Ports.
+   */
+  static fromPorts(tenantId, name, baseCurrency, ports, clock, ids, dimensions = DimensionRegistry.empty(), taxCodes = TaxCodeRegistry.empty(), taxProfile = TaxProfile.default(), mappings = MappingRegistry.empty()) {
+    const { accounts, fiscalYears, vouchers, journal, openItems, assets, partners, audit } = ports;
     const ledger = new Ledger(
       baseCurrency,
       accounts,
@@ -3972,14 +4049,14 @@ var Tenant = class _Tenant {
       audit,
       dimensions,
       clock,
-      idGen
+      ids
     );
     const tax = new TaxService(baseCurrency, taxCodes, taxProfile, journal);
-    const assetService = new AssetService(baseCurrency, assets, fiscalYears, vouchers, ledger, idGen);
-    const costing = new CostingService(baseCurrency, accounts, journal, idGen);
-    const partnerService = new PartnerService(partners, audit, clock, idGen);
+    const assetService = new AssetService(baseCurrency, assets, fiscalYears, vouchers, ledger, ids);
+    const costing = new CostingService(baseCurrency, accounts, journal, ids);
+    const partnerService = new PartnerService(partners, audit, clock, ids);
     return new _Tenant(
-      idGen.next(),
+      tenantId,
       name,
       baseCurrency,
       accounts,
@@ -3997,7 +4074,7 @@ var Tenant = class _Tenant {
       partnerService,
       mappings,
       clock,
-      idGen
+      ids
     );
   }
 };