From 3abe69badc1a044946fe03bb58c95ebe0904d2a9 Mon Sep 17 00:00:00 2001 From: User Date: Thu, 16 Jul 2026 20:40:51 +0200 Subject: [PATCH] docs: record session storage deployment gotchas --- brain/codebase/datamart-builder-deployment-gotchas.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/brain/codebase/datamart-builder-deployment-gotchas.md b/brain/codebase/datamart-builder-deployment-gotchas.md index 8875fc7d..8dbceec4 100644 --- a/brain/codebase/datamart-builder-deployment-gotchas.md +++ b/brain/codebase/datamart-builder-deployment-gotchas.md @@ -8,5 +8,7 @@ - Django può tenere in memoria il manifest Vite per worker: dopo un rebuild del frontend riavviare anche i worker Omics Portal, altrimenti richieste diverse possono produrre hash asset vecchi e nuovi. - Nel profilo server legacy, `vector_db` è una connessione pgvector RW condivisa; il factory può riusarla come writer solo con `profile=server`. La workstation senza writer REST deve restare read-only. - Non convertire in-place `local.yaml` da chiavi legacy a risorse moderne durante un incident fix: cambia il binding del workspace e può invalidare gli snapshot DWH attivi. +- `session_storage` è configurazione di persistenza delle sessioni, non degli artefatti DWH: escluderla dall'impronta in `config_dwh_binding`, altrimenti l'attivazione di profili utente rende incompatibile un indice DWH già valido. +- Con profili per utente, un profilo privato vuoto deve essere inizializzato una sola volta dai settings legacy completi; trattare `{}` come settings effettivi fa creare sessioni senza provider/modello e lo spawn Pi fallisce prima di partire. - Regola operativa concordata: dopo ogni modifica o enhancement, ricostruire e ricreare tutti i container ThothII coinvolti prima dell'handoff, quindi verificare che siano healthy affinché l'utente possa testare live. Il push Git non aggiorna le immagini Docker automaticamente.