Files
PolyTraderSharp/docs
RichardandClaude Opus 4.8 a3c145c0ed 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>
2026-07-20 08:54:12 +02:00
..

Doku (Predictalytics / PolyTraderSharp)

Zentrale Ablage für Konzepte, Umsetzungspläne, Ideen und Fach-/Business-Dokumente — nach Typ in Unterordnern organisiert. Code-gekoppelte Umsetzungspläne bleiben bewusst in diesem Repo (statt in einem separaten Docs-Repo), damit „Plan → umsetzende Commits" nachvollziehbar bleibt.

Struktur

  • konzepte/ — Konzepte für neue Module/Features (das „Warum" und „Was", vor der Umsetzung).
    • KONZEPT-Modul-Accounting.md — Buchhaltungs-/Steuer-Reporting-Modul (unabhängiger Polymarket-Abruf, BWA, CSV/PDF, US-Steuer Florida LLC).
    • KONZEPT-Modul-DataDriven.md
  • umsetzungsplaene/ — konkrete, slice-weise Implementationspläne (das „Wie"), oft mit file:line-Bezügen und Fortschritt.
    • UMSETZUNGSPLAN-Modularisierung.md — Umbau Copytrader → Core + Module.
    • UMSETZUNGSPLAN-CopyTrading-Verbesserungen.md — Rentabilitäts-/Fable-Plan Copytrading.
    • UMSETZUNGSPLAN-Fable-Review-Fixes.md — Fable-Code-Review-Fixes (Slices 06 + Tests).
    • UMSETZUNGSPLAN-Modul-ResolutionFarming.md — Strategiemodul ResolutionFarming.
    • UMSETZUNGSPLAN-Modul-MarketMaking.md — Strategiemodul MarketMaking (Phase-1-blockiert).
    • UMSETZUNGSPLAN-Modul-BundleArbitrage.md — Strategiemodul BundleArbitrage (Phase-1-blockiert).
    • UMSETZUNGSPLAN-AutoRedeem.md, UMSETZUNGSPLAN-AI-Aufloesequalitaet.md, UMSETZUNGSPLAN-StrategieDrift.md
  • ideen/ — frühe Ideen/Explorationen, bevor sie zu einem Konzept oder Umsetzungsplan reifen.
  • pruefplaene/ — Prüf-/Validierungspläne.
    • PREDICTALYTICS-PRUEFPLAN-Master-Auswahl.md — Master-Trader-Auswahl (separates Predictalytics-Projekt).
  • steuer/ — Steuer-/Buchhaltungs-Fachdokumente & Vorlagen (auch zum Weitergeben an Berater).
    • Accounting-US-Tax-Questionnaire.md — Fragebogen (EN) für die US-Steuerberaterin (Florida LLC).

Konventionen

  • Neue Konzepte: KONZEPT-*.mdkonzepte/. Neue Umsetzungspläne: UMSETZUNGSPLAN-*.mdumsetzungsplaene/.
  • Übergreifende/an Externe weitergebbare Dokumente können später in ein eigenes Predictalytics-Docs-Repo ausgelagert werden (Ordner rausziehen genügt) — für jetzt bewusst hier gebündelt.