RAGcore-Public/docs/01_ARCHITECTURE/DEPLOYMENT_TOPOLOGY.md

Deployment Topology

Development

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

Unraid productie

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