Initial curated RAGcore source from c16667f0c9397e2bfc8dd0255b114fba23c8d05e

docs/01_ARCHITECTURE/DEPLOYMENT_TOPOLOGY.md

@@ -0,0 +1,31 @@
+# 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 |