Erste Stufe der V3.3-Spezifikation: Token- und Kosten-Tracking-Fundament.
Schema und Persistenz:
- Neue Flyway-Migration V2__token_tracking.sql mit sechs Token-/Preis-Snapshot-
Spalten in processing_attempt, neuer model_price-Tabelle (Composite-Key
provider+model_name) und Default-Preisen fuer beide Provider-Familien.
- SqliteModelPriceRepositoryAdapter mit UPSERT, transaktionalem Batch und
invalidUpdatedAt-Mapping.
- Zentrale SqliteConnectionFactory; alle direkten DriverManager.getConnection-
Stellen in den Repository-Adaptern (Document, Attempt, History, UnitOfWork)
auf die Factory umgezogen, damit WAL und busy_timeout pro Connection greifen.
Application und Domain:
- Neue DTOs AiUsageMetadata, ModelPriceEntry/View/Key/ChangeSet, CostResult.
- AiInvocationSuccess um usageMetadata erweitert; AiAttemptContext um vier
nullable Token-Felder.
- ProcessingAttempt um sechs Token-/Preis-Snapshot-Felder erweitert
(Convenience-Konstruktor und withoutAiFields-Factory unveraendert).
- ModelPriceRepository-Port mit Schreib-/Lese-Trennung.
- DefaultManageModelPricesUseCase mit ChangeSet-Konfliktvalidierung,
Provider-Whitelist und Clock-Stempel.
- CostCalculator (formatRow + calculateAttempt; formatTotal als Stub fuer AP-B).
KI-Adapter:
- AnthropicClaudeHttpAdapter und OpenAiHttpAdapter extrahieren Token-Daten
aus den Response-Bodies inklusive Validierung (negativ, > 10 Mio., nicht
numerisch -> NULL + WARN-Log).
BatchRunProcessingUseCase-Hook:
- DocumentProcessingCoordinator erhaelt optional ModelPriceRepository und ein
Headless-Flag. Beim Bau eines KI-Versuchs wird der Snapshot-Preis fuer
(Provider, Modell) geladen und mit den Token-Daten am ProcessingAttempt
persistiert. Lookup-Fehler verlieren keinen Attempt.
GUI:
- Neuer Tab "Modell-Preise" (TableView mit Editierfeldern, Add-Dialog,
Loesch-Bestaetigung, Konvertierung Nano-USD <-> $/1M Tokens).
- History-Tab um drei Spalten erweitert: Input-Tokens, Output-Tokens, Kosten.
- Summary-Banner um Token-, Kosten- und Cache-only-Zeile erweitert
(Default-Werte; AP-B liefert spaeter die echten Aggregate).
- Konfigurations-Tab warnt beim Speichern, wenn das aktive Modell keinen
Preis-Eintrag hat.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
marcus
08ec021b5f