docs: verify structured semantic contracts

2026-08-08 21:14:17 +02:00
parent b84d4db946
commit bed43c747e
6 changed files with 219 additions and 46 deletions
@@ -11,6 +11,15 @@ ThothII usa una topologia Compose unica:
 Qdrant e Ollama embedding sono servizi interni obbligatori del progetto Compose. Restano esterni solo DWH e LLM. Il modello fissato è `qwen3-embedding:0.6b` con 1024 dimensioni e distanza
 coseno; `embedding-model-init` lo prepara prima dell'avvio di `core`.

+## Contratto sintetico di ownership
+
+| Componente | Ownership | Contratto operativo |
+| --- | --- | --- |
+| DWH | Esterno | Endpoint esterno configurato dall'installazione. |
+| LLM | Esterno | Endpoint o policy esterna all'infrastruttura semantica interna. |
+| Qdrant | Interno | Servizio Compose interno obbligatorio con volume persistente `qdrant-data`. |
+| Ollama embedding | Interno | Servizio Compose interno obbligatorio per `qwen3-embedding:0.6b`. |
+
 ## Comando standard locale

 ```sh