From 3befe7e266be90928ba094395f41295ddbbf0d88 Mon Sep 17 00:00:00 2001 From: Alberto Balbo Date: Fri, 16 Oct 2026 13:40:16 +0200 Subject: [PATCH] fix: CI adattata a Forgejo, revisione completa del codice e avvio in debug MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi del sito, dei controlli e della documentazione. CI e rilascio: - continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno irraggiungibile avrebbe reso rossa la CI; - artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati); - token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico; - dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL; - ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server; sostituzione dei file senza mai lasciarli mancanti; - tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip). Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe, giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati. Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail, a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante MODALITA_PREDEFINITA per attivarlo. Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore, «commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive, HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test. Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso), deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata, procedura nginx che toglie i file delle versioni precedenti. Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il debugger collegato. Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e decisioni D-045…D-055. Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root); job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in Docker; release-upload.sh e deploy di esempio contro API e shell simulate. Co-Authored-By: Claude Opus 5.5 --- .forgejo/workflows/ci.yml | 23 ++- .forgejo/workflows/release.yml | 25 +-- .gitignore | 2 + .vscode/launch.json | 73 +++++++++ .vscode/tasks.json | 14 ++ CHANGELOG.md | 19 +++ DECISIONS.md | 181 +++++++++++++++++++++ README.md | 49 ++++-- TODO-STUDIO.md | 44 ++--- astro.config.mjs | 13 +- deploy/forgejo-deploy.yml.example | 107 +++++++++++- deploy/nginx.conf.example | 48 +++--- deploy/optional-php-form/contact.php | 73 ++++++--- docs/CONFORMITA.md | 32 ++-- docs/CONTENUTI.md | 11 +- docs/DEPLOY.md | 50 +++--- public/.htaccess | 2 + scripts/check-compliance.mjs | 235 ++++++++++++++++++++++++--- scripts/check-links.mjs | 3 +- scripts/package.mjs | 24 ++- scripts/release-upload.sh | 81 ++++++--- scripts/screenshots.mjs | 7 +- site.config.mjs | 17 ++ src/components/ContactForm.astro | 23 ++- src/components/ContactInfo.astro | 12 +- src/components/CtaBand.astro | 1 + src/components/Footer.astro | 7 +- src/components/Header.astro | 11 +- src/components/LegalDocument.astro | 3 +- src/components/Nav.astro | 41 +++-- src/components/SedeCard.astro | 16 +- src/components/ServiceCard.astro | 2 +- src/data/studio.ts | 37 +++-- src/data/testi.ts | 6 +- src/lib/format.ts | 20 ++- src/lib/seo.ts | 2 +- src/pages/contatti/index.astro | 5 +- src/pages/servizi/[slug].astro | 4 +- src/pages/servizi/index.astro | 9 +- src/scripts/form.ts | 34 +++- src/styles/global.css | 5 +- src/styles/print.css | 3 +- src/styles/tokens.css | 5 + tests/a11y/keyboard.spec.ts | 117 +++++++++++-- tests/e2e/form.spec.ts | 91 +++++++---- tests/e2e/mobile-menu.spec.ts | 3 +- tests/e2e/navigation.spec.ts | 39 ++--- tests/e2e/privacy.spec.ts | 10 +- tests/e2e/smoke.spec.ts | 5 +- tests/helpers/site.ts | 3 +- 50 files changed, 1309 insertions(+), 338 deletions(-) create mode 100644 .vscode/launch.json create mode 100644 .vscode/tasks.json create mode 100644 site.config.mjs 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[] {