# qdrant

Base vectorielle Qdrant sur storage-01 — mémoire sémantique du RAG (collection `funk-docs`).

## Ce que fait le rôle

- User système `qdrant`, données dans `/srv/data/qdrant` (NVMe)
- Télécharge le binaire (version pinnée), upgrade seulement si la version installée diffère
- Config `/opt/qdrant/config.yaml` + service systemd

## Variables principales

| Variable | Défaut |
|---|---|
| `qdrant_version` | `1.13.4` |
| `qdrant_http_port` / `qdrant_grpc_port` | 6333 / 6334 |
| `qdrant_host` | `0.0.0.0` (filtré par nftables — LAN cluster seulement) |
| `qdrant_data_dir` | `/srv/data/qdrant` |

## Vérifications

```bash
curl -s http://127.0.0.1:6333/collections
systemctl status qdrant
```

## Caveat — crash-loop silencieux

Si un segment de collection est corrompu, Qdrant panique au boot et reste en `activating (auto-restart)` — **invisible dans `systemctl --state=failed`**. Symptôme : port 6333 fermé, `rag-query` en connection refused. Réparation : supprimer la collection corrompue et ré-ingérer (voir `admin/incidents.md` 2026-06-05).