fix(ui): improve knowledge reading and add isolated formatting examples

2026-09-13 16:52:53 +02:00
parent 2953f6b608
commit 3535fda958
14 changed files with 362 additions and 19 deletions
@@ -0,0 +1,77 @@
+# Lettura di Evidence e Memory
+
+Data: 13 settembre 2026. Richiesta: eliminare il muro di testo nelle regole,
+usare la larghezza disponibile, fornire Memory finte per la verifica grafica e
+sostituire i pulsanti Copia con l'icona a due fogli.
+
+## Intervento
+
+Rimossi il limite di 75ch dal dettaglio Evidence e quello di 72ch dai campi Memory.
+La variante di lettura Knowledge elimina anche il limite interno dei paragrafi
+Markdown, mantenendo il comportamento responsive del contenitore. Gli altri
+visualizzatori non cambiano impaginazione. Codice e identificatori lunghi possono
+andare a capo quando necessario, senza allargare la pagina.
+
+Per paragrafi di almeno 360 caratteri, la variante introduce separazioni visive
+dopo almeno 180 caratteri, cercando punti, punti e virgola, punti interrogativi
+o esclamativi nel testo ordinario. Non divide dentro codice inline, enfasi o link;
+elenchi, titoli, paragrafi brevi e blocchi SQL già strutturati rimangono intatti.
+La spaziatura tra paragrafi è 1,25em. Si tratta di un intervento sul rendering
+Markdown, non di una riscrittura o un salvataggio dei documenti. Nessuna conoscenza
+di dominio viene generata dal visualizzatore.
+
+Ambito, Provenienza e Regola occupano l'intera larghezza del dettaglio. Gli estratti
+di provenienza interpretano Markdown, senza mostrare letteralmente asterischi e
+backtick. Copia usa l'icona Lucide Copy con nome accessibile e tooltip; il percorso
+completo viene copiato senza trasformazioni e gli errori restano annunciati.
+
+Impeccable ha guidato la leggibilità, la separazione dei paragrafi e l'accessibilità;
+la larghezza piena segue la richiesta esplicita dell'utente anche oltre la misura
+di lettura ordinaria del design system.
+
+## Memory simulate
+
+In **Administration → Memory → Formatting examples**, oppure **Amministrazione →
+Memory → Esempi di formattazione**, sono disponibili quattro schede FAKE:
+
+- chiarimento di dominio con una regola lunga;
+- regola SQL con titoli, elenchi e identificatori;
+- domanda risolta con SQL dimostrativo;
+- errore spiegato con paragrafi distinti.
+
+La sezione si apre automaticamente se l'archivio reale è vuoto. Gli esempi sono
+fixture frontend in `frontend/src/shell/memoryFormattingExamples.ts`, separate
+dai risultati dell'archivio e dai suoi conteggi. Riutilizzano il lettore reale,
+ma non offrono Edit/Delete/Save, non hanno dipendenze o link a schede reali e non
+vengono inviati ad alcuna API Memory. Nessun inserimento PostgreSQL, indicizzazione
+Qdrant, consolidamento Evidence o invio al modello è avvenuto. I nomi demo e gli
+identificatori non sono riferimenti al DWH operativo.
+
+Si possono richiudere senza cancellazioni. Una futura rimozione degli esempi è
+una modifica del frontend, non una pulizia dei dati. New card dopo un esempio
+apre una scheda vuota, senza copiarne il contenuto simulato.
+
+## Verifiche e consegna locale
+
+- 762 test frontend in 91 file, tutti superati.
+- 18 scenari Playwright, inclusi reader a 390, 1280 e 2400 px, tema scuro,
+  assenza di overflow, larghezza dei paragrafi e separazione effettiva.
+- Test di conservazione di parole, codice e destinazioni dei link, struttura
+  Markdown e comportamento invariato dei visualizzatori ordinari.
+- Clipboard: contenuto copiato esatto, nome accessibile e fallimento gestito.
+- Fixture Memory: nessuna richiesta di scrittura o caricamento di una falsa
+  scheda dal server; nessuna azione di modifica disponibile.
+- Typecheck, controllo di 1686 traduzioni italiane/1707 riferimenti statici e build
+  Docker superati. Screenshot desktop, desktop largo e mobile scuro controllati.
+
+Il Mac serve la nuova variante CSS. Solo frontend è stato ricreato, container
+`fc4286b5406d`, immagine `cbe0fe0dce55`, healthy. Core `3c3c0739b9af`, catalogo
+`89755e439dc7`, Qdrant `52ebd5c47955` ed embedding `7f690e534eda` restano invariati
+e healthy. Non è stato eseguito un deploy Omics o PSD.
+
+Rollback locale, senza toccare altri servizi o volumi:
+
+```bash
+docker image tag thothii-frontend:before-knowledge-reading-20260913 thothii-frontend:local
+bash /private/tmp/thothii-memory-preview.sh up -d --no-deps --no-build --wait frontend
+```