diff --git a/.forgejo/workflows/ci.yml b/.forgejo/workflows/ci.yml index 0f28cbd..0763a51 100644 --- a/.forgejo/workflows/ci.yml +++ b/.forgejo/workflows/ci.yml @@ -11,8 +11,18 @@ # AZIONI: referenziate con URL completo su code.forgejo.org, così il workflow non dipende # dall'impostazione DEFAULT_ACTIONS_URL dell'istanza. # -# SEGRETI: questo workflow non ne usa. Il segreto facoltativo FORGEJO_TOKEN (o RELEASE_TOKEN) -# serve solo a release.yml (vedi il commento in quel file e il README). +# ARTIFACT: upload-artifact@v3 (supportato da Forgejo) con include-hidden-files, altrimenti +# salta .lighthouseci/ e dist/.htaccess. Per passare alla v4 usare il fork per Forgejo +# https://code.forgejo.org/forgejo/upload-artifact@v4: actions/upload-artifact@v4 accetta solo +# github.com e su Forgejo fallisce sempre (GHESNotSupportedError). +# +# NON BLOCCANTE: Forgejo ignora `continue-on-error` a livello di job; va messo sullo step. +# +# DOMINIO: la variabile del repository SITE_URL (Impostazioni → Actions → Variabili), se +# impostata, sostituisce il dominio predefinito di site.config.mjs in build e test. +# +# SEGRETI: questo workflow non ne usa. Il segreto facoltativo RELEASE_TOKEN serve solo a +# release.yml (vedi il commento in quel file e il README). # ============================================================================= name: CI @@ -25,6 +35,7 @@ on: env: ASTRO_TELEMETRY_DISABLED: '1' CI: 'true' + SITE_URL: ${{ vars.SITE_URL }} jobs: verify: @@ -49,7 +60,7 @@ jobs: - name: Report Playwright (solo in caso di errore) if: failure() - uses: https://code.forgejo.org/actions/upload-artifact@v3 # usare @v4 se l'istanza Forgejo lo supporta + uses: https://code.forgejo.org/actions/upload-artifact@v3 # per la v4: forgejo/upload-artifact@v4 (vedi in alto) with: name: playwright-report path: playwright-report @@ -61,6 +72,7 @@ jobs: with: name: lighthouse path: .lighthouseci + include-hidden-files: true # cartella nascosta: senza, l'action non carica nulla retention-days: 14 - name: Artifact dist @@ -68,6 +80,7 @@ jobs: with: name: dist path: dist + include-hidden-files: true # comprende dist/.htaccess retention-days: 7 external-links: @@ -75,7 +88,6 @@ jobs: runs-on: docker # label del runner: adattare (es. ubuntu-latest) container: image: node:24 - continue-on-error: true # dipende dalla rete del runner e dai siti esterni timeout-minutes: 15 steps: - uses: https://code.forgejo.org/actions/checkout@v4 @@ -89,4 +101,7 @@ jobs: run: npm run build - name: Controllo dei link esterni + # non bloccante: dipende dalla rete del runner e dai siti esterni. Su Forgejo deve stare + # sullo step: a livello di job viene ignorato e un link esterno rotto renderebbe rossa la CI. + continue-on-error: true run: npm run test:links -- --external diff --git a/.forgejo/workflows/release.yml b/.forgejo/workflows/release.yml index 054e63b..459ea27 100644 --- a/.forgejo/workflows/release.yml +++ b/.forgejo/workflows/release.yml @@ -11,17 +11,21 @@ # RUNNER: `runs-on: docker` è il label più comune di forgejo-runner; sostituirlo se il # runner dell'istanza ne usa un altro (es. `ubuntu-latest`). # -# TOKEN: su alcune istanze il token automatico del workflow non può creare release. -# In tal caso creare un access token (Impostazioni utente → Applicazioni → Genera token, -# permesso «write:repository») e salvarlo come segreto del repository con nome -# FORGEJO_TOKEN (Impostazioni del repository → Actions → Segreti). Se l'istanza non accetta -# nomi che iniziano con FORGEJO_, usare RELEASE_TOKEN. Se il segreto esiste viene usato al -# posto del token automatico; serve anche per avviare il deploy automatico facoltativo -# (gli eventi creati con il token automatico non avviano altri workflow). +# TOKEN: per impostazione predefinita la release è pubblicata con il token automatico del +# workflow (su Forgejo ha il permesso di scrittura sul repository). Per usare un token personale +# creare un access token (Impostazioni utente → Applicazioni → Genera token, permesso +# «write:repository») e salvarlo come segreto del repository RELEASE_TOKEN (Impostazioni del +# repository → Actions → Segreti): se esiste viene usato al posto del token automatico. Serve +# per avviare il deploy automatico facoltativo, perché le modifiche fatte con il token +# automatico non avviano altri workflow. NON usare nomi che iniziano con FORGEJO_, GITEA_ o +# GITHUB_: sono riservati, e secrets.FORGEJO_TOKEN è sempre il token automatico. # # PUBBLICAZIONE: prima con l'action forgejo-release; se l'action non riesce (es. strumenti # mancanti nell'immagine), lo step successivo pubblica la stessa release con l'API REST # (scripts/release-upload.sh, solo curl e node). +# +# DOMINIO: la variabile del repository SITE_URL, se impostata, sostituisce il dominio +# predefinito di site.config.mjs (canonical, sitemap, robots.txt, dati strutturati). # ============================================================================= name: Release @@ -32,6 +36,7 @@ on: env: ASTRO_TELEMETRY_DISABLED: '1' CI: 'true' + SITE_URL: ${{ vars.SITE_URL }} jobs: release: @@ -89,7 +94,7 @@ jobs: url: ${{ github.server_url }} repo: ${{ github.repository }} tag: ${{ github.ref_name }} - token: ${{ secrets.FORGEJO_TOKEN || secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }} + token: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }} release-dir: release # contiene SOLO zip, tar.gz, SHA256SUMS.txt, BUILD-INFO.txt release-notes: ${{ steps.notes.outputs.notes }} prerelease: ${{ contains(github.ref_name, '-') }} @@ -100,12 +105,12 @@ jobs: env: FORGEJO_URL: ${{ github.server_url }} FORGEJO_REPO: ${{ github.repository }} - FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN || secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }} + FORGEJO_TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }} run: bash scripts/release-upload.sh "${{ github.ref_name }}" release - name: Report Playwright (solo in caso di errore) if: failure() - uses: https://code.forgejo.org/actions/upload-artifact@v3 # usare @v4 se l'istanza Forgejo lo supporta + uses: https://code.forgejo.org/actions/upload-artifact@v3 # per la v4: forgejo/upload-artifact@v4 (vedi ci.yml) with: name: playwright-report path: playwright-report diff --git a/.gitignore b/.gitignore index 643578f..ea575a8 100644 --- a/.gitignore +++ b/.gitignore @@ -29,6 +29,8 @@ desktop.ini .idea/ .vscode/* !.vscode/extensions.json +!.vscode/launch.json +!.vscode/tasks.json *.swp # Screenshot di controllo (oltre 2 MB: si rigenerano con `npm run screenshots`) diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..fb64920 --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,73 @@ +{ + // Avvio del sito in debug: pannello «Esegui e debug» (Ctrl+Maiusc+D), scegliere la + // configurazione e premere F5. Il server Astro parte con il debugger di Node collegato; + // appena è pronto si apre il browser con il proprio debugger (punti di interruzione negli + // script di src/scripts/). Maiusc+F5 sulla sessione del server la ferma e chiude il browser; + // dopo una pausa nel browser la sessione selezionata è quella del browser: un secondo + // Maiusc+F5 (o Stop su «Sito: sviluppo») ferma anche il server. + // + // Il pattern riconosce la riga «Local http://…» di Astro anche quando è colorata: su Windows + // Astro scrive sempre i codici colore ANSI, che non devono finire nell'indirizzo aperto. + "version": "0.2.0", + "configurations": [ + { + "name": "Sito: sviluppo (Edge)", + "type": "node", + "request": "launch", + "program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs", + "args": ["dev"], + "cwd": "${workspaceFolder}", + "env": { "ASTRO_TELEMETRY_DISABLED": "1" }, + "outputCapture": "std", + "skipFiles": ["/**", "${workspaceFolder}/node_modules/**"], + "serverReadyAction": { + "pattern": "Local\\s+(?:\\u001b\\[[0-9;]*m)*(https?://[^\\s\\u001b]+)", + "uriFormat": "%s", + "action": "debugWithEdge", + "webRoot": "${workspaceFolder}", + "killOnServerStop": true + }, + "presentation": { "group": "sito", "order": 1 } + }, + { + "name": "Sito: sviluppo (Chrome)", + "type": "node", + "request": "launch", + "program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs", + "args": ["dev"], + "cwd": "${workspaceFolder}", + "env": { "ASTRO_TELEMETRY_DISABLED": "1" }, + "outputCapture": "std", + "skipFiles": ["/**", "${workspaceFolder}/node_modules/**"], + "serverReadyAction": { + "pattern": "Local\\s+(?:\\u001b\\[[0-9;]*m)*(https?://[^\\s\\u001b]+)", + "uriFormat": "%s", + "action": "debugWithChrome", + "webRoot": "${workspaceFolder}", + "killOnServerStop": true + }, + "presentation": { "group": "sito", "order": 2 } + }, + { + // Prima compila dist/ (task «Sito: build»), poi lo serve come in produzione. + "name": "Sito: anteprima della build (Edge)", + "type": "node", + "request": "launch", + "preLaunchTask": "Sito: build", + "program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs", + "args": ["preview", "--host", "127.0.0.1", "--port", "4321"], + "cwd": "${workspaceFolder}", + "env": { "ASTRO_TELEMETRY_DISABLED": "1" }, + "outputCapture": "std", + "skipFiles": ["/**", "${workspaceFolder}/node_modules/**"], + "serverReadyAction": { + "pattern": "Local\\s+(?:\\u001b\\[[0-9;]*m)*(https?://[^\\s\\u001b]+)", + "uriFormat": "%s", + "action": "debugWithEdge", + "webRoot": "${workspaceFolder}", + "killOnServerStop": true + }, + "presentation": { "group": "sito", "order": 3 } + } + ] +} diff --git a/.vscode/tasks.json b/.vscode/tasks.json new file mode 100644 index 0000000..e62d1c9 --- /dev/null +++ b/.vscode/tasks.json @@ -0,0 +1,14 @@ +{ + // Task usati da .vscode/launch.json (avviabili anche da Terminale → Esegui attività). + "version": "2.0.0", + "tasks": [ + { + "label": "Sito: build", + "detail": "astro build: genera il sito statico in dist/", + "type": "npm", + "script": "build", + "group": "build", + "problemMatcher": [] + } + ] +} diff --git a/CHANGELOG.md b/CHANGELOG.md index f511f6e..0170d83 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,25 @@ Il formato segue [Keep a Changelog](https://keepachangelog.com/it-IT/1.1.0/) e i ## [Non rilasciato] +### Aggiunto + +- Avvio del sito in debug da VS Code (F5): server di sviluppo con il browser collegato al debugger (Edge o Chrome) oppure anteprima della build. +- `site.config.mjs`: dominio del sito in un solo punto. La variabile del repository `SITE_URL` vale anche per la build di CI e release. + +### Corretto + +- CI su Forgejo: il controllo dei link esterni non blocca più la CI (Forgejo ignora `continue-on-error` sul job); il report Lighthouse e il `.htaccess` arrivano negli artifact; il token personale per le release è `RELEASE_TOKEN` (il prefisso `FORGEJO_` è riservato). +- Release: lo script di ripiego crea la release in bozza e la pubblica solo dopo i file, pubblica anche una bozza rimasta a metà, sostituisce un file senza mai lasciarlo mancante e controlla che il tag sia sul server; il tar.gz è identico su Windows, macOS e Linux. +- Layout mobile su Safari/iOS precedenti alla 16.4 e sfocatura dell'intestazione su Chrome, Edge e Firefox (CSS generato per i browser supportati). +- Accessibilità: anello di focus con contrasto di almeno 3:1 su ogni fondo; bersagli touch di 44 px per la freccia del sottomenu, i recapiti e i link del footer su mobile; nessuna zona morta sotto le voci del menu; HTML valido nella pagina Servizi. +- Intestazione desktop: voci del menu e logo non vanno più a capo vicino ai 960 e ai 1100 px; il numero di telefono compare da 1140 px, quando c'è spazio. +- Colore delle etichette dei valori in home; stampa senza i riquadri delle mappe. +- Dati strutturati e mappe: giorni di apertura, ricerca per indirizzo, titolo delle mappe e numero dell'intestazione ricavati dai dati dello Studio. +- Modulo di contatto (modalità `php` ed `endpoint`): stesse regole nel browser e nel gestore PHP, tempo minimo misurato con un solo orologio, e-mail in quoted-printable (nessun rifiuto per righe troppo lunghe), messaggi d'errore con il requisito, attivazione con la costante `MODALITA_PREDEFINITA`. +- Controlli e test leggono i dati del sito: aggiornare orari, recapiti o testi, oppure aggiungere un servizio, non fa più fallire la verifica. Il controllo su «commercialista» copre anche descrizioni, attributi e dati strutturati. +- Esempi di pubblicazione: nginx con gli header di sicurezza su ogni risposta (HSTS compreso, anche sul redirect dal dominio senza «www»), procedura nginx che toglie i file delle versioni precedenti, deploy automatico che parte alla pubblicazione di una release (non alle modifiche successive delle note) e sincronizza via rsync solo una cartella confermata. +- HSTS si può attivare con una scelta esplicita (`HSTS_ATTIVO` nei controlli) invece di far fallire la verifica. + ## [1.0.0] - 2026-10-16 Prima versione del nuovo sito dello Studio Grasso — Studio Tributario e Societario. diff --git a/DECISIONS.md b/DECISIONS.md index ff8ea6b..e5ce182 100644 --- a/DECISIONS.md +++ b/DECISIONS.md @@ -227,6 +227,7 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · - **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. +- **Aggiornamento (2026-10-16):** il numero di telefono dell'intestazione compare da 71.25em (1140 px) invece che da 68.75em: vedi D-055. ## D-029 — Correzioni ai test durante la fase 6 @@ -286,6 +287,7 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · - **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. +- **Aggiornamento (2026-10-16):** `continue-on-error` del job dei link esterni spostato sullo step, artifact con i file nascosti e token `RELEASE_TOKEN` al posto di `FORGEJO_TOKEN`: vedi D-045. ## D-036 — Checkbox del modulo: presa visione, non consenso @@ -380,6 +382,7 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · - **Scelta:** il workflow usa l'action indicata dal brief (§12.3) con le note prodotte da `changelog-notes.mjs --shell-safe`, che converte `codice` in «codice» e toglie `"`, `\` e `$(`. L'action ha `continue-on-error`: se non riesce, lo step successivo pubblica la stessa release con `scripts/release-upload.sh` (solo curl e node, già provato contro un'API simulata), che legge le note dal CHANGELOG senza passare dalla shell. Token: `FORGEJO_TOKEN`, oppure `RELEASE_TOKEN`, oppure quello automatico. Il deploy di esempio non esclude più `contact.php` e protegge `.well-known/`, `.user.ini` e `cgi-bin/`. - **Alternative scartate:** solo l'API REST (il brief prescrive l'action); note senza alcuna trasformazione. - **Motivazione:** nessuna release bloccata o alterata da un dettaglio dell'istanza. Consigliato un primo rilascio di prova sull'istanza reale prima di comunicare la versione. +- **Aggiornamento (2026-10-16):** su Forgejo `secrets.FORGEJO_TOKEN` è sempre il token automatico e il prefisso `FORGEJO_` è riservato: il token personale è solo `RELEASE_TOKEN` (D-045). Il ripiego REST ora crea la release in bozza e la pubblica dopo i file (D-046). ## D-044 — Controlli coerenti con la configurazione e portabili @@ -404,3 +407,181 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · - `--shell-safe` neutralizza ogni `$` ($). - **Alternative scartate:** documentare i limiti invece di correggerli. - **Motivazione:** `npm run verify` deve fallire solo per difetti reali (§11) e funzionare su Linux, macOS e Windows. + +## D-045 — CI su Forgejo 16: job non bloccante, artifact, token e runner + +- **Data:** 2026-10-16 +- **Contesto:** sull'istanza le run della CI e della release restano «in attesa»: l'unico runner registrato («Ferrari», globale) è offline e non si è mai collegato (nessuna versione, nessun label). La revisione ha trovato tre difetti che si sarebbero presentati con il runner online: + - Forgejo ignora `continue-on-error` a livello di job: il job «Link esterni (non bloccante)» avrebbe reso rossa la CI al primo sito esterno irraggiungibile; + - `upload-artifact@v3` (v3.2.1) esclude i file nascosti: il report Lighthouse (`.lighthouseci/`) e `dist/.htaccess` non venivano mai caricati; + - `secrets.FORGEJO_TOKEN` è sempre il token automatico e i nomi con prefisso `FORGEJO_`, `GITEA_` o `GITHUB_` sono riservati: `RELEASE_TOKEN` non veniva mai usato. +- **Scelta:** + - `continue-on-error` sullo step «Controllo dei link esterni»; + - `include-hidden-files: true` negli upload del report Lighthouse e di `dist`; + - token `secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN` in release.yml; + - per una futura v4 degli artifact il commento indica il fork `code.forgejo.org/forgejo/upload-artifact@v4`, perché `actions/upload-artifact@v4` fallisce su Forgejo con `GHESNotSupportedError`; + - variabile del repository `SITE_URL` passata a build e test di CI e release (D-051). + + I due job sono stati eseguiti in locale negli stessi container del runner (Playwright 1.56.1 noble come root, node:24): verdi, `verify` in circa 6 minuti. Il runner non è stato configurato: decisione rimandata dal manutentore. + +- **Alternative scartate:** `actions/upload-artifact@v4` (non funziona su Forgejo); il controllo dei link esterni in un workflow pianificato (si perderebbe il controllo a ogni push). +- **Motivazione:** la CI deve diventare verde appena un runner con label `docker` è online, senza altre correzioni. + +## D-046 — Release: pubblicazione dopo i file e controllo del tag nel ripiego REST + +- **Data:** 2026-10-16 +- **Contesto:** `scripts/release-upload.sh`: + - creava la release già pubblicata prima di caricare i file; + - lasciava in bozza una release creata dall'action fallita a metà; + - cancellava un file prima di caricare il nuovo; + - non verificava il tag (senza tag Forgejo lo crea sulla punta del branch predefinito). + + Inoltre il tar.gz cambiava impronta tra Windows e Linux, perché l'header gzip registra il sistema operativo. + +- **Scelta:** + - release nuova: bozza, file, poi pubblicazione con titolo e note del CHANGELOG; + - release esistente, anche in bozza: caricamento del nuovo file, cancellazione del vecchio, pubblicazione; + - tag verificato sul server e confrontato con quello locale; + - byte 9 dell'header gzip fissato a 3. + + Provato contro un'API simulata in 7 scenari: release nuova, bozza, release pubblicata, tag mancante, tag diverso, errore di caricamento su release nuova e su release pubblicata. + +- **Alternative scartate:** chiedere una conferma (es. `FORCE=1`) per sostituire i file di una release pubblicata. È il comportamento documentato, e ora la sostituzione non lascia mai la release senza un file. +- **Motivazione:** nessuna release pubblicata senza file o con il tag sul commit sbagliato; pacchetto identico su ogni piattaforma a parità di versione di Node.js. + +## D-047 — Deploy automatico di esempio: evento, ultima release e percorsi protetti + +- **Data:** 2026-10-16 +- **Contesto:** l'action forgejo-release pubblica la release passando da bozza a pubblicata, e Forgejo notifica il passaggio come «edited». L'esempio ascoltava solo «published» e quindi non partiva. Non escludeva le pre-release, e con un segreto `DEPLOY_PATH` mancante `rsync --delete` avrebbe sincronizzato la radice del server. +- **Scelta:** + - eventi `published` ed `edited`; + - un job «controllo» lascia proseguire solo una release stabile che sia l'ultima pubblicata e, per «edited», solo se i file sono stati caricati nell'ultima ora (la pubblicazione di release.yml o di release-upload.sh): una modifica successiva di titolo o note, anche dell'ultima release, non avvia il deploy; l'avvio manuale procede sempre; + - se l'API delle release non risponde lo step fallisce, invece di saltare il deploy in silenzio; + - download con il token automatico; dominio per il controllo finale dalla variabile `SITE_URL` o da `BUILD-INFO.txt`; + - controlli su `DEPLOY_PATH`, `FTP_PATH` e `RCLONE_DEST`; per rsync, sincronizzazione solo se nella cartella c'è il file di conferma `.deploy-studio-grasso`, creato a mano una volta. +- **Alternative scartate:** un job di deploy dentro release.yml attivato da una variabile: più robusto, ma porta nel workflow attivo segreti e varianti commentate. Scartato anche il solo evento `published`, che con l'action non scatta. +- **Motivazione:** l'esempio deve funzionare quando viene attivato, non deve ripubblicare versioni per una semplice modifica delle note e non deve poter sincronizzare con `--delete` una cartella diversa da quella del sito (per FTP la guida avverte di non indicare la radice dell'account). + +## D-048 — Browser supportati dal CSS generato + +- **Data:** 2026-10-16 +- **Contesto:** Astro imposta `build.target: 'esnext'`, quindi il minificatore (lightningcss) lavorava senza browser di riferimento. Scriveva le media query in sintassi a intervallo `(width<=60em)`, che Safari e iOS ignorano prima della 16.4: niente layout mobile su iPhone fermi a iOS 15. Scartava inoltre `backdrop-filter` scritto prima della forma con prefisso. +- **Scelta:** + - `vite.build.cssTarget: ['chrome107', 'edge107', 'firefox104', 'safari15', 'ios15']`; + - in Header.astro solo la forma standard di `backdrop-filter` (il prefisso lo aggiunge lightningcss); + - check-compliance verifica che non ci siano media query a intervallo e che `-webkit-backdrop-filter` sia sempre accompagnato dalla forma standard. +- **Alternative scartate:** `browserslist` in package.json (il CSS minificato da Vite segue `cssTarget`); la sintassi a intervallo, che esclude iOS 15. +- **Motivazione:** il sito deve funzionare anche sui telefoni che non si aggiornano oltre iOS 15. + +## D-049 — Anello di focus con contrasto misurato + +- **Data:** 2026-10-16 +- **Contesto:** l'anello oro `--gold-500` aveva un contrasto di 2,68–2,97:1 sui fondi chiari (WCAG 1.4.11 chiede 3:1). Il test verificava solo che l'outline ci fosse. +- **Scelta:** + - token `--focus-ring`: `--gold-700` sui fondi chiari (almeno 4,28:1); + - `--gold-500` nei contenitori navy con elementi focalizzabili (barra superiore, footer, banda CTA, riquadro delle pagine dei servizi), dove `--gold-700` arriverebbe a 2,9:1; + - il test da tastiera calcola il contrasto tra l'anello e il fondo (anche semitrasparente o a gradiente), esige almeno 3:1 e copre anche una pagina di servizio. +- **Alternative scartate:** un doppio anello oro e navy, più invasivo nel design. +- **Motivazione:** conformità AA mantenendo il «focus visibile oro» del brief (§6.3). + +## D-050 — Bersagli touch: 44 px sui controlli principali, deroga per percorso e barra superiore + +- **Data:** 2026-10-16 +- **Contesto:** il brief (§9.5) chiede bersagli touch di almeno 44 px. Restavano sotto: + - la freccia del sottomenu (32 px); + - i link di telefono, e-mail e PEC nei recapiti (circa 29 px); + - i link del footer su mobile (circa 33 px); + - i link del percorso e della barra superiore (testo da 13 px). + + Il «ponte» invisibile del sottomenu copriva inoltre la parte bassa delle voci vicine, con clic a vuoto. + +- **Scelta:** + - 44 px per freccia del sottomenu, recapiti e link del footer su mobile; + - ponte eliminato: il sottomenu tocca già la voce e sta dentro il suo `
  • `; + - deroga per i link del percorso e della barra superiore (solo desktop): sono navigazione secondaria, le stesse destinazioni hanno bersagli da 44 px (menu principale, footer, pagina Contatti) e rispettano i 24 px di WCAG 2.2 (2.5.8). +- **Alternative scartate:** percorso e barra superiore a 44 px, che cambierebbero l'altezza della testata delle pagine e della barra rispetto ai mockup. +- **Motivazione:** le azioni principali da telefono (chiamare, scrivere, aprire il sottomenu) hanno bersagli comodi senza stravolgere il design. + +## D-051 — Dati da un'unica fonte e controlli che leggono i dati + +- **Data:** 2026-10-16 +- **Contesto:** alcuni controlli confrontavano valori scritti a mano: orari, esattamente 6 servizi, l'e-mail, etichette e titoli. Alcune modifiche indicate in docs/CONTENUTI.md facevano quindi fallire `verify` con il sito corretto. Erano duplicati non derivati: + - i giorni di apertura del JSON-LD; + - la ricerca per indirizzo e il titolo delle mappe; + - il numero breve dell'intestazione; + - il dominio, ripetuto in cinque file. +- **Scelta:** + - `orari.giorniSettimana` in studio.ts; + - `mapQuery`, `mapTitle` e `telNational` in format.ts (riproducono esattamente i valori precedenti); + - `site.config.mjs` come unica fonte del dominio; + - controlli e test che leggono studio.ts, testi.ts, pagine.ts e navigazione.ts; + - servizi: almeno i 6 del brief, verificati per slug e ancora del vecchio sito, con slug e ancore univoci. + + check-compliance controlla inoltre: + - «commercialista» anche in meta, attributi e JSON-LD; + - le direttive del .htaccess solo su righe attive; HSTS commentato, oppure attivo con `HSTS_ATTIVO = true` nello stesso script (scelta esplicita, documentata in DEPLOY.md); + - `contact.php` presente solo in modalità `php`; + - nessun contenuto dopo `` (lo script di `/servizi/` era fuori dal layout). + +- **Alternative scartate:** documentare quali test aggiornare a ogni modifica dei contenuti. +- **Motivazione:** `verify` deve fallire solo per difetti reali (D-044), e le modifiche descritte in CONTENUTI.md devono funzionare. + +## D-052 — Modulo di contatto: stesse regole nel browser e in contact.php + +- **Data:** 2026-10-16 +- **Contesto:** con il modulo attivo il browser accettava valori che contact.php rifiutava: campi di soli spazi, e-mail senza dominio completo, testi vicini al limite con gli a capo contati due volte (CRLF). Gli altri problemi: + - il tempo minimo confrontava l'orologio del dispositivo con quello del server; + - il corpo dell'e-mail era in 8bit con righe di lunghezza illimitata, che i server di posta rifiutano oltre 998 byte; + - l'oggetto era codificato in un'unica parola; + - i messaggi d'errore non indicavano il requisito; + - due stili con scope non raggiungevano i contenuti generati; + - la modalità si attivava modificando un'espressione (e il lint falliva). +- **Scelta:** + - validazione con `trim`, lunghezza minima in caratteri come `mb_strlen` (un'emoji vale 1) e un `pattern` dell'e-mail allineato a `FILTER_VALIDATE_EMAIL` nei casi comuni (parte locale fino a 64 caratteri, punto nel dominio, ultimo segmento che inizia con una lettera); + - campo `ts_invio`, così la durata è misurata con un solo orologio; calcolo in virgola mobile, perché con PHP a 32 bit i millisecondi superano `PHP_INT_MAX`; + - a capo normalizzati prima di misurare; + - corpo in quoted-printable; + - oggetto in parole RFC 2047 di al massimo 75 caratteri; + - messaggi con il requisito (`{min}`); + - `:global()` per gli stili dei contenuti generati; + - costante `MODALITA_PREDEFINITA` in studio.ts. + + Provato con PHP 7.4 e 8.3: 23 controlli superati, mentre con il gestore precedente ne falliscono 11. + +- **Alternative scartate:** sostituire `ts` con la sola durata scritta all'invio: un programma che chiama `form.submit()` non genera l'evento e passerebbe il controllo. +- **Motivazione:** nessuna richiesta rifiutata dal server dopo che il browser l'ha accettata, e nessuna e-mail respinta dal server di posta. + +## D-053 — nginx: header di sicurezza in un solo punto + +- **Data:** 2026-10-16 +- **Contesto:** in nginx un `add_header` dentro una `location` annulla tutti quelli ereditati. HSTS, una volta decommentato, non arrivava a pagine e asset, e la CSP era ripetuta in due punti. +- **Scelta:** nessun `add_header` nelle `location`; Cache-Control da una `map` sull'indirizzo (senza `always`, così le risposte d'errore non vengono messe in cache); la riga HSTS commentata anche nel blocco HTTPS del dominio senza «www», da attivare insieme a quella principale. Verificato con nginx:stable in Docker: `nginx -t`, header di pagine, asset, icone, sitemap, 404 e redirect; con HSTS attivato, HSTS su tutte le risposte, compreso il redirect dal dominio senza «www». +- **Alternative scartate:** uno snippet con gli header incluso in ogni `location`, che richiede di installare due file. +- **Motivazione:** la configurazione deve essere davvero equivalente al .htaccess, che applica gli header a ogni risposta. + +## D-054 — Avvio in debug con VS Code + +- **Data:** 2026-10-16 +- **Contesto:** il manutentore ha chiesto di poter avviare il sito in debug per vederlo. +- **Scelta:** + - `.vscode/launch.json`: sviluppo con Edge o con Chrome, e anteprima della build (con il task `Sito: build` di `.vscode/tasks.json`); + - Node lancia `astro.mjs` con `outputCapture: "std"`, perché il logger di Astro scrive direttamente su stdout; + - `serverReadyAction` apre il browser con il debugger collegato (`debugWithEdge`/`debugWithChrome`, `killOnServerStop`), con un pattern che ignora i codici colore ANSI (su Windows Astro li scrive sempre, anche senza terminale); + - `.gitignore` versiona `launch.json` e `tasks.json`. +- **Alternative scartate:** una configurazione composta server + browser, in cui il browser partirebbe prima che il server sia pronto. +- **Motivazione:** con F5 si apre il sito con i punti di interruzione attivi, senza comandi da ricordare. + +## D-055 — Intestazione desktop: voci su una riga e numero di telefono da 1140 px + +- **Data:** 2026-10-16 +- **Contesto:** durante il controllo visivo delle correzioni è emerso un difetto preesistente. Vicino ai punti di interruzione le etichette del menu desktop («Lo studio», «Dove siamo», «Link utili») andavano a capo su due righe: tra 961 e circa 980 px, e tra 1101 e circa 1120 px, dove compare il numero di telefono. La freccia del sottomenu portata a 44 px (D-050) allargava la prima fascia fino a circa 1000 px. +- **Scelta:** + - `white-space: nowrap` sulle voci del menu; + - numero di telefono dell'intestazione da 71.25em (1140 px), perché sotto circa 1120 px non c'è spazio senza comprimere nulla (misurato pixel per pixel; il margine copre le differenze di resa dei caratteri); + - icona del telefono non comprimibile; + - tra 960 e 1020 px (63.75em) voci e spazio tra logo e menu più compatti: con le voci su una riga, lo spazio mancante ricadeva tutto sul logo, che andava a capo (con la barra di scorrimento classica di Windows anche il nome). + + Misura dopo la correzione, con e senza barra di scorrimento: da 961 a 1400 px voci, numero, pulsante, nome e sottotitolo del logo su una riga, nessuna icona schiacciata e nessuno scorrimento orizzontale. + +- **Alternative scartate:** ridurre la spaziatura delle voci (cambia il design a tutte le larghezze); spostare il passaggio al menu mobile oltre i 960 px (punto di interruzione condiviso da molti componenti, D-028). +- **Motivazione:** intestazione ordinata a ogni larghezza desktop, senza cambiare il design alle larghezze comuni. diff --git a/README.md b/README.md index 852d371..03ae070 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,17 @@ npm run verify # tutti i controlli di qualità (gli stessi della CI) npm run package # crea il pacchetto di rilascio in release/ ``` +### Avvio in debug con VS Code + +Dopo `npm ci`, aprire il pannello **Esegui e debug** (Ctrl+Maiusc+D), scegliere una configurazione e premere **F5**: + +| Configurazione | Cosa fa | +| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `Sito: sviluppo (Edge)` / `(Chrome)` | `astro dev` con il debugger di Node; quando il server è pronto apre il browser con il debugger collegato (punti di interruzione negli script di `src/scripts/`) | +| `Sito: anteprima della build (Edge)` | esegue `npm run build` e serve `dist/` come in produzione su | + +Maiusc+F5 ferma il server e chiude il browser quando è selezionata la sessione del server, come all'avvio. Dopo una pausa su un punto di interruzione nel browser è selezionata la sessione del browser, e Maiusc+F5 chiude solo quella: premerlo una seconda volta, oppure usare Stop sulla sessione «Sito: sviluppo» nel pannello dello stack di chiamate. Le configurazioni sono in [`.vscode/launch.json`](.vscode/launch.json) e [`.vscode/tasks.json`](.vscode/tasks.json). Astro avvia un solo server di sviluppo per progetto: se `npm run dev` è già aperto in un terminale, chiuderlo prima di premere F5. + ## Comandi | Comando | Cosa fa | @@ -64,25 +75,41 @@ scripts/ script di test, pacchetto, icone, note di rilascio, upload de tests/ e2e/ e a11y/ (Playwright), helpers/ deploy/ nginx.conf.example, optional-php-form/contact.php, esempio di deploy automatico .forgejo/workflows ci.yml (verifica) e release.yml (pubblicazione della release) +.vscode/ launch.json e tasks.json: avvio del sito in debug (F5) docs/ brief, mockup, guide di deploy e contenuti, conformità +site.config.mjs dominio pubblico del sito (unica fonte per build, test e pacchetto) ``` ## Configurazione -| Impostazione | Dove | Valore predefinito | -| --------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------- | -| Dominio del sito (canonical, sitemap, robots, dati strutturati) | variabile d'ambiente `SITE_URL` | `https://www.grassoezio.it` | -| Modulo di contatto: `off`, `php`, `endpoint` | `contactForm.mode` in `src/data/studio.ts`, oppure variabile `CONTACT_FORM_MODE` | `off` (card «Scrivici una e-mail») | -| Data riproducibile (anno nel footer, date negli archivi) | variabile `SOURCE_DATE_EPOCH` | ora corrente / data dell'ultimo commit | +| Impostazione | Dove | Valore predefinito | +| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------- | +| Dominio del sito (canonical, sitemap, robots, dati strutturati) | `site.config.mjs`, oppure variabile `SITE_URL` (in CI: variabile del repository `SITE_URL`) | `https://www.grassoezio.it` | +| Modulo di contatto: `off`, `php`, `endpoint` | `MODALITA_PREDEFINITA` in `src/data/studio.ts`, oppure variabile `CONTACT_FORM_MODE` | `off` (card «Scrivici una e-mail») | +| Data riproducibile (anno nel footer, date negli archivi) | variabile `SOURCE_DATE_EPOCH` | ora corrente / data dell'ultimo commit | -Esempio: `SITE_URL=https://studiograssoezio.it npm run build`. +Le variabili valgono per tutti i comandi della sessione (build, `verify`, `package`), non solo per la build. Esempio, nel terminale di VS Code (PowerShell): -Per verificare il modulo attivo (validazione, anti-spam, pagina di conferma): - -```bash -CONTACT_FORM_MODE=php npm run build && npx playwright test tests/e2e/form.spec.ts && npm run build +```powershell +$env:SITE_URL = 'https://studiograssoezio.it' +npm run verify +Remove-Item Env:SITE_URL ``` +In Git Bash, macOS o Linux: `SITE_URL=https://studiograssoezio.it npm run verify`. Per un cambio di dominio definitivo modificare invece il valore in `site.config.mjs`, oppure la variabile del repository `SITE_URL` su Forgejo (Impostazioni → Actions → Variabili), che CI e release usano per la build. + +Per verificare il modulo attivo (validazione, anti-spam, pagina di conferma), in PowerShell: + +```powershell +$env:CONTACT_FORM_MODE = 'php' +npm run build +npx playwright test tests/e2e/form.spec.ts +Remove-Item Env:CONTACT_FORM_MODE +npm run build # ripristina la versione senza modulo +``` + +In Git Bash, macOS o Linux: `CONTACT_FORM_MODE=php npm run build && npx playwright test tests/e2e/form.spec.ts && npm run build`. + ## Pubblicare il repository su Forgejo Questo repository è un clone di `https://forgejo.encke-hake.ts.net/BalboSoft/Studio_Grasso.git`: il remote `origin` è già configurato. Per un repository nuovo: `git remote add origin `. @@ -109,7 +136,7 @@ La CI richiede un **runner Forgejo Actions** con label `docker` (modificabile in Il workflow `release.yml` verifica che tag, `package.json` e CHANGELOG coincidano, esegue `npm run verify` e `npm run package` e pubblica nella sezione **Release** del repository: `sito-studio-grasso-vX.Y.Z.zip`, `.tar.gz`, `SHA256SUMS.txt`, `BUILD-INFO.txt`. -**Token:** su alcune istanze il token automatico dei workflow non può creare release. In quel caso creare un _access token_ (Impostazioni utente → Applicazioni → Genera nuovo token, permesso **`write:repository`**) e salvarlo come segreto del repository con nome **`FORGEJO_TOKEN`** (Impostazioni del repository → Actions → Segreti): il workflow lo usa automaticamente. Se l'istanza rifiuta i nomi che iniziano con `FORGEJO_`, chiamarlo **`RELEASE_TOKEN`**. Lo stesso token serve per avviare in automatico il deploy facoltativo (`docs/DEPLOY.md`, sezione 9). +**Token:** per impostazione predefinita la release è pubblicata con il token automatico del workflow, che su Forgejo ha il permesso di scrittura sul repository. Per usare un token personale (necessario per avviare in automatico il deploy facoltativo, `docs/DEPLOY.md` sezione 9, perché le modifiche fatte con il token automatico non avviano altri workflow) creare un _access token_ (Impostazioni utente → Applicazioni → Genera nuovo token, permesso **`write:repository`**) e salvarlo come segreto del repository **`RELEASE_TOKEN`** (Impostazioni del repository → Actions → Segreti): il workflow lo usa al posto di quello automatico. Non usare nomi che iniziano con `FORGEJO_`, `GITEA_` o `GITHUB_`: Forgejo li riserva, e `secrets.FORGEJO_TOKEN` è sempre il token automatico. Il workflow pubblica la release con l'action `forgejo-release`; se l'action non riesce, lo step successivo la pubblica con l'API REST (`scripts/release-upload.sh`, solo `curl` e `node`). Lo stesso script serve anche a mano (istruzioni in testa al file e in `docs/DEPLOY.md`). diff --git a/TODO-STUDIO.md b/TODO-STUDIO.md index bfdd4a8..20c6e95 100644 --- a/TODO-STUDIO.md +++ b/TODO-STUDIO.md @@ -12,16 +12,16 @@ Dopo ogni modifica: `npm run verify`, poi commit e nuova release (vedi `docs/CON La PEC `studiotributariograssosrl@pec.it` fa pensare a una società («Studio Tributario Grasso S.r.l.»), ma il dato **non è confermato**. Serve: -- denominazione esatta del titolare della P.IVA 01597790052 → `src/data/studio.ts`, riga 119 (`titolare.denominazione`); -- codice fiscale, se diverso dalla P.IVA → `src/data/studio.ts`, riga 120 (`titolare.codiceFiscale`). +- denominazione esatta del titolare della P.IVA 01597790052 → `src/data/studio.ts`, riga 131 (`titolare.denominazione`); +- codice fiscale, se diverso dalla P.IVA → `src/data/studio.ts`, riga 132 (`titolare.codiceFiscale`). -Se il titolare è una **società**, l'art. 2250 c.c. impone di indicare nel sito anche (righe 128–133 di `src/data/studio.ts`, oggetto `datiSocietari`): +Se il titolare è una **società**, l'art. 2250 c.c. impone di indicare nel sito anche (righe 140–145 di `src/data/studio.ts`, oggetto `datiSocietari`): -- sede legale (`sedeLegale`), riga 128; -- ufficio del Registro delle Imprese (`ufficioRegistroImprese`), riga 129, e numero REA (`numeroRea`), riga 130; -- capitale sociale versato (`capitaleSociale`, es. `'€ 10.000,00 i.v.'`), riga 131; -- eventuale socio unico (`socioUnico: true`), riga 132; -- eventuale stato di liquidazione (`inLiquidazione: true`), riga 133. +- sede legale (`sedeLegale`), riga 140; +- ufficio del Registro delle Imprese (`ufficioRegistroImprese`), riga 141, e numero REA (`numeroRea`), riga 142; +- capitale sociale versato (`capitaleSociale`, es. `'€ 10.000,00 i.v.'`), riga 143; +- eventuale socio unico (`socioUnico: true`), riga 144; +- eventuale stato di liquidazione (`inLiquidazione: true`), riga 145. I dati compaiono da soli nel footer di ogni pagina, nelle Note legali, nella Privacy policy e nei dati strutturati. @@ -29,13 +29,13 @@ I dati compaiono da soli nel footer di ogni pagina, nelle Note legali, nella Pri La Privacy policy cita il fornitore di hosting come responsabile del trattamento e la conservazione dei log del server «per il periodo previsto dalle politiche del fornitore». Appena scelto l'hosting: -- nome del fornitore → `src/data/studio.ts`, riga 211 (`fornitori.hosting`, es. `'Aruba S.p.A.'`); -- durata di conservazione dei log → riga 212 (`fornitori.conservazioneLog`, es. `'12 mesi'`); -- **verificare con i fornitori di hosting, posta elettronica e PEC che i dati siano conservati nello Spazio economico europeo.** Solo dopo la verifica impostare `fornitori.soloSee: true` (riga 215): la Privacy policy dirà che lo Studio non trasferisce dati fuori dallo SEE. Finché resta `false`, la Privacy policy indica le garanzie previste per eventuali trasferimenti (artt. 45–46 GDPR); se un fornitore conserva i dati fuori dallo SEE (es. alcuni servizi di posta statunitensi), farsi indicare la garanzia applicata e farla riportare dal consulente privacy. +- nome del fornitore → `src/data/studio.ts`, riga 218 (`fornitori.hosting`, es. `'Aruba S.p.A.'`); +- durata di conservazione dei log → riga 219 (`fornitori.conservazioneLog`, es. `'12 mesi'`); +- **verificare con i fornitori di hosting, posta elettronica e PEC che i dati siano conservati nello Spazio economico europeo.** Solo dopo la verifica impostare `fornitori.soloSee: true` (riga 222): la Privacy policy dirà che lo Studio non trasferisce dati fuori dallo SEE. Finché resta `false`, la Privacy policy indica le garanzie previste per eventuali trasferimenti (artt. 45–46 GDPR); se un fornitore conserva i dati fuori dallo SEE (es. alcuni servizi di posta statunitensi), farsi indicare la garanzia applicata e farla riportare dal consulente privacy. ### B3. Dominio definitivo del nuovo sito -Il sito è costruito per `https://www.grassoezio.it` (canonical, sitemap, robots.txt, dati strutturati). Se il dominio sarà diverso (es. `studiograssoezio.it`), impostare la variabile `SITE_URL` nella build (README, «Configurazione») oppure cambiare il valore predefinito in `astro.config.mjs`, riga 27. Nel `.htaccess` (`public/.htaccess`, sezione «Redirect», punto 2) decommentare la regola www/non-www coerente con il dominio scelto. +Il sito è costruito per `https://www.grassoezio.it` (canonical, sitemap, robots.txt, dati strutturati). Se il dominio sarà diverso (es. `studiograssoezio.it`), cambiare il valore predefinito in `site.config.mjs`, riga 9 (vale per build, controlli e pacchetto), oppure impostare la variabile del repository `SITE_URL` su Forgejo (Impostazioni → Actions → Variabili), che CI e release usano per la build. In locale la variabile `SITE_URL` va impostata per tutti i comandi (`npm run verify`, `npm run package`), non solo per la build (README, «Configurazione»). Nel `.htaccess` (`public/.htaccess`, sezione «Redirect», punto 2) decommentare la regola www/non-www coerente con il dominio scelto. ### B4. Validazione dei testi legali @@ -54,7 +54,7 @@ Il sito pubblica la PEC personale `giuliagrasso@pec.commercialisti.it` (footer, - lo Studio e la professionista sono contitolari, con un accordo ai sensi dell'art. 26 GDPR; - la professionista è titolare autonoma dei messaggi ricevuti sulla propria casella. -Poi far completare il paragrafo nella Privacy policy (`src/content/legali/privacy-policy.md`, righe 18–22, blocco `se:pecProfessionisti`). Se la PEC personale non deve comparire sul sito, toglierla da `src/data/studio.ts` (riga 147, `pec`, e riga 304, `pec` della professionista): il paragrafo scompare da solo. +Poi far completare il paragrafo nella Privacy policy (`src/content/legali/privacy-policy.md`, righe 18–22, blocco `se:pecProfessionisti`). Se la PEC personale non deve comparire sul sito, toglierla da `src/data/studio.ts` (righe 156–159, voce `giuliagrasso@pec.commercialisti.it` dell'elenco `pec`, e riga 311, `pec` della professionista): il paragrafo scompare da solo. --- @@ -73,38 +73,38 @@ Sono stati applicati ai contenuti; confermare che corrispondano all'attività at | Bonus energia / gas con i comuni convenzionati | Bonus sociale luce e gas riconosciuto automaticamente con DSU/ISEE | `src/content/servizi/centro-autorizzato-caf.md` | | 8 e 5 per mille da CUD, 2 per mille ai partiti | Scelta dell'8, del 5 e del 2 per mille tramite Certificazione Unica | `src/content/servizi/centro-autorizzato-caf.md` | | Modello ISE – ISEE | DSU per l'ISEE | `src/content/servizi/centro-autorizzato-caf.md` | -| Camera di Commercio di Asti | Camera di Commercio di Alessandria-Asti (sede di Asti) | `src/data/studio.ts` righe 269 e 379, `src/content/servizi/certificazione-atti-firma-digitale.md`, `src/content/link-utili.json` | +| Camera di Commercio di Asti | Camera di Commercio di Alessandria-Asti (sede di Asti) | `src/data/studio.ts` righe 276 e 392, `src/content/servizi/certificazione-atti-firma-digitale.md`, `src/content/link-utili.json` | | Smart card | Dispositivi di firma digitale (smart card / token) | `src/content/servizi/certificazione-atti-firma-digitale.md` | | Cap. Gain | capital gain | `src/content/servizi/consulenza-fiscale-tributaria-e-societaria.md` | | Copyright 2016 | anno corrente generato a ogni build | `src/components/Footer.astro` | ### C2. Confermare la dicitura del Ruolo dei Periti e degli Esperti -Il Ruolo era tenuto dalla Camera di Commercio di Asti, accorpata il 1° ottobre 2020 nella Camera di Commercio di Alessandria-Asti. È stata usata la dicitura «Camera di Commercio di Alessandria-Asti (sede di Asti)»: confermare o correggere in `src/data/studio.ts`, righe 269 (qualifiche del Dott. Ezio Grasso) e 379 (abilitazioni). +Il Ruolo era tenuto dalla Camera di Commercio di Asti, accorpata il 1° ottobre 2020 nella Camera di Commercio di Alessandria-Asti. È stata usata la dicitura «Camera di Commercio di Alessandria-Asti (sede di Asti)»: confermare o correggere in `src/data/studio.ts`, righe 276 (qualifiche del Dott. Ezio Grasso) e 392 (abilitazioni). ### C3. Confermare la dicitura dell'abilitazione MEF -È riportata come nel sito attuale: «… iscritto al numero 12, sezione 1» (`src/data/studio.ts`, righe 268 e 355). Verificare che numero e sezione siano corretti e attuali. +È riportata come nel sito attuale: «… iscritto al numero 12, sezione 1» (`src/data/studio.ts`, righe 275 e 368). Verificare che numero e sezione siano corretti e attuali. ### C4. Telefono della sede di Asti -Il vecchio sito non associa i due numeri (+39 0141 951382 e +39 0141 1762214) a una sede specifica: il nuovo sito li indica come recapiti dello Studio e, per Asti, invita a fissare l'appuntamento al numero principale. Se il secondo numero è quello della sede di Asti, aggiungere alla sede di Asti in `src/data/studio.ts` (riga 174, oggetto con `id: 'asti'`) il campo `telefono: { display: '+39 0141 1762214', e164: '+3901411762214' },`: pulsante «Chiama» e invito all'appuntamento lo useranno da soli. +Il vecchio sito non associa i due numeri (+39 0141 951382 e +39 0141 1762214) a una sede specifica: il nuovo sito li indica come recapiti dello Studio e, per Asti, invita a fissare l'appuntamento al numero principale. Se il secondo numero è quello della sede di Asti, aggiungere alla sede di Asti in `src/data/studio.ts` (riga 182, oggetto con `id: 'asti'`) il campo `telefono: { display: '+39 0141 1762214', e164: '+3901411762214' },`: pulsante «Chiama» e invito all'appuntamento lo useranno da soli. ### C5. Termine di conservazione delle richieste di contatto -La Privacy policy indica la conservazione delle richieste per al massimo **12 mesi** dall'ultimo contatto (salvo incarico). Confermare o modificare in `src/data/studio.ts`, riga 217 (`conservazioneRichieste`). +La Privacy policy indica la conservazione delle richieste per al massimo **12 mesi** dall'ultimo contatto (salvo incarico). Confermare o modificare in `src/data/studio.ts`, riga 224 (`conservazioneRichieste`). ### C6. Fornitore della posta elettronica -Facoltativo: il nome del fornitore della casella `info@studiograssoezio.it` (responsabile del trattamento) può essere indicato in `src/data/studio.ts`, riga 213 (`fornitori.posta`). +Facoltativo: il nome del fornitore della casella `info@studiograssoezio.it` (responsabile del trattamento) può essere indicato in `src/data/studio.ts`, riga 220 (`fornitori.posta`). ### C7. Polizza di responsabilità civile professionale -L'obbligo è comunicarne gli estremi al cliente (art. 9, co. 4, D.L. 1/2012), non pubblicarli. Se lo Studio desidera indicarla nelle Note legali, compilare `polizzaRc` (es. `'Compagnia X, polizza n. 123'`) in `src/data/studio.ts`, righe 285 (Dott. Ezio Grasso) e 305 (Dott.ssa Giulia Grasso). +L'obbligo è comunicarne gli estremi al cliente (art. 9, co. 4, D.L. 1/2012), non pubblicarli. Se lo Studio desidera indicarla nelle Note legali, compilare `polizzaRc` (es. `'Compagnia X, polizza n. 123'`) in `src/data/studio.ts`, righe 292 (Dott. Ezio Grasso) e 312 (Dott.ssa Giulia Grasso). ### C8. Modulo di contatto -Per impostazione predefinita il modulo è **disattivato** (`contactForm.mode = 'off'`, `src/data/studio.ts` riga 335): al suo posto c'è il pulsante per scrivere un'e-mail. Se l'hosting supporta PHP e lo Studio vuole il modulo, impostare `'php'` e seguire `docs/DEPLOY.md` («Modulo di contatto»). Con un servizio esterno (`'endpoint'`) serve anche il nome e la sede del fornitore in `fornitori.modulo` (riga 214): senza, la build si ferma. La Privacy policy, la pagina Accessibilità e l'informativa breve del modulo si aggiornano da sole. +Per impostazione predefinita il modulo è **disattivato** (`MODALITA_PREDEFINITA = 'off'`, `src/data/studio.ts` riga 334): al suo posto c'è il pulsante per scrivere un'e-mail. Se l'hosting supporta PHP e lo Studio vuole il modulo, impostare `'php'` in quella costante e seguire `docs/DEPLOY.md` («Modulo di contatto»). Con un servizio esterno (`'endpoint'`) serve anche il nome e la sede del fornitore in `fornitori.modulo` (riga 221): senza, la build si ferma. La Privacy policy, la pagina Accessibilità e l'informativa breve del modulo si aggiornano da sole. ### C9. Foto e loghi @@ -125,4 +125,4 @@ Come previsto dal brief, la home (`src/data/pagine.ts`, riga 42, riquadro «Assi ### C13. Stato in cui è stato conseguito il titolo professionale -Per le professioni regolamentate l'art. 7, lett. f, D.Lgs. 70/2003 chiede di indicare anche lo Stato in cui è stato rilasciato il titolo. Il dato non è nel vecchio sito: se lo Studio lo conferma, compilare `statoTitolo` (es. `'Italia'`) in `src/data/studio.ts`, riga 306 (Dott.ssa Giulia Grasso). Il dato compare nelle Note legali, nella scheda della professionista. +Per le professioni regolamentate l'art. 7, lett. f, D.Lgs. 70/2003 chiede di indicare anche lo Stato in cui è stato rilasciato il titolo. Il dato non è nel vecchio sito: se lo Studio lo conferma, compilare `statoTitolo` (es. `'Italia'`) in `src/data/studio.ts`, riga 313 (Dott.ssa Giulia Grasso). Il dato compare nelle Note legali, nella scheda della professionista. diff --git a/astro.config.mjs b/astro.config.mjs index 3292e71..c7d2982 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -3,6 +3,7 @@ import { rm, rmdir } from 'node:fs/promises'; import { fileURLToPath } from 'node:url'; import sitemap from '@astrojs/sitemap'; import { defineConfig } from 'astro/config'; +import { siteUrl } from './site.config.mjs'; /** * public/images/README.md è documentazione per lo Studio (immagini da fornire): resta nel @@ -20,11 +21,8 @@ const dropRepoDocs = { }, }; -/** - * URL pubblico del sito. Si imposta con la variabile d'ambiente SITE_URL - * (es. `SITE_URL=https://www.esempio.it npm run build`). Default: dominio attuale. - */ -const site = (process.env.SITE_URL || 'https://www.grassoezio.it').replace(/\/+$/, ''); +/** URL pubblico del sito: valore predefinito in site.config.mjs, oppure variabile SITE_URL. */ +const site = siteUrl(); export default defineConfig({ site, @@ -49,6 +47,11 @@ export default defineConfig({ build: { // Nessuno script inline: la CSP consente solo `script-src 'self'`. assetsInlineLimit: 0, + // Browser supportati dal CSS generato. Astro imposta `build.target: 'esnext'` e senza + // questa riga il minificatore (lightningcss) scrive le media query in sintassi a + // intervallo «(width<=60em)», ignorata da Safari/iOS < 16.4 (layout mobile rotto), e non + // aggiunge i prefissi necessari (es. -webkit-backdrop-filter). Vedi DECISIONS.md. + cssTarget: ['chrome107', 'edge107', 'firefox104', 'safari15', 'ios15'], }, }, }); diff --git a/deploy/forgejo-deploy.yml.example b/deploy/forgejo-deploy.yml.example index ac810af..ef11061 100644 --- a/deploy/forgejo-deploy.yml.example +++ b/deploy/forgejo-deploy.yml.example @@ -6,11 +6,19 @@ # e creare i segreti del repository indicati (Impostazioni → Actions → Segreti). # Istruzioni complete in docs/DEPLOY.md, sezione «Deploy automatico». # -# Si avvia quando una release viene pubblicata (dal workflow release.yml) oppure a mano -# (workflow_dispatch, indicando il tag). Pubblica il pacchetto della release, già verificato. -# ATTENZIONE: l'avvio automatico funziona solo se release.yml pubblica la release con un token -# personale (segreto FORGEJO_TOKEN o RELEASE_TOKEN): gli eventi creati con il token automatico -# del workflow non avviano altri workflow. Senza il segreto, avviarlo a mano dalla scheda Actions. +# Si avvia quando release.yml pubblica una release stabile oppure a mano (workflow_dispatch, +# indicando il tag: serve anche per tornare a una versione precedente). Pubblica il pacchetto +# della release, già verificato. +# - Evento: l'action forgejo-release crea la release in bozza e poi la pubblica, e Forgejo +# notifica questo passaggio come «edited», non come «published». Per questo si ascoltano +# entrambi, e il job «controllo» procede solo per una release stabile che sia l'ultima +# pubblicata e, per «edited», solo se i file sono stati caricati nell'ultima ora (cioè è la +# pubblicazione fatta da release.yml o da scripts/release-upload.sh). Modificare in seguito +# titolo o note di una release, anche l'ultima, non avvia il deploy. Dopo un ritorno manuale +# a una versione precedente segnare come pre-release la versione ritirata. +# - Token: l'avvio automatico funziona solo se release.yml pubblica la release con un token +# personale (segreto RELEASE_TOKEN): le modifiche fatte con il token automatico non avviano +# altri workflow. Senza il segreto, avviarlo a mano dalla scheda Actions. # I file gestiti dall'hosting (.well-known/, .user.ini, cgi-bin/) sono esclusi dalla # sincronizzazione, quindi non vengono cancellati. # RUNNER: `runs-on: docker`, adattare il label come negli altri workflow. @@ -19,7 +27,7 @@ name: Deploy on: release: - types: [published] + types: [published, edited] workflow_dispatch: inputs: tag: @@ -27,7 +35,62 @@ on: required: true jobs: + controllo: + name: Release da pubblicare + runs-on: docker # label del runner: adattare (es. ubuntu-latest) + container: + image: debian:stable-slim + outputs: + tag: ${{ steps.scelta.outputs.tag }} + steps: + - name: Scegli la release + id: scelta + env: + EVENTO: ${{ github.event_name }} + AZIONE: ${{ github.event.action }} + TAG_MANUALE: ${{ inputs.tag }} + TAG_RELEASE: ${{ github.event.release.tag_name }} + BOZZA: ${{ github.event.release.draft }} + PRERELEASE: ${{ github.event.release.prerelease }} + TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + set -eu + if [ "$EVENTO" = workflow_dispatch ]; then + echo "tag=$TAG_MANUALE" >> "$GITHUB_OUTPUT" + exit 0 + fi + if [ "$BOZZA" = true ] || [ "$PRERELEASE" = true ]; then + echo "$TAG_RELEASE è una bozza o una pre-release: nessun deploy." + exit 0 + fi + apt-get update -qq && apt-get install -y -qq --no-install-recommends ca-certificates curl jq >/dev/null + # «edited» anche per le modifiche successive: si procede solo se i file sono appena stati + # caricati, cioè se è la pubblicazione fatta da release.yml o da release-upload.sh + if [ "$AZIONE" != published ]; then + ULTIMO_FILE="$(jq -r '[.release.assets[].created_at] | max // empty' "$GITHUB_EVENT_PATH")" + if [ -z "$ULTIMO_FILE" ] || [ $(( $(date +%s) - $(date -d "$ULTIMO_FILE" +%s) )) -gt 3600 ]; then + echo "$TAG_RELEASE: modifica di una release già pubblicata, nessun deploy (per ripubblicarla usare l'avvio manuale)." + exit 0 + fi + fi + # chiamata separata dal parsing: se l'API non risponde lo step fallisce (set -e) invece + # di saltare il deploy in silenzio + RISPOSTA="$(curl -fsS -H "Authorization: token ${TOKEN}" \ + "${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases/latest")" + ULTIMA="$(printf '%s' "$RISPOSTA" | jq -r .tag_name)" + if [ -z "$ULTIMA" ] || [ "$ULTIMA" = null ]; then + echo "risposta inattesa da /releases/latest" >&2 + exit 1 + fi + if [ "$ULTIMA" != "$TAG_RELEASE" ]; then + echo "$TAG_RELEASE non è l'ultima release pubblicata ($ULTIMA): nessun deploy." + exit 0 + fi + echo "tag=$TAG_RELEASE" >> "$GITHUB_OUTPUT" + deploy: + needs: controllo + if: needs.controllo.outputs.tag != '' runs-on: docker # label del runner: adattare (es. ubuntu-latest) container: image: debian:stable-slim @@ -39,20 +102,27 @@ jobs: - name: Scarica il pacchetto della release env: - TAG: ${{ github.event.release.tag_name || inputs.tag }} - TOKEN: ${{ secrets.FORGEJO_TOKEN || secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }} + TAG: ${{ needs.controllo.outputs.tag }} + TOKEN: ${{ secrets.GITHUB_TOKEN }} # il token automatico basta per scaricare run: | set -eu VERSION="${TAG#v}" BASE="${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}" curl -fsSL -H "Authorization: token ${TOKEN}" -o pacchetto.zip "${BASE}/sito-studio-grasso-v${VERSION}.zip" curl -fsSL -H "Authorization: token ${TOKEN}" -o SHA256SUMS.txt "${BASE}/SHA256SUMS.txt" + curl -fsSL -H "Authorization: token ${TOKEN}" -o BUILD-INFO.txt "${BASE}/BUILD-INFO.txt" grep " sito-studio-grasso-v${VERSION}.zip$" SHA256SUMS.txt | sed "s/sito-studio-grasso-v${VERSION}.zip/pacchetto.zip/" | sha256sum -c - + grep ' BUILD-INFO.txt$' SHA256SUMS.txt | sha256sum -c - mkdir sito && unzip -q pacchetto.zip -d sito # --------------------------------------------------------------------------- # Variante A — rsync su SSH (VPS o hosting con accesso SSH) # Segreti: DEPLOY_HOST, DEPLOY_USER, DEPLOY_PATH, DEPLOY_SSH_KEY (chiave privata) + # DEPLOY_PATH = cartella pubblica del sito (es. /var/www/studio-grasso): con --delete + # tutto ciò che contiene e non è nel pacchetto viene cancellato. Prima del primo deploy + # creare sul server il file di conferma: touch /.deploy-studio-grasso + # Senza quel file lo step si ferma: un percorso sbagliato (la home, /var/www…) non viene + # mai sincronizzato. # --------------------------------------------------------------------------- # - name: Pubblica con rsync # env: @@ -62,15 +132,26 @@ jobs: # DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }} # run: | # set -eu + # # un segreto mancante vale "": senza questo controllo la destinazione sarebbe «/» + # : "${DEPLOY_PATH:?segreto DEPLOY_PATH mancante o vuoto}" + # case "$DEPLOY_PATH" in + # /|'~'|'~/'|.|./|/home|/home/|/root|/root/) echo "DEPLOY_PATH non sicuro: $DEPLOY_PATH" >&2; exit 1 ;; + # esac # mkdir -p ~/.ssh && chmod 700 ~/.ssh # printf '%s\n' "$DEPLOY_SSH_KEY" > ~/.ssh/id_deploy && chmod 600 ~/.ssh/id_deploy # ssh-keyscan -H "$DEPLOY_HOST" >> ~/.ssh/known_hosts + # # la cartella deve essere quella del sito, confermata dal file creato a mano + # ssh -i ~/.ssh/id_deploy "$DEPLOY_USER@$DEPLOY_HOST" "test -f '$DEPLOY_PATH/.deploy-studio-grasso'" \ + # || { echo "manca $DEPLOY_PATH/.deploy-studio-grasso: cartella del sito non confermata" >&2; exit 1; } # rsync -az --delete --exclude '.well-known/' --exclude '.user.ini' --exclude 'cgi-bin/' \ + # --exclude '.deploy-studio-grasso' \ # -e "ssh -i ~/.ssh/id_deploy" sito/ "$DEPLOY_USER@$DEPLOY_HOST:$DEPLOY_PATH/" # --------------------------------------------------------------------------- # Variante B — FTPS con lftp (hosting condivisi: cPanel, Plesk, Aruba, Register…) # Segreti: FTP_HOST, FTP_USER, FTP_PASSWORD, FTP_PATH (es. /public_html) + # FTP_PATH = cartella pubblica del sito, MAI la radice dell'account quando questa è la home + # (cPanel): mirror --delete cancellerebbe posta, configurazioni e altri siti. # --------------------------------------------------------------------------- # - name: Pubblica via FTPS # env: @@ -79,6 +160,8 @@ jobs: # FTP_PASSWORD: ${{ secrets.FTP_PASSWORD }} # FTP_PATH: ${{ secrets.FTP_PATH }} # run: | + # set -eu + # : "${FTP_PATH:?segreto FTP_PATH mancante o vuoto}" # lftp -u "$FTP_USER","$FTP_PASSWORD" -e "set ftp:ssl-force true; set ssl:verify-certificate yes; \ # mirror -R --delete --verbose --exclude-glob .well-known/ --exclude-glob .user.ini \ # --exclude-glob cgi-bin/ sito/ $FTP_PATH; quit" "$FTP_HOST" @@ -92,14 +175,20 @@ jobs: # RCLONE_CONFIG_CONTENT: ${{ secrets.RCLONE_CONFIG }} # RCLONE_DEST: ${{ secrets.RCLONE_DEST }} # run: | + # set -eu + # : "${RCLONE_DEST:?segreto RCLONE_DEST mancante o vuoto}" # mkdir -p ~/.config/rclone && printf '%s\n' "$RCLONE_CONFIG_CONTENT" > ~/.config/rclone/rclone.conf # rclone sync sito/ "$RCLONE_DEST" --checksum --exclude '.htaccess' - name: Controllo dopo la pubblicazione env: - SITE_URL: ${{ vars.SITE_URL || 'https://www.grassoezio.it' }} + SITE_URL: ${{ vars.SITE_URL }} run: | set -eu + # dominio per cui è stato costruito il pacchetto (BUILD-INFO.txt, scritto da + # scripts/package.mjs), se la variabile del repository SITE_URL non è impostata + SITE_URL="${SITE_URL:-$(sed -n 's/^SITE_URL: //p' BUILD-INFO.txt)}" + : "${SITE_URL:?dominio del sito non trovato in BUILD-INFO.txt}" for p in / /servizi/ /contatti/ /sitemap-index.xml /robots.txt; do code=$(curl -s -o /dev/null -w '%{http_code}' "${SITE_URL}${p}") echo "${p} → ${code}"; [ "$code" = 200 ] diff --git a/deploy/nginx.conf.example b/deploy/nginx.conf.example index 6e4ef6b..5f9da68 100644 --- a/deploy/nginx.conf.example +++ b/deploy/nginx.conf.example @@ -1,14 +1,31 @@ # ============================================================================= # Studio Grasso — configurazione nginx di esempio (equivalente a public/.htaccess) # ----------------------------------------------------------------------------- -# 1. Estrarre il pacchetto sito-studio-grasso-vX.Y.Z.tar.gz in /var/www/studio-grasso +# 1. Pubblicare il pacchetto in /var/www/studio-grasso come in docs/DEPLOY.md, sezione 4 +# (estrazione in una cartella temporanea e rsync -rlt --delete): estraendo direttamente +# nella cartella, i file tolti in una nuova versione resterebbero raggiungibili # 2. Copiare questo file in /etc/nginx/sites-available/studio-grasso, adattare # server_name e certificati, attivarlo e ricaricare: nginx -t && systemctl reload nginx # 3. Il file .htaccess incluso nel pacchetto è ignorato da nginx (ed è bloccato qui sotto). # Richiede nginx ≥ 1.25.1 per la direttiva «http2 on;»; con versioni precedenti eliminarla e # scrivere «listen 443 ssl http2;». Configurazione verificata con `nginx -t`. +# +# Header: in nginx un `add_header` dentro una location annulla TUTTI quelli ereditati dal +# blocco server. Per questo nessuna location ne definisce: gli header di sicurezza (CSP e HSTS +# compresi) stanno solo nel blocco server e valgono per ogni risposta, mentre la durata della +# cache dipende dall'indirizzo tramite la `map` qui sotto. # ============================================================================= +# Cache-Control per tipo di risorsa (variabile usata nel blocco server) +map $uri $studio_grasso_cache { + # file con impronta nel nome (cartella /_astro/): un anno + ~^/_astro/ "public, max-age=31536000, immutable"; + # icone, immagine di condivisione, sitemap, robots.txt: una settimana + ~*^/(favicon\.(ico|svg)|apple-touch-icon\.png|og-default\.png|robots\.txt|sitemap.*\.xml)$ "public, max-age=604800"; + # pagine HTML: sempre ricontrollate + default "no-cache"; +} + # HTTP → HTTPS server { listen 80; @@ -25,6 +42,8 @@ server { server_name grassoezio.it; ssl_certificate /etc/letsencrypt/live/grassoezio.it/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/grassoezio.it/privkey.pem; + # HSTS: decommentare insieme alla riga del blocco principale (copre anche questo dominio) + # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; return 301 https://www.grassoezio.it$request_uri; } @@ -42,15 +61,19 @@ server { charset utf-8; server_tokens off; - # --- header di sicurezza (come .htaccess, brief §9.4) --- + # --- header di sicurezza (come .htaccess, brief §9.4): UNICO punto, valgono per ogni + # risposta perché nessuna location ha add_header propri (vedi in alto) --- add_header Content-Security-Policy "default-src 'self'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; script-src 'self'; font-src 'self'; frame-src https://www.google.com; form-action 'self'; base-uri 'self'; frame-ancestors 'self'" always; add_header X-Content-Type-Options "nosniff" always; add_header Referrer-Policy "strict-origin-when-cross-origin" always; add_header X-Frame-Options "SAMEORIGIN" always; add_header Permissions-Policy "accelerometer=(), autoplay=(), camera=(), display-capture=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), usb=(), browsing-topics=()" always; add_header Cross-Origin-Opener-Policy "same-origin" always; - # HSTS: attivare solo quando HTTPS è certo su tutto il dominio. + # HSTS: attivare solo quando HTTPS è certo su tutto il dominio, decommentando questa riga e + # quella del blocco del dominio senza «www» qui sopra. # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; + # cache: valore della map in alto (senza «always»: le risposte d'errore non vanno in cache) + add_header Cache-Control $studio_grasso_cache; # --- compressione --- gzip on; @@ -60,16 +83,9 @@ server { # --- pagine e 404 --- # /studio → /studio/ è automatico (try_files su una cartella con index.html). + # NB: nessun add_header nelle location (annullerebbe gli header del blocco server). location / { try_files $uri $uri/ =404; - add_header Cache-Control "no-cache"; - # ripetuti perché add_header in un blocco location sostituisce quelli del server - add_header Content-Security-Policy "default-src 'self'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; script-src 'self'; font-src 'self'; frame-src https://www.google.com; form-action 'self'; base-uri 'self'; frame-ancestors 'self'" always; - add_header X-Content-Type-Options "nosniff" always; - add_header Referrer-Policy "strict-origin-when-cross-origin" always; - add_header X-Frame-Options "SAMEORIGIN" always; - add_header Permissions-Policy "accelerometer=(), autoplay=(), camera=(), display-capture=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), usb=(), browsing-topics=()" always; - add_header Cross-Origin-Opener-Policy "same-origin" always; } error_page 404 /404.html; location = /404.html { @@ -81,19 +97,11 @@ server { return 301 /privacy-policy/; } - # file con impronta nel nome (cartella /_astro/): cache di un anno + # file con impronta nel nome (cartella /_astro/): solo file esistenti, nessun indice location /_astro/ { - add_header Cache-Control "public, max-age=31536000, immutable"; - add_header X-Content-Type-Options "nosniff" always; try_files $uri =404; } - # icone, immagine di condivisione, sitemap, robots.txt: una settimana - location ~* ^/(favicon\.(ico|svg)|apple-touch-icon\.png|og-default\.png|robots\.txt|sitemap.*\.xml)$ { - add_header Cache-Control "public, max-age=604800"; - add_header X-Content-Type-Options "nosniff" always; - } - # file nascosti (tranne /.well-known/ per i certificati) e mappe dei sorgenti location ~ /\.(?!well-known/) { deny all; diff --git a/deploy/optional-php-form/contact.php b/deploy/optional-php-form/contact.php index 5920701..7fe686d 100644 --- a/deploy/optional-php-form/contact.php +++ b/deploy/optional-php-form/contact.php @@ -2,21 +2,25 @@ /** * Studio Grasso — gestore del modulo di contatto (modalità "php", brief §10.1). * - * Installazione: impostare `contactForm.mode = 'php'` in src/data/studio.ts, copiare questo - * file in public/contact.php, eseguire `npm run verify` e pubblicare (vedi docs/DEPLOY.md). + * Installazione: in src/data/studio.ts impostare `MODALITA_PREDEFINITA = 'php'`, copiare + * questo file in public/contact.php, rivedere DESTINATARIO e MITTENTE qui sotto, eseguire + * `npm run verify` e pubblicare (vedi docs/DEPLOY.md, sezione 6). * Requisiti: PHP 7.4 o successivo con la funzione mail() abilitata dall'hosting (l'estensione * mbstring è usata se presente, ma non è necessaria). * * Cosa fa: * - accetta solo POST e valida tutti i campi (obbligatori, lunghezze, e-mail, telefono, presa - * visione dell'informativa); + * visione dell'informativa) con le stesse regole del browser (src/scripts/form.ts): spazi + * iniziali e finali esclusi, a capo contati come un carattere; * - anti-spam senza cookie né servizi esterni: campo trappola `sito_web` (se compilato la - * richiesta viene scartata in silenzio), tempo minimo di compilazione (campo `ts`) e massimo - * 5 invii all'ora per indirizzo IP. Il contatore è un file per IP in una cartella privata - * (permessi 0700/0600), con nome HMAC-SHA256 dell'IP e di un segreto casuale generato al primo - * uso: mai l'IP in chiaro. I file più vecchi di un'ora vengono cancellati a ogni invio - * (informativa: privacy policy, blocco «moduloPhp»); - * - invia un'e-mail in testo semplice al destinatario configurato con mail(); + * richiesta viene scartata in silenzio), tempo minimo di compilazione (campi `ts` e + * `ts_invio`, entrambi dall'orologio del dispositivo) e massimo 5 invii all'ora per + * indirizzo IP. Il contatore è un file per IP in una cartella privata (permessi 0700/0600), + * con nome HMAC-SHA256 dell'IP e di un segreto casuale generato al primo uso: mai l'IP in + * chiaro. I file più vecchi di un'ora vengono cancellati a ogni invio (informativa: privacy + * policy, blocco «moduloPhp»); + * - invia un'e-mail in testo semplice al destinatario configurato con mail(), con il corpo in + * quoted-printable (righe brevi: nessun rifiuto per «lines too long» dai server di posta); * - NON salva né registra il contenuto dei messaggi; * - risponde con redirect a /contatti/grazie/ oppure con una pagina d'errore leggibile. */ @@ -45,10 +49,14 @@ const LUNGHEZZE = ['nome' => 120, 'email' => 160, 'telefono' => 25, 'oggetto' => const CARTELLA_LIMITI = __DIR__ . '/../.studio-grasso-form'; // ---------------------------------------------------------------- funzioni +/** + * Valore di un campo senza spazi iniziali e finali, con gli a capo normalizzati in LF: il + * browser invia CRLF ma conta ogni a capo come un carattere (maxlength), e così fa il server. + */ function campo(string $nome): string { $valore = $_POST[$nome] ?? ''; - return is_string($valore) ? trim($valore) : ''; + return is_string($valore) ? trim(str_replace(["\r\n", "\r"], "\n", $valore)) : ''; } /** Lunghezza in caratteri (UTF-8), anche senza l'estensione mbstring. */ @@ -173,10 +181,25 @@ function limiteSuperato(string $ip): bool return $superato; } -/** Oggetto codificato secondo RFC 2047 (lettere accentate). */ -function oggettoMime(string $oggetto): string +/** + * Testo codificato secondo RFC 2047 (lettere accentate) in parole di al massimo 75 caratteri: + * pezzi di al massimo 45 byte senza spezzare i caratteri UTF-8. Lo spazio tra due parole + * codificate viene ignorato da chi le legge, quindi il testo arriva intero. + */ +function oggettoMime(string $testo): string { - return '=?UTF-8?B?' . base64_encode($oggetto) . '?='; + $pezzi = ['']; + foreach (preg_split('//u', $testo, -1, PREG_SPLIT_NO_EMPTY) ?: [] as $carattere) { + $ultimo = count($pezzi) - 1; + if (strlen($pezzi[$ultimo] . $carattere) > 45) { + $pezzi[] = $carattere; + } else { + $pezzi[$ultimo] .= $carattere; + } + } + return implode(' ', array_map(static function (string $pezzo): string { + return '=?UTF-8?B?' . base64_encode($pezzo) . '?='; + }, $pezzi)); } // ---------------------------------------------------------------- richiesta @@ -190,11 +213,19 @@ if (campo('sito_web') !== '') { vai(PAGINA_GRAZIE); } -// 2) tempo minimo di compilazione (il campo ts è valorizzato via JavaScript all'apertura della -// pagina; senza JavaScript manca e il controllo non si applica) +// 2) tempo minimo di compilazione. I campi ts (apertura della pagina) e ts_invio (invio) sono +// valorizzati via JavaScript con l'orologio del dispositivo: la durata si calcola con lo +// stesso orologio, perché quello del dispositivo può essere avanti o indietro rispetto al +// server. Senza ts_invio (es. invio senza l'evento submit) si usa l'ora del server; senza +// JavaScript mancano entrambi e il controllo non si applica. +// Calcolo in virgola mobile: i millisecondi (13 cifre) superano PHP_INT_MAX di PHP a 32 bit, +// dove (int) li satura e la durata risulterebbe sempre 0; un float li rappresenta esatti. $ts = campo('ts'); +$tsInvio = campo('ts_invio'); if ($ts !== '' && ctype_digit($ts)) { - $trascorsi = (int) floor(microtime(true) * 1000) - (int) $ts; + $trascorsi = ($tsInvio !== '' && ctype_digit($tsInvio)) + ? (float) $tsInvio - (float) $ts + : microtime(true) * 1000 - (float) $ts; if ($trascorsi >= 0 && $trascorsi < TEMPO_MINIMO_MS) { errore('Il modulo è stato inviato troppo rapidamente. Attendi qualche secondo e riprova.', 429); } @@ -224,10 +255,10 @@ if (filter_var($dati['email'], FILTER_VALIDATE_EMAIL) === false) { errore('L’indirizzo e-mail non è valido.'); } if (!preg_match('/^[0-9 +().\/-]{6,25}$/', $dati['telefono'])) { - errore('Il numero di telefono non è valido.'); + errore('Il numero di telefono non è valido: usa da 6 a 25 caratteri tra cifre, spazi e i segni + ( ) . / -'); } if (lunghezza($dati['messaggio']) < 10) { - errore('Il messaggio è troppo breve.'); + errore('Il messaggio deve contenere almeno 10 caratteri.'); } if (campo('privacy') !== '1') { errore('Per inviare la richiesta conferma di aver letto l’informativa sulla privacy.'); @@ -247,13 +278,17 @@ $corpo = "Nuova richiesta dal modulo di contatto del sito.\n\n" . "Messaggio:\n" . $dati['messaggio'] . "\n\n" . "--\nPresa visione dell'informativa privacy: sì\n" . 'Data: ' . date('d/m/Y H:i') . "\n"; +// Quoted-printable: righe di al massimo 76 caratteri anche per un messaggio scritto senza andare +// a capo (oltre 998 byte per riga i server di posta lo rifiutano o lo spezzano, RFC 5322) e testo +// UTF-8 invariato. Gli a capo diventano CRLF prima della codifica, che li conserva come tali. +$corpo = quoted_printable_encode(str_replace("\n", "\r\n", $corpo)); $intestazioni = [ 'From' => oggettoMime(NOME_MITTENTE) . ' <' . MITTENTE . '>', 'Reply-To' => $dati['email'], 'MIME-Version' => '1.0', 'Content-Type' => 'text/plain; charset=UTF-8', - 'Content-Transfer-Encoding' => '8bit', + 'Content-Transfer-Encoding' => 'quoted-printable', 'X-Mailer' => 'studio-grasso-form', ]; diff --git a/docs/CONFORMITA.md b/docs/CONFORMITA.md index f876b71..cee37e8 100644 --- a/docs/CONFORMITA.md +++ b/docs/CONFORMITA.md @@ -6,16 +6,16 @@ Legenda stato: ✅ fatto · 🟡 fatto, richiede un dato o una conferma dallo St ## Obblighi informativi -| Requisito | Norma | Dove è implementato | Stato | -| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -| P.IVA in home page e in ogni pagina, come testo | art. 35, co. 1, D.P.R. 633/1972 | `src/components/Footer.astro` (riga legale), dato in `src/data/studio.ts` **(automatico)** | ✅ | -| Denominazione del titolare del sito | art. 7 D.Lgs. 70/2003; art. 2250 c.c. | `studio.titolare.denominazione` in `src/data/studio.ts`; Note legali e footer | 🟡 B1 | -| Dati societari (sede, Registro Imprese/REA, capitale, socio unico, liquidazione) se il titolare è una società | art. 2250 c.c. | `studio.datiSocietari` → footer, Note legali, Privacy policy (compaiono appena compilati) | 🟡 B1 | -| Riferimento agli estremi della L. 4/2013 per il tributarista | art. 1, co. 3, L. 4/2013 | `professionisti[0].riferimentoNormativo` → scheda del Dott. Ezio Grasso (home, Lo studio) e Note legali **(automatico)** | ✅ | -| Ordine e numero di iscrizione della Dott.ssa Giulia Grasso (Dottore Commercialista); titolo, Stato di rilascio, norme professionali | art. 4 D.P.R. 137/2012; art. 7, lett. f, D.Lgs. 70/2003; Codice deontologico CNDCEC | scheda della Dott.ssa Giulia Grasso, abilitazioni, Note legali (D.Lgs. 139/2005 e Codice deontologico, link al CNDCEC); Stato del titolo da `statoTitolo` | 🟡 C13 | -| Pubblicità informativa veritiera, non comparativa, senza promesse di risultato né tariffe | art. 4 D.P.R. 137/2012 | contenuti in `src/data` e `src/content` (nessun superlativo, numero o testimonianza inventati) | ✅ | -| Titoli professionali esatti: «commercialista» solo per la Dott.ssa Giulia Grasso | brief §2.2 | controllo per frase su tutte le pagine **(automatico)** | ✅ | -| Estremi della polizza RC professionale | art. 9, co. 4, D.L. 1/2012 (obbligo verso il cliente, non di pubblicazione) | campo facoltativo `polizzaRc` → Note legali | 🟡 C7 | +| Requisito | Norma | Dove è implementato | Stato | +| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | +| P.IVA in home page e in ogni pagina, come testo | art. 35, co. 1, D.P.R. 633/1972 | `src/components/Footer.astro` (riga legale), dato in `src/data/studio.ts` **(automatico)** | ✅ | +| Denominazione del titolare del sito | art. 7 D.Lgs. 70/2003; art. 2250 c.c. | `studio.titolare.denominazione` in `src/data/studio.ts`; Note legali e footer | 🟡 B1 | +| Dati societari (sede, Registro Imprese/REA, capitale, socio unico, liquidazione) se il titolare è una società | art. 2250 c.c. | `studio.datiSocietari` → footer, Note legali, Privacy policy (compaiono appena compilati) | 🟡 B1 | +| Riferimento agli estremi della L. 4/2013 per il tributarista | art. 1, co. 3, L. 4/2013 | `professionisti[0].riferimentoNormativo` → scheda del Dott. Ezio Grasso (home, Lo studio) e Note legali **(automatico)** | ✅ | +| Ordine e numero di iscrizione della Dott.ssa Giulia Grasso (Dottore Commercialista); titolo, Stato di rilascio, norme professionali | art. 4 D.P.R. 137/2012; art. 7, lett. f, D.Lgs. 70/2003; Codice deontologico CNDCEC | scheda della Dott.ssa Giulia Grasso, abilitazioni, Note legali (D.Lgs. 139/2005 e Codice deontologico, link al CNDCEC); Stato del titolo da `statoTitolo` | 🟡 C13 | +| Pubblicità informativa veritiera, non comparativa, senza promesse di risultato né tariffe | art. 4 D.P.R. 137/2012 | contenuti in `src/data` e `src/content` (nessun superlativo, numero o testimonianza inventati) | ✅ | +| Titoli professionali esatti: «commercialista» solo per la Dott.ssa Giulia Grasso | brief §2.2 | controllo per frase su testo visibile, meta (description, Open Graph, Twitter), attributi alt/title/aria-label e dati strutturati di tutte le pagine **(automatico)** | ✅ | +| Estremi della polizza RC professionale | art. 9, co. 4, D.L. 1/2012 (obbligo verso il cliente, non di pubblicazione) | campo facoltativo `polizzaRc` → Note legali | 🟡 C7 | ## Privacy e cookie @@ -46,12 +46,12 @@ Legenda stato: ✅ fatto · 🟡 fatto, richiede un dato o una conferma dallo St ## Accessibilità -| Requisito | Norma | Dove è implementato | Stato | -| -------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ----- | -| Pagina «Accessibilità» volontaria (non dichiarazione AgID) | L. 4/2004 e D.Lgs. 82/2022 non applicabili | `/accessibilita/` ← `src/content/legali/accessibilita.md` | ✅ | -| WCAG 2.1 AA: zero violazioni gravi o critiche | WCAG 2.1 | axe-core su tutte le pagine a 1440 e 390 px **(automatico, tests/a11y)**; Lighthouse accessibilità = 1 | ✅ | -| Zoom non bloccato | WCAG 1.4.4 | `meta viewport` senza `user-scalable=no` / `maximum-scale` **(automatico)** | ✅ | -| Navigazione da tastiera, skip link, focus visibile, menu e sottomenu accessibili | WCAG 2.1.1, 2.4.1, 2.4.7 | `Header`, `Nav`, `MobileMenu`, `src/scripts/menu.ts` **(automatico, tests/a11y/keyboard.spec.ts)** | ✅ | +| Requisito | Norma | Dove è implementato | Stato | +| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ----- | +| Pagina «Accessibilità» volontaria (non dichiarazione AgID) | L. 4/2004 e D.Lgs. 82/2022 non applicabili | `/accessibilita/` ← `src/content/legali/accessibilita.md` | ✅ | +| WCAG 2.1 AA: zero violazioni gravi o critiche | WCAG 2.1 | axe-core su tutte le pagine a 1440 e 390 px **(automatico, tests/a11y)**; Lighthouse accessibilità = 1 | ✅ | +| Zoom non bloccato | WCAG 1.4.4 | `meta viewport` senza `user-scalable=no` / `maximum-scale` **(automatico)** | ✅ | +| Navigazione da tastiera, skip link, focus visibile (contrasto ≥ 3:1 misurato), menu e sottomenu accessibili | WCAG 2.1.1, 2.4.1, 2.4.7, 1.4.11 | `Header`, `Nav`, `MobileMenu`, `src/scripts/menu.ts`, token `--focus-ring` **(automatico, tests/a11y/keyboard.spec.ts)** | ✅ | ## Contenuti diff --git a/docs/CONTENUTI.md b/docs/CONTENUTI.md index 1c111c2..2ec0472 100644 --- a/docs/CONTENUTI.md +++ b/docs/CONTENUTI.md @@ -18,7 +18,7 @@ Le modifiche diventano visibili sul sito **solo dopo una nuova release** e il su | Professionisti e qualifiche | `src/data/studio.ts` (`professionisti`) | | Abilitazioni e iscrizioni (i 9 riquadri) | `src/data/studio.ts` (`abilitazioni`) | | Valori, partner, collaborazioni | `src/data/studio.ts` (`valori`, `partner`, `collaborazioni`) | -| Servizi (testo delle 6 pagine) | `src/content/servizi/*.md` | +| Servizi (un file per ogni pagina di servizio) | `src/content/servizi/*.md` | | Link utili | `src/content/link-utili.json` | | Privacy policy, Cookie policy, Note legali, Accessibilità | `src/content/legali/*.md` | | Testi delle pagine (home, Lo studio, Contatti…), titoli e descrizioni per Google | `src/data/pagine.ts` | @@ -35,11 +35,12 @@ email: 'info@studiograssoezio.it', - **Telefono:** ogni numero ha due forme: `display` (come appare, con spazi) ed `e164` (per la chiamata, solo `+` e cifre): `{ display: '+39 0141 951382', e164: '+390141951382' },` -- **Orari:** nell'oggetto `orari` le fasce sono in formato 24 ore (`'09:00'`); i testi `giorni`, `giorniEsteso`, `giorniBreve` e `notaAsti` sono quelli mostrati. +- **Orari:** nell'oggetto `orari` le fasce sono in formato 24 ore (`'09:00'`); i testi `giorni`, `giorniEsteso`, `giorniBreve` e `notaAsti` sono quelli mostrati. Se cambiano i giorni di apertura, aggiornare insieme ai tre testi anche `giorniSettimana`, l'elenco in inglese usato dai motori di ricerca (es. `['Monday', 'Tuesday', 'Wednesday', 'Thursday']` per «dal lunedì al giovedì»). +- **Indirizzo di una sede:** si modifica solo in `indirizzo`; la ricerca per le indicazioni stradali, i link a Google Maps e OpenStreetMap e il titolo della mappa si aggiornano da soli. Vanno invece cambiati a mano `mappa.embedUrl` (su Google Maps: Condividi → Incorpora una mappa, poi copiare l'indirizzo dopo `src="`) e la descrizione della pagina «Dove siamo» in `src/data/pagine.ts` (`doveSiamoPagina`), che cita le vie. - **Dati mancanti:** i campi con `null` (es. `denominazione: null`) non compaiono sul sito finché non vengono compilati: scrivere il valore tra apici al posto di `null`, es. `denominazione: 'Studio Tributario Grasso S.r.l.',`. L'elenco dei dati da completare è in `TODO-STUDIO.md`. - Per l'apostrofo nei testi visibili usare `’` (es. `Montegrosso d’Asti`). -Un dato modificato qui si aggiorna automaticamente in **tutte** le pagine (intestazione, footer, contatti, pagine legali, dati per i motori di ricerca). +Un dato modificato qui si aggiorna automaticamente in **tutte** le pagine (intestazione, footer, contatti, pagine legali, dati per i motori di ricerca), con le sole eccezioni indicate sopra per l'indirizzo. I controlli automatici leggono gli stessi dati: un orario o un recapito aggiornato non fa fallire la verifica. ## Servizi (`src/content/servizi/*.md`) @@ -68,7 +69,7 @@ Paragrafo introduttivo. - `## ` all'inizio della riga crea un titolo di gruppo; `- ` crea una voce dell'elenco. - Un link: `[testo del link](/servizi/contenzioso-tributario/)`. - Se un campo non rispetta le regole (es. descrizione troppo lunga), la verifica si ferma e indica file e campo da correggere. -- **Nuovo servizio:** copiare un file esistente, cambiare nome del file, `slug`, `ordine` e `anchorLegacy` (un nome nuovo qualsiasi); compare da solo in menu, home, pagina Servizi e footer. +- **Nuovo servizio:** copiare un file esistente, cambiare nome del file, `slug`, `ordine` e `anchorLegacy` (un nome nuovo qualsiasi, diverso da quelli degli altri servizi); compare da solo in menu, home, pagina Servizi e footer. I sei servizi originali non vanno eliminati: la verifica controlla che ci siano tutti. ## Link utili (`src/content/link-utili.json`) @@ -102,7 +103,7 @@ Contiene, pagina per pagina, titoli, sottotitoli, paragrafi e i **meta** per i m **Regole sui contenuti** (verificate in automatico dove possibile): - solo fatti veri e verificabili: niente numeri, anni di esperienza, clienti, recensioni o superlativi; -- titoli professionali esatti: «commercialista» solo per la Dott.ssa Giulia Grasso (ODCEC di Asti); lo Studio è «Studio Grasso — Studio Tributario e Societario»; +- titoli professionali esatti: «commercialista» solo per la Dott.ssa Giulia Grasso (ODCEC di Asti), anche nelle descrizioni per Google e nei testi alternativi delle immagini; lo Studio è «Studio Grasso — Studio Tributario e Societario»; - niente tariffe né promesse di risultato o di tempi di risposta (è ammesso «ti rispondiamo nel più breve tempo possibile»); - dare del «tu» nelle frasi rivolte al visitatore («Richiedi un preventivo»). diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index 53f6fac..21b3fe3 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -35,8 +35,8 @@ Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorith ### Note sul `.htaccess` - Il redirect **HTTP → HTTPS** è attivo: se l'hosting lo gestisce già dal pannello, o se il certificato non è ancora attivo, commentare le tre righe indicate nella sezione «Redirect». -- Il redirect tra dominio **con e senza «www»** è commentato: decommentare la variante coerente con il dominio usato per la build (`SITE_URL`, predefinito `https://www.grassoezio.it` → variante A). -- **HSTS** è commentato: attivarlo solo quando HTTPS funziona su tutto il dominio. +- Il redirect tra dominio **con e senza «www»** è commentato: decommentare la variante coerente con il dominio usato per la build (`site.config.mjs` o variabile `SITE_URL`, predefinito `https://www.grassoezio.it` → variante A). +- **HSTS** è commentato: attivarlo solo quando HTTPS funziona su tutto il dominio, decommentando la riga in `public/.htaccess` e impostando `HSTS_ATTIVO = true` in `scripts/check-compliance.mjs` (così la verifica controlla che sia attivo invece di segnalarlo come errore), poi nuova release. - Se compare un **errore 500** dopo il caricamento, l'hosting non consente una direttiva: commentare la riga indicata nel log degli errori del pannello (tutte le direttive dei moduli sono già dentro ``). - La configurazione è stata provata su Apache 2.4 con `AllowOverride All` (vedi DECISIONS.md, D-034). @@ -48,14 +48,19 @@ Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorith ## 4. Server con nginx -1. Copiare `sito-studio-grasso-vX.Y.Z.tar.gz` sul server ed estrarlo: +1. Copiare `sito-studio-grasso-vX.Y.Z.tar.gz` sul server, estrarlo in una cartella temporanea e sincronizzare la cartella servita. Così vengono tolti anche i file che non fanno più parte del sito: estraendo direttamente nella cartella servita, le pagine eliminate in una nuova versione (o aggiunte in una versione più recente, quando si torna indietro) resterebbero raggiungibili. ```bash sudo mkdir -p /var/www/studio-grasso - sudo tar -xzf sito-studio-grasso-vX.Y.Z.tar.gz -C /var/www/studio-grasso + d=$(sudo mktemp -d) + sudo tar -xzf sito-studio-grasso-vX.Y.Z.tar.gz -C "$d" + sudo rsync -rlt --delete --exclude .well-known/ "$d"/ /var/www/studio-grasso/ + sudo rm -rf "$d" ``` -2. Usare come base [`deploy/nginx.conf.example`](../deploy/nginx.conf.example) (redirect HTTPS e www, `try_files`, `error_page 404`, header di sicurezza, cache, compressione, blocco dei file nascosti): adattare `server_name` e certificati, poi `sudo nginx -t && sudo systemctl reload nginx`. + `rsync -rlt` (non `-a`) lascia invariati permessi e proprietario della cartella servita. Senza rsync: svuotare la cartella (tranne `.well-known/`) e poi estrarre l'archivio. La stessa procedura vale per gli aggiornamenti e per tornare a una versione precedente. + +2. Usare come base [`deploy/nginx.conf.example`](../deploy/nginx.conf.example) (redirect HTTPS e www, `try_files`, `error_page 404`, header di sicurezza, cache, compressione, blocco dei file nascosti): adattare `server_name` e certificati, poi `sudo nginx -t` e, se l'esito è positivo, `sudo systemctl reload nginx`. Gli header di sicurezza stanno solo nel blocco `server` e valgono per ogni risposta: non aggiungere `add_header` dentro le `location`, perché annullerebbe tutti quelli ereditati (HSTS compreso). 3. Il `.htaccess` è ignorato da nginx (e bloccato dalla configurazione). ## 5. Object storage (S3 compatibile, hosting statico) @@ -65,19 +70,20 @@ Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorith ## 6. Modulo di contatto (facoltativo) -Per impostazione predefinita il modulo è **disattivato** (`contactForm.mode = 'off'`): la pagina Contatti mostra il pulsante «Scrivi a info@studiograssoezio.it». Nessun dato passa dal server del sito. +Per impostazione predefinita il modulo è **disattivato** (`MODALITA_PREDEFINITA = 'off'` in `src/data/studio.ts`): la pagina Contatti mostra il pulsante «Scrivi a info@studiograssoezio.it». Nessun dato passa dal server del sito. ### Modalità `php` (hosting con PHP 7.4+ e funzione `mail()`; l'estensione mbstring non è necessaria) -1. In `src/data/studio.ts` impostare `mode: 'php'` (oggetto `contactForm`). +1. In `src/data/studio.ts` impostare `MODALITA_PREDEFINITA = 'php'`. Cambiare solo quella costante: la lettura della variabile `CONTACT_FORM_MODE` (usata nei test) deve restare. 2. Copiare `deploy/optional-php-form/contact.php` in `public/contact.php` e controllare le costanti in testa al file: `DESTINATARIO` (predefinito `info@studiograssoezio.it`) e `MITTENTE`. `MITTENTE` deve essere una casella **esistente** di un dominio da cui l'hosting può spedire, coperto da SPF/DKIM (es. `noreply@` sul dominio del sito o della posta). È usata anche come mittente della busta (`-f`): con un mittente non autorizzato le richieste possono finire nello spam o essere respinte, anche se il sito mostra «Richiesta inviata». -3. `npm run verify`, commit e nuova release: il pacchetto conterrà `contact.php`. +3. `npm run verify` (segnala se `contact.php` manca in `public/`), commit e nuova release: il pacchetto conterrà `contact.php`. 4. Dopo il deploy inviare una richiesta di prova e verificare la ricezione (anche nella cartella spam). Il gestore: -- valida i campi e scarta in silenzio gli invii con il campo trappola compilato; -- rifiuta gli invii troppo rapidi (meno di 3 secondi) e quelli oltre 5 all'ora dallo stesso indirizzo IP; +- valida i campi con le stesse regole del browser (spazi iniziali e finali esclusi, a capo contati come un carattere, e-mail con dominio completo) e scarta in silenzio gli invii con il campo trappola compilato; +- rifiuta gli invii troppo rapidi (meno di 3 secondi, misurati con l'orologio del dispositivo) e quelli oltre 5 all'ora dallo stesso indirizzo IP; +- invia l'e-mail in quoted-printable (righe brevi: un messaggio lungo scritto senza andare a capo non viene respinto dal server di posta); - non salva il contenuto dei messaggi e reindirizza a `/contatti/grazie/`. Il contatore degli invii è un file per IP con un nome crittografico (HMAC dell'IP con un segreto casuale generato al primo uso). I contatori più vecchi di un'ora vengono cancellati al primo invio successivo; per cancellarli comunque entro l'ora si può aggiungere un'operazione pianificata (cron) dell'hosting, es. `find ~/.studio-grasso-form -name 'ip-*' -mmin +60 -delete`. Sta in una cartella privata **fuori dalla cartella pubblica**: la costante `CARTELLA_LIMITI`, predefinita `../.studio-grasso-form`, cioè accanto a `public_html`. Se l'hosting non permette di scrivere lì, indicare una cartella privata scrivibile. Senza una cartella sicura il limite non si applica. @@ -87,15 +93,15 @@ La Privacy policy si aggiorna automaticamente. ### Modalità `endpoint` (servizio esterno di gestione moduli) 1. Scegliere un fornitore **con sede e server nell'Unione europea** e conforme al GDPR; nominarlo responsabile del trattamento. -2. In `src/data/studio.ts` impostare `mode: 'endpoint'`, `endpoint: 'https://…'` e, in `studio.fornitori.modulo`, denominazione e sede del fornitore (senza, la build si ferma): compaiono nella Privacy policy e sotto il modulo. -3. **Aggiornare la Content-Security-Policy** (`public/.htaccess` e `deploy/nginx.conf.example`): aggiungere l'origine del fornitore a `form-action`, nella stessa direttiva (es. `form-action 'self' https://moduli.esempio.eu`). `npm run test:compliance` verifica che l'origine di `contactForm.endpoint` sia presente e che nessuna direttiva sia ripetuta. -4. Verificare il modulo: `npm run build && npx playwright test tests/e2e/form.spec.ts` (l'invio al fornitore è simulato, nessuna richiesta esterna), poi `npm run verify`. +2. In `src/data/studio.ts` impostare `MODALITA_PREDEFINITA = 'endpoint'`, `endpoint: 'https://…'` (oggetto `contactForm`) e, in `studio.fornitori.modulo`, denominazione e sede del fornitore (senza, la build si ferma): compaiono nella Privacy policy e sotto il modulo. +3. **Aggiornare la Content-Security-Policy** (`public/.htaccess` e, per nginx, l'unica riga `Content-Security-Policy` del blocco `server` in `deploy/nginx.conf.example`): aggiungere l'origine del fornitore a `form-action`, nella stessa direttiva (es. `form-action 'self' https://moduli.esempio.eu`). `npm run test:compliance` verifica che l'origine di `contactForm.endpoint` sia presente e che nessuna direttiva sia ripetuta. +4. Verificare il modulo: `npm run build`, poi `npx playwright test tests/e2e/form.spec.ts` (l'invio al fornitore è simulato, nessuna richiesta esterna), poi `npm run verify`. 5. Far rivedere la Privacy policy al consulente. ## 7. Controlli dopo la pubblicazione - [ ] `https://` attivo, il lucchetto del browser è presente e `http://` reindirizza a `https://`. -- [ ] Il dominio con/senza «www» reindirizza alla versione usata in `SITE_URL`. +- [ ] Il dominio con/senza «www» reindirizza alla versione usata per la build (`site.config.mjs` o `SITE_URL`). - [ ] `https://dominio/privacy` reindirizza a `/privacy-policy/`; `https://dominio/studio` a `/studio/`. - [ ] Un indirizzo inesistente (es. `/prova-404/`) mostra la pagina «Pagina non trovata». - [ ] `https://dominio/sitemap-index.xml` e `/robots.txt` sono raggiungibili. @@ -107,25 +113,25 @@ La Privacy policy si aggiorna automaticamente. ## 8. Tornare alla versione precedente -Scaricare dalla pagina Release il pacchetto della versione precedente e ripetere la procedura (sezioni 2, 3, 4 o 5). Ogni release è completa e indipendente. +Scaricare dalla pagina Release il pacchetto della versione precedente e ripetere la procedura (sezioni 2, 3, 4 o 5). Ogni release è completa e indipendente. Togliere sempre i file della versione sostituita (cartella svuotata, punto 3 dell'FTP, sincronizzazione della sezione 4, `rclone sync`): altrimenti le pagine aggiunte nella versione più recente restano raggiungibili. ## 9. Deploy automatico (facoltativo, da attivare quando l'hosting è definito) -[`deploy/forgejo-deploy.yml.example`](../deploy/forgejo-deploy.yml.example) è un workflow pronto ma **non attivo**: alla pubblicazione di una release (o su avvio manuale) scarica il pacchetto, ne verifica l'impronta e lo pubblica, poi controlla che le pagine principali rispondano. +[`deploy/forgejo-deploy.yml.example`](../deploy/forgejo-deploy.yml.example) è un workflow pronto ma **non attivo**: quando `release.yml` pubblica una release stabile (o su avvio manuale, indicando il tag) scarica il pacchetto, ne verifica l'impronta e lo pubblica, poi controlla che le pagine principali rispondano. Le pre-release (tag con «-», es. `v1.1.0-rc.1`) non vengono pubblicate, e nemmeno una release che non sia l'ultima. Modificare in seguito titolo o note di una release, anche dell'ultima, non avvia il deploy: parte solo la pubblicazione fatta dal workflow di release o da `scripts/release-upload.sh`. L'avvio manuale serve anche per tornare a una versione precedente: in quel caso segnare come pre-release la versione ritirata, così resta «ultima» quella online. 1. Copiarlo in `.forgejo/workflows/deploy.yml`. 2. Decommentare **una** variante e creare i segreti del repository (Impostazioni → Actions → Segreti): - - **A — rsync su SSH:** `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY` (chiave privata dedicata, con la chiave pubblica in `~/.ssh/authorized_keys` sul server); - - **B — FTPS con lftp:** `FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH` (es. `/public_html`); + - **A — rsync su SSH:** `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY` (chiave privata dedicata, con la chiave pubblica in `~/.ssh/authorized_keys` sul server). `DEPLOY_PATH` è la cartella pubblica del sito. Prima del primo deploy creare sul server il file di conferma `.deploy-studio-grasso` in quella cartella (es. `touch /var/www/studio-grasso/.deploy-studio-grasso`): senza, lo step si ferma, così un percorso sbagliato (la home, `/var/www`…) non viene mai sincronizzato con `--delete`. Lo step si ferma anche se il segreto manca o vale `/`, `~`, `.`, `/home` o `/root`; + - **B — FTPS con lftp:** `FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH` (es. `/public_html`). `FTP_PATH` è la cartella pubblica del sito, **mai** la radice dell'account quando questa è la home (cPanel): la sincronizzazione cancellerebbe posta, configurazioni e altri siti; - **C — rclone (object storage):** `RCLONE_CONFIG` (contenuto di `rclone.conf`), `RCLONE_DEST`. -3. **Avvio automatico:** gli eventi creati con il token automatico dei workflow non avviano altri workflow. Perché il deploy parta da solo alla pubblicazione di una release, `release.yml` deve usare un token personale: segreto `FORGEJO_TOKEN` (o `RELEASE_TOKEN`, vedi README, «Fare una release»). Senza il segreto il deploy si avvia a mano dalla scheda **Actions** (indicando il tag). -4. Facoltativo: variabile del repository `SITE_URL` per il controllo finale. +3. **Avvio automatico:** le modifiche fatte con il token automatico dei workflow non avviano altri workflow. Perché il deploy parta da solo, `release.yml` deve pubblicare la release con un token personale: segreto `RELEASE_TOKEN` (vedi README, «Fare una release»). Non usare nomi che iniziano con `FORGEJO_`, `GITEA_` o `GITHUB_`: Forgejo li riserva, e `secrets.FORGEJO_TOKEN` è sempre il token automatico. Senza il segreto il deploy si avvia a mano dalla scheda **Actions** (indicando il tag). +4. Facoltativo: variabile del repository `SITE_URL`, usata dalla build di CI e release (dominio del sito). Il controllo finale del deploy usa la stessa variabile oppure, se non è impostata, il dominio scritto in `BUILD-INFO.txt` del pacchetto (cioè quello di `site.config.mjs` al momento della build). 5. Le varianti A e B sincronizzano la cartella con `--delete` ma **non toccano** `.well-known/`, `.user.ini` e `cgi-bin/`, gestiti dall'hosting. Se l'hosting ne usa altri, aggiungere le esclusioni. 6. Aggiungere al passo «Strumenti» i programmi della variante scelta (`rsync openssh-client`, `lftp` o `rclone`). ## 10. Pubblicare la release a mano (senza workflow) -Se le Actions non sono disponibili: +Se le Actions non sono disponibili (su Windows eseguire i comandi in Git Bash): ```bash RELEASE_VERSION=vX.Y.Z npm run package @@ -133,4 +139,4 @@ FORGEJO_URL=https://forgejo.example.it FORGEJO_REPO=proprietario/repository \ FORGEJO_TOKEN= scripts/release-upload.sh vX.Y.Z ``` -Il tag deve già esistere sul server (`git push origin vX.Y.Z`). Lo script crea la release (o aggiorna quella esistente) con le note del CHANGELOG e carica i quattro file di `release/`. +Il tag deve già esistere sul server (`git push origin vX.Y.Z`): lo script si ferma se manca o se punta a un commit diverso dal tag locale. Come l'action del workflow, crea la release in bozza, carica i quattro file di `release/` e solo alla fine la pubblica con titolo e note del CHANGELOG. Se la release esiste già (anche come bozza lasciata da un tentativo non riuscito), sostituisce i file con lo stesso nome, caricando il nuovo prima di cancellare il vecchio, e la pubblica con le note aggiornate. diff --git a/public/.htaccess b/public/.htaccess index ab20d2b..c087ee2 100644 --- a/public/.htaccess +++ b/public/.htaccess @@ -74,6 +74,8 @@ ErrorDocument 404 /404.html # HSTS: attivare SOLO quando HTTPS funziona su tutto il dominio (e sui sottodomini, se si # usa includeSubDomains). Una volta attivo, i browser rifiutano l'HTTP per un anno. + # Per attivarlo: decommentare la riga e impostare HSTS_ATTIVO = true in + # scripts/check-compliance.mjs (altrimenti la verifica segnala HSTS attivo per errore). # Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains" Header unset X-Powered-By diff --git a/scripts/check-compliance.mjs b/scripts/check-compliance.mjs index a47d870..cfec718 100644 --- a/scripts/check-compliance.mjs +++ b/scripts/check-compliance.mjs @@ -3,13 +3,16 @@ * Controlli di conformità sul sito compilato (brief §11.5). Ogni errore indica COSA non va e * DOVE (file di dist/). Richiede `npm run build`. Uscita con codice 1 se c'è almeno un errore. * - * I dati attesi (abilitazioni, servizi, P.IVA, professionisti) sono letti dalle stesse fonti - * del sito: src/data/studio.ts e src/content/servizi/*.md. + * I dati attesi (abilitazioni, servizi, P.IVA, professionisti, orari e giorni di apertura, + * dominio) sono letti dalle stesse fonti del sito: src/data/studio.ts, + * src/content/servizi/*.md e site.config.mjs. Così una modifica dei contenuti fatta come indica + * docs/CONTENUTI.md non fa fallire i controlli. */ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'; import { join, resolve } from 'node:path'; import { pathToFileURL } from 'node:url'; import { DomUtils, parseDocument } from 'htmlparser2'; +import { siteUrl } from '../site.config.mjs'; import { fileToPath, listHtmlFiles, readSitemapPaths } from './lib/pages.mjs'; import { root } from './lib/preview-server.mjs'; @@ -21,7 +24,7 @@ const { abilitazioni, professionisti, studio, contactForm } = await importSrc('s // stesso anno del footer: SOURCE_DATE_EPOCH, se impostata, altrimenti l'anno corrente const { buildYear } = await importSrc('src/lib/build.ts'); -const SITE = (process.env.SITE_URL || 'https://www.grassoezio.it').replace(/\/+$/, ''); +const SITE = siteUrl(); const PIVA = `P.IVA ${studio.partitaIva}`; const LEGAL_PAGES = ['/privacy-policy/', '/cookie-policy/', '/note-legali/', '/accessibilita/']; const NOINDEX_PAGES = ['/404.html', '/contatti/grazie/']; @@ -100,6 +103,24 @@ function closestBlock(node) { return n; } +/** Problemi di compatibilità nel CSS generato (pagina HTML o file .css). */ +function cssIssues(css) { + checks++; + const issues = []; + const range = css.match(/@media[^{]*\(\s*(?:width|height)\s*[<>]/); + if (range) { + issues.push( + `media query in sintassi a intervallo «${range[0]}…»: controllare vite.build.cssTarget in astro.config.mjs`, + ); + } + for (const block of css.match(/\{[^{}]*-webkit-backdrop-filter:[^{}]*\}/g) ?? []) { + if (!/[{;]\s*backdrop-filter:/.test(block)) { + issues.push(`-webkit-backdrop-filter senza backdrop-filter: «${block.slice(0, 80)}…»`); + } + } + return issues; +} + function ancestorWithAttr(node, name, value) { for (let n = getParent(node); n; n = getParent(n)) { if (isTag(n) && attr(n, name) === value) return n; @@ -201,10 +222,68 @@ const FORBIDDEN_REFS = [ ]; const COMMERCIALISTA_OK = /giulia|odcec|(ordine|consiglio nazionale) dei dottori commercialisti|\bocc\b|organismo di composizione della crisi/i; +const DICITURE_VIETATE = [ + 'studio commercialista', + 'studio di commercialisti', + 'studio di commercialista', + 'commercialista ezio', + 'ezio grasso, commercialista', + 'ezio grasso commercialista', +]; +const giulia = professionisti.find((p) => p.id === 'giulia-grasso'); + +/** + * Testi non visibili che finiscono nei risultati di ricerca, nelle anteprime o agli screen + * reader: meta (description, Open Graph, Twitter), attributi alt/title/aria-label e stringhe del + * JSON-LD, esclusa la scheda della Dott.ssa Giulia Grasso. Coppie [provenienza, testo]. + */ +function hiddenTexts(doc, ldNodes) { + const out = []; + for (const el of all(doc, (n) => n.name === 'meta')) { + const key = attr(el, 'name') ?? attr(el, 'property') ?? ''; + if (/^(description$|og:|twitter:)/.test(key)) + out.push([`meta ${key}`, attr(el, 'content') ?? '']); + } + for (const el of all(doc, () => true)) { + for (const n of ['alt', 'title', 'aria-label', 'data-map-title']) { + const v = attr(el, n); + if (v) out.push([`attributo ${n} di <${el.name}>`, v]); + } + } + const walk = (value, path) => { + if (typeof value === 'string') out.push([`JSON-LD ${path}`, value]); + else if (Array.isArray(value)) value.forEach((v, i) => walk(v, `${path}[${i}]`)); + else if (value && typeof value === 'object') { + if (value['@type'] === 'Person' && value.name === giulia?.nomeSenzaTitolo) return; + for (const [k, v] of Object.entries(value)) walk(v, `${path}.${k}`); + } + }; + for (const n of ldNodes) walk(n, String(n['@type'] ?? 'nodo')); + return out; +} const titles = new Map(); const descriptions = new Map(); const year = String(buildYear); +// orari e giorni di apertura: formato dei dati in studio.ts e valore atteso nel JSON-LD +const HHMM = /^([01]\d|2[0-3]):[0-5]\d$/; +for (const f of studio.orari.fasce) { + check( + HHMM.test(f.apertura) && HHMM.test(f.chiusura) && f.apertura < f.chiusura, + 'src/data/studio.ts', + `fascia oraria non valida «${f.apertura}–${f.chiusura}» (formato HH:MM, apertura prima della chiusura)`, + ); +} +check( + studio.orari.giorniSettimana.length > 0, + 'src/data/studio.ts', + 'orari.giorniSettimana vuoto: indicare i giorni di apertura', +); +const EXPECTED_HOURS = studio.orari.fasce + .map((f) => `${f.apertura}-${f.chiusura}`) + .sort() + .join(','); + for (const page of pages) { const { doc, file, path, html } = page; const where = `${file} (${path})`; @@ -383,14 +462,7 @@ for (const page of pages) { } } const lower = normalize(text).toLowerCase(); - for (const bad of [ - 'studio commercialista', - 'studio di commercialisti', - 'studio di commercialista', - 'commercialista ezio', - 'ezio grasso, commercialista', - 'ezio grasso commercialista', - ]) { + for (const bad of DICITURE_VIETATE) { check(!lower.includes(bad), where, `dicitura vietata «${bad}»`); } @@ -414,6 +486,24 @@ for (const page of pages) { fail(where, `JSON-LD non valido: ${e.message}`); } } + + // «commercialista» anche nei testi non visibili (meta, attributi, JSON-LD): ogni stringa è + // controllata da sola, con le stesse regole del testo visibile + for (const [origin, value] of hiddenTexts(doc, nodes)) { + const t = normalize(value); + if (!/commercialist/i.test(t)) continue; + for (const s of sentences(t).filter((x) => /commercialist/i.test(x))) { + check( + COMMERCIALISTA_OK.test(s), + where, + `«commercialista» usato fuori contesto in ${origin} (ammesso solo per la Dott.ssa Giulia Grasso, ODCEC, OCC): «${s}»`, + ); + } + for (const bad of DICITURE_VIETATE) { + check(!t.toLowerCase().includes(bad), where, `dicitura vietata «${bad}» in ${origin}`); + } + } + const org = nodes.find((n) => n['@type'] === 'AccountingService'); if (check(Boolean(org), where, 'JSON-LD: manca AccountingService')) { for (const k of [ @@ -461,10 +551,17 @@ for (const page of pages) { .sort() .join(','); check( - hours === '09:00-12:30,15:00-18:30', + hours === EXPECTED_HOURS, where, - `JSON-LD: orari attesi 09:00-12:30 e 15:00-18:30, trovati ${hours}`, + `JSON-LD: orari attesi ${EXPECTED_HOURS} (studio.orari.fasce), trovati ${hours}`, ); + for (const h of org.openingHoursSpecification ?? []) { + check( + JSON.stringify(h.dayOfWeek) === JSON.stringify(studio.orari.giorniSettimana), + where, + `JSON-LD: giorni di apertura ${JSON.stringify(h.dayOfWeek)} diversi da studio.orari.giorniSettimana`, + ); + } const people = (org.employee ?? org.founder ?? []).filter((p) => p['@type'] === 'Person'); check(people.length === professionisti.length, where, 'JSON-LD: professionisti mancanti'); for (const p of professionisti) { @@ -491,6 +588,14 @@ for (const page of pages) { } } + // CSS compatibile con i browser di vite.build.cssTarget (astro.config.mjs): media query con + // min-/max-width (la sintassi a intervallo non funziona su Safari/iOS < 16.4) e + // backdrop-filter anche senza prefisso (Chrome, Edge e Firefox ignorano -webkit-) + for (const issue of cssIssues(html)) fail(where, issue); + + // nulla dopo (es. uno + {/* dentro il layout: scritto dopo finirebbe dopo (HTML non valido) */} + + diff --git a/src/scripts/form.ts b/src/scripts/form.ts index f93ba12..185dec7 100644 --- a/src/scripts/form.ts +++ b/src/scripts/form.ts @@ -1,8 +1,11 @@ /** * Miglioramento del modulo di contatto: messaggi di validazione in italiano accanto ai campi, - * riepilogo degli errori annunciato agli screen reader, campo `ts` con l'ora di apertura della - * pagina e blocco degli invii troppo rapidi (anti-spam senza cookie). Senza JavaScript il modulo - * usa la validazione nativa del browser. + * riepilogo degli errori annunciato agli screen reader, campi `ts` (apertura della pagina) e + * `ts_invio` (invio) con l'orologio del dispositivo, così contact.php misura la durata senza + * confrontare due orologi diversi, e blocco degli invii troppo rapidi (anti-spam senza cookie). + * La validazione segue le regole di contact.php (spazi iniziali e finali esclusi, e-mail con + * dominio completo), così il server non rifiuta un modulo che il browser ha accettato. + * Senza JavaScript il modulo usa la validazione nativa del browser. */ /** Testi in src/data/testi.ts (`modulo.errori`), passati dal componente in `data-messages`. */ @@ -20,14 +23,26 @@ interface Messages { type Field = HTMLInputElement | HTMLTextAreaElement; +function tooShort(field: Field, m: Messages): string { + return field.type === 'tel' ? m.telefono : m.breve.replace('{min}', String(field.minLength)); +} + function messageFor(field: Field, m: Messages): string | null { + if (field instanceof HTMLInputElement && field.type === 'checkbox') { + return field.checked ? null : m.presaVisione; + } + // come contact.php: gli spazi iniziali e finali non contano (un campo di soli spazi è vuoto) + const value = field.value.trim(); + if (value === '') return m.obbligatorio; + // caratteri contati come in PHP (mb_strlen): un'emoji vale 1, non 2 come in value.length + if (field.minLength > 0 && Array.from(value).length < field.minLength) { + return tooShort(field, m); + } const v = field.validity; if (v.valid) return null; - if (field instanceof HTMLInputElement && field.type === 'checkbox') return m.presaVisione; - if (v.valueMissing) return m.obbligatorio; - if (v.typeMismatch && field.type === 'email') return m.email; + if (field.type === 'email' && (v.typeMismatch || v.patternMismatch)) return m.email; if (field.type === 'tel' && (v.patternMismatch || v.tooShort || v.tooLong)) return m.telefono; - if (v.tooShort) return m.breve; + if (v.tooShort) return tooShort(field, m); return field.validationMessage || m.obbligatorio; } @@ -59,6 +74,7 @@ function init(form: HTMLFormElement): void { const minMs = Number(form.dataset.minSeconds ?? '3') * 1000; const ts = form.querySelector('[data-form-ts]'); if (ts) ts.value = String(loadedAt); + const tsInvio = form.querySelector('[data-form-ts-invio]'); const summary = form.querySelector('[data-form-summary]'); const summaryList = form.querySelector('[data-form-summary-list]'); @@ -127,13 +143,15 @@ function init(form: HTMLFormElement): void { if (summary) summary.hidden = true; - if (Date.now() - loadedAt < minMs) { + const now = Date.now(); + if (now - loadedAt < minMs) { event.preventDefault(); if (status) status.textContent = m.rapido; showNotice(m.rapido); return; } + if (tsInvio) tsInvio.value = String(now); if (status) status.textContent = m.invio; }); } diff --git a/src/styles/global.css b/src/styles/global.css index 5ee6db1..8c5caf0 100644 --- a/src/styles/global.css +++ b/src/styles/global.css @@ -121,7 +121,7 @@ button { } :focus-visible { - outline: 3px solid var(--gold-500); + outline: 3px solid var(--focus-ring); outline-offset: 3px; border-radius: 4px; } @@ -252,8 +252,9 @@ button { max-width: var(--measure); } +/* le chip (valori in home) hanno il proprio colore, --gold-800 */ .prose p:not(.eyebrow), -.prose li { +.prose li:not(.chip) { color: var(--ink-700); } diff --git a/src/styles/print.css b/src/styles/print.css index 85d4d59..6d9b1b6 100644 --- a/src/styles/print.css +++ b/src/styles/print.css @@ -23,8 +23,7 @@ .mobile-menu, .skip-link, .cta-band, - .map-consent__actions, - .map-consent__frame, + .map-consent, .sidenav, .pager, .hero__visual, diff --git a/src/styles/tokens.css b/src/styles/tokens.css index d71f6c7..1fbf97c 100644 --- a/src/styles/tokens.css +++ b/src/styles/tokens.css @@ -31,6 +31,11 @@ --on-dark: rgba(255, 255, 255, 0.86); --on-dark-muted: rgba(255, 255, 255, 0.74); + /* anello di focus (WCAG 1.4.11, ≥ 3:1 con il fondo): gold-700 sui fondi chiari (≥ 4,28:1); + i contenitori navy (barra superiore, footer, banda CTA, riquadro dei servizi) lo + ridefiniscono a gold-500 (≥ 4,9:1), perché gold-700 sul navy arriva solo a 2,9:1 */ + --focus-ring: var(--gold-700); + /* --- tipografia --- */ --font-display: 'Fraunces', Georgia, 'Times New Roman', serif; --font-body: diff --git a/tests/a11y/keyboard.spec.ts b/tests/a11y/keyboard.spec.ts index 8d2eae1..22094df 100644 --- a/tests/a11y/keyboard.spec.ts +++ b/tests/a11y/keyboard.spec.ts @@ -3,19 +3,90 @@ * mobile usabili con la tastiera, focus sempre visibile, testo ridimensionabile, reflow a 320 px. */ import { expect, test, type Page } from '@playwright/test'; -import { ALL_PAGES } from '../helpers/site'; +import { ALL_PAGES, SERVICE_PAGES } from '../helpers/site'; -/** Vero se l'elemento attivo ha un indicatore di focus visibile (outline su sé o su ::after). */ -async function focusIsVisible(page: Page): Promise<{ ok: boolean; what: string }> { +/** + * Indicatore di focus dell'elemento attivo: deve esserci (outline su sé o su ::after, oppure un + * box-shadow) e l'outline deve avere un contrasto di almeno 3:1 con il fondo su cui si trova + * (WCAG 1.4.11). Con outline-offset l'anello sta fuori dall'elemento: il fondo è quello del primo + * antenato con un colore di sfondo, composto con i fondi semitrasparenti sopra di esso; per i + * gradienti vale il colore meno favorevole. + */ +async function focusIsVisible( + page: Page, +): Promise<{ ok: boolean; what: string; contrast: number | null }> { return page.evaluate(() => { + type Rgba = [number, number, number, number]; const el = document.activeElement as HTMLElement | null; - if (!el || el === document.body) return { ok: false, what: 'nessun elemento con il focus' }; - const has = (s: CSSStyleDeclaration) => - (s.outlineStyle !== 'none' && parseFloat(s.outlineWidth) > 0) || - (s.boxShadow !== 'none' && s.boxShadow !== ''); - const ok = has(getComputedStyle(el)) || has(getComputedStyle(el, '::after')); + if (!el || el === document.body) { + return { ok: false, what: 'nessun elemento con il focus', contrast: null }; + } const what = `${el.tagName.toLowerCase()}${el.id ? '#' + el.id : ''}.${String(el.className).split(' ')[0]} «${(el.textContent ?? '').trim().slice(0, 40)}»`; - return { ok, what }; + + const colors = (css: string): Rgba[] => + [...css.matchAll(/rgba?\(([^)]+)\)/g)].map((m) => { + const p = m[1] + .split(/[\s,/]+/) + .filter(Boolean) + .map(Number); + return [p[0], p[1], p[2], p.length > 3 ? p[3] : 1]; + }); + const over = (top: Rgba, under: Rgba): Rgba => [ + top[0] * top[3] + under[0] * (1 - top[3]), + top[1] * top[3] + under[1] * (1 - top[3]), + top[2] * top[3] + under[2] * (1 - top[3]), + 1, + ]; + const luminance = ([r, g, b]: Rgba) => { + const [lr, lg, lb] = [r, g, b].map((v) => { + const c = v / 255; + return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4; + }); + return 0.2126 * lr + 0.7152 * lg + 0.0722 * lb; + }; + const ratio = (a: Rgba, b: Rgba) => { + const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x); + return (hi + 0.05) / (lo + 0.05); + }; + /** Colori possibili del fondo dietro `start` (più di uno con un gradiente). */ + const backgrounds = (start: Element | null): Rgba[] => { + const layers: Rgba[] = []; // fondi semitrasparenti, dal più vicino al più lontano + let base: Rgba[] | null = null; + for (let n = start; n && !base; n = n.parentElement) { + const s = getComputedStyle(n); + const stops = s.backgroundImage === 'none' ? [] : colors(s.backgroundImage); + if (stops.length) { + base = stops.map((c) => over(c, [255, 255, 255, 1])); + break; + } + const c = colors(s.backgroundColor)[0]; + if (c && c[3] >= 1) base = [c]; + else if (c && c[3] > 0) layers.push(c); + } + return (base ?? [[255, 255, 255, 1]]).map((b) => + layers.reduceRight((acc, l) => over(l, acc), b), + ); + }; + + const self = getComputedStyle(el); + const after = getComputedStyle(el, '::after'); + const hasOutline = (s: CSSStyleDeclaration) => + s.outlineStyle !== 'none' && parseFloat(s.outlineWidth) > 0; + let ring: Rgba | undefined; + let start: Element | null = null; + if (hasOutline(self)) { + ring = colors(self.outlineColor)[0]; + start = el.parentElement; + } else if (hasOutline(after)) { + // ::after in posizione assoluta (card): l'anello circonda il contenitore posizionato + ring = colors(after.outlineColor)[0]; + start = (el.offsetParent ?? el).parentElement; + } else if (self.boxShadow !== 'none' && self.boxShadow !== '') { + return { ok: true, what, contrast: null }; // indicatore con ombra: contrasto non misurato + } + if (!ring) return { ok: false, what, contrast: null }; + const contrast = Math.min(...backgrounds(start).map((b) => ratio(ring, b))); + return { ok: contrast >= 3, what, contrast: Math.round(contrast * 100) / 100 }; }); } @@ -62,10 +133,21 @@ test('sottomenu desktop: apertura con Invio, navigazione con Tab, chiusura con E await expect(toggle).toBeFocused(); await expect(toggle).toHaveAttribute('aria-expanded', 'false'); - // uscendo dal sottomenu con Tab il sottomenu si chiude + // uscendo dal sottomenu con Tab il sottomenu si chiude (qualunque sia il numero di servizi) await page.keyboard.press('Enter'); await expect(submenu).toBeVisible(); - for (let i = 0; i < 7; i++) await page.keyboard.press('Tab'); + let tabs = 0; + for (; tabs < SERVICE_PAGES.length + 5; tabs++) { + await page.keyboard.press('Tab'); + const inside = await page.evaluate(() => { + const a = document.activeElement; + return ( + !!a && (a.closest('#sottomenu-servizi') !== null || a.matches('[data-submenu-toggle]')) + ); + }); + if (!inside) break; + } + expect(tabs, 'un Tab per ogni servizio del sottomenu, poi si esce').toBe(SERVICE_PAGES.length); await expect(submenu).toBeHidden(); }); @@ -127,8 +209,10 @@ test('menu mobile: apertura con Invio, focus intrappolato nel menu, chiusura con await expect(toggle).toHaveAttribute('aria-expanded', 'false'); }); -for (const path of ['/', '/servizi/', '/contatti/', '/dove-siamo/']) { - test(`focus visibile su ogni elemento raggiungibile con Tab in ${path}`, async ({ page }) => { +for (const path of ['/', '/servizi/', SERVICE_PAGES[0], '/contatti/', '/dove-siamo/']) { + test(`focus visibile e contrastato su ogni elemento raggiungibile con Tab in ${path}`, async ({ + page, + }) => { await page.setViewportSize({ width: 1440, height: 900 }); await page.goto(path); const total = await page @@ -144,9 +228,12 @@ for (const path of ['/', '/servizi/', '/contatti/', '/dove-siamo/']) { const seen: string[] = []; for (let i = 0; i < total; i++) { await page.keyboard.press('Tab'); - const { ok, what } = await focusIsVisible(page); + const { ok, what, contrast } = await focusIsVisible(page); seen.push(what); - expect(ok, `focus non visibile su ${what} (Tab n. ${i + 1}) in ${path}`).toBe(true); + expect( + ok, + `focus non visibile o poco contrastato (${contrast ?? '—'}:1, minimo 3:1) su ${what} (Tab n. ${i + 1}) in ${path}`, + ).toBe(true); } }); } diff --git a/tests/e2e/form.spec.ts b/tests/e2e/form.spec.ts index 99698d4..89d3937 100644 --- a/tests/e2e/form.spec.ts +++ b/tests/e2e/form.spec.ts @@ -2,8 +2,12 @@ * Modulo di contatto (brief §10.1, §11.4). Con `contactForm.mode = 'off'` (predefinito) si * verifica la card «Scrivici una e-mail»; con il modulo attivo (CONTACT_FORM_MODE=php o * endpoint nella build) si verificano validazione, honeypot, tempo minimo e pagina di conferma. + * Testi e recapiti attesi sono letti dalle stesse fonti del sito (src/data). */ import { expect, test } from '@playwright/test'; +import { grazie } from '../../src/data/pagine'; +import { studio } from '../../src/data/studio'; +import { modulo, scriviEmail } from '../../src/data/testi'; test('contatti: modulo oppure card e-mail, a seconda della configurazione', async ({ page }) => { await page.goto('/contatti/'); @@ -11,11 +15,9 @@ test('contatti: modulo oppure card e-mail, a seconda della configurazione', asyn if (forms === 0) { const card = page.locator('[data-contact-mode="off"]'); await expect(card).toBeVisible(); - await expect(card.getByRole('heading', { name: 'Scrivici una e-mail' })).toBeVisible(); + await expect(card.getByRole('heading', { name: scriviEmail.titolo })).toBeVisible(); const href = await card.locator('a[href^="mailto:"]').getAttribute('href'); - expect(href).toBe( - `mailto:info@studiograssoezio.it?subject=${encodeURIComponent('Richiesta di informazioni dal sito')}`, - ); + expect(href).toBe(`mailto:${studio.email}?subject=${encodeURIComponent(scriviEmail.oggetto)}`); } else { await expect(page.locator('form[data-contact-form]')).toBeVisible(); } @@ -30,13 +32,7 @@ test.describe('modulo attivo', () => { test('campi obbligatori, etichette e informativa', async ({ page }) => { const form = page.locator('form[data-contact-form]'); - for (const label of [ - 'Nome e cognome', - 'E-mail', - 'Telefono / Cellulare', - 'Oggetto', - 'Messaggio', - ]) { + for (const { label } of Object.values(modulo.campi)) { const field = form.getByLabel(label); await expect(field, `campo «${label}»`).toBeVisible(); await expect(field, `campo «${label}» obbligatorio`).toHaveAttribute('required', ''); @@ -47,7 +43,7 @@ test.describe('modulo attivo', () => { 'href', '/privacy-policy/', ); - await expect(form).toContainText('* campo obbligatorio'); + await expect(form).toContainText(modulo.legenda); }); test('honeypot nascosto e campo ts valorizzato', async ({ page }) => { @@ -57,24 +53,52 @@ test.describe('modulo attivo', () => { await expect(page.locator('.contact-form__trap')).toHaveAttribute('aria-hidden', 'true'); const ts = await page.locator('input[name="ts"]').inputValue(); expect(Number(ts), 'timestamp di apertura della pagina').toBeGreaterThan(1_600_000_000_000); + await expect(page.locator('input[name="ts_invio"]')).toHaveValue(''); }); test('invio vuoto: errori in italiano accanto ai campi e riepilogo', async ({ page }) => { - await page.getByRole('button', { name: /Invia la richiesta/ }).click(); + await page.getByRole('button', { name: modulo.invia }).click(); const summary = page.locator('[data-form-summary]'); await expect(summary).toBeVisible(); await expect(summary).toBeFocused(); - await expect(summary).toContainText('Controlla i campi evidenziati'); + await expect(summary).toContainText(modulo.errori.titolo); await expect(page.locator('#cf-nome')).toHaveAttribute('aria-invalid', 'true'); - await expect(page.locator('#cf-nome-err')).toHaveText('Compila questo campo.'); - await expect(page.locator('#cf-privacy-err')).toContainText('informativa sulla privacy'); + await expect(page.locator('#cf-nome-err')).toHaveText(modulo.errori.obbligatorio); + await expect(page.locator('#cf-privacy-err')).toHaveText(modulo.errori.presaVisione); await expect(page).toHaveURL('/contatti/'); }); - test('e-mail non valida', async ({ page }) => { - await page.locator('#cf-email').fill('non-valida'); - await page.locator('#cf-email').blur(); - await expect(page.locator('#cf-email-err')).toContainText('indirizzo e-mail valido'); + test('e-mail non valida, anche senza dominio completo (rifiutata da contact.php)', async ({ + page, + }) => { + const email = page.locator('#cf-email'); + for (const value of [ + 'non-valida', + 'mario.rossi@gmail', + 'mario..rossi@esempio.it', + 'mario.rossi@esempio.1t', + `${'a'.repeat(65)}@esempio.it`, + ]) { + await email.fill(value); + await email.blur(); + await expect(page.locator('#cf-email-err'), `«${value}»`).toHaveText(modulo.errori.email); + } + await email.fill('mario.rossi@esempio.it'); + expect(await email.evaluate((el: HTMLInputElement) => el.validity.valid)).toBe(true); + }); + + test('campi di soli spazi e messaggio breve: stessi controlli di contact.php', async ({ + page, + }) => { + await page.locator('#cf-nome').fill(' '); + await page.locator('#cf-nome').blur(); + await expect(page.locator('#cf-nome-err')).toHaveText(modulo.errori.obbligatorio); + // 12 caratteri, ma solo 4 senza gli spazi iniziali e finali + await page.locator('#cf-messaggio').fill(' ciao '); + await page.locator('#cf-messaggio').blur(); + await expect(page.locator('#cf-messaggio-err')).toHaveText( + modulo.errori.breve.replace('{min}', '10'), + ); }); test('telefono non valido: messaggio accanto al campo', async ({ page }) => { @@ -82,7 +106,7 @@ test.describe('modulo attivo', () => { await tel.fill('abcdefgh'); await tel.blur(); expect(await tel.evaluate((el: HTMLInputElement) => el.validity.patternMismatch)).toBe(true); - await expect(page.locator('#cf-telefono-err')).toContainText('numero di telefono valido'); + await expect(page.locator('#cf-telefono-err')).toHaveText(modulo.errori.telefono); await tel.fill('+39 (0141) 951-382'); expect(await tel.evaluate((el: HTMLInputElement) => el.validity.valid)).toBe(true); }); @@ -91,12 +115,14 @@ test.describe('modulo attivo', () => { // invio simulato all'indirizzo reale del modulo (/contact.php oppure il servizio esterno) const action = await page.locator('form[data-contact-form]').getAttribute('action'); const target = new URL(action ?? '', page.url()).href; - await page.route(target, (route) => - route.fulfill({ + let inviato = ''; + await page.route(target, (route) => { + inviato = route.request().postData() ?? ''; + return route.fulfill({ status: 303, headers: { Location: new URL('/contatti/grazie/', page.url()).href }, - }), - ); + }); + }); await page.locator('#cf-nome').fill('Mario Rossi'); await page.locator('#cf-email').fill('mario.rossi@example.com'); await page.locator('#cf-telefono').fill('+39 0141 000000'); @@ -107,15 +133,20 @@ test.describe('modulo attivo', () => { await page.locator('#cf-privacy').check(); // primo invio entro 3 secondi dall'apertura della pagina: bloccato dall'anti-spam - await page.getByRole('button', { name: /Invia la richiesta/ }).click(); - await expect(page.locator('[data-form-status]')).toHaveText(/Attendi qualche secondo/); + await page.getByRole('button', { name: modulo.invia }).click(); + await expect(page.locator('[data-form-status]')).toHaveText(modulo.errori.rapido); await expect(page.locator('[data-form-notice]')).toBeVisible(); - await expect(page.locator('[data-form-notice]')).toHaveText(/Attendi qualche secondo/); + await expect(page.locator('[data-form-notice]')).toHaveText(modulo.errori.rapido); await expect(page).toHaveURL('/contatti/'); await page.waitForTimeout(3_200); - await page.getByRole('button', { name: /Invia la richiesta/ }).click(); + await page.getByRole('button', { name: modulo.invia }).click(); await expect(page).toHaveURL('/contatti/grazie/'); - await expect(page.locator('h1')).toHaveText('Richiesta inviata'); + await expect(page.locator('h1')).toHaveText(grazie.titolo); + + // durata misurata con l'orologio del dispositivo: ts all'apertura, ts_invio all'invio + const dati = new URLSearchParams(inviato); + const durata = Number(dati.get('ts_invio')) - Number(dati.get('ts')); + expect(durata, 'ts_invio − ts (millisecondi)').toBeGreaterThanOrEqual(3_000); }); }); diff --git a/tests/e2e/mobile-menu.spec.ts b/tests/e2e/mobile-menu.spec.ts index a3d0cd0..e140920 100644 --- a/tests/e2e/mobile-menu.spec.ts +++ b/tests/e2e/mobile-menu.spec.ts @@ -2,6 +2,7 @@ * Menu mobile a 390 px (brief §5.2): apertura e chiusura, aria-expanded, Esc, focus, sottomenu. */ import { expect, test } from '@playwright/test'; +import { navPrincipale } from '../../src/data/navigazione'; import { SERVICE_PAGES } from '../helpers/site'; test.use({ viewport: { width: 390, height: 844 }, isMobile: true, hasTouch: true }); @@ -21,7 +22,7 @@ test('il menu mobile si apre e si chiude', async ({ page }) => { await expect(menu).toBeVisible(); await expect(toggle).toHaveAttribute('aria-expanded', 'true'); await expect(page.locator('[data-menu-close]')).toBeFocused(); - for (const label of ['Lo studio', 'Servizi', 'Contatti', 'Dove siamo', 'Link utili']) { + for (const { label } of navPrincipale) { await expect(menu.getByRole('link', { name: label, exact: true })).toBeVisible(); } await expect(menu.locator('a[href^="tel:"]')).toBeVisible(); diff --git a/tests/e2e/navigation.spec.ts b/tests/e2e/navigation.spec.ts index d7a6b4f..bef361e 100644 --- a/tests/e2e/navigation.spec.ts +++ b/tests/e2e/navigation.spec.ts @@ -3,15 +3,12 @@ * breadcrumb, precedente/successivo e redirect delle ancore del vecchio sito. */ import { expect, test } from '@playwright/test'; +import { ctaHeader, navLegale, navPrincipale } from '../../src/data/navigazione'; import { SERVICE_PAGES } from '../helpers/site'; -const MAIN_NAV = [ - { label: 'Lo studio', path: '/studio/' }, - { label: 'Servizi', path: '/servizi/' }, - { label: 'Contatti', path: '/contatti/' }, - { label: 'Dove siamo', path: '/dove-siamo/' }, - { label: 'Link utili', path: '/link-utili/' }, -]; +// voci lette dalla stessa fonte del sito: cambiare un'etichetta non rompe i test +const MAIN_NAV = navPrincipale.map((v) => ({ label: v.label, path: v.href })); +const SERVIZI = navPrincipale.find((v) => v.servizi)?.label ?? 'Servizi'; test('le voci dell’intestazione portano alle pagine giuste', async ({ page }) => { for (const item of MAIN_NAV) { @@ -29,18 +26,20 @@ test('le voci dell’intestazione portano alle pagine giuste', async ({ page }) } }); -test('logo e pulsante «Richiedi un preventivo»', async ({ page }) => { +test(`logo e pulsante «${ctaHeader.label}»`, async ({ page }) => { await page.goto('/studio/'); await page.locator('header .brand').first().click(); await expect(page).toHaveURL('/'); await page .getByRole('navigation', { name: 'Principale' }) - .getByRole('link', { name: 'Richiedi un preventivo' }) + .getByRole('link', { name: ctaHeader.label }) .click(); - await expect(page).toHaveURL('/contatti/'); + await expect(page).toHaveURL(ctaHeader.href); }); -test('il sottomenu «Servizi» elenca i 6 servizi e si apre con il pulsante', async ({ page }) => { +test('il sottomenu «Servizi» elenca tutti i servizi e si apre con il pulsante', async ({ + page, +}) => { await page.goto('/'); const toggle = page.locator('.nav [data-submenu-toggle]'); const submenu = page.locator('#sottomenu-servizi'); @@ -53,7 +52,7 @@ test('il sottomenu «Servizi» elenca i 6 servizi e si apre con il pulsante', as await expect(page).toHaveURL(/\/servizi\/[a-z-]+\/$/); await expect( page.getByRole('navigation', { name: 'Principale' }).getByRole('link', { - name: 'Servizi', + name: SERVIZI, exact: true, }), ).toHaveAttribute('aria-current', 'true'); @@ -85,12 +84,13 @@ test('tutti i link del footer funzionano', async ({ page, request }) => { const response = await request.get(href); expect(response.status(), `link del footer ${href}`).toBe(200); } - for (const label of ['Privacy policy', 'Cookie policy', 'Note legali', 'Accessibilità']) { - await expect( - page.getByRole('navigation', { name: 'Informazioni legali' }).getByRole('link', { - name: label, - }), - ).toBeVisible(); + for (const { label, href } of navLegale) { + const link = page.getByRole('navigation', { name: 'Informazioni legali' }).getByRole('link', { + name: label, + exact: true, + }); + await expect(link).toBeVisible(); + await expect(link).toHaveAttribute('href', href); } }); @@ -129,7 +129,8 @@ test('le ancore del vecchio sito portano al servizio corrispondente', async ({ p .evaluateAll((els) => els.map((el) => ({ id: el.id, href: el.getAttribute('data-legacy-href') })), ); - expect(cards.length, 'card con ancora del vecchio sito').toBe(6); + // una card per servizio (i 6 del brief e quelli aggiunti dopo), ognuna con la sua ancora + expect(cards.length, 'card con ancora del vecchio sito').toBe(SERVICE_PAGES.length); for (const { id, href } of cards) { await page.goto(`/servizi/#${id}`); await expect(page, `l'ancora #${id} porta a ${href}`).toHaveURL(href ?? ''); diff --git a/tests/e2e/privacy.spec.ts b/tests/e2e/privacy.spec.ts index 83004cf..ed88461 100644 --- a/tests/e2e/privacy.spec.ts +++ b/tests/e2e/privacy.spec.ts @@ -3,8 +3,12 @@ * nessun cookie, localStorage vuoto, mappa Google caricata solo dopo il clic. */ import { expect, test } from '@playwright/test'; +import { navPrincipale } from '../../src/data/navigazione'; import { ALL_PAGES, isLocalRequest, stubGoogle } from '../helpers/site'; +/** Etichetta della voce di menu che porta a `href` (stessa fonte del sito). */ +const voce = (href: string) => navPrincipale.find((v) => v.href === href)?.label ?? href; + test('nessuna richiesta verso host esterni, nessun cookie e localStorage vuoto', async ({ page, context, @@ -96,7 +100,9 @@ test('senza JavaScript restano i link esterni della mappa e la navigazione', asy await expect(page.locator('iframe')).toHaveCount(0); await page.goto('/'); await expect( - page.getByRole('navigation', { name: 'Principale' }).getByRole('link', { name: 'Lo studio' }), + page + .getByRole('navigation', { name: 'Principale' }) + .getByRole('link', { name: voce('/studio/'), exact: true }), ).toBeVisible(); await context.close(); }); @@ -110,7 +116,7 @@ test('senza JavaScript il menu è navigabile anche su mobile', async ({ browser await page.goto('/'); await expect(page.locator('[data-menu-open]')).toBeHidden(); const menu = page.getByRole('navigation', { name: 'Menu mobile' }); - await expect(menu.getByRole('link', { name: 'Contatti', exact: true })).toBeVisible(); + await expect(menu.getByRole('link', { name: voce('/contatti/'), exact: true })).toBeVisible(); await expect(menu.locator('#menu-mobile-servizi a').first()).toBeVisible(); await context.close(); }); diff --git a/tests/e2e/smoke.spec.ts b/tests/e2e/smoke.spec.ts index 7d07fc2..1d5dd98 100644 --- a/tests/e2e/smoke.spec.ts +++ b/tests/e2e/smoke.spec.ts @@ -3,6 +3,7 @@ * titolo e descrizione presenti e unici, canonical corretto, nessun errore in console. */ import { expect, test } from '@playwright/test'; +import { grazie, paginaNonTrovata } from '../../src/data/pagine'; import { ALL_PAGES, EXTRA_PAGES, SITE, collectConsoleErrors } from '../helpers/site'; for (const path of ALL_PAGES) { @@ -58,7 +59,7 @@ test('titoli e descrizioni sono unici su tutto il sito', async ({ page }) => { test('un indirizzo inesistente mostra la pagina 404 personalizzata', async ({ page }) => { const response = await page.goto('/pagina-che-non-esiste/'); expect(response?.status(), 'stato HTTP di un indirizzo inesistente').toBe(404); - await expect(page.locator('h1')).toHaveText('Pagina non trovata'); + await expect(page.locator('h1')).toHaveText(paginaNonTrovata.titolo); const main = page.locator('main'); for (const href of ['/', '/servizi/', '/contatti/']) { await expect(main.locator(`a[href="${href}"]`), `link a ${href} nella 404`).toHaveCount(1); @@ -68,6 +69,6 @@ test('un indirizzo inesistente mostra la pagina 404 personalizzata', async ({ pa test('la pagina di conferma del modulo è noindex', async ({ page }) => { await page.goto('/contatti/grazie/'); - await expect(page.locator('h1')).toHaveText('Richiesta inviata'); + await expect(page.locator('h1')).toHaveText(grazie.titolo); await expect(page.locator('meta[name="robots"]')).toHaveAttribute('content', /noindex/); }); diff --git a/tests/helpers/site.ts b/tests/helpers/site.ts index 9686846..01a1941 100644 --- a/tests/helpers/site.ts +++ b/tests/helpers/site.ts @@ -5,8 +5,9 @@ import { existsSync, readFileSync } from 'node:fs'; import { resolve } from 'node:path'; import type { Page } from '@playwright/test'; +import { siteUrl } from '../../site.config.mjs'; -export const SITE = (process.env.SITE_URL || 'https://www.grassoezio.it').replace(/\/+$/, ''); +export const SITE = siteUrl(); const DIST = resolve(import.meta.dirname, '..', '..', 'dist'); function locs(xml: string): string[] {