Nel checkout principale mancava node_modules: le configurazioni di avvio puntano a
node_modules/astro/bin/astro.mjs e fallivano subito. Ora un preLaunchTask («Sito:
dipendenze», scripts/ensure-deps.mjs) esegue npm ci solo se node_modules manca, se manca
una dipendenza diretta o se package-lock.json è più recente dell'ultima installazione;
altrimenti esce subito. Lo stesso controllo precede la build dell'anteprima. README e
CHANGELOG lo descrivono, con il messaggio di Astro quando un server è già avviato.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Il committente ha chiesto un sito più moderno, con pagine ed effetti di
scorrimento di alto livello. La palette e i font restano gli stessi; cambia il
linguaggio visivo (DECISIONS.md, D-058):
- palchi navy arrotondati per hero, testate, credenziali, banda CTA e footer;
servizi in griglia bento con la prima card in evidenza; nuova sezione «Come
lavoriamo»; fascia di numeri ricavati dai dati; menu mobile a tutto schermo;
indice laterale fermo nelle pagine legali, che segue la lettura (toc.ts);
- movimento solo CSS (scroll-driven animations e View Transitions), dentro
@supports e prefers-reduced-motion: senza supporto o con «riduci movimento»
tutto resta fermo e visibile. La comparsa usa solo spostamento e scala, mai
l'opacità, che lasciava semitrasparente il testo sul bordo della finestra;
- budget di 120 KB rispettato con lo scoping a classi, il marchio richiamato
con <use> e gli stili di checklist e documenti in file separati;
- compatibilità con Safari/iOS 15 e Firefox: overflow: clip in un blocco
@supports separato (il minificatore eliminava la riserva hidden), nessun
:has() per gli stacchi tra i palchi;
- stampa dei palchi in nero su bianco, dichiarazione di accessibilità e
decisioni aggiornate (D-042 superata in parte, deroga a §2.6 per toc.ts).
Testi nuovi da far confermare allo Studio: TODO-STUDIO.md, C14.
Verifiche: eslint, prettier, astro check, build, html-validate, link,
conformità (1467 controlli), Playwright e2e e a11y (90 superati), Lighthouse
(prestazioni 98-100, accessibilità, best practice e SEO 100), pacchetto v1.1.0.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sul runner il server di cache non è raggiungibile dal container del job (getCacheEntry
failed: connect ETIMEDOUT): setup-node con cache: npm aspettava circa cinque minuti prima
di proseguire con un avviso, sia all'inizio sia nel passo finale di salvataggio. Le
dipendenze si scaricano con npm ci a ogni esecuzione.
La prima esecuzione su Gitea è passata per intero (lint, formato, tipi, build, HTML, link,
e2e, accessibilità 51, conformità 1455, Lighthouse, pacchetto zip). Corretti i commenti sui
timeout, che attribuivano ai limiti anche lo scarico dell'immagine (non provato), e aggiunta
la motivazione in D-056.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
La prima esecuzione su Gitea ha impiegato oltre venti minuti solo per scaricare
l'immagine mcr.microsoft.com/playwright (più di 1 GB) sulla rete del runner di casa, a
fronte di un limite di 30 minuti per l'intero job: l'esecuzione rischiava di scadere
prima di cominciare i controlli. Ora verify e release hanno 90 minuti e il controllo dei
link esterni 45; a immagine presente la verifica dura pochi minuti. Motivazione in D-056,
estratti di docs/BRIEF.md allineati.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Il progetto vive in modo definitivo su Gitea: i workflow passano da .forgejo/ a
.gitea/workflows/ e la documentazione non nomina più la piattaforma precedente.
- ci.yml: i controlli di npm run verify sono passi separati (si vede subito quale è
fallito) e alla fine la CI crea lo zip di rilascio e ne verifica il contenuto, così un
errore di pacchetto emerge prima del tag. Runner ubuntu-latest, azioni da github.com con
URL completo, upload-artifact@v3 (la v4 non funziona su Gitea).
- release.yml: a ogni tag vX.Y.Z verifica tutto, crea lo zip e lo pubblica nella Release
con scripts/release-upload.sh e l'API di Gitea, senza action esterne di release.
- La release contiene un solo file, sito-studio-grasso-vX.Y.Z.zip (contenuto di dist/ alla
radice, .htaccess compreso): tolti tar.gz, SHA256SUMS.txt e BUILD-INFO.txt da
package.mjs, check-package.mjs e dalla documentazione.
- release-upload.sh: variabili GITEA_*, si ferma su errori diversi da 404 invece di
provare a creare la release, rifiuta una cartella vuota; provato su una finta API Gitea.
- deploy/gitea-deploy.yml.example convertito per Gitea (resta disattivato).
- Versione 1.0.1 pronta (package.json, CHANGELOG, D-056 e D-057 in DECISIONS.md); il tag
v1.0.1 non è stato creato.
Verifica: npm run verify completo (lint, formato, tipi, build, HTML, link, e2e 39,
a11y 51, conformità 1455, Lighthouse) e npm run package eseguiti in una copia fuori da
.claude/. I workflow non sono ancora stati eseguiti su un runner Gitea.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Verificata eseguendo i job della CI negli stessi container del runner (il runner dell'istanza è offline).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è
mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato
anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi
del sito, dei controlli e della documentazione.
CI e rilascio:
- continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno
irraggiungibile avrebbe reso rossa la CI;
- artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati);
- token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico;
- dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL;
- ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server;
sostituzione dei file senza mai lasciarli mancanti;
- tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip).
Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di
focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop
senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe,
giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati.
Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail,
a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in
quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante
MODALITA_PREDEFINITA per attivarlo.
Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore,
«commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive,
HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test.
Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso),
deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata,
procedura nginx che toglie i file delle versioni precedenti.
Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il
debugger collegato.
Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e
decisioni D-045…D-055.
Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root);
job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in
Docker; release-upload.sh e deploy di esempio contro API e shell simulate.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- privacy (modalità php): conservazione dell'impronta HMAC descritta come
avviene davvero; cron facoltativo in DEPLOY.md
- contitolarità con Google: punto di contatto e verifica dell'accordo
ex art. 26 in TODO B4; informativa breve con art. 6.1.b o f
- «titolo conseguito in Italia» tolto: dato da confermare (statoTitolo,
TODO C13); qualifica CAF del Dott. Ezio Grasso con la dicitura ufficiale
- mappe: il consenso carica tutte le mappe della pagina
- Esc sul sottomenu riporta il focus sul pulsante; sidebar «Altri servizi»
- resa: anello CTA ancorato al contenuto, colonna legale allineata alla
testa, spazi non separabili anche nei testi legali e nel ruolo, «tel.»
unito al numero, a capo dopo la @ nel pulsante e-mail, breadcrumb
- contact.php: UTF-8 non valido rifiutato, nessun avviso con open_basedir,
apostrofi tipografici; CSP con direttive ripetute segnalate;
--shell-safe neutralizza ogni $
- DEPLOY: ordine dei passi della modalità endpoint; TODO B2/C13 e righe
- date di aggiornamento dei testi legali
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- testi: «lo Studio» uniforme, «Centro autorizzato CAF», ripetizioni tolte
nei servizi e in «Lo studio», valori senza superlativi, meta corrette,
testo della mappa di §10.2, numeri e indirizzi con spazi non separabili
- visuale: breadcrumb, anello della banda CTA, card dei professionisti,
pager e sidebar dei servizi su mobile, pagine legali a colonna singola,
pulsante e-mail su una riga, card sedi allineate
- dati: fatti della sede di Asti da studio.ts/testi.ts, sede.telefono
- 404 e conferma senza canonical; avviso mappa senza JavaScript
- controlli: CSP per direttive (endpoint), anno da SOURCE_DATE_EPOCH,
URL del sito controllati sulla build locale, import file:// e tar da
stdin per Windows, .gitattributes, porta libera corretta
- modulo: pattern del telefono valido, avviso visibile, Esc sul
sottomenu aperto al passaggio del mouse; contact.php con -f, senza
mbstring obbligatorio, fuso Europe/Rome
- release: note --shell-safe, ripiego REST automatico, RELEASE_TOKEN;
deploy di esempio senza esclusione di contact.php; nginx /privacy/
- DECISIONS D-040–D-044, TODO C4 e riferimenti di riga aggiornati
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- 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
- README: requisiti, comandi, struttura, configurazione, pubblicazione su
Forgejo, release e segreto FORGEJO_TOKEN
- docs/DEPLOY.md: cPanel/Plesk, FTP, nginx, object storage, modulo PHP,
controlli post-deploy, rollback, deploy automatico, release manuale
- docs/CONTENUTI.md: guida non tecnica per aggiornare testi e dati
- CHANGELOG con la sezione 1.0.0; screenshot di controllo esclusi da git
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- .forgejo/workflows/ci.yml: npm run verify nel container Playwright a ogni
push su main e pull request, report come artifact, link esterni non bloccanti
- .forgejo/workflows/release.yml: ai tag vX.Y.Z verifica, pacchetto e
pubblicazione nella sezione Release con forgejo-release (token FORGEJO_TOKEN)
- scripts/package.mjs: zip e tar.gz riproducibili, SHA256SUMS.txt, BUILD-INFO.txt
- scripts/check-package.mjs: confronto 1:1 con dist/, impronte, sha256sum -c
- scripts/changelog-notes.mjs e release-upload.sh (API REST di Forgejo)
- deploy/: nginx.conf.example, gestore PHP del modulo, esempio di deploy
automatico (rsync, FTPS, rclone) non attivo
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- html-validate su tutte le pagine; linkinator su astro preview (link, asset,
CSS e ancore), con modalità --external per i siti esterni
- e2e Playwright: struttura e metadati di ogni pagina, 404, navigazione,
sottomenu, menu mobile, ancore del vecchio sito, nessuna richiesta esterna,
nessun cookie, localStorage vuoto, mappa solo dopo il clic, funzionamento
senza JavaScript, modulo di contatto
- a11y: axe su tutte le pagine a 1440 e 390 px e negli stati interattivi,
tastiera (skip link, sottomenu, menu mobile), focus visibile, testo al 200 %,
reflow a 320 px, movimento ridotto
- check-compliance.mjs: P.IVA, link legali, risorse sicure, segnaposto,
JSON-LD, sitemap, robots, .htaccess, badge e servizi, uso di
«commercialista», riferimento L. 4/2013, budget
- fix: punti di interruzione in em, focus ciclico nel menu mobile,
rel="noopener" sui link esterni del Markdown, numeri di telefono non spezzabili
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- CSS delle pagine incluso nell'HTML: nessun foglio di stile bloccante
(Lighthouse mobile: Performance 0.99–1, Accessibility, Best Practices e SEO 1)
- token --gold-800 per il testo delle chip (contrasto 4.98:1)
- lighthouserc: soglie di §9.3 bloccanti, audit informativi declassati ad avviso
- verificati titoli (≤ 65 caratteri) e descrizioni (120–155) unici, nessun
overflow orizzontale a 320 px
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- privacy policy, cookie policy, note legali e accessibilità in Markdown,
scritte ex novo sull'uso effettivo del sito, con dati da studio.ts
(segnaposto e blocchi condizionali risolti a build time)
- dati societari ex art. 2250 c.c., fornitori e polizza RC previsti in
studio.ts: compaiono appena valorizzati
- .htaccess: HTTPS, redirect del vecchio sito, CSP e header di sicurezza,
404, blocco file nascosti e .map, compressione e cache
- robots.txt generato dal valore di SITE_URL; sitemap senza pagina di conferma
- docs/CONFORMITA.md, TODO-STUDIO.md completo, public/images/README.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- home con hero, servizi, studio e professionisti, abilitazioni, partner,
banda CTA e sedi con mappa click-to-load
- lo studio, servizi (hub con ancore del vecchio sito e redirect), dettaglio
servizio con barra laterale e precedente/successivo
- contatti (recapiti, modulo o card e-mail, mappa), dove siamo, link utili
- pagina 404 e pagina di conferma del modulo (noindex, fuori sitemap)
- script per screenshot di tutte le pagine; preview Astro in primo piano
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- studio.ts completo: anagrafica, sedi, orari, professionisti con titoli esatti,
9 abilitazioni, valori, partner, collaborazioni, configurazione del modulo
- 6 servizi in Markdown con tutti i contenuti di §4.5 e gli aggiornamenti di §4.9
- link-utili.json con URL aggiornati (scadenzario AE su www1)
- testi e meta delle pagine in pagine.ts, testi condivisi in testi.ts
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- token, font self-hosted (Fraunces e Inter, sottoinsieme latin) con preload
- BaseLayout con head completo (SEO, Open Graph, favicon) e JSON-LD dello studio
- intestazione con barra superiore, navigazione e sottomenu servizi accessibili
- menu mobile con dialog modale e alternativa senza JavaScript
- footer con P.IVA, recapiti, servizi, orari e link legali
- componenti: Logo, Icon (Lucide inline), Hero, card servizio, scheda
professionista, badge abilitazione, card sede, mappa click-to-load,
modulo di contatto, banda CTA, breadcrumb, intestazioni di sezione
- generate-icons.mjs: marchio, favicon, apple-touch-icon e immagine OG
- collection dei servizi e dei link utili con schemi Zod
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
- Astro 7.4.0 in output statico, TypeScript strict, sitemap
- ESLint (flat config, Astro + TS), Prettier, EditorConfig, .nvmrc
- configurazioni di Playwright, Lighthouse CI e html-validate
- script npm di §3.3 (segnaposto per gli script non ancora implementati)
- README, DECISIONS, TODO-STUDIO e CHANGELOG iniziali
- mockup e brief in docs/
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ