# Browser-AZA MVP Spezifikation

Stand: 2026-03-08  
Status: verbindliche Arbeitsgrundlage für Step 22

---

## Ziel

Browser-AZA ist die kleinste verkaufbare Web-Version von AZA.

Der MVP soll genau einen klaren Hauptnutzen liefern:

1. Arzt öffnet die Browser-Oberfläche  
2. wählt Fachrichtung  
3. lädt Audio hoch  
4. Browser sendet an `/v1/transcribe`  
5. Transkript wird angezeigt  
6. Transkript kann kopiert werden

---

## Nicht verhandelbare Projektregeln

- `/license/status` Schema bleibt exakt unverändert
- Auth bleibt `X-API-Token`
- keine Bearer-Umstellung
- keine Tokens oder Secrets loggen
- keine unnötigen Refactors
- keine Breaking Changes ohne eigenen Step

---

## MVP-In-Scope

- eine Browser-Hauptseite
- klarer Upload-Bereich
- Fachrichtungsauswahl vor Upload
- Upload an `/v1/transcribe`
- Ergebnisbereich für Transkript
- Copy-Button
- sichtbarer Support-Link
- sichtbarer Privacy-/Terms-Link
- HTTPS-Erreichbarkeit

---

## Nicht Teil des MVP

- komplexes Benutzer-/Rollensystem
- Admin-Dashboard
- Billing-Logik im Browser
- Desktop-Auto-Update
- ausgefeilte Mehrseiten-Navigation
- Nice-to-have UI-Politur
- Zusatzmodule außerhalb Transkriptions-Kernflow

---

## Zielbild der Oberfläche

Die MVP-Oberfläche besteht aus genau einer klaren Hauptansicht:

### Bereich 1 – Kopf
- Produktname / AZA
- kurze Einzeile: medizinische Transkription
- Support-Link
- Privacy-/Terms-Link

### Bereich 2 – Eingabe
- Fachrichtungsauswahl
- Audio-Datei auswählen
- klarer Button zum Starten des Uploads

### Bereich 3 – Ergebnis
- Ladezustand
- Fehlermeldung falls Upload/Antwort fehlschlägt
- Transkript-Textfeld oder Ergebnisbox
- Copy-Button

---

## Minimaler Benutzerfluss

### Happy Path

1. User öffnet Browser-AZA
2. Seite lädt fehlerfrei
3. User wählt Fachrichtung
4. User wählt Audio-Datei
5. User startet Upload
6. Request geht an `/v1/transcribe`
7. Backend antwortet erfolgreich
8. Transkript erscheint sichtbar im Browser
9. User kopiert das Transkript

### Fehlerfälle

- keine Datei gewählt
- leere/ungültige Datei
- Backend antwortet mit Fehler
- Antwort enthält kein nutzbares Transkript

Für alle Fehlerfälle gilt:

- verständliche Meldung anzeigen
- keine internen Secrets/Tokens anzeigen
- keine technischen Rohfehler direkt an User durchreichen, wenn unnötig

---

## API-/Backend-Contract für MVP

Der Browser-MVP darf den bestehenden Backend-Contract nicht brechen.

### Fix

- Endpoint: `/v1/transcribe`
- Auth-Header: `X-API-Token`

### Wichtig

- keine Bearer-Auth einführen
- `/license/status` unberührt lassen
- bestehende Token-Logik nicht aufbrechen

---

## Dateiformat-Hinweis

Für den MVP soll ein klar definiertes Upload-Format verwendet werden.

Aktueller Projektkontext:

- Browser-MVP soll mit vereinbartem Upload-Format arbeiten
- falls Formatfrage noch offen ist, als separater klarer Substep behandeln
- kein stiller Nebenbei-Umbau

---

## Definition of Done für Step 22 MVP

Step 22 MVP gilt als erfüllt, wenn:

1. Browser-Seite erreichbar ist
2. Seite über HTTPS läuft
3. Fachrichtung auswählbar ist
4. Audio hochgeladen werden kann
5. Upload erfolgreich `/v1/transcribe` anspricht
6. Transkript sichtbar angezeigt wird
7. Copy-Button funktioniert
8. Support-/Privacy-/Terms-Link sichtbar sind
9. keine Tokens/Secrets im UI oder Logs erscheinen

---

## Umsetzungsreihenfolge

### Block A
- Browser-Hauptseite als MVP-Web-Shell
- einfache Seitenstruktur festlegen

### Block B
- Fachrichtungsauswahl einbauen
- Upload-Feld und Start-Button einbauen

### Block C
- Request-Flow an `/v1/transcribe`
- Lade- und Fehlerzustände

### Block D
- Ergebnisbereich
- Copy-Button

### Block E
- Support/Privacy/Terms sichtbar
- HTTPS-Check / Deployment-Vorbereitung

---

## Akzeptanzchecks

- Browser öffnet Seite erfolgreich
- Fachrichtung auswählbar
- Audio-Datei auswählbar
- Upload funktioniert
- Transkript erscheint
- Copy funktioniert
- Fehlermeldungen sind verständlich
- Support/Privacy/Terms sind sichtbar
- keine Secrets/Tokens sichtbar

---

## Ergebnis dieses Dokuments

Dieses Dokument ist die verbindliche Baugrundlage für:

- den ersten echten Browser-AZA UI-Patch
- den Upload-/Result-Flow
- die spätere Step-22-Abnahme