# HTTP-API

Alle Endpunkte werden von `app.py` bereitgestellt. HTML-Seiten geben `text/html` zurück; Daten-Endpunkte geben JSON zurück.

## PWA / System

| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | `/` | Upload-Seite |
| GET | `/manifest.webmanifest` | PWA-Manifest |
| GET | `/icon.svg` | App-Icon |
| GET | `/sw.js` | Service Worker |
| GET | `/healthz` | Statuscheck (JSON): API_BASE, OLLAMA_BASE_URL, Modell, DB-Pfad |

## Einstellungen

| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | `/settings` | Einstellungsseite |
| POST | `/settings` | Einstellungen speichern |
| GET | `/settings/models` | Verfügbare Ollama-Modelle laden (JSON) |

### `GET /settings/models` Response
```json
{ "ok": true, "models": ["llama3.2:3b", "qwen3.5:9b", ...] }
{ "ok": false, "error": "...", "models": [] }
```

## Projekte

| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | `/projects` | Projekt anlegen (Form: `name`) |
| POST | `/projects/update` | Projekt umbenennen (Form: `id`, `name`) |
| POST | `/projects/{id}/delete` | Projekt löschen (Dokumente → Default) |
| POST | `/projects/create-api` | Projekt anlegen, gibt JSON zurück (für JS-Upload-Flow) |

## Upload

| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | `/upload` | Audio-/Videodatei hochladen (Form: `project_id`, `file`); legt Upload-Job an |

## Library / Dokumente

| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | `/library` | Dokumentenliste (Query: `project_id`, `q_title`, `q_content`) |
| GET | `/document/{id}` | Dokument anzeigen |
| GET | `/document/{id}/download.md` | Dokument als Markdown herunterladen |
| POST | `/document/{id}/edit` | Inhalt bearbeiten (Form: `content_md`) |
| POST | `/document/{id}/rename` | Umbenennen (Form: `title`) |
| POST | `/document/{id}/move` | Projekt wechseln (Form: `project_id`) |
| POST | `/document/{id}/delete` | Dokument löschen |
| POST | `/documents/bulk-move` | Mehrere Dokumente verschieben (Form: `ids[]`, `project_id`) |
| POST | `/documents/bulk-delete` | Mehrere Dokumente löschen (Form: `ids[]`) |

## Prompts & Projekte

| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | `/prompts` | Prompts- und Projektverwaltung |
| GET | `/prompts/{id}/preview` | Prompt-Vorschau (JSON: `{html}`) |
| POST | `/prompts/add` | Prompt anlegen (Form: `name`, `prompt`) |
| POST | `/prompts/update` | Prompt speichern inkl. KI-Einstellungen (siehe unten) |
| POST | `/prompts/{id}/delete` | Prompt löschen |

### `POST /prompts/update` Felder
| Feld | Typ | Beschreibung |
|---|---|---|
| `id` | int | Prompt-ID |
| `name` | str | Name |
| `prompt` | str | Prompttext |
| `llm_use_default` | int | 1 = globale KI-Einstellungen, 0 = promptspezifisch |
| `llm_model` | str? | Modellname |
| `llm_think` | str? | `"true"` / `"false"` |
| `llm_num_ctx` | str? | Kontextgröße oder `"auto"` |
| `llm_num_predict` | str? | Max. Tokens |
| `llm_repeat_penalty` | str? | |
| `llm_repeat_last_n` | str? | |

## Hintergrundjobs

| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | `/jobs` | Job-Übersicht (HTML) |
| GET | `/jobs/data` | Job-Liste als JSON (Query: `limit=200`) |
| GET | `/jobs/{id}/debug-data` | Detail-Daten eines Jobs (JSON) |
| POST | `/jobs/{id}/cancel` | Job abbrechen (JSON-Response) |
| POST | `/jobs/{id}/cancel-form` | Job abbrechen (Redirect) |
| POST | `/jobs/{id}/delete` | Job löschen (JSON-Response) |
| POST | `/jobs/{id}/delete-form` | Job löschen (Redirect) |

## Prompt ausführen

| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | `/run` | Formular: Prompt auf Dokument(e) anwenden |
| POST | `/run` | Analyse-Job(s) starten |
| POST | `/run/project` | Analyse-Job für alle Transkripte eines Projekts starten |