# Sprint 2 – Navigation & Design Shell

## Ziel und Scope

Sprint 2 konsolidiert ausschließlich die FinanceManager-Frontend-Shell. Es entstehen keine neuen Finanzberechnungen, Datenquellen, API-Verträge, Schreibfreigaben oder Backendänderungen. Transfer Pairing v2, Import/Review, Preview → Confirm → Audit und die Sprint-0-Write-Gates bleiben unverändert.

## Informationsarchitektur

`frontend/src/navigation/userNav.ts` ist die einzige typisierte Quelle für Navigation, Readiness, Icons, Sichtbarkeit und die vorhandenen Deep Links:

- **Heute** – `/`: bestehende Übersicht, offene Aufgaben und Hinweise.
- **Haushalt** – `/planning/budget`: Budget, Budgetstatus, Import, Buchungen prüfen, Review Backlog, Transfers, Transaktionen, Konten und Kategorien.
- **Vermögen** – `/portfolio`: Cash, Aktien & ETFs, Crypto und TrueWealth.
- **Research** – sichtbar als `In Vorbereitung`, ohne Route und ohne klickbaren Pseudo-Zielpfad. Es wird erst nach belastbarer Markt-/Advisor-Datenbasis freigeschaltet.

Bestehende Deep Links bleiben unverändert. Es wurden keine fachlichen Routen umbenannt oder neue APIs angelegt.

## Shell und Readiness

- Desktop: semantische Seitennavigation mit aktivem Bereich und Unterpunkten.
- iPad/Smartphone: vier Hauptbereiche plus `Mehr` in der Bottom Navigation; vollständige Navigation im zugänglichen Menü-Drawer.
- Aktive Navigation, sichtbare Tastatur-Fokuszustände, beschriftete `nav`-Elemente, ein modal fokussiertes Mobilmenü mit Escape/Focus-Rückgabe und mindestens 44-px-nahe Touch-Ziele sind Teil der Shell.
- Lange deutsche Seitentitel brechen um statt abgeschnitten zu werden.
- Der zentrale `AvailabilityState` bietet Varianten für `loading`, `empty`, `error`, `partial` und `unavailable`; Fehler verwenden `role="alert"`, andere dynamische Status `aria-live="polite"`.
- `CommandCenter` verwendet die neue Zustandsdarstellung bei vollständigem Fehler oder nach einem fehlgeschlagenen Refresh mit weiterhin sichtbaren, zuvor geladenen Daten.

## Responsive UAT

Synthetisch gegen den existierenden Budget-Review-Deep-Link geprüft:

- Desktop 1440×900: Desktopnavigation sichtbar, Haushalt aktiv, kein horizontaler Overflow.
- iPad quer 1024×768: Navigation und aktiver Bereich sichtbar, keine Überlagerung oder horizontale Seiten-Scrollbarkeit.
- Smartphone 390×844: Bottom Navigation sichtbar, Haushalt aktiv, Research deaktiviert, kein horizontaler Overflow.
- Der Deep-Link `/planning/budget/expenses/review` blieb direkt erreichbar; Budget- und Transfer-Review-Links sind in der Navigation weiterhin vorhanden.

## Rollback

Vor einer Veröffentlichung reicht ein Revert dieses Commit-Slices. Keine Migration und keine Runtime-Datenänderung sind enthalten.

## Nicht-Scope und nächster kleiner Konzept-PR

Nicht enthalten sind Reconciliation, Bewertungs-/FX-Snapshots, Performance, TWR/XIRR, Portfolio Policy, Research-Provider, Authentifizierung oder globale JARVIS-Oberflächen.

Der nächste kleine Konzept-PR **Reconciliation & Snapshot** sollte auf additive, read-only vorbereitete Verträge begrenzt bleiben: Kontoabgleichstatus, lokale Bewertungs-/FX-Snapshot-Metadaten und ein einheitlicher Data-Freshness-Contract. Keine neue Portfolio-Berechnung oder automatische Buchung ohne separat freigegebenes Modell und End-to-End-Gates.