# Deployment Topology

## Development

Docker Compose levert app, worker, PostgreSQL en Qdrant. Ollama is een optioneel profiel. Alleen app publiceert een hostpoort.

## Unraid productie

```text
Nginx Proxy Manager / Authentik
             |
       ragcore-app:8080
             |
     internal Docker network
    /        |          worker   PostgreSQL    Qdrant     Ollama
```

- PostgreSQL, Qdrant en Ollama publiceren geen internet- of LAN-poort via deze stack.
- Actieve PostgreSQL/Qdrant-volumes gebruiken directe poolpaden zoals `/mnt/cache/appdata/ragcore/...` of `/mnt/<pool>/...`, niet `/mnt/pool/...`.
- Back-ups en snapshots mogen naar `/mnt/pool/backups/ragcore` worden gekopieerd nadat ze consistent zijn geëxporteerd.
- Containers draaien non-root, read-only waar mogelijk, met `no-new-privileges`.

## Failure modes

| Failure | Gedrag |
|---|---|
| Ollama down | `/search` en `/context` blijven beschikbaar; `/answers` geeft provider unavailable |
| Qdrant down | API blijft live maar retrieval-readiness faalt |
| Worker down | Bestaande actieve kennis blijft zoekbaar; nieuwe jobs wachten |
| PostgreSQL down | readiness faalt; geen request dat autorisatie vereist wordt uitgevoerd |
| Blobstore tijdelijk down | search op reeds geïndexeerde tekst kan doorgaan; documentopen/download faalt expliciet |