Nick SzaunigandClaude Opus 5.5
ce922c8569
Task 20: /inspections/new?voice=<id> zeigt die Sprachnotiz über dem Formular (Abgeschriebenes, Unklares, „Alle übernehmen“ mit Rückfrage) und Vorschläge unter den Feldern mit wörtlichem Zitat; nichts wird ohne Tipp übernommen, die Volkskarte wird nie angehakt. Bei ausgeschalteter Auswertung ist der Text offen zum Abtippen. Speichern schickt voiceCaptureId; bei 409 VOICE_CAPTURE_GONE genau ein neuer Versuch ohne Notiz mit demselben Idempotency-Key (online und aus der Warteschlange); VOICE_CAPTURE_COLONY_MISMATCH nie automatisch, sondern „Ohne Sprachnotiz speichern/senden“. Skalen aus lib/inspections/scales.ts mit Paritätstest zum Backend. Task 22: /settings/voice mit Modell und Fristen (bei ausgeschalteter Auswertung ausdrücklich: nichts geht an einen KI-Dienst), „Alle meine Sprachnotizen löschen“ auf Server und Gerät mit Anzahl; Systemkarte „Sprachnotizen“ (nur system:manage) mit Zählern und Kosten der letzten 7 Tage (Ruling 15); Service Worker cacht /api/v1/voice-captures nie, /voice und /voice/new offline erreichbar. Gates: Frontend lint, typecheck, 3106 Tests, build. Refs #27 Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
ApiCore-Frontend
Next.js-Oberfläche von ApiCore (App Router, TypeScript, Tailwind, shadcn/ui, TanStack Query). Die App spricht nur über die API des Backends; sie hat keinen eigenen Datenbankzugriff. Überblick über das ganze Projekt: ../README.md, Seitenstruktur: ../ARCHITECTURE.md Abschnitt 2.
Einrichten
npm install
cp .env.example .env.local # API_URL, z. B. http://localhost:3001/api/v1
npm run dev # http://localhost:3000
API_URL ist eine Laufzeit-Variable: Im Cluster kommt sie aus der ConfigMap apicore-frontend-config, ein neuer Wert braucht keinen neuen Build.
Diese Next.js-Version (16) weicht von älteren ab; vor Änderungen die mitgelieferte Doku unter node_modules/next/dist/docs/ lesen (siehe AGENTS.md).
Prüfen
npm run lint
npm run typecheck # next typegen && tsc --noEmit
npm test # Vitest + React Testing Library
npm run build
Der Image-Build (Dockerfile) führt Lint, Typecheck und Tests aus und bricht bei Fehlern ab.
Offline
- Offline-Warteschlange in IndexedDB (
src/lib/offline/), Band „Offline – X Einträge warten“, Sync bei Wiederverbindung mit Idempotenz-Schlüssel. - Service Worker (
public/sw.js,public/sw-routes.js) mit App-Hülle und Offline-Seiten untersrc/app/(app)/offline/für den Kaltstart ohne Netz. - „Stand laden“ holt die Daten eines Stands auf das Gerät; Abmelden löscht Pakete und Caches. Tokens werden nie gespeichert.