Backup automatico script del 2026-09-27 07:00

2026-09-27 07:00:02 +02:00
1 parent f347badf3b
commit 09dcbbdadb
@@ -35,6 +35,7 @@ Tutti i dati restano in LAN/NAS; l’accesso esterno avviene solo via HTTPS + OA
 │    ├── /oauth/*      OAuth 2.1 PKCE                         │
 │    └── /dashboard    UI famiglia                            │
 │  Pi-1 :8700  loogle-mcp-indexer (worker Paperless→vector)   │
+│  Pi-1        loogle-mcp-ollama (embedding query + indexer)  │
 └───────┬─────────────────────────────┬───────────────────────┘
        │                             │
        ▼                             ▼
@@ -63,6 +64,8 @@ Tutti i dati restano in LAN/NAS; l’accesso esterno avviene solo via HTTPS + OA
 |------------|------|-------|----------------------|
 | MCP Gateway | Pi-1 | 8700 | `loogle-mcp` |
 | Indexer | Pi-1 | — | `loogle-mcp-indexer` |
+| Embedding | Pi-1 | 11434 (solo rete compose) | `loogle-mcp-ollama`, volume `loogle-mcp_ollama-models` |
+| Ollama di riserva | DS920 | 11434 | solo query se l'Ollama di Pi-1 non risponde; embedding per extrema |
 | Qdrant (primario) | DS920 | 6333 | opzionale, compose extrema |
 | Vector fallback | Pi-1 | — | `/data/vector_fallback.db` |
 | Context NFS | NAS | — | `/mnt/ha-apps/mcp/context/` |
@@ -133,16 +136,24 @@ File: `/home/daniely/docker/loogle-mcp/.env`
 | `PAPERLESS_API_TOKEN` | Token API admin (fallback) | vedi [PAPERLESS-TOKEN.md](PAPERLESS-TOKEN.md) |
 | `PAPERLESS_API_TOKEN_{USER}` | Token API per utente | `DANIELE`, `LUCIA`, `DAVIDE`, `LUCA` |
 | `QDRANT_URL` | Vector DB remoto | `http://192.168.128.100:6333` |
-| `OLLAMA_URL` | Embedding locale | `http://192.168.128.100:11434` |
+| `OLLAMA_URL` | Ollama DS920: riserva per le query, embedding in extrema | `http://192.168.128.100:11434` |
 | `OLLAMA_EMBED_MODEL` | Modello embedding | `nomic-embed-text` |
 | `OPENAI_API_KEY` | Fallback embedding cloud | *(opzionale)* |
 | `INDEXER_INTERVAL_MINUTES` | Intervallo sync Paperless | `30` |
-| `THERMAL_TEMP_HARD_C` | Pausa embedding se CPU DS920 ≥ °C | `70` |
-| `THERMAL_TEMP_SOFT_C` | Rallenta embedding sopra °C | `58` |
-| `THERMAL_CPU_TARGET_PCT` | Cap load1 (nproc × %) | `40` |
-| `OLLAMA_NUM_THREAD` | Thread CPU per richiesta embed | `1` |
-| `OLLAMA_EMBED_DELAY_S` | Pausa tra embed (duty-cycle lento) | `10` |
-| `DS920_THERMAL_URL` | Probe temp/load DS920 | `http://192.168.128.100:9191/thermal` |
+| `MCP_TOOL_TIMEOUT_S` | Tempo massimo di una chiamata MCP | `45` |
+| `MCP_THREAD_LIMIT` | Thread per i tool (eseguiti in parallelo) | `40` |
+| `QDRANT_RETRY_S` | Riprova Qdrant ogni N s mentre usa il fallback SQLite | `60` |
+| `OLLAMA_QUERY_TIMEOUT_S` | Timeout embedding query sull'Ollama DS920 | `20` |
+
+Impostate in `docker-compose.yml` (sovrascrivono `.env`) per usare l'Ollama di Pi-1:
+
+| Variabile | Valore | Note |
+|-----------|--------|------|
+| `OLLAMA_QUERY_URL` / `OLLAMA_INDEX_URL` | `http://ollama:11434` | query (~0,1 s) e indicizzazione (~0,9 s/chunk) |
+| `OLLAMA_QUERY_NUM_THREAD` | `2` | uguale a `cpus: 2` del container; stesse options per query e indexer, altrimenti Ollama ricarica il modello |
+| `THERMAL_SOURCE` | `local` | thermal gate su temperatura e carico di Pi-1 (`ds920` = sonda `DS920_THERMAL_URL`) |
+| `THERMAL_TEMP_SOFT_C` / `_HARD_C` | `70` / `78` | soglie Pi 5 |
+| `OLLAMA_EMBED_DELAY_S` | `0.5` | pausa tra un chunk e l'altro |

 ---

@@ -155,7 +166,12 @@ File: `/home/daniely/docker/loogle-mcp/.env`
 | Davide | `davide` | user | `davide` |
 | Luca | `luca` | user | `luca` |

- Ogni utente vede **solo** i propri progetti in `/mnt/ha-apps/mcp/context/{username}/`
+- Ogni utente vede i propri progetti in `/mnt/ha-apps/mcp/context/{username}/` più i
+  **contesti condivisi** con la famiglia in `/mnt/ha-apps/mcp/context/_shared/`
+- Contesti condivisi: tutti li leggono e li aggiornano; archiviazione e ritorno a personale
+  solo per il proprietario (`owner`) o l'admin. Ogni salvataggio registra `updated_by` e una
+  sessione `AAAAMMGG-HHMMSS-{utente}.md`; `revision` aumenta a ogni salvataggio
+  (`save_context if_revision` evita di sovrascrivere modifiche concorrenti)
 - I token OAuth JWT contengono `sub` = username; ogni tool filtra per utente
 - L’admin può `reindex_document`, vedere audit completo, revocare refresh token

@@ -169,8 +185,9 @@ File: `/home/daniely/docker/loogle-mcp/.env`
 |------|--------------|----------|
 | `ping` | — | Test connettività |
 | `whoami` | — | Utente e scope attivi |
-| `list_projects` | context:read | Elenco progetti |
-| `create_project` | context:write | Nuovo progetto |
+| `list_projects` | context:read | Elenco progetti personali + condivisi (`shared`) |
+| `create_project` | context:write | Nuovo progetto (`shared=true`: condiviso con la famiglia) |
+| `share_project` | context:write | Condivide un proprio progetto / lo riporta personale |
 | `get_project_context` | context:read | Legge memoria progetto |
 | `save_context` | context:write | Salva/appende memoria |
 | `archive_project` | context:write | Archivia progetto |
@@ -204,13 +221,19 @@ Vedi anche tool Gitea in `docs/GITEA-TOKEN.md` e app homelab in `docs/APPS-INTEG
 ## Storage contesto (per progetto)

 ```
-/mnt/ha-apps/mcp/context/{username}/projects/{project-id}/
-  meta.json       # titolo, tag, date, stato, gitea_repo (opz.)
+/mnt/ha-apps/mcp/context/{username}/projects/{project-id}/   # personali
+/mnt/ha-apps/mcp/context/_shared/projects/{project-id}/      # condivisi con la famiglia
+  meta.json       # titolo, tag, date, stato, revision, gitea_repo (opz.)
+                  # condivisi: shared, shared_with=family, owner, updated_by
  context.md      # memoria persistente
-  sessions/       # snapshot conversazioni
+  sessions/       # snapshot conversazioni (condivisi: suffisso -{utente})
  artifacts/      # file generati dagli agenti
 ```

+Gli ID dei condivisi sono univoci anche rispetto ai progetti personali di tutti gli utenti.
+Nel vector store ogni progetto è indicizzato con il `context.md` **completo** (sostituito a
+ogni salvataggio): `ctx_{utente}` per i personali, `ctx_shared_family` per i condivisi.
+
 ---

 ## Vector store / RAG
@@ -227,8 +250,10 @@ Vedi anche tool Gitea in `docs/GITEA-TOKEN.md` e app homelab in `docs/APPS-INTEG
 **Nota Pi 5:** Qdrant locale su ARM (page size 16K) non è supportato. Default: Qdrant su DS920 o fallback SQLite in `/data/vector_fallback.db`.

 **Pipeline indexer:** ogni 30 min:
-1. Paperless → chunk → embedding (Ollama DS920) → upsert `kb_*`
-2. Gitea (repo configurati in `GITEA_INDEX_REPOS_*`) → file `.md`/`.py`/`.sh` → chunk → upsert `gitea_*`
+1. Paperless → chunk → embedding (Ollama Pi-1) → upsert `kb_*`
+2. Gitea (repo configurati in `GITEA_INDEX_REPOS_*`) → file `.md`/`.py`/`.sh` → segreti mascherati
+   (`auth_pass`, `password=`, `token:`, chiavi private) → chunk → upsert `gitea_*`. I file
+   `.env*` (tranne `.env.example`), chiavi e certificati non vengono mai indicizzati.
 3. Irrigazione + Turni → snapshot/storico → upsert `apps_shared_family` (vedi `docs/APPS-INTEGRATION.md`)

 ---
@@ -282,7 +307,7 @@ sudo /home/daniely/rete/scripts/setup-mcp-dns-npm.sh
 ## Da completare (post-install)

 1. **`PAPERLESS_API_TOKEN_*`** in `.env` — vedi [PAPERLESS-TOKEN.md](PAPERLESS-TOKEN.md)
-2. **Ollama su DS920** con `nomic-embed-text` per embedding locali
+2. **Ollama su DS920** con `nomic-embed-text`: riserva per le query ed embedding in extrema
 3. **Qdrant su DS920** (opzionale): `rete/compose/extrema-ds920/loogle-mcp-compose.yml`
 4. **Cambio password** per tutti gli utenti dal dashboard
 5. **`MCP_JWT_SECRET`** — impostare valore robusto in produzione