# Sprint 11 — Kursdiagnose und Behebungssemantik

**Sicherheitsrahmen:** Der instrumentgenaue Diagnosebericht enthält produktive Finanzdaten und wird deshalb ausschließlich als owner-only Runtime-Artefakt außerhalb von Git aufbewahrt. Diese Repository-Fassung dokumentiert nur die technische Diagnose und die freigegebene Behebungssemantik.

## Technische Befunde

1. Der bisherige Sammelpfad war auf eine feste Teilmenge begrenzt und konnte deshalb keine vollständige Abdeckung garantieren.
2. Der Primärprovider kann historische Endpunkte tarifbedingt ablehnen. Tarif-, Authentifizierungs-, Netzwerk- und Rate-Limit-Fehler sind Providerfehler und kein Beweis für die Inaktivität eines Instruments.
3. Mehrere Provider liefern nur aktuelle Quotes. Sie dürfen nicht automatisch zur historischen As-of-Bewertung verwendet werden.
4. Der kontrollierte Lauf muss fehlende Positionen zuerst verarbeiten, frische cutoff-sichere Cachezeilen überspringen, sequenziell arbeiten und nach einer Unterbrechung wiederaufnehmen können.
5. Ein historischer Fallback ist nur zulässig, wenn seine Fähigkeit explizit bestätigt ist und Symbol, Handelsplatz, Kurswährung sowie tatsächliches Kursdatum zum kanonischen Mapping passen.
6. Instrumentgenaue Providerantworten, Portfoliobestände, ISIN-Matrizen und Kurswerte gehören nicht in Git oder öffentliche Logs.

## Verifizierte Behebungssemantik

- Primärprovider bleibt die bestätigte Instrumentzuordnung.
- Historischer Auto-Fallback ist ausschließlich für Provider mit `supports_historical_as_of=true` zulässig.
- Der Fallback wird nur akzeptiert, wenn Provider-Symbol, Handelsplatzalias und Kurswährung zur Mapping-Zeile passen.
- Das gespeicherte Kursdatum muss am oder vor dem Stichtag liegen und höchstens zwei Börsentage zurückliegen.
- Ein aktueller Quote darf niemals auf einen historischen Anforderungsstichtag umdatiert werden.
- Primär- und Fallbackprovider, Symbol, Börse, Kurswährung, tatsächliches Kursdatum und Abrufzeitpunkt werden gespeichert; kanonische Instrumentidentitäten bleiben unverändert.
- Unvollständige oder veraltete Bewertungen bleiben `null`; Teilwerte werden ausdrücklich als Teilwerte ausgewiesen.
- Read-only UI- und GET-Pfade lösen keine Providerabfragen aus.
- Inaktive, delistete, suspendierte, zusammengeführte oder per Bewertungsrichtlinie ausgeschlossene Instrumente werden weder automatisch aktualisiert noch in die kanonische Bewertung aufgenommen.

## Private Evidenz

Die vollständige Diagnosematrix wird im privaten Runtime-Evidenzverzeichnis mit Owner-only-Berechtigungen geführt und nicht versioniert. Sie enthält die instrumentgenauen Ursachen- und Providerprüfungen, die für die technische Abnahme erforderlich sind.