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
parent c7668170a4
commit a3c145c0ed
22 changed files with 1995 additions and 2 deletions
@@ -0,0 +1,69 @@
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using PolyTrader.Core.Configuration;
+using PolyTrader.Core.Modularity;
+using PolyTrader.Modules.Accounting.Persistence;
+using PolyTrader.Modules.Accounting.Services;
+
+namespace PolyTrader.Modules.Accounting
+{
+    /// <summary>
+    /// Modul „Accounting": vollständige, von unserer Trading-DB UNABHÄNGIGE, buchhalterisch korrekte
+    /// Erfassung aller Transaktionen der Live-Accounts (direkte Polymarket-/On-Chain-Abrufe → append-only
+    /// Ledger). Reines Ingest-/Reporting-Modul, KEIN Handel. Konzept: docs/konzepte/KONZEPT-Modul-Accounting.md.
+    ///
+    /// A-1 (dieser Slice): Modul + acc_-Persistenz + pure Klassifikation + idempotenter Ingest hinter
+    /// Interfaces (Null-Quellen offline; Live-Abruf im Zielland) + Ledger-/Status-UI. A-2 Abrechnung/BWA/FX,
+    /// A-3 US-Steuerschicht, A-4 CSV/PDF-Export folgen.
+    /// </summary>
+    public class AccountingModule : IPolyTraderModule
+    {
+        public string Name => "Accounting";
+        public string DbPrefix => "acc_";
+
+        public void RegisterServices(IServiceCollection services, IConfiguration configuration)
+        {
+            var conn = configuration["Database:MySqlConnectionString"] ?? string.Empty;
+            services.AddDbContextFactory<AccountingDbContext>(o => o.UseMySql(conn, DatabaseServerVersion.Value));
+
+            services.AddSingleton<ILedgerRepository, EfLedgerRepository>();
+            services.AddSingleton<IIngestRunRepository, EfIngestRunRepository>();
+            services.AddSingleton<IRawSnapshotRepository, EfRawSnapshotRepository>();
+
+            // Ingest-Quellen: offline Null-Stubs (das Modul läuft ohne Live-Anbindung und bucht korrekt
+            // nichts). Im Zielland werden die echten Quellen (Polymarket /activity, Alchemy-Transfers,
+            // GetUsdcBalanceAsync) + die System-Contract-Whitelist registriert. Muster wie RF.
+            services.AddSingleton<IActivitySource, NullActivitySource>();
+            services.AddSingleton<ITransferSource, NullTransferSource>();
+            services.AddSingleton<IBalanceAnchorSource, NullBalanceAnchorSource>();
+            services.AddSingleton(new AccountingSystemContracts());
+
+            services.AddSingleton<AccountingIngestService>();
+            services.AddHostedService(sp => sp.GetRequiredService<AccountingIngestService>());
+        }
+
+        public void RegisterUi(IModuleUiHost host, System.IServiceProvider services)
+        {
+            host.RegisterView(new ModuleView
+            {
+                Id = "accounting.main",
+                Title = "Accounting",
+                Group = "Accounting",
+                Order = 400,
+                CreateForm = () =>
+                {
+                    var form = new Ui.AccountingMainForm();
+                    form.Initialize(services);
+                    return form;
+                }
+            });
+        }
+
+        public Task StartAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+
+        public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+    }
+}