docs: add user-owned session storage plan

2026-07-16 17:01:39 +02:00
parent 671bd20329
commit 8296937bc0
2 changed files with 155 additions and 0 deletions
@@ -0,0 +1,25 @@
+# User-owned session storage design
+
+## Decisioni vincolanti
+
+- In server mode ThothII usa PostgreSQL diretto, nello schema Supabase privato
+  `thoth_sessions`; il browser non accede mai al database.
+- In local mode ogni utente usa `~/.thothii` (override esplicito `THT_HOME`),
+  senza fallback o sincronizzazione con Supabase.
+- Una sessione appartiene al principal `(issuer, subject)`. Nel portale il
+  subject è il PK Django; email e username non sono identificatori.
+- Il proxy valida la sessione del portale e inietta identità normalizzata; il
+  backend richiede `AUTH_MODE=upstream` in produzione e non riceve token raw.
+- Gli utenti nel gruppo Authentik `authentik Admins` possono gestire ogni
+  sessione. Un accesso non autorizzato restituisce 404.
+- Lo schema contiene principals, principal_preferences, sessions,
+  session_artifacts, review_decisions e audit_log. Artefatti correnti e
+  decision ledger append-only; niente cronologia di artefatti né contenuto
+  nell'audit.
+- La sicurezza server combina RLS forzata, un runtime role senza BYPASSRLS,
+  contesto attore transaction-local e filtri applicativi espliciti.
+- Non vengono creati embeddings o vector columns per le sessioni. La memoria
+  solved_question esistente resta un flusso separato best-effort.
+- Sessioni e preferenze server sono persistite solo nel DB; guasti DB sono
+  fail-closed (503). I file temporanei di export sono effimeri.
+- Chat e SSE restano memoria runtime, non artefatti persistiti.