Accounting A-1: Ingest-Fundament (unabhaengiger Ledger, idempotent, read-only)

Neues Modul PolyTrader.Modules.Accounting (IPolyTraderModule, acc_-Praefix, nur Core-Referenz,
KEIN Handel). Konzept: docs/konzepte/KONZEPT-Modul-Accounting.md, Phase A-1.

Buchungsgrundlage ausschliesslich aus unabhaengigen Polymarket-/On-Chain-Abrufen (nie unsere
Trading-DB), append-only, prueffaehig:
- Modelle: LedgerEntry (+ LedgerEventType), IngestRun (mit Balance-Anker), RawSnapshot,
  RawActivity/RawTransfer (normalisierte Eingaben, entkoppeln pure Logik von der API-Feldbenennung).
- AccountingClassifier (Logic/, pur+getestet): Activity->Buchungssatz (Typ/Vorzeichen: BUY=Cash raus
  inkl. Fee, SELL=Cash rein minus Fee, Redeem/Reward +, Split/Merge/Conversion geldneutral),
  stabiler Idempotency-Key; Transfer-Klassifikation trennt intern (System-Contract-Whitelist) von
  externen Deposits/Withdrawals. SumNet fuer den Balance-Anker-Abgleich.
- AccountingDbContext (acc_ledger append-only + Unique-Index Idempotency, acc_ingest_runs, acc_raw;
  Autoincrement-PKs). Migration InitialAccounting generiert UND angewendet. Repos mit idempotentem
  Upsert (true=neu/false=Duplikat).
- AccountingIngestService (BackgroundService): testbarer IngestAccountAsync - Activity + On-Chain-
  Transfers klassifizieren + idempotent buchen, Rohschnappschuss ablegen, Lauf inkl. Balance-Anker-
  Delta protokollieren; Backfill vs. inkrementell (Lookback-Ueberlappung gegen API-Lag).
- Quellen hinter Interfaces (IActivitySource/ITransferSource/IBalanceAnchorSource) mit Null-Stubs:
  Modul laeuft offline und bucht korrekt nichts. Live-Abruf + System-Contract-Whitelist = Zielland.
- UI designerfaehig (partial + .Designer.cs): Tabs Ledger (filterbar) + Abruf/Status (Ingest-Laeufe,
  Balance-Anker, manueller Backfill/Inkrement).
- Program.cs (beide Modul-Listen) + sln + App/Tests-Referenzen.

A-2 (Abrechnung/BWA/FX), A-3 (US-Steuerschicht FIFO/Form-8949), A-4 (CSV/PDF via PDFsharp/MigraDoc)
folgen. Tests: +12 (Klassifikation, intern/extern-Transfer, Ingest-Idempotenz, Balance-Anker,
Inkrement-Fenster). Build 0 Fehler, 379 Tests gruen, --smoke-ui alle 6 Views gruen.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Richard
2026-07-20 08:54:12 +02:00
co-authored by Claude Opus 4.8
parent c7668170a4
commit a3c145c0ed
22 changed files with 1995 additions and 2 deletions
@@ -0,0 +1,44 @@
using System;
namespace PolyTrader.Modules.Accounting.Models
{
/// <summary>
/// Normalisierte Polymarket-Activity-Position (Eingabe des Klassifikators). Die Live-Quelle
/// (<c>IActivitySource</c>) mappt die tatsächliche API-JSON auf dieses Modell — so bleibt die
/// pure Buchungslogik von der (im Zielland zu verifizierenden) API-Feldbenennung entkoppelt.
/// </summary>
public sealed class RawActivity
{
public string Type { get; init; } = string.Empty; // TRADE/REDEEM/REWARD/FEE/SPLIT/MERGE/CONVERSION
public string Side { get; init; } = string.Empty; // BUY/SELL (bei TRADE)
public DateTime Timestamp { get; init; }
public string TxHash { get; init; } = string.Empty;
public int LogIndex { get; init; }
public string TokenId { get; init; } = string.Empty;
public string MarketSlug { get; init; } = string.Empty;
public string Outcome { get; init; } = string.Empty;
public decimal Size { get; init; } // Shares
public decimal Price { get; init; } // USDC je Share
public decimal UsdcAmount { get; init; } // Brutto-USDC des Ereignisses
public decimal Fee { get; init; }
public string RawJson { get; init; } = string.Empty;
}
/// <summary>
/// Normalisierter On-Chain-USDC-Transfer des Safe-Wallets (Eingabe des Klassifikators). Die
/// Live-Quelle liefert ERC-20-Transfer-Logs; die Klassifikation trennt interne Bewegungen
/// (Safe ↔ Polymarket-System-Contracts, bereits in der Activity) von echten externen
/// Ein-/Auszahlungen.
/// </summary>
public sealed class RawTransfer
{
public DateTime Timestamp { get; init; }
public string TxHash { get; init; } = string.Empty;
public int LogIndex { get; init; }
public string FromAddress { get; init; } = string.Empty;
public string ToAddress { get; init; } = string.Empty;
public decimal UsdcAmount { get; init; } // positiv
public bool IsIncoming { get; init; } // Ziel == unser Wallet
public string RawJson { get; init; } = string.Empty;
}
}