7 Commits
Author SHA1 Message Date
Alby96andClaude Opus 5.5 52b0693185 feat: rework grafico 1.1.0, palchi scuri e movimento legato allo scorrimento
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Successful in 22m18s
CI / Link esterni (non bloccante) (push) Successful in 2m42s
Release / Zip del sito e pubblicazione (push) Successful in 5m42s
Il committente ha chiesto un sito più moderno, con pagine ed effetti di
scorrimento di alto livello. La palette e i font restano gli stessi; cambia il
linguaggio visivo (DECISIONS.md, D-058):

- palchi navy arrotondati per hero, testate, credenziali, banda CTA e footer;
  servizi in griglia bento con la prima card in evidenza; nuova sezione «Come
  lavoriamo»; fascia di numeri ricavati dai dati; menu mobile a tutto schermo;
  indice laterale fermo nelle pagine legali, che segue la lettura (toc.ts);
- movimento solo CSS (scroll-driven animations e View Transitions), dentro
  @supports e prefers-reduced-motion: senza supporto o con «riduci movimento»
  tutto resta fermo e visibile. La comparsa usa solo spostamento e scala, mai
  l'opacità, che lasciava semitrasparente il testo sul bordo della finestra;
- budget di 120 KB rispettato con lo scoping a classi, il marchio richiamato
  con <use> e gli stili di checklist e documenti in file separati;
- compatibilità con Safari/iOS 15 e Firefox: overflow: clip in un blocco
  @supports separato (il minificatore eliminava la riserva hidden), nessun
  :has() per gli stacchi tra i palchi;
- stampa dei palchi in nero su bianco, dichiarazione di accessibilità e
  decisioni aggiornate (D-042 superata in parte, deroga a §2.6 per toc.ts).

Testi nuovi da far confermare allo Studio: TODO-STUDIO.md, C14.

Verifiche: eslint, prettier, astro check, build, html-validate, link,
conformità (1467 controlli), Playwright e2e e a11y (90 superati), Lighthouse
(prestazioni 98-100, accessibilità, best practice e SEO 100), pacchetto v1.1.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 00:48:39 +01:00
Alby96andClaude Sonnet 5.5 f9f5a43a14 ci: tolta la cache npm di setup-node, che bloccava ogni esecuzione per cinque minuti
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Successful in 7m24s
CI / Link esterni (non bloccante) (push) Successful in 3m19s
Release / Zip del sito e pubblicazione (push) Successful in 6m24s
Sul runner il server di cache non è raggiungibile dal container del job (getCacheEntry
failed: connect ETIMEDOUT): setup-node con cache: npm aspettava circa cinque minuti prima
di proseguire con un avviso, sia all'inizio sia nel passo finale di salvataggio. Le
dipendenze si scaricano con npm ci a ogni esecuzione.

La prima esecuzione su Gitea è passata per intero (lint, formato, tipi, build, HTML, link,
e2e, accessibilità 51, conformità 1455, Lighthouse, pacchetto zip). Corretti i commenti sui
timeout, che attribuivano ai limiti anche lo scarico dell'immagine (non provato), e aggiunta
la motivazione in D-056.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 12:18:52 +02:00
Alby96andClaude Sonnet 5.5 b7b985b3fa ci: limiti di tempo larghi per lo scarico dell'immagine Playwright sul runner
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Canceled after 0s
CI / Link esterni (non bloccante) (push) Canceled after 0s
La prima esecuzione su Gitea ha impiegato oltre venti minuti solo per scaricare
l'immagine mcr.microsoft.com/playwright (più di 1 GB) sulla rete del runner di casa, a
fronte di un limite di 30 minuti per l'intero job: l'esecuzione rischiava di scadere
prima di cominciare i controlli. Ora verify e release hanno 90 minuti e il controllo dei
link esterni 45; a immagine presente la verifica dura pochi minuti. Motivazione in D-056,
estratti di docs/BRIEF.md allineati.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 12:00:29 +02:00
Alby96andClaude Sonnet 5.5 31ac5b7f68 ci: Gitea Actions, release con il solo zip del sito e documentazione senza Forgejo
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Canceled after 40m56s
CI / Link esterni (non bloccante) (push) Canceled after 0s
Il progetto vive in modo definitivo su Gitea: i workflow passano da .forgejo/ a
.gitea/workflows/ e la documentazione non nomina più la piattaforma precedente.

- ci.yml: i controlli di npm run verify sono passi separati (si vede subito quale è
  fallito) e alla fine la CI crea lo zip di rilascio e ne verifica il contenuto, così un
  errore di pacchetto emerge prima del tag. Runner ubuntu-latest, azioni da github.com con
  URL completo, upload-artifact@v3 (la v4 non funziona su Gitea).
- release.yml: a ogni tag vX.Y.Z verifica tutto, crea lo zip e lo pubblica nella Release
  con scripts/release-upload.sh e l'API di Gitea, senza action esterne di release.
- La release contiene un solo file, sito-studio-grasso-vX.Y.Z.zip (contenuto di dist/ alla
  radice, .htaccess compreso): tolti tar.gz, SHA256SUMS.txt e BUILD-INFO.txt da
  package.mjs, check-package.mjs e dalla documentazione.
- release-upload.sh: variabili GITEA_*, si ferma su errori diversi da 404 invece di
  provare a creare la release, rifiuta una cartella vuota; provato su una finta API Gitea.
- deploy/gitea-deploy.yml.example convertito per Gitea (resta disattivato).
- Versione 1.0.1 pronta (package.json, CHANGELOG, D-056 e D-057 in DECISIONS.md); il tag
  v1.0.1 non è stato creato.

Verifica: npm run verify completo (lint, formato, tipi, build, HTML, link, e2e 39,
a11y 51, conformità 1455, Lighthouse) e npm run package eseguiti in una copia fuori da
.claude/. I workflow non sono ancora stati eseguiti su un runner Gitea.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 11:15:08 +02:00
Alby96andClaude Opus 5.5 083489ac8b Merge della PR #1: CI adattata a Forgejo, revisione completa del codice e avvio in debug
Verificata eseguendo i job della CI negli stessi container del runner (il runner dell'istanza è offline).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 14:14:11 +02:00
Alby96andClaude Opus 5.5 3befe7e266 fix: CI adattata a Forgejo, revisione completa del codice e avvio in debug
Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è
mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato
anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi
del sito, dei controlli e della documentazione.

CI e rilascio:
- continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno
  irraggiungibile avrebbe reso rossa la CI;
- artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati);
- token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico;
- dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL;
- ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server;
  sostituzione dei file senza mai lasciarli mancanti;
- tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip).

Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di
focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop
senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe,
giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati.

Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail,
a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in
quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante
MODALITA_PREDEFINITA per attivarlo.

Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore,
«commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive,
HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test.

Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso),
deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata,
procedura nginx che toglie i file delle versioni precedenti.

Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il
debugger collegato.

Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e
decisioni D-045…D-055.

Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root);
job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in
Docker; release-upload.sh e deploy di esempio contro API e shell simulate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 13:40:16 +02:00
Claude 5aea990dc2 docs: collegamenti alla wiki e alla release nel README
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
2026-10-16 07:28:03 +00:00
84 changed files with 4138 additions and 1424 deletions

No files matched your search

-92
View File
@@ -1,92 +0,0 @@
# =============================================================================
# CI — verifica completa a ogni push su main e a ogni pull request.
#
# RUNNER: `runs-on: docker` è il label più comune di forgejo-runner. Se il runner
# dell'istanza usa un altro label (es. `ubuntu-latest`, `self-hosted`), sostituirlo
# in tutti i job: Impostazioni del repository → Actions → Runner mostra i label disponibili.
#
# CONTAINER: l'immagine Playwright DEVE avere la stessa versione di @playwright/test
# in package.json (oggi 1.56.1). Aggiornando Playwright, aggiornare anche qui e in release.yml.
#
# 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).
# =============================================================================
name: CI
on:
push:
branches: [main]
pull_request:
workflow_dispatch:
env:
ASTRO_TELEMETRY_DISABLED: '1'
CI: 'true'
jobs:
verify:
name: Verifica (lint, build, test, Lighthouse)
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
container:
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
timeout-minutes: 30
steps:
- uses: https://code.forgejo.org/actions/checkout@v4
- uses: https://code.forgejo.org/actions/setup-node@v4
with:
node-version-file: .nvmrc
cache: npm
- name: Dipendenze
run: npm ci
- name: npm run verify
run: npm run verify
- 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
with:
name: playwright-report
path: playwright-report
retention-days: 14
- name: Report Lighthouse
if: always()
uses: https://code.forgejo.org/actions/upload-artifact@v3
with:
name: lighthouse
path: .lighthouseci
retention-days: 14
- name: Artifact dist
uses: https://code.forgejo.org/actions/upload-artifact@v3
with:
name: dist
path: dist
retention-days: 7
external-links:
name: Link esterni (non bloccante)
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
- name: Dipendenze
run: npm ci
env:
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
- name: Build
run: npm run build
- name: Controllo dei link esterni
run: npm run test:links -- --external
-112
View File
@@ -1,112 +0,0 @@
# =============================================================================
# Release — a ogni tag vX.Y.Z: verifica completa, pacchetto (zip, tar.gz, SHA256SUMS.txt,
# BUILD-INFO.txt) e pubblicazione nella sezione «Release» del repository Forgejo.
#
# Come rilasciare (dettagli nel README):
# 1. aggiornare "version" in package.json e la sezione ## [X.Y.Z] di CHANGELOG.md;
# 2. commit su main; 3. git tag vX.Y.Z && git push origin vX.Y.Z
# Il workflow si ferma se il tag non coincide con la versione di package.json o se manca
# la sezione del CHANGELOG.
#
# 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).
#
# 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).
# =============================================================================
name: Release
on:
push:
tags: ['v*.*.*']
env:
ASTRO_TELEMETRY_DISABLED: '1'
CI: 'true'
jobs:
release:
name: Pacchetto e pubblicazione
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
container:
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
timeout-minutes: 40
steps:
- uses: https://code.forgejo.org/actions/checkout@v4
with:
fetch-depth: 0
- uses: https://code.forgejo.org/actions/setup-node@v4
with:
node-version-file: .nvmrc
cache: npm
- name: Data riproducibile (data del commit)
run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV"
- name: Dipendenze
run: npm ci
- name: Controlli preliminari (tag, versione, CHANGELOG)
env:
RELEASE_VERSION: ${{ github.ref_name }}
run: |
node -e 'const v=require("./package.json").version; const t=process.env.RELEASE_VERSION.replace(/^v/,""); if (v!==t) { console.error(`Il tag ${process.env.RELEASE_VERSION} non corrisponde a package.json (${v})`); process.exit(1); }'
node scripts/changelog-notes.mjs "$RELEASE_VERSION" > /dev/null
- name: npm run verify # nessuna release senza test verdi
run: npm run verify
- name: npm run package # crea release/ e ne verifica il contenuto
run: npm run package
env:
RELEASE_VERSION: ${{ github.ref_name }}
- name: Note di rilascio dal CHANGELOG
id: notes
run: |
{
echo 'notes<<NOTES_EOF'
node scripts/changelog-notes.mjs "${{ github.ref_name }}" --shell-safe
echo 'NOTES_EOF'
} >> "$GITHUB_OUTPUT"
- name: Pubblica la release su Forgejo
id: action
continue-on-error: true # in caso di errore pubblica lo step successivo (API REST)
uses: https://code.forgejo.org/actions/forgejo-release@v2
with:
direction: upload
url: ${{ github.server_url }}
repo: ${{ github.repository }}
tag: ${{ github.ref_name }}
token: ${{ secrets.FORGEJO_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, '-') }}
verbose: true
- name: Pubblica la release (API REST, se l'action non è riuscita)
if: steps.action.outcome == 'failure'
env:
FORGEJO_URL: ${{ github.server_url }}
FORGEJO_REPO: ${{ github.repository }}
FORGEJO_TOKEN: ${{ secrets.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
with:
name: playwright-report
path: playwright-report
retention-days: 14
+146
View File
@@ -0,0 +1,146 @@
# =============================================================================
# CI — verifica completa a ogni push su main e a ogni pull request (Gitea Actions).
#
# Il job «verify» ripete passo per passo `npm run verify` (stesso ordine): nella pagina
# dell'esecuzione si vede subito quale controllo è fallito. Alla fine costruisce anche lo zip
# di rilascio e ne verifica il contenuto (`scripts/package.mjs` + `scripts/check-package.mjs`),
# così un errore di pacchetto emerge qui e non al momento del tag. Modificando gli script
# `verify`/`test` di package.json, aggiornare anche questi passi.
#
# RUNNER: i job usano il label `ubuntu-latest`, quello predefinito di act_runner. Se il runner
# è stato registrato con un altro label, sostituirlo in tutti i job: Impostazioni del
# repository → Actions → Runner (o Amministrazione → Actions → Runner) mostra i label.
#
# CONTAINER: l'immagine Playwright DEVE avere la stessa versione di @playwright/test
# in package.json (oggi 1.56.1). Aggiornando Playwright, aggiornare anche qui e in release.yml.
#
# AZIONI: referenziate con URL completo su github.com, così il workflow non dipende
# dall'impostazione DEFAULT_ACTIONS_URL dell'istanza. Il runner deve poter raggiungere
# github.com; in alternativa usare le copie ospitate su https://gitea.com/actions/.
#
# ARTIFACT: upload-artifact@v3, l'unica versione che funziona su Gitea: actions/upload-artifact@v4
# fallisce sempre con GHESNotSupportedError. Gli upload sono sullo step con `continue-on-error`,
# così un problema dello storage non rende rossa una verifica andata a buon fine.
#
# TIMEOUT: i limiti sono larghi perché la rete del runner di casa è lenta: il primo avvio scarica
# l'immagine Playwright (oltre 1 GB, più di venti minuti) e ogni esecuzione clona le action da
# github.com, scarica Node e le dipendenze npm. A immagine presente e con la rete libera la
# verifica dura pochi minuti.
#
# CACHE: niente `cache: npm` in setup-node. Il server di cache del runner non è raggiungibile
# dal container del job (connect ETIMEDOUT verso l'indirizzo del runner): ogni esecuzione
# aspettava cinque minuti prima di proseguire con un avviso. Le dipendenze si scaricano con
# `npm ci` a ogni esecuzione.
#
# NON BLOCCANTE: il controllo dei link esterni ha `continue-on-error` sullo step (non sul job).
#
# 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
on:
push:
branches: [main]
pull_request:
workflow_dispatch:
env:
ASTRO_TELEMETRY_DISABLED: '1'
CI: 'true'
SITE_URL: ${{ vars.SITE_URL }}
jobs:
verify:
name: Verifica (lint, build, test, Lighthouse, pacchetto)
runs-on: ubuntu-latest # label del runner: adattare se diverso
container:
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
timeout-minutes: 90 # la rete del runner è lenta (vedi TIMEOUT)
steps:
- uses: https://github.com/actions/checkout@v4
- uses: https://github.com/actions/setup-node@v4
with:
node-version-file: .nvmrc # niente `cache: npm`: vedi CACHE in testa al file
- name: Dipendenze
run: npm ci
- name: Lint
run: npm run lint
- name: Formattazione
run: npm run format:check
- name: Controllo dei tipi (astro check)
run: npm run check
- name: Build
run: npm run build
- name: HTML valido
run: npm run test:html
- name: Link interni
run: npm run test:links
- name: Test end-to-end
run: npm run test:e2e
- name: Test di accessibilità
run: npm run test:a11y
- name: Conformità legale
run: npm run test:compliance
- name: Lighthouse
run: npm run test:lighthouse
- name: Pacchetto zip (creazione e verifica del contenuto)
run: node scripts/package.mjs && npm run test:package
- name: Report Playwright (solo in caso di errore)
if: failure()
continue-on-error: true
uses: https://github.com/actions/upload-artifact@v3
with:
name: playwright-report
path: playwright-report
retention-days: 14
- name: Report Lighthouse
if: always()
continue-on-error: true
uses: https://github.com/actions/upload-artifact@v3
with:
name: lighthouse
path: .lighthouseci
include-hidden-files: true # necessario: dalla v3.2.0 le cartelle nascoste (.lighthouseci) sono escluse
retention-days: 14
external-links:
name: Link esterni (non bloccante)
runs-on: ubuntu-latest # label del runner: adattare se diverso
container:
image: node:24
timeout-minutes: 45 # la rete del runner è lenta (vedi TIMEOUT)
steps:
- uses: https://github.com/actions/checkout@v4
- name: Dipendenze
run: npm ci
env:
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
- name: Build
run: npm run build
- name: Controllo dei link esterni
# non bloccante: dipende dalla rete del runner e dai siti esterni, quindi un link
# irraggiungibile non deve rendere rossa la CI
continue-on-error: true
run: npm run test:links -- --external
+97
View File
@@ -0,0 +1,97 @@
# =============================================================================
# Release — a ogni tag vX.Y.Z: verifica completa, creazione dello zip del sito e
# pubblicazione nella sezione «Release» del repository con UN SOLO file allegato:
# sito-studio-grasso-vX.Y.Z.zip (il contenuto va estratto nella cartella pubblica
# dell'hosting, .htaccess compreso). Gitea aggiunge da solo alla release i due archivi
# «Source code» del codice sorgente: non sono il sito, serve lo zip sito-studio-grasso-….
#
# Come rilasciare (dettagli nel README):
# 1. aggiornare "version" in package.json e la sezione ## [X.Y.Z] di CHANGELOG.md;
# 2. commit su main; 3. git tag vX.Y.Z && git push origin vX.Y.Z
# Il workflow si ferma se il tag non coincide con la versione di package.json o se manca
# la sezione del CHANGELOG, che diventa il testo della release.
#
# RUNNER: i job usano il label `ubuntu-latest`, quello predefinito di act_runner; sostituirlo
# se il runner ne usa un altro (Impostazioni del repository → Actions → Runner).
#
# TOKEN: per impostazione predefinita la release è pubblicata con il token automatico del
# workflow (il job chiede il permesso `contents: write`). Se la release non viene creata (errore
# 403 o 404 nello step di pubblicazione: ad esempio un amministratore ha limitato i permessi dei
# token automatici) 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. NON
# usare nomi che iniziano con GITEA_ o GITHUB_: sono riservati.
#
# PUBBLICAZIONE: scripts/release-upload.sh (solo curl e node) usa l'API REST di Gitea: crea
# la release in bozza, carica lo zip e solo allora la pubblica. Lo stesso script serve a mano.
#
# AZIONI e ARTIFACT: come in ci.yml (URL completo su github.com, upload-artifact@v3).
#
# 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
on:
push:
tags: ['v*.*.*']
env:
ASTRO_TELEMETRY_DISABLED: '1'
CI: 'true'
SITE_URL: ${{ vars.SITE_URL }}
jobs:
release:
name: Zip del sito e pubblicazione
runs-on: ubuntu-latest # label del runner: adattare se diverso
permissions:
contents: write # crea la release e carica lo zip con il token automatico (Gitea 1.26 e successivi)
container:
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
timeout-minutes: 90 # largo come in ci.yml: la rete del runner è lenta (vedi TIMEOUT)
steps:
- uses: https://github.com/actions/checkout@v4
with:
fetch-depth: 0
- uses: https://github.com/actions/setup-node@v4
with:
node-version-file: .nvmrc # niente `cache: npm`: vedi CACHE in ci.yml
- name: Data riproducibile (data del commit)
run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV"
- name: Dipendenze
run: npm ci
- name: Controlli preliminari (tag, versione, CHANGELOG)
env:
RELEASE_VERSION: ${{ github.ref_name }}
run: |
node -e 'const v=require("./package.json").version; const t=process.env.RELEASE_VERSION.replace(/^v/,""); if (v!==t) { console.error(`Il tag ${process.env.RELEASE_VERSION} non corrisponde a package.json (${v})`); process.exit(1); }'
node scripts/changelog-notes.mjs "$RELEASE_VERSION" > /dev/null
- name: npm run verify # nessuna release senza test verdi
run: npm run verify
- name: npm run package # crea release/ con lo zip e ne verifica il contenuto
run: npm run package
env:
RELEASE_VERSION: ${{ github.ref_name }}
- name: Pubblica la release con lo zip
env:
GITEA_URL: ${{ github.server_url }}
GITEA_REPO: ${{ github.repository }}
GITEA_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()
continue-on-error: true
uses: https://github.com/actions/upload-artifact@v3
with:
name: playwright-report
path: playwright-report
retention-days: 14
+2
View File
@@ -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`)
+73
View File
@@ -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": ["<node_internals>/**", "${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": ["<node_internals>/**", "${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": ["<node_internals>/**", "${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 }
}
]
}
+14
View File
@@ -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": []
}
]
}
+52 -2
View File
@@ -4,7 +4,57 @@ Tutte le modifiche rilevanti a questo progetto sono documentate in questo file.
Il formato segue [Keep a Changelog](https://keepachangelog.com/it-IT/1.1.0/) e il progetto adotta il [Versionamento Semantico](https://semver.org/lang/it/).
## [Non rilasciato]
## [1.1.0] - 2026-11-13
### Modificato
- Rework grafico completo (DECISIONS.md, D-058). Stessa palette navy e oro, ma con «palchi» navy arrotondati per hero, testate delle pagine interne, credenziali, banda di invito all'azione e footer; tipografia più grande e contrastata; card, bottoni, menu e moduli ridisegnati.
- Home: hero scuro con composizione decorativa (sfera e anelli oro) e fact card in vetro smerigliato, fascia di numeri ricavati dai dati del sito (aree di competenza, abilitazioni, sedi, professionisti), servizi in una griglia «bento» con la prima card in evidenza, credenziali su fondo scuro.
- Pagine dei servizi: elenco laterale con le icone dei servizi, gruppi numerati, voci della checklist come piccole schede, precedente e successivo come card.
- Pagine legali: da 1024 px l'indice sta in una colonna a sinistra, fermo durante lo scorrimento, e segnala la sezione in lettura.
- Menu mobile a tutto schermo su fondo navy, con le voci che entrano in sequenza; sottomenu desktop con apertura animata.
- Footer su fondo navy con il nome dello Studio in grande e il link «Torna su»; pagina 404 e conferma del modulo ridisegnate.
- Stampa: i palchi scuri e la card in evidenza escono in nero su bianco, senza decorazioni né numeri in gradiente.
- Dichiarazione di accessibilità: tra gli usi di JavaScript c'è anche l'evidenziazione della sezione in lettura nell'indice delle pagine legali.
### Aggiunto
- Sezione «Come lavoriamo» (home e pagina Servizi): quattro passi, con la barra di avanzamento e i numeri dei passi che si accendono durante lo scorrimento. Testo nuovo da far confermare allo Studio (TODO-STUDIO.md, C14).
- Movimento legato allo scorrimento, solo CSS e solo dove il browser lo supporta: comparsa dei contenuti all'ingresso nella finestra, barra di avanzamento della lettura, intestazione che diventa opaca, parallasse delle testate e degli anelli decorativi. Transizioni morbide tra le pagine (View Transitions). Con «riduci movimento» attivo, o nei browser senza supporto, tutto resta fermo e visibile.
### Tecnico
- Stili dei componenti delimitati da classi (`scopedStyleStrategy: 'class'`) e tracciato del marchio definito una volta per pagina: HTML+CSS della home sotto i 120 KB del budget nonostante i nuovi stili.
- Stili della checklist e delle pagine documento in file separati (`src/styles/checklist.css`, `documento.css`), inclusi solo dove servono.
## [1.0.1] - 2026-10-22
### Modificato
- Il repository risiede in via definitiva su Gitea: i workflow di CI e di release sono in `.gitea/workflows/` e usano Gitea Actions (runner `act_runner` con label `ubuntu-latest`).
- La release contiene un solo file allegato, `sito-studio-grasso-vX.Y.Z.zip`: il sito pronto da estrarre nella cartella pubblica dell'hosting, `.htaccess` compreso. Non vengono più pubblicati l'archivio tar.gz, `SHA256SUMS.txt` e `BUILD-INFO.txt`.
- La CI esegue i controlli di `npm run verify` come passi separati, così la pagina dell'esecuzione mostra subito quale è fallito, e alla fine crea lo zip di rilascio e ne verifica il contenuto.
- La release è pubblicata da `scripts/release-upload.sh` con l'API REST di Gitea (variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`), senza action esterne.
- L'esempio di deploy automatico, sempre disattivato, è `deploy/gitea-deploy.yml.example` e lavora sul nuovo zip unico.
### 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: il controllo dei link esterni non blocca più la CI (`continue-on-error` sullo step); il report Lighthouse viene allegato all'esecuzione; il token personale per le release è il segreto `RELEASE_TOKEN`.
- Release: lo script 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.
- 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
@@ -22,5 +72,5 @@ Prima versione del nuovo sito dello Studio Grasso — Studio Tributario e Societ
- Modulo di contatto configurabile (disattivato, PHP, servizio esterno) con presa visione dell'informativa, informativa breve generata dai dati dello Studio e anti-spam senza cookie; il gestore PHP registra solo un'impronta crittografica dell'IP, cancellata dopo un'ora al primo invio successivo.
- `.htaccess` con HTTPS, header di sicurezza e Content-Security-Policy; configurazione nginx di esempio.
- Test automatici: validità HTML, link, end-to-end, accessibilità (axe), conformità, Lighthouse.
- CI e release su Forgejo Actions: pacchetti zip e tar.gz riproducibili con impronte SHA-256.
- CI e release con le Actions del repository: pacchetto di rilascio riproducibile.
- Documentazione: deploy, aggiornamento dei contenuti, checklist di conformità, decisioni, dati da fornire.
+251 -18
View File
@@ -4,10 +4,10 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
---
## D-001 — Repository esistente su Forgejo e branch di lavoro
## D-001 — Repository esistente su Gitea e branch di lavoro
- **Data:** 2026-10-15
- **Contesto:** il brief (§14.0) prevede `git init`, ma il repository `BalboSoft/Studio_Grasso` esiste già su Forgejo con un commit iniziale (README di due righe e `.gitignore`).
- **Contesto:** il brief (§14.0) prevede `git init`, ma il repository `BalboSoft/Studio_Grasso` esiste già su Gitea con un commit iniziale (README di due righe e `.gitignore`).
- **Scelta:** si lavora sul clone del repository esistente. Lo sviluppo avviene sul branch `feat/sito-v1` (un commit per fase, Conventional Commits in italiano); a fine fase 8 il branch viene unito in `main` con un merge commit (`--no-ff`), così `main` locale è pronto per il push.
- **Alternative scartate:** `git init` di un nuovo repository (perderebbe la storia remota e richiederebbe un push forzato); commit diretti su `main` (meno leggibile la storia per fasi).
- **Motivazione:** conserva la storia remota, nessun push forzato necessario, `main` resta pulito fino al merge finale.
@@ -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
@@ -266,8 +267,8 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
## D-033 — Pacchetto di rilascio riproducibile e verificato senza dipendenze aggiuntive
- **Data:** 2026-10-15
- **Contesto:** §12.4 chiede archivi zip e tar.gz deterministici; §11.7 chiede di estrarli e confrontarli 1:1 con `dist/`. L'immagine CI potrebbe non avere `unzip`.
- **Scelta:** `scripts/package.mjs` usa `archiver` (ZipArchive/TarArchive) con voci ordinate, permessi 0644, fuso orario UTC e data fissa = `SOURCE_DATE_EPOCH` o data dell'ultimo commit (il workflow di release la imposta dal commit del tag). `check-package.mjs` legge lo zip con un lettore minimale in Node (directory centrale, store/deflate, controllo CRC32) ed estrae il tar.gz con `tar` di sistema; confronta percorsi, dimensioni e impronte con `dist/` e verifica `SHA256SUMS.txt` sia in Node sia con `sha256sum -c`. Due esecuzioni consecutive producono archivi identici (verificato). Il pacchetto fallisce se il tag non coincide con `package.json`.
- **Contesto:** §12.4 chiede uno zip deterministico; §11.7 chiede di aprirlo e confrontarlo 1:1 con `dist/`. L'immagine CI potrebbe non avere `unzip`.
- **Scelta:** `scripts/package.mjs` usa `archiver` (ZipArchive) con voci ordinate, permessi 0644, fuso orario UTC e data fissa = `SOURCE_DATE_EPOCH` o data dell'ultimo commit (il workflow di release la imposta dal commit del tag). Il contenuto di `dist/` sta alla radice dello zip, `.htaccess` compreso, senza cartelle di primo livello. `check-package.mjs` legge lo zip con un lettore minimale in Node (directory centrale, store/deflate, controllo CRC32); verifica che in `release/` ci sia solo lo zip, che non superi 5 MB e che percorsi, dimensioni e contenuto coincidano con `dist/` (pagine del sitemap e `.htaccess` comprese). A parità di `dist/` lo zip è identico su Windows, macOS e Linux. Il pacchetto fallisce se il tag non coincide con `package.json`. Il pacchetto è un solo file: D-057.
- **Alternative scartate:** `unzip`/`zip` di sistema (non garantiti nel container); librerie di estrazione aggiuntive.
- **Motivazione:** integrità verificabile ovunque, nessuna dipendenza in più.
@@ -279,13 +280,15 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
- **Alternative scartate:** nessuna verifica (solo revisione del codice).
- **Motivazione:** ridurre il rischio al primo deploy. Le prove non fanno parte di `npm run verify` (richiedono server non presenti nel container CI).
## D-035 — Workflow Forgejo
## D-035 — Workflow Gitea
- **Data:** 2026-10-15
- **Contesto:** §12.2–12.3.
- **Scelta:** `ci.yml` (push su main, pull request, avvio manuale) con `npm run verify` nel container Playwright 1.56.1 e Node da `.nvmrc`, report Playwright e Lighthouse come artifact, job dei link esterni non bloccante; `release.yml` sui tag `v*.*.*` con controllo preliminare tag/versione/CHANGELOG, `SOURCE_DATE_EPOCH` dal commit, `verify`, `package`, note dal CHANGELOG e `forgejo-release@v2` (token `FORGEJO_TOKEN` se presente, altrimenti quello automatico); alternativa via API REST (`scripts/release-upload.sh`) commentata. Telemetria di Astro disattivata (`ASTRO_TELEMETRY_DISABLED`). Il deploy automatico resta un esempio non attivo (`deploy/forgejo-deploy.yml.example`, evento `release: published`, varianti rsync/FTPS/rclone).
- **Alternative scartate:** `workflow_run` per il deploy (non supportato da Forgejo Actions).
- **Motivazione:** nessuna release senza test verdi; workflow indipendenti dalla configurazione dell'istanza.
- **Scelta:** `ci.yml` (push su main, pull request, avvio manuale) con i comandi di `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 pubblicazione con `scripts/release-upload.sh` (API REST di Gitea; token `RELEASE_TOKEN` se presente, altrimenti quello automatico). Telemetria di Astro disattivata (`ASTRO_TELEMETRY_DISABLED`). Il deploy automatico resta un esempio non attivo (`deploy/gitea-deploy.yml.example`, evento `release`, varianti rsync/FTPS/rclone).
- **Alternative scartate:** un job di deploy dentro `release.yml`, che porterebbe nel workflow attivo segreti e varianti ancora da scegliere (D-047).
- **Motivazione:** nessuna release senza test verdi; workflow che non dipendono dall'impostazione `DEFAULT_ACTIONS_URL` dell'istanza (D-056).
- **Aggiornamento (2026-10-16):** `continue-on-error` del job dei link esterni spostato sullo step, `include-hidden-files` per il report Lighthouse e token personale `RELEASE_TOKEN` (segreto facoltativo): vedi D-045.
- **Aggiornamento (2026-10-22):** la CI ripete i controlli come passi separati e alla fine crea e verifica lo zip; la release è un solo file zip pubblicato senza action esterna: vedi D-056 e D-057.
## D-036 — Checkbox del modulo: presa visione, non consenso
@@ -367,40 +370,270 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
## D-042 — Pagine legali a colonna singola; link della mappa sotto il riquadro
> Superata in parte da D-058: da 1024 px l'indice sta in una colonna laterale; la colonna di lettura resta singola. La parte sui link della mappa resta valida.
- **Data:** 2026-10-16
- **Contesto:** le pagine legali avevano su desktop l'indice in una colonna laterale, mentre §7.8 chiede un layout «documento» a colonna singola (max 68 ch) con indice interno. Il mockup 03 mostra i link «Apri in Google Maps / OpenStreetMap» dentro il riquadro della mappa; nel sito sono sotto.
- **Scelta:** pagine legali a colonna singola con l'indice in testa, a tutte le larghezze (la specifica scritta prevale sui mockup). I due link della mappa restano sotto il riquadro: così sono visibili anche dopo il caricamento dell'iframe e senza JavaScript (§10.2), accanto al pulsante «Non caricare più le mappe». Nelle card delle sedi sono allineati a sinistra come le altre azioni.
- **Alternative scartate:** spostare i link dentro il riquadro e poi fuori dopo il caricamento (layout che cambia a ogni stato).
- **Motivazione:** §7.8 e §10.2; un solo asse di allineamento nelle card.
## D-043 — Release: note sicure per la shell e ripiego automatico sull'API REST
## D-043 — Release: note dal CHANGELOG e pubblicazione con l'API REST
- **Data:** 2026-10-16
- **Contesto:** il comportamento di `forgejo-release@v2` con note che contengono apici inversi o virgolette e le sue dipendenze nell'immagine Playwright non sono verificabili senza l'istanza. Alcune istanze potrebbero non accettare segreti con prefisso `FORGEJO_`, e gli eventi creati con il token automatico non avviano altri workflow (deploy automatico).
- **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.
- **Contesto:** le note della release sono la sezione del CHANGELOG, che contiene apici inversi e virgolette: passate come testo a una shell o a un'action, rischiano di essere alterate o di rompere il comando. Un'action esterna di release aggiungerebbe inoltre dipendenze da verificare nell'immagine Playwright. Gli eventi prodotti con il token automatico del workflow non avviano altri workflow (deploy automatico, D-047).
- **Scelta:** la release è pubblicata da `scripts/release-upload.sh` (solo curl e node), che legge le note dal CHANGELOG con `changelog-notes.mjs` e le inserisce nel JSON con node, senza passare da interpolazioni di shell. Nessuna action esterna di release. Token: `RELEASE_TOKEN` se presente, altrimenti quello automatico. Il deploy di esempio non esclude più `contact.php` e protegge `.well-known/`, `.user.ini` e `cgi-bin/`.
- **Alternative scartate:** un'action esterna di pubblicazione (una dipendenza in più da raggiungere e da tenere aggiornata, con le note passate come testo alla shell); note senza alcuna trasformazione passate a una riga di shell.
- **Motivazione:** nessuna release bloccata o alterata da un dettaglio dell'istanza o del testo delle note. Consigliato un primo rilascio di prova sull'istanza reale prima di comunicare la versione.
- **Aggiornamento (2026-10-16):** il token personale è solo `RELEASE_TOKEN`: i nomi dei segreti che iniziano con `GITEA_` o `GITHUB_` sono riservati (D-045). Lo script crea la release in bozza e la pubblica dopo i file (D-046).
- **Aggiornamento (2026-10-22):** la pubblicazione passa solo dallo script, senza altri passi di ripiego (D-056). L'opzione `--shell-safe` di `changelog-notes.mjs` non serve più ed è stata tolta.
## D-044 — Controlli coerenti con la configurazione e portabili
- **Data:** 2026-10-16
- **Contesto:** la revisione del codice ha trovato tre situazioni in cui `verify` falliva senza un difetto del sito, più tre problemi di portabilità su Windows:
- **Contesto:** la revisione del codice ha trovato tre situazioni in cui `verify` falliva senza un difetto del sito, più due problemi di portabilità su Windows:
- la modalità `endpoint` con la CSP aggiornata;
- una release a cavallo d'anno, con `SOURCE_DATE_EPOCH` dell'anno precedente;
- il controllo dei link esterni, che verificava canonical e JSON-LD sul dominio di produzione, dove c'è ancora il vecchio sito;
- su Windows: `import()` con un percorso assoluto, `tar` di Git Bash con «C:\…» e il checkout con CRLF.
- su Windows: `import()` con un percorso assoluto e il checkout con CRLF.
- **Scelta:**
- La CSP è confrontata per direttive; una direttiva ripetuta è un errore (il browser applica solo la prima); in modalità `endpoint`, `form-action` deve contenere anche l'origine di `contactForm.endpoint` (provato con una configurazione temporanea).
- L'anno del footer è calcolato con `src/lib/build.ts`, lo stesso modulo usato dal sito.
- Gli URL del dominio del sito sono riscritti verso la build locale e controllati lì.
- Portabilità: import con URL `file://`, `tar` alimentato da stdin, `.gitattributes` con `eol=lf`.
- Portabilità: import con URL `file://`, `.gitattributes` con `eol=lf`.
- Altre correzioni:
- il ripiego di `freePort` restituisce la porta assegnata;
- il pattern del telefono è valido anche con il flag `v` dei browser attuali, con un test sul formato;
- l'avviso di invio troppo rapido è visibile;
- Esc chiude il sottomenu aperto al passaggio del mouse (WCAG 1.4.13);
- `contact.php` usa il mittente della busta (`-f`), non richiede mbstring (rifiuta l'UTF-8 non valido prima di contare i caratteri), non produce avvisi con `open_basedir` e usa il fuso Europe/Rome;
- Esc su un sottomenu aperto al passaggio del mouse riporta il focus sul pulsante se era su un link del sottomenu;
- `--shell-safe` neutralizza ogni `$` ($).
- Esc su un sottomenu aperto al passaggio del mouse riporta il focus sul pulsante se era su un link del sottomenu.
- **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 Gitea: job non bloccante, artifact, token e runner
- **Data:** 2026-10-16
- **Contesto:** la revisione dei workflow ha trovato difetti che si sarebbero presentati con il runner online:
- `continue-on-error` a livello di job non è garantito dalla documentazione di Gitea Actions: il job «Link esterni (non bloccante)» avrebbe potuto rendere rossa la CI al primo sito esterno irraggiungibile;
- il report Lighthouse sta in una cartella nascosta (`.lighthouseci/`): senza un'indicazione esplicita, il caricamento degli artifact potrebbe non includerla;
- i nomi dei segreti che iniziano con `GITEA_` o `GITHUB_` sono riservati: il token personale per le release non può chiamarsi `GITEA_TOKEN`, serve un nome diverso (`RELEASE_TOKEN`).
- **Scelta:**
- `continue-on-error` sullo step «Controllo dei link esterni», non sul job;
- `include-hidden-files: true` nell'upload del report Lighthouse: dalla v3.2.0 `upload-artifact` esclude per impostazione predefinita i file e le cartelle nascosti, come `.lighthouseci/`, e l'opzione è quella che li fa caricare;
- token `secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN` in release.yml;
- `upload-artifact@v3`, perché `actions/upload-artifact@v4` fallisce su Gitea con `GHESNotSupportedError` (D-056);
- `runs-on: ubuntu-latest` in tutti i job, il label predefinito di `act_runner`, con un commento che invita ad adattarlo se il runner ne usa un altro;
- variabile del repository `SITE_URL` passata a build e test di CI e release (D-051).
I 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.
- **Alternative scartate:** `actions/upload-artifact@v4` (non funziona su Gitea); 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 `ubuntu-latest` è online, senza altre correzioni.
## D-046 — Release: pubblicazione dopo i file e controllo del tag
- **Data:** 2026-10-16
- **Contesto:** `scripts/release-upload.sh`:
- creava la release già pubblicata prima di caricare i file;
- lasciava in bozza una release rimasta a metà dopo un errore;
- cancellava un file prima di caricare il nuovo;
- non verificava il tag (senza tag Gitea lo crea sulla punta del branch predefinito).
- **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.
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.
## D-047 — Deploy automatico di esempio: evento, ultima release e percorsi protetti
- **Data:** 2026-10-16
- **Contesto:** `scripts/release-upload.sh` (usato da release.yml) crea la release in bozza, carica lo zip e solo allora la pubblica; poiché il tag esiste già, Gitea notifica il passaggio come modifica della release («edited») e non come «published». 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` (i due tipi che Gitea supporta per `release`);
- un job «controllo» lascia proseguire solo una release stabile che sia l'ultima pubblicata e, per «edited», solo se lo zip è stato caricato 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, con un tag nel formato `vX.Y.Z`;
- se l'API delle release non risponde lo step fallisce, invece di saltare il deploy in silenzio;
- download dello zip `sito-studio-grasso-vX.Y.Z.zip` con il token automatico, controllo di integrità (`unzip -t`) e della presenza di `index.html` e `.htaccess`; dominio per il controllo finale dalla variabile `SITE_URL` o dalla riga `Sitemap:` del `robots.txt` contenuto nello zip;
- l'avvio automatico richiede che la release sia pubblicata con il token personale (`RELEASE_TOKEN`): Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro workflow; senza il segreto si avvia a mano dalla scheda Actions;
- 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 la pubblicazione da bozza 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 `<li>`;
- 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 `</html>` (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.
## D-056 — Repository definitivo su Gitea: workflow in `.gitea/workflows`
- **Data:** 2026-10-22
- **Contesto:** il repository `BalboSoft/Studio_Grasso` risiede in via definitiva sull'istanza Gitea `https://gitea.encke-hake.ts.net`: CI, release e deploy automatico devono funzionare con Gitea Actions (runner `act_runner`), senza dipendere dalla configurazione dell'istanza e indicando subito, in caso di errore, quale controllo è fallito.
- **Scelta:**
- workflow in `.gitea/workflows/` (`ci.yml`, `release.yml`); l'esempio di deploy automatico, sempre disattivato, è `deploy/gitea-deploy.yml.example`, da copiare in `.gitea/workflows/deploy.yml` per attivarlo;
- `runs-on: ubuntu-latest` in tutti i job, il label predefinito di `act_runner`; un commento in ogni workflow ricorda di adattarlo se il runner ne usa un altro. Container: Playwright `v1.56.1-noble` (stessa versione di `@playwright/test`) per verifica e release, `node:24` per i link esterni;
- azioni di terze parti con URL completo su github.com (`uses: https://github.com/actions/checkout@v4`), così non dipendono dall'impostazione `DEFAULT_ACTIONS_URL` dell'istanza; il runner deve poter raggiungere github.com;
- artifact con `upload-artifact@v3`, perché la v4 non funziona su Gitea (fallisce con `GHESNotSupportedError`); gli upload stanno su step con `continue-on-error`, così un problema dello storage non rende rossa una verifica riuscita;
- CI: il job «verify» ripete passo per passo `npm run verify`, nello stesso ordine (lint, formattazione, controllo dei tipi, build, HTML, link interni, end-to-end, accessibilità, conformità, Lighthouse), poi crea lo zip di rilascio (`scripts/package.mjs`) e ne verifica il contenuto (`npm run test:package`); il controllo dei link esterni è un job a parte e non bloccante (D-045). Modificando gli script `verify` o `test` di `package.json` vanno aggiornati anche i passi;
- release: a ogni tag `vX.Y.Z` il workflow controlla tag, versione e CHANGELOG, esegue `verify` e `package` e pubblica la release con `scripts/release-upload.sh`, che usa l'API REST di Gitea (variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`), senza action esterne di release (D-043);
- token e variabili: segreto facoltativo `RELEASE_TOKEN` (token personale con permesso `write:repository`); se manca si usa il token automatico del workflow. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Il dominio si imposta con la variabile del repository `SITE_URL` (D-051).
- `timeout-minutes` larghi (90 per `verify` e per la release, 45 per il controllo dei link esterni; prima 30, 40 e 15): la rete del runner di casa è lenta. Il 22 ottobre 2026 la prima esecuzione ha impiegato più di venti minuti per scaricare l'immagine Playwright (oltre 1 GB), tre minuti per clonare `setup-node` da github.com e minuti per le dipendenze; lo scarico dell'immagine si ripete se il runner la elimina con la pulizia delle immagini inutilizzate;
- niente `cache: npm` in `setup-node`: il server di cache del runner non è raggiungibile dal container del job (`getCacheEntry failed: connect ETIMEDOUT`), e a ogni esecuzione il passo aspettava circa cinque minuti prima di proseguire con un avviso. Le dipendenze si scaricano con `npm ci`;
- **Alternative scartate:**
- le copie delle azioni ospitate su gitea.com: restano la via d'uscita, indicata nel commento di `ci.yml`, se il runner non raggiunge github.com, ma i workflow usano le azioni originali senza un secondo repository di azioni da tenere allineato;
- `actions/upload-artifact@v4`, che non funziona su Gitea;
- workflow in `.github/workflows`: sono scritti per Gitea Actions (URL completi delle azioni, `upload-artifact@v3`, label di `act_runner`) e la cartella indicata dalla documentazione di Gitea è `.gitea/workflows/`;
- un unico passo `npm run verify` nella CI: in caso di errore bisognerebbe leggere il log per capire quale controllo è fallito.
- **Motivazione:** CI e release usano solo funzioni documentate di Gitea Actions e non dipendono dalle azioni predefinite dell'istanza né da action di terzi per la pubblicazione; la pagina dell'esecuzione mostra subito il controllo fallito e un errore di pacchetto emerge nella CI, non al momento del tag.
## D-057 — Release con un solo file: lo zip del sito
- **Data:** 2026-10-22
- **Contesto:** la release serve a ottenere i file del sito da copiare sull'hosting per metterlo online. Il pacchetto conteneva quattro file (zip, tar.gz, `SHA256SUMS.txt`, `BUILD-INFO.txt`): per copiare il sito bastava lo zip, il resto era da capire e ignorare. Gitea, inoltre, aggiunge da solo a ogni release due archivi, «Source code (ZIP)» e «Source code (TAR.GZ)», che contengono il codice sorgente del repository e non il sito.
- **Scelta:** la release ha un solo file allegato, `sito-studio-grasso-vX.Y.Z.zip`, con il contenuto di `dist/` alla radice (nessuna cartella di primo livello) e `.htaccess` compreso: va estratto nella cartella pubblica dell'hosting. L'archivio tar.gz, `SHA256SUMS.txt` e `BUILD-INFO.txt` non vengono più creati. `package.mjs` crea solo lo zip, `check-package.mjs` verifica che `release/` contenga solo quello (D-033) e `release-upload.sh` carica i file che trova in `release/`. Versione del pacchetto: 1.0.1. Dove si spiega come scaricare il sito va detto di scegliere lo zip `sito-studio-grasso-vX.Y.Z.zip`, non i «Source code» di Gitea.
- **Alternative scartate:**
- tar.gz, `SHA256SUMS.txt` e `BUILD-INFO.txt` accanto allo zip: più file tra cui scegliere per chi deve solo copiare il sito; il tar.gz serviva ai server Linux, dove però lo zip si estrae con `unzip` (come nell'esempio di deploy);
- `BUILD-INFO.txt` dentro lo zip: aggiungerebbe un file alla radice pubblica del sito, raggiungibile da chiunque conosca l'indirizzo;
- impronte SHA-256 separate: l'integrità è garantita dalla verifica del contenuto dello zip contro `dist/` prima della pubblicazione (D-033) e, nel deploy di esempio, dal controllo `unzip -t` dopo il download.
- **Motivazione:** chi pubblica il sito scarica un file e lo copia sull'hosting, senza altri passaggi. Conseguenza: i «Source code» che Gitea mette in ogni release non sono il sito, e le guide di deploy lo dicono. Il dominio per cui è costruito il pacchetto non è più scritto in `BUILD-INFO.txt`: il deploy di esempio lo legge dalla variabile `SITE_URL` o dal `robots.txt` contenuto nello zip (D-047).
## D-058 — Rework grafico: palchi scuri, movimento legato allo scorrimento, solo CSS
- **Data:** 2026-11-13
- **Contesto:** il committente ha chiesto un rework completo della grafica, «moderno, funzionale e di alto livello tecnico visivo», con elementi e pagine moderne ed effetti di scorrimento. Il brief (§6.1) prevedeva invece «movimento minimo: solo transizioni di hover». Restano validi tutti gli altri vincoli: contenuti, struttura delle pagine (§7, salvo le aggiunte elencate sotto), CSP senza script inline, nessuna risorsa di terze parti, WCAG 2.1 AA, budget di 120 KB per HTML+CSS di ogni pagina e di 15 KB per il JavaScript, Lighthouse.
- **Scelta:**
- **Linguaggio visivo:** palette e font invariati (navy, oro, carta; Fraunces e Inter), più un navy profondo (`--navy-950`) per i «palchi»: blocchi scuri arrotondati, staccati dai bordi, per hero, testate interne, credenziali, banda CTA e footer. Il fondo è sempre pieno sul contenitore; trama a griglia e bagliori stanno in un livello decorativo a parte (`.stage__decor`), così il colore dietro testi e anelli di focus resta misurabile (test del contrasto del focus, axe). Sui palchi l'anello di focus è `--gold-300` (≥ 10:1).
- **Servizi in griglia «bento»:** prima card in evidenza su due righe, l'ultima a tutta riga se resterebbe sola (con 6 servizi: 1 + 4 + 1); la card larga si dispone in orizzontale con una container query.
- **Movimento:** solo CSS, con le scroll-driven animations (`animation-timeline: view()/scroll()`) dentro `@supports` e `prefers-reduced-motion: no-preference`: comparsa dei contenuti (`.reveal`, `.reveal-group`), barra di avanzamento della lettura, intestazione che diventa opaca, parallasse delle decorazioni, barra e numeri della sezione «Come lavoriamo». Transizioni tra pagine con `@view-transition { navigation: auto }`. Nessuna animazione infinita (WCAG 2.2.2): le decorazioni ruotano solo mentre si scorre. Il testo principale dell'hero non è animato (LCP). La comparsa dei contenuti usa solo spostamento e scala, mai l'opacità: legata allo scorrimento, lascerebbe semitrasparente (e sotto il contrasto AA) il testo di un blocco fermo sul bordo inferiore della finestra; axe e Lighthouse lo segnalavano su /contatti/ e /link-utili/.
- **Nessun cambio di altezza durante lo scorrimento:** l'intestazione cambia solo fondo e ombra, per non spostare il contenuto (CLS).
- **Struttura (§7):** in home (§7.1) la fascia di numeri nell'hero e la sezione «Come lavoriamo» tra servizi e studio; nell'hub dei servizi (§7.3) «Come lavoriamo» tra la griglia e la banda CTA; nelle pagine legali (§7.8), da 1024 px, l'indice in una colonna laterale di 17rem, fermo durante lo scorrimento, accanto alla colonna di lettura che resta al massimo `--measure` (68 ch); sotto i 1024 px, o con un solo titolo, l'indice resta in testa e il testo a colonna singola. Supera D-042 per la posizione dell'indice.
- **JavaScript:** solo `src/scripts/toc.ts` in più (meno di 1 KB): evidenzia nell'indice delle pagine legali la sezione in lettura. È un uso in più rispetto all'elenco chiuso del brief (§2.6), accettato perché non essenziale: senza JavaScript l'indice resta un elenco di link funzionante. È dichiarato nella pagina Accessibilità. Tutto il resto è CSS.
- **Budget:** `scopedStyleStrategy: 'class'` (selettori e markup più corti, stessa specificità), tracciato della «G» del marchio definito una volta per pagina e richiamato con `<use>` (LogoDefs), stili della checklist e dei documenti fuori dal CSS globale.
- **Alternative scartate:**
- librerie di animazione JavaScript (GSAP, Lenis, AOS): peso oltre il budget, dipendenze in più e contenuti nascosti finché lo script non parte;
- comparsa dei contenuti con IntersectionObserver: richiede JavaScript, e senza di esso o prima del caricamento i contenuti restano invisibili; le animazioni CSS legate allo scorrimento lasciano tutto visibile dove non sono supportate;
- caroselli orizzontali su mobile per le fact card e le credenziali: aree scorrevoli senza elementi focalizzabili (axe: scrollable-region-focusable) e contenuti meno visibili;
- pulsante «torna su» fisso che compare scorrendo: invisibile ma focalizzabile in cima alla pagina; il link «Torna su» è nel footer.
- **Motivazione:** il sito ottiene un aspetto contemporaneo e un movimento curato senza perdere nulla di ciò che il brief garantiva: niente JavaScript necessario, niente risorse esterne, contenuti sempre leggibili e accessibili, prestazioni nel budget. La specifica §6.1 «movimento minimo» è superata da questa decisione, come §7.1, §7.3 e §7.8 nei punti indicati sopra e l'elenco degli usi di JavaScript di §2.6 per l'indice delle pagine legali; il resto del §6 resta valido.
+64 -27
View File
@@ -1,9 +1,10 @@
# Sito web dello Studio Grasso
Sito statico dello **Studio Grasso — Studio Tributario e Societario** (Montegrosso d'Asti e Asti), realizzato con [Astro](https://astro.build/). Nessun tracciamento, nessun cookie, nessuna risorsa di terze parti caricata senza un'azione esplicita dell'utente; pacchetto di rilascio universale (solo file statici, con `.htaccess`) pronto per qualsiasi hosting.
Sito statico dello **Studio Grasso — Studio Tributario e Societario** (Montegrosso d'Asti e Asti), realizzato con [Astro](https://astro.build/). Nessun tracciamento, nessun cookie, nessuna risorsa di terze parti caricata senza un'azione esplicita dell'utente; pacchetto di rilascio universale (un file zip di soli file statici, con `.htaccess`) pronto per qualsiasi hosting.
- Requisiti di progetto: [`docs/BRIEF.md`](docs/BRIEF.md) · Mockup: [`docs/mockups/`](docs/mockups/)
- Decisioni tecniche: [`DECISIONS.md`](DECISIONS.md) · Dati da fornire: [`TODO-STUDIO.md`](TODO-STUDIO.md) · Novità: [`CHANGELOG.md`](CHANGELOG.md)
- Wiki del repository (come vedere e provare il sito, CI e release, dati da fornire): [Wiki](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/wiki/Home) · Release (lo zip del sito da mettere online): [elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases)
- Pubblicazione sull'hosting: [`docs/DEPLOY.md`](docs/DEPLOY.md) · Aggiornare i contenuti: [`docs/CONTENUTI.md`](docs/CONTENUTI.md) · Conformità: [`docs/CONFORMITA.md`](docs/CONFORMITA.md)
## Requisiti
@@ -20,9 +21,20 @@ npm run dev # sito in sviluppo su http://localhost:4321 (si aggiorna a ogn
npm run build # genera il sito statico in dist/
npm run preview # serve dist/ su http://127.0.0.1:4321
npm run verify # tutti i controlli di qualità (gli stessi della CI)
npm run package # crea il pacchetto di rilascio in release/
npm run package # crea lo zip 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 <http://127.0.0.1:4321> |
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 |
@@ -41,10 +53,10 @@ npm run package # crea il pacchetto di rilascio in release/
| `npm run test:lighthouse` | Lighthouse CI: Performance ≥ 0.95, Accessibility 1, Best Practices ≥ 0.95, SEO 1 |
| `npm test` | html + link + e2e + a11y + conformità |
| `npm run verify` | lint + formattazione + tipi + build + `npm test` + Lighthouse |
| `npm run package` | build + pacchetto in `release/` + verifica del pacchetto (`test:package`) |
| `npm run package` | build + zip in `release/` + verifica del contenuto dello zip (`test:package`) |
| `npm run icons` | rigenera marchio, favicon, apple-touch-icon e immagine di condivisione |
`npm run verify` deve terminare senza errori prima di ogni rilascio: è il comando eseguito dalla CI.
`npm run verify` deve terminare senza errori prima di ogni rilascio: la CI ne ripete i controlli uno per uno e `release.yml` lo esegue prima di creare lo zip.
## Struttura
@@ -61,42 +73,65 @@ src/scripts/ piccoli script: menu, mappa su consenso, modulo, ancore del v
public/ .htaccess, favicon e immagini statiche (copiati così come sono)
scripts/ script di test, pacchetto, icone, note di rilascio, upload della release
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)
deploy/ nginx.conf.example, optional-php-form/contact.php, gitea-deploy.yml.example
(esempio di deploy automatico, disattivato)
.gitea/workflows/ ci.yml (verifica e zip di prova) e release.yml (zip e 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
```
## Pubblicare il repository su Forgejo
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 Gitea (Impostazioni → Actions → Variabili), che CI e release usano per la build. Lo zip della release contiene un sito costruito per quel dominio.
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 <url-del-repository>`.
Per verificare il modulo attivo (validazione, anti-spam, pagina di conferma), in PowerShell:
```bash
git push -u origin main # pubblica il codice: parte la CI (.forgejo/workflows/ci.yml)
```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
```
Consigliato: proteggere il branch `main` (Impostazioni del repository → Branch → Protezione: niente push forzati, merge solo con CI verde) e lavorare con branch e pull request. I messaggi di commit seguono [Conventional Commits](https://www.conventionalcommits.org/it/) in italiano (`feat:`, `fix:`, `docs:`, `ci:`, `test:`, `chore:`).
In Git Bash, macOS o Linux: `CONTACT_FORM_MODE=php npm run build && npx playwright test tests/e2e/form.spec.ts && npm run build`.
La CI richiede un **runner Forgejo Actions** con label `docker` (modificabile in cima ai file dei workflow). Le azioni sono indicate con URL completo su `code.forgejo.org`, quindi non dipendono dalla configurazione dell'istanza.
## Pubblicare il repository su Gitea
Il repository è su Gitea: <https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso>. In un clone il remote `origin` è già configurato (`git remote -v` per controllare). Per un repository nuovo: `git remote add origin <url-del-repository>`.
```bash
git push -u origin main # pubblica il codice: parte la CI (.gitea/workflows/ci.yml)
git push origin vX.Y.Z # pubblica un tag: parte la release (.gitea/workflows/release.yml)
```
Consigliato: proteggere il branch `main` (Impostazioni del repository → Branch → nuova regola per `main`: niente push forzati, merge solo con i controlli di stato, cioè la CI, superati) e lavorare con branch e pull request. I messaggi di commit seguono [Conventional Commits](https://www.conventionalcommits.org/it/) in italiano (`feat:`, `fix:`, `docs:`, `ci:`, `test:`, `chore:`).
**CI e release usano Gitea Actions**, con i workflow in `.gitea/workflows/`:
- `ci.yml` parte a ogni push su `main`, a ogni pull request e a mano dalla scheda **Actions**: ripete passo per passo i controlli di `npm run verify` (così si vede subito quale è fallito), poi crea lo zip di rilascio e ne verifica il contenuto.
- `release.yml` parte a ogni tag `vX.Y.Z`: verifica tutto, crea lo zip e lo pubblica nella sezione **Release** (vedi sotto).
I job girano su un **runner** `act_runner` con label `ubuntu-latest`, il label predefinito di `act_runner` (modificabile in cima ai file dei workflow). Perché i workflow partano, le Actions devono essere attive sul repository (Impostazioni del repository → «Enable Repository Actions») e il runner deve essere registrato su Gitea. I runner del repository, con i loro label, e il token per registrarne uno nuovo si trovano in Impostazioni del repository → Actions → Runner (`<url-del-repository>/settings/actions/runners`); i passi per l'installazione e la registrazione sono nella [guida di Gitea Actions](https://docs.gitea.com/usage/actions/quickstart). Le azioni di terze parti (checkout, setup-node, upload-artifact) sono indicate con URL completo su `github.com`, quindi non dipendono dalla configurazione dell'istanza, ma il runner deve poter raggiungere `github.com`. I report dei test sono caricati con `upload-artifact@v3`: la v4 non funziona su Gitea.
## Fare una release
1. Aggiornare `version` in `package.json` (SemVer: `1.0.1` correzioni, `1.1.0` novità, `2.0.0` cambiamenti importanti) e `npm install` per allineare `package-lock.json`.
1. Aggiornare `version` in `package.json` (SemVer: si aumenta l'ultima cifra per le correzioni, la cifra centrale per le novità, la prima per i cambiamenti importanti) e `npm install` per allineare `package-lock.json`.
2. Aggiungere in `CHANGELOG.md` la sezione `## [X.Y.Z] - AAAA-MM-GG`: diventa il testo della release.
3. `npm run verify`, commit (`chore(release): prepara vX.Y.Z`) e push su `main`.
4. Creare e pubblicare il tag:
@@ -106,15 +141,17 @@ La CI richiede un **runner Forgejo Actions** con label `docker` (modificabile in
git push origin vX.Y.Z
```
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`.
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 (<https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases>) un solo file allegato: **`sito-studio-grasso-vX.Y.Z.zip`**. È il sito pronto da estrarre nella cartella pubblica dell'hosting: il contenuto di `dist/` sta alla radice dello zip, `.htaccess` compreso, senza cartelle di primo livello. Il dominio del sito è quello di `site.config.mjs`, oppure la variabile del repository `SITE_URL` se impostata (vedi «Configurazione»).
**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).
**Quale file scaricare:** a ogni release Gitea aggiunge da solo due archivi, «Source code (ZIP)» e «Source code (TAR.GZ)». Contengono il codice sorgente, **non** il sito: per metterlo online scegliere sempre lo zip `sito-studio-grasso-vX.Y.Z.zip`. La procedura di pubblicazione sull'hosting è in [`docs/DEPLOY.md`](docs/DEPLOY.md).
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`).
**Token:** per impostazione predefinita la release è pubblicata con il token automatico del workflow. Se lo step di pubblicazione fallisce con errore 403 o 404, oppure per avviare in automatico il deploy facoltativo (`docs/DEPLOY.md` sezione 9: le azioni compiute 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): se esiste, il workflow lo usa al posto di quello automatico. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`.
La release è pubblicata da `scripts/release-upload.sh` (solo `curl` e `node`) con l'API REST di Gitea, senza action esterne: crea la release in bozza, carica lo zip e solo allora la pubblica. Lo stesso script serve anche a mano (istruzioni in testa al file e in `docs/DEPLOY.md`).
## Aggiornare le dipendenze
Le versioni sono bloccate (senza `^`) e `package-lock.json` è committato. Per aggiornare: `npm install <pacchetto>@<versione> --save-exact`, poi `npm run verify`. **Playwright:** la versione di `@playwright/test`, `playwright` e `playwright-core` deve coincidere con l'immagine `mcr.microsoft.com/playwright:vX.Y.Z-noble` usata in `.forgejo/workflows/ci.yml` e `release.yml` (oggi 1.56.1).
Le versioni sono bloccate (senza `^`) e `package-lock.json` è committato. Per aggiornare: `npm install <pacchetto>@<versione> --save-exact`, poi `npm run verify`. **Playwright:** la versione di `@playwright/test`, `playwright` e `playwright-core` deve coincidere con l'immagine `mcr.microsoft.com/playwright:vX.Y.Z-noble` usata in `.gitea/workflows/ci.yml` e `release.yml` (oggi 1.56.1): aggiornandola, cambiare la versione in tutti e due i file.
## Note
+30 -22
View File
@@ -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 Gitea (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,12 @@ 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.
### C14. Testi nuovi del rework grafico
Il rework grafico (DECISIONS.md, D-058) ha aggiunto alcuni testi che non vengono dal vecchio sito. Confermarli o correggerli:
- sezione «Come lavoriamo» in home e nella pagina Servizi (`src/data/pagine.ts`, costante `metodo`): titolo «Dal primo contatto all’assistenza continuativa», testo introduttivo e i quattro passi (Primo contatto, Analisi della situazione, Preventivo gratuito, Al tuo fianco nel tempo). In particolare va confermato che il preventivo viene proposto prima di iniziare l'attività;
- fascia di numeri sotto l'hero (`src/data/pagine.ts`, `home.hero.numeri`): le etichette «Aree di competenza», «Abilitazioni e iscrizioni», «Sedi in provincia di Asti», «Professionisti dello Studio». I numeri sono contati dai dati del sito e si aggiornano da soli;
- occhiello «Preventivo gratuito» sopra la banda di invito all'azione (`src/data/testi.ts`, `ctaBand.eyebrow`).
+12 -5
View File
@@ -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,17 +21,18 @@ 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,
output: 'static',
trailingSlash: 'always',
compressHTML: true,
// stili dei componenti delimitati da una classe (.astro-xxxx) invece che da un attributo
// ([data-astro-cid-xxxx]): stessa specificità, selettori e markup più corti (budget di 120 KB
// per HTML+CSS di ogni pagina, vedi DECISIONS.md D-058)
scopedStyleStrategy: 'class',
build: {
format: 'directory',
// CSS incluso nella pagina: nessuna richiesta bloccante per il rendering
@@ -49,6 +51,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'],
},
},
});
-107
View File
@@ -1,107 +0,0 @@
# =============================================================================
# DEPLOY AUTOMATICO (DISATTIVATO) — esempio per Forgejo Actions.
#
# Per attivarlo: copiare questo file in .forgejo/workflows/deploy.yml, scegliere UNA delle
# varianti qui sotto (rsync su SSH, FTPS con lftp, object storage con rclone), decommentarla
# 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.
# 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.
# =============================================================================
name: Deploy
on:
release:
types: [published]
workflow_dispatch:
inputs:
tag:
description: 'Tag della release da pubblicare (es. v1.0.0)'
required: true
jobs:
deploy:
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
container:
image: debian:stable-slim
environment: produzione
steps:
- name: Strumenti
run: apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip
# aggiungere: rsync openssh-client (variante A) · lftp (variante B) · rclone (variante C)
- 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 }}
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"
grep " sito-studio-grasso-v${VERSION}.zip$" SHA256SUMS.txt | sed "s/sito-studio-grasso-v${VERSION}.zip/pacchetto.zip/" | 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)
# ---------------------------------------------------------------------------
# - name: Pubblica con rsync
# env:
# DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
# DEPLOY_USER: ${{ secrets.DEPLOY_USER }}
# DEPLOY_PATH: ${{ secrets.DEPLOY_PATH }}
# DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
# run: |
# set -eu
# 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
# rsync -az --delete --exclude '.well-known/' --exclude '.user.ini' --exclude 'cgi-bin/' \
# -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)
# ---------------------------------------------------------------------------
# - name: Pubblica via FTPS
# env:
# FTP_HOST: ${{ secrets.FTP_HOST }}
# FTP_USER: ${{ secrets.FTP_USER }}
# FTP_PASSWORD: ${{ secrets.FTP_PASSWORD }}
# FTP_PATH: ${{ secrets.FTP_PATH }}
# run: |
# 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"
# ---------------------------------------------------------------------------
# Variante C — object storage S3 compatibile con rclone
# Segreti: RCLONE_CONFIG (contenuto di rclone.conf con il remote «sito»), RCLONE_DEST (es. sito:bucket)
# ---------------------------------------------------------------------------
# - name: Pubblica su object storage
# env:
# RCLONE_CONFIG_CONTENT: ${{ secrets.RCLONE_CONFIG }}
# RCLONE_DEST: ${{ secrets.RCLONE_DEST }}
# run: |
# 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' }}
run: |
set -eu
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 ]
done
code=$(curl -s -o /dev/null -w '%{http_code}' "${SITE_URL}/pagina-inesistente/"); echo "404 → ${code}"; [ "$code" = 404 ]
+214
View File
@@ -0,0 +1,214 @@
# =============================================================================
# DEPLOY AUTOMATICO (DISATTIVATO) — esempio per Gitea Actions.
#
# Per attivarlo: copiare questo file in .gitea/workflows/deploy.yml, scegliere UNA delle
# varianti qui sotto (rsync su SSH, FTPS con lftp, object storage con rclone), decommentarla
# e creare i segreti del repository indicati (Impostazioni → Actions → Segreti). I nomi dei
# segreti non possono iniziare con GITEA_ o GITHUB_.
# Istruzioni complete in docs/DEPLOY.md, sezione «Deploy automatico».
#
# Pubblica il contenuto dello zip della release, sito-studio-grasso-vX.Y.Z.zip: l'unico file
# allegato da release.yml (i due archivi «Source code» che Gitea aggiunge da solo sono il
# codice sorgente, non il sito). Dopo il download ne controlla l'integrità (unzip -t) e la
# presenza di index.html e .htaccess.
#
# 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).
# - Evento: per «release» Gitea supporta i tipi published (release non in bozza creata) ed
# edited (release modificata); una bozza non genera alcun evento. release.yml e
# scripts/release-upload.sh creano la release in bozza, caricano lo zip e solo allora la
# pubblicano: Gitea notifica questo passaggio come modifica, non come «published». Per questo
# si ascoltano entrambi i tipi, e il job «controllo» procede solo per una release stabile che
# sia l'ultima pubblicata e, per le modifiche, solo se lo zip è stato caricato 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: Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro
# workflow (per evitare cicli). L'avvio automatico funziona quindi solo se release.yml
# pubblica la release con un token personale (segreto RELEASE_TOKEN). Senza il segreto,
# avviarlo a mano dalla scheda Actions del repository.
# - File: per gli eventi di release Gitea legge il workflow dal commit del tag, quindi questo
# file deve già essere nel commit su cui è messo il tag. Per una release uscita prima di
# aggiungerlo, usare l'avvio manuale.
# I file gestiti dall'hosting (.well-known/, .user.ini, cgi-bin/) sono esclusi dalla
# sincronizzazione, quindi non vengono cancellati.
# RUNNER: `runs-on: ubuntu-latest`, il label predefinito di act_runner, come negli altri
# workflow: sostituirlo se il runner ne usa un altro.
# =============================================================================
name: Deploy
on:
release:
types: [published, edited]
workflow_dispatch:
inputs:
tag:
description: 'Tag della release da pubblicare (es. v1.0.1)'
required: true
jobs:
controllo:
name: Release da pubblicare
runs-on: ubuntu-latest # label del runner: adattare se diverso
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: ${{ github.event.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
# il tag finisce in un indirizzo di download: solo vX.Y.Z (o vX.Y.Z-suffisso)
printf '%s' "$TAG_MANUALE" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.]+)?$' \
|| { echo "tag non valido: $TAG_MANUALE (atteso vX.Y.Z)" >&2; exit 1; }
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
# modifica anziché prima pubblicazione: si procede solo se lo zip è appena stato
# caricato, 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: ubuntu-latest # label del runner: adattare se diverso
container:
image: debian:stable-slim
steps:
- name: Strumenti
run: apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip
# aggiungere: rsync openssh-client (variante A) · lftp (variante B) · rclone (variante C)
- name: Scarica e controlla lo zip della release
env:
TAG: ${{ needs.controllo.outputs.tag }}
TOKEN: ${{ secrets.GITHUB_TOKEN }} # token automatico del workflow
run: |
set -eu
VERSION="${TAG#v}"
curl -fsSL -H "Authorization: token ${TOKEN}" -o pacchetto.zip \
"${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}/sito-studio-grasso-v${VERSION}.zip"
unzip -tq pacchetto.zip # integrità: si ferma se lo zip è danneggiato o incompleto
mkdir sito && unzip -q pacchetto.zip -d sito
for f in index.html .htaccess; do
[ -f "sito/$f" ] || { echo "manca $f nel pacchetto: non è lo zip del sito" >&2; exit 1; }
done
# ---------------------------------------------------------------------------
# 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_PATH>/.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:
# DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
# DEPLOY_USER: ${{ secrets.DEPLOY_USER }}
# DEPLOY_PATH: ${{ secrets.DEPLOY_PATH }}
# 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:
# FTP_HOST: ${{ secrets.FTP_HOST }}
# FTP_USER: ${{ secrets.FTP_USER }}
# 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"
# ---------------------------------------------------------------------------
# Variante C — object storage S3 compatibile con rclone
# Segreti: RCLONE_CONFIG (contenuto di rclone.conf con il remote «sito»), RCLONE_DEST (es. sito:bucket)
# ---------------------------------------------------------------------------
# - name: Pubblica su object storage
# env:
# 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 }}
run: |
set -eu
# dominio per cui è stato costruito il pacchetto: la riga «Sitemap:» del robots.txt
# (scritto in build da src/pages/robots.txt.ts), se la variabile del repository SITE_URL
# non è impostata
if [ -z "$SITE_URL" ]; then
SITE_URL="$(tr -d '\r' < sito/robots.txt | sed -n 's|^Sitemap: \(.*\)/sitemap-index\.xml$|\1|p' | head -n 1)"
fi
SITE_URL="${SITE_URL%/}"
: "${SITE_URL:?dominio del sito non trovato (riga Sitemap: di robots.txt nel pacchetto)}"
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 ]
done
code=$(curl -s -o /dev/null -w '%{http_code}' "${SITE_URL}/pagina-inesistente/"); echo "404 → ${code}"; [ "$code" = 404 ]
+28 -20
View File
@@ -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;
+54 -19
View File
@@ -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',
];
+108 -68
View File
@@ -1,6 +1,6 @@
# PROMPT PER CLAUDE CODE — Nuovo sito web «Studio Grasso» (Studio Tributario e Societario)
Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformità legale, test, CI/CD Forgejo, packaging release.
Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformità legale, test, CI/CD su Gitea, packaging release.
> **Per chi legge (Claude Code):** questo documento è l'unica fonte dei requisiti e contiene tutto ciò che serve per costruire il sito da zero: contenuti già estratti dal sito attuale (§4), specifiche di design con mockup (§6–7, Appendici A–C), vincoli legali (§8), suite di test (§11), pipeline CI e packaging (§12). Non sono previste domande di chiarimento: dove un'informazione manca, applica le regole di §0 e registra la scelta in `DECISIONS.md`.
@@ -23,7 +23,7 @@ Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformit
- **Cliente.** Studio Grasso — Studio Tributario e Societario. Sede principale a Montegrosso d'Asti (AT), sede secondaria ad Asti (ricevimento su appuntamento). Due professionisti: **Dott. Ezio Grasso** (tributarista qualificato I.N.T. ai sensi della L. 4/2013, difensore tributario abilitato MEF, CTU e perito del Tribunale di Asti, responsabile Centro Autorizzato CAF) e **Dott.ssa Giulia Grasso** (Dottore Commercialista, ODCEC di Asti). Clientela: imprese, professionisti, privati, dipendenti e pensionati.
- **Sito attuale.** `http://www.grassoezio.it/` (realizzato nel 2016). Problemi da non ripetere: solo HTTP; cookie banner con "consenso implicito" (non conforme alle Linee guida del Garante del 10/6/2021); `meta viewport` con `user-scalable=no` (viola l'accessibilità); Google Analytics e Google Maps caricati senza consenso; informativa privacy generica che cita servizi non usati (AdSense, YouTube, LiveChat, Hotjar, social plugin); terminologia normativa in parte superata (vedi §4.9). **I contenuti sono già stati estratti e riportati in §4: non devi fare scraping del vecchio sito e non devi copiarne immagini, loghi o codice.**
- **Risultato atteso.** Un repository Git locale, pronto per essere pubblicato su un'istanza Forgejo, contenente: sito statico completo (tutte le pagine di §5), suite di test (§11), workflow CI (verifica a ogni push/PR) e workflow Release (a ogni tag `vX.Y.Z` pubblica nella sezione *Release* di Forgejo un `.zip` e un `.tar.gz` del sito pronti per qualsiasi hosting, con checksum), documentazione per deploy e per l'aggiornamento dei contenuti da parte dello studio.
- **Risultato atteso.** Un repository Git locale, pronto per essere pubblicato su Gitea (istanza `https://gitea.encke-hake.ts.net`, repository `BalboSoft/Studio_Grasso`), contenente: sito statico completo (tutte le pagine di §5), suite di test (§11), workflow CI (Gitea Actions: verifica a ogni push su `main`, a ogni pull request e a mano) e workflow Release (a ogni tag `vX.Y.Z` verifica tutto e pubblica nella sezione *Release* di Gitea **un solo file allegato**, `sito-studio-grasso-vX.Y.Z.zip`: il sito pronto da estrarre nella cartella pubblica di qualsiasi hosting), documentazione per deploy e per l'aggiornamento dei contenuti da parte dello studio.
- **Hosting di destinazione.** Non ancora definito (scenario più probabile: hosting condiviso italiano Apache/LiteSpeed con PHP; possibile anche nginx o object storage). Il pacchetto deve quindi essere **universale**: solo file statici, con `.htaccess` incluso e configurazione nginx di esempio fuori dal pacchetto.
- **Stile.** Semplice ma moderno: sobrio, ordinato, molto leggibile, "istituzionale senza essere datato". Fiducia e chiarezza, niente effetti speciali.
@@ -59,8 +59,8 @@ Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformit
| SEO | `@astrojs/sitemap`, `robots.txt`, meta/OG/canonical centralizzati in `BaseLayout.astro`, JSON-LD (§9.2) | |
| Test | Playwright (`@playwright/test`) + `@axe-core/playwright`, `html-validate`, `linkinator`, `@lhci/cli`, script Node custom per conformità e pacchetto (§11) | |
| Qualità codice | ESLint (config Astro + TS), Prettier (`prettier-plugin-astro`), Stylelint (facoltativo), EditorConfig | `npm run lint` e `npm run format:check` fanno parte di `verify`. |
| Packaging | `scripts/package.mjs` con `archiver` (zip + tar.gz deterministici) e `SHA256SUMS.txt` | §12.3 |
| CI | Forgejo Actions (`.forgejo/workflows/*.yml`) | §12 |
| Packaging | `scripts/package.mjs` con `archiver` (un solo zip deterministico) | §12.4 |
| CI | Gitea Actions (`.gitea/workflows/*.yml`), runner `act_runner` con label `ubuntu-latest` | §12 |
### 3.2 Struttura del repository (obbligatoria)
@@ -69,12 +69,12 @@ sito-studio-grasso/
├── .editorconfig .nvmrc .gitignore .prettierrc eslint.config.js
├── astro.config.mjs tsconfig.json package.json package-lock.json
├── playwright.config.ts lighthouserc.cjs .htmlvalidate.json
├── README.md # panoramica, comandi, come pubblicare su Forgejo, come rilasciare
├── README.md # panoramica, comandi, come pubblicare su Gitea, come rilasciare
├── CHANGELOG.md # Keep a Changelog, versione 1.0.0 iniziale
├── DECISIONS.md # log decisioni (§0.4)
├── TODO-STUDIO.md # dati/azioni richiesti allo studio (§0.5)
├── docs/
│ ├── DEPLOY.md # come usare il pacchetto release su cPanel/Plesk/FTP/nginx; deploy automatico futuro
│ ├── DEPLOY.md # come usare lo zip della release su cPanel/Plesk/FTP/nginx; deploy automatico futuro
│ ├── CONTENUTI.md # guida non tecnica per aggiornare testi, servizi, orari, link utili
│ ├── CONFORMITA.md # checklist legale (§8) con stato e riferimenti ai file
│ └── mockups/ # copia dei PNG dei mockup, se forniti insieme a questo brief (facoltativo)
@@ -93,20 +93,20 @@ sito-studio-grasso/
│ ├── assets/ (logo.svg, logo-mark.svg, illustrazioni SVG originali)
│ └── scripts/ (menu.ts, map-consent.ts, form.ts, legacy-anchors.ts) — piccoli, senza dipendenze
├── scripts/
│ ├── package.mjs # crea release/*.zip, *.tar.gz, SHA256SUMS.txt, BUILD-INFO.txt
│ ├── package.mjs # crea release/sito-studio-grasso-vX.Y.Z.zip (unico file)
│ ├── check-compliance.mjs # test di conformità sul dist (§11.5)
│ ├── check-package.mjs # test di integrità del pacchetto (§11.7)
│ ├── generate-icons.mjs # favicon/apple-touch/og da logo.svg (sharp)
│ ├── changelog-notes.mjs # estrae dal CHANGELOG la sezione della versione (note di rilascio)
│ └── release-upload.sh # fallback: upload asset release via API Forgejo (curl)
│ └── release-upload.sh # pubblica la release e carica lo zip via API REST di Gitea (curl)
├── tests/
│ ├── e2e/*.spec.ts # smoke, navigazione, menu mobile, form, no-third-party, no-cookies
│ └── a11y/*.spec.ts # axe su tutte le pagine + tastiera
├── deploy/
│ ├── nginx.conf.example
│ ├── optional-php-form/contact.php # handler form (modalità "php", §10.1)
│ └── forgejo-deploy.yml.example # workflow deploy futuro (rsync/FTPS), disattivato
└── .forgejo/workflows/ci.yml release.yml
│ └── gitea-deploy.yml.example # workflow deploy futuro (rsync/FTPS), disattivato
└── .gitea/workflows/ci.yml release.yml
```
### 3.3 Script npm (nomi obbligatori)
@@ -118,7 +118,7 @@ test (= html+links+e2e+a11y+compliance) · verify (= lint + format:check + check
package (= build + scripts/package.mjs + test:package) · icons (= scripts/generate-icons.mjs)
```
`npm run verify` è il comando che la CI esegue; deve terminare con exit code 0 in locale prima di considerare chiusa la fase 6.
`npm run verify` è il comando di riferimento: la CI ne ripete i passi uno per uno (§12.2) e il workflow di release lo esegue per intero (§12.3); deve terminare con exit code 0 in locale prima di considerare chiusa la fase 6.
---
@@ -582,7 +582,7 @@ Pagina volontaria (lo studio non rientra nei soggetti obbligati dalla L. 4/2004
---
## 11. Test e quality gate (tutti eseguiti da `npm run verify`)
## 11. Test e quality gate (eseguiti da `npm run verify`; il controllo del pacchetto, 11.7, da `npm run package`)
| # | Suite | Strumento | Cosa verifica (criterio di superamento) |
|---|---|---|---|
@@ -592,21 +592,24 @@ Pagina volontaria (lo studio non rientra nei soggetti obbligati dalla L. 4/2004
| 11.4 | **E2E e privacy** | Playwright (`tests/e2e`) su `astro preview` | Ogni pagina → 200, un solo `h1`, `title` e `description` unici, `lang="it"`, canonical corretto; navigazione header/footer funzionante; 404 branded; **nessuna richiesta di rete verso host ≠ `localhost`** su tutte le pagine; **`context.cookies()` vuoto** dopo navigazione; `localStorage` vuoto; mappa: nessun iframe prima del click, iframe Google dopo il click; form (se attivo): validazione, honeypot, pagina grazie; anchor legacy → redirect alla pagina servizio; nessun errore in console. |
| 11.5 | **Conformità** | `scripts/check-compliance.mjs` su `dist/` | In **ogni** pagina: stringa `P.IVA 01597790052` nel footer; link a `/privacy-policy/`, `/cookie-policy/`, `/note-legali/`; pagine legali esistenti e con `h1`; nessun `http://` in `src`/`href` di risorse; nessun riferimento a `fonts.googleapis.com`, `gstatic`, `analytics`, `gtag`, `cdn.`; nessun `<iframe>` statico; nessun `user-scalable=no`; nessun placeholder (`TODO`, `lorem`, `XXX`, `[da`); tutte le `<img>` con `alt`; JSON-LD valido con i campi di §9.2; sitemap che elenca tutte le pagine (e nessuna in più, tranne `grazie` se `noindex`); `robots.txt` con `Sitemap:`; `.htaccess` e `404.html` presenti; i 9 badge e i 6 servizi presenti (confronto con `studio.ts`/collection); le parole «commercialist*» compaiono solo nelle frasi che riguardano la Dott.ssa Giulia Grasso, l'ODCEC o l'OCC (controllo per frase con whitelist; fallimento = errore); il riferimento alla L. 4/2013 compare nella scheda del Dott. Ezio Grasso e nelle Note legali. |
| 11.6 | **Lighthouse** | `@lhci/cli` (`lighthouserc.cjs`, preset mobile, 3 run, mediana) su home, `/servizi/`, un servizio, `/contatti/` | Soglie §9.3 come `assert` con `minScore` sulle 4 categorie (`categories:performance`, ecc.), preset `lighthouse:recommended` con le regole rumorose declassate a `warn`; Chrome = eseguibile di Playwright (`chromePath` ottenuto con `require('playwright').chromium.executablePath()`), così funziona anche nel container CI. |
| 11.7 | **Pacchetto** | `scripts/check-package.mjs` dopo `scripts/package.mjs` | Lo zip e il tar.gz contengono alla radice `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, `favicon.svg`, tutte le pagine; estrazione in cartella temporanea e confronto 1:1 con `dist/` (nessun file mancante/extra, dimensioni uguali); `SHA256SUMS.txt` verificato con `sha256sum -c`; nome file = `sito-studio-grasso-v<versione>.<ext>`; dimensione zip ≤ 5 MB; `BUILD-INFO.txt` contiene versione, commit, data. |
| 11.8 | **Link** | `linkinator` ricorsivo su `astro preview` | Zero link interni rotti (incluse immagini e asset). Link esterni: verificati in un job separato **non bloccante** della CI (`continue-on-error: true`) perché dipendono dalla rete del runner; in locale eseguire `npm run test:links -- --external` prima del rilascio. |
| 11.7 | **Pacchetto** | `scripts/check-package.mjs` dopo `scripts/package.mjs` (eseguito da `npm run package`; la CI lo esegue come ultimo passo) | `release/` contiene solo lo zip, con nome `sito-studio-grasso-v<versione>.zip`; lo zip, letto con CRC e dimensioni, contiene alla radice `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, `favicon.svg`, tutte le pagine; confronto 1:1 con `dist/` (nessun file mancante/extra, contenuto identico, nessuna cartella di primo livello); dimensione zip ≤ 5 MB. |
| 11.8 | **Link** | `linkinator` ricorsivo su `astro preview` | Zero link interni rotti (incluse immagini e asset). Link esterni: verificati in un job separato della CI, con `continue-on-error: true` sullo step (non sul job), così non è bloccante: dipendono dalla rete del runner. In locale eseguire `npm run test:links -- --external` prima del rilascio. |
Regole: i test leggono l'elenco pagine da `sitemap` (nessuna lista hardcoded da tenere allineata); ogni test ha messaggi di errore in italiano che dicono *cosa* e *dove*; Playwright produce report HTML in `playwright-report/` (gitignored, caricato come artifact in CI quando fallisce).
Regole: i test leggono l'elenco pagine da `sitemap` (nessuna lista hardcoded da tenere allineata); ogni test ha messaggi di errore in italiano che dicono *cosa* e *dove*; Playwright produce report HTML in `playwright-report/` (gitignored, caricato come artifact in CI quando fallisce); il report Lighthouse (`.lighthouseci/`) è sempre allegato all'esecuzione della CI.
---
## 12. CI/CD su Forgejo e packaging della release
## 12. CI/CD su Gitea e packaging della release
### 12.1 Convenzioni
- Branch `main` protetto (consiglio nel README). Commit con Conventional Commits in italiano (`feat: …`, `fix: …`, `docs: …`, `ci: …`, `test: …`).
- Versioni SemVer; tag `vX.Y.Z` (es. `v1.0.0`); `package.json.version` allineata; `CHANGELOG.md` aggiornato ad ogni versione (la sezione della versione diventa le note di rilascio).
- Le action vengono referenziate con URL completo su `code.forgejo.org` così da non dipendere dalla configurazione `DEFAULT_ACTIONS_URL` dell'istanza. `runs-on` usa il label `docker` (il più comune per `forgejo-runner`): **in cima ai workflow inserisci un commento che spiega come cambiarlo** (es. `ubuntu-latest`) e come impostare il segreto facoltativo `FORGEJO_TOKEN`.
- Piattaforma: Gitea, istanza `https://gitea.encke-hake.ts.net`, repository `BalboSoft/Studio_Grasso` (https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso). I workflow sono in `.gitea/workflows/` e girano con Gitea Actions su un runner `act_runner`.
- `runs-on` usa il label `ubuntu-latest`, quello predefinito di `act_runner`: **in cima ai workflow inserisci un commento che spiega come cambiarlo** se il runner è registrato con un altro label.
- Le action di terze parti vengono referenziate con URL completo su `github.com` (es. `https://github.com/actions/checkout@v4`), così da non dipendere dall'impostazione `DEFAULT_ACTIONS_URL` dell'istanza. Per gli artifact si usa `actions/upload-artifact@v3`: la v4 non funziona su Gitea. L'immagine Playwright del container (`mcr.microsoft.com/playwright:v1.56.1-noble`) ha la stessa versione di `@playwright/test`.
- Segreti e variabili (Impostazioni del repository → Actions): segreto **facoltativo** `RELEASE_TOKEN` (token personale con permesso `write:repository`, usato al posto del token automatico del workflow per pubblicare la release; vedi §12.3) e variabile `SITE_URL` con il dominio del sito, che sostituisce il valore predefinito di `site.config.mjs` in build e test. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Il commento in cima ai workflow spiega anche questo.
### 12.2 `.forgejo/workflows/ci.yml` — verifica a ogni push/PR (riferimento, adatta le versioni)
### 12.2 `.gitea/workflows/ci.yml` — verifica a ogni push su `main`, a ogni PR e a mano (riassunto del workflow reale, adatta le versioni)
```yaml
name: CI
@@ -614,102 +617,139 @@ on:
push:
branches: [main]
pull_request:
workflow_dispatch:
env:
ASTRO_TELEMETRY_DISABLED: '1'
CI: 'true'
SITE_URL: ${{ vars.SITE_URL }} # variabile del repository (facoltativa)
jobs:
verify:
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
runs-on: ubuntu-latest # label del runner: adattare se diverso
container:
image: mcr.microsoft.com/playwright:v1.56.0-noble # DEVE coincidere con la versione di @playwright/test in package.json
image: mcr.microsoft.com/playwright:v1.56.1-noble # DEVE coincidere con la versione di @playwright/test in package.json
timeout-minutes: 90
steps:
- uses: https://code.forgejo.org/actions/checkout@v4
- uses: https://code.forgejo.org/actions/setup-node@v4
- uses: https://github.com/actions/checkout@v4
- uses: https://github.com/actions/setup-node@v4
with:
node-version: 22
cache: npm
node-version-file: .nvmrc
- run: npm ci
- run: npm run verify
# i passi di `npm run verify`, uno per uno e nello stesso ordine
- run: npm run lint
- run: npm run format:check
- run: npm run check
- run: npm run build
- run: npm run test:html
- run: npm run test:links
- run: npm run test:e2e
- run: npm run test:a11y
- run: npm run test:compliance
- run: npm run test:lighthouse
- run: node scripts/package.mjs && npm run test:package # crea lo zip di rilascio e ne verifica il contenuto
- 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
continue-on-error: true
uses: https://github.com/actions/upload-artifact@v3 # la v4 non funziona su Gitea
with:
name: playwright-report
path: playwright-report
- name: Artifact dist
uses: https://code.forgejo.org/actions/upload-artifact@v3
- name: Report Lighthouse
if: always()
continue-on-error: true
uses: https://github.com/actions/upload-artifact@v3
with:
name: dist
path: dist
name: lighthouse
path: .lighthouseci
include-hidden-files: true # cartella nascosta: senza, l'action non carica nulla
external-links:
runs-on: docker
runs-on: ubuntu-latest
container:
image: node:22
continue-on-error: true
image: node:24
timeout-minutes: 45
steps:
- uses: https://code.forgejo.org/actions/checkout@v4
- uses: https://github.com/actions/checkout@v4
- run: npm ci
env:
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
- run: npm run build
- run: npm run test:links -- --external
continue-on-error: true # non bloccante: dipende dalla rete del runner e dai siti esterni
```
### 12.3 `.forgejo/workflows/release.yml` — pubblicazione in Release a ogni tag
- Il job `verify` ripete passo per passo `npm run verify`: nella pagina dell'esecuzione si vede subito quale controllo è fallito. In coda costruisce anche lo zip di rilascio e ne verifica il contenuto (`scripts/package.mjs` + `scripts/check-package.mjs`), così un errore di pacchetto emerge in CI e non al momento del tag. Modificando gli script `verify`/`test` di `package.json`, aggiornare anche questi passi.
- Gli upload degli artifact hanno `continue-on-error`: un problema dello storage non deve rendere rossa una verifica andata a buon fine.
### 12.3 `.gitea/workflows/release.yml` — pubblicazione in Release a ogni tag (riassunto del workflow reale)
```yaml
name: Release
on:
push:
tags: ['v*.*.*']
env:
ASTRO_TELEMETRY_DISABLED: '1'
CI: 'true'
SITE_URL: ${{ vars.SITE_URL }} # variabile del repository (facoltativa)
jobs:
release:
runs-on: docker
runs-on: ubuntu-latest # label del runner: adattare se diverso
container:
image: mcr.microsoft.com/playwright:v1.56.0-noble
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
timeout-minutes: 90
steps:
- uses: https://code.forgejo.org/actions/checkout@v4
- uses: https://github.com/actions/checkout@v4
with:
fetch-depth: 0
- uses: https://github.com/actions/setup-node@v4
with:
node-version-file: .nvmrc
- run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV" # data riproducibile = data del commit
- run: npm ci
- run: npm run verify # nessuna release senza test verdi
- run: npm run package # crea release/ (zip, tar.gz, SHA256SUMS.txt, BUILD-INFO.txt) e li verifica
- name: Controlli preliminari (tag, versione, CHANGELOG)
env:
RELEASE_VERSION: ${{ github.ref_name }}
- name: Note di rilascio dal CHANGELOG
id: notes
run: |
{
echo 'notes<<NOTES_EOF'
node scripts/changelog-notes.mjs "${{ github.ref_name }}"
echo 'NOTES_EOF'
} >> "$GITHUB_OUTPUT"
- name: Pubblica la release su Forgejo
uses: https://code.forgejo.org/actions/forgejo-release@v2 # input: direction, url, repo, tag, token, release-dir, release-notes, prerelease, override, verbose
node -e '…' # il tag deve coincidere con "version" di package.json
node scripts/changelog-notes.mjs "$RELEASE_VERSION" > /dev/null # deve esistere la sezione del CHANGELOG
- run: npm run verify # nessuna release senza test verdi
- run: npm run package # crea release/ con il solo zip e ne verifica il contenuto
env:
RELEASE_VERSION: ${{ github.ref_name }}
- name: Pubblica la release con lo zip
env:
GITEA_URL: ${{ github.server_url }}
GITEA_REPO: ${{ github.repository }}
GITEA_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()
continue-on-error: true
uses: https://github.com/actions/upload-artifact@v3
with:
direction: upload
url: ${{ github.server_url }}
repo: ${{ github.repository }}
tag: ${{ github.ref_name }}
token: ${{ secrets.FORGEJO_TOKEN || secrets.GITHUB_TOKEN }}
release-dir: release # contiene SOLO zip, tar.gz, SHA256SUMS.txt, BUILD-INFO.txt
release-notes: ${{ steps.notes.outputs.notes }}
verbose: true
name: playwright-report
path: playwright-report
```
- Fallback: `scripts/release-upload.sh` crea la release e carica gli asset via API REST (`POST /api/v1/repos/{owner}/{repo}/releases` e `POST …/releases/{id}/assets?name=…`) usando `FORGEJO_URL`, `FORGEJO_REPO`, `FORGEJO_TOKEN`; documentato in DEPLOY.md per l'uso manuale o come step alternativo.
- `README.md` deve spiegare: il token automatico può non avere il permesso di creare release su alcune istanze → creare un *access token* con scope `write:repository` e salvarlo come segreto `FORGEJO_TOKEN` nel repository.
- Come rilasciare: aggiornare `version` in `package.json` e la sezione `## [X.Y.Z]` di `CHANGELOG.md`, committare su `main`, poi `git tag vX.Y.Z && git push origin vX.Y.Z`. Il workflow si ferma se il tag non coincide con la versione di `package.json` o se manca la sezione del CHANGELOG, che diventa il testo della release.
- Pubblicazione: `scripts/release-upload.sh` (solo `curl` e `node`) usa l'API REST di Gitea (`POST /api/v1/repos/{owner}/{repo}/releases`, poi `POST …/releases/{id}/assets?name=…`) con le variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`, senza action esterne di release. Controlla che il tag sia già sul server e punti allo stesso commit del tag locale, crea la release in bozza, carica lo zip e solo allora la pubblica; se la release esiste già sostituisce il file con lo stesso nome. Le note sono la sezione del `CHANGELOG.md` estratta da `scripts/changelog-notes.mjs`. Lo stesso script si usa anche a mano (documentato in DEPLOY.md).
- Token: per impostazione predefinita la release è pubblicata con il token automatico del workflow. `README.md` deve spiegare che, se la release non viene creata (errore 403 o 404 nello step di pubblicazione), occorre creare un *access token* personale con permesso `write:repository` e salvarlo come segreto del repository `RELEASE_TOKEN` (se esiste, viene usato al posto del token automatico). Non usare nomi che iniziano con `GITEA_` o `GITHUB_`.
- Contenuto della release: **un solo file allegato**, `sito-studio-grasso-vX.Y.Z.zip`. Gitea aggiunge da solo a ogni release due archivi, «Source code (ZIP)» e «Source code (TAR.GZ)»: contengono il codice sorgente, **non** il sito. Per mettere il sito online va scaricato lo zip `sito-studio-grasso-vX.Y.Z.zip` dall'elenco delle release (https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases).
### 12.4 Pacchetto di rilascio (`scripts/package.mjs`)
- Input: `dist/` (dopo `npm run build`), versione da `RELEASE_VERSION` (tag) oppure `package.json`.
- Output in `release/`: `sito-studio-grasso-v<versione>.zip` (formato primario: tutti i pannelli hosting — cPanel, Plesk, Aruba, Register, SiteGround, ecc. — estraggono zip), `sito-studio-grasso-v<versione>.tar.gz` (server Linux/SSH, nginx, object storage), `SHA256SUMS.txt`, `BUILD-INFO.txt` (versione, commit, data ISO, Node, Astro).
- Layout degli archivi: **contenuto di `dist/` alla radice** (nessuna cartella di primo livello), `.htaccess` incluso; voci ordinate e mtime fisso (archivi riproducibili).
- Output in `release/`: **un solo file**, `sito-studio-grasso-v<versione>.zip` (tutti i pannelli hosting — cPanel, Plesk, Aruba, Register, SiteGround, ecc. — estraggono zip). È l'unico file della cartella, e quindi l'unico allegato della release.
- Layout dello zip: **contenuto di `dist/` alla radice** (nessuna cartella di primo livello), `.htaccess` incluso; voci ordinate e date fisse (`SOURCE_DATE_EPOCH`, altrimenti la data dell'ultimo commit): a parità di `dist/` lo zip è identico, anche tra sistemi operativi diversi.
- Esclusioni: `*.map`, file di sistema.
- `docs/DEPLOY.md`: procedura per cPanel/Plesk (upload zip → estrai in `public_html`/`httpdocs` → verifica `.htaccess`), FTP/SFTP (estrazione locale + upload binario), nginx (config in `deploy/nginx.conf.example`: `try_files`, `error_page 404`, header di sicurezza, cache), oggetti statici (S3-compatible). Checklist post-deploy: HTTPS attivo, redirect `/privacy`, 404, `sitemap-index.xml` raggiungibile, test Lighthouse su produzione.
- `docs/DEPLOY.md`: procedura per cPanel/Plesk (scarica `sito-studio-grasso-vX.Y.Z.zip` dalla pagina della release, non gli archivi «Source code» → upload zip → estrai in `public_html`/`httpdocs` → verifica `.htaccess`), FTP/SFTP (estrazione locale + upload binario), nginx (config in `deploy/nginx.conf.example`: `try_files`, `error_page 404`, header di sicurezza, cache), oggetti statici (S3-compatible). Checklist post-deploy: HTTPS attivo, redirect `/privacy`, 404, `sitemap-index.xml` raggiungibile, test Lighthouse su produzione.
### 12.5 Deploy automatico futuro (destinazione da definire)
- `deploy/forgejo-deploy.yml.example`: job `deploy` che si attiva dopo `release` (o su `workflow_dispatch`), scarica l'asset della release o usa `dist/` e pubblica con **una** delle varianti commentate: `rsync` su SSH (segreti `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY`), `lftp` FTPS (`FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH`), `rclone` per object storage. Il file non va attivato (resta `.example`), DEPLOY.md spiega come abilitarlo.
- `deploy/gitea-deploy.yml.example`: job `deploy` che si avvia alla pubblicazione di una release (o a mano con `workflow_dispatch`, indicando il tag), scarica dalla release lo zip `sito-studio-grasso-vX.Y.Z.zip` già verificato e pubblica con **una** delle varianti commentate: `rsync` su SSH (segreti `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY`), `lftp` FTPS (`FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH`), `rclone` per object storage. Il file non è attivo (resta `.example`): per attivarlo si copia in `.gitea/workflows/deploy.yml`; DEPLOY.md spiega come.
---
## 13. Documentazione da produrre
- `README.md`: cos'è, requisiti, comandi (`dev`, `build`, `verify`, `package`), struttura, come pubblicare su Forgejo (`git remote add origin …`, push `main`, push del tag), come fare una release (bump versione + CHANGELOG + tag), configurazioni (`SITE_URL`, `contactForm.mode`), link a docs/.
- `README.md`: cos'è, requisiti, comandi (`dev`, `build`, `verify`, `package`), struttura, come pubblicare su Gitea (`git remote add origin …`, push `main`, push del tag), come fare una release (bump versione + CHANGELOG + tag), segreto facoltativo `RELEASE_TOKEN` e quale file scaricare dalla release (lo zip `sito-studio-grasso-vX.Y.Z.zip`, non gli archivi «Source code»), configurazioni (`SITE_URL`, anche come variabile del repository per CI e release; `contactForm.mode`), link a docs/.
- `docs/CONTENUTI.md`: guida **non tecnica** (per lo studio) per modificare orari, recapiti, testi dei servizi, link utili, pagine legali; dove si trovano i file; come chiedere la pubblicazione (commit → tag → release).
- `docs/DEPLOY.md` (§12.4–12.5), `docs/CONFORMITA.md` (§8.7), `DECISIONS.md` (§0.4), `TODO-STUDIO.md` (§0.5), `CHANGELOG.md`, `public/images/README.md` (immagini che lo studio può fornire: foto della sede e dei professionisti con dimensioni consigliate, loghi degli enti solo se autorizzati).
@@ -724,23 +764,23 @@ jobs:
4. **Conformità** — pagine legali (§8.3–8.6), `.htaccess` (§9.4, §5.3), `robots.txt`, sitemap, `docs/CONFORMITA.md`, aggiornamento `TODO-STUDIO.md`. Commit.
5. **SEO, performance, accessibilità** — meta per pagina, JSON-LD completo, ottimizzazione immagini/asset, `prefers-reduced-motion`, `print.css`, controllo contrasto. Commit.
6. **Test** — suite §11 completa; `npm run verify` verde in locale (installa i browser Playwright con `npx playwright install --with-deps chromium` se mancano). Commit.
7. **CI/CD e packaging** — workflow §12.2–12.3, `package.mjs`, `check-package.mjs`, `changelog-notes.mjs`, `release-upload.sh`, `deploy/*`; esegui `npm run package` in locale e verifica il contenuto dello zip (`unzip -l`). Commit.
7. **CI/CD e packaging** — workflow in `.gitea/workflows/` (§12.2–12.3), `package.mjs`, `check-package.mjs`, `changelog-notes.mjs`, `release-upload.sh`, `deploy/*`; esegui `npm run package` in locale e verifica il contenuto dello zip (`unzip -l`). Commit.
8. **Documentazione e QA finale** — docs §13; rilettura di tutte le pagine nel browser headless (screenshot desktop e mobile di ogni pagina in `docs/screenshots/`, gitignorabili se > 2 MB totali); controllo ortografico dei testi italiani; `npm run verify` finale. Commit `chore(release): prepara v1.0.0` (senza tag).
9. **Report finale** (unico momento in cui ti fermi) — stampa in chat: elenco pagine generate; risultato di ogni suite di test con numeri (pagine testate, violazioni, punteggi Lighthouse, dimensione zip); contenuto di `TODO-STUDIO.md` (bloccanti in evidenza); decisioni principali; comandi esatti per pubblicare su Forgejo e creare la prima release (`git remote add origin <url>`, `git push -u origin main`, `git tag v1.0.0`, `git push origin v1.0.0`) e il promemoria sul segreto `FORGEJO_TOKEN`.
9. **Report finale** (unico momento in cui ti fermi) — stampa in chat: elenco pagine generate; risultato di ogni suite di test con numeri (pagine testate, violazioni, punteggi Lighthouse, dimensione zip); contenuto di `TODO-STUDIO.md` (bloccanti in evidenza); decisioni principali; comandi esatti per pubblicare su Gitea e creare la prima release (`git remote add origin https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso.git`, `git push -u origin main`, `git tag v1.0.0`, `git push origin v1.0.0`), il promemoria sul segreto facoltativo `RELEASE_TOKEN` (§12.3) e sulla variabile `SITE_URL`, e l'indicazione di quale file scaricare dalla release per mettere il sito online: `sito-studio-grasso-v1.0.0.zip`, non gli archivi «Source code».
---
## 15. Criteri di accettazione (Definition of Done)
- [ ] `npm run verify` termina con exit code 0 (lint, format, check, build, HTML, link interni, e2e, a11y, conformità, Lighthouse con soglie §9.3).
- [ ] `npm run package` produce zip + tar.gz + SHA256SUMS + BUILD-INFO verificati da `check-package`.
- [ ] `npm run package` produce in `release/` il solo `sito-studio-grasso-v<versione>.zip`, verificato da `check-package`.
- [ ] Tutte le pagine di §5.1 esistono, con i contenuti di §4 integrali e gli aggiornamenti di §4.9.
- [ ] Nessuna richiesta esterna, nessun cookie, nessun banner; mappa e Google solo su click.
- [ ] Footer con P.IVA e link legali in ogni pagina; pagine legali complete e coerenti con l'uso reale; riferimento L. 4/2013 presente.
- [ ] Nessuna attribuzione errata di titoli professionali (controllo automatico §11.5 + rilettura manuale in fase 8).
- [ ] Nessun placeholder, nessun dato inventato; `TODO-STUDIO.md` elenca tutto ciò che manca con istruzioni.
- [ ] Mobile: menu e sottomenu accessibili, layout corretto a 360–390 px; desktop corretto a 1440 px.
- [ ] Workflow CI e Release presenti, con action referenziate via URL completo e commento sul label del runner.
- [ ] Workflow CI e Release presenti in `.gitea/workflows/`, con action referenziate via URL completo e commento sul label del runner (`ubuntu-latest`); la release pubblica un solo allegato, lo zip del sito.
- [ ] Documentazione §13 completa; `DECISIONS.md` aggiornato; commit atomici con Conventional Commits.
- [ ] Nessun push, tag o deploy effettuato.
+16 -16
View File
@@ -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
+9 -8
View File
@@ -4,7 +4,7 @@ Guida per lo Studio: dove si trovano i testi e i dati e come modificarli. Non se
## Come si modifica un file
**Dal browser (consigliato):** aprire il repository su Forgejo, entrare nel file, premere l'icona a forma di matita («Modifica file»), fare la modifica, scrivere in basso una breve descrizione (es. `docs: aggiorna orari di agosto`) e confermare con **Commit**. La verifica automatica (CI) parte da sola: dopo qualche minuto, nella scheda **Actions**, un segno verde indica che è tutto a posto; una croce rossa indica un errore, con la spiegazione nel dettaglio dell'esecuzione.
**Dal browser (consigliato):** aprire il [repository su Gitea](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso), entrare nel file, premere l'icona a forma di matita («Modifica file»), fare la modifica, scrivere in basso una breve descrizione (es. `docs: aggiorna orari di agosto`) e confermare con **Commit**. La verifica automatica (CI) parte da sola: dopo qualche minuto, nella scheda **Actions**, un segno verde indica che è tutto a posto; una croce rossa indica un errore, con la spiegazione nel dettaglio dell'esecuzione.
**Dal computer:** modificare il file con un editor di testo (es. Visual Studio Code), poi `npm run verify` e commit.
@@ -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»).
@@ -113,5 +114,5 @@ Foto e loghi autorizzati vanno consegnati a chi gestisce il sito: vedi `public/i
## Pubblicare le modifiche
1. Verifica verde (segno verde nella scheda **Actions**, oppure `npm run verify` in locale).
2. Chiedere a chi gestisce il sito di creare una **nuova release** (aggiornamento della versione e del CHANGELOG, poi tag: vedi README, «Fare una release»). La release produce lo zip da caricare.
3. Caricare lo zip sull'hosting come descritto in `docs/DEPLOY.md` (o automaticamente, se è stato attivato il deploy automatico).
2. Chiedere a chi gestisce il sito di creare una **nuova release** (aggiornamento della versione e del CHANGELOG, poi tag: vedi README, «Fare una release»). Al termine del workflow la release compare nella sezione [Release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases) del repository, con un solo file allegato: lo zip `sito-studio-grasso-vX.Y.Z.zip`, che contiene il sito da caricare. Gli archivi «Source code (ZIP)» e «Source code (TAR.GZ)» che Gitea aggiunge da solo contengono il codice sorgente, non il sito: non vanno caricati sull'hosting.
3. Caricare lo zip `sito-studio-grasso-vX.Y.Z.zip` sull'hosting come descritto in `docs/DEPLOY.md` (o automaticamente, se è stato attivato il deploy automatico).
+61 -44
View File
@@ -1,83 +1,97 @@
# Pubblicare il sito sull'hosting
Il sito è un insieme di **file statici**: funziona su qualsiasi hosting (Apache/LiteSpeed con o senza PHP, nginx, object storage). Ogni release pubblicata su Forgejo contiene:
Il sito è un insieme di **file statici**: funziona su qualsiasi hosting (Apache/LiteSpeed con o senza PHP, nginx, object storage). Ogni release pubblicata su Gitea ([elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases)) contiene un solo file allegato, quello del sito:
| File | Uso |
| ---------------------------------- | ------------------------------------------------------------------------------------------- |
| `sito-studio-grasso-vX.Y.Z.zip` | formato consigliato per i pannelli di hosting (cPanel, Plesk, Aruba, Register, SiteGround…) |
| `sito-studio-grasso-vX.Y.Z.tar.gz` | server Linux con accesso SSH, nginx, object storage |
| `SHA256SUMS.txt` | impronte per verificare che i file scaricati siano integri |
| `BUILD-INFO.txt` | versione, commit, data e strumenti usati per la build |
| File | Uso |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sito-studio-grasso-vX.Y.Z.zip` | il sito pronto, per ogni tipo di hosting: pannelli (cPanel, Plesk, Aruba, Register, SiteGround…), FTP, server Linux con SSH, nginx, object storage |
Il **contenuto del sito è alla radice dell'archivio** (non c'è una cartella da aprire): `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, le cartelle delle pagine e `_astro/`.
> **Quale file scaricare.** Nella pagina di ogni release Gitea aggiunge da solo anche «Source code (ZIP)» e «Source code (TAR.GZ)»: contengono il **codice sorgente** del sito, non il sito pronto, e non vanno caricati sull'hosting. Scaricare sempre e solo `sito-studio-grasso-vX.Y.Z.zip`.
Il **contenuto del sito è alla radice dello zip** (non c'è una cartella da aprire): `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, le cartelle delle pagine e `_astro/`.
> Il file `.htaccess` è **nascosto** (inizia con un punto): assicurarsi che il programma FTP o il file manager mostri i file nascosti e che venga caricato.
## 1. Scaricare e verificare il pacchetto
## 1. Scaricare e controllare il pacchetto
Dalla pagina **Release** del repository Forgejo scaricare lo zip (o il tar.gz) e `SHA256SUMS.txt` nella stessa cartella, poi:
1. Aprire l'[elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases) del repository e, nella release che si vuole pubblicare (di norma la più recente), scaricare **`sito-studio-grasso-vX.Y.Z.zip`**. Non scaricare i due «Source code».
2. Facoltativo, ma utile prima di caricare il sito: estrarre lo zip in una cartella vuota del proprio computer e controllare che contenga `index.html` **e** `.htaccess`. Un file scaricato a metà o danneggiato dà un errore.
```bash
sha256sum -c SHA256SUMS.txt --ignore-missing # Linux
shasum -a 256 -c SHA256SUMS.txt --ignore-missing # macOS
```
Su Windows (PowerShell):
Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorithm SHA256` e confrontare con la riga corrispondente di `SHA256SUMS.txt`.
```powershell
Expand-Archive .\sito-studio-grasso-vX.Y.Z.zip -DestinationPath .\sito
Get-ChildItem .\sito -Force # devono comparire index.html e .htaccess
```
Su Linux e macOS:
```bash
unzip -t sito-studio-grasso-vX.Y.Z.zip # «No errors detected» se lo zip è integro
unzip -q sito-studio-grasso-vX.Y.Z.zip -d sito
ls -a sito # devono comparire index.html e .htaccess
```
## 2. Hosting con pannello (cPanel, Plesk, DirectAdmin…)
1. Aprire il **File Manager** del pannello ed entrare nella cartella pubblica del dominio (`public_html` su cPanel, `httpdocs` su Plesk).
2. Fare una copia di sicurezza del sito esistente (o scaricarla), poi svuotare la cartella.
3. Caricare lo zip e usare **Estrai** (Extract) nella stessa cartella.
3. Caricare lo zip `sito-studio-grasso-vX.Y.Z.zip` (non i «Source code») e usare **Estrai** (Extract) nella stessa cartella.
4. Verificare che nella cartella ci siano `index.html` **e** `.htaccess` (attivare «mostra file nascosti»), poi eliminare lo zip.
5. Attivare il certificato **HTTPS** (Let's Encrypt/AutoSSL) dal pannello, se non è già attivo.
### 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 `<IfModule>`).
- La configurazione è stata provata su Apache 2.4 con `AllowOverride All` (vedi DECISIONS.md, D-034).
## 3. FTP / SFTP
1. Estrarre lo zip **sul proprio computer** in una cartella vuota.
1. Estrarre lo zip del sito **sul proprio computer** in una cartella vuota (sezione 1).
2. Con il programma FTP (es. FileZilla, modalità di trasferimento automatica o binaria) caricare **il contenuto** della cartella, `.htaccess` compreso, nella cartella pubblica del dominio, sostituendo i file esistenti.
3. Eliminare dal server i file del vecchio sito non più presenti (es. vecchie pagine `.php` o `.html`), dopo averne fatto una copia.
## 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.zip` sul server (ad esempio con `scp`), estrarlo con `unzip` 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 unzip -q sito-studio-grasso-vX.Y.Z.zip -d "$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 lo zip. Servono i programmi `unzip` e `rsync` (su Debian e Ubuntu: `sudo apt install unzip rsync`). 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)
1. Estrarre il tar.gz e caricare il contenuto nel bucket (es. `rclone sync sito/ remote:bucket`), con «documento indice» `index.html` e «documento di errore» `404.html`.
1. Estrarre lo zip (`unzip -q sito-studio-grasso-vX.Y.Z.zip -d sito`) e caricare il contenuto nel bucket (es. `rclone sync sito/ remote:bucket`), con «documento indice» `index.html` e «documento di errore» `404.html`.
2. Il `.htaccess` non è usato: configurare **nel CDN o nel servizio** redirect HTTPS, il redirect `/privacy` → `/privacy-policy/` e gli header di sicurezza (Content-Security-Policy, X-Content-Type-Options, Referrer-Policy, X-Frame-Options, Permissions-Policy) come in `public/.htaccess`.
## 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 +101,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,30 +121,33 @@ 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 dall'[elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases) lo zip `sito-studio-grasso-vX.Y.Z.zip` 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/gitea-deploy.yml.example`](../deploy/gitea-deploy.yml.example) è un workflow pronto ma **non attivo**: quando `release.yml` pubblica una release stabile (o su avvio manuale, indicando il tag) scarica lo zip `sito-studio-grasso-vX.Y.Z.zip` della release, ne controlla l'integrità (`unzip -t`) e la presenza di `index.html` e `.htaccess`, 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`.
Per le release Gitea supporta gli eventi `published` (release non in bozza creata) ed `edited` (release modificata); una bozza non genera alcun evento. Il workflow di release crea la release in bozza, carica lo zip e solo allora la pubblica: Gitea notifica questo passaggio come modifica, non come `published`. Per questo il deploy ascolta entrambi gli eventi e il suo primo job («controllo») decide se procedere.
1. Copiarlo in `.gitea/workflows/deploy.yml` e committarlo su `main`. Per gli eventi di release Gitea legge il workflow dal commit del tag: il file deve quindi essere già nel commit su cui è messo il tag. Per una release uscita prima di aggiungerlo, usare l'avvio manuale.
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:** Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro workflow (per evitare cicli). Perché il deploy parta da solo, `release.yml` deve quindi pubblicare la release con un token personale: segreto `RELEASE_TOKEN`, un _access token_ con permesso `write:repository` (vedi README, «Fare una release»). I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Senza il segreto il deploy si avvia a mano dalla scheda **Actions** del repository (workflow «Deploy», indicando il tag).
4. Facoltativo: variabile del repository `SITE_URL` (Impostazioni → Actions → Variabili), 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 della riga `Sitemap:` del `robots.txt` contenuto nello zip (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`).
6. Aggiungere al passo «Strumenti» i programmi della variante scelta (`rsync openssh-client`, `lftp` o `rclone`; `unzip` c'è già).
7. I job usano il label `ubuntu-latest`, il predefinito di `act_runner`, come `ci.yml` e `release.yml`: sostituirlo se il runner ne usa un altro.
## 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
FORGEJO_URL=https://forgejo.example.it FORGEJO_REPO=proprietario/repository \
FORGEJO_TOKEN=<token write:repository> scripts/release-upload.sh vX.Y.Z
GITEA_URL=https://gitea.encke-hake.ts.net GITEA_REPO=BalboSoft/Studio_Grasso \
GITEA_TOKEN=<token write:repository> 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/`.
`GITEA_TOKEN` è un _access token_ personale con permesso `write:repository` (Impostazioni utente → Applicazioni). Il tag deve già esistere sul server (`git push origin vX.Y.Z`): lo script (solo `curl` e `node`, usa l'API REST di Gitea) si ferma se manca o se punta a un commit diverso dal tag locale. Come il workflow, crea la release in bozza, carica lo zip 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 il file con lo stesso nome, caricando il nuovo prima di cancellare il vecchio, e la pubblica con le note aggiornate.
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "sito-studio-grasso",
"version": "1.0.0",
"version": "1.1.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "sito-studio-grasso",
"version": "1.0.0",
"version": "1.1.0",
"license": "UNLICENSED",
"dependencies": {
"@astrojs/sitemap": "3.7.4",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "sito-studio-grasso",
"version": "1.0.0",
"version": "1.1.0",
"private": true,
"type": "module",
"description": "Sito web statico dello Studio Grasso — Studio Tributario e Societario (Montegrosso d'Asti e Asti)",
+2
View File
@@ -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
+3 -18
View File
@@ -1,21 +1,13 @@
#!/usr/bin/env node
/**
* Stampa la sezione di CHANGELOG.md relativa a una versione: diventa il testo della release.
* Uso: `node scripts/changelog-notes.mjs v1.0.0 [--shell-safe]` (oppure 1.0.0). Esce con
* Uso: `node scripts/changelog-notes.mjs v1.0.0` (oppure 1.0.0). Esce con
* codice 1 se la sezione non esiste, così non si pubblica una release senza note.
*
* `--shell-safe` (usato da release.yml): niente caratteri che una shell interpreterebbe se
* l'action li inserisse tra virgolette doppie: `codice` → «codice», " → ”, \ → /, $ → $.
*/
import { readFileSync } from 'node:fs';
import { resolve } from 'node:path';
const args = process.argv.slice(2);
const shellSafe = args.includes('--shell-safe');
const arg = (args.find((a) => !a.startsWith('--')) ?? process.env.RELEASE_VERSION ?? '').replace(
/^refs\/tags\//,
'',
);
const arg = (process.argv[2] ?? process.env.RELEASE_VERSION ?? '').replace(/^refs\/tags\//, '');
const version = arg.replace(/^v/, '');
if (!/^\d+\.\d+\.\d+/.test(version)) {
console.error('Uso: node scripts/changelog-notes.mjs vX.Y.Z');
@@ -44,11 +36,4 @@ if (!body) {
console.error(`La sezione ${version} di CHANGELOG.md è vuota.`);
process.exit(1);
}
const safe = (text) =>
text
.replace(/`([^`\n]*)`/g, '«$1»')
.replace(/`/g, '')
.replace(/"/g, '”')
.replace(/\\/g, '/')
.replace(/\$/g, '$');
process.stdout.write(`${shellSafe ? safe(body) : body}\n`);
process.stdout.write(`${body}\n`);
+208 -27
View File
@@ -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 </html> (es. uno <script> scritto fuori dal layout: errore di parsing HTML)
check(/<\/html>\s*$/i.test(html), where, 'contenuto dopo </html>: spostarlo dentro il layout');
// budget HTML + CSS (il CSS è incluso nella pagina)
const size = statSync(join(dist, file.replace(/^dist\//, ''))).size;
check(
@@ -523,7 +628,36 @@ function servicesFromCollection() {
}
const servizi = servicesFromCollection();
check(servizi.length === 6, 'src/content/servizi', `attesi 6 servizi, trovati ${servizi.length}`);
// almeno i 6 servizi del brief (§4.5): se ne possono aggiungere altri (docs/CONTENUTI.md)
check(
servizi.length >= 6,
'src/content/servizi',
`attesi almeno i 6 servizi del brief, trovati ${servizi.length}`,
);
// i sei servizi del brief (§4.5) con l'ancora del vecchio sito (§5.3): requisiti, non contenuti
const SERVIZI_BRIEF = [
['consulenza-fiscale-tributaria-e-societaria', 'consulenza-fiscale-tributaria-e-societaria-1'],
['contabilita-fiscale', 'contabilita-fiscale-2'],
['contenzioso-tributario', 'contenzioso-tributario-3'],
['centro-autorizzato-caf', 'centro-autorizzato-caf-4'],
['servizi-imprese-dipendenti-pensionati', 'servizi-alle-imprese-dipendenti-e-pensionati-5'],
['certificazione-atti-firma-digitale', 'certificazione-atti-mediante-firma-digitale-6'],
];
for (const [slug, anchor] of SERVIZI_BRIEF) {
check(
servizi.some((s) => s.slug === slug && s.anchor === anchor),
'src/content/servizi',
`manca il servizio del brief /servizi/${slug}/ con anchorLegacy «${anchor}» (link del vecchio sito)`,
);
}
for (const [key, label] of [
['slug', 'slug'],
['anchor', 'anchorLegacy'],
]) {
const values = servizi.map((s) => s[key]);
const repeated = [...new Set(values.filter((v, i) => values.indexOf(v) !== i))];
check(repeated.length === 0, 'src/content/servizi', `${label} ripetuti: ${repeated.join(', ')}`);
}
const hub = byPath.get('/servizi/');
const home = byPath.get('/');
for (const s of servizi) {
@@ -619,11 +753,13 @@ if (contatti) {
contatti.file,
'campo honeypot assente o raggiungibile da tastiera',
);
check(
all(contatti.doc, (n) => n.name === 'input' && attr(n, 'name') === 'ts').length === 1,
contatti.file,
'campo ts assente',
);
for (const name of ['ts', 'ts_invio']) {
check(
all(contatti.doc, (n) => n.name === 'input' && attr(n, 'name') === name).length === 1,
contatti.file,
`campo ${name} assente`,
);
}
const privacy = all(
contatti.doc,
(n) =>
@@ -633,6 +769,22 @@ if (contatti) {
}
}
// gestore PHP del modulo: nel sito solo con contactForm.mode = 'php' (docs/DEPLOY.md, sezione 6)
const phpHandler = existsSync(join(dist, 'contact.php'));
if (contactForm.mode === 'php') {
check(
phpHandler,
'dist/contact.php',
'contactForm.mode = "php" ma contact.php manca: copiare deploy/optional-php-form/contact.php in public/',
);
} else {
check(
!phpHandler,
'dist/contact.php',
`contact.php pubblicato con contactForm.mode = "${contactForm.mode}": toglierlo da public/ (la privacy policy non lo descrive)`,
);
}
/* ------------------------------------------------------------------ asset */
const astroDir = join(dist, '_astro');
@@ -647,6 +799,7 @@ check(
);
for (const f of assets.filter((x) => /\.(js|css)$/.test(x))) {
const src = readFileSync(join(astroDir, f), 'utf8');
if (f.endsWith('.css')) for (const issue of cssIssues(src)) fail(`dist/_astro/${f}`, issue);
for (const re of FORBIDDEN_REFS)
check(
!re.test(src),
@@ -692,22 +845,50 @@ check(
const htaccess = existsSync(join(dist, '.htaccess'))
? readFileSync(join(dist, '.htaccess'), 'utf8')
: '';
// direttive cercate solo su righe attive (non commentate)
for (const [re, what] of [
[/ErrorDocument 404 \/404\.html/, 'ErrorDocument 404 /404.html'],
[/^\s*ErrorDocument 404 \/404\.html\s*$/m, 'ErrorDocument 404 /404.html'],
[
/RedirectMatch 301 \^\/privacy\/\?\$ \/privacy-policy\//,
/^\s*RedirectMatch 301 \^\/privacy\/\?\$ \/privacy-policy\/\s*$/m,
'redirect /privacy → /privacy-policy/',
],
[/X-Content-Type-Options "nosniff"/, 'X-Content-Type-Options'],
[/Referrer-Policy "strict-origin-when-cross-origin"/, 'Referrer-Policy'],
[/Permissions-Policy/, 'Permissions-Policy'],
[/X-Frame-Options "SAMEORIGIN"/, 'X-Frame-Options'],
[/#\s*Header always set Strict-Transport-Security/, 'HSTS presente ma commentato'],
[/\\\.map\$/, 'blocco dei file .map'],
[/^\s*Header always set X-Content-Type-Options "nosniff"\s*$/m, 'X-Content-Type-Options'],
[
/^\s*Header always set Referrer-Policy "strict-origin-when-cross-origin"\s*$/m,
'Referrer-Policy',
],
[/^\s*Header always set Permissions-Policy "[^"]+"\s*$/m, 'Permissions-Policy'],
[/^\s*Header always set X-Frame-Options "SAMEORIGIN"\s*$/m, 'X-Frame-Options'],
[/^\s*<FilesMatch "[^"]*\\\.map\$[^"]*">/m, 'blocco dei file .map'],
]) {
check(re.test(htaccess), 'dist/.htaccess', `manca: ${what}`);
}
// HSTS: commentato finché HTTPS non è verificato su tutto il dominio. Per attivarlo decommentare
// la riga in public/.htaccess E impostare qui HSTS_ATTIVO = true (docs/DEPLOY.md, sezione 2).
const HSTS_ATTIVO = false;
const hsts = /^\s*Header always set Strict-Transport-Security "max-age=(\d+)[^"]*"\s*$/m.exec(
htaccess,
);
if (HSTS_ATTIVO) {
check(
Boolean(hsts) && Number(hsts[1]) >= 31536000,
'dist/.htaccess',
'HSTS_ATTIVO = true ma Strict-Transport-Security non è attivo (max-age di almeno un anno)',
);
} else {
check(
/^\s*#\s*Header always set Strict-Transport-Security/m.test(htaccess),
'dist/.htaccess',
'manca la riga di HSTS (commentata)',
);
check(
!/^\s*Header always set Strict-Transport-Security/m.test(htaccess),
'dist/.htaccess',
'HSTS attivo: se HTTPS è verificato su tutto il dominio impostare HSTS_ATTIVO = true in scripts/check-compliance.mjs',
);
}
// Content-Security-Policy di §9.4, confrontata per direttive. Con il modulo esterno
// (`contactForm.mode = 'endpoint'`) form-action deve ammettere anche l'origine del fornitore.
const EXPECTED_CSP = {
+2 -1
View File
@@ -10,13 +10,14 @@
*/
import { resolve } from 'node:path';
import { LinkChecker, LinkState } from 'linkinator';
import { siteUrl } from '../site.config.mjs';
import { EXTRA_PAGES, readSitemapPaths } from './lib/pages.mjs';
import { root, startPreview } from './lib/preview-server.mjs';
const external = process.argv.includes('--external');
// URL assoluti del sito (canonical, og:url, og:image, JSON-LD): controllati sulla build locale,
// non sul dominio di produzione, che prima della pubblicazione ospita ancora il vecchio sito.
const SITE = (process.env.SITE_URL || 'https://www.grassoezio.it').replace(/\/+$/, '');
const SITE = siteUrl();
const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
const dist = resolve(root, 'dist');
const seeds = [...readSitemapPaths(dist), ...EXTRA_PAGES];
+16 -96
View File
@@ -1,17 +1,15 @@
#!/usr/bin/env node
/**
* Integrità del pacchetto di rilascio (brief §11.7), da eseguire dopo scripts/package.mjs:
* Integrità del pacchetto di rilascio, da eseguire dopo scripts/package.mjs:
*
* - in release/ ci sono solo zip, tar.gz, SHA256SUMS.txt e BUILD-INFO.txt, con i nomi attesi;
* - le impronte di SHA256SUMS.txt sono corrette (anche con `sha256sum -c`, se disponibile);
* - zip e tar.gz, estratti in una cartella temporanea, contengono esattamente i file di dist/
* (stessi percorsi, dimensioni e contenuto), alla radice, con .htaccess e tutte le pagine;
* - lo zip non supera 5 MB; BUILD-INFO.txt riporta versione, commit e data.
* - in release/ c'è solo lo zip, con il nome atteso (nessun altro file);
* - lo zip, aperto con un lettore minimale (CRC e dimensioni compresi), contiene esattamente
* i file di dist/ (stessi percorsi, dimensioni e contenuto), alla radice, con .htaccess e
* tutte le pagine del sitemap;
* - lo zip non supera 5 MB.
*/
import { execFileSync, spawnSync } from 'node:child_process';
import { createHash } from 'node:crypto';
import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
import { join } from 'node:path';
import { crc32, inflateRawSync } from 'node:zlib';
import { readSitemapPaths } from './lib/pages.mjs';
@@ -63,32 +61,6 @@ function readZip(file) {
return entries;
}
/**
* Estrazione del tar.gz con `tar` di sistema in una cartella temporanea. L'archivio arriva da
* stdin: su Windows il GNU tar di Git Bash interpreta «C:\…» come host remoto.
*/
function readTarGz(file) {
const dir = mkdtempSync(join(tmpdir(), 'sito-studio-grasso-'));
try {
execFileSync('tar', ['-xzf', '-'], { cwd: dir, input: readFileSync(file) });
const entries = new Map();
for (const rel of listAll(dir)) entries.set(rel, readFileSync(join(dir, rel)));
return entries;
} finally {
rmSync(dir, { recursive: true, force: true });
}
}
function listAll(dir, base = '') {
const out = [];
for (const e of readdirSync(join(dir, base), { withFileTypes: true })) {
const rel = base ? `${base}/${e.name}` : e.name;
if (e.isDirectory()) out.push(...listAll(dir, rel));
else out.push(rel);
}
return out.sort();
}
function compareWithDist(label, entries, expected) {
const names = [...entries.keys()].sort();
const missing = expected.filter((f) => !entries.has(f));
@@ -130,80 +102,28 @@ try {
console.error(`✘ ${e.message}`);
process.exit(1);
}
const names = archiveNames(version);
const expectedRelease = [names.zip, names.tgz, 'SHA256SUMS.txt', 'BUILD-INFO.txt'].sort();
const { zip } = archiveNames(version);
if (!existsSync(releaseDir)) {
console.error('✘ release/ assente: eseguire `npm run package`.');
process.exit(1);
}
const present = readdirSync(releaseDir).sort();
for (const f of expectedRelease) if (!present.includes(f)) fail(`release/: manca ${f}`);
const present = readdirSync(releaseDir);
if (!present.includes(zip)) fail(`release/: manca ${zip}`);
for (const f of present)
if (!expectedRelease.includes(f))
fail(`release/: file inatteso ${f} (la cartella deve contenere solo il pacchetto)`);
if (f !== zip) fail(`release/: file inatteso ${f} (la cartella deve contenere solo lo zip)`);
// impronte
const sumsFile = join(releaseDir, 'SHA256SUMS.txt');
if (existsSync(sumsFile)) {
const lines = readFileSync(sumsFile, 'utf8').trim().split('\n');
const listed = new Set();
for (const line of lines) {
const m = line.match(/^([0-9a-f]{64}) {2}(.+)$/);
if (!m) {
fail(`SHA256SUMS.txt: riga non valida «${line}»`);
continue;
}
listed.add(m[2]);
const target = join(releaseDir, m[2]);
if (!existsSync(target)) fail(`SHA256SUMS.txt: il file ${m[2]} non esiste`);
else if (sha256(readFileSync(target)) !== m[1])
fail(`SHA256SUMS.txt: impronta errata per ${m[2]}`);
}
for (const f of [names.zip, names.tgz]) if (!listed.has(f)) fail(`SHA256SUMS.txt: manca ${f}`);
const tool = spawnSync('sha256sum', ['-c', 'SHA256SUMS.txt'], {
cwd: releaseDir,
encoding: 'utf8',
});
if (tool.error)
console.log(' (sha256sum non disponibile: impronte verificate solo con Node.js)');
else if (tool.status !== 0) fail(`sha256sum -c non superato:\n${tool.stdout}${tool.stderr}`);
else console.log(` sha256sum -c: ${tool.stdout.trim().split('\n').join(' · ')}`);
}
// contenuto degli archivi
const expected = listFiles(distDir);
const zipPath = join(releaseDir, names.zip);
const tgzPath = join(releaseDir, names.tgz);
const zipPath = join(releaseDir, zip);
if (existsSync(zipPath)) {
const size = statSync(zipPath).size;
if (size > MAX_ZIP)
fail(`${names.zip}: ${(size / 1048576).toFixed(2)} MB oltre il limite di 5 MB`);
if (size > MAX_ZIP) fail(`${zip}: ${(size / 1048576).toFixed(2)} MB oltre il limite di 5 MB`);
try {
compareWithDist(names.zip, readZip(zipPath), expected);
compareWithDist(zip, readZip(zipPath), expected);
} catch (e) {
fail(`${names.zip}: ${e.message}`);
fail(`${zip}: ${e.message}`);
}
}
if (existsSync(tgzPath)) {
try {
compareWithDist(names.tgz, readTarGz(tgzPath), expected);
} catch (e) {
fail(`${names.tgz}: ${e.message}`);
}
}
// BUILD-INFO
const infoFile = join(releaseDir, 'BUILD-INFO.txt');
if (existsSync(infoFile)) {
const info = readFileSync(infoFile, 'utf8');
if (!info.includes(`Versione: ${version}`)) fail('BUILD-INFO.txt: manca «Versione»');
if (!/^Commit: [0-9a-f]{7,40}$/m.test(info)) fail('BUILD-INFO.txt: manca l’hash del commit');
if (!/^Data: \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/m.test(info))
fail('BUILD-INFO.txt: manca la data ISO');
if (!/^Node\.js: v\d+/m.test(info) || !/^Astro: \d+/m.test(info))
fail('BUILD-INFO.txt: mancano le versioni di Node.js e Astro');
}
if (errors.length) {
console.error(`✘ Pacchetto v${version}: ${errors.length} errori`);
@@ -212,5 +132,5 @@ if (errors.length) {
}
const zipKb = (statSync(zipPath).size / 1024).toFixed(1);
console.log(
`✔ Pacchetto v${version} verificato: ${expected.length} file identici a dist/ in zip (${zipKb} KB) e tar.gz, impronte corrette.`,
`✔ Pacchetto v${version} verificato: ${expected.length} file identici a dist/ nello zip (${zipKb} KB), unico file di release/.`,
);
-1
View File
@@ -33,7 +33,6 @@ export function resolveVersion() {
export const archiveNames = (version) => ({
zip: `${ARCHIVE_PREFIX}-v${version}.zip`,
tgz: `${ARCHIVE_PREFIX}-v${version}.tar.gz`,
});
/** Elenco ordinato dei file di una cartella (percorsi relativi con «/»), esclusioni applicate. */
+26 -67
View File
@@ -1,24 +1,22 @@
#!/usr/bin/env node
/**
* Pacchetto di rilascio (brief §12.4). Da `dist/` crea in `release/`:
* Pacchetto di rilascio. Da `dist/` crea in `release/` un solo file:
*
* sito-studio-grasso-v<versione>.zip per i pannelli di hosting (cPanel, Plesk, …)
* sito-studio-grasso-v<versione>.tar.gz per server Linux/SSH, nginx, object storage
* SHA256SUMS.txt impronte SHA-256 (verificabili con `sha256sum -c`)
* BUILD-INFO.txt versione, commit, data, Node, Astro
* sito-studio-grasso-v<versione>.zip da estrarre nella cartella pubblica dell'hosting
*
* Il contenuto di dist/ è alla radice degli archivi (nessuna cartella di primo livello), con
* `.htaccess`. Voci ordinate e date fisse: a parità di dist/ gli archivi sono identici.
* Il contenuto di dist/ è alla radice dello zip (nessuna cartella di primo livello), con
* `.htaccess`. Voci ordinate e date fisse: a parità di dist/ lo zip è identico anche tra
* Windows, macOS e Linux.
* Versione: variabile RELEASE_VERSION (tag vX.Y.Z) oppure package.json.
*/
process.env.TZ = 'UTC';
import { createHash } from 'node:crypto';
import { createReadStream, createWriteStream, existsSync, readFileSync, statSync } from 'node:fs';
import { mkdir, rm, writeFile } from 'node:fs/promises';
import { join, resolve } from 'node:path';
import { createWriteStream, existsSync, readFileSync, statSync } from 'node:fs';
import { mkdir, rm } from 'node:fs/promises';
import { join } from 'node:path';
import { pipeline } from 'node:stream/promises';
import { TarArchive, ZipArchive } from 'archiver';
import { ZipArchive } from 'archiver';
import { siteUrl } from '../site.config.mjs';
import {
archiveEpoch,
archiveNames,
@@ -27,7 +25,6 @@ import {
listFiles,
releaseDir,
resolveVersion,
root,
} from './lib/release.mjs';
if (!existsSync(join(distDir, 'index.html'))) {
@@ -42,66 +39,28 @@ try {
console.error(`✘ ${e.message}`);
process.exit(1);
}
const names = archiveNames(version);
const { zip } = archiveNames(version);
const files = listFiles(distDir);
const date = new Date(archiveEpoch() * 1000);
await rm(releaseDir, { recursive: true, force: true });
await mkdir(releaseDir, { recursive: true });
async function build(archive, target) {
const output = createWriteStream(target);
const done = pipeline(archive, output);
archive.on('warning', (err) => {
throw err;
});
for (const rel of files) {
// contenuto letto in memoria: l'ordine delle voci resta quello dell'elenco ordinato
archive.append(readFileSync(join(distDir, rel)), { name: rel, date, mode: 0o644 });
}
await archive.finalize();
await done;
const target = join(releaseDir, zip);
const archive = new ZipArchive({ zlib: { level: 9 } });
const output = createWriteStream(target);
const done = pipeline(archive, output);
archive.on('warning', (err) => {
throw err;
});
for (const rel of files) {
// contenuto letto in memoria: l'ordine delle voci resta quello dell'elenco ordinato
archive.append(readFileSync(join(distDir, rel)), { name: rel, date, mode: 0o644 });
}
await archive.finalize();
await done;
await build(new ZipArchive({ zlib: { level: 9 } }), join(releaseDir, names.zip));
await build(new TarArchive({ gzip: true, gzipOptions: { level: 9 } }), join(releaseDir, names.tgz));
const sha256 = (file) =>
new Promise((ok, ko) => {
const hash = createHash('sha256');
createReadStream(file)
.on('data', (d) => hash.update(d))
.on('end', () => ok(hash.digest('hex')))
.on('error', ko);
});
const pkgLock = JSON.parse(readFileSync(resolve(root, 'package-lock.json'), 'utf8'));
const astroVersion = pkgLock.packages?.['node_modules/astro']?.version ?? 'sconosciuta';
const info = [
'Sito web dello Studio Grasso — Studio Tributario e Societario',
`Versione: ${version}`,
`Commit: ${gitCommit()}`,
`Data: ${new Date().toISOString()}`,
`Data dei file negli archivi: ${date.toISOString()}`,
`Node.js: ${process.version}`,
`Astro: ${astroVersion}`,
`SITE_URL: ${process.env.SITE_URL || 'https://www.grassoezio.it'}`,
`File: ${files.length}`,
'',
'Pubblicazione: estrarre il contenuto dell’archivio nella cartella pubblica del sito',
'(es. public_html o httpdocs), includendo il file nascosto .htaccess. Vedi docs/DEPLOY.md.',
'',
].join('\n');
await writeFile(join(releaseDir, 'BUILD-INFO.txt'), info);
const sums = [];
for (const name of [names.zip, names.tgz, 'BUILD-INFO.txt']) {
sums.push(`${await sha256(join(releaseDir, name))} ${name}`);
}
await writeFile(join(releaseDir, 'SHA256SUMS.txt'), sums.join('\n') + '\n');
const kb = (f) => `${(statSync(join(releaseDir, f)).size / 1024).toFixed(1)} KB`;
const kb = (statSync(target).size / 1024).toFixed(1);
console.log(`✔ Pacchetto v${version} creato in release/ (${files.length} file da dist/):`);
for (const f of [names.zip, names.tgz, 'SHA256SUMS.txt', 'BUILD-INFO.txt']) {
console.log(` ${f.padEnd(40)} ${kb(f)}`);
}
console.log(` ${zip} ${kb} KB`);
console.log(` commit ${gitCommit().slice(0, 12)} · dominio ${siteUrl()}`);
+91 -35
View File
@@ -1,17 +1,22 @@
#!/usr/bin/env bash
# =============================================================================
# Pubblica una release su Forgejo tramite API REST e carica i file di release/.
# Alternativa manuale (o step di riserva) all'action forgejo-release del workflow.
# Pubblica una release su Gitea tramite API REST e carica i file di release/ (lo zip del sito).
# Lo usa release.yml; si può eseguire anche a mano.
#
# Uso:
# FORGEJO_URL=https://forgejo.example.it \
# FORGEJO_REPO=proprietario/repository \
# FORGEJO_TOKEN=<token con permesso write:repository> \
# GITEA_URL=https://gitea.encke-hake.ts.net \
# GITEA_REPO=proprietario/repository \
# GITEA_TOKEN=<token con permesso write:repository> \
# scripts/release-upload.sh v1.0.0 [cartella] # cartella predefinita: release
#
# Prima eseguire `npm run package` con RELEASE_VERSION=v1.0.0. Il tag deve già esistere
# sul server (git push origin v1.0.0). Le note della release sono prese da CHANGELOG.md.
# Se la release esiste già, i file con lo stesso nome vengono sostituiti.
# Prima eseguire `npm run package` con RELEASE_VERSION=v1.0.0 e pubblicare il tag
# (git push origin v1.0.0): lo script si ferma se il tag non è sul server oppure se punta a
# un commit diverso dal tag locale. Le note della release sono prese da CHANGELOG.md.
#
# Una release nuova viene creata in bozza, riceve i file e solo alla fine viene pubblicata.
# Se la release esiste già (anche come bozza rimasta a metà), i file con lo stesso nome
# vengono sostituiti (prima si carica il nuovo, poi si cancella il vecchio) e la release viene
# pubblicata con titolo e note del CHANGELOG.
# =============================================================================
set -euo pipefail
@@ -21,43 +26,94 @@ DIR="${2:-release}"
die() { echo "✘ $*" >&2; exit 1; }
[ -n "$TAG" ] || die "indicare il tag, es.: scripts/release-upload.sh v1.0.0"
[ -n "${FORGEJO_URL:-}" ] || die "variabile FORGEJO_URL mancante (es. https://forgejo.example.it)"
[ -n "${FORGEJO_REPO:-}" ] || die "variabile FORGEJO_REPO mancante (es. proprietario/repository)"
[ -n "${FORGEJO_TOKEN:-}" ] || die "variabile FORGEJO_TOKEN mancante"
[ -n "${GITEA_URL:-}" ] || die "variabile GITEA_URL mancante (es. https://gitea.encke-hake.ts.net)"
[ -n "${GITEA_REPO:-}" ] || die "variabile GITEA_REPO mancante (es. proprietario/repository)"
[ -n "${GITEA_TOKEN:-}" ] || die "variabile GITEA_TOKEN mancante"
[ -d "$DIR" ] || die "cartella $DIR assente: eseguire prima npm run package"
command -v curl >/dev/null || die "curl non installato"
command -v node >/dev/null || die "node non installato"
API="${FORGEJO_URL%/}/api/v1/repos/${FORGEJO_REPO}"
AUTH="Authorization: token ${FORGEJO_TOKEN}"
# nessun file da caricare = pacchetto non creato: meglio fermarsi che pubblicare una release vuota
FILES=()
for FILE in "$DIR"/*; do
[ -f "$FILE" ] && FILES+=("$FILE")
done
[ "${#FILES[@]}" -gt 0 ] || die "nessun file in $DIR: eseguire prima npm run package"
json_field() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{const v=JSON.parse(s)[process.argv[1]];if(v===undefined)process.exit(1);console.log(typeof v==="object"?JSON.stringify(v):v)})' "$1"; }
API="${GITEA_URL%/}/api/v1/repos/${GITEA_REPO}"
AUTH="Authorization: token ${GITEA_TOKEN}"
NOTES="$(node scripts/changelog-notes.mjs "$TAG")"
PAYLOAD="$(node -e 'console.log(JSON.stringify({tag_name:process.argv[1],name:process.argv[1],body:process.argv[2],draft:false,prerelease:/-/.test(process.argv[1])}))' "$TAG" "$NOTES")"
# Valore di un campo (anche annidato: «commit.sha») di un oggetto JSON letto da stdin.
json_field() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{let v=JSON.parse(s);for(const k of process.argv[1].split("."))v=v==null?undefined:v[k];if(v===undefined)process.exit(1);console.log(typeof v==="object"?JSON.stringify(v):v)})' "$1"; }
# Id degli asset con un certo nome, da un elenco JSON letto da stdin.
asset_ids() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{console.log(JSON.parse(s).filter(a=>a.name===process.argv[1]).map(a=>a.id).join(" "))})' "$1"; }
urlencode() { node -e 'console.log(encodeURIComponent(process.argv[1]))' "$1"; }
echo "→ Release $TAG su $FORGEJO_REPO"
if EXISTING="$(curl -fsS -H "$AUTH" "$API/releases/tags/$TAG" 2>/dev/null)"; then
RELEASE_ID="$(printf '%s' "$EXISTING" | json_field id)"
echo " release già esistente (id $RELEASE_ID): aggiornamento dei file"
else
CREATED="$(curl -fsS -X POST -H "$AUTH" -H 'Content-Type: application/json' -d "$PAYLOAD" "$API/releases")" \
|| die "creazione della release non riuscita (permessi del token? il tag esiste sul server?)"
RELEASE_ID="$(printf '%s' "$CREATED" | json_field id)"
echo " release creata (id $RELEASE_ID)"
TAG_URL="$(urlencode "$TAG")"
NOTES="$(node "$(dirname "${BASH_SOURCE[0]}")/changelog-notes.mjs" "$TAG")" \
|| die "note della release non disponibili: manca la sezione di $TAG in CHANGELOG.md"
PRERELEASE=false
case "$TAG" in *-*) PRERELEASE=true ;; esac
# Dati della release; $1 = true per la bozza, false per pubblicarla.
payload() {
node -e 'console.log(JSON.stringify({tag_name:process.argv[1],name:process.argv[1],body:process.argv[2],draft:process.argv[3]==="true",prerelease:process.argv[4]==="true"}))' \
"$TAG" "$NOTES" "$1" "$PRERELEASE"
}
echo "→ Release $TAG su $GITEA_REPO"
# 1) il tag deve essere già sul server: senza, Gitea lo creerebbe sulla punta del branch
# predefinito (un altro commit)
TAG_JSON="$(curl -fsS -H "$AUTH" "$API/tags/$TAG_URL")" \
|| die "tag $TAG assente sul server (o token senza accesso al repository): eseguire prima git push origin $TAG"
SERVER_SHA="$(printf '%s' "$TAG_JSON" | json_field commit.sha)" || die "risposta inattesa per il tag $TAG"
if LOCAL_SHA="$(git rev-parse --verify --quiet "refs/tags/$TAG^{commit}" 2>/dev/null)"; then
[ "$LOCAL_SHA" = "$SERVER_SHA" ] \
|| die "il tag $TAG sul server punta a $SERVER_SHA, quello locale a $LOCAL_SHA: pacchetto e tag non coincidono"
fi
ASSETS="$(curl -fsS -H "$AUTH" "$API/releases/$RELEASE_ID/assets")"
for FILE in "$DIR"/*; do
[ -f "$FILE" ] || continue
NAME="$(basename "$FILE")"
OLD_ID="$(printf '%s' "$ASSETS" | node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{const a=JSON.parse(s).find(x=>x.name===process.argv[1]);if(a)console.log(a.id)})' "$NAME")"
if [ -n "$OLD_ID" ]; then
curl -fsS -X DELETE -H "$AUTH" "$API/releases/$RELEASE_ID/assets/$OLD_ID" >/dev/null
# 2) release esistente (pubblicata o bozza) oppure nuova bozza: solo un 404 vuol dire «non
# esiste ancora»; qualunque altro errore (rete, 401, 403, 5xx) ferma lo script
EXISTING_FILE="$(mktemp)"
trap 'rm -f "$EXISTING_FILE"' EXIT
EXISTING_CODE="$(curl -sS -o "$EXISTING_FILE" -w '%{http_code}' -H "$AUTH" "$API/releases/tags/$TAG_URL")" \
|| die "il server non risponde ($GITEA_URL)"
if [ "$EXISTING_CODE" = "200" ]; then
EXISTING="$(cat "$EXISTING_FILE")"
RELEASE_ID="$(printf '%s' "$EXISTING" | json_field id)"
if [ "$(printf '%s' "$EXISTING" | json_field draft)" = "true" ]; then
echo " bozza già esistente (id $RELEASE_ID): caricamento dei file e pubblicazione"
else
echo " release già pubblicata (id $RELEASE_ID): sostituzione dei file con lo stesso nome"
fi
elif [ "$EXISTING_CODE" = "404" ]; then
CREATED="$(curl -fsS -X POST -H "$AUTH" -H 'Content-Type: application/json' -d "$(payload true)" "$API/releases")" \
|| die "creazione della release non riuscita (il token ha il permesso write:repository?)"
RELEASE_ID="$(printf '%s' "$CREATED" | json_field id)"
echo " bozza creata (id $RELEASE_ID)"
else
die "lettura della release $TAG non riuscita (HTTP $EXISTING_CODE): controllare l'indirizzo, il token e riprovare"
fi
# 3) file: prima il nuovo, poi la cancellazione dell'eventuale versione precedente, così un
# errore a metà non lascia la release senza quel file
ASSETS="$(curl -fsS -H "$AUTH" "$API/releases/$RELEASE_ID/assets")" \
|| die "elenco dei file della release $RELEASE_ID non disponibile"
for FILE in "${FILES[@]}"; do
NAME="$(basename "$FILE")"
OLD_IDS="$(printf '%s' "$ASSETS" | asset_ids "$NAME")"
curl -fsS -X POST -H "$AUTH" -F "attachment=@${FILE}" \
"$API/releases/$RELEASE_ID/assets?name=$(node -e 'console.log(encodeURIComponent(process.argv[1]))' "$NAME")" >/dev/null \
"$API/releases/$RELEASE_ID/assets?name=$(urlencode "$NAME")" >/dev/null \
|| die "caricamento di $NAME non riuscito"
echo " ✔ $NAME"
for OLD_ID in $OLD_IDS; do
curl -fsS -X DELETE -H "$AUTH" "$API/releases/$RELEASE_ID/assets/$OLD_ID" >/dev/null \
|| die "cancellazione della versione precedente di $NAME (id $OLD_ID) non riuscita"
done
echo " ✔ $NAME${OLD_IDS:+ (sostituito)}"
done
echo "✔ Release $TAG pubblicata: ${FORGEJO_URL%/}/${FORGEJO_REPO}/releases/tag/$TAG"
# 4) pubblicazione (o aggiornamento di titolo e note) solo con tutti i file caricati
curl -fsS -X PATCH -H "$AUTH" -H 'Content-Type: application/json' -d "$(payload false)" \
"$API/releases/$RELEASE_ID" >/dev/null \
|| die "pubblicazione non riuscita: la release $RELEASE_ID potrebbe essere rimasta in bozza"
echo "✔ Release $TAG pubblicata: ${GITEA_URL%/}/${GITEA_REPO}/releases/tag/$TAG"
+5 -2
View File
@@ -33,8 +33,11 @@ const paths = [...readSitemapPaths(resolve(root, 'dist')), ...EXTRA_PAGES].filte
);
await mkdir(outDir, { recursive: true });
const server = await startPreview();
const browser = await chromium.launch();
// browser avviato dentro il try: se non parte (Chromium mancante) il server viene comunque
// fermato, invece di restare attivo in background su Linux e macOS
let browser;
try {
browser = await chromium.launch();
for (const vp of viewports) {
const context = await browser.newContext({
viewport: { width: vp.width, height: vp.height },
@@ -55,6 +58,6 @@ try {
await context.close();
}
} finally {
await browser.close();
await browser?.close().catch(() => {});
await server.stop();
}
+17
View File
@@ -0,0 +1,17 @@
/**
* Dominio pubblico del sito: UNICA FONTE per la build (astro.config.mjs), i controlli, i test e
* il pacchetto di rilascio (canonical, sitemap, robots.txt, dati strutturati).
*
* Per un dominio diverso: cambiare qui il valore predefinito, oppure impostare la variabile
* d'ambiente SITE_URL per tutti i comandi (build, verify, package); nei workflow di Gitea Actions
* la imposta la variabile del repository SITE_URL (Impostazioni → Actions → Variabili).
*/
export const SITE_URL_PREDEFINITO = 'https://www.grassoezio.it';
/**
* URL del sito senza barra finale: SITE_URL, se impostata, altrimenti il valore predefinito.
* @returns {string}
*/
export function siteUrl() {
return (process.env.SITE_URL || SITE_URL_PREDEFINITO).replace(/\/+$/, '');
}
+44 -11
View File
@@ -12,12 +12,14 @@ interface Props {
icona: string;
/** id del professionista, usato dai controlli automatici sui titoli. */
personaId?: string;
/** `dark` = su un palco navy (vetro smerigliato). */
tone?: 'light' | 'dark';
}
const { testo, professionista, icona, personaId } = Astro.props;
const { testo, professionista, icona, personaId, tone = 'light' } = Astro.props;
---
<li class="badge" data-person={personaId}>
<li class:list={['badge', `badge--${tone}`]} data-person={personaId}>
<span class="badge__icon">
<Icon name={icona} size={20} />
</span>
@@ -30,21 +32,29 @@ const { testo, professionista, icona, personaId } = Astro.props;
<style>
.badge {
display: grid;
grid-template-columns: 40px minmax(0, 1fr);
gap: var(--space-3);
grid-template-columns: 44px minmax(0, 1fr);
gap: var(--space-4);
align-items: start;
padding: var(--space-4) var(--space-5);
padding: var(--space-5);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
border-radius: var(--radius-lg);
transition:
border-color 260ms var(--ease-out),
background-color 260ms var(--ease-out),
transform 260ms var(--ease-out);
}
.badge:hover {
transform: translateY(-3px);
}
.badge__icon {
display: grid;
place-items: center;
width: 40px;
height: 40px;
border-radius: 10px;
width: 44px;
height: 44px;
border-radius: 14px;
background: var(--navy-800);
color: var(--gold-300);
}
@@ -56,10 +66,10 @@ const { testo, professionista, icona, personaId } = Astro.props;
.badge__text {
display: block;
margin: 0 0 0.4rem;
margin: 0 0 0.5rem;
font-size: var(--fs-sm);
color: var(--ink-700);
line-height: 1.45;
line-height: 1.5;
}
.badge__who {
@@ -70,4 +80,27 @@ const { testo, professionista, icona, personaId } = Astro.props;
text-transform: uppercase;
color: var(--navy-700);
}
.badge--dark {
background: rgba(255, 255, 255, 0.04);
border-color: rgba(255, 255, 255, 0.1);
}
.badge--dark:hover {
background: rgba(255, 255, 255, 0.07);
border-color: rgba(227, 200, 120, 0.45);
}
.badge--dark .badge__icon {
background: rgba(227, 200, 120, 0.12);
box-shadow: inset 0 0 0 1px rgba(227, 200, 120, 0.3);
}
.badge--dark .badge__text {
color: var(--on-dark);
}
.badge--dark .badge__who {
color: var(--gold-300);
}
</style>
+7 -6
View File
@@ -28,15 +28,16 @@ const all = [{ name: 'Home', href: '/' }, ...items];
</nav>
<style>
/* il percorso sta nella testata navy delle pagine interne (PageHead) */
.breadcrumb ol {
display: flex;
flex-wrap: wrap;
gap: 0.25rem 0.5rem;
margin: 0 0 var(--space-4);
margin: 0 0 var(--space-5);
padding: 0;
list-style: none;
font-size: var(--fs-xs);
color: var(--ink-600);
color: var(--on-dark-muted);
}
/* separatore in coda alla voce precedente: andando a capo resta sulla prima riga;
@@ -46,20 +47,20 @@ const all = [{ name: 'Home', href: '/' }, ...items];
content: '/' / '';
/* lo spazio del testo dopo il link (≈0,25em) + questo margine = gap dopo la barra */
margin-left: 0.25rem;
color: var(--ink-600);
color: var(--on-dark-muted);
}
.breadcrumb a {
color: var(--ink-600);
color: var(--on-dark-muted);
text-decoration: none;
}
.breadcrumb a:hover {
color: var(--navy-900);
color: var(--white);
text-decoration: underline;
}
.breadcrumb [aria-current='page'] {
color: var(--ink-700);
color: var(--gold-300);
}
</style>
+35 -14
View File
@@ -1,14 +1,16 @@
---
/**
* Modulo di contatto (brief §10.1). La modalità si imposta in src/data/studio.ts
* (`contactForm.mode`):
* Modulo di contatto (brief §10.1). La modalità si imposta con la costante
* `MODALITA_PREDEFINITA` in src/data/studio.ts (la variabile d'ambiente CONTACT_FORM_MODE, se
* impostata, ha la precedenza):
* - `off` (predefinita): nessun modulo, al suo posto la card «Scrivici una e-mail»;
* - `php`: invio a /contact.php (deploy/optional-php-form/contact.php);
* - `endpoint`: invio all'URL configurato.
*
* Anti-spam senza cookie né servizi terzi: campo trappola nascosto (honeypot) e tempo minimo
* di compilazione (`ts`). Validazione HTML5 nativa; con JavaScript i messaggi d'errore sono in
* italiano, accanto ai campi e annunciati dagli screen reader.
* di compilazione (`ts` all'apertura, `ts_invio` all'invio, entrambi dall'orologio del
* dispositivo). Validazione HTML5 nativa; con JavaScript i messaggi d'errore sono in italiano,
* accanto ai campi e annunciati dagli screen reader, con le stesse regole di contact.php.
*/
import { contactForm, denominazione, sedePrincipale, studio } from '../data/studio';
import { modulo, scriviEmail } from '../data/testi';
@@ -112,6 +114,7 @@ const c = modulo.campi;
inputmode="email"
required
maxlength="160"
pattern="(?=[^@]{1,64}@)[^@\s.]+(\.[^@\s.]+)*@([^@\s.]+\.)+[A-Za-z][^@\s.]*"
placeholder={c.email.placeholder}
aria-describedby="cf-email-err"
/>
@@ -178,6 +181,7 @@ const c = modulo.campi;
<input id="cf-sito" name="sito_web" type="text" tabindex="-1" autocomplete="off" />
</div>
<input type="hidden" name="ts" value="" data-form-ts />
<input type="hidden" name="ts_invio" value="" data-form-ts-invio />
<div class="consent">
<input
@@ -210,16 +214,28 @@ const c = modulo.campi;
<style>
.mail-card,
.contact-form {
padding: var(--space-6);
position: relative;
overflow: hidden;
padding: clamp(1.5rem, 3vw, 2.5rem);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-md);
border-radius: var(--radius-xl);
box-shadow: var(--shadow-lg);
}
/* filo oro in alto */
.mail-card::before,
.contact-form::before {
content: '';
position: absolute;
inset: 0 0 auto;
height: 4px;
background: var(--gold-gradient);
}
.mail-card h2,
.contact-form h2 {
font-size: 1.5rem;
font-size: clamp(1.6rem, 1.3rem + 1vw, 2rem);
margin-bottom: 0.4rem;
}
@@ -274,7 +290,8 @@ const c = modulo.campi;
padding-left: 1.2rem;
}
.contact-form__summary a {
/* link creati da src/scripts/form.ts: senza :global() lo stile con scope non li raggiunge */
.contact-form__summary :global(a) {
color: var(--error);
}
@@ -290,17 +307,21 @@ const c = modulo.campi;
color: var(--ink-700);
}
.field label span,
.consent label span {
.field label span {
color: var(--error);
}
/* asterisco inserito con set:html: serve :global() per raggiungerlo */
.consent label :global(span) {
color: var(--error);
}
.field input,
.field textarea {
width: 100%;
min-height: var(--tap);
padding: 0.75rem 0.95rem;
border-radius: var(--radius-sm);
min-height: 3rem;
padding: 0.8rem 1rem;
border-radius: var(--radius-md);
border: 1px solid #b9c3cf;
background: var(--white);
color: var(--ink-900);
+8 -8
View File
@@ -16,7 +16,7 @@ const Heading = headingLevel === 2 ? 'h2' : 'h3';
const elencoSedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipale.id)];
---
<div class="info-stack">
<div class="info-stack reveal-group">
{sedi && (
<section class="info" aria-labelledby="info-sedi">
<Heading id="info-sedi">
@@ -99,7 +99,7 @@ const elencoSedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePr
padding: var(--space-5);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-sm);
}
@@ -123,6 +123,8 @@ const elencoSedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePr
.info dl {
display: grid;
grid-template-columns: auto minmax(0, 1fr);
/* l'etichetta resta allineata al testo dei link, alti 44 px */
align-items: baseline;
gap: 0.5rem var(--space-4);
margin: 0;
font-size: var(--fs-sm);
@@ -143,19 +145,17 @@ const elencoSedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePr
display: block;
}
.info__line + .info__line {
margin-top: 0.35rem;
}
.info__note {
display: block;
font-size: var(--fs-xs);
color: var(--ink-600);
}
/* telefono, e-mail e PEC: bersagli touch di almeno 44 px (brief §9.5) */
.info a {
display: inline-block;
padding-block: 0.15rem;
display: inline-flex;
align-items: center;
min-height: var(--tap);
}
@media (max-width: 26.25em) {
+67 -49
View File
@@ -1,5 +1,8 @@
---
/** Banda navy di invito all'azione (brief §6.3): titolo, testo, preventivo e telefono. */
/**
* Banda di invito all'azione (brief §6.3) come «palco» navy arrotondato: titolo, testo,
* preventivo e telefono. Anelli oro decorativi che ruotano piano durante lo scorrimento.
*/
import { studio } from '../data/studio';
import { ctaBand } from '../data/testi';
import { telHref, telText } from '../lib/format';
@@ -8,18 +11,23 @@ import Icon from './Icon.astro';
const telefono = studio.telefoni[0];
---
<section class="cta-band" aria-labelledby="cta-band-titolo">
<div class="container cta-band__inner">
<div>
<section class="cta-band stage" aria-labelledby="cta-band-titolo">
<div class="stage__decor" aria-hidden="true">
<span class="cta-band__ring cta-band__ring--1"></span>
<span class="cta-band__ring cta-band__ring--2"></span>
</div>
<div class="container cta-band__inner reveal">
<div class="cta-band__text">
<p class="eyebrow">{ctaBand.eyebrow}</p>
<h2 id="cta-band-titolo">{ctaBand.titolo}</h2>
<p>{ctaBand.testo}</p>
</div>
<div class="cta-band__actions">
<a class="btn btn--gold" href={ctaBand.pulsante.href}>
<a class="btn btn--gold btn--lg" href={ctaBand.pulsante.href}>
{ctaBand.pulsante.label}
<Icon name="arrow-right" size={18} />
</a>
<a class="btn btn--ghost-light" href={telHref(telefono)}>
<a class="btn btn--ghost-light btn--lg" href={telHref(telefono)}>
<Icon name="phone" size={18} />
<span class="visually-hidden">Telefono</span>
{telText(telefono)}
@@ -29,71 +37,81 @@ const telefono = studio.telefoni[0];
</section>
<style>
.cta-band {
position: relative;
overflow: hidden;
background: var(--navy-800);
color: var(--white);
}
.cta-band::before {
content: '';
position: absolute;
width: 420px;
height: 420px;
border-radius: 50%;
border: 60px solid rgba(184, 144, 46, 0.18);
right: -140px;
top: -180px;
pointer-events: none;
}
.cta-band__inner {
position: relative;
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--space-6);
padding-block: var(--space-8);
}
.cta-band__inner > :first-child {
flex: 1 1 auto;
min-width: 0;
display: grid;
grid-template-columns: minmax(0, 1fr) auto;
align-items: end;
gap: var(--space-6) var(--space-8);
padding-block: clamp(3.5rem, 7vw, 6rem);
}
.cta-band h2 {
color: var(--white);
margin-bottom: 0.4rem;
font-size: clamp(1.75rem, 1.3rem + 1.4vw, 2.3rem);
margin-bottom: var(--space-3);
font-size: clamp(2rem, 1.3rem + 2.4vw, 3.25rem);
max-width: 18ch;
}
.cta-band p {
.cta-band__text > p:last-child {
margin: 0;
max-width: 40rem;
color: var(--on-dark);
font-size: var(--fs-lg);
}
.cta-band__actions {
display: flex;
flex-wrap: wrap;
gap: var(--space-3);
flex: none;
}
/* su desktop l'anello è ancorato al bordo del contenuto (non della finestra), sopra e a
destra dei pulsanti, a qualsiasi larghezza (mockup 01) */
@media (min-width: 60.001em) {
.cta-band::before {
right: calc((100% - min(100% - 2 * var(--gutter), var(--container))) / 2 - 330px);
top: -300px;
.cta-band__ring {
position: absolute;
border-radius: 50%;
border: 1px solid rgba(227, 200, 120, 0.35);
}
.cta-band__ring--1 {
width: 34rem;
height: 34rem;
right: -10rem;
top: -16rem;
border-width: 48px;
border-color: rgba(184, 144, 46, 0.12);
}
.cta-band__ring--2 {
width: 22rem;
height: 22rem;
right: 2rem;
top: -9rem;
border-style: dashed;
}
@keyframes cta-spin {
to {
rotate: 40deg;
}
}
@media (prefers-reduced-motion: no-preference) {
@supports (animation-timeline: view()) {
.cta-band__ring {
animation: cta-spin linear both;
animation-timeline: view();
}
}
}
@media (max-width: 60em) {
.cta-band__inner {
flex-direction: column;
align-items: flex-start;
grid-template-columns: minmax(0, 1fr);
align-items: start;
}
}
@media (max-width: 40em) {
.cta-band__actions .btn {
width: 100%;
}
}
</style>
+62 -6
View File
@@ -8,6 +8,7 @@ import { denominazione, sedePrincipale, studio } from '../data/studio';
import { buildYear } from '../lib/build';
import { addressLine, hoursLine, mailtoHref, telHref, telText } from '../lib/format';
import { servizioHref, type Servizio } from '../lib/servizi';
import Icon from './Icon.astro';
import Logo from './Logo.astro';
interface Props {
@@ -83,6 +84,10 @@ const datiSocietari = [
</div>
</div>
<div class="footer__wordmark" aria-hidden="true">
{studio.nome}
</div>
<div class="footer__legal">
<div class="footer__legal-text">
<p>{`© ${buildYear} ${denominazione} — P.IVA ${studio.partitaIva} — Tutti i diritti riservati`}</p>
@@ -102,15 +107,24 @@ const datiSocietari = [
))}
</ul>
</nav>
<a class="footer__top" href="#inizio">
Torna su
<Icon name="arrow-up" size={16} />
</a>
</div>
</div>
</footer>
<style>
.site-footer {
background: var(--navy-900);
--focus-ring: var(--gold-300);
position: relative;
overflow: hidden;
margin: 0 var(--stage-inset) var(--stage-inset);
border-radius: var(--radius-xl);
background: var(--navy-950);
color: var(--on-dark);
padding-block: var(--space-8) var(--space-5);
padding-block: var(--space-8) var(--space-4);
font-size: var(--fs-sm);
}
@@ -146,11 +160,10 @@ const datiSocietari = [
grid-template-columns: 1.4fr 1fr 1fr 1fr;
gap: var(--space-6);
padding-bottom: var(--space-6);
border-bottom: 1px solid rgba(255, 255, 255, 0.14);
}
.footer__title {
color: var(--white);
color: var(--gold-300);
font-family: var(--font-body);
font-size: var(--fs-xs);
font-weight: 600;
@@ -165,6 +178,22 @@ const datiSocietari = [
font-size: var(--fs-xs);
}
/* marchio tipografico gigante, solo decorativo (testo pieno di un gradiente) */
.footer__wordmark {
margin: 0 0 calc(-0.18em) -0.04em;
font-family: var(--font-display);
font-size: clamp(2.4rem, 13.4vw, 12.5rem);
font-weight: 500;
line-height: 1;
letter-spacing: -0.045em;
white-space: nowrap;
background: linear-gradient(180deg, rgba(255, 255, 255, 0.16), rgba(255, 255, 255, 0.02) 85%);
-webkit-background-clip: text;
background-clip: text;
color: transparent;
user-select: none;
}
.footer__legal {
display: flex;
flex-wrap: wrap;
@@ -172,6 +201,7 @@ const datiSocietari = [
align-items: center;
gap: var(--space-3) var(--space-5);
padding-top: var(--space-4);
border-top: 1px solid var(--line-dark);
font-size: var(--fs-xs);
}
@@ -201,6 +231,30 @@ const datiSocietari = [
min-height: var(--tap);
}
.site-footer .footer__top {
gap: 0.4rem;
padding-inline: 1rem;
border: 1px solid rgba(255, 255, 255, 0.24);
border-radius: var(--radius-pill);
font-weight: 600;
}
.footer__top :global(svg) {
width: 16px;
height: 16px;
color: var(--gold-300);
transition: transform var(--dur) var(--ease);
}
.site-footer .footer__top:hover {
text-decoration: none;
border-color: var(--white);
}
.footer__top:hover :global(svg) {
transform: translateY(-2px);
}
@media (max-width: 60em) {
.footer__grid {
grid-template-columns: 1fr 1fr;
@@ -212,9 +266,11 @@ const datiSocietari = [
grid-template-columns: 1fr;
}
/* bersagli touch di almeno 44 px (brief §9.5) */
.site-footer li a {
display: inline-block;
padding-block: 0.3rem;
display: inline-flex;
align-items: center;
min-height: var(--tap);
}
}
</style>
+41 -6
View File
@@ -2,7 +2,9 @@
/**
* Intestazione: barra superiore con sedi e recapiti (solo ≥ 960 px), logo, navigazione
* principale con sottomenu dei servizi e menu mobile. L'intestazione resta fissa in alto
* durante lo scorrimento; la barra superiore scorre via.
* durante lo scorrimento (la barra superiore scorre via) e, dove il browser lo supporta,
* diventa più opaca e prende un'ombra man mano che la pagina scorre (solo CSS, senza cambi
* di altezza).
*/
import { sedePrincipale, studio } from '../data/studio';
import { mailtoHref, telHref, telText } from '../lib/format';
@@ -65,7 +67,8 @@ const short = (s: (typeof sedi)[number]) =>
}
.topbar {
background: var(--navy-900);
--focus-ring: var(--gold-300);
background: var(--navy-950);
color: var(--on-dark);
font-size: var(--fs-xs);
}
@@ -106,11 +109,16 @@ const short = (s: (typeof sedi)[number]) =>
text-decoration: underline;
}
/* la barra non partecipa alla dissolvenza della pagina nelle transizioni (il nome va sulla
barra e non su
.site-header: un antenato con view-transition-name isolerebbe il backdrop-filter) */
.site-header__bar {
background: rgba(255, 255, 255, 0.94);
backdrop-filter: saturate(1.4) blur(10px);
-webkit-backdrop-filter: saturate(1.4) blur(10px);
border-bottom: 1px solid var(--line);
view-transition-name: site-header;
background: rgba(255, 255, 255, 0.88);
/* solo la forma standard: il prefisso -webkit- per Safari lo aggiunge il minificatore
(vite.build.cssTarget); scritto a mano dopo la standard, la faceva scartare */
backdrop-filter: saturate(1.6) blur(14px);
border-bottom: 1px solid rgba(221, 227, 234, 0.8);
}
.site-header__inner {
@@ -120,6 +128,33 @@ const short = (s: (typeof sedi)[number]) =>
min-height: var(--header-h);
}
/* più opaca e con un'ombra quando la pagina scorre (nessun cambio di altezza: niente
spostamenti del contenuto) */
@keyframes header-solid {
to {
background-color: rgba(255, 255, 255, 0.96);
border-bottom-color: transparent;
box-shadow: 0 14px 34px -22px rgba(7, 20, 35, 0.45);
}
}
@media (prefers-reduced-motion: no-preference) {
@supports (animation-timeline: scroll()) {
.site-header__bar {
animation: header-solid linear both;
animation-timeline: scroll(root block);
animation-range: 0 10rem;
}
}
}
/* fascia stretta del desktop (960–1020 px): meno spazio tra logo e menu (vedi Nav.astro) */
@media (max-width: 63.75em) {
.site-header__inner {
gap: var(--space-4);
}
}
@media (max-width: 60em) {
.site-header {
top: 0;
+254 -54
View File
@@ -1,8 +1,11 @@
---
/**
* Hero della home: occhiello, titolo con seconda parte in corsivo, testo introduttivo, due
* inviti all'azione, riga di fiducia e, a destra, illustrazione in CSS (forma navy e anello
* oro, decorativi) con tre «fact card». Su mobile le card si impilano e l'illustrazione sparisce.
* Hero della home come «palco» navy: occhiello, titolo con seconda parte in corsivo oro, testo
* introduttivo, due inviti all'azione, riga di fiducia e, a destra, composizione decorativa
* (sfera navy e anelli oro) con tre «fact card» in vetro smerigliato. In fondo una fascia di
* numeri ricavati dai dati del sito. Movimento solo CSS: le card entrano una dopo l'altra al
* caricamento e, scorrendo, anelli e card si spostano a velocità diverse (parallasse).
* Su mobile le card si impilano e la composizione sparisce.
*/
import Icon from './Icon.astro';
@@ -15,26 +18,37 @@ interface Props {
ctaSecondaria: { label: string; href: string };
fiducia: string[];
fatti: { titolo: string; testo: string; icona: string }[];
numeri: { valore: number; etichetta: string }[];
}
const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiducia, fatti } =
Astro.props;
const {
eyebrow,
titolo,
titoloCorsivo,
testo,
ctaPrimaria,
ctaSecondaria,
fiducia,
fatti,
numeri,
} = Astro.props;
---
<section class="hero" aria-labelledby="hero-titolo">
<section class="hero stage" aria-labelledby="hero-titolo">
<div class="stage__decor" aria-hidden="true"></div>
<div class="container hero__inner">
<div class="hero__text">
<p class="eyebrow">{eyebrow}</p>
<p class="hero__eyebrow">{eyebrow}</p>
<h1 id="hero-titolo">
{titolo} <em>{titoloCorsivo}</em>
</h1>
<p class="hero__lead">{testo}</p>
<div class="hero__actions">
<a class="btn btn--primary" href={ctaPrimaria.href}>
<a class="btn btn--gold btn--lg" href={ctaPrimaria.href}>
{ctaPrimaria.label}
<Icon name="arrow-right" size={18} />
</a>
<a class="btn btn--outline" href={ctaSecondaria.href}>
<a class="btn btn--ghost-light btn--lg" href={ctaSecondaria.href}>
{ctaSecondaria.label}
</a>
</div>
@@ -48,8 +62,11 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
</ul>
</div>
<div class="hero__visual">
<div class="hero__blob" aria-hidden="true"></div>
<div class="hero__ring" aria-hidden="true"></div>
<div class="hero__orb" aria-hidden="true">
<span class="hero__ring hero__ring--1"></span>
<span class="hero__ring hero__ring--2"></span>
<span class="hero__ring hero__ring--3"></span>
</div>
<ul class="hero__facts">
{fatti.map((f, i) => (
<li class:list={['fact', `fact--${i + 1}`]}>
@@ -65,36 +82,73 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
</ul>
</div>
</div>
<div class="container">
<dl class="hero__stats">
{numeri.map((n) => (
<div class="stat">
<dt>{n.etichetta}</dt>
<dd>{n.valore}</dd>
</div>
))}
</dl>
</div>
</section>
<style>
.hero {
position: relative;
overflow: hidden;
background: linear-gradient(180deg, var(--navy-050) 0%, var(--white) 100%);
margin-top: var(--stage-inset);
}
.hero__inner {
display: grid;
grid-template-columns: 1.15fr 0.85fr;
grid-template-columns: minmax(0, 1.2fr) minmax(0, 0.8fr);
gap: var(--space-8);
align-items: center;
padding-block: clamp(3rem, 8vw, 6.5rem);
padding-block: clamp(3.5rem, 8vw, 7rem) clamp(2.5rem, 5vw, 4rem);
}
.hero__eyebrow {
display: inline-flex;
align-items: center;
gap: 0.6rem;
margin: 0 0 var(--space-5);
padding: 0.4rem 0.9rem 0.4rem 0.7rem;
border: 1px solid rgba(227, 200, 120, 0.35);
border-radius: var(--radius-pill);
background: rgba(227, 200, 120, 0.08);
color: var(--gold-300);
font-size: var(--fs-xs);
font-weight: 600;
letter-spacing: 0.08em;
text-transform: uppercase;
}
/* pallino «attivo» davanti all'occhiello */
.hero__eyebrow::before {
content: '';
flex: none;
width: 8px;
height: 8px;
border-radius: 50%;
background: var(--gold-300);
box-shadow: 0 0 0 4px rgba(227, 200, 120, 0.2);
}
.hero h1 {
margin-bottom: var(--space-5);
max-width: 16ch;
max-width: 17ch;
font-size: clamp(2.25rem, 1.15rem + 3.5vw, 4rem);
}
.hero h1 em {
font-style: italic;
color: var(--navy-700);
font-weight: 400;
color: var(--gold-300);
}
.hero__lead {
font-size: var(--fs-lg);
color: var(--ink-600);
color: var(--on-dark);
max-width: 36rem;
margin-bottom: var(--space-6);
}
@@ -112,7 +166,7 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
gap: var(--space-3) var(--space-5);
list-style: none;
font-size: var(--fs-sm);
color: var(--ink-700);
color: var(--on-dark);
font-weight: 500;
}
@@ -126,33 +180,63 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
flex: none;
width: 18px;
height: 18px;
color: var(--gold-700);
color: var(--gold-300);
}
/* --- composizione decorativa --- */
.hero__visual {
position: relative;
min-height: 26.25rem;
min-height: 30rem;
}
.hero__blob {
.hero__orb {
position: absolute;
inset: 8% -6% 4% 6%;
background: radial-gradient(120% 110% at 80% 10%, var(--navy-700) 0%, var(--navy-900) 70%);
border-radius: 48% 52% 44% 56% / 52% 40% 60% 48%;
inset: 50% auto auto 50%;
width: min(30rem, 100%);
aspect-ratio: 1;
translate: -50% -50%;
border-radius: 50%;
background:
radial-gradient(circle at 30% 25%, rgba(255, 255, 255, 0.16), transparent 40%),
radial-gradient(
circle at 50% 50%,
var(--navy-700) 0%,
var(--navy-900) 62%,
var(--navy-950) 100%
);
box-shadow:
inset 0 0 0 1px rgba(255, 255, 255, 0.08),
0 40px 120px -40px rgba(31, 75, 116, 0.9);
}
.hero__ring {
position: absolute;
width: 160px;
height: 160px;
border-radius: 50%;
border: 10px solid var(--gold-500);
right: 4%;
top: 2%;
opacity: 0.9;
border: 1px solid rgba(227, 200, 120, 0.4);
}
.hero__ring--1 {
inset: -9%;
border-style: dashed;
border-color: rgba(227, 200, 120, 0.3);
}
.hero__ring--2 {
inset: -22%;
border-color: rgba(255, 255, 255, 0.08);
}
/* arco oro spesso, in alto a destra */
.hero__ring--3 {
inset: 4%;
border: 6px solid transparent;
border-top-color: var(--gold-500);
border-right-color: var(--gold-500);
}
.hero__facts {
position: absolute;
inset: 0;
list-style: none;
}
@@ -161,12 +245,13 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
display: flex;
gap: var(--space-3);
align-items: flex-start;
width: 18.75rem;
width: 18.5rem;
padding: var(--space-4) var(--space-5);
background: var(--white);
border: 1px solid var(--line);
border: 1px solid rgba(255, 255, 255, 0.16);
border-radius: var(--radius-md);
box-shadow: var(--shadow-md);
background: rgba(11, 31, 51, 0.62);
backdrop-filter: blur(14px) saturate(1.3);
box-shadow: 0 24px 50px -24px rgba(0, 0, 0, 0.6);
}
.fact__icon {
@@ -175,9 +260,9 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
flex: none;
width: 40px;
height: 40px;
border-radius: 10px;
background: var(--gold-100);
color: var(--gold-700);
border-radius: 12px;
background: rgba(227, 200, 120, 0.14);
color: var(--gold-300);
}
.fact__icon :global(svg) {
@@ -188,7 +273,7 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
.fact strong {
display: block;
font-size: var(--fs-sm);
color: var(--navy-900);
color: var(--white);
line-height: 1.35;
}
@@ -196,23 +281,115 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
display: block;
margin-top: 0.15rem;
font-size: var(--fs-xs);
color: var(--ink-600);
color: var(--on-dark);
line-height: 1.45;
}
.fact--1 {
left: 0;
top: 14%;
left: -4%;
top: 6%;
}
.fact--2 {
right: 2%;
top: 42%;
right: -6%;
top: 40%;
}
.fact--3 {
left: 10%;
bottom: 6%;
left: 4%;
bottom: 4%;
}
/* --- numeri --- */
.hero__stats {
display: grid;
grid-template-columns: repeat(4, minmax(0, 1fr));
margin: 0 0 clamp(2rem, 4vw, 3rem);
border-top: 1px solid var(--line-dark);
}
.stat {
display: flex;
flex-direction: column-reverse;
justify-content: flex-end;
gap: 0.35rem;
padding: var(--space-5) var(--space-5) 0 0;
}
.stat + .stat {
padding-left: var(--space-5);
border-left: 1px solid var(--line-dark);
}
.stat dd {
margin: 0;
font-family: var(--font-display);
font-size: clamp(2.25rem, 1.6rem + 2vw, 3.25rem);
font-weight: 400;
line-height: 1;
letter-spacing: -0.03em;
color: var(--white);
}
.stat dt {
font-size: var(--fs-sm);
color: var(--on-dark);
}
/* --- movimento --- */
@keyframes hero-ring-turn {
to {
rotate: 75deg;
}
}
@keyframes hero-float {
to {
translate: 0 -5rem;
}
}
@keyframes hero-orb-in {
from {
opacity: 0;
scale: 0.86;
}
}
@media (prefers-reduced-motion: no-preference) {
.fact {
animation: rise 900ms var(--ease-out) both;
}
.fact--2 {
animation-delay: 140ms;
}
.fact--3 {
animation-delay: 280ms;
}
.hero__orb {
animation: hero-orb-in 1200ms var(--ease-out) both;
}
@supports (animation-timeline: scroll()) {
.hero__ring {
animation: hero-ring-turn linear both;
animation-timeline: scroll(root block);
animation-range: 0 100vh;
}
.hero__ring--2 {
animation-direction: reverse;
}
.hero__facts {
animation: hero-float linear both;
animation-timeline: scroll(root block);
animation-range: 0 100vh;
}
}
}
@media (max-width: 60em) {
@@ -225,20 +402,43 @@ const { eyebrow, titolo, titoloCorsivo, testo, ctaPrimaria, ctaSecondaria, fiduc
min-height: 0;
}
.hero__facts {
display: grid;
gap: var(--space-3);
.hero__orb {
display: none;
}
.hero__blob,
.hero__ring {
display: none;
.hero__facts {
position: static;
display: grid;
gap: var(--space-3);
animation: none;
}
.fact {
position: static;
width: 100%;
box-shadow: var(--shadow-sm);
}
.hero__stats {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
.stat + .stat:nth-child(3) {
padding-left: 0;
border-left: 0;
}
}
@media (max-width: 26.25em) {
.stat {
padding-right: var(--space-3);
}
.stat + .stat {
padding-left: var(--space-3);
}
.stat + .stat:nth-child(3) {
padding-left: 0;
}
}
</style>
+48 -13
View File
@@ -1,14 +1,18 @@
---
/**
* Pagina «documento» (privacy, cookie, note legali, accessibilità): colonna singola leggibile
* (max 68 caratteri), indice interno e data dell'ultimo aggiornamento (dal frontmatter).
* Pagina «documento» (privacy, cookie, note legali, accessibilità): colonna leggibile (max 68
* caratteri), indice interno e data dell'ultimo aggiornamento (dal frontmatter). Da 1024 px
* l'indice sta in una colonna a sinistra, fermo durante lo scorrimento, e segnala la sezione
* in lettura (src/scripts/toc.ts); più stretto resta in testa al documento.
*/
import type { MarkdownHeading } from 'astro';
import { getEntry } from 'astro:content';
import { siteUrl } from '../../site.config.mjs';
import BaseLayout from '../layouts/BaseLayout.astro';
import { formatDateIt, nbspAbbreviations } from '../lib/format';
import { externalLinksNoopener, mapHtmlText } from '../lib/html';
import { renderLegal } from '../lib/legal';
import '../styles/documento.css';
import PageHead from './PageHead.astro';
interface Props {
@@ -21,7 +25,7 @@ interface Props {
const { id, dataLabel = 'Ultimo aggiornamento' } = Astro.props;
const entry = await getEntry('legali', id);
if (!entry) throw new Error(`Testo legale mancante: src/content/legali/${id}.md`);
const siteHost = (Astro.site ?? new URL('https://www.grassoezio.it')).host;
const siteHost = (Astro.site ?? new URL(siteUrl())).host;
// spazi non separabili dopo «n.», «art.», «D.Lgs.»… solo nel testo (non negli URL)
const html = mapHtmlText(
externalLinksNoopener(
@@ -50,9 +54,9 @@ const updated = entry.data.aggiornato;
</PageHead>
<section class="section">
<div class="container doc-layout">
<div class:list={['container doc-layout', { 'doc-layout--toc': headings.length > 1 }]}>
{headings.length > 1 && (
<nav class="doc-toc" aria-labelledby="indice-titolo">
<nav class="doc-toc" aria-labelledby="indice-titolo" data-toc>
<p class="doc-toc__title" id="indice-titolo">
Indice
</p>
@@ -68,16 +72,19 @@ const updated = entry.data.aggiornato;
<article class="doc" set:html={html} />
</div>
</section>
{headings.length > 1 && <script>
import '../scripts/toc';
</script>}
</BaseLayout>
<style>
.doc-updated {
margin: var(--space-4) 0 0;
margin: var(--space-5) 0 0;
font-size: var(--fs-sm);
color: var(--ink-600);
color: var(--on-dark-muted);
}
/* layout «documento» a colonna singola con l'indice in testa (brief §7.8) */
.doc-layout {
display: grid;
grid-template-columns: minmax(0, 1fr);
@@ -92,12 +99,13 @@ const updated = entry.data.aggiornato;
.doc-toc {
padding: var(--space-4);
border: 1px solid var(--line);
border-radius: var(--radius-md);
border-radius: var(--radius-lg);
background: var(--white);
}
.doc-toc__title {
margin: 0 0 var(--space-2);
padding-inline: 0.5rem;
font-size: var(--fs-xs);
font-weight: 600;
letter-spacing: 0.12em;
@@ -111,8 +119,8 @@ const updated = entry.data.aggiornato;
padding: 0;
}
/* indice su due colonne quando c'è spazio, per non allungare la testa del documento */
@media (min-width: 40.001em) {
/* indice su due colonne quando sta in testa e c'è spazio */
@media (min-width: 40.001em) and (max-width: 64em) {
.doc-toc ol {
columns: 2;
column-gap: var(--space-4);
@@ -127,12 +135,17 @@ const updated = entry.data.aggiornato;
display: flex;
align-items: center;
min-height: var(--tap);
padding: 0.35rem 0.5rem;
border-radius: var(--radius-sm);
padding: 0.35rem 0.5rem 0.35rem 0.75rem;
border-left: 2px solid transparent;
border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
color: var(--ink-700);
font-size: var(--fs-sm);
line-height: 1.35;
text-decoration: none;
transition:
background-color var(--dur) var(--ease),
border-color var(--dur) var(--ease),
color var(--dur) var(--ease);
}
.doc-toc a:hover {
@@ -140,6 +153,28 @@ const updated = entry.data.aggiornato;
color: var(--navy-900);
}
.doc-toc a[aria-current] {
border-left-color: var(--gold-500);
background: var(--navy-050);
color: var(--navy-900);
font-weight: 600;
}
@media (min-width: 64.001em) {
.doc-layout--toc {
grid-template-columns: 17rem minmax(0, var(--measure));
gap: var(--space-8);
align-items: start;
}
.doc-toc {
position: sticky;
top: calc(var(--header-h) + 1.5rem);
max-height: calc(100vh - var(--header-h) - 3rem);
overflow-y: auto;
}
}
.doc :global(.doc-card) {
margin: var(--space-4) 0 var(--space-5);
padding: var(--space-4) var(--space-5);
+16 -7
View File
@@ -1,11 +1,12 @@
---
/**
* Marchio + logotipo dello Studio. Variante `dark` per i fondi navy (footer, menu mobile no).
* Il marchio è un SVG con la «G» già convertita in tracciato (vedi scripts/generate-icons.mjs).
* Marchio + logotipo dello Studio. Variante `dark` per i fondi navy (footer, menu mobile).
* Il marchio riproduce src/assets/logo-mark.svg e logo-mark-dark.svg (scripts/generate-icons.mjs):
* quadrato arrotondato, «G» in tracciato richiamata con <use> (definita una volta per pagina da
* LogoDefs) e, sulla versione chiara, il quadratino oro.
*/
import MarkDark from '../assets/logo-mark-dark.svg';
import Mark from '../assets/logo-mark.svg';
import { studio } from '../data/studio';
import { LOGO_GLYPH_ID } from '../lib/logo';
interface Props {
variant?: 'light' | 'dark';
@@ -17,7 +18,7 @@ interface Props {
const { variant = 'light', href = '/', class: className } = Astro.props;
const tag = studio.sottotitolo.replace(/^Studio\s+/i, '');
const isHome = Astro.url.pathname === '/';
const MarkSvg = variant === 'dark' ? MarkDark : Mark;
const dark = variant === 'dark';
---
{href ? (
@@ -26,7 +27,11 @@ const MarkSvg = variant === 'dark' ? MarkDark : Mark;
href={href}
aria-current={isHome && href === '/' ? 'page' : undefined}
>
<MarkSvg class="brand__mark" width={44} height={44} aria-hidden="true" />
<svg class="brand__mark" viewBox="0 0 44 44" width="44" height="44" aria-hidden="true">
<rect width="44" height="44" rx="10" fill={dark ? '#b8902e' : '#0f2a44'} />
<use href={`#${LOGO_GLYPH_ID}`} fill={dark ? '#0b1f33' : '#ffffff'} />
{!dark && <rect x="30" y="30" width="8" height="8" rx="2" fill="#b8902e" />}
</svg>
<span class="brand__text">
<span class="brand__name">{studio.nome}</span>
<span class="brand__tag">{tag}</span>
@@ -34,7 +39,11 @@ const MarkSvg = variant === 'dark' ? MarkDark : Mark;
</a>
) : (
<span class:list={['brand', `brand--${variant}`, className]}>
<MarkSvg class="brand__mark" width={44} height={44} aria-hidden="true" />
<svg class="brand__mark" viewBox="0 0 44 44" width="44" height="44" aria-hidden="true">
<rect width="44" height="44" rx="10" fill={dark ? '#b8902e' : '#0f2a44'} />
<use href={`#${LOGO_GLYPH_ID}`} fill={dark ? '#0b1f33' : '#ffffff'} />
{!dark && <rect x="30" y="30" width="8" height="8" rx="2" fill="#b8902e" />}
</svg>
<span class="brand__text">
<span class="brand__name">{studio.nome}</span>
<span class="brand__tag">{tag}</span>
+17
View File
@@ -0,0 +1,17 @@
---
/** Definizione unica del tracciato del marchio, richiamata dai loghi della pagina (Logo.astro). */
import { LOGO_GLYPH_ID, LOGO_GLYPH_PATH } from '../lib/logo';
---
<svg class="logo-defs" width="0" height="0" aria-hidden="true" focusable="false">
<defs>
<path id={LOGO_GLYPH_ID} d={LOGO_GLYPH_PATH}></path>
</defs>
</svg>
<style>
.logo-defs {
position: absolute;
overflow: hidden;
}
</style>
+4 -1
View File
@@ -79,7 +79,10 @@ const { embedUrl, title, query, place, compact = false } = Astro.props;
gap: var(--space-3);
padding: var(--space-6);
text-align: center;
background: repeating-linear-gradient(45deg, var(--navy-050) 0 12px, var(--white) 12px 24px);
/* trama a puntini, richiamo discreto di una mappa */
background-color: var(--navy-050);
background-image: radial-gradient(var(--navy-100) 1.5px, transparent 1.5px);
background-size: 18px 18px;
}
.map-consent__placeholder p {
+197
View File
@@ -0,0 +1,197 @@
---
/**
* «Come lavoriamo»: i passaggi di un incarico. Su desktop l'intestazione resta ferma a sinistra
* mentre i passi scorrono a destra; una barra oro accanto al titolo si riempie man mano che si
* leggono i passi e il numero di ciascun passo si «accende» quando arriva a metà schermo
* (scroll-driven animations, solo dove supportate; altrimenti tutto resta fermo e leggibile).
*/
import { metodo } from '../data/pagine';
import Icon from './Icon.astro';
interface Props {
/** Fondo della sezione. */
tone?: 'paper' | 'white';
}
const { tone = 'paper' } = Astro.props;
---
<section
class:list={['section metodo', { 'section--paper': tone === 'paper' }]}
aria-labelledby="metodo-titolo"
>
<div class="container metodo__inner">
<div class="metodo__head">
<p class="eyebrow">{metodo.eyebrow}</p>
<h2 id="metodo-titolo">{metodo.titolo}</h2>
<p class="metodo__text">{metodo.testo}</p>
<div class="metodo__rail" aria-hidden="true">
<span></span>
</div>
<a class="btn btn--primary" href={metodo.cta.href}>
{metodo.cta.label}
<Icon name="arrow-right" size={18} />
</a>
</div>
<ol class="metodo__steps">
{metodo.passi.map((p, i) => (
<li class="step reveal">
<span class="step__num" aria-hidden="true">
{String(i + 1).padStart(2, '0')}
</span>
<div>
<h3>{p.titolo}</h3>
<p>{p.testo}</p>
</div>
</li>
))}
</ol>
</div>
</section>
<style>
.metodo__inner {
display: grid;
grid-template-columns: minmax(0, 0.9fr) minmax(0, 1.1fr);
gap: var(--space-8);
align-items: start;
timeline-scope: --metodo;
}
.metodo__head {
position: sticky;
top: calc(var(--header-h) + 2.5rem);
}
.metodo__text {
font-size: var(--fs-lg);
color: var(--ink-600);
max-width: 30rem;
}
/* barra di avanzamento: piena se il browser non supporta le animazioni da scorrimento */
.metodo__rail {
width: min(100%, 16rem);
height: 4px;
margin: var(--space-6) 0;
border-radius: 4px;
background: rgba(138, 106, 30, 0.18);
overflow: hidden;
}
.metodo__rail span {
display: block;
height: 100%;
border-radius: inherit;
background: var(--gold-gradient);
transform-origin: 0 50%;
}
.metodo__steps {
display: grid;
gap: var(--space-4);
list-style: none;
view-timeline-name: --metodo;
}
.step {
position: relative;
display: grid;
grid-template-columns: auto minmax(0, 1fr);
gap: var(--space-5);
padding: var(--space-6);
border: 1px solid var(--line);
border-radius: var(--radius-lg);
background: var(--white);
box-shadow: var(--shadow-sm);
}
.step__num {
position: relative;
display: grid;
place-items: center;
width: 3.5rem;
height: 3.5rem;
border-radius: 50%;
border: 1px solid var(--line);
font-family: var(--font-display);
font-size: 1.15rem;
font-weight: 500;
color: var(--gold-700);
}
/* anello oro che si chiude attorno al numero */
.step__num::after {
content: '';
position: absolute;
inset: -1px;
border-radius: 50%;
border: 2px solid var(--gold-500);
}
.step h3 {
margin: 0.35rem 0 var(--space-2);
font-size: 1.35rem;
}
.step p {
margin: 0;
color: var(--ink-600);
}
@keyframes metodo-fill {
from {
scale: 0 1;
}
to {
scale: 1 1;
}
}
@keyframes step-ring {
from {
opacity: 0;
scale: 0.6;
}
}
@media (prefers-reduced-motion: no-preference) {
@supports (animation-timeline: view()) {
.metodo__rail span {
animation: metodo-fill linear both;
animation-timeline: --metodo;
animation-range: entry 40% exit 60%;
}
.step__num::after {
animation: step-ring var(--ease-out) both;
animation-timeline: view();
animation-range: cover 30% cover 50%;
}
}
}
@media (max-width: 60em) {
.metodo__inner {
grid-template-columns: minmax(0, 1fr);
gap: var(--space-6);
}
.metodo__head {
position: static;
}
.metodo__rail {
display: none;
}
}
@media (max-width: 26.25em) {
.step {
grid-template-columns: minmax(0, 1fr);
gap: var(--space-3);
padding: var(--space-5);
}
}
</style>
+57 -21
View File
@@ -36,7 +36,7 @@ const telefono = studio.telefoni[0];
<dialog id="menu-mobile" class="mobile-menu" aria-label="Menu" data-menu>
<div class="mobile-menu__head">
<Logo />
<Logo variant="dark" />
<button type="button" class="mobile-menu__close" data-menu-close>
<Icon name="x" size={22} />
<span class="visually-hidden">Chiudi il menu</span>
@@ -84,10 +84,10 @@ const telefono = studio.telefoni[0];
)}
</ul>
<div class="mobile-menu__contacts">
<a class="btn btn--primary btn--block" href={ctaHeader.href}>
<a class="btn btn--gold btn--block" href={ctaHeader.href}>
{ctaHeader.label}
</a>
<a class="btn btn--outline btn--block" href={telHref(telefono)}>
<a class="btn btn--ghost-light btn--block" href={telHref(telefono)}>
<Icon name="phone" size={18} />
{telText(telefono)}
</a>
@@ -105,7 +105,7 @@ const telefono = studio.telefoni[0];
margin-left: auto;
width: var(--tap);
height: var(--tap);
border-radius: var(--radius-sm);
border-radius: var(--radius-pill);
border: 1px solid var(--line);
background: var(--white);
color: var(--navy-900);
@@ -125,6 +125,7 @@ const telefono = studio.telefoni[0];
}
.mobile-menu {
--focus-ring: var(--gold-300);
width: 100%;
max-width: 100%;
height: 100%;
@@ -132,13 +133,13 @@ const telefono = studio.telefoni[0];
margin: 0;
padding: 0 var(--gutter) var(--space-6);
border: 0;
background: var(--white);
color: var(--ink-900);
background: var(--navy-950);
color: var(--on-dark);
overflow-y: auto;
}
.mobile-menu::backdrop {
background: rgba(11, 31, 51, 0.4);
background: rgba(7, 20, 35, 0.6);
}
.mobile-menu__head {
@@ -147,7 +148,7 @@ const telefono = studio.telefoni[0];
justify-content: space-between;
gap: var(--space-4);
min-height: 4.25rem;
border-bottom: 1px solid var(--line);
border-bottom: 1px solid var(--line-dark);
margin-bottom: var(--space-3);
}
@@ -159,10 +160,10 @@ const telefono = studio.telefoni[0];
flex: none;
width: var(--tap);
height: var(--tap);
border-radius: var(--radius-sm);
border: 1px solid var(--line);
background: var(--white);
color: var(--navy-900);
border-radius: var(--radius-pill);
border: 1px solid rgba(255, 255, 255, 0.24);
background: rgba(255, 255, 255, 0.06);
color: var(--white);
}
.mobile-menu__sub-toggle :global(svg) {
@@ -178,7 +179,35 @@ const telefono = studio.telefoni[0];
}
.mobile-menu__item {
border-bottom: 1px solid var(--line);
border-bottom: 1px solid var(--line-dark);
}
/* voci che salgono in sequenza all'apertura del menu */
@media (prefers-reduced-motion: no-preference) {
.mobile-menu[open] .mobile-menu__item,
.mobile-menu[open] .mobile-menu__contacts {
animation: rise 480ms var(--ease-out) both;
}
.mobile-menu[open] .mobile-menu__item:nth-child(2) {
animation-delay: 40ms;
}
.mobile-menu[open] .mobile-menu__item:nth-child(3) {
animation-delay: 80ms;
}
.mobile-menu[open] .mobile-menu__item:nth-child(4) {
animation-delay: 120ms;
}
.mobile-menu[open] .mobile-menu__item:nth-child(n + 5) {
animation-delay: 160ms;
}
.mobile-menu[open] .mobile-menu__contacts {
animation-delay: 220ms;
}
}
.mobile-menu__row {
@@ -192,18 +221,19 @@ const telefono = studio.telefoni[0];
flex: 1;
display: flex;
align-items: center;
min-height: 3.25rem;
min-height: 3.75rem;
font-family: var(--font-display);
font-size: 1.3rem;
font-size: 1.6rem;
font-weight: 500;
color: var(--navy-900);
letter-spacing: -0.01em;
color: var(--white);
text-decoration: none;
}
.mobile-menu a[aria-current] {
color: var(--navy-700);
color: var(--gold-300);
text-decoration: underline;
text-decoration-color: var(--gold-500);
text-decoration-color: var(--gold-300);
text-decoration-thickness: 2px;
text-underline-offset: 6px;
}
@@ -212,6 +242,8 @@ const telefono = studio.telefoni[0];
display: none;
list-style: none;
padding: 0 0 var(--space-3) var(--space-4);
border-left: 2px solid var(--gold-500);
margin: 0 0 var(--space-3) 0.25rem;
}
.mobile-menu__row:has(.mobile-menu__sub-toggle[aria-expanded='true']) + .mobile-menu__sub {
@@ -223,7 +255,7 @@ const telefono = studio.telefoni[0];
align-items: center;
min-height: var(--tap);
padding-block: 0.35rem;
color: var(--ink-700);
color: var(--on-dark);
text-decoration: none;
font-size: var(--fs-md);
line-height: 1.35;
@@ -232,7 +264,7 @@ const telefono = studio.telefoni[0];
.mobile-menu__contacts {
display: grid;
gap: var(--space-3);
margin-top: var(--space-5);
margin-top: var(--space-6);
}
.mobile-menu__mail {
@@ -241,13 +273,17 @@ const telefono = studio.telefoni[0];
justify-content: center;
gap: 0.5rem;
min-height: var(--tap);
color: var(--navy-800);
color: var(--on-dark);
font-weight: 600;
font-size: var(--fs-sm);
text-decoration: none;
overflow-wrap: anywhere;
}
.mobile-menu__mail :global(svg) {
color: var(--gold-300);
}
:global(html:has(.mobile-menu[open])) {
overflow: hidden;
}
+88 -23
View File
@@ -6,7 +6,7 @@
*/
import { ctaHeader, isCurrentSection, navPrincipale } from '../data/navigazione';
import { studio } from '../data/studio';
import { telHref, telText } from '../lib/format';
import { telHref, telNational, telText } from '../lib/format';
import { servizioHref, type Servizio } from '../lib/servizi';
import Icon from './Icon.astro';
@@ -61,7 +61,7 @@ const current = (href: string) =>
<a class="nav__phone" href={telHref(studio.telefoni[0])}>
<Icon name="phone" size={16} />
<span class="visually-hidden">Telefono</span>
{telText(studio.telefonoPrincipaleBreve)}
{telText(telNational(studio.telefoni[0]))}
</a>
<a class="btn btn--primary btn--sm" href={ctaHeader.href}>
{ctaHeader.label}
@@ -107,26 +107,63 @@ const current = (href: string) =>
font-size: var(--fs-sm);
}
.nav__item > a {
position: relative;
}
/* lineetta oro sotto la voce: si allarga al passaggio del mouse, resta sulla voce corrente */
.nav__item > a::after {
content: '';
position: absolute;
left: 0.75rem;
right: 0.75rem;
bottom: 0.45rem;
height: 2px;
border-radius: 2px;
background: var(--gold-500);
scale: 0 1;
transition: scale 260ms var(--ease-out);
}
.nav__item--has-sub > a::after {
right: 0.3rem;
}
.nav__item > a:hover,
.nav__item > a[aria-current] {
color: var(--navy-900);
background: var(--navy-050);
}
.nav__item > a[aria-current] {
box-shadow: inset 0 -2px 0 var(--gold-500);
border-radius: var(--radius-sm) var(--radius-sm) 0 0;
.nav__item > a:hover::after,
.nav__item > a[aria-current]::after {
scale: 1 1;
}
/* etichette su una riga: vicino ai punti di interruzione (960 e 1100 px) andavano a capo */
.nav__item > a {
white-space: nowrap;
}
.nav__item--has-sub > a {
padding-right: 0.3rem;
}
/* tra 960 e 1020 px lo spazio è poco: voci più compatte, così anche il logo resta su una
riga (con le voci su una riga lo spazio mancante ricadrebbe tutto sul logo) */
@media (max-width: 63.75em) {
.nav__item > a {
padding-inline: 0.5rem;
}
.nav__item--has-sub > a {
padding-right: 0.3rem;
}
}
.nav__sub-toggle {
justify-content: center;
min-width: 32px;
min-width: var(--tap);
padding: 0.5rem 0.4rem;
margin-left: -0.15rem;
border: 0;
background: transparent;
}
@@ -150,27 +187,32 @@ const current = (href: string) =>
display: none;
position: absolute;
top: 100%;
left: 0;
left: -0.5rem;
z-index: 60;
min-width: 21rem;
min-width: 22rem;
padding: var(--space-2);
list-style: none;
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
box-shadow: var(--shadow-md);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-lg);
}
/* ponte invisibile tra voce e sottomenu, per non perdere l'hover */
.nav__sub::before {
content: '';
position: absolute;
left: 0;
right: 0;
top: -0.6rem;
height: 0.6rem;
@keyframes drop-in {
from {
opacity: 0;
translate: 0 -6px;
}
}
@media (prefers-reduced-motion: no-preference) {
.nav__sub {
animation: drop-in 220ms var(--ease-out);
}
}
/* il sottomenu tocca la voce (top: 100%) ed è dentro il suo <li>: passando dalla voce al
sottomenu l'hover non si perde, senza «ponti» sopra gli altri controlli */
.nav__item--has-sub:hover .nav__sub,
.nav__sub-toggle[aria-expanded='true'] + .nav__sub {
display: block;
@@ -184,14 +226,29 @@ const current = (href: string) =>
.nav__sub a {
display: flex;
align-items: center;
gap: 0.75rem;
min-height: var(--tap);
padding: 0.5rem 0.75rem;
border-radius: var(--radius-sm);
padding: 0.55rem 0.85rem;
border-radius: var(--radius-md);
color: var(--ink-700);
text-decoration: none;
font-size: var(--fs-sm);
font-weight: 500;
line-height: 1.35;
transition:
background-color var(--dur) var(--ease),
color var(--dur) var(--ease);
}
/* pallino oro davanti alla voce: si accende al passaggio del mouse e sulla pagina corrente */
.nav__sub a::before {
content: '';
flex: none;
width: 6px;
height: 6px;
border-radius: 50%;
background: var(--line);
transition: background-color var(--dur) var(--ease);
}
.nav__sub a:hover,
@@ -200,6 +257,11 @@ const current = (href: string) =>
color: var(--navy-900);
}
.nav__sub a:hover::before,
.nav__sub a[aria-current]::before {
background: var(--gold-500);
}
.nav__cta {
display: flex;
align-items: center;
@@ -223,6 +285,7 @@ const current = (href: string) =>
}
.nav__phone :global(svg) {
flex-shrink: 0;
width: 16px;
height: 16px;
color: var(--gold-700);
@@ -232,7 +295,9 @@ const current = (href: string) =>
white-space: nowrap;
}
@media (max-width: 68.75em) {
/* il numero compare solo quando c'è spazio per tutto senza comprimere nulla (misurato: sotto
circa 1120 px l'icona veniva schiacciata); margine per le differenze di resa dei caratteri */
@media (max-width: 71.25em) {
.nav {
gap: var(--space-3);
}
+45 -9
View File
@@ -1,5 +1,9 @@
---
/** Testata delle pagine interne: percorso, titolo principale (unico <h1>) e sottotitolo. */
/**
* Testata delle pagine interne come «palco» navy: percorso, titolo principale (unico <h1>),
* sottotitolo ed eventuale contenuto aggiuntivo. La trama decorativa scorre più lenta del
* contenuto (parallasse, solo CSS e solo dove supportato).
*/
import type { Crumb } from '../lib/seo';
import Breadcrumb from './Breadcrumb.astro';
@@ -12,8 +16,9 @@ interface Props {
const { title, subtitle, breadcrumbs } = Astro.props;
---
<div class="page-head">
<div class="container">
<div class="page-head stage">
<div class="stage__decor page-head__decor" aria-hidden="true"></div>
<div class="container page-head__inner">
<Breadcrumb items={breadcrumbs} />
<h1>{title}</h1>
{subtitle && <p class="page-head__lead">{subtitle}</p>}
@@ -23,20 +28,51 @@ const { title, subtitle, breadcrumbs } = Astro.props;
<style>
.page-head {
background: var(--navy-050);
border-bottom: 1px solid var(--line);
padding-block: var(--space-7) var(--space-6);
margin-top: var(--stage-inset);
}
.page-head__inner {
padding-block: clamp(3rem, 7vw, 6rem) clamp(3rem, 6vw, 5rem);
}
.page-head h1 {
max-width: 22ch;
margin-bottom: var(--space-3);
max-width: 20ch;
margin-bottom: var(--space-4);
}
.page-head__lead {
font-size: var(--fs-lg);
color: var(--ink-600);
color: var(--on-dark);
max-width: 44rem;
margin: 0;
}
/* anello oro sfumato in basso a destra */
.page-head__decor {
background: radial-gradient(
closest-side,
transparent 72%,
rgba(227, 200, 120, 0.22) 73%,
transparent 74%
);
background-size: 46rem 46rem;
background-position: right -14rem bottom -26rem;
background-repeat: no-repeat;
}
@keyframes page-head-drift {
to {
translate: 0 6rem;
}
}
@media (prefers-reduced-motion: no-preference) {
@supports (animation-timeline: scroll()) {
.page-head__decor {
animation: page-head-drift linear both;
animation-timeline: scroll(root block);
animation-range: 0 32rem;
}
}
}
</style>
+34 -13
View File
@@ -9,10 +9,12 @@ interface Props {
const { partner } = Astro.props;
---
<ul class="partners">
<ul class="partners reveal-group">
{partner.map((p) => (
<li class="partner">
<Icon name={p.icona} size={22} />
<span class="partner__icon">
<Icon name={p.icona} size={22} />
</span>
<span>
<strong>{p.nome}</strong>
<span>{p.descrizione}</span>
@@ -30,31 +32,50 @@ const { partner } = Astro.props;
}
.partner {
display: flex;
gap: var(--space-3);
align-items: center;
padding: var(--space-4);
background: rgba(255, 255, 255, 0.6);
border: 1px dashed #c3ccd6;
border-radius: var(--radius-md);
display: grid;
gap: var(--space-4);
align-content: start;
padding: var(--space-5);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-lg);
transition:
transform 260ms var(--ease-out),
box-shadow 260ms var(--ease-out);
}
.partner:hover {
transform: translateY(-3px);
box-shadow: var(--shadow-md);
}
.partner__icon {
display: grid;
place-items: center;
width: 48px;
height: 48px;
border-radius: 50%;
background: var(--gold-100);
color: var(--gold-700);
}
.partner :global(svg) {
flex: none;
width: 22px;
height: 22px;
color: var(--gold-700);
}
.partner strong {
display: block;
font-size: var(--fs-sm);
margin-bottom: 0.2rem;
font-family: var(--font-display);
font-size: 1.15rem;
font-weight: 600;
color: var(--navy-900);
}
.partner strong + span {
display: block;
font-size: var(--fs-xs);
font-size: var(--fs-sm);
color: var(--ink-600);
line-height: 1.45;
}
+33 -18
View File
@@ -57,36 +57,50 @@ const qualifiche =
<style>
.person {
position: relative;
display: grid;
grid-template-columns: 64px minmax(0, 1fr);
gap: var(--space-4);
padding: var(--space-5);
grid-template-columns: 72px minmax(0, 1fr);
gap: var(--space-5);
padding: var(--space-6);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-sm);
overflow: hidden;
}
/* filo oro in alto */
.person::before {
content: '';
position: absolute;
inset: 0 0 auto;
height: 3px;
background: var(--gold-gradient);
}
.person__avatar {
display: grid;
place-items: center;
width: 64px;
height: 64px;
width: 72px;
height: 72px;
border-radius: 50%;
background: var(--navy-800);
background: radial-gradient(circle at 30% 25%, var(--navy-600), var(--navy-950) 75%);
box-shadow:
0 0 0 3px var(--white),
0 0 0 5px var(--gold-300);
color: var(--white);
font-family: var(--font-display);
font-size: 1.35rem;
font-weight: 600;
font-size: 1.5rem;
font-weight: 500;
}
.person__name {
margin: 0 0 0.15rem;
font-size: 1.2rem;
margin: 0 0 0.2rem;
font-size: 1.35rem;
}
.person__role {
margin-bottom: 0.5rem;
margin-bottom: 0.75rem;
font-size: var(--fs-sm);
font-weight: 600;
color: var(--gold-700);
@@ -94,7 +108,7 @@ const qualifiche =
.person__list {
display: grid;
gap: 0.3rem;
gap: 0.35rem;
list-style: none;
font-size: var(--fs-xs);
color: var(--ink-600);
@@ -107,30 +121,30 @@ const qualifiche =
.person__list li {
display: flex;
gap: 0.5rem;
gap: 0.55rem;
align-items: flex-start;
}
.person__list li::before {
content: '';
flex: none;
width: 5px;
height: 5px;
width: 6px;
height: 6px;
margin-top: 0.55em;
border-radius: 50%;
background: var(--gold-500);
}
.person__law {
margin: 0.75rem 0 0;
padding-top: 0.6rem;
margin: 0.85rem 0 0;
padding-top: 0.7rem;
border-top: 1px dashed var(--line);
font-size: var(--fs-xs);
color: var(--ink-700);
}
.person__meta {
margin: 0.6rem 0 0;
margin: 0.7rem 0 0;
font-size: var(--fs-xs);
color: var(--ink-600);
}
@@ -142,6 +156,7 @@ const qualifiche =
@media (max-width: 26.25em) {
.person {
grid-template-columns: minmax(0, 1fr);
padding: var(--space-5);
}
}
</style>
+40 -6
View File
@@ -1,5 +1,8 @@
---
/** Intestazione di sezione: occhiello, titolo e sottotitolo facoltativo. */
/**
* Intestazione di sezione: occhiello, titolo e sottotitolo facoltativo. Con `layout="split"`
* (≥ 960 px) titolo a sinistra e sottotitolo a destra, allineati in basso.
*/
interface Props {
eyebrow?: string;
title: string;
@@ -7,28 +10,59 @@ interface Props {
/** id del titolo, per collegarlo alla sezione con aria-labelledby. */
id?: string;
level?: 2 | 3;
layout?: 'stack' | 'split';
class?: string;
}
const { eyebrow, title, subtitle, id, level = 2, class: className } = Astro.props;
const { eyebrow, title, subtitle, id, level = 2, layout = 'stack', class: className } = Astro.props;
const Heading = level === 2 ? 'h2' : 'h3';
---
<div class:list={['section-head', className]}>
{eyebrow && <p class="eyebrow">{eyebrow}</p>}
<Heading id={id}>{title}</Heading>
<div class:list={['section-head', `section-head--${layout}`, 'reveal', className]}>
<div>
{eyebrow && <p class="eyebrow">{eyebrow}</p>}
<Heading id={id}>{title}</Heading>
</div>
{subtitle && <p class="section-head__sub">{subtitle}</p>}
</div>
<style>
.section-head {
max-width: 42rem;
max-width: 46rem;
margin-bottom: var(--space-7);
}
.section-head h2,
.section-head h3 {
margin-bottom: var(--space-3);
}
.section-head__sub {
color: var(--ink-600);
font-size: var(--fs-lg);
margin: 0;
}
:global(.stage) .section-head__sub {
color: var(--on-dark);
}
@media (min-width: 60.001em) {
.section-head--split {
display: grid;
grid-template-columns: minmax(0, 1.15fr) minmax(0, 0.85fr);
align-items: end;
gap: var(--space-8);
max-width: none;
}
.section-head--split h2,
.section-head--split h3 {
margin-bottom: 0;
}
.section-head--split .section-head__sub {
padding-bottom: 0.35rem;
}
}
</style>
+26 -7
View File
@@ -6,7 +6,15 @@
import type { Sede } from '../data/studio';
import { studio } from '../data/studio';
import { sedi as t } from '../data/testi';
import { cityLine, googleDirectionsUrl, hoursLine, telHref, telText } from '../lib/format';
import {
cityLine,
googleDirectionsUrl,
hoursLine,
mapQuery,
mapTitle,
telHref,
telText,
} from '../lib/format';
import Icon from './Icon.astro';
import MapConsent from './MapConsent.astro';
@@ -23,7 +31,9 @@ const telefono = sede.telefono ?? studio.telefoni[0];
<article class:list={['sede', `sede--${variant}`]} id={`sede-${sede.id}`}>
<div class="sede__head">
<Icon name="map-pin" size={20} />
<span class="sede__pin">
<Icon name="map-pin" size={20} />
</span>
<Heading>{sede.nome}</Heading>
</div>
<address>
@@ -34,8 +44,8 @@ const telefono = sede.telefono ?? studio.telefoni[0];
<MapConsent
embedUrl={sede.mappa.embedUrl}
title={sede.mappa.titolo}
query={sede.ricercaMappa}
title={mapTitle(sede)}
query={mapQuery(sede.indirizzo)}
place={sede.nome}
compact={variant === 'compact'}
/>
@@ -64,7 +74,7 @@ const telefono = sede.telefono ?? studio.telefoni[0];
<div class="sede__actions">
<a
class="btn btn--outline btn--sm"
href={googleDirectionsUrl(sede.ricercaMappa)}
href={googleDirectionsUrl(mapQuery(sede.indirizzo))}
rel="noopener"
>
Indicazioni stradali<span class="visually-hidden"> ({sede.nome})</span>
@@ -108,11 +118,20 @@ const telefono = sede.telefono ?? studio.telefoni[0];
gap: var(--space-3);
}
.sede__head :global(svg) {
.sede__pin {
display: grid;
place-items: center;
flex: none;
width: 44px;
height: 44px;
border-radius: 50%;
background: var(--navy-800);
color: var(--gold-300);
}
.sede__pin :global(svg) {
width: 20px;
height: 20px;
color: var(--gold-700);
}
.sede__head :global(h2),
+224 -38
View File
@@ -1,7 +1,10 @@
---
/**
* Card di un servizio: icona, titolo, sommario e link «Approfondisci». L'intera card è
* cliccabile (il link si estende su tutta la superficie) e si solleva leggermente al passaggio.
* Card di un servizio: numero, icona, titolo, sommario e link «Approfondisci». L'intera card è
* cliccabile (il link si estende su tutta la superficie); al passaggio del mouse si solleva e
* il bordo si accende d'oro. `featured` = card in evidenza della griglia «bento» (fondo navy).
* Nella griglia larga la card che occupa una riga intera si dispone in orizzontale
* (container query).
*/
import { servizioHref, type Servizio } from '../lib/servizi';
import Icon from './Icon.astro';
@@ -13,60 +16,126 @@ interface Props {
/** Destinazione del redirect delle vecchie ancore (data-legacy-href). */
legacy?: boolean;
headingLevel?: 2 | 3;
/** Posizione nell'elenco (da 0): mostrata come numero d'ordine decorativo. */
index?: number;
featured?: boolean;
}
const { servizio, id, legacy = false, headingLevel = 3 } = Astro.props;
const { servizio, id, legacy = false, headingLevel = 3, index, featured = false } = Astro.props;
const href = servizioHref(servizio);
const Heading = headingLevel === 2 ? 'h2' : 'h3';
const numero = index === undefined ? null : String(index + 1).padStart(2, '0');
---
<article class="card" id={id} data-legacy-href={legacy ? href : undefined}>
<span class="card__icon">
<Icon name={servizio.data.icona} size={24} />
</span>
<Heading class="card__title">{servizio.data.titolo}</Heading>
<p>{servizio.data.sommario}</p>
<a class="card__link" href={href}>
Approfondisci<span class="visually-hidden"> ({servizio.data.titolo})</span>
<Icon name="arrow-right" size={16} />
</a>
<article
class:list={['card', { 'card--featured': featured }]}
id={id}
data-legacy-href={legacy ? href : undefined}
>
<div class="card__body">
<div class="card__top">
<span class="card__icon">
<Icon name={servizio.data.icona} size={24} />
</span>
{numero && (
<span class="card__num" aria-hidden="true">
{numero}
</span>
)}
</div>
<div class="card__text">
<Heading class="card__title">{servizio.data.titolo}</Heading>
<p>{servizio.data.sommario}</p>
</div>
<a class="card__link" href={href}>
Approfondisci<span class="visually-hidden"> ({servizio.data.titolo})</span>
<span class="card__arrow">
<Icon name="arrow-up-right" size={18} />
</span>
</a>
</div>
</article>
<style>
.card {
position: relative;
container-type: inline-size;
display: flex;
flex-direction: column;
gap: var(--space-3);
padding: var(--space-5);
border-radius: var(--radius-lg);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
box-shadow: var(--shadow-sm);
transition:
transform var(--dur) var(--ease),
box-shadow var(--dur) var(--ease),
border-color var(--dur) var(--ease);
transform 260ms var(--ease-out),
box-shadow 260ms var(--ease-out),
border-color 260ms var(--ease-out);
}
/* bordo d'oro sfumato che compare al passaggio del mouse */
.card::before {
content: '';
position: absolute;
inset: -1px;
border-radius: inherit;
padding: 1px;
background: linear-gradient(140deg, var(--gold-300), transparent 45%, var(--gold-500));
-webkit-mask:
linear-gradient(#000 0 0) content-box,
linear-gradient(#000 0 0);
-webkit-mask-composite: xor;
mask:
linear-gradient(#000 0 0) content-box exclude,
linear-gradient(#000 0 0);
opacity: 0;
transition: opacity 260ms var(--ease-out);
pointer-events: none;
}
.card:hover {
transform: translateY(-3px);
transform: translateY(-4px);
box-shadow: var(--shadow-md);
border-color: var(--navy-100);
border-color: transparent;
}
.card:hover::before {
opacity: 1;
}
.card:focus-within {
border-color: var(--navy-700);
}
.card__body {
flex: 1;
display: flex;
flex-direction: column;
gap: var(--space-4);
padding: var(--space-5) var(--space-5) var(--space-4);
}
.card__top {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: var(--space-3);
}
.card__icon {
display: grid;
place-items: center;
width: 48px;
height: 48px;
border-radius: 12px;
width: 52px;
height: 52px;
border-radius: 16px;
background: var(--navy-050);
color: var(--navy-700);
transition:
background-color 260ms var(--ease-out),
color 260ms var(--ease-out);
}
.card:hover .card__icon {
background: var(--navy-800);
color: var(--gold-300);
}
.card__icon :global(svg) {
@@ -74,13 +143,29 @@ const Heading = headingLevel === 2 ? 'h2' : 'h3';
height: 24px;
}
.card__num {
font-family: var(--font-display);
font-size: 2.25rem;
font-weight: 400;
line-height: 1;
letter-spacing: -0.04em;
background: var(--gold-gradient);
-webkit-background-clip: text;
background-clip: text;
color: transparent;
}
.card__text {
flex: 1;
}
.card__title {
margin: 0.25rem 0 0;
font-size: 1.2rem;
margin: 0 0 var(--space-2);
font-size: 1.3rem;
line-height: 1.2;
}
.card p {
flex: 1;
margin: 0;
color: var(--ink-600);
font-size: var(--fs-sm);
@@ -89,16 +174,41 @@ const Heading = headingLevel === 2 ? 'h2' : 'h3';
.card__link {
display: inline-flex;
align-items: center;
gap: 0.35rem;
align-self: flex-start;
justify-content: space-between;
gap: 0.6rem;
min-height: var(--tap);
margin-top: var(--space-1);
padding-top: var(--space-3);
border-top: 1px solid var(--line);
font-weight: 600;
font-size: var(--fs-sm);
text-decoration: none;
color: var(--navy-800);
}
.card__arrow {
display: grid;
place-items: center;
width: 2.25rem;
height: 2.25rem;
border-radius: 50%;
background: var(--navy-050);
transition:
background-color 260ms var(--ease-out),
color 260ms var(--ease-out),
transform 260ms var(--ease-out);
}
.card:hover .card__arrow {
background: var(--gold-300);
color: var(--navy-950);
transform: rotate(45deg);
}
.card__arrow :global(svg) {
width: 18px;
height: 18px;
}
/* l'area cliccabile copre l'intera card */
.card__link::after {
content: '';
@@ -111,18 +221,94 @@ const Heading = headingLevel === 2 ? 'h2' : 'h3';
outline: none;
}
/* anello fuori dalla card, sul fondo chiaro della sezione: sempre gold-700 */
.card__link:focus-visible::after {
outline: 3px solid var(--gold-500);
outline: 3px solid var(--gold-700);
outline-offset: 3px;
}
.card__link :global(svg) {
width: 16px;
height: 16px;
transition: transform var(--dur) var(--ease);
/* --- card in evidenza (navy) --- */
.card--featured {
border-color: var(--navy-950);
background-color: var(--navy-950);
/* niente overflow: hidden, taglierebbe l'anello di focus che sta fuori dalla card */
isolation: isolate;
}
.card:hover .card__link :global(svg) {
transform: translateX(3px);
.card--featured::after {
content: '';
position: absolute;
z-index: -1;
inset: 0;
border-radius: inherit;
background:
radial-gradient(60% 50% at 100% 0%, rgba(184, 144, 46, 0.3), transparent 70%),
radial-gradient(70% 60% at 0% 100%, rgba(31, 75, 116, 0.6), transparent 70%);
pointer-events: none;
}
.card--featured .card__body {
padding: var(--space-6);
}
.card--featured .card__icon {
width: 64px;
height: 64px;
border-radius: 20px;
background: rgba(255, 255, 255, 0.08);
color: var(--gold-300);
}
.card--featured .card__num {
font-size: 3.5rem;
}
.card--featured .card__text {
display: flex;
flex-direction: column;
justify-content: flex-end;
}
.card--featured .card__title {
color: var(--white);
font-size: clamp(1.6rem, 1.2rem + 1.2vw, 2.15rem);
}
.card--featured p {
color: var(--on-dark);
font-size: var(--fs-md);
max-width: 34ch;
}
.card--featured .card__link {
color: var(--white);
border-top-color: var(--line-dark);
}
.card--featured .card__arrow {
background: var(--gold-300);
color: var(--navy-950);
}
/* card che occupa tutta la riga della griglia: disposizione orizzontale */
@container (min-width: 46rem) {
.card__body {
display: grid;
grid-template-columns: auto minmax(0, 1fr) auto;
align-items: center;
gap: var(--space-6);
padding: var(--space-5) var(--space-6);
}
.card__top {
flex-direction: row-reverse;
align-items: center;
gap: var(--space-5);
}
.card__link {
padding-top: 0;
border-top: 0;
}
}
</style>
+3 -3
View File
@@ -2,7 +2,7 @@
titolo: Accessibilità
sottotitolo: 'L’impegno dello Studio perché il sito sia consultabile da tutti, anche da chi usa tecnologie assistive.'
descrizioneSeo: 'Accessibilità del sito dello Studio Grasso: obiettivo WCAG 2.1 livello AA, verifiche svolte, limiti noti e come segnalare problemi di accessibilità.'
aggiornato: 2026-10-16
aggiornato: 2026-11-13
---
## Il nostro impegno
@@ -27,12 +27,12 @@ Nella realizzazione del sito sono stati adottati questi accorgimenti:
I campi del modulo di contatto hanno etichette associate e gli errori sono annunciati dalle tecnologie assistive.
Tecnologie usate: HTML5, CSS e JavaScript (solo per il menu di navigazione, cioè menu mobile e sottomenu dei servizi, il caricamento delle mappe su richiesta, i messaggi e il controllo anti-spam del modulo e l’apertura dei vecchi collegamenti alla pagina del servizio corrispondente).
Tecnologie usate: HTML5, CSS e JavaScript (solo per il menu di navigazione, cioè menu mobile e sottomenu dei servizi, il caricamento delle mappe su richiesta, i messaggi e il controllo anti-spam del modulo, l’evidenziazione nell’indice delle pagine legali della sezione in lettura e l’apertura dei vecchi collegamenti alla pagina del servizio corrispondente).
<!-- /se:modulo -->
<!-- se:!modulo -->
Tecnologie usate: HTML5, CSS e JavaScript (solo per il menu di navigazione, cioè menu mobile e sottomenu dei servizi, il caricamento delle mappe su richiesta e l’apertura dei vecchi collegamenti alla pagina del servizio corrispondente).
Tecnologie usate: HTML5, CSS e JavaScript (solo per il menu di navigazione, cioè menu mobile e sottomenu dei servizi, il caricamento delle mappe su richiesta, l’evidenziazione nell’indice delle pagine legali della sezione in lettura e l’apertura dei vecchi collegamenti alla pagina del servizio corrispondente).
<!-- /se:!modulo -->
+44
View File
@@ -48,6 +48,16 @@ export const home = {
icona: 'file-text',
},
],
/**
* Fascia di numeri sotto l'hero: le etichette stanno qui, i valori sono contati dai dati
* (servizi della collection, abilitazioni e sedi di studio.ts), così restano sempre veri.
*/
numeri: {
servizi: 'Aree di competenza',
abilitazioni: 'Abilitazioni e iscrizioni',
sedi: 'Sedi in provincia di Asti',
professionisti: 'Professionisti dello Studio',
},
},
servizi: {
eyebrow: 'Servizi',
@@ -81,6 +91,40 @@ export const home = {
},
};
/**
* «Come lavoriamo»: i passaggi di un incarico (home e pagina Servizi). Testo nuovo del rework
* grafico, da far confermare allo Studio (TODO-STUDIO.md).
*/
export const metodo = {
eyebrow: 'Come lavoriamo',
titolo: 'Dal primo contatto all’assistenza continuativa',
testo:
'Un percorso chiaro, con un unico interlocutore dall’inizio alla fine: sai sempre a che punto è la tua pratica e chi la segue.',
cta: { label: 'Richiedi un preventivo', href: '/contatti/' },
passi: [
{
titolo: 'Primo contatto',
testo:
'Ci chiami, ci scrivi o compili il modulo: raccogliamo la tua richiesta e, se serve, fissiamo un appuntamento a Montegrosso d’Asti o ad Asti.',
},
{
titolo: 'Analisi della situazione',
testo:
'Esaminiamo la posizione fiscale, contabile o societaria e individuiamo gli adempimenti e le soluzioni più adatte alle tue esigenze.',
},
{
titolo: 'Preventivo gratuito',
testo:
'Ti proponiamo un preventivo chiaro, gratuito e senza impegno, prima di iniziare l’attività.',
},
{
titolo: 'Al tuo fianco nel tempo',
testo:
'Seguiamo gli adempimenti nel corso dell’anno e restiamo il tuo riferimento per ogni nuova esigenza, fino all’eventuale contenzioso tributario.',
},
],
};
export const studioPagina = {
meta: {
titolo: 'Lo studio',
+25 -12
View File
@@ -25,12 +25,15 @@ export interface PostalAddress {
export interface Sede {
id: 'montegrosso' | 'asti';
/** Inizia con «Sede» (es. «Sede di Asti»): il titolo della mappa ne è ricavato. */
nome: string;
nomeBreve: string;
principale: boolean;
/**
* Indirizzo: ne sono ricavati anche la ricerca per indirizzo (indicazioni stradali, link a
* Google Maps e OpenStreetMap) e il titolo della mappa (src/lib/format.ts).
*/
indirizzo: PostalAddress;
/** Testo per la ricerca su Google Maps / OpenStreetMap (per indirizzo, non per coordinate). */
ricercaMappa: string;
suAppuntamento: boolean;
/**
* Telefono da indicare per questa sede (pulsante «Chiama», appuntamenti). Se manca si usa il
@@ -38,12 +41,19 @@ export interface Sede {
*/
telefono?: Phone;
mappa: {
/** URL di incorporamento di Google Maps, caricato solo dopo il clic dell'utente. */
/**
* URL di incorporamento di Google Maps, caricato solo dopo il clic dell'utente. Contiene
* coordinate e luogo, non l'indirizzo: se la sede cambia indirizzo va rigenerato
* (Google Maps → Condividi → Incorpora una mappa).
*/
embedUrl: string;
titolo: string;
};
}
/** Giorni della settimana con i nomi di schema.org (dati strutturati). */
export type GiornoSettimana =
'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday';
export interface StudioData {
nome: string;
sottotitolo: string;
@@ -60,8 +70,8 @@ export interface StudioData {
socioUnico: boolean | null;
inLiquidazione: boolean | null;
};
/** Il primo è il numero principale (intestazione, pulsanti «Chiama», dati strutturati). */
telefoni: Phone[];
telefonoPrincipaleBreve: string;
fax: Phone;
email: string;
pec: { indirizzo: string; etichetta: string }[];
@@ -70,6 +80,8 @@ export interface StudioData {
giorni: string;
giorniEsteso: string;
giorniBreve: string;
/** Gli stessi giorni dei tre testi qui sopra, per i dati strutturati: cambiarli insieme. */
giorniSettimana: GiornoSettimana[];
fasce: { apertura: string; chiusura: string }[];
notaAsti: string;
};
@@ -137,8 +149,6 @@ export const studio: StudioData = {
{ display: '+39 0141 951382', e164: '+390141951382' },
{ display: '+39 0141 1762214', e164: '+3901411762214' },
],
/** Numero mostrato nell'intestazione (forma breve). */
telefonoPrincipaleBreve: '0141 951382',
fax: { display: '+39 0141 951382', e164: '+390141951382' },
email: 'info@studiograssoezio.it',
pec: [
@@ -162,12 +172,10 @@ export const studio: StudioData = {
province: 'AT',
country: 'IT',
},
ricercaMappa: "Via XX Settembre 163, 14048 Montegrosso d'Asti AT, Italia",
suAppuntamento: false,
mappa: {
embedUrl:
'https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d8004.848449080845!2d8.236377634731156!3d44.81868574358478!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x47878dcc2e6297f3%3A0x846046fed37eb9c4!2sDOTT.+GRASSO+EZIO!5e0!3m2!1sit!2sit!4v1535992381814',
titolo: 'Mappa Google della sede di Montegrosso d’Asti, Via XX Settembre 163',
},
},
{
@@ -182,12 +190,10 @@ export const studio: StudioData = {
province: 'AT',
country: 'IT',
},
ricercaMappa: 'Piazza Medici 4, 14100 Asti AT, Italia',
suAppuntamento: true,
mappa: {
embedUrl:
'https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d8717.992744149282!2d8.209872081044194!3d44.893648234946355!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x47879320066f4583%3A0x1197181cde2a0e9b!2sDOTT.+GRASSO+EZIO!5e0!3m2!1sit!2sit!4v1535992455182',
titolo: 'Mappa Google della sede di Asti, Piazza Medici 4',
},
},
],
@@ -196,6 +202,7 @@ export const studio: StudioData = {
giorni: 'Dal lunedì al venerdì',
giorniEsteso: 'Lunedì – Venerdì',
giorniBreve: 'Lun – Ven',
giorniSettimana: ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday'],
/** Fasce orarie (formato 24 h, usato anche nei dati strutturati). */
fasce: [
{ apertura: '09:00', chiusura: '12:30' },
@@ -320,6 +327,12 @@ export const professionisti: Professionista[] = [
*/
export type ContactFormMode = 'off' | 'php' | 'endpoint';
/**
* Modalità del modulo da pubblicare: per attivarlo cambiare SOLO questo valore (docs/DEPLOY.md,
* sezione 6). La variabile d'ambiente CONTACT_FORM_MODE, se impostata, ha la precedenza.
*/
const MODALITA_PREDEFINITA: ContactFormMode = 'off';
const modeFromEnv = process.env.CONTACT_FORM_MODE;
export const contactForm: {
@@ -332,7 +345,7 @@ export const contactForm: {
mode:
modeFromEnv === 'off' || modeFromEnv === 'php' || modeFromEnv === 'endpoint'
? modeFromEnv
: 'off',
: MODALITA_PREDEFINITA,
endpoint: '',
phpAction: '/contact.php',
tempoMinimoSecondi: 3,
+5 -2
View File
@@ -4,6 +4,7 @@
*/
export const ctaBand = {
eyebrow: 'Preventivo gratuito',
titolo: 'Sei interessato ad uno dei nostri servizi?',
testo:
'Richiedi un preventivo gratuito e senza impegno: ti rispondiamo nel più breve tempo possibile.',
@@ -70,8 +71,10 @@ export const modulo = {
titolo: 'Controlla i campi evidenziati:',
obbligatorio: 'Compila questo campo.',
email: 'Inserisci un indirizzo e-mail valido (es. nome@esempio.it).',
telefono: 'Inserisci un numero di telefono valido (solo cifre, spazi e +).',
breve: 'Il testo è troppo breve.',
telefono:
'Inserisci un numero di telefono valido: da 6 a 25 caratteri tra cifre, spazi e i segni + ( ) . / -',
/** `{min}` diventa il numero minimo di caratteri del campo (attributo minlength). */
breve: 'Il messaggio deve contenere almeno {min} caratteri.',
presaVisione: 'Per inviare la richiesta conferma di aver letto l’informativa sulla privacy.',
rapido: 'Attendi qualche secondo prima di inviare il modulo.',
unErrore: 'Il modulo contiene 1 errore.',
+6 -3
View File
@@ -7,6 +7,7 @@ import frauncesUrl from '@fontsource-variable/fraunces/files/fraunces-latin-wght
import interUrl from '@fontsource-variable/inter/files/inter-latin-wght-normal.woff2?url';
import Footer from '../components/Footer.astro';
import Header from '../components/Header.astro';
import LogoDefs from '../components/LogoDefs.astro';
import { studio } from '../data/studio';
import { breadcrumbLd, jsonLdScript, organizationLd, pageTitle, type Crumb } from '../lib/seo';
import { getServizi } from '../lib/servizi';
@@ -126,18 +127,20 @@ const servizi = await getServizi();
height: auto !important;
max-height: none !important;
margin: 0 0 var(--space-4) !important;
padding: 0 !important;
padding: var(--space-2) var(--space-4) var(--space-4) !important;
border: 0 !important;
background: transparent !important;
border-radius: var(--radius-lg) !important;
}
}
</style>
</noscript>
</head>
<body>
<body id="inizio">
<a class="skip-link" href="#contenuto">
Vai al contenuto principale
</a>
<div class="scroll-progress" aria-hidden="true"></div>
<LogoDefs />
<Header servizi={servizi} />
<main id="contenuto" tabindex="-1">
<slot />
+19 -1
View File
@@ -1,7 +1,7 @@
/**
* Funzioni di formattazione condivise (indirizzi, orari, link telefonici e mappe).
*/
import type { Phone, PostalAddress } from '../data/studio';
import type { Phone, PostalAddress, Sede } from '../data/studio';
import { studio } from '../data/studio';
const NBSP = '\u00a0';
@@ -32,6 +32,11 @@ export function telHref(phone: Phone): string {
return `tel:${phone.e164}`;
}
/** Numero senza prefisso internazionale, per l'intestazione: «0141 951382». */
export function telNational(phone: Phone): string {
return phone.display.replace(/^\+39\s*/, '');
}
/** Numero da mostrare con spazi non separabili, così non va mai a capo. */
export function telText(phone: Phone | string): string {
return (typeof phone === 'string' ? phone : phone.display).replace(/ /g, '\u00a0');
@@ -47,6 +52,19 @@ export function hoursLine(): string {
return studio.orari.fasce.map((f) => `${short(f.apertura)} – ${short(f.chiusura)}`).join(' | ');
}
/**
* Testo della ricerca per indirizzo (indicazioni stradali, Google Maps, OpenStreetMap), ricavato
* dall'indirizzo: «Via XX Settembre 163, 14048 Montegrosso d'Asti AT, Italia».
*/
export function mapQuery(a: PostalAddress): string {
return `${a.streetAddress.replace(',', '')}, ${a.postalCode} ${a.locality.replace(/’/g, "'")} ${a.province}, Italia`;
}
/** Titolo dell'iframe della mappa: «Mappa Google della sede di Asti, Piazza Medici 4». */
export function mapTitle(sede: Sede): string {
return `Mappa Google della ${sede.nome.replace(/^Sede\b/, 'sede')}, ${sede.indirizzo.streetAddress.replace(',', '')}`;
}
/** Ricerca per indirizzo (le coordinate non sono verificate, brief §4.6). */
export function googleMapsUrl(query: string): string {
return `https://www.google.com/maps/search/?api=1&query=${encodeURIComponent(query)}`;
+13
View File
@@ -0,0 +1,13 @@
/**
* Tracciato della «G» del marchio, letto da src/assets/logo-mark.svg (generato da
* scripts/generate-icons.mjs). Ogni pagina lo definisce una sola volta (LogoDefs in
* BaseLayout) e i loghi lo richiamano con <use>: tre loghi per pagina (intestazione, menu
* mobile, footer) senza ripetere ~2 KB di tracciato (budget HTML+CSS di 120 KB).
*/
import markSvg from '../assets/logo-mark.svg?raw';
const match = /class="logo-mark__glyph" d="([^"]+)"/.exec(markSvg);
if (!match) throw new Error('src/assets/logo-mark.svg: tracciato «logo-mark__glyph» non trovato');
export const LOGO_GLYPH_PATH = match[1];
export const LOGO_GLYPH_ID = 'logo-glyph';
+1 -1
View File
@@ -68,7 +68,7 @@ export function organizationLd(site: URL) {
})),
openingHoursSpecification: studio.orari.fasce.map((f) => ({
'@type': 'OpeningHoursSpecification',
dayOfWeek: ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday'],
dayOfWeek: studio.orari.giorniSettimana,
opens: f.apertura,
closes: f.chiusura,
})),
+54 -17
View File
@@ -6,32 +6,62 @@ import BaseLayout from '../layouts/BaseLayout.astro';
---
<BaseLayout title={t.meta.titolo} description={t.meta.descrizione} noindex>
<section class="section notfound">
<div class="container">
<p class="eyebrow">Errore 404</p>
<h1>{t.titolo}</h1>
<p class="lead">{t.testo}</p>
<ul class="notfound__links">
{t.link.map((l) => (
<li>
<a class="btn btn--outline" href={l.href}>
<Icon name={l.icona} size={18} />
{l.label}
</a>
</li>
))}
</ul>
<section class="stage notfound">
<div class="stage__decor" aria-hidden="true"></div>
<div class="container notfound__inner">
<p class="notfound__code" aria-hidden="true">
404
</p>
<div>
<p class="eyebrow">Errore 404</p>
<h1>{t.titolo}</h1>
<p class="notfound__lead">{t.testo}</p>
<ul class="notfound__links">
{t.link.map((l) => (
<li>
<a class="btn btn--ghost-light" href={l.href}>
<Icon name={l.icona} size={18} />
{l.label}
</a>
</li>
))}
</ul>
</div>
</div>
</section>
</BaseLayout>
<style>
.notfound {
background: linear-gradient(180deg, var(--navy-050) 0%, var(--white) 100%);
margin-top: var(--stage-inset);
}
.notfound .lead {
.notfound__inner {
display: grid;
grid-template-columns: auto minmax(0, 1fr);
align-items: center;
gap: var(--space-8);
padding-block: clamp(4rem, 10vw, 8rem);
}
/* numero gigante, pieno di un gradiente oro (decorativo) */
.notfound__code {
margin: 0;
font-family: var(--font-display);
font-size: clamp(6rem, 4rem + 10vw, 14rem);
font-weight: 400;
line-height: 0.85;
letter-spacing: -0.06em;
background: var(--gold-gradient);
-webkit-background-clip: text;
background-clip: text;
color: transparent;
}
.notfound__lead {
max-width: 40rem;
font-size: var(--fs-lg);
color: var(--on-dark);
}
.notfound__links {
@@ -41,4 +71,11 @@ import BaseLayout from '../layouts/BaseLayout.astro';
margin-top: var(--space-5);
list-style: none;
}
@media (max-width: 60em) {
.notfound__inner {
grid-template-columns: minmax(0, 1fr);
gap: var(--space-4);
}
}
</style>
+54 -2
View File
@@ -19,11 +19,63 @@ const breadcrumbs = [
>
<PageHead title={t.titolo} subtitle={t.testo} breadcrumbs={breadcrumbs} />
<section class="section">
<div class="container">
<a class="btn btn--primary" href={t.link.href}>
<div class="container grazie">
<svg class="grazie__check" viewBox="0 0 52 52" width="52" height="52" aria-hidden="true">
<circle cx="26" cy="26" r="24"></circle>
<path d="M15 27l7 7 15-16"></path>
</svg>
<a class="btn btn--primary btn--lg" href={t.link.href}>
{t.link.label}
<Icon name="arrow-right" size={18} />
</a>
</div>
</section>
</BaseLayout>
<style>
.grazie {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: var(--space-5);
}
/* spunta che si disegna all'apertura della pagina */
.grazie__check {
flex: none;
width: 52px;
height: 52px;
fill: none;
stroke-width: 3;
stroke-linecap: round;
stroke-linejoin: round;
}
.grazie__check circle {
stroke: var(--success);
stroke-dasharray: 151;
}
.grazie__check path {
stroke: var(--success);
stroke-dasharray: 36;
}
@keyframes draw {
from {
stroke-dashoffset: var(--len);
}
}
@media (prefers-reduced-motion: no-preference) {
.grazie__check circle {
--len: 151;
animation: draw 700ms var(--ease-out) both;
}
.grazie__check path {
--len: 36;
animation: draw 450ms 500ms var(--ease-out) both;
}
}
</style>
+9 -6
View File
@@ -9,6 +9,7 @@ import SectionHead from '../../components/SectionHead.astro';
import { contattiPagina as t } from '../../data/pagine';
import { sedePrincipale } from '../../data/studio';
import BaseLayout from '../../layouts/BaseLayout.astro';
import { mapQuery, mapTitle } from '../../lib/format';
const breadcrumbs = [{ name: t.titolo, href: '/contatti/' }];
---
@@ -28,12 +29,14 @@ const breadcrumbs = [{ name: t.titolo, href: '/contatti/' }];
<section class="section section--paper" aria-labelledby="contatti-mappa">
<div class="container">
<SectionHead id="contatti-mappa" eyebrow={t.mappa.eyebrow} title={t.mappa.titolo} />
<MapConsent
embedUrl={sedePrincipale.mappa.embedUrl}
title={sedePrincipale.mappa.titolo}
query={sedePrincipale.ricercaMappa}
place={sedePrincipale.nome}
/>
<div class="contact-map">
<MapConsent
embedUrl={sedePrincipale.mappa.embedUrl}
title={mapTitle(sedePrincipale)}
query={mapQuery(sedePrincipale.indirizzo)}
place={sedePrincipale.nome}
/>
</div>
<p class="contact-more">
<a href="/dove-siamo/">
Tutte le sedi e le indicazioni stradali
+1 -1
View File
@@ -17,7 +17,7 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
<PageHead title={t.titolo} subtitle={t.sottotitolo} breadcrumbs={breadcrumbs} />
<section class="section" aria-label="Le sedi">
<div class="container grid grid--2 sedi">
<div class="container grid grid--2 sedi reveal-group">
{sedi.map((s) => (
<SedeCard sede={s} variant="full" headingLevel={2} />
))}
+31 -13
View File
@@ -1,9 +1,10 @@
---
/** Home (brief §7.1). */
/** Home (brief §7.1; rework grafico D-058). */
import BadgeAbilitazione from '../components/BadgeAbilitazione.astro';
import CtaBand from '../components/CtaBand.astro';
import Hero from '../components/Hero.astro';
import Icon from '../components/Icon.astro';
import Metodo from '../components/Metodo.astro';
import PartnerGrid from '../components/PartnerGrid.astro';
import PersonCard from '../components/PersonCard.astro';
import SectionHead from '../components/SectionHead.astro';
@@ -24,6 +25,12 @@ import { getServizi } from '../lib/servizi';
const servizi = await getServizi();
const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipale.id)];
const numeri = [
{ valore: servizi.length, etichetta: home.hero.numeri.servizi },
{ valore: abilitazioni.length, etichetta: home.hero.numeri.abilitazioni },
{ valore: studio.sedi.length, etichetta: home.hero.numeri.sedi },
{ valore: professionisti.length, etichetta: home.hero.numeri.professionisti },
];
---
<BaseLayout
@@ -31,7 +38,7 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
fullTitle={home.meta.titoloCompleto}
description={home.meta.descrizione}
>
<Hero {...home.hero} />
<Hero {...home.hero} numeri={numeri} />
<section class="section" aria-labelledby="home-servizi">
<div class="container">
@@ -40,18 +47,21 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
eyebrow={home.servizi.eyebrow}
title={home.servizi.titolo}
subtitle={home.servizi.sottotitolo}
layout="split"
/>
<div class="grid grid--3">
{servizi.map((s) => (
<ServiceCard servizio={s} />
<div class="bento reveal-group">
{servizi.map((s, i) => (
<ServiceCard servizio={s} index={i} featured={i === 0} />
))}
</div>
</div>
</section>
<section class="section section--paper" aria-labelledby="home-studio">
<Metodo />
<section class="section" aria-labelledby="home-studio">
<div class="container split">
<div class="prose">
<div class="prose reveal">
<p class="eyebrow">{home.studio.eyebrow}</p>
<h2 id="home-studio">{home.studio.titolo}</h2>
{home.studio.paragrafi.map((p) => (
@@ -67,7 +77,7 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
<Icon name="arrow-right" size={18} />
</a>
</div>
<div class="home-people">
<div class="home-people reveal-group">
{professionisti.map((p) => (
<PersonCard persona={p} variant="compact" />
))}
@@ -75,21 +85,24 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
</div>
</section>
<section class="section" aria-labelledby="home-abilitazioni">
<div class="container">
<section class="stage credenziali" aria-labelledby="home-abilitazioni">
<div class="stage__decor" aria-hidden="true"></div>
<div class="container section">
<SectionHead
id="home-abilitazioni"
eyebrow={home.abilitazioni.eyebrow}
title={home.abilitazioni.titolo}
subtitle={home.abilitazioni.sottotitolo}
layout="split"
/>
<ul class="grid grid--3 badges">
<ul class="grid grid--3 badges reveal-group">
{abilitazioni.map((a) => (
<BadgeAbilitazione
testo={a.testo}
professionista={nomeProfessionista(a.professionista)}
personaId={a.professionista}
icona={a.icona}
tone="dark"
/>
))}
</ul>
@@ -103,6 +116,7 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
eyebrow={home.partner.eyebrow}
title={home.partner.titolo}
subtitle={home.partner.sottotitolo}
layout="split"
/>
<PartnerGrid partner={partner} />
</div>
@@ -113,7 +127,7 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
<section class="section" aria-labelledby="home-sedi">
<div class="container">
<SectionHead id="home-sedi" eyebrow={home.sedi.eyebrow} title={home.sedi.titolo} />
<div class="grid grid--2">
<div class="grid grid--2 reveal-group">
{sedi.map((s) => (
<SedeCard sede={s} variant="compact" />
))}
@@ -131,7 +145,7 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
}
.home-values {
margin: var(--space-5) 0;
margin: var(--space-5) 0 var(--space-6);
}
.home-people {
@@ -143,6 +157,10 @@ const sedi = [sedePrincipale, ...studio.sedi.filter((s) => s.id !== sedePrincipa
list-style: none;
}
.credenziali .section {
padding-inline: 0;
}
@media (max-width: 60em) {
.split {
grid-template-columns: minmax(0, 1fr);
+30 -9
View File
@@ -17,7 +17,7 @@ const breadcrumbs = [{ name: t.titolo, href: '/link-utili/' }];
<section class="section" aria-label="Elenco dei link">
<div class="container">
<ul class="grid grid--2 links">
<ul class="grid grid--2 links reveal-group">
{links.map((l) => (
<li class="link-card">
<span class="link-card__icon">
@@ -50,30 +50,41 @@ const breadcrumbs = [{ name: t.titolo, href: '/link-utili/' }];
}
.link-card {
position: relative;
display: grid;
grid-template-columns: 44px minmax(0, 1fr);
grid-template-columns: 48px minmax(0, 1fr);
gap: var(--space-4);
align-items: start;
padding: var(--space-5);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-sm);
transition:
transform 260ms var(--ease-out),
box-shadow 260ms var(--ease-out),
border-color 260ms var(--ease-out);
}
.link-card:hover {
transform: translateY(-3px);
box-shadow: var(--shadow-md);
border-color: var(--gold-300);
}
.link-card__icon {
display: grid;
place-items: center;
width: 44px;
height: 44px;
border-radius: 10px;
background: var(--navy-050);
color: var(--navy-700);
width: 48px;
height: 48px;
border-radius: 50%;
background: var(--navy-800);
color: var(--gold-300);
}
.link-card h2 {
margin: 0.1rem 0 0.35rem;
font-size: 1.2rem;
font-size: 1.25rem;
}
.link-card p {
@@ -93,6 +104,16 @@ const breadcrumbs = [{ name: t.titolo, href: '/link-utili/' }];
overflow-wrap: anywhere;
}
.link-card a :global(svg) {
flex: none;
color: var(--gold-700);
transition: transform var(--dur) var(--ease);
}
.link-card:hover a :global(svg) {
transform: translate(2px, -2px);
}
.links__note {
margin: var(--space-6) 0 0;
font-size: var(--fs-sm);
+107 -29
View File
@@ -5,6 +5,7 @@
* successivo.
*/
import type { GetStaticPaths } from 'astro';
import { siteUrl } from '../../../site.config.mjs';
import CtaBand from '../../components/CtaBand.astro';
import Icon from '../../components/Icon.astro';
import PageHead from '../../components/PageHead.astro';
@@ -15,6 +16,7 @@ import { externalLinksNoopener } from '../../lib/html';
import { telHref, telText } from '../../lib/format';
import { serviceLd } from '../../lib/seo';
import { getServizi, servizioHref, type Servizio } from '../../lib/servizi';
import '../../styles/checklist.css';
export const getStaticPaths = (async () => {
const servizi = await getServizi();
@@ -43,7 +45,7 @@ const breadcrumbs = [
{ name: 'Servizi', href: '/servizi/' },
{ name: d.titolo, href: path },
];
const site = Astro.site ?? new URL('https://www.grassoezio.it');
const site = Astro.site ?? new URL(siteUrl());
const contentHtml = externalLinksNoopener(servizio.rendered?.html ?? '', site.host);
const jsonLd = [serviceLd(site, { name: d.titolo, description: d.descrizioneSeo, path })];
const telefono = studio.telefoni[0];
@@ -72,13 +74,15 @@ const nextWords = words(next.data.titolo);
{servizi.map((s) => (
<li>
<a href={servizioHref(s)} aria-current={s.id === servizio.id ? 'page' : undefined}>
<Icon name={s.data.icona} size={18} />
{s.data.titolo}
</a>
</li>
))}
</ul>
</nav>
<div class="sidenav__cta">
<div class="sidenav__cta stage">
<div class="stage__decor" aria-hidden="true"></div>
<p class="sidenav__cta-title">{ctaSidebar.titolo}</p>
<p>{ctaSidebar.testo}</p>
<a class="btn btn--gold btn--sm" href={ctaSidebar.pulsante.href}>
@@ -97,7 +101,7 @@ const nextWords = words(next.data.titolo);
<Fragment set:html={contentHtml} />
<nav class="pager" aria-label="Servizio precedente e successivo">
<a href={servizioHref(prev)} rel="prev">
<a class="reveal" href={servizioHref(prev)} rel="prev">
<span class="pager__label">Precedente</span>
<span class="pager__title">
<span class="pager__nowrap">
@@ -107,7 +111,7 @@ const nextWords = words(next.data.titolo);
{prevWords.slice(1).join(' ')}
</span>
</a>
<a href={servizioHref(next)} rel="next">
<a class="reveal" href={servizioHref(next)} rel="next">
<span class="pager__label">Successivo</span>
<span class="pager__title">
{nextWords.slice(0, -1).join(' ')}
@@ -128,23 +132,30 @@ const nextWords = words(next.data.titolo);
<style>
.layout {
display: grid;
grid-template-columns: 17.5rem minmax(0, 1fr);
grid-template-columns: 18.5rem minmax(0, 1fr);
gap: var(--space-8);
align-items: start;
}
.sidenav {
position: sticky;
top: calc(var(--header-h) + 1.5rem);
display: grid;
gap: var(--space-4);
}
/* ferma durante lo scorrimento solo se ci sta tutta (invito e telefono compresi) */
@media (min-width: 60.01em) and (min-height: 50em) {
.sidenav {
position: sticky;
top: calc(var(--header-h) + 1.5rem);
}
}
.sidenav__box {
padding: var(--space-3);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-sm);
}
.sidenav__box ul {
@@ -163,14 +174,25 @@ const nextWords = words(next.data.titolo);
.sidenav__box a {
display: flex;
align-items: center;
gap: 0.7rem;
min-height: var(--tap);
padding: 0.5rem 0.75rem;
border-radius: var(--radius-sm);
padding: 0.55rem 0.75rem;
border-radius: var(--radius-md);
color: var(--ink-700);
font-size: var(--fs-sm);
font-weight: 500;
line-height: 1.35;
text-decoration: none;
transition:
background-color var(--dur) var(--ease),
color var(--dur) var(--ease);
}
.sidenav__box a :global(svg) {
flex: none;
width: 18px;
height: 18px;
color: var(--gold-700);
}
.sidenav__box a:hover {
@@ -183,14 +205,17 @@ const nextWords = words(next.data.titolo);
color: var(--white);
}
.sidenav__box a[aria-current='page'] :global(svg) {
color: var(--gold-300);
}
.sidenav__cta {
display: grid;
gap: var(--space-3);
justify-items: start;
margin: 0;
padding: var(--space-5);
border-radius: var(--radius-md);
background: var(--navy-800);
color: var(--white);
border-radius: var(--radius-lg);
}
.sidenav__cta p {
@@ -201,9 +226,9 @@ const nextWords = words(next.data.titolo);
.sidenav__cta .sidenav__cta-title {
font-family: var(--font-display);
font-size: 1.2rem;
font-size: 1.3rem;
font-weight: 500;
line-height: 1.3;
line-height: 1.25;
color: var(--white);
}
@@ -230,13 +255,32 @@ const nextWords = words(next.data.titolo);
color: var(--gold-300);
}
/* gruppi del servizio numerati (titoli ## del Markdown) */
.content {
counter-reset: gruppo;
}
.content :global(h2) {
font-size: 1.6rem;
margin-top: var(--space-6);
padding-top: var(--space-5);
display: flex;
align-items: baseline;
gap: var(--space-4);
font-size: clamp(1.5rem, 1.25rem + 0.9vw, 2rem);
margin-top: var(--space-7);
padding-top: var(--space-6);
border-top: 1px solid var(--line);
}
.content :global(h2)::before {
counter-increment: gruppo;
content: counter(gruppo, decimal-leading-zero);
content: counter(gruppo, decimal-leading-zero) / '';
flex: none;
font-size: 0.9rem;
font-weight: 600;
letter-spacing: 0.08em;
color: var(--gold-700);
}
.content :global(h2:first-child) {
margin-top: 0;
padding-top: 0;
@@ -253,20 +297,54 @@ const nextWords = words(next.data.titolo);
color: var(--ink-700);
}
/* voci della checklist come piccole schede */
.content :global(ul li) {
padding: 0.8rem 1rem 0.8rem 2.75rem;
border: 1px solid var(--line);
border-radius: var(--radius-md);
background: var(--white);
transition:
border-color var(--dur) var(--ease),
box-shadow var(--dur) var(--ease);
}
.content :global(ul li:hover) {
border-color: var(--gold-300);
box-shadow: var(--shadow-sm);
}
.content :global(ul li)::before {
left: 1rem;
top: 0.95rem;
}
.pager {
display: flex;
justify-content: space-between;
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: var(--space-4);
margin-top: var(--space-7);
padding-top: var(--space-5);
border-top: 1px solid var(--line);
}
.pager a {
display: grid;
gap: 0.2rem;
align-content: start;
gap: 0.35rem;
min-height: var(--tap);
padding: var(--space-5);
border: 1px solid var(--line);
border-radius: var(--radius-lg);
background: var(--white);
text-decoration: none;
transition:
border-color 260ms var(--ease-out),
box-shadow 260ms var(--ease-out),
transform 260ms var(--ease-out);
}
.pager a:hover {
border-color: var(--gold-300);
box-shadow: var(--shadow-md);
transform: translateY(-3px);
}
.pager a:last-child {
@@ -282,7 +360,10 @@ const nextWords = words(next.data.titolo);
}
.pager__title {
font-family: var(--font-display);
font-size: 1.2rem;
font-weight: 600;
line-height: 1.3;
color: var(--navy-900);
}
@@ -293,11 +374,8 @@ const nextWords = words(next.data.titolo);
/* tra freccia e parola basta lo spazio del testo */
.pager__nowrap :global(svg) {
display: inline-block;
vertical-align: -0.2em;
}
.pager a:hover .pager__title {
text-decoration: underline;
vertical-align: -0.15em;
color: var(--gold-700);
}
@media (max-width: 60em) {
@@ -319,7 +397,7 @@ const nextWords = words(next.data.titolo);
@media (max-width: 40em) {
.pager {
flex-direction: column;
grid-template-columns: minmax(0, 1fr);
}
.pager a:last-child {
+19 -8
View File
@@ -4,6 +4,7 @@
* link /servizi#… atterrano sulla card giusta; con JavaScript si passa alla pagina di dettaglio.
*/
import CtaBand from '../../components/CtaBand.astro';
import Metodo from '../../components/Metodo.astro';
import PageHead from '../../components/PageHead.astro';
import ServiceCard from '../../components/ServiceCard.astro';
import { serviziPagina as t } from '../../data/pagine';
@@ -19,17 +20,27 @@ const breadcrumbs = [{ name: 'Servizi', href: '/servizi/' }];
<section class="section" aria-label="Elenco dei servizi">
<div class="container">
<div class="grid grid--3">
{servizi.map((s) => (
<ServiceCard servizio={s} id={s.data.anchorLegacy} legacy headingLevel={2} />
<div class="bento reveal-group">
{servizi.map((s, i) => (
<ServiceCard
servizio={s}
id={s.data.anchorLegacy}
legacy
headingLevel={2}
index={i}
featured={i === 0}
/>
))}
</div>
</div>
</section>
<CtaBand />
</BaseLayout>
<Metodo />
<script>
import '../../scripts/legacy-anchors';
</script>
<CtaBand />
{/* dentro il layout: scritto dopo </BaseLayout> finirebbe dopo </html> (HTML non valido) */}
<script>
import '../../scripts/legacy-anchors';
</script>
</BaseLayout>
+88 -18
View File
@@ -18,6 +18,7 @@ import {
valori,
} from '../data/studio';
import BaseLayout from '../layouts/BaseLayout.astro';
import '../styles/checklist.css';
const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
---
@@ -27,14 +28,14 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
<section class="section" aria-labelledby="studio-chi-siamo">
<div class="container studio-intro">
<div class="prose">
<div class="prose reveal">
<p class="eyebrow">{t.chiSiamo.eyebrow}</p>
<h2 id="studio-chi-siamo">{t.chiSiamo.titolo}</h2>
{t.chiSiamo.paragrafi.map((p) => (
<p>{p}</p>
))}
</div>
<div class="studio-intro__visual" aria-hidden="true">
<div class="studio-intro__visual reveal" aria-hidden="true">
<Illustrazione width={560} height={420} />
</div>
</div>
@@ -43,11 +44,16 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
<section class="section section--paper" aria-labelledby="studio-valori">
<div class="container">
<SectionHead id="studio-valori" eyebrow={t.valori.eyebrow} title={t.valori.titolo} />
<ul class="grid grid--4 values">
{valori.map((v) => (
<ul class="grid grid--4 values reveal-group">
{valori.map((v, i) => (
<li class="value">
<span class="value__icon">
<Icon name={v.icona} size={22} />
<span class="value__top">
<span class="value__icon">
<Icon name={v.icona} size={22} />
</span>
<span class="value__num" aria-hidden="true">
{String(i + 1).padStart(2, '0')}
</span>
</span>
<h3>{v.nome}</h3>
<p>{v.descrizione}</p>
@@ -64,7 +70,7 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
eyebrow={t.professionisti.eyebrow}
title={t.professionisti.titolo}
/>
<div class="grid grid--2 people">
<div class="grid grid--2 people reveal-group">
{professionisti.map((p) => (
<PersonCard persona={p} variant="full" />
))}
@@ -72,21 +78,24 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
</div>
</section>
<section class="section section--tint" aria-labelledby="studio-abilitazioni">
<div class="container">
<section class="stage" aria-labelledby="studio-abilitazioni">
<div class="stage__decor" aria-hidden="true"></div>
<div class="container section">
<SectionHead
id="studio-abilitazioni"
eyebrow={t.abilitazioni.eyebrow}
title={t.abilitazioni.titolo}
subtitle={t.abilitazioni.sottotitolo}
layout="split"
/>
<ul class="grid grid--3 badges">
<ul class="grid grid--3 badges reveal-group">
{abilitazioni.map((a) => (
<BadgeAbilitazione
testo={a.testo}
professionista={nomeProfessionista(a.professionista)}
personaId={a.professionista}
icona={a.icona}
tone="dark"
/>
))}
</ul>
@@ -100,9 +109,10 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
eyebrow={t.partner.eyebrow}
title={t.partner.titolo}
subtitle={t.partner.sottotitolo}
layout="split"
/>
<PartnerGrid partner={partner} />
<div class="collab">
<div class="collab reveal">
<h3>{t.partner.collaborazioniTitolo}</h3>
<p>{t.partner.collaborazioniTesto}</p>
<ul class="checklist">
@@ -125,7 +135,29 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
align-items: center;
}
/* illustrazione in una cornice tinta, con un anello oro sfalsato */
.studio-intro__visual {
position: relative;
overflow: hidden;
padding: var(--space-6);
border-radius: var(--radius-xl);
background: var(--navy-050);
}
.studio-intro__visual::before {
content: '';
position: absolute;
width: 11rem;
height: 11rem;
right: -3.5rem;
top: -3.5rem;
border-radius: 50%;
border: 10px solid var(--gold-300);
opacity: 0.55;
}
.studio-intro__visual :global(svg) {
position: relative;
width: 100%;
height: auto;
}
@@ -141,15 +173,30 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
padding: var(--space-5);
background: var(--white);
border: 1px solid var(--line);
border-radius: var(--radius-md);
border-radius: var(--radius-lg);
transition:
transform 260ms var(--ease-out),
box-shadow 260ms var(--ease-out);
}
.value:hover {
transform: translateY(-3px);
box-shadow: var(--shadow-md);
}
.value__top {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: var(--space-3);
}
.value__icon {
display: grid;
place-items: center;
width: 44px;
height: 44px;
border-radius: 10px;
width: 48px;
height: 48px;
border-radius: 50%;
background: var(--gold-100);
color: var(--gold-700);
}
@@ -159,9 +206,20 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
height: 22px;
}
.value__num {
font-family: var(--font-display);
font-size: 1.75rem;
line-height: 1;
letter-spacing: -0.03em;
background: var(--gold-gradient);
-webkit-background-clip: text;
background-clip: text;
color: transparent;
}
.value h3 {
margin: var(--space-2) 0 0;
font-size: 1.15rem;
margin: 0;
font-size: 1.2rem;
}
.value p {
@@ -176,7 +234,9 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
.collab {
margin-top: var(--space-7);
max-width: 56rem;
padding: var(--space-6);
border-radius: var(--radius-lg);
background: var(--paper);
}
.collab h3 {
@@ -187,6 +247,10 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
color: var(--ink-700);
}
.collab .checklist {
margin-bottom: 0;
}
@media (max-width: 60em) {
.studio-intro {
grid-template-columns: minmax(0, 1fr);
@@ -197,4 +261,10 @@ const breadcrumbs = [{ name: t.titolo, href: '/studio/' }];
max-width: 32rem;
}
}
@media (max-width: 40em) {
.collab {
padding: var(--space-5);
}
}
</style>
+26 -8
View File
@@ -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<HTMLInputElement>('[data-form-ts]');
if (ts) ts.value = String(loadedAt);
const tsInvio = form.querySelector<HTMLInputElement>('[data-form-ts-invio]');
const summary = form.querySelector<HTMLElement>('[data-form-summary]');
const summaryList = form.querySelector<HTMLElement>('[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;
});
}
+64
View File
@@ -0,0 +1,64 @@
/**
* Indice delle pagine «documento» (LegalDocument): evidenzia con aria-current la voce della
* sezione che si sta leggendo, cioè l'ultima il cui titolo ha superato il primo terzo della
* finestra; a fondo pagina la voce scelta dall'indice, se visibile, altrimenti l'ultima (le
* ultime sezioni possono essere troppo corte per arrivare in alto). Miglioramento
* progressivo: senza JavaScript l'indice funziona come elenco di link.
*/
function initToc(): void {
const links = Array.from(document.querySelectorAll<HTMLAnchorElement>('[data-toc] a[href^="#"]'));
const entries = links
.map((link) => ({
link,
heading: document.getElementById(decodeURIComponent(link.hash.slice(1))),
}))
.filter((e): e is { link: HTMLAnchorElement; heading: HTMLElement } => e.heading !== null);
if (entries.length === 0) return;
let current: HTMLAnchorElement | null = null;
const update = () => {
const line = window.innerHeight * 0.35;
const root = document.documentElement;
const atBottom = window.scrollY + window.innerHeight >= root.scrollHeight - 2;
let active: HTMLAnchorElement | null = null;
if (atBottom && window.scrollY > 0) {
// in fondo vince la sezione scelta dall'indice, se il suo titolo è visibile
const chosen = entries.find((e) => e.link.hash === window.location.hash);
const top = chosen?.heading.getBoundingClientRect().top;
active =
chosen && top !== undefined && top >= 0 && top < window.innerHeight
? chosen.link
: entries[entries.length - 1].link;
} else {
for (const { link, heading } of entries) {
if (heading.getBoundingClientRect().top <= line) active = link;
}
}
if (active === current) return;
current?.removeAttribute('aria-current');
active?.setAttribute('aria-current', 'location');
current = active;
};
// scorrimento e ridimensionamento, al più un ricalcolo per fotogramma (salti con Home,
// «Torna su» o scorrimenti veloci non passerebbero da un IntersectionObserver)
let queued = false;
const schedule = () => {
if (queued) return;
queued = true;
requestAnimationFrame(() => {
queued = false;
update();
});
};
window.addEventListener('scroll', schedule, { passive: true });
window.addEventListener('resize', schedule, { passive: true });
// un clic sull'indice con la pagina già in fondo non produce eventi di scorrimento
window.addEventListener('hashchange', schedule);
update();
}
initToc();
export {};
+44
View File
@@ -0,0 +1,44 @@
/* Studio Grasso — checklist con icona: elenchi dei servizi (Markdown, .content) e delle
collaborazioni (pagina Lo studio). Importato solo dalle pagine che la usano. */
.checklist,
.content ul {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 0.6rem var(--space-5);
margin: var(--space-4) 0 var(--space-5);
padding: 0;
list-style: none;
}
.checklist li,
.content ul li {
position: relative;
padding-left: 1.75rem;
font-size: var(--fs-sm);
color: var(--ink-700);
line-height: 1.55;
}
.checklist li::before,
.content ul li::before {
content: '';
position: absolute;
left: 0;
top: 0.12em;
width: 1.15rem;
height: 1.15rem;
background-color: var(--gold-700);
/* icona Lucide «circle-check» */
-webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='10'/%3E%3Cpath d='m9 12 2 2 4-4'/%3E%3C/svg%3E")
center / contain no-repeat;
mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='10'/%3E%3Cpath d='m9 12 2 2 4-4'/%3E%3C/svg%3E")
center / contain no-repeat;
}
@media (max-width: 40em) {
.checklist,
.content ul {
grid-template-columns: minmax(0, 1fr);
}
}
+44
View File
@@ -0,0 +1,44 @@
/* Studio Grasso — pagine «documento» (privacy, cookie, note legali, accessibilità).
Importato da LegalDocument.astro. */
.doc {
max-width: var(--measure);
}
.doc h2 {
font-size: clamp(1.4rem, 1.2rem + 0.8vw, 1.75rem);
margin-top: var(--space-7);
padding-top: var(--space-5);
border-top: 1px solid var(--line);
}
.doc h2:first-child {
margin-top: 0;
padding-top: 0;
border-top: 0;
}
.doc h3 {
font-size: 1.15rem;
margin-top: var(--space-6);
}
.doc p,
.doc li,
.doc dd {
color: var(--ink-700);
}
.doc ul,
.doc ol {
padding-left: 1.4rem;
margin: 0 0 var(--space-4);
}
.doc li + li {
margin-top: 0.35rem;
}
.doc a {
overflow-wrap: anywhere;
}
+240 -88
View File
@@ -1,5 +1,5 @@
/* ==========================================================================
Studio Grasso — stili globali: reset, tipografia, layout, bottoni, utilità.
Studio Grasso — stili globali: reset, tipografia, layout, palchi scuri, bottoni, movimento.
Gli stili dei singoli componenti stanno nei rispettivi file .astro.
========================================================================== */
@@ -15,6 +15,7 @@ html {
text-size-adjust: 100%;
scroll-behavior: smooth;
scroll-padding-top: calc(var(--header-h) + 1rem);
accent-color: var(--navy-800);
}
body {
@@ -69,19 +70,22 @@ h4 {
font-weight: 600;
line-height: var(--lh-tight);
margin: 0 0 var(--space-4);
letter-spacing: -0.01em;
letter-spacing: -0.015em;
color: var(--navy-900);
text-wrap: balance;
overflow-wrap: break-word;
}
h1 {
font-size: var(--fs-h1);
font-weight: 500;
letter-spacing: -0.025em;
}
h2 {
font-size: var(--fs-h2);
font-weight: 500;
letter-spacing: -0.02em;
}
h3 {
@@ -90,6 +94,7 @@ h3 {
p {
margin: 0 0 var(--space-4);
text-wrap: pretty;
}
ul,
@@ -121,7 +126,7 @@ button {
}
:focus-visible {
outline: 3px solid var(--gold-500);
outline: 3px solid var(--focus-ring);
outline-offset: 3px;
border-radius: 4px;
}
@@ -223,6 +228,127 @@ button {
}
}
/* --- griglia «bento» dei servizi (home e /servizi/) ---
La prima card (in evidenza) occupa due righe; l'ultima, se resterebbe sola nella riga,
la occupa tutta (6 servizi: 1 grande + 4 + 1 larga). */
.bento {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
gap: var(--space-4);
}
.bento > :first-child {
grid-row: span 2;
}
.bento > :last-child:nth-child(3n) {
grid-column: 1 / -1;
}
@media (max-width: 60em) {
.bento {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
.bento > :first-child {
grid-row: auto;
grid-column: 1 / -1;
}
.bento > :last-child:nth-child(3n) {
grid-column: auto;
}
.bento > :last-child:nth-child(even) {
grid-column: 1 / -1;
}
}
@media (max-width: 40em) {
.bento {
grid-template-columns: minmax(0, 1fr);
}
.bento > :first-child,
.bento > :last-child:nth-child(even) {
grid-column: auto;
}
}
/* --- palchi scuri (hero, testate, credenziali, banda CTA) ---
Fondo pieno sul contenitore (i controlli automatici del contrasto del focus leggono il fondo
degli antenati); trama e bagliori stanno in un livello decorativo a parte (.stage__decor). */
.stage {
--focus-ring: var(--gold-300);
position: relative;
isolation: isolate;
overflow: hidden;
margin-inline: var(--stage-inset);
border-radius: var(--radius-xl);
background-color: var(--navy-950);
color: var(--on-dark);
}
.stage h1,
.stage h2,
.stage h3 {
color: var(--white);
}
.stage .eyebrow {
color: var(--gold-300);
}
.stage .eyebrow::before {
background: var(--gold-300);
}
.stage__decor {
position: absolute;
inset: 0;
z-index: -1;
overflow: hidden;
pointer-events: none;
}
/* clip dove esiste: un contenitore «hidden» è un contenitore di scorrimento, e le timeline
view() dei figli seguirebbero lui, fermo, invece della pagina. In un blocco a parte perché
il minificatore fonderebbe «hidden; clip» nel solo clip, che Safari/iOS 15 non conoscono. */
@supports (overflow: clip) {
.stage,
.stage__decor {
overflow: clip;
}
}
/* l'ultimo palco della pagina (banda CTA, 404) si stacca dal footer come due palchi tra loro */
main > section.stage:last-of-type {
margin-bottom: var(--stage-inset);
}
/* trama a griglia sfumata verso i bordi */
.stage__decor::before {
content: '';
position: absolute;
inset: 0;
background-image:
linear-gradient(rgba(255, 255, 255, 0.055) 1px, transparent 1px),
linear-gradient(90deg, rgba(255, 255, 255, 0.055) 1px, transparent 1px);
background-size: 56px 56px;
-webkit-mask-image: radial-gradient(120% 90% at 70% 0%, #000 0%, transparent 70%);
mask-image: radial-gradient(120% 90% at 70% 0%, #000 0%, transparent 70%);
}
/* bagliori: oro in alto a destra, blu in basso a sinistra */
.stage__decor::after {
content: '';
position: absolute;
inset: -20%;
background:
radial-gradient(38% 42% at 82% 18%, rgba(184, 144, 46, 0.26), transparent 70%),
radial-gradient(45% 50% at 8% 95%, rgba(31, 75, 116, 0.55), transparent 70%);
}
.eyebrow {
display: inline-flex;
align-items: center;
@@ -252,8 +378,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);
}
@@ -262,7 +389,7 @@ button {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
gap: 0.55rem;
min-height: var(--tap);
padding: 0.75rem 1.4rem;
border-radius: var(--radius-pill);
@@ -277,6 +404,7 @@ button {
background-color var(--dur) var(--ease),
color var(--dur) var(--ease),
border-color var(--dur) var(--ease),
box-shadow var(--dur) var(--ease),
transform var(--dur) var(--ease);
}
@@ -284,27 +412,39 @@ button {
flex: none;
width: 1.1em;
height: 1.1em;
transition: transform var(--dur) var(--ease);
}
.btn:hover {
transform: translateY(-1px);
}
.btn:hover svg:last-child:not(:first-child) {
transform: translateX(3px);
}
.btn--primary {
background: var(--navy-800);
color: var(--white);
box-shadow: 0 10px 24px -14px rgba(15, 42, 68, 0.9);
}
.btn--primary:hover {
background: var(--navy-900);
color: var(--white);
transform: translateY(-1px);
box-shadow: 0 16px 30px -14px rgba(15, 42, 68, 0.9);
}
.btn--gold {
background: var(--gold-500);
color: var(--navy-900);
background: var(--gold-300);
color: var(--navy-950);
box-shadow: 0 12px 30px -14px rgba(227, 200, 120, 0.8);
}
.btn--gold:hover {
background: var(--gold-300);
color: var(--navy-900);
background: #edd794;
color: var(--navy-950);
box-shadow: 0 18px 36px -14px rgba(227, 200, 120, 0.9);
}
.btn--outline {
@@ -319,14 +459,21 @@ button {
}
.btn--ghost-light {
background: transparent;
background: rgba(255, 255, 255, 0.04);
color: var(--white);
border-color: rgba(255, 255, 255, 0.55);
border-color: rgba(255, 255, 255, 0.5);
}
.btn--ghost-light:hover {
background: rgba(255, 255, 255, 0.1);
background: rgba(255, 255, 255, 0.12);
color: var(--white);
border-color: var(--white);
}
.btn--lg {
min-height: 3.25rem;
padding: 0.9rem 1.6rem;
font-size: var(--fs-md);
}
.btn--sm {
@@ -350,7 +497,7 @@ button {
display: inline-flex;
align-items: center;
gap: 0.35rem;
padding: 0.35rem 0.8rem;
padding: 0.4rem 0.9rem;
border-radius: var(--radius-pill);
background: var(--gold-100);
color: var(--gold-800);
@@ -359,93 +506,98 @@ button {
letter-spacing: 0.02em;
}
/* --- checklist (elenchi di servizi, anche da Markdown) --- */
.checklist,
.content ul {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 0.6rem var(--space-5);
margin: var(--space-4) 0 var(--space-5);
padding: 0;
list-style: none;
}
.checklist li,
.content ul li {
position: relative;
padding-left: 1.75rem;
font-size: var(--fs-sm);
color: var(--ink-700);
line-height: 1.55;
}
.checklist li::before,
.content ul li::before {
content: '';
position: absolute;
left: 0;
top: 0.12em;
width: 1.15rem;
height: 1.15rem;
background-color: var(--gold-700);
/* icona Lucide «circle-check» */
-webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='10'/%3E%3Cpath d='m9 12 2 2 4-4'/%3E%3C/svg%3E")
center / contain no-repeat;
mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='10'/%3E%3Cpath d='m9 12 2 2 4-4'/%3E%3C/svg%3E")
center / contain no-repeat;
}
@media (max-width: 40em) {
.checklist,
.content ul {
grid-template-columns: minmax(0, 1fr);
/* --- movimento ---
Solo CSS e solo come miglioramento: animazioni legate allo scorrimento (scroll-driven
animations) dove il browser le supporta e l'utente non chiede di ridurre il movimento.
Senza supporto, o con «riduci movimento», i contenuti sono semplicemente fermi e visibili. */
/* niente opacità: l'animazione segue lo scorrimento, e un blocco fermo sul bordo inferiore
della finestra resterebbe semitrasparente, con il testo sotto il contrasto AA */
@keyframes reveal {
from {
translate: 0 3rem;
scale: 0.97;
}
}
/* --- documenti (pagine legali, accessibilità) --- */
.doc {
max-width: var(--measure);
@keyframes rise {
from {
opacity: 0;
translate: 0 1rem;
}
}
.doc h2 {
font-size: clamp(1.4rem, 1.2rem + 0.8vw, 1.75rem);
margin-top: var(--space-7);
padding-top: var(--space-5);
border-top: 1px solid var(--line);
@keyframes grow-x {
from {
scale: 0 1;
}
to {
scale: 1 1;
}
}
.doc h2:first-child {
margin-top: 0;
padding-top: 0;
border-top: 0;
@keyframes fade-out {
to {
opacity: 0;
}
}
.doc h3 {
font-size: 1.15rem;
margin-top: var(--space-6);
/* barra di avanzamento della lettura (BaseLayout) */
.scroll-progress {
display: none;
}
.doc p,
.doc li,
.doc dd {
color: var(--ink-700);
@media (prefers-reduced-motion: no-preference) {
@view-transition {
navigation: auto;
}
::view-transition-old(root) {
animation: fade-out 160ms var(--ease) both;
}
::view-transition-new(root) {
animation: rise 380ms var(--ease-out) both;
}
/* la barra non segue lo spostamento tra le due posizioni (la barra superiore visibile o no):
resta nella posizione della pagina nuova e passa con una dissolvenza */
::view-transition-group(site-header) {
animation: none;
}
@supports (animation-timeline: view()) {
.reveal,
.reveal-group > * {
animation: reveal var(--ease-out) both;
animation-timeline: view();
animation-range: entry 0% entry 85%;
}
.reveal-group > :nth-child(3n + 2) {
animation-range: entry 6% entry 95%;
}
.reveal-group > :nth-child(3n + 3) {
animation-range: entry 12% cover 40%;
}
.scroll-progress {
display: block;
position: fixed;
inset: 0 0 auto;
z-index: 120;
height: 3px;
background: var(--gold-gradient);
transform-origin: 0 50%;
scale: 0 1;
pointer-events: none;
animation: grow-x linear both;
animation-timeline: scroll(root block);
}
}
}
.doc ul,
.doc ol {
padding-left: 1.4rem;
margin: 0 0 var(--space-4);
}
.doc li + li {
margin-top: 0.35rem;
}
.doc a {
overflow-wrap: anywhere;
}
/* --- movimento ridotto --- */
@media (prefers-reduced-motion: reduce) {
html {
scroll-behavior: auto;
+36 -2
View File
@@ -23,8 +23,7 @@
.mobile-menu,
.skip-link,
.cta-band,
.map-consent__actions,
.map-consent__frame,
.map-consent,
.sidenav,
.pager,
.hero__visual,
@@ -55,6 +54,41 @@
color: #000 !important;
}
/* palchi e card in evidenza: i fondi scuri non si stampano, il testo bianco sparirebbe */
.stage,
.stage *,
.card--featured,
.card--featured * {
color: #000 !important;
background: none !important;
}
.stage,
.site-footer {
margin: 0 !important;
border-radius: 0 !important;
}
/* decorazioni e numeri in gradiente (il testo trasparente senza fondo non si vede) */
.stage__decor,
.page-head__decor,
.footer__wordmark,
.footer__top,
.scroll-progress,
.card__num,
.card__arrow,
.value__num {
display: none !important;
}
/* nessuno stato di animazione nella pagina stampata */
*,
*::before,
*::after {
animation: none !important;
transition: none !important;
}
h1,
h2,
h3 {
+26 -11
View File
@@ -1,11 +1,13 @@
/* ==========================================================================
Studio Grasso — token del design system (brief §6.2, Appendice B)
Palette: navy (fiducia) + oro brunito (accento) + carta calda (sfondi)
Studio Grasso — token del design system (brief §6.2, Appendice B; rework grafico D-058)
Palette: navy (fiducia) + oro brunito (accento) + carta calda (sfondi); «palchi» navy
profondi (--navy-950) per hero, testate, credenziali, banda CTA e footer.
Tipografia: Fraunces (titoli) + Inter (testo), entrambi self-hosted
========================================================================== */
:root {
/* --- colori --- */
--navy-950: #071423; /* palchi scuri: hero, testate, banda CTA, footer */
--navy-900: #0b1f33;
--navy-800: #0f2a44;
--navy-700: #163a5c;
@@ -15,7 +17,7 @@
--gold-800: #806219; /* testo su fondo gold-100 (chip): contrasto 4.98:1 */
--gold-700: #8a6a1e; /* accento su testo: contrasto AA su bianco e su carta */
--gold-500: #b8902e; /* solo decorativo o su fondo navy, mai come testo su chiaro */
--gold-300: #e3c878;
--gold-300: #e3c878; /* testo e anello di focus sui palchi scuri (≥ 10:1 su navy-950) */
--gold-100: #f7efd9;
--paper: #f6f3ec;
--white: #ffffff;
@@ -24,6 +26,7 @@
--ink-600: #4f5b66;
--ink-400: #8a949e; /* solo elementi decorativi: contrasto insufficiente per il testo */
--line: #dde3ea;
--line-dark: rgba(255, 255, 255, 0.12);
--success: #1e7b4f;
--error: #b42318;
@@ -31,6 +34,14 @@
--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 (palchi .stage, barra superiore, menu mobile, footer) lo ridefiniscono
a gold-300 (≥ 10:1 su navy-950), perché gold-700 sul navy arriva solo a 2,9:1 */
--focus-ring: var(--gold-700);
/* accento in gradiente (solo decorativo: linee, numeri grandi, bordi) */
--gold-gradient: linear-gradient(115deg, #f1dc9c 0%, #e3c878 30%, #b8902e 100%);
/* --- tipografia --- */
--font-display: 'Fraunces', Georgia, 'Times New Roman', serif;
--font-body:
@@ -40,9 +51,9 @@
--fs-md: 1.0625rem;
--fs-lg: 1.1875rem;
--fs-h3: 1.3125rem;
--fs-h2: clamp(1.75rem, 1.3rem + 1.6vw, 2.5rem);
--fs-h1: clamp(2.25rem, 1.4rem + 2.6vw, 3.5rem);
--lh-tight: 1.15;
--fs-h2: clamp(1.9rem, 1.3rem + 2.1vw, 3rem);
--fs-h1: clamp(2.25rem, 1.3rem + 3.1vw, 4rem);
--lh-tight: 1.1;
--lh-body: 1.65;
--measure: 68ch;
@@ -56,23 +67,27 @@
--space-7: 3rem;
--space-8: 4rem;
--space-9: 6rem;
--section-pad: clamp(3.5rem, 7vw, 6rem);
--section-pad: clamp(4rem, 8vw, 7rem);
/* --- forme --- */
--radius-sm: 8px;
--radius-md: 12px;
--radius-lg: 20px;
--radius-md: 14px;
--radius-lg: 22px;
--radius-xl: clamp(20px, 2.4vw, 32px);
--radius-pill: 999px;
--shadow-sm: 0 1px 2px rgba(11, 31, 51, 0.06), 0 1px 3px rgba(11, 31, 51, 0.08);
--shadow-md: 0 10px 30px -12px rgba(11, 31, 51, 0.22);
--shadow-sm: 0 1px 2px rgba(11, 31, 51, 0.05), 0 2px 6px rgba(11, 31, 51, 0.06);
--shadow-md: 0 18px 40px -18px rgba(11, 31, 51, 0.28);
--shadow-lg: 0 40px 80px -32px rgba(7, 20, 35, 0.45), 0 12px 28px -14px rgba(7, 20, 35, 0.2);
/* --- layout --- */
--container: 1200px;
--gutter: clamp(1rem, 4vw, 2rem);
--stage-inset: clamp(0.5rem, 1.2vw, 1rem); /* margine dei palchi scuri dal bordo */
--header-h: 5rem;
--tap: 44px; /* dimensione minima dei target touch */
/* --- movimento --- */
--dur: 180ms;
--ease: cubic-bezier(0.2, 0, 0, 1);
--ease-out: cubic-bezier(0.16, 1, 0.3, 1);
}
+102 -15
View File
@@ -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);
}
});
}
+61 -30
View File
@@ -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);
});
});
+2 -1
View File
@@ -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();
+20 -19
View File
@@ -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 ?? '');
+8 -2
View File
@@ -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();
});
+3 -2
View File
@@ -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/);
});
+2 -1
View File
@@ -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[] {