Files
Studio_Grasso/DECISIONS.md
T
Claude ac69a4351f fix: revisione legale e dei fatti prima del rilascio
- privacy: sezione sulle mappe di Google (consenso, contitolarità C-40/17,
  Data Privacy Framework), PEC personale della Dott.ssa Giulia Grasso,
  trasferimenti condizionati a fornitori.soloSee, art. 13, frasi sul
  consenso e sul modulo solo quando servono, grammatica dei destinatari
- mappe: avviso sulla scelta valida per tutto il sito e pulsante
  «Non caricare più le mappe» con test di revoca
- modulo: checkbox di presa visione, informativa breve dai dati dello
  Studio, nota diversa per php/endpoint, fornitori.modulo obbligatorio
  in modalità endpoint, messaggi da testi.ts
- contact.php: HMAC dell'IP con segreto casuale, cartella privata
  0700/0600 fuori dalla webroot, cancellazione dopo un'ora
- note legali e accessibilità: D.Lgs. 139/2005 e Codice deontologico,
  clausola di responsabilità, usi di JavaScript completi
- testi senza promesse di tempi; TODO B2/B3/B4/B5/C12, DECISIONS D-036–D-039

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
2026-10-15 23:35:06 +00:00

344 lines
33 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Registro delle decisioni
Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · contesto · scelta · alternative scartate · motivazione.
---
## D-001 — Repository esistente su Forgejo e branch di lavoro
- **Data:** 2026-10-15
- **Contesto:** il brief (§14.0) prevede `git init`, ma il repository `BalboSoft/Studio_Grasso` esiste già su Forgejo con un commit iniziale (README di due righe e `.gitignore`).
- **Scelta:** si lavora sul clone del repository esistente. Lo sviluppo avviene sul branch `feat/sito-v1` (un commit per fase, Conventional Commits in italiano); a fine fase 8 il branch viene unito in `main` con un merge commit (`--no-ff`), così `main` locale è pronto per il push.
- **Alternative scartate:** `git init` di un nuovo repository (perderebbe la storia remota e richiederebbe un push forzato); commit diretti su `main` (meno leggibile la storia per fasi).
- **Motivazione:** conserva la storia remota, nessun push forzato necessario, `main` resta pulito fino al merge finale.
## D-002 — Sostituzione del `.gitignore` iniziale
- **Data:** 2026-10-15
- **Contesto:** il `.gitignore` del commit iniziale è il modello «VisualStudio» (C#/.NET), non pertinente a un progetto Node/Astro.
- **Scelta:** sostituito con un `.gitignore` specifico (`node_modules`, `dist`, `release`, `.astro`, `test-results`, `playwright-report`, `.lighthouseci`, file di sistema).
- **Alternative scartate:** aggiungere le voci in coda al modello esistente (centinaia di regole inutili, alcune potenzialmente fuorvianti).
- **Motivazione:** semplicità e chiarezza (§0.3, punto 4).
## D-003 — Versione di Node.js
- **Data:** 2026-10-15
- **Contesto:** il brief chiede «Node.js LTS corrente (≥ 22)». A ottobre 2026 la LTS attiva è Node 24 (Krypton); Node 22 è in manutenzione. `eslint-plugin-astro` 3.x richiede Node `^22.22.3 || ^24.16.0 || >=26.3.0`, Astro 7 richiede `>=22.22.0`.
- **Scelta:** `.nvmrc` = `24`; `engines.node` = `>=22.22.3`. Sviluppo e test eseguiti con Node 24.22.0.
- **Alternative scartate:** Node 22 come riferimento (LTS in manutenzione); `engines` `>=24` (escluderebbe inutilmente Node 22 aggiornato).
- **Motivazione:** LTS attiva per lo sviluppo, compatibilità dichiarata con il minimo realmente supportato dalle dipendenze.
## D-004 — Astro 7.4.0
- **Data:** 2026-10-15
- **Contesto:** il brief chiede l'ultima versione stabile di Astro, verificata con `npm view astro version`.
- **Scelta:** `astro@7.4.0` (risultato di `npm view astro version` il 2026-10-15), con `@astrojs/sitemap@3.7.4`.
- **Alternative scartate:** nessuna (requisito esplicito).
- **Motivazione:** requisito del brief §3.1.
## D-005 — TypeScript 6.0.3 invece di 7.0.2
- **Data:** 2026-10-15
- **Contesto:** l'ultima TypeScript è la 7.0.2, ma `@astrojs/check@0.9.10` dichiara `typescript ^5 || ^6` e `typescript-eslint@8.71.2` richiede `typescript <6.1.0`.
- **Scelta:** `typescript@6.0.3` (ultima 6.x), modalità `strict` tramite `astro/tsconfigs/strict`.
- **Alternative scartate:** TypeScript 7 (fuori dai peer delle dipendenze, rischio di `astro check` non funzionante).
- **Motivazione:** compatibilità garantita dalle dipendenze ufficiali.
## D-006 — Playwright 1.56.1 (versione bloccata)
- **Data:** 2026-10-15
- **Contesto:** il brief usa come riferimento l'immagine CI `mcr.microsoft.com/playwright:v1.56.0-noble` e chiede che coincida con la versione di `@playwright/test`. L'ambiente di sviluppo dispone di Chromium revision 1194, quella usata da Playwright 1.56.x; le versioni successive (1.57+) richiedono un Chromium diverso.
- **Scelta:** `@playwright/test@1.56.1` e `playwright@1.56.1` (ultima patch della 1.56); immagine CI `mcr.microsoft.com/playwright:v1.56.1-noble`.
- **Alternative scartate:** Playwright 1.64.1 (richiederebbe lo scaricamento di un nuovo browser e un'immagine diversa da quella indicata nel brief).
- **Motivazione:** test riproducibili in locale e in CI con lo stesso browser; aggiornare Playwright significa aggiornare insieme `package.json` e l'immagine dei workflow (documentato nel README).
## D-007 — Versioni esatte delle dipendenze
- **Data:** 2026-10-15
- **Contesto:** riproducibilità della build e del pacchetto di rilascio.
- **Scelta:** tutte le dipendenze sono dichiarate con versione esatta (senza `^`) e `package-lock.json` è committato; la CI usa `npm ci`.
- **Alternative scartate:** intervalli semver (`^x.y.z`).
- **Motivazione:** build identiche nel tempo; gli aggiornamenti diventano commit espliciti.
## D-008 — Avvisi di `npm audit` sulle dipendenze di sviluppo
- **Data:** 2026-10-15
- **Contesto:** `npm audit` segnala 17 vulnerabilità, tutte in dipendenze transitive di strumenti di sviluppo (soprattutto `@lhci/cli`: `tmp`, `uuid`, `basic-ftp`, `extract-zip`). `npm audit --omit=dev` = 0 vulnerabilità.
- **Scelta:** nessuna azione; nessuno di questi pacchetti finisce nel sito pubblicato (che contiene solo file statici).
- **Alternative scartate:** `npm audit fix --force` (introdurrebbe versioni incompatibili e romperebbe Lighthouse CI).
- **Motivazione:** rischio nullo per il sito pubblicato; gli strumenti girano solo in locale/CI su input fidato.
## D-009 — Nessun `eslint-plugin-jsx-a11y`
- **Data:** 2026-10-15
- **Contesto:** le regole a11y di `eslint-plugin-astro` richiedono `eslint-plugin-jsx-a11y`, che non supporta ESLint 10.
- **Scelta:** si usa la configurazione `recommended` di `eslint-plugin-astro`; l'accessibilità è verificata da axe-core (tutte le pagine, due viewport), html-validate (regole WCAG) e Lighthouse (punteggio 1.0).
- **Alternative scartate:** declassare ESLint alla 9 solo per questo plugin.
- **Motivazione:** copertura a11y più forte a runtime che in lint statico; toolchain aggiornata.
## D-010 — Icone Lucide senza `astro-icon`
- **Data:** 2026-10-15
- **Contesto:** il brief consente `@iconify-json/lucide` + `astro-icon` oppure file SVG in `src/icons/`.
- **Scelta:** componente `Icon.astro` che legge i tracciati da `@iconify-json/lucide` (JSON) a build time e genera SVG inline con `aria-hidden="true"`. Nessuna integrazione aggiuntiva.
- **Alternative scartate:** `astro-icon` (porta con sé `@iconify/tools` e decine di dipendenze transitive, compatibilità con Astro 7 non dichiarata); copiare a mano i file SVG (manutenzione più scomoda).
- **Motivazione:** zero runtime, meno dipendenze, stesso set di icone (Lucide, licenza ISC).
## D-011 — Script segnaposto in fase 0
- **Data:** 2026-10-15
- **Contesto:** il brief chiede di definire in fase 0 tutti gli script npm di §3.3 «anche se vuoti».
- **Scelta:** gli script in `scripts/` sono creati come segnaposto e implementati nelle fasi 1 (icone), 6 (test) e 7 (packaging e release).
- **Alternative scartate:** nessuna.
- **Motivazione:** requisito del brief §14.0.
## D-012 — Mockup e brief in `docs/`
- **Data:** 2026-10-15
- **Contesto:** i mockup sono stati forniti in formato WebP (non PNG come indicato nell'Appendice A).
- **Scelta:** copiati in `docs/mockups/` con i nomi dell'Appendice A ed estensione `.webp`; il brief completo è conservato in `docs/BRIEF.md` come riferimento dei requisiti.
- **Alternative scartate:** convertirli in PNG (file più pesanti senza benefici).
- **Motivazione:** il riferimento visivo resta nel repository insieme ai requisiti.
## D-013 — Generazione di marchio e icone con tracciati vettoriali
- **Data:** 2026-10-15
- **Contesto:** favicon, `apple-touch-icon`, immagine Open Graph e `logo.svg` devono riprodurre la «G» e il logotipo in Fraunces/Inter. Un SVG con testo dipende dai font installati sul sistema (librsvg/sharp usa fontconfig); `fontkit` non gestisce correttamente i font variabili WOFF2 e il motore di shaping di `opentype.js` non supporta tutte le tabelle GSUB di questi font.
- **Scelta:** `scripts/generate-icons.mjs` legge le versioni statiche WOFF (`@fontsource/fraunces`, `@fontsource/inter`, solo sviluppo) con `opentype.js`, impagina i testi glifo per glifo e li converte in tracciati SVG; sharp genera i PNG e il file ICO (PNG incapsulati). I file generati sono committati e rigenerabili con `npm run icons`.
- **Alternative scartate:** testo SVG con font di sistema (risultato diverso da macchina a macchina); screenshot con Chromium (dipendenza dal browser per un'operazione grafica); disegnare la «G» a mano (non sarebbe Fraunces).
- **Motivazione:** risultato identico ovunque, nessun font di sistema richiesto, nessuna rete.
## D-014 — Menu mobile con `<dialog>` modale e alternativa senza JavaScript
- **Data:** 2026-10-15
- **Contesto:** il menu mobile deve avere pulsante con `aria-controls`/`aria-expanded`, chiusura con Esc e focus gestito, ma il sito deve restare navigabile senza JavaScript (§2.6). Script inline non sono ammessi dalla CSP.
- **Scelta:** pulsante + `<dialog>` aperto con `showModal()` (sfondo inerte, Esc nativo, focus sul pulsante «Chiudi» e ritorno al pulsante menu). Un blocco `<noscript><style>` (consentito dalla CSP: `style-src 'unsafe-inline'`) nasconde i pulsanti che richiedono JS e mostra le voci di menu sotto il logo; il sottomenu desktop resta raggiungibile da tastiera con `:focus-within` e la voce «Servizi» porta comunque alla pagina dei servizi.
- **Alternative scartate:** `popover` (non rende inerte lo sfondo, il focus può uscire dal menu); menu visibile di default e nascosto via JS (spostamento del layout al caricamento, CLS).
- **Motivazione:** accessibilità completa con JS, navigazione garantita senza JS, nessuno script inline.
## D-015 — Formato dei titoli di pagina
- **Data:** 2026-10-15
- **Contesto:** il brief chiede il formato «Titolo pagina — Studio Grasso | Studio Tributario e Societario, Asti» con un massimo di ~60 caratteri; il solo suffisso misura 54 caratteri, quindi il formato completo è possibile solo per titoli brevissimi.
- **Scelta:** regola in `src/lib/seo.ts`: si usa il formato completo se il titolo resta entro 65 caratteri, altrimenti «Titolo — Studio Grasso, Asti», altrimenti «Titolo — Studio Grasso». La home usa «Studio Grasso | Studio Tributario e Societario, Asti».
- **Alternative scartate:** formato completo ovunque (titoli fino a 100 caratteri, troncati nei risultati di ricerca); suffisso breve ovunque (perde le parole chiave dove c'è spazio).
- **Motivazione:** rispetta il formato dove possibile e la lunghezza sempre.
## D-016 — Dati in `src/data`, testi condivisi in `testi.ts`, testi di pagina in `pagine.ts`
- **Data:** 2026-10-15
- **Contesto:** «Tutto il testo editabile sta in `src/data` e `src/content`, mai hardcoded nei componenti».
- **Scelta:** `studio.ts` = anagrafica e fatti (unica fonte di verità); `navigazione.ts` = menu; `testi.ts` = testi ricorrenti (banda CTA, mappa, modulo); `pagine.ts` = testi e meta delle singole pagine; `src/content` = servizi, link utili e testi legali (Markdown). I componenti ricevono i dati come proprietà; restano nei componenti solo micro-etichette d'interfaccia (es. «Apri il menu»).
- **Alternative scartate:** testi direttamente nelle pagine `.astro`.
- **Motivazione:** lo Studio può aggiornare i contenuti senza toccare la logica dei componenti (vedi `docs/CONTENUTI.md`).
## D-017 — Nessun numero di telefono attribuito alla sede di Asti
- **Data:** 2026-10-15
- **Contesto:** il mockup mostra «Tel. +39 0141 1762214» nella card della sede di Asti, ma §4.1 elenca i due numeri senza associarli a una sede.
- **Scelta:** i due numeri sono indicati come recapiti dello Studio; nella card di Asti compare «Su appuntamento» con il numero principale per fissare l'appuntamento.
- **Alternative scartate:** riprodurre il mockup (attribuzione non verificata).
- **Motivazione:** priorità ai fatti di §4 sui mockup (§0.3). Richiesta di conferma in TODO-STUDIO.
## D-018 — URL dello scadenzario fiscale
- **Data:** 2026-10-15
- **Contesto:** §4.7 indica `https://www.agenziaentrate.gov.it/portale/scadenzario` «da verificare». Dalla ricerca sul sito dell'Agenzia lo scadenzario consultabile per imposta, contribuente e data è pubblicato su `https://www1.agenziaentrate.gov.it/servizi/scadenzario/main.php`; sotto `/portale/` è presente solo l'archivio storico.
- **Scelta:** si usa l'indirizzo `www1.agenziaentrate.gov.it/servizi/scadenzario/main.php`.
- **Alternative scartate:** l'indirizzo del brief (probabile 404 o archivio non aggiornato).
- **Motivazione:** il link deve portare allo scadenzario in uso. Il controllo dei link esterni (`npm run test:links -- --external`) va eseguito prima del rilascio: dall'ambiente di sviluppo i siti esterni non erano raggiungibili (proxy).
## D-019 — Aggiornamenti terminologici di §4.9 applicati ai contenuti
- **Data:** 2026-10-15
- **Contesto:** il vecchio sito usa terminologia superata (Commissioni tributarie, studi di settore, TASI, esterometro, CUD, ANF dei Comuni, bonus energia su convenzione, Camera di Commercio di Asti).
- **Scelta:** tutte le sostituzioni della tabella §4.9 sono applicate nei servizi (`src/content/servizi/*.md`), nelle abilitazioni e nelle qualifiche (`src/data/studio.ts`); il copyright usa l'anno di build. Ogni voce è elencata in TODO-STUDIO «Consigliato: confermare».
- **Alternative scartate:** riportare i testi originali (informazioni non più corrette).
- **Motivazione:** correttezza dei contenuti (§0.3, punto 1) con conferma finale dello Studio.
## D-020 — Testo della «Consulenza societaria» come elenco
- **Data:** 2026-10-15
- **Contesto:** §4.5 riporta per la consulenza societaria tre voci in elenco e un «messaggio» descrittivo con altre attività (acquisizioni, operazioni straordinarie, contratti, arbitrati).
- **Scelta:** le attività del messaggio sono riportate come voci della checklist; il paragrafo introduttivo riassume struttura giuridica, adempimenti e rapporti tra soci e organi sociali.
- **Alternative scartate:** paragrafo unico (meno leggibile, attività difficili da individuare).
- **Motivazione:** stessi fatti, presentazione coerente con il layout a checklist (§7.4).
## D-021 — Testi legali in Markdown con dati da `studio.ts`
- **Data:** 2026-10-15
- **Contesto:** privacy policy, cookie policy, note legali e accessibilità devono essere modificabili dallo Studio e coerenti con i dati (titolare, recapiti, dati societari, fornitori, modalità del modulo), che possono cambiare.
- **Scelta:** testi in `src/content/legali/*.md`; i dati sono inseriti con segnaposto `{{nome}}` e blocchi condizionali `<!-- se:condizione -->…<!-- /se:condizione -->` risolti a build time da `src/lib/legal.ts`. Un segnaposto sconosciuto o non risolto blocca la build. La data di aggiornamento è il campo `aggiornato` del frontmatter.
- **Alternative scartate:** testi scritti nelle pagine `.astro` (meno accessibili allo Studio); MDX (dipendenza in più per un'esigenza semplice).
- **Motivazione:** un solo punto in cui cambiare un dato; testi sempre coerenti con l'uso effettivo del sito (ad esempio, con il modulo disattivato la privacy policy descrive solo i contatti via e-mail).
## D-022 — `robots.txt` generato a build time
- **Data:** 2026-10-15
- **Contesto:** §3.2 prevede `public/robots.txt`, ma la riga `Sitemap:` deve contenere l'URL assoluto, che dipende da `SITE_URL`.
- **Scelta:** `src/pages/robots.txt.ts` genera `dist/robots.txt` (Allow all + Sitemap) dal valore di `site`.
- **Alternative scartate:** file statico con dominio fisso (errato se cambia il dominio).
- **Motivazione:** correttezza garantita per qualsiasi dominio.
## D-023 — Scelte sul `.htaccess`
- **Data:** 2026-10-15
- **Contesto:** l'hosting non è noto (§1); un `.htaccess` con direttive non permesse produce un errore 500 su tutto il sito.
- **Scelta:** tutte le direttive dei moduli dentro `<IfModule>`; redirect HTTP → HTTPS **attivo** (con controllo `X-Forwarded-Proto` per gli hosting dietro proxy), www/non-www commentato con le due varianti; `RedirectMatch 301 ^/privacy/?$ /privacy-policy/` al posto di `Redirect 301 /privacy …` (stesso effetto, senza ambiguità con `/privacy-policy/`); niente `Options -Indexes` (spesso vietato negli hosting condivisi): le cartelle senza `index.html` rispondono 404 tramite mod_rewrite; cache lunga e `immutable` per i file con impronta nel nome; header CSP esattamente come §9.4 più `Cross-Origin-Opener-Policy`.
- **Alternative scartate:** redirect HTTPS commentato (il problema principale del vecchio sito era l'HTTP); `<If>` di Apache 2.4 per la cache (supporto incompleto su LiteSpeed).
- **Motivazione:** massima compatibilità con gli hosting condivisi italiani senza rinunciare a HTTPS e header di sicurezza. Il passaggio a HTTPS va verificato al primo deploy (checklist in `docs/DEPLOY.md`).
## D-024 — `public/images/README.md` escluso dal sito pubblicato
- **Data:** 2026-10-15
- **Contesto:** §3.2 colloca in `public/images/README.md` l'elenco delle immagini che lo Studio può fornire; tutto ciò che è in `public/` viene copiato nel sito.
- **Scelta:** il file resta dove previsto dal brief; una piccola integrazione in `astro.config.mjs` lo rimuove da `dist/` a fine build.
- **Alternative scartate:** pubblicarlo (documento interno visibile online); spostarlo in `docs/` (diverso dalla struttura obbligatoria).
- **Motivazione:** struttura del brief rispettata, pacchetto di rilascio pulito.
## D-025 — CSS incluso nelle pagine
- **Data:** 2026-10-15
- **Contesto:** con `assetsInlineLimit: 0` (necessario perché nessuno script venga incluso inline, CSP `script-src 'self'`) Astro produceva 4–6 fogli di stile separati per pagina, tutti bloccanti per il rendering (segnalati da Lighthouse).
- **Scelta:** `build.inlineStylesheets: 'always'`: il CSS di ogni pagina è incluso nell'HTML (consentito da `style-src 'unsafe-inline'`). La pagina più pesante (home) misura circa 95 KB di HTML + CSS non compressi, sotto il budget di 120 KB.
- **Alternative scartate:** un unico foglio di stile esterno (una richiesta bloccante in più a ogni prima visita); soglia di inline più alta (avrebbe incluso anche gli script, vietati dalla CSP).
- **Motivazione:** prestazioni migliori (Lighthouse mobile 0.99–1) senza indebolire la CSP sugli script.
## D-026 — Token `--gold-800` per il testo delle chip
- **Data:** 2026-10-15
- **Contesto:** il testo oro `--gold-700` sul fondo `--gold-100` delle chip dei valori ha contrasto 4.40:1, sotto il minimo 4.5:1 richiesto (§6.2).
- **Scelta:** nuovo token `--gold-800: #806219` (4.98:1 su `--gold-100`) usato solo per il testo delle chip; l'aspetto resta quello del mockup.
- **Alternative scartate:** schiarire il fondo delle chip (si perde la tinta calda del mockup).
- **Motivazione:** contrasto AA per tutto il testo (priorità della specifica scritta sui mockup).
## D-027 — Audit di Lighthouse declassati ad avviso
- **Data:** 2026-10-15
- **Contesto:** il preset `lighthouse:recommended` trasforma in errore anche audit informativi o che dipendono dal server di test di LHCI (HTTP/1.1, assenza degli header del `.htaccess`), ad esempio `network-dependency-tree-insight`, che fallisce per qualsiasi catena HTML → font o script.
- **Scelta:** in `lighthouserc.cjs` restano errori bloccanti le quattro soglie di §9.3 (Performance ≥ 0.95, Accessibility = 1, Best Practices ≥ 0.95, SEO = 1) e tutti gli audit del preset; sono declassati a `warn` solo: `network-dependency-tree-insight`, `critical-request-chains`, `render-blocking-insight`, `render-blocking-resources`, `uses-http2`, `bf-cache`, `csp-xss`.
- **Alternative scartate:** togliere il preset (si perderebbero i controlli puntuali).
- **Motivazione:** regole «rumorose» declassate come previsto dal brief (§11.6), senza allentare le soglie.
## D-028 — Punti di interruzione in `em` e focus ciclico nel menu mobile
- **Data:** 2026-10-15
- **Contesto:** il test «testo al 200 %» (dimensione del carattere del browser raddoppiata) mostrava scorrimento orizzontale: con i punti di interruzione in px l'intestazione desktop restava attiva anche con testo doppio. Il test del menu mobile mostrava che il `<dialog>` nativo lascia uscire il focus verso l'interfaccia del browser dopo l'ultimo elemento.
- **Scelta:** media query in `em` (960 px → 60em, 640 px → 40em, 1100 px → 68.75em, 420 px → 26.25em) e larghezze fisse in `rem`; nel menu mobile Tab/Maiusc+Tab ciclano tra il primo e l'ultimo elemento.
- **Alternative scartate:** lasciare il comportamento nativo del dialog (accettabile ma meno prevedibile per chi usa la tastiera).
- **Motivazione:** WCAG 1.4.4 (ridimensionamento del testo) e 2.4.3 (ordine del focus) senza eccezioni.
## D-029 — Correzioni ai test durante la fase 6
- **Data:** 2026-10-15
- **Contesto:** §0.6 chiede di spiegare ogni test corretto.
- **Scelta:**
1. `check-compliance.mjs`, controllo «commercialista»: `DomUtils.findAll` restituisce solo elementi, quindi i nodi di testo non venivano esaminati; sostituito con una visita esplicita dei nodi di testo e una divisione in frasi che non spezza «Dott.», «n.», «sez.». Verificato con casi negativi iniettati (frasi errate rilevate, frasi sulla Dott.ssa Giulia Grasso accettate).
2. Test «testo al 200 %»: la prima versione iniettava `html { font-size: 200% }`, che non agisce sulle media query e non corrisponde a nessuna impostazione reale; ora il test usa il protocollo DevTools (`Page.setFontSizes`) come la preferenza «Dimensione carattere» del browser.
3. Test axe con mappa caricata: l'iframe è contenuto di terze parti (nei test una pagina finta): escluso dall'analisi, che resta sul markup del sito.
- **Alternative scartate:** nessuna (i test non sono stati allentati: le soglie restano zero violazioni gravi/critiche).
- **Motivazione:** test corretti che verificano davvero il requisito.
## D-030 — Link esterni nel Markdown e processore Markdown di Astro 7
- **Data:** 2026-10-15
- **Contesto:** in Astro 7 il processore Markdown predefinito (Sätteri) ignora `markdown.rehypePlugins` (deprecato); i link esterni dei testi legali risultavano senza `rel="noopener"` (rilevato da `check-compliance`).
- **Scelta:** l'HTML generato dal Markdown (servizi e testi legali) passa da `src/lib/html.ts`, che aggiunge `rel="noopener"` ai link verso altri domini; i link si aprono nella stessa scheda (§4.7).
- **Alternative scartate:** installare `@astrojs/markdown-remark` solo per un plugin.
- **Motivazione:** nessuna dipendenza in più, comportamento verificato dai test.
## D-031 — Dipendenze di test esplicite
- **Data:** 2026-10-15
- **Contesto:** `@axe-core/playwright` dichiara `playwright-core` come peer e npm installava la 1.64.1 accanto alla 1.56.1 di Playwright (tipi incompatibili); `check-compliance.mjs` usa `htmlparser2`, già presente come dipendenza di linkinator.
- **Scelta:** `playwright-core@1.56.1` e `htmlparser2@12.0.0` dichiarati esplicitamente in `devDependencies`.
- **Alternative scartate:** affidarsi alle dipendenze transitive.
- **Motivazione:** una sola versione di Playwright nel progetto; nessuna dipendenza usata senza essere dichiarata.
## D-032 — Test del modulo con il modulo attivo
- **Data:** 2026-10-15
- **Contesto:** con la configurazione predefinita (`contactForm.mode = 'off'`) i test del modulo (validazione, honeypot, tempo minimo, pagina di conferma) vengono saltati.
- **Scelta:** la variabile d'ambiente `CONTACT_FORM_MODE` (`off`, `php`, `endpoint`) ha la precedenza su `studio.ts`; i test del modulo sono stati eseguiti con `CONTACT_FORM_MODE=php npm run build` seguito da Playwright (tutti verdi, insieme a html-validate, axe e conformità). Il README spiega come ripeterli. L'invio a `/contact.php` è simulato nei test (nessun PHP in `astro preview`).
- **Alternative scartate:** attivare il modulo per impostazione predefinita (moduli rotti su hosting senza PHP, §10.1).
- **Motivazione:** il modulo resta verificato anche se disattivato.
## D-033 — Pacchetto di rilascio riproducibile e verificato senza dipendenze aggiuntive
- **Data:** 2026-10-15
- **Contesto:** §12.4 chiede archivi zip e tar.gz deterministici; §11.7 chiede di estrarli e confrontarli 1:1 con `dist/`. L'immagine CI potrebbe non avere `unzip`.
- **Scelta:** `scripts/package.mjs` usa `archiver` (ZipArchive/TarArchive) con voci ordinate, permessi 0644, fuso orario UTC e data fissa = `SOURCE_DATE_EPOCH` o data dell'ultimo commit (il workflow di release la imposta dal commit del tag). `check-package.mjs` legge lo zip con un lettore minimale in Node (directory centrale, store/deflate, controllo CRC32) ed estrae il tar.gz con `tar` di sistema; confronta percorsi, dimensioni e impronte con `dist/` e verifica `SHA256SUMS.txt` sia in Node sia con `sha256sum -c`. Due esecuzioni consecutive producono archivi identici (verificato). Il pacchetto fallisce se il tag non coincide con `package.json`.
- **Alternative scartate:** `unzip`/`zip` di sistema (non garantiti nel container); librerie di estrazione aggiuntive.
- **Motivazione:** integrità verificabile ovunque, nessuna dipendenza in più.
## D-034 — Verifica reale di `.htaccess`, configurazione nginx e `contact.php`
- **Data:** 2026-10-15
- **Contesto:** l'hosting non è noto; un errore in `.htaccess` o nel gestore PHP si scoprirebbe solo in produzione.
- **Scelta:** durante lo sviluppo sono stati installati localmente Apache 2.4.58, nginx 1.24 e PHP 8.3: il `.htaccess` (con `AllowOverride All`) e `deploy/nginx.conf.example` (con `nginx -t`) sono stati provati servendo `dist/` (redirect HTTPS e /privacy, barra finale, 404, file nascosti, header, cache, compressione); `contact.php` è stato provato con il server integrato di PHP (405, honeypot, validazione, header injection, tempo minimo, limite di 5 invii/ora, e-mail UTF-8 con Reply-To).
- **Alternative scartate:** nessuna verifica (solo revisione del codice).
- **Motivazione:** ridurre il rischio al primo deploy. Le prove non fanno parte di `npm run verify` (richiedono server non presenti nel container CI).
## D-035 — Workflow Forgejo
- **Data:** 2026-10-15
- **Contesto:** §12.2–12.3.
- **Scelta:** `ci.yml` (push su main, pull request, avvio manuale) con `npm run verify` nel container Playwright 1.56.1 e Node da `.nvmrc`, report Playwright e Lighthouse come artifact, job dei link esterni non bloccante; `release.yml` sui tag `v*.*.*` con controllo preliminare tag/versione/CHANGELOG, `SOURCE_DATE_EPOCH` dal commit, `verify`, `package`, note dal CHANGELOG e `forgejo-release@v2` (token `FORGEJO_TOKEN` se presente, altrimenti quello automatico); alternativa via API REST (`scripts/release-upload.sh`) commentata. Telemetria di Astro disattivata (`ASTRO_TELEMETRY_DISABLED`). Il deploy automatico resta un esempio non attivo (`deploy/forgejo-deploy.yml.example`, evento `release: published`, varianti rsync/FTPS/rclone).
- **Alternative scartate:** `workflow_run` per il deploy (non supportato da Forgejo Actions).
- **Motivazione:** nessuna release senza test verdi; workflow indipendenti dalla configurazione dell'istanza.
## D-036 — Checkbox del modulo: presa visione, non consenso
- **Data:** 2026-10-15
- **Contesto:** §10.1 riporta l'etichetta del vecchio sito («… e acconsento al trattamento dei miei dati personali…») e §8.3 indica come base giuridica l'art. 6.1.b «e, per quanto non necessario, consenso»; §8.2 chiede invece una «checkbox obbligatoria di presa visione». Un consenso obbligatorio per inviare la richiesta non è libero (art. 7.4 e considerando 43 GDPR) e renderebbe ambigua la base giuridica; inoltre non esiste un trattamento «non necessario» a rispondere.
- **Scelta:** per §0.3 (conformità legale prima di tutto; §8 prevale su §10) la checkbox è di sola presa visione: «Ho letto l'informativa sulla privacy». Base giuridica: art. 6.1.b (misure precontrattuali) oppure, per le richieste di sole informazioni, art. 6.1.f (legittimo interesse a rispondere). Messaggi di errore, testo della privacy e riga dell'e-mail di `contact.php` («Presa visione dell'informativa privacy: sì») sono allineati. La revoca del consenso (§8.3, punto 6) resta descritta per l'unico consenso raccolto dal sito, quello per le mappe.
- **Alternative scartate:** etichetta del vecchio sito (consenso non libero); seconda checkbox facoltativa di consenso (nessun trattamento ulteriore da autorizzare).
- **Motivazione:** base giuridica univoca e conforme; nessun consenso fittizio. Da confermare con il consulente (TODO-STUDIO B4).
## D-037 — Mappe di Google: base giuridica, ruoli e revoca
- **Data:** 2026-10-15
- **Contesto:** il caricamento della mappa su richiesta trasmette a Google indirizzo IP, browser e pagina di provenienza. La prima stesura citava Google solo come «titolare autonomo» nella sezione sui trasferimenti, senza base giuridica né modo di revocare la scelta, che vale per tutto il sito fino alla chiusura della scheda.
- **Scelta:** nella Privacy policy c'è una sezione dedicata. La base giuridica è il consenso espresso con «Carica la mappa» (art. 6.1.a GDPR e art. 122 del Codice). Per la sola raccolta e trasmissione dei dati lo Studio è contitolare con Google Ireland Limited (CGUE, C-40/17 «Fashion ID»); i trattamenti successivi sono di Google come titolare autonomo. Il trasferimento a Google LLC avviene sulla base dell'EU-U.S. Data Privacy Framework, a cui Google dichiara di aderire (decisione di adeguatezza del 10/7/2023). Il riquadro avvisa che la scelta vale per tutte le mappe del sito. Sotto ogni mappa caricata compare il pulsante «Non caricare più le mappe»: cancella la voce di `sessionStorage`, rimuove gli iframe della pagina e riporta il focus sul pulsante di caricamento. La revoca è verificata da `tests/e2e/privacy.spec.ts`. La Cookie policy è allineata.
- **Alternative scartate:** consenso valido per un solo riquadro (costringerebbe a ripetere il clic in ogni pagina e il comportamento è già noto agli utenti); nessun comando di revoca, perché chiudere la scheda non è «facile quanto dare il consenso» (art. 7.3).
- **Motivazione:** informativa completa per l'unico contenuto di terze parti del sito.
## D-038 — `contact.php`: limite di invii con dati minimi e cancellazione automatica
- **Data:** 2026-10-15
- **Contesto:** il limite di 5 invii all'ora creava nella cartella temporanea di sistema un file per IP. Il nome era un SHA-256 dell'IP con un sale facile da indovinare (quindi invertibile per forza bruta) e i file restavano con i permessi predefiniti, senza mai essere cancellati. Su un hosting condiviso altri utenti potevano leggerli, e la privacy policy non diceva nulla di questo trattamento.
- **Scelta:**
- Il nome del file è un HMAC-SHA256 dell'IP, calcolato con un segreto casuale di 32 byte generato al primo uso.
- I contatori stanno in una cartella privata **fuori dalla webroot**, configurabile (`CARTELLA_LIMITI`, predefinita `../.studio-grasso-form`). Se quella non si può usare, si ripiega su una sottocartella della cartella temporanea, accettata solo se ha permessi 0700; altrimenti il limite non si applica.
- I file sono creati con permessi 0600 e quelli più vecchi di un'ora vengono cancellati a ogni invio.
- Il blocco «moduloPhp» della Privacy policy dichiara il trattamento: impronta cifrata dell'IP e orario, al massimo un'ora, base giuridica art. 6.1.f.
- Il comportamento è stato provato con il server integrato di PHP 8.3: 5 invii accettati e il 6° rifiutato con 429, permessi 0700/0600, contatore vecchio cancellato.
- **Alternative scartate:** nessun limite per IP, che sarebbe meno sicuro; un database, che non esiste su tutti gli hosting.
- **Motivazione:** minimizzazione dei dati e limitazione della conservazione (art. 5.1.c ed e GDPR), sicurezza (art. 32 GDPR).
## D-039 — Testi legali e del modulo guidati dalla configurazione
- **Data:** 2026-10-15
- **Contesto:** alcune frasi erano vere solo in una configurazione. Esempi:
- la nota «nessun dato a terze parti», falsa in modalità `endpoint`;
- il consenso e i campi del modulo citati anche con il modulo spento;
- «il sito non trasferisce dati fuori dall'UE» affermato senza conoscere i fornitori.
Inoltre l'informativa breve del modulo indicava il titolare con un generico «lo Studio».
- **Scelta:** nuovi dati in `studio.ts`:
- `fornitori.modulo`, obbligatorio in modalità `endpoint`: senza, la build si ferma;
- `fornitori.soloSee`, `false` finché la verifica di TODO-STUDIO B2 non è fatta.
Nuove condizioni nei testi legali: `soloSee`, `pecProfessionisti` e la negazione `se:!modulo`, già supportata. Nuovi segnaposto: `{{fornitoreModulo}}` e `{{pecProfessionisti}}`. I segnaposto dei fornitori includono la preposizione articolata («comunicati al fornitore…»).
Il componente del modulo cambia così:
- l'informativa breve è composta con denominazione, indirizzo, durata di conservazione ed e-mail presi da `studio.ts`;
- la nota sul destinatario dei dati è diversa per `php` ed `endpoint`;
- i messaggi di validazione passano da `testi.ts` a `form.ts` tramite `data-messages`, quindi c'è un'unica fonte dei testi.
La pagina Accessibilità descrive il modulo solo se è attivo e include tra gli usi di JavaScript lo script delle ancore del vecchio sito.
- **Alternative scartate:** testi fissi da correggere a mano a ogni cambio di configurazione.
- **Motivazione:** nessuna affermazione falsa in nessuna modalità (§2.3, §8).