126 lines
7.0 KiB
Markdown
126 lines
7.0 KiB
Markdown
# Integrazione della revisione grafica con full/embedded
|
|
|
|
Data: 2026-09-13. Ambito autorizzato: integrazione locale e aggiornamento del Mac,
|
|
senza push, merge in `main` o deploy sul server PSD.
|
|
|
|
## Causa della regressione
|
|
|
|
La revisione full/embedded `d8a29bfb` e il ramo `codex/ui-visual-review` partivano
|
|
entrambi da `2d1b714e`. La prima build full è stata eseguita dal primo ramo senza
|
|
integrare i sette commit grafici già presenti nell'immagine installata sul Mac.
|
|
La corrispondenza è verificata anche sulle immagini: il backup
|
|
`thothii-frontend:before-full-shell-20260913` e
|
|
`thothii-frontend:visual-review-20260912` identificano entrambi `7dceaafcd9ee`.
|
|
|
|
Commit recuperati, in ordine:
|
|
|
|
| Commit | Modifica |
|
|
| --- | --- |
|
|
| `c8d276dd` | Manrope locale, scala tipografica condivisa, leggibilità delle pagine operative |
|
|
| `eed398e5` | Marchio ThothII a 48 px nel Core e 32 px nella sidebar |
|
|
| `8c819968` | Indicatori del catalogo dopo le rispettive etichette |
|
|
| `803e9e92` | Ricalcolo dell'altezza del campo domanda dopo la riapertura del Core |
|
|
| `e088abd6` | Allineamento degli stati alla griglia del riepilogo |
|
|
| `5af44081` | Margini e assi interni dei blocchi Database |
|
|
| `a59624a6` | Allineamento del pannello del contesto e rimozione delle spiegazioni ridondanti |
|
|
|
|
## Criteri di riconciliazione
|
|
|
|
- Conservati traduzioni, protezione delle bozze, autenticazione, gestione delle
|
|
sessioni e isolamento dell'adapter Omics introdotti dalla revisione full.
|
|
- Recuperati font locale, classi e geometria approvati nel ramo grafico.
|
|
Impeccable, registro product, ha guidato la verifica della coerenza; nessun
|
|
ridisegno delle pagine o nuovo accorciamento dei loro titoli.
|
|
- Il reset e i token CSS restano circoscritti al mount di ThothII e ai suoi popup:
|
|
la revisione grafica non reintroduce un reset del documento del portale.
|
|
- Conservati tema, traduzioni e stato di AG Grid; le colorazioni degli avvisi
|
|
rimangono leggibili nei due temi.
|
|
- Tradotte le nuove etichette e le spiegazioni introdotte dalla revisione grafica.
|
|
- Il mock di ResizeObserver dei test ora emette le misure degli elementi osservati,
|
|
come richiesto anche dal ridimensionamento del campo domanda recuperato.
|
|
- I test visuali configurano esplicitamente full oppure embedded. La simulazione
|
|
embedded fornisce le preferenze del portale e il suo reset del margine del body;
|
|
ThothII non deve applicare quel reset al documento esterno.
|
|
|
|
## Verifiche
|
|
|
|
| Controllo | Esito |
|
|
| --- | --- |
|
|
| Suite frontend completa | 755 test passati, zero fallimenti |
|
|
| Playwright visuale/interazione | 11 scenari passati, zero saltati o instabili |
|
|
| Larghezze della revisione grafica | 390, 649, 768, 1280 e 1600 px |
|
|
| Combinazione lingua/tema/full | EN/IT, chiaro/scuro, persistenza al reload e margini simmetrici a 390 e 1280 px |
|
|
| Caricamento font | Verificata una font face Manrope Variable effettivamente caricata |
|
|
| Embedded | Nessun header ThothII, contenimento sotto header e sidebar del portale simulato |
|
|
| Cataloghi | 1681 messaggi italiani, 1706 riferimenti statici; nessuna chiave mancante o interpolazione incoerente |
|
|
| Typecheck e build | Superati, inclusa la regressione sul CSS compilato prima della build |
|
|
| Documentazione | Build MkDocs strict superata |
|
|
|
|
Le verifiche Playwright usano dati sintetici e bloccano tutte le richieste API;
|
|
gli scenari non avviano modelli reali né modificano dati dell'installazione.
|
|
Gli screenshot sono in `frontend/test-results/visual-review/`, ignorati da Git.
|
|
Backend, harness e Omics non sono modificati da questa integrazione; le loro
|
|
verifiche precedenti restano nel rapporto full-shell. Non viene rivendicata una
|
|
nuova verifica end-to-end sul portale di produzione.
|
|
|
|
La verifica indipendente dell'integrazione di CSS, shell e reset non ha segnalato
|
|
rilievi aperti. Il controllo della pagina reale ha inoltre rilevato l'etichetta
|
|
predefinita «Administration» non tradotta: è stata corretta nel componente condiviso
|
|
e coperta dallo scenario EN/IT. Nessun nuovo testo JSX o attributo di accessibilità
|
|
non tradotto è stato introdotto dal merge, secondo il confronto statico con `d8a29bfb`.
|
|
|
|
## Aggiornamento e rollback locali
|
|
|
|
Contesto di build: `/Users/mp/projects/ThothII`; launcher dell'installazione:
|
|
`/private/tmp/thothii-memory-preview.sh`. Il launcher termina con l'override
|
|
`/private/tmp/thothii-context-a.compose.yaml`, che seleziona questo checkout.
|
|
Non applicare l'override della precedente revisione isolata: selezionerebbe di nuovo
|
|
il worktree senza l'integrazione full/embedded.
|
|
|
|
Comandi usati per costruire e sostituire il solo frontend:
|
|
|
|
```sh
|
|
bash /private/tmp/thothii-memory-preview.sh build frontend
|
|
bash /private/tmp/thothii-memory-preview.sh up -d --no-deps --no-build --wait frontend
|
|
```
|
|
|
|
Configurazione Mac conservata: modalità `full`, lingua predefinita `en`.
|
|
Aggiornamento completato alle 12:54 UTC: immagine frontend `605a6e6bba68`, container
|
|
`9489a5765f7b`, stato healthy. Core (`3c3c0739b9af`), catalogo (`89755e439dc7`),
|
|
Qdrant (`52ebd5c47955`) ed embedding (`7f690e534eda`) conservano gli stessi container,
|
|
immagini e tempi di avvio rilevati prima dell'aggiornamento; sono tutti healthy.
|
|
Il controllo dal browser usa l'accesso locale già presente, senza logout, modifica
|
|
del catalogo o avvio di una sessione del modello. Sul viewport reale da 771 px:
|
|
titolo Manrope Variable a 24 px, margini full sinistro/destro di 24 px, tre blocchi
|
|
Database con identica posizione x=45 e larghezza 681 px; nessun overflow della pagina.
|
|
Verificati italiano e tema scuro; ripristinati inglese e tema chiaro.
|
|
|
|
L'immagine prima del merge è conservata come
|
|
`thothii-frontend:before-visual-shell-merge-20260913` (`781650644192`). Per ripristinare
|
|
quella versione full precedente, senza toccare Core o i volumi:
|
|
|
|
```sh
|
|
bash /private/tmp/thothii-memory-preview.sh \
|
|
-f /Users/mp/projects/ThothII/deploy/compose.visual-shell-rollback.yaml \
|
|
up -d --no-deps --no-build --wait frontend
|
|
```
|
|
|
|
Quel rollback reintroduce volutamente l'aspetto precedente al recupero grafico.
|
|
Per tornare alla versione integrata usare il launcher senza l'override di rollback.
|
|
Le immagini della revisione grafica isolata rimangono disponibili, ma non includono
|
|
le nuove funzionalità full/embedded: non sono il rollback equivalente di questa consegna.
|
|
|
|
## Conservazione del lavoro locale e prevenzione
|
|
|
|
Le tre modifiche documentali locali preesistenti sono state protette nello stash
|
|
`436d59225869aa3d93ee04077c566d371bde4099`. I due rapporti erano identici alle versioni
|
|
del ramo grafico; tutte le aggiunte di PROJECT_STATE erano già contenute nel merge.
|
|
Non è stato necessario riapplicarle o sovrascrivere le versioni integrate. Lo stash
|
|
è conservato come ulteriore copia recuperabile.
|
|
|
|
Prima di un successivo rebuild, confrontare il ramo corrente con gli altri worktree
|
|
attivi e controllare il contesto di build effettivo del launcher. Un'immagine locale
|
|
può provenire da un ramo laterale più recente del checkout principale. Il passaggio
|
|
delle sole suite funzionali non certifica che la build contenga la revisione grafica
|
|
già accettata: verificare anche l'ascendenza Git e i test visuali recuperati qui.
|