Add CI workflow, full env docs, fix Up button navigation

- .gitea/workflows/build.yaml: Gitea Actions — push latest on main
- docker-compose.example.yml: image-based pull, all NAT20_ vars shown
- settings.py: add NAT20_PLAYER_RECAP_STYLE / CUSTOM_PROMPT overrides
- README.md: full env var reference table with accepted values + rationale
- files.py: fix parent_path to avoid up-button bug; add path traversal guard
- Files.tsx: remove copy/paste/autoPlay, scope to campaign

README.md

@@ -40,39 +40,62 @@ A reference compose file using named volumes only (no host paths) is at
 
 ## Data layout
 
-The app stores everything under `/data` (inside the container), which by default
-is a [bind mount](./docker-compose.yml) to a host path of your choice:
+The app stores everything under `/data` (inside the container):
 
 | Directory / File | Contents |
 |---|---|
-| `audio/` | Uploaded recordings and extracted audio |
-| `transcriptions/` | Per-session transcript JSON files |
-| `notes/` | Generated notes (GM log + player recap) |
-| `app.db` | SQLite database (sessions, speakers, settings, jobs) |
+| `campaigns/{id}/audio/` | Uploaded recordings and extracted audio, organised per campaign |
+| `campaigns/{id}/transcriptions/` | Per-session transcript JSON files |
+| `campaigns/{id}/notes/` | Generated notes (GM log + player recap) |
+| `app.db` | SQLite database (sessions, speakers, campaigns, settings, jobs) |
 
 ## Configuration
 
-### Prefilling the setup wizard
+### Environment variables (`NAT20_*`)
 
-Set `NAT20_*` environment variables under the `backend` service in
-`docker-compose.yml` — the wizard will pick them up as defaults:
+Set these under the `backend` service in `docker-compose.yml` to prefill
+the setup wizard and override defaults. All are optional — the wizard
+and Settings page can set them at runtime.
 
-```yaml
-environment:
-  NAT20_HF_TOKEN: "hf_..."
-  NAT20_WHISPER_MODEL: medium
-  NAT20_OLLAMA_HOST: http://localhost:11434
-  NAT20_WORLD_CONTEXT_PATH: /data/campaign-context.txt
-```
+#### Transcription
 
-See the `environment:` block in `docker-compose.yml` for the full list.
+| Variable | What it does | Values | Default | Notes |
+|---|---|---|---|---|
+| `NAT20_WHISPER_MODEL` | Whisper model size | `tiny` `base` `small` `medium` `large-v3` | `medium` | Larger = more accurate but uses more VRAM. `medium` fits most 6-8 GB GPUs; `large-v3` needs ~10 GB+ |
+| `NAT20_WHISPER_COMPUTE_TYPE` | Compute precision | `int8` `float16` `float32` | `int8` | `int8` = fastest / least VRAM. `float16` = more accurate, more VRAM. `float32` = full precision, slowest |
+| `NAT20_HF_TOKEN` | HuggingFace token for speaker diarization | `hf_...` | (none) | Required for speaker attribution. Must accept pyannote gated-model terms with the same account first |
+
+#### LLM backend
+
+| Variable | What it does | Values | Default | Notes |
+|---|---|---|---|---|
+| `NAT20_OLLAMA_HOST` | Ollama server URL | URL | `http://localhost:11434` | Set to your Ollama host |
+| `NAT20_OLLAMA_MODEL` | Ollama model name | any model on your server | `qwen2.5:7b` | |
+| `NAT20_API_BASE_URL` | OpenAI-compatible API base | URL | `https://api.openai.com/v1` | Uncomment and set to switch from Ollama |
+| `NAT20_API_KEY` | API key | string | (none) | |
+| `NAT20_API_MODEL` | API model name | string | `gpt-4o-mini` | |
+
+#### Summarization
+
+| Variable | What it does | Values | Default | Notes |
+|---|---|---|---|---|
+| `NAT20_CHUNK_WORD_TARGET` | Target words per summarisation chunk | number | `2500` | Long transcripts are split into chunks, each summarised separately, then combined. **Lower** = more LLM calls but finer granularity (good for models with small context windows). **Higher** = more context per chunk but may exceed the model's window. `2500` is safe for most models (8K–128K context) |
+| `NAT20_WORLD_CONTEXT` | Campaign context string | text | (none) | Injected into every summarisation prompt so the LLM recognises NPCs, places, and lore correctly |
+| `NAT20_WORLD_CONTEXT_PATH` | Path to campaign context file inside container | container path | (none) | Alternative to `NAT20_WORLD_CONTEXT` for large campaign bibles you update independently |
+| `NAT20_PLAYER_RECAP_STYLE` | Player recap format | `story` `diary` `bullets` `custom` | `story` | |
+| `NAT20_PLAYER_RECAP_CUSTOM_PROMPT` | Custom prompt (only when style is `custom`) | text | (none) | |
+
+#### Setup wizard
+
+| Variable | What it does | Values | Default | Notes |
+|---|---|---|---|---|
+| `NAT20_ONBOARDING_COMPLETED` | Skip the setup wizard | `true` or `false` | `false` | Set to `"true"` after you finish the wizard once |
 
 ### Campaign context
 
 You can paste context directly in the Settings page, or point to a file
-inside the container using the `world_context_path` setting (or the
-`NAT20_WORLD_CONTEXT_PATH` env var). The file path version is useful for
-large campaign bibles that you update independently.
+inside the container using `NAT20_WORLD_CONTEXT_PATH`. The file version is
+useful for large campaign bibles that you update independently.
 
 ## Notes on hardware