diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..ebf0801 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,15 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +indent_style = space +indent_size = 2 +trim_trailing_whitespace = true + +[*.md] +trim_trailing_whitespace = false + +[Makefile] +indent_style = tab diff --git a/.gitignore b/.gitignore index 8670a15..0aafdf0 100644 --- a/.gitignore +++ b/.gitignore @@ -1,442 +1,32 @@ -# ---> VisualStudio -## Ignore Visual Studio temporary files, build results, and -## files generated by popular Visual Studio add-ons. -## -## Get latest from https://github.com/github/gitignore/blob/main/VisualStudio.gitignore - -# User-specific files -*.rsuser -*.suo -*.user -*.userosscache -*.sln.docstates -*.env - -# User-specific files (MonoDevelop/Xamarin Studio) -*.userprefs - -# Mono auto generated files -mono_crash.* - -# Build results -[Dd]ebug/ -[Dd]ebugPublic/ -[Rr]elease/ -[Rr]eleases/ - -[Dd]ebug/x64/ -[Dd]ebugPublic/x64/ -[Rr]elease/x64/ -[Rr]eleases/x64/ -bin/x64/ -obj/x64/ - -[Dd]ebug/x86/ -[Dd]ebugPublic/x86/ -[Rr]elease/x86/ -[Rr]eleases/x86/ -bin/x86/ -obj/x86/ - -[Ww][Ii][Nn]32/ -[Aa][Rr][Mm]/ -[Aa][Rr][Mm]64/ -[Aa][Rr][Mm]64[Ee][Cc]/ -bld/ -[Oo]bj/ -[Oo]ut/ -[Ll]og/ -[Ll]ogs/ - -# Build results on 'Bin' directories -**/[Bb]in/* -# Uncomment if you have tasks that rely on *.refresh files to move binaries -# (https://github.com/github/gitignore/pull/3736) -#!**/[Bb]in/*.refresh - -# Visual Studio 2015/2017 cache/options directory -.vs/ -# Uncomment if you have tasks that create the project's static files in wwwroot -#wwwroot/ - -# Visual Studio 2017 auto generated files -Generated\ Files/ - -# MSTest test Results -[Tt]est[Rr]esult*/ -[Bb]uild[Ll]og.* -*.trx - -# NUnit -*.VisualState.xml -TestResult.xml -nunit-*.xml - -# Approval Tests result files -*.received.* - -# Build Results of an ATL Project -[Dd]ebugPS/ -[Rr]eleasePS/ -dlldata.c - -# Benchmark Results -BenchmarkDotNet.Artifacts/ - -# .NET Core -project.lock.json -project.fragment.lock.json -artifacts/ - -# ASP.NET Scaffolding -ScaffoldingReadMe.txt - -# StyleCop -StyleCopReport.xml - -# Files built by Visual Studio -*_i.c -*_p.c -*_h.h -*.ilk -*.meta -*.obj -*.idb -*.iobj -*.pch -*.pdb -*.ipdb -*.pgc -*.pgd -*.rsp -# but not Directory.Build.rsp, as it configures directory-level build defaults -!Directory.Build.rsp -*.sbr -*.tlb -*.tli -*.tlh -*.tmp -*.tmp_proj -*_wpftmp.csproj -*.log -*.tlog -*.vspscc -*.vssscc -.builds -*.pidb -*.svclog -*.scc - -# Chutzpah Test files -_Chutzpah* - -# Visual C++ cache files -ipch/ -*.aps -*.ncb -*.opendb -*.opensdf -*.sdf -*.cachefile -*.VC.db -*.VC.VC.opendb - -# Visual Studio profiler -*.psess -*.vsp -*.vspx -*.sap - -# Visual Studio Trace Files -*.e2e - -# TFS 2012 Local Workspace -$tf/ - -# Guidance Automation Toolkit -*.gpState - -# ReSharper is a .NET coding add-in -_ReSharper*/ -*.[Rr]e[Ss]harper -*.DotSettings.user - -# TeamCity is a build add-in -_TeamCity* - -# DotCover is a Code Coverage Tool -*.dotCover - -# AxoCover is a Code Coverage Tool -.axoCover/* -!.axoCover/settings.json - -# Coverlet is a free, cross platform Code Coverage Tool -coverage*.json -coverage*.xml -coverage*.info - -# Visual Studio code coverage results -*.coverage -*.coveragexml - -# NCrunch -_NCrunch_* -.NCrunch_* -.*crunch*.local.xml -nCrunchTemp_* - -# MightyMoose -*.mm.* -AutoTest.Net/ - -# Web workbench (sass) -.sass-cache/ - -# Installshield output folder -[Ee]xpress/ - -# DocProject is a documentation generator add-in -DocProject/buildhelp/ -DocProject/Help/*.HxT -DocProject/Help/*.HxC -DocProject/Help/*.hhc -DocProject/Help/*.hhk -DocProject/Help/*.hhp -DocProject/Help/Html2 -DocProject/Help/html - -# Click-Once directory -publish/ - -# Publish Web Output -*.[Pp]ublish.xml -*.azurePubxml -# Note: Comment the next line if you want to checkin your web deploy settings, -# but database connection strings (with potential passwords) will be unencrypted -*.pubxml -*.publishproj - -# Microsoft Azure Web App publish settings. Comment the next line if you want to -# checkin your Azure Web App publish settings, but sensitive information contained -# in these scripts will be unencrypted -PublishScripts/ - -# NuGet Packages -*.nupkg -# NuGet Symbol Packages -*.snupkg -# The packages folder can be ignored because of Package Restore -**/[Pp]ackages/* -# except build/, which is used as an MSBuild target. -!**/[Pp]ackages/build/ -# Uncomment if necessary however generally it will be regenerated when needed -#!**/[Pp]ackages/repositories.config -# NuGet v3's project.json files produces more ignorable files -*.nuget.props -*.nuget.targets - -# Microsoft Azure Build Output -csx/ -*.build.csdef - -# Microsoft Azure Emulator -ecf/ -rcf/ - -# Windows Store app package directories and files -AppPackages/ -BundleArtifacts/ -Package.StoreAssociation.xml -_pkginfo.txt -*.appx -*.appxbundle -*.appxupload - -# Visual Studio cache files -# files ending in .cache can be ignored -*.[Cc]ache -# but keep track of directories ending in .cache -!?*.[Cc]ache/ - -# Others -ClientBin/ -~$* -*~ -*.dbmdl -*.dbproj.schemaview -*.jfm -*.pfx -*.publishsettings -orleans.codegen.cs - -# Including strong name files can present a security risk -# (https://github.com/github/gitignore/pull/2483#issue-259490424) -#*.snk - -# Since there are multiple workflows, uncomment next line to ignore bower_components -# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) -#bower_components/ - -# RIA/Silverlight projects -Generated_Code/ - -# Backup & report files from converting an old project file -# to a newer Visual Studio version. Backup files are not needed, -# because we have git ;-) -_UpgradeReport_Files/ -Backup*/ -UpgradeLog*.XML -UpgradeLog*.htm -ServiceFabricBackup/ -*.rptproj.bak - -# SQL Server files -*.mdf -*.ldf -*.ndf - -# Business Intelligence projects -*.rdl.data -*.bim.layout -*.bim_*.settings -*.rptproj.rsuser -*- [Bb]ackup.rdl -*- [Bb]ackup ([0-9]).rdl -*- [Bb]ackup ([0-9][0-9]).rdl - -# Microsoft Fakes -FakesAssemblies/ - -# GhostDoc plugin setting file -*.GhostDoc.xml - -# Node.js Tools for Visual Studio -.ntvs_analysis.dat +# Dipendenze node_modules/ -# Visual Studio 6 build log -*.plg +# Output di build e rilascio +dist/ +release/ +.astro/ -# Visual Studio 6 workspace options file -*.opt +# Report dei test +test-results/ +playwright-report/ +blob-report/ +.lighthouseci/ +.cache/ -# Visual Studio 6 auto-generated workspace file (contains which files were open etc.) -*.vbw +# Variabili d'ambiente locali +.env +.env.* +!.env.example -# Visual Studio 6 workspace and project file (working project files containing files to include in project) -*.dsw -*.dsp +# Log +npm-debug.log* +*.log -# Visual Studio 6 technical files -*.ncb -*.aps - -# Visual Studio LightSwitch build output -**/*.HTMLClient/GeneratedArtifacts -**/*.DesktopClient/GeneratedArtifacts -**/*.DesktopClient/ModelManifest.xml -**/*.Server/GeneratedArtifacts -**/*.Server/ModelManifest.xml -_Pvt_Extensions - -# Paket dependency manager -**/.paket/paket.exe -paket-files/ - -# FAKE - F# Make -**/.fake/ - -# CodeRush personal settings -**/.cr/personal - -# Python Tools for Visual Studio (PTVS) -**/__pycache__/ -*.pyc - -# Cake - Uncomment if you are using it -#tools/** -#!tools/packages.config - -# Tabs Studio -*.tss - -# Telerik's JustMock configuration file -*.jmconfig - -# BizTalk build output -*.btp.cs -*.btm.cs -*.odx.cs -*.xsd.cs - -# OpenCover UI analysis results -OpenCover/ - -# Azure Stream Analytics local run output -ASALocalRun/ - -# MSBuild Binary and Structured Log -*.binlog -MSBuild_Logs/ - -# AWS SAM Build and Temporary Artifacts folder -.aws-sam - -# NVidia Nsight GPU debugger configuration file -*.nvuser - -# MFractors (Xamarin productivity tool) working folder -**/.mfractor/ - -# Local History for Visual Studio -**/.localhistory/ - -# Visual Studio History (VSHistory) files -.vshistory/ - -# BeatPulse healthcheck temp database -healthchecksdb - -# Backup folder for Package Reference Convert tool in Visual Studio 2017 -MigrationBackup/ - -# Ionide (cross platform F# VS Code tools) working folder -**/.ionide/ - -# Fody - auto-generated XML schema -FodyWeavers.xsd - -# VS Code files for those working on multiple tools +# File di sistema / editor +.DS_Store +Thumbs.db +desktop.ini +.idea/ .vscode/* -!.vscode/settings.json -!.vscode/tasks.json -!.vscode/launch.json !.vscode/extensions.json -!.vscode/*.code-snippets - -# Local History for Visual Studio Code -.history/ - -# Built Visual Studio Code Extensions -*.vsix - -# Windows Installer files from build outputs -*.cab -*.msi -*.msix -*.msm -*.msp - -# ---> VisualStudioCode -.vscode/* -!.vscode/settings.json -!.vscode/tasks.json -!.vscode/launch.json -!.vscode/extensions.json -!.vscode/*.code-snippets -!*.code-workspace - -# Built Visual Studio Code Extensions -*.vsix - +*.swp diff --git a/.htmlvalidate.json b/.htmlvalidate.json new file mode 100644 index 0000000..9c09a09 --- /dev/null +++ b/.htmlvalidate.json @@ -0,0 +1,11 @@ +{ + "$schema": "https://html-validate.org/schemas/config.json", + "extends": ["html-validate:recommended"], + "rules": { + "doctype-html": "error", + "element-required-attributes": "error", + "heading-level": "error", + "no-dup-id": "error", + "wcag/h37": "error" + } +} diff --git a/.nvmrc b/.nvmrc new file mode 100644 index 0000000..a45fd52 --- /dev/null +++ b/.nvmrc @@ -0,0 +1 @@ +24 diff --git a/.prettierignore b/.prettierignore new file mode 100644 index 0000000..9bd618e --- /dev/null +++ b/.prettierignore @@ -0,0 +1,13 @@ +node_modules/ +dist/ +release/ +.astro/ +test-results/ +playwright-report/ +blob-report/ +.lighthouseci/ +package-lock.json +public/ +docs/mockups/ +docs/screenshots/ +docs/BRIEF.md diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 0000000..5c2a0e9 --- /dev/null +++ b/.prettierrc @@ -0,0 +1,16 @@ +{ + "printWidth": 100, + "singleQuote": true, + "trailingComma": "all", + "plugins": ["prettier-plugin-astro"], + "overrides": [ + { + "files": "*.astro", + "options": { "parser": "astro" } + }, + { + "files": "*.md", + "options": { "proseWrap": "preserve" } + } + ] +} diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..0d1b4e7 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,7 @@ +{ + "recommendations": [ + "astro-build.astro-vscode", + "dbaeumer.vscode-eslint", + "esbenp.prettier-vscode" + ] +} diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..8798f10 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,11 @@ +# Changelog + +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] + +### Aggiunto + +- Struttura iniziale del progetto Astro, strumenti di qualità del codice e script npm. diff --git a/DECISIONS.md b/DECISIONS.md new file mode 100644 index 0000000..b36866c --- /dev/null +++ b/DECISIONS.md @@ -0,0 +1,101 @@ +# Registro delle decisioni + +Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · contesto · scelta · alternative scartate · motivazione. + +--- + +## D-001 — Repository esistente su Forgejo e branch di lavoro + +- **Data:** 2026-10-15 +- **Contesto:** il brief (§14.0) prevede `git init`, ma il repository `BalboSoft/Studio_Grasso` esiste già su Forgejo con un commit iniziale (README di due righe e `.gitignore`). +- **Scelta:** si lavora sul clone del repository esistente. Lo sviluppo avviene sul branch `feat/sito-v1` (un commit per fase, Conventional Commits in italiano); a fine fase 8 il branch viene unito in `main` con un merge commit (`--no-ff`), così `main` locale è pronto per il push. +- **Alternative scartate:** `git init` di un nuovo repository (perderebbe la storia remota e richiederebbe un push forzato); commit diretti su `main` (meno leggibile la storia per fasi). +- **Motivazione:** conserva la storia remota, nessun push forzato necessario, `main` resta pulito fino al merge finale. + +## D-002 — Sostituzione del `.gitignore` iniziale + +- **Data:** 2026-10-15 +- **Contesto:** il `.gitignore` del commit iniziale è il modello «VisualStudio» (C#/.NET), non pertinente a un progetto Node/Astro. +- **Scelta:** sostituito con un `.gitignore` specifico (`node_modules`, `dist`, `release`, `.astro`, `test-results`, `playwright-report`, `.lighthouseci`, file di sistema). +- **Alternative scartate:** aggiungere le voci in coda al modello esistente (centinaia di regole inutili, alcune potenzialmente fuorvianti). +- **Motivazione:** semplicità e chiarezza (§0.3, punto 4). + +## D-003 — Versione di Node.js + +- **Data:** 2026-10-15 +- **Contesto:** il brief chiede «Node.js LTS corrente (≥ 22)». A ottobre 2026 la LTS attiva è Node 24 (Krypton); Node 22 è in manutenzione. `eslint-plugin-astro` 3.x richiede Node `^22.22.3 || ^24.16.0 || >=26.3.0`, Astro 7 richiede `>=22.22.0`. +- **Scelta:** `.nvmrc` = `24`; `engines.node` = `>=22.22.3`. Sviluppo e test eseguiti con Node 24.22.0. +- **Alternative scartate:** Node 22 come riferimento (LTS in manutenzione); `engines` `>=24` (escluderebbe inutilmente Node 22 aggiornato). +- **Motivazione:** LTS attiva per lo sviluppo, compatibilità dichiarata con il minimo realmente supportato dalle dipendenze. + +## D-004 — Astro 7.4.0 + +- **Data:** 2026-10-15 +- **Contesto:** il brief chiede l'ultima versione stabile di Astro, verificata con `npm view astro version`. +- **Scelta:** `astro@7.4.0` (risultato di `npm view astro version` il 2026-10-15), con `@astrojs/sitemap@3.7.4`. +- **Alternative scartate:** nessuna (requisito esplicito). +- **Motivazione:** requisito del brief §3.1. + +## D-005 — TypeScript 6.0.3 invece di 7.0.2 + +- **Data:** 2026-10-15 +- **Contesto:** l'ultima TypeScript è la 7.0.2, ma `@astrojs/check@0.9.10` dichiara `typescript ^5 || ^6` e `typescript-eslint@8.71.2` richiede `typescript <6.1.0`. +- **Scelta:** `typescript@6.0.3` (ultima 6.x), modalità `strict` tramite `astro/tsconfigs/strict`. +- **Alternative scartate:** TypeScript 7 (fuori dai peer delle dipendenze, rischio di `astro check` non funzionante). +- **Motivazione:** compatibilità garantita dalle dipendenze ufficiali. + +## D-006 — Playwright 1.56.1 (versione bloccata) + +- **Data:** 2026-10-15 +- **Contesto:** il brief usa come riferimento l'immagine CI `mcr.microsoft.com/playwright:v1.56.0-noble` e chiede che coincida con la versione di `@playwright/test`. L'ambiente di sviluppo dispone di Chromium revision 1194, quella usata da Playwright 1.56.x; le versioni successive (1.57+) richiedono un Chromium diverso. +- **Scelta:** `@playwright/test@1.56.1` e `playwright@1.56.1` (ultima patch della 1.56); immagine CI `mcr.microsoft.com/playwright:v1.56.1-noble`. +- **Alternative scartate:** Playwright 1.64.1 (richiederebbe lo scaricamento di un nuovo browser e un'immagine diversa da quella indicata nel brief). +- **Motivazione:** test riproducibili in locale e in CI con lo stesso browser; aggiornare Playwright significa aggiornare insieme `package.json` e l'immagine dei workflow (documentato nel README). + +## D-007 — Versioni esatte delle dipendenze + +- **Data:** 2026-10-15 +- **Contesto:** riproducibilità della build e del pacchetto di rilascio. +- **Scelta:** tutte le dipendenze sono dichiarate con versione esatta (senza `^`) e `package-lock.json` è committato; la CI usa `npm ci`. +- **Alternative scartate:** intervalli semver (`^x.y.z`). +- **Motivazione:** build identiche nel tempo; gli aggiornamenti diventano commit espliciti. + +## D-008 — Avvisi di `npm audit` sulle dipendenze di sviluppo + +- **Data:** 2026-10-15 +- **Contesto:** `npm audit` segnala 17 vulnerabilità, tutte in dipendenze transitive di strumenti di sviluppo (soprattutto `@lhci/cli`: `tmp`, `uuid`, `basic-ftp`, `extract-zip`). `npm audit --omit=dev` = 0 vulnerabilità. +- **Scelta:** nessuna azione; nessuno di questi pacchetti finisce nel sito pubblicato (che contiene solo file statici). +- **Alternative scartate:** `npm audit fix --force` (introdurrebbe versioni incompatibili e romperebbe Lighthouse CI). +- **Motivazione:** rischio nullo per il sito pubblicato; gli strumenti girano solo in locale/CI su input fidato. + +## D-009 — Nessun `eslint-plugin-jsx-a11y` + +- **Data:** 2026-10-15 +- **Contesto:** le regole a11y di `eslint-plugin-astro` richiedono `eslint-plugin-jsx-a11y`, che non supporta ESLint 10. +- **Scelta:** si usa la configurazione `recommended` di `eslint-plugin-astro`; l'accessibilità è verificata da axe-core (tutte le pagine, due viewport), html-validate (regole WCAG) e Lighthouse (punteggio 1.0). +- **Alternative scartate:** declassare ESLint alla 9 solo per questo plugin. +- **Motivazione:** copertura a11y più forte a runtime che in lint statico; toolchain aggiornata. + +## D-010 — Icone Lucide senza `astro-icon` + +- **Data:** 2026-10-15 +- **Contesto:** il brief consente `@iconify-json/lucide` + `astro-icon` oppure file SVG in `src/icons/`. +- **Scelta:** componente `Icon.astro` che legge i tracciati da `@iconify-json/lucide` (JSON) a build time e genera SVG inline con `aria-hidden="true"`. Nessuna integrazione aggiuntiva. +- **Alternative scartate:** `astro-icon` (porta con sé `@iconify/tools` e decine di dipendenze transitive, compatibilità con Astro 7 non dichiarata); copiare a mano i file SVG (manutenzione più scomoda). +- **Motivazione:** zero runtime, meno dipendenze, stesso set di icone (Lucide, licenza ISC). + +## D-011 — Script segnaposto in fase 0 + +- **Data:** 2026-10-15 +- **Contesto:** il brief chiede di definire in fase 0 tutti gli script npm di §3.3 «anche se vuoti». +- **Scelta:** gli script in `scripts/` sono creati come segnaposto e implementati nelle fasi 1 (icone), 6 (test) e 7 (packaging e release). +- **Alternative scartate:** nessuna. +- **Motivazione:** requisito del brief §14.0. + +## D-012 — Mockup e brief in `docs/` + +- **Data:** 2026-10-15 +- **Contesto:** i mockup sono stati forniti in formato WebP (non PNG come indicato nell'Appendice A). +- **Scelta:** copiati in `docs/mockups/` con i nomi dell'Appendice A ed estensione `.webp`; il brief completo è conservato in `docs/BRIEF.md` come riferimento dei requisiti. +- **Alternative scartate:** convertirli in PNG (file più pesanti senza benefici). +- **Motivazione:** il riferimento visivo resta nel repository insieme ai requisiti. diff --git a/README.md b/README.md index 305c2ff..7fe345e 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,21 @@ -# Studio_Grasso +# Sito web dello Studio Grasso -Sito internet per Studio Grasso \ No newline at end of file +Sito statico dello **Studio Grasso — Studio Tributario e Societario** (Montegrosso d'Asti e Asti), realizzato con [Astro](https://astro.build/). + +> Documento in costruzione: la versione completa (comandi, pubblicazione su Forgejo, rilasci) viene scritta nella fase 8. + +## Requisiti + +- Node.js LTS (vedi `.nvmrc`, minimo `22.22.3`) e npm. + +## Comandi principali + +```bash +npm ci # installa le dipendenze esatte di package-lock.json +npm run dev # server di sviluppo su http://localhost:4321 +npm run build # genera il sito statico in dist/ +npm run verify # tutti i controlli di qualità (eseguito anche dalla CI) +npm run package # crea i pacchetti di rilascio in release/ +``` + +Requisiti di progetto: `docs/BRIEF.md`. Decisioni tecniche: `DECISIONS.md`. Dati da fornire: `TODO-STUDIO.md`. diff --git a/TODO-STUDIO.md b/TODO-STUDIO.md new file mode 100644 index 0000000..1a873f7 --- /dev/null +++ b/TODO-STUDIO.md @@ -0,0 +1,12 @@ +# Dati e azioni richiesti allo Studio + +Elenco di ciò che non è stato possibile ricavare dal sito attuale e che lo Studio deve fornire o confermare (brief §0.5). Il sito costruito non contiene segnaposto: dove un dato manca, la pagina ne fa a meno. + +## Bloccante prima della pubblicazione + +1. **Titolare della P.IVA 01597790052.** Indicare la denominazione esatta del titolare del sito (persona fisica o società, ad es. «Studio Tributario Grasso S.r.l.» come lascia supporre la PEC `studiotributariograssosrl@pec.it`). +2. **Dominio definitivo del nuovo sito.** Default: `https://www.grassoezio.it`. + +## Consigliato + +1. **Far validare** privacy policy, cookie policy e note legali da un consulente. diff --git a/astro.config.mjs b/astro.config.mjs new file mode 100644 index 0000000..4baf734 --- /dev/null +++ b/astro.config.mjs @@ -0,0 +1,34 @@ +// @ts-check +import sitemap from '@astrojs/sitemap'; +import { defineConfig } from 'astro/config'; + +/** + * 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(/\/+$/, ''); + +export default defineConfig({ + site, + output: 'static', + trailingSlash: 'always', + compressHTML: true, + build: { + format: 'directory', + // Il CSS piccolo viene incluso nella pagina (consentito dalla CSP: style-src 'unsafe-inline'). + inlineStylesheets: 'auto', + }, + devToolbar: { enabled: false }, + integrations: [ + sitemap({ + // La pagina di conferma del modulo è `noindex`: non va in sitemap. + filter: (page) => !page.includes('/contatti/grazie/'), + }), + ], + vite: { + build: { + // Nessuno script inline: la CSP consente solo `script-src 'self'`. + assetsInlineLimit: 0, + }, + }, +}); diff --git a/docs/BRIEF.md b/docs/BRIEF.md new file mode 100644 index 0000000..5797120 --- /dev/null +++ b/docs/BRIEF.md @@ -0,0 +1,2433 @@ +# 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. + +> **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`. + +--- + +## 0. Modalità operativa + +- **0.1 Ruolo.** Agisci come senior web engineer + web designer + esperto di conformità per siti di studi professionali italiani. +- **0.2 Autonomia totale.** Non chiedere conferme, non proporre piani da approvare, non fermarti tra una fase e l'altra. Esegui le fasi di §14 in ordine, stampa una riga di avanzamento alla fine di ogni fase e fermati solo per il report finale (§14.9). +- **0.3 Priorità in caso di dubbio o conflitto:** (1) conformità legale e correttezza dei fatti → (2) fedeltà ai contenuti di §4 → (3) test verdi e integrità del pacchetto → (4) semplicità e manutenibilità → (5) estetica. Se due sezioni di questo brief sembrano in conflitto: §8 > §4 > §11 > §6–7 > resto. +- **0.4 Decisioni.** Ogni scelta non banale (libreria, struttura, interpretazione di un contenuto) va registrata in `DECISIONS.md` (data, contesto, scelta, alternative scartate, motivazione in 1–3 righe). +- **0.5 Dati mancanti.** Ciò che non puoi sapere va in `TODO-STUDIO.md`, diviso in «Bloccante prima della pubblicazione» e «Consigliato», con istruzioni precise su *dove* inserire il dato (file e riga). **Mai** placeholder visibili nel sito costruito: niente `[TODO]`, `lorem ipsum`, `XXX`, numeri o date inventati. Se un dato obbligatorio manca, la pagina ne fa a meno e il TODO lo segnala. +- **0.6 Verifica reale.** Ogni fase si chiude con build e test eseguiti davvero. Se un test fallisce: correggi e riesegui. Vietato disabilitare, saltare o allentare test per farli passare; se un test è sbagliato, correggilo e spiega perché in `DECISIONS.md`. +- **0.7 Lingua.** Interfaccia, contenuti, documentazione, messaggi di commit e `DECISIONS.md` in italiano. Identificatori di codice in inglese. +- **0.8 Nessuna pubblicazione.** Non fare push, non creare tag, non effettuare deploy: consegna un repository locale pronto, con istruzioni per il push in `README.md`. + +--- + +## 1. Obiettivo e contesto + +- **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. +- **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. + +--- + +## 2. Vincoli non negoziabili + +1. **Conformità legale** come da §8: P.IVA nella home e in ogni pagina (footer); pagine Privacy policy, Cookie policy e Note legali coerenti con l'uso *effettivo* del sito; nessun tracciamento; nessuna risorsa di terze parti caricata senza un'azione esplicita dell'utente (font self-hosted, mappa click-to-load, nessun CDN, nessun embed automatico). +2. **Titoli professionali esatti** (§4.2). Solo la Dott.ssa Giulia Grasso è iscritta all'Ordine dei Dottori Commercialisti: **mai** definire il Dott. Ezio Grasso "commercialista" né lo studio "studio di commercialisti" o "studio commercialista". La denominazione da usare è sempre «Studio Grasso» / «Studio Tributario e Societario». +3. **Fatti solo da §4.** Nessun dato, numero o affermazione inventata (anni di esperienza, numero di clienti, recensioni, testimonianze, "leader", "n. 1"). Il copy può essere riscritto, ma i fatti no. +4. **Nessuna immagine di terzi**: niente foto stock, niente loghi di enti (MEF, ODCEC, CNDCEC, I.N.T., CCIAA, Unioncamere, Tribunale, CAF). Le abilitazioni si rappresentano con badge testuali + icone. Lo studio potrà aggiungere i loghi ufficiali se autorizzato (voce in `TODO-STUDIO.md`). +5. **Niente cookie banner** (non serve finché il sito non usa cookie non tecnici) e **vietato aggiungere analytics o cookie di terze parti**. Se in futuro lo studio vorrà statistiche, la documentazione indicherà soluzioni senza cookie (es. analytics self-hosted cookieless) da valutare con il consulente privacy. +6. **Progressive enhancement.** Il sito deve essere pienamente navigabile e leggibile senza JavaScript. JS consentito solo per: menu mobile, caricamento mappa su consenso, validazione client del form (il form funziona anche senza JS), redirect degli anchor del vecchio sito (§5.3). +7. **Nessun servizio esterno a runtime** (CDN, font remoti, iframe automatici, API). Output: puro statico in `dist/`. +8. **Nessuna pubblicazione** (§0.8). Nessun push, nessun tag, nessun deploy. + +--- + +## 3. Stack tecnico e struttura del repository + +### 3.1 Stack + +| Ambito | Scelta | Note | +|---|---|---| +| Runtime | Node.js LTS corrente (≥ 22), npm con `package-lock.json` committato | Dichiara `engines` in `package.json` e un file `.nvmrc`. | +| Generatore | **Astro** (ultima versione stabile disponibile su npm al momento dell'esecuzione, verifica con `npm view astro version`) | Output statico (`output: 'static'`), `build.format: 'directory'`, `trailingSlash: 'always'`, `compressHTML: true`, `site` da variabile d'ambiente `SITE_URL` (default `https://www.grassoezio.it`). | +| Linguaggio | TypeScript strict | `astro check` deve passare senza errori. | +| Stili | CSS moderno nativo (custom properties, `clamp()`, grid, container query dove utile), scoped styles di Astro + `src/styles/tokens.css` e `global.css` | Nessun framework CSS. Il design system di riferimento è in Appendice B (`style.css` del mockup): riusalo come base, adattandolo. | +| Font | `@fontsource-variable/fraunces` (titoli) e `@fontsource-variable/inter` (testo), self-hosted, subset `latin`, `font-display: swap`, `preload` dei due file woff2 principali | Nessun Google Fonts. | +| Icone | SVG inline (set Lucide via `@iconify-json/lucide` + `astro-icon`, oppure file SVG in `src/icons/`) — inlined a build time, zero runtime | Icone con `aria-hidden="true"` quando decorative. | +| Immagini | `astro:assets` (``/``, WebP/AVIF, dimensioni esplicite) | Nessuna immagine di terzi (§2.4). | +| Contenuti | `src/data/studio.ts` (anagrafica, recapiti, orari, professionisti, abilitazioni = **unica fonte di verità**) + Content Collections (`src/content/servizi/*.md`, `src/content/link-utili.json`) con schema Zod | Tutto il testo editabile sta in `src/data` e `src/content`, mai hardcoded nei componenti. | +| 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 | + +### 3.2 Struttura del repository (obbligatoria) + +``` +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 +├── 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 +│ ├── 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) +├── public/ +│ ├── .htaccess robots.txt favicon.svg favicon.ico apple-touch-icon.png og-default.png +│ └── images/README.md # elenco immagini che lo studio può fornire (foto sedi, foto professionisti, loghi autorizzati) +├── src/ +│ ├── data/studio.ts # anagrafica, sedi, recapiti, orari, professionisti, abilitazioni, partner, config form/mappa +│ ├── content/servizi/*.md # 6 servizi (frontmatter: titolo, slug, ordine, sommario, icona, anchorLegacy) +│ ├── content/link-utili.json +│ ├── content.config.ts # schemi Zod delle collection (o src/content/config.ts, secondo la versione di Astro) +│ ├── layouts/BaseLayout.astro # completo, skip link, Header, Footer, JSON-LD +│ ├── components/ (Header, Nav, MobileMenu, Footer, Hero, ServiceCard, PersonCard, BadgeAbilitazione, SedeCard, MapConsent, ContactForm, CtaBand, Breadcrumb, SectionHead, Icon, Logo) +│ ├── pages/ (index, studio, servizi/index, servizi/[slug], contatti, dove-siamo, link-utili, privacy-policy, cookie-policy, note-legali, accessibilita, 404) +│ ├── styles/ (tokens.css, global.css, print.css) +│ ├── 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 +│ ├── 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) +├── 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 +``` + +### 3.3 Script npm (nomi obbligatori) + +``` +dev · build · preview · lint · format · format:check · check (astro check) +test:html · test:links · test:e2e · test:a11y · test:lighthouse · test:compliance · test:package +test (= html+links+e2e+a11y+compliance) · verify (= lint + format:check + check + build + test + test:lighthouse) +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. + +--- + +## 4. Contenuti — fonte di verità (estratti dal sito attuale) + +Tutto ciò che segue è **fatto accertato** dal sito attuale. I testi descrittivi vanno riscritti (copy originale, stile §6.4) mantenendo invariati i fatti. Gli elenchi di servizi e abilitazioni vanno riportati integralmente (con gli aggiornamenti terminologici di §4.9). + +### 4.1 Anagrafica e recapiti + +| Campo | Valore | +|---|---| +| Nome commerciale | **Studio Grasso** — sottotitolo «Studio Tributario e Societario» | +| Nome esteso (SEO/title) | Studio Ezio Grasso — Studio Tributario e Societario | +| Payoff attuale | «Consulenza Fiscale e Tributaria» | +| Sede principale | Via XX Settembre, 163 — 14048 Montegrosso d'Asti (AT) | +| Sede secondaria | Piazza Medici, 4 — 14100 Asti (AT) — **si riceve su appuntamento** | +| Telefono | +39 0141 951382 · +39 0141 1762214 | +| Fax | +39 0141 951382 | +| E-mail | info@studiograssoezio.it | +| PEC (studio) | studiotributariograssosrl@pec.it | +| PEC (Dott.ssa Giulia Grasso) | giuliagrasso@pec.commercialisti.it | +| P.IVA indicata nel footer del sito | **01597790052** | +| Orari | Dal lunedì al venerdì, 9:00–12:30 e 15:00–18:30. Ad Asti su appuntamento. | +| Dominio attuale | grassoezio.it (sito) · studiograssoezio.it (e-mail). Dominio definitivo del nuovo sito: da confermare → `SITE_URL` configurabile, default `https://www.grassoezio.it` (TODO-STUDIO). | + +> Nota sull'intestatario della P.IVA 01597790052: l'indirizzo PEC `studiotributariograssosrl@pec.it` fa presumere l'esistenza di una società «Studio Tributario Grasso S.r.l.». **Non è confermato.** Nel sito usa «Studio Grasso» e la P.IVA; inserisci in `TODO-STUDIO.md` (bloccante) la richiesta di denominazione sociale esatta, codice fiscale, dati Registro Imprese/REA, capitale sociale ed eventuale socio unico (obbligatori ex art. 2250 c.c. se si tratta di una società, vedi §8.1) e, nel caso, di aggiornare `src/data/studio.ts` e la pagina Note legali. + +### 4.2 Professionisti (titoli esatti — vincolo §2.2) + +**Dott. Ezio Grasso** — P.IVA 01451730053 +- Tributarista: iscritto al n. 1535 dell'Istituto Nazionale Tributaristi (I.N.T.), professionista qualificato I.N.T. ai sensi della Legge 14 gennaio 2013, n. 4 (professioni non organizzate in ordini o collegi). +- Difensore tributario abilitato ed autorizzato dal Ministero dell'Economia e delle Finanze all'assistenza tecnica dinanzi alle Corti di Giustizia Tributaria per il contenzioso — iscritto al numero 12, sezione 1 (riportare la dicitura così com'è; è un dato dello studio). +- Iscritto al n. 167 del Ruolo dei Periti e degli Esperti della Camera di Commercio di Asti (oggi Camera di Commercio di Alessandria-Asti, nata il 1° ottobre 2020 dall'accorpamento: usare «Camera di Commercio di Alessandria-Asti (sede di Asti)» e segnalare in TODO-STUDIO di confermare la dicitura). +- Arbitro e Mediatore presso la Camera Arbitrale del Piemonte — Unioncamere Piemonte. +- Responsabile del Centro Autorizzato Servizi C.A.F. (codice M202). +- Consulente Tecnico del Giudice, iscritto al numero 82. +- Perito del Tribunale di Asti. + +**Dott.ssa Giulia Grasso** — P.IVA 01763800057 +- Dottore Commercialista, iscritta al n. 479, sezione A, dell'Ordine dei Dottori Commercialisti e degli Esperti Contabili di Asti. +- Gestore della crisi da sovraindebitamento: iscritta al numero 37 dell'Organismo di Composizione della Crisi — Commercialisti Asti. + +### 4.3 Abilitazioni e iscrizioni (sezione "Abilitazioni e iscrizioni" — 9 voci, ordine di presentazione) + +| # | Abilitazione / iscrizione | Professionista | +|---|---|---| +| 1 | Difensore tributario abilitato ed autorizzato dal MEF all'assistenza tecnica dinanzi alle Corti di Giustizia Tributaria — iscritto al n. 12, sez. 1 | Dott. Ezio Grasso | +| 2 | Iscritta al n. 479, sez. A, dell'Ordine dei Dottori Commercialisti e degli Esperti Contabili di Asti | Dott.ssa Giulia Grasso | +| 3 | Iscritta al n. 37 dell'Organismo di Composizione della Crisi — Commercialisti Asti — Gestore nelle procedure di composizione della crisi da sovraindebitamento | Dott.ssa Giulia Grasso | +| 4 | Iscritto al n. 1535 dell'Istituto Nazionale Tributaristi (I.N.T.) — Qualificato I.N.T. ai sensi della L. 4/2013 | Dott. Ezio Grasso | +| 5 | Iscritto al n. 167 del Ruolo dei Periti e degli Esperti della Camera di Commercio (Asti) | Dott. Ezio Grasso | +| 6 | Arbitro e Mediatore presso la Camera Arbitrale del Piemonte — Unioncamere Piemonte | Dott. Ezio Grasso | +| 7 | Responsabile Centro Autorizzato Servizi C.A.F. (M202) | Dott. Ezio Grasso | +| 8 | Consulente Tecnico del Giudice — iscritto al n. 82 | Dott. Ezio Grasso | +| 9 | Perito del Tribunale di Asti | Dott. Ezio Grasso | + +### 4.4 Lo studio — fatti e messaggi chiave (per il copy originale) + +- Ambiti: consulenza tributaria, societaria, contabile e fiscale; clientela: imprese, professionisti e privati. +- Assistenza personalizzata fin dalla costituzione dell'impresa (scelta della forma giuridica), poi affiancamento nella gestione di aspetti fiscali, contrattuali e finanziari, operazioni straordinarie e contenzioso tributario. +- Punti di forza dichiarati: lunga esperienza professionale; rapidità e affidabilità; aggiornamento costante; collaborazione con consulenti esterni di provata esperienza (consulenza del lavoro, pratiche legali e notarili, sicurezza sul lavoro, finanza agevolata, servizi immobiliari, tutela della proprietà intellettuale). +- Valori dichiarati: **efficienza** della prestazione, **professionalità**, massima **trasparenza**; rapporto di fiducia con il cliente; soddisfazione del cliente come obiettivo; missione: far sviluppare l'attività dei clienti fornendo i servizi necessari ai loro progetti. +- **Partner** («Lo studio si avvale di»): Consulenti del lavoro (paghe e contributi) · Avvocati (consulenze legali e recupero crediti) · Notai (prestazioni notarili e consulenze patrimoniali) · Sicurezza sul lavoro (D.Lgs. 81/2008). +- Claim ricorrente (CTA): «Sei interessato ad uno dei nostri servizi? Richiedi un preventivo gratuito e senza impegno». + +### 4.5 Servizi — contenuto integrale (6 aree) + +Slug nuovi tra parentesi; `anchorLegacy` = anchor usato dal vecchio sito su `/servizi` (serve per i redirect di §5.3). + +**1. Consulenza fiscale, tributaria e societaria** (`consulenza-fiscale-tributaria-e-societaria`, legacy `consulenza-fiscale-tributaria-e-societaria-1`) + +*Consulenza fiscale* +- Consulenza sui regimi fiscali ordinario e semplificato e sui regimi fiscali agevolati +- Consulenza per l'iscrizione alla gestione previdenziale (INPS o altra cassa) +- Elaborazione dati per tipologia di soggetto: lavoratori autonomi, imprese individuali, società di persone e di capitali, enti non commerciali e non residenti +- Predisposizione e pubblicazione dei bilanci d'esercizio; situazioni patrimoniali e reddituali periodiche +- Tenuta e scritturazione dei libri contabili +- Ristrutturazioni e riorganizzazioni societarie: conferimenti, fusioni proprie e per incorporazione, trasformazioni, scissioni +- Consulenza e assistenza per la fatturazione elettronica +- Consulenza contrattualistica e di diritto commerciale; perizie e consulenze tecniche in materia civile +- Aggiornamento sugli sviluppi della legislazione fiscale +- Procedure e pratiche fiscali ricorrenti +- Convenzioni internazionali contro la doppia imposizione +- Contenzioso fiscale (rimando alla pagina Contenzioso tributario) +- Pianificazione fiscale; programmazione fiscale per enti, lavoratori autonomi e privati +- Assistenza fiscale per imposizione diretta, indiretta e sostitutiva (IRES, IRAP, IVA, capital gain, ecc.) +- Successioni: dichiarazioni di successione, volture catastali, assistenza nelle regolazioni successorie tra eredi + +*Consulenza tributaria* (sintesi + link alla pagina Contenzioso tributario, per evitare duplicazioni) +- Predisposizione dei ricorsi e assistenza dinanzi alle Corti di Giustizia Tributaria; studio e analisi della contestazione; assistenza nella fase di accertamento; contraddittorio preventivo presso l'Agenzia delle Entrate ed eventuale definizione; richiesta di sospensione della cartella esattoriale; revoca/sospensione del fermo amministrativo dell'auto; rateazione dei pagamenti presso Agenzia delle Entrate-Riscossione. +- Messaggio: assistenza costante anche nelle problematiche più complesse, fino alla rappresentanza in ogni grado di giudizio; riguarda tutti gli aspetti della tassazione, imposte dirette e indirette, per imprese individuali e collettive, associazioni ed enti. + +*Consulenza societaria* +- Tenuta e scritturazione dei libri sociali +- Assistenza in occasione di costituzione e scioglimento di società ed enti +- Consulenza amministrativa e fiscale per gli enti no-profit +- Messaggio: individuazione della struttura giuridica adeguata e dell'organizzazione dell'impresa; adempimenti societari ordinari; rapporti tra soci, tra soci e società, tra società e organi sociali; acquisizione e cessione di società e partecipazioni; conferimenti, fusioni, trasformazioni, scissioni, liquidazione e scioglimento; contratti di locazione, associazione in partecipazione, comodato, affitto d'azienda; arbitrati, transazioni e composizione di vertenze giudiziali e stragiudiziali. + +*Consulenza aziendale e direzionale* +- Valutazione di azienda e di rami d'azienda +- Perizie contabili e amministrative +- Consulenza per l'accesso ai finanziamenti + +**2. Contabilità fiscale** (`contabilita-fiscale`, legacy `contabilita-fiscale-2`) + +Intro: tenuta e registrazione delle scritture contabili obbligatorie previste dalla normativa civilistica e fiscale, con gestione dei documenti consegnati allo studio per la registrazione. + +*Contabilità semplificata:* registri IVA acquisti, registro IVA vendite, registro dei corrispettivi, registro liquidazioni IVA, registro dei cespiti ammortizzabili. + +*Contabilità ordinaria:* prima nota cassa, libro giornale, libro degli inventari, libri sociali, registri IVA. + +*Predisposizione e invio telematico di dichiarativi fiscali e bilanci:* dichiarazione dei redditi; dichiarazione IRAP; modello 770; Certificazione Unica; dichiarazione IVA; ISA — Indici Sintetici di Affidabilità fiscale (ex studi di settore, §4.9); trasmissione telematica dei dichiarativi; deposito telematico dei bilanci d'esercizio in formato XBRL presso la Camera di Commercio; elaborazione di INTRASTAT, comunicazione delle operazioni transfrontaliere (ex esterometro) e IMU (§4.9). + +**3. Contenzioso tributario** (`contenzioso-tributario`, legacy `contenzioso-tributario-3`) + +Intro: assistenza in tutte le fasi del contenzioso tributario. +- Studio e analisi della contestazione +- Assistenza durante la fase dell'accertamento +- Assistenza presso l'Agenzia delle Entrate per il contraddittorio preventivo ed eventuale definizione +- Assistenza dinanzi alle Corti di Giustizia Tributaria di primo e secondo grado (§4.9) +- Richiesta di sospensione della cartella esattoriale +- Revoca e/o sospensione del fermo amministrativo dell'auto +- Predisposizione della documentazione per la rateazione dei pagamenti presso Agenzia delle Entrate-Riscossione +- Evidenziare: il Dott. Ezio Grasso è difensore tributario abilitato ed autorizzato dal MEF all'assistenza tecnica (§4.2). + +**4. Centro autorizzato CAF** (`centro-autorizzato-caf`, legacy `centro-autorizzato-caf-4`) +- Elaborazione e trasmissione del modello 730 (singolo e congiunto) +- Elaborazione e trasmissione della DSU per l'ISEE (ex modello ISE/ISEE) +- Elaborazione e trasmissione del modello RED +- Elaborazione del modello detrazioni INPS +- Bonus sociale luce e gas (§4.9: oggi riconosciuto in automatico tramite DSU/ISEE; il CAF assiste nella DSU) +- Scelta dell'8, del 5 e del 2 per mille tramite Certificazione Unica (ex CUD) — il «2 per mille ai partiti politici» del vecchio sito rientra qui +- Assegno di maternità dei Comuni; assistenza per la domanda di Assegno Unico e Universale (§4.9: sostituisce l'assegno per il nucleo familiare con tre figli minori) +- Elaborazione e trasmissione dei modelli ICRIC, ICLAV, ACCAS/PS + +**5. Servizi alle imprese, dipendenti e pensionati** (`servizi-imprese-dipendenti-pensionati`, legacy `servizi-alle-imprese-dipendenti-e-pensionati-5`) +- Elaborazione di business plan +- Stipula di contratti di locazione e registrazione telematica +- Successioni e donazioni +- Agevolazioni fiscali + +**6. Certificazione atti mediante firma digitale** (`certificazione-atti-firma-digitale`, legacy `certificazione-atti-mediante-firma-digitale-6`) +- Sportello telematico della Camera di Commercio (pratiche Registro Imprese) +- Convenzione con la Camera di Commercio (sede di Asti) per il rilascio dei dispositivi di firma digitale (smart card/token — §4.9) +- Messaggio (da riscrivere in modo originale): lo studio è abilitato alla certificazione degli atti mediante firma digitale, che ha lo stesso valore legale della firma autografa; si basa su chiavi crittografiche che consentono a chi firma e a chi riceve di verificare provenienza e integrità dei documenti informatici; è fondamentale negli adempimenti verso la pubblica amministrazione e negli scambi sicuri di documenti tra imprese. + +### 4.6 Sedi e mappe + +- **Montegrosso d'Asti** — Via XX Settembre, 163 — 14048 (AT). Sede principale, orari §4.1. +- **Asti** — Piazza Medici, 4 — 14100 (AT). Si riceve su appuntamento. +- Mappe (solo click-to-load, §10.2). URL embed Google Maps già usati dal sito attuale (riutilizzabili): + - Montegrosso: `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` + - Asti: `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` + - Link esterni "Apri in Google Maps" / "Apri in OpenStreetMap": costruiscili per **indirizzo** (query URL-encoded), non per coordinate (le coordinate non sono verificate). + +### 4.7 Link utili (pagina dedicata, URL aggiornati; il link checker deve confermarli) + +| Ente | Descrizione (riscrivere in 1–2 righe) | URL | +|---|---|---| +| Agenzia delle Entrate | Sito ufficiale: modelli, software, scadenze, circolari, risoluzioni, dichiarazioni online, novità fiscali | https://www.agenziaentrate.gov.it | +| Scadenzario fiscale | Scadenze divise per imposta, categoria di contribuente e data | https://www.agenziaentrate.gov.it/portale/scadenzario (verificare; in caso di 404 usare la pagina dello scadenzario raggiungibile dal sito AE) | +| Camera di Commercio di Alessandria-Asti | Ente camerale competente per le province di Alessandria e Asti (ex CCIAA di Asti): servizi alle imprese, Registro Imprese, news | https://www.aa.camcom.it | +| Enasarco | Ente Nazionale di Assistenza per gli Agenti e Rappresentanti di Commercio: previdenza e assistenza degli agenti | https://www.enasarco.it | +| INPS | Istituto Nazionale Previdenza Sociale | https://www.inps.it | +| INAIL | Istituto Nazionale Assicurazione Infortuni sul Lavoro: prevenzione, sicurezza, assicurazione | https://www.inail.it | +| ISTAT | Istituto Nazionale di Statistica: dati e analisi della statistica ufficiale | https://www.istat.it | +| Regione Piemonte | Informazioni regionali, notizie, modulistica | https://www.regione.piemonte.it | + +Tutti i link esterni: `rel="noopener"`, apertura nella stessa scheda (niente `target="_blank"` forzato) oppure, se si sceglie una nuova scheda, indicarlo con icona + testo per screen reader. + +### 4.8 Meta SEO attuali (da migliorare, mantenendo le parole chiave) + +- Home — title: «Studio Ezio Grasso - Studio Tributario e Societario, consulenza fiscale e tributaria»; description: lo studio presta consulenza fiscale, societaria e tributaria e si occupa di contabilità fiscale. +- Lo studio — «Chi siamo | Studio Ezio Grasso»; description: opera ad Asti e Montegrosso d'Asti, consulenze fiscali e tributarie, contabilità, centro autorizzato CAF. +- Servizi — «I nostri servizi | Studio Ezio Grasso»; description: consulenza fiscale, tributaria e societaria, contabilità fiscale, contenzioso tributario, centro CAF. +- Contatti — «Contatti | Studio Ezio Grasso»; description: disponibilità a rispondere a dubbi, domande e richieste di preventivo senza impegno. +- Dove siamo — «Dove siamo | Studio Ezio Grasso»; description: sede principale di Montegrosso d'Asti, Asti su appuntamento. +- Link utili — «Link utili | Studio Ezio Grasso»; description: link a scadenze, moduli, circolari, news di Regione Piemonte e Asti. + +Nuovi title: formato `«Titolo pagina» — Studio Grasso | Studio Tributario e Societario, Asti`, max ~60 caratteri; description uniche, 120–155 caratteri, con località (Asti, Montegrosso d'Asti) e servizi. + +### 4.9 Aggiornamenti normativi/terminologici da applicare ai contenuti (proposte: applicale e registrale in `TODO-STUDIO.md` → «Consigliato: confermare») + +| Nel sito attuale | Nel nuovo sito | Motivo | +|---|---|---| +| «Commissioni Provinciali e Regionali» (tributarie) | «Corti di Giustizia Tributaria di primo e secondo grado» | L. 130/2022 ha ridenominato le Commissioni tributarie | +| «Studi di settore» | «ISA — Indici Sintetici di Affidabilità fiscale» | Gli studi di settore sono stati sostituiti dagli ISA | +| «INTRA CEE – ESTEROMETRO – IMU – TASI» | «INTRASTAT, comunicazione delle operazioni transfrontaliere (ex esterometro), IMU» | TASI abolita dal 2020 (L. 160/2019); esterometro assorbito dalla trasmissione via SdI dal 2022 | +| «Assegno per il nucleo familiare con tre figli minori» | «Assistenza per la domanda di Assegno Unico e Universale»; mantenere «assegno di maternità dei Comuni» | L'AUU (D.Lgs. 230/2021) ha sostituito l'assegno ANF dei Comuni | +| «Bonus energia/bonus gas… solo con i comuni convenzionati» | «Bonus sociale luce e gas: riconosciuto automaticamente tramite DSU/ISEE» | Dal 2021 il bonus sociale è automatico con ISEE | +| «8 e 5 x 1000 da CUD», «2 x mille ai partiti» | «Scelta dell'8, 5 e 2 per mille (da Certificazione Unica)» | Il CUD è stato sostituito dalla CU | +| «Modello ISE – ISEE» | «DSU per l'ISEE» | Terminologia corrente | +| «Camera di Commercio di Asti» | «Camera di Commercio di Alessandria-Asti (sede di Asti)» | Accorpamento del 1° ottobre 2020 | +| «smart card» | «dispositivi di firma digitale (smart card / token)» | Terminologia corrente | +| «Cap.Gain» | «capital gain» | Grafia | +| `Copyright 2016` | anno corrente generato a build time | — | + +--- + +## 5. Architettura dell'informazione + +### 5.1 Sitemap e URL (tutti con trailing slash) + +| Pagina | URL | Note | +|---|---|---| +| Home | `/` | §7.1 | +| Lo studio | `/studio/` | chi siamo, valori, professionisti, abilitazioni (complete), partner | +| Servizi (hub) | `/servizi/` | intro + 6 card; ogni card ha `id` = `anchorLegacy` (§5.3) | +| Servizio (dettaglio ×6) | `/servizi//` | generati dalla collection; sidebar con elenco servizi + CTA; prev/next | +| Contatti | `/contatti/` | recapiti, orari, form (§10.1), mappa click-to-load | +| Dove siamo | `/dove-siamo/` | due sedi, orari, mappe click-to-load, link indicazioni | +| Link utili | `/link-utili/` | §4.7 | +| Privacy policy | `/privacy-policy/` | §8.3 | +| Cookie policy | `/cookie-policy/` | §8.4 | +| Note legali | `/note-legali/` | §8.5 | +| Accessibilità | `/accessibilita/` | §8.6 (dichiarazione volontaria) | +| 404 | `/404.html` | branded, link alle sezioni principali | + +### 5.2 Navigazione + +- **Header:** logo (→ home) · Lo studio · Servizi (con sottomenu dei 6 servizi, accessibile da tastiera, `aria-expanded`) · Contatti · Dove siamo · Link utili · numero di telefono (`tel:`) · CTA «Richiedi un preventivo» (→ `/contatti/`). Header sticky; su mobile: logo + pulsante menu (`aria-controls`, `aria-expanded`, chiusura con Esc, focus gestito), menu a tutto schermo con le stesse voci e il telefono. +- **Topbar** (solo ≥ 960 px): indirizzi delle due sedi · telefono · e-mail. +- **Footer** (4 colonne + riga legale, §7.7). +- **Breadcrumb** su tutte le pagine interne (anche in JSON-LD). + +### 5.3 Continuità con il vecchio sito (redirect) + +Il vecchio sito usa URL senza trailing slash e anchor sulla pagina servizi. Garantire: +- `.htaccess`: `Redirect 301 /privacy /privacy-policy/`; `DirectorySlash On` (default Apache) copre `/studio` → `/studio/`, `/servizi`, `/contatti`, `/dove-siamo`, `/link-utili`. +- `/servizi/` contiene sei elementi con `id` uguale agli `anchorLegacy` di §4.5, così i vecchi link `#…` atterrano sulla card giusta; lo script `legacy-anchors.ts` (progressive enhancement) reindirizza `location.hash` noti alla pagina di dettaglio corrispondente. +- Mantenere l'indicizzazione: `sitemap-index.xml`, `robots.txt` con `Sitemap:`. + +--- + +## 6. Design system + +I mockup (Appendice A) e il CSS di riferimento (Appendice B) definiscono l'aspetto. **La specifica scritta prevale sui mockup** dove differiscono. + +### 6.1 Principi +- Sobrio, ordinato, molto arioso: una colonna di lettura larga al massimo 68 caratteri per i testi lunghi; sezioni separate da fondi alternati (bianco / carta calda / tinta fredda). +- Gerarchia tipografica netta: titoli in serif (Fraunces) per carattere e autorevolezza; testo in Inter per leggibilità. +- Un solo accento (oro brunito) usato con parsimonia: eyebrow, icone, dettagli, bottone CTA sulla banda navy. +- Movimento minimo: solo transizioni di hover (≤ 200 ms) e rispetto di `prefers-reduced-motion`. + +### 6.2 Token (riprodurre in `src/styles/tokens.css`) + +| Token | Valore | Uso | +|---|---|---| +| `--navy-900` | `#0b1f33` | topbar, footer, testo su chiaro | +| `--navy-800` | `#0f2a44` | colore primario: bottoni, mark del logo, banda CTA | +| `--navy-700` | `#163a5c` | link, icone, hover | +| `--navy-100` / `--navy-050` | `#e6edf5` / `#f2f6fa` | tinte fredde (sfondi sezione, hover nav, icon tile) | +| `--gold-700` | `#8a6a1e` | accento **su testo** (contrasto AA su bianco) | +| `--gold-500` | `#b8902e` | accento decorativo, bottone gold su navy | +| `--gold-300` / `--gold-100` | `#e3c878` / `#f7efd9` | dettagli, sfondi chip | +| `--paper` | `#f6f3ec` | sezioni a tinta calda | +| `--ink-900` / `--ink-700` / `--ink-600` / `--ink-400` | `#16202a` / `#33404c` / `#4f5b66` / `#8a949e` | testo, testo secondario, meta | +| `--line` | `#dde3ea` | bordi | +| `--success` / `--error` | `#1e7b4f` / `#b42318` | stati form | +| Font | `Fraunces` (titoli, peso 500–600), `Inter` (testo) | `font-display: swap`, preload | +| Scala | h1 `clamp(2.25rem, 1.4rem + 2.6vw, 3.5rem)`, h2 `clamp(1.75rem, 1.3rem + 1.6vw, 2.5rem)`, h3 `1.3125rem`, body `1.0625rem/1.65`, small `0.9rem`, eyebrow `0.8125rem` maiuscolo tracking `0.12em` | | +| Spaziatura | scala 4/8/12/16/24/32/48/64/96 px; sezioni `padding-block: clamp(3.5rem, 7vw, 6rem)` | | +| Raggi | 8 / 12 / 20 px, pill per i bottoni | | +| Ombre | `--shadow-sm` e `--shadow-md` (vedi Appendice B) | | +| Container | max 1200 px, gutter `clamp(1rem, 4vw, 2rem)` | | +| Breakpoint | 640 px (mobile), 960 px (tablet → desktop) | | + +Contrasto minimo 4.5:1 per tutto il testo (gold-500 mai come colore di testo normale). + +### 6.3 Componenti (nomi file in §3.2) +- **Logo**: mark = quadrato arrotondato navy (44 px, raggio 10) con «G» in Fraunces bianco e un quadratino oro in basso a destra; wordmark «Studio Grasso» (Fraunces 600) + «TRIBUTARIO E SOCIETARIO» (Inter 600, 0.65rem, tracking 0.16em, grigio). Varianti: su fondo scuro (mark oro con «G» navy, wordmark bianco). File: `src/assets/logo.svg`, `logo-mark.svg`; da esso genera `favicon.svg`, `favicon.ico`, `apple-touch-icon.png`, `og-default.png` (1200×630: fondo navy, logo, payoff, città). +- **Bottoni**: primary (navy pieno), outline (bordo navy), gold (su fondo navy), ghost-light (su fondo navy), size sm. Pill, 1.5 px bordo, focus visibile oro. +- **Card servizio**: icon tile 48 px, titolo h3, sommario, link «Approfondisci →»; hover: leggero sollevamento. +- **Card professionista**: avatar con iniziali (sostituibile con foto), nome, ruolo in oro, elenco qualifiche, P.IVA in meta. +- **Badge abilitazione**: icon tile navy 40 px con icona oro, testo dell'abilitazione, etichetta maiuscola con il nome del professionista. +- **Card sede**: icona pin, nome sede, indirizzo (`
`), blocco mappa click-to-load, orari, bottone «Indicazioni stradali». +- **Banda CTA**: fondo navy, titolo «Sei interessato ad uno dei nostri servizi?», testo, bottone gold «Richiedi un preventivo» + bottone ghost con telefono. +- **Form contatti** (§10.1), **MapConsent** (§10.2), **Breadcrumb**, **SectionHead** (eyebrow + h2 + sottotitolo), **Chip** (valori). + +### 6.4 Tono del copy +- Italiano chiaro, professionale, senza gergo inutile e senza superlativi; frasi brevi; seconda persona singolare per le CTA («Richiedi un preventivo», «Contattaci»), coerente in tutto il sito. +- Ogni pagina: un solo `

`; eyebrow sopra i titoli di sezione; sommari ≤ 160 caratteri. +- Nessuna promessa di tempi di risposta o risultati; consentito «ti rispondiamo nel più breve tempo possibile» (presente nel sito attuale). + +--- + +## 7. Specifica pagina per pagina + +### 7.1 Home (`/`) — ordine delle sezioni + +``` +┌──────────────────────────────────────────────────────────────────────────┐ +│ TOPBAR 📍 Via XX Settembre 163, Montegrosso 📍 Piazza Medici 4, Asti ☎ +39 0141 951382 ✉ info@… │ +├──────────────────────────────────────────────────────────────────────────┤ +│ [G] Studio Grasso Lo studio Servizi ▾ Contatti Dove siamo Link utili ☎ 0141 951382 [Richiedi un preventivo] │ +├──────────────────────────────────────────────────────────────────────────┤ +│ HERO (fondo gradiente navy-050→bianco) │ +│ — STUDIO TRIBUTARIO E SOCIETARIO · MONTEGROSSO D'ASTI E ASTI │ ┌ fact: Due sedi ┐ +│ H1 Consulenza fiscale, tributaria e societaria per │ │ fact: contenzioso │ +│ *imprese, professionisti e privati* │ │ fact: CAF │ +│ lead (2–3 righe) [Richiedi un preventivo gratuito →] [Scopri i servizi] │ └ (su blob navy + anello oro) ┘ +│ ✓ Difensore tributario abilitato MEF ✓ Dottore Commercialista ODCEC Asti ✓ Centro Autorizzato CAF │ +├──────────────────────────────────────────────────────────────────────────┤ +│ SERVIZI — Aree di competenza (eyebrow, h2, sottotitolo) │ +│ [card] [card] [card] │ +│ [card] [card] [card] │ +├──────────────────────────────────────────────────────────────────────────┤ +│ LO STUDIO (fondo carta) — testo + chip valori + [Scopri lo studio →] │ [card Dott. Ezio Grasso] │ +│ │ [card Dott.ssa Giulia Grasso] │ +├──────────────────────────────────────────────────────────────────────────┤ +│ CREDENZIALI — Abilitazioni e iscrizioni: 9 badge in griglia 3×3 │ +├──────────────────────────────────────────────────────────────────────────┤ +│ RETE DI PROFESSIONISTI (fondo tinta fredda) — 4 partner in riga │ +├──────────────────────────────────────────────────────────────────────────┤ +│ BANDA CTA navy — «Sei interessato…?» [Richiedi un preventivo →] [☎ +39 0141 951382] │ +├──────────────────────────────────────────────────────────────────────────┤ +│ DOVE SIAMO — [card sede Montegrosso | mappa click-to-load | orari] [card sede Asti | mappa | su appuntamento] │ +├──────────────────────────────────────────────────────────────────────────┤ +│ FOOTER 4 colonne (Studio · Contatti · Servizi · Orari) + riga legale │ +└──────────────────────────────────────────────────────────────────────────┘ +``` + +Dettagli: +- Hero: eyebrow «Studio Tributario e Societario · Montegrosso d'Asti e Asti»; H1 «Consulenza fiscale, tributaria e societaria per imprese, professionisti e privati» (corsivo sulla seconda parte); lead che sintetizza §4.4 (dalla forma giuridica al contenzioso, un unico interlocutore, rapidità e affidabilità); CTA primaria → `/contatti/`, secondaria → `/servizi/`; riga di fiducia con tre voci **vere** (§4.2). Lato destro: illustrazione originale in CSS/SVG (blob navy + anello oro) con tre "fact card" (Due sedi, Assistenza nel contenzioso in ogni grado di giudizio, Centro Autorizzato CAF); su mobile le card si impilano e il blob sparisce. +- Sezione servizi: 6 card da `src/content/servizi` (titolo, sommario, icona) → `/servizi//`. +- Sezione studio: copy originale da §4.4; chip Efficienza · Professionalità · Trasparenza · Rapporto di fiducia; card dei due professionisti (§4.2). +- Abilitazioni: 9 badge (§4.3) nell'ordine indicato. +- Partner: 4 voci (§4.4). +- Dove siamo: due card sede con mappa click-to-load (§10.2) e orari. + +### 7.2 Lo studio (`/studio/`) +Page head (breadcrumb, h1 «Lo studio», sottotitolo) → sezione «Chi siamo» (3–4 paragrafi originali da §4.4, max 68 caratteri per riga; spazio per una foto della sede fornita dallo studio: finché manca, usare un'illustrazione SVG originale astratta, non un placeholder grigio) → «I nostri valori» (4 chip/card) → «I professionisti» (2 card estese con tutte le qualifiche di §4.2 e P.IVA) → «Abilitazioni e iscrizioni» (9 badge) → «I nostri partner» (4 voci, con l'elenco ampio delle collaborazioni di §4.4) → banda CTA. + +### 7.3 Servizi hub (`/servizi/`) +Page head (h1 «I nostri servizi», sottotitolo «Consulenza e assistenza in campo tributario, societario, contabile e fiscale») → griglia 6 card (ogni card con `id=""`) → banda CTA. + +### 7.4 Servizio dettaglio (`/servizi//`) + +``` +┌ PAGE HEAD (tinta fredda): breadcrumb Home / Servizi / Titolo · H1 · sottotitolo ┐ +├───────────────────────────┬────────────────────────────────────────────────┤ +│ SIDEBAR sticky │ CONTENUTO │ +│ TUTTI I SERVIZI │ h2 Gruppo (es. Consulenza fiscale) │ +│ ▸ corrente evidenziata │ paragrafo intro │ +│ … │ ✓ voce ✓ voce (checklist a 2 colonne) │ +│ [CTA navy: Hai bisogno di │ h2 Gruppo successivo … │ +│ una consulenza? Contattaci│ │ +│ +39 0141 951382] │ ← Precedente | Successivo → │ +└───────────────────────────┴────────────────────────────────────────────────┘ +│ BANDA CTA │ FOOTER +``` +Contenuti integrali da §4.5; il markdown della collection usa `##` per i gruppi e liste puntate per le voci (il layout le trasforma in checklist con icona). + +### 7.5 Contatti (`/contatti/`) +Page head → griglia 2 colonne: a sinistra card «Le sedi», «Recapiti» (telefoni `tel:`, fax, e-mail `mailto:`, due PEC), «Orari»; a destra il form (§10.1) oppure, se il form è disattivato, una card «Scrivici una e-mail» con bottone `mailto:` (oggetto precompilato «Richiesta di informazioni dal sito») → sezione «Come raggiungerci» con mappa click-to-load (§10.2) → footer. + +### 7.6 Dove siamo (`/dove-siamo/`) +Page head (h1 «Dove siamo», testo: sede principale a Montegrosso d'Asti, Asti su appuntamento) → due card sede complete (indirizzo, orari/appuntamento, mappa click-to-load, bottoni «Apri in Google Maps», «Apri in OpenStreetMap», «Chiama») → recapiti → banda CTA. + +### 7.7 Footer (tutte le pagine) +Colonna 1: logo, una riga di descrizione, i due indirizzi. Colonna 2 «Contatti»: 2 telefoni, fax, e-mail, 2 PEC. Colonna 3 «Servizi»: 6 link. Colonna 4 «Orari»: lun–ven 9:00–12:30 | 15:00–18:30, Asti su appuntamento. Riga legale: `© Studio Grasso — P.IVA 01597790052 — Tutti i diritti riservati` + link Privacy policy · Cookie policy · Note legali · Accessibilità. + +### 7.8 Link utili, pagine legali, 404 +- Link utili: elenco di card (nome ente, descrizione, link con dominio visibile). +- Pagine legali: layout "documento" a colonna singola (max 68 ch), indice interno, data di ultimo aggiornamento, contenuti §8. +- 404: titolo «Pagina non trovata», link a Home/Servizi/Contatti, ricerca non necessaria. + +--- + +## 8. Conformità legale (Italia) — requisiti e contenuti delle pagine legali + +> I testi legali vanno redatti in italiano, chiari e completi, **solo sui trattamenti e sulle tecnologie realmente presenti nel sito**. Lo studio li farà validare: in `TODO-STUDIO.md` inserisci «Far validare privacy policy, cookie policy e note legali» (consigliato) e i dati mancanti (bloccante). + +### 8.1 Obblighi informativi "aziendali" +- **P.IVA nella home page** (art. 35, co. 1, D.P.R. 633/1972): presente nel footer di ogni pagina, compresa la home, come testo (non immagine). +- **Se il titolare del sito è una società** (ipotesi «Studio Tributario Grasso S.r.l.», §4.1): negli atti, nella corrispondenza e **nel sito web** vanno indicati sede, ufficio del Registro delle Imprese e numero di iscrizione (REA), capitale sociale versato, eventuale stato di liquidazione, eventuale socio unico (art. 2250 c.c.). Dati non disponibili → TODO-STUDIO bloccante; prevedi i campi in `studio.ts` e nella pagina Note legali in modo che compaiano appena valorizzati. +- **Professionista non ordinistico (tributarista, L. 4/2013):** nei documenti e rapporti scritti con il cliente, compreso il sito, va fatto «espresso riferimento agli estremi della legge» (art. 1, co. 3, L. 4/2013). Inserire nella scheda del Dott. Ezio Grasso e nelle Note legali: «Professionista di cui alla Legge 14 gennaio 2013, n. 4 — iscritto all'Istituto Nazionale Tributaristi (I.N.T.) al n. 1535». +- **Dottore Commercialista:** la pubblicità informativa è libera ma deve essere veritiera, corretta, non equivoca, non ingannevole, non denigratoria (art. 4 D.P.R. 137/2012 e Codice deontologico CNDCEC vigente). Indicare sempre Ordine e numero di iscrizione (§4.2). Niente comparazioni, niente promesse di risultato, niente tariffe «da». +- **Polizza RC professionale**: l'obbligo è di comunicarne gli estremi al cliente (art. 9, co. 4, D.L. 1/2012), non di pubblicarli sul sito; prevedi un campo facoltativo in `studio.ts`/Note legali (TODO-STUDIO: consigliato). +- **Titolo "Dott."** e qualifiche: usare esattamente le diciture di §4.2; mai attribuire qualifiche non dichiarate (§2.2). + +### 8.2 Privacy e cookie — impostazione tecnica (zero tracciamento) +- Nessun cookie impostato dal sito (verificato da test §11.4). L'eventuale memorizzazione della scelta «mappa caricata» avviene in `sessionStorage` (tecnico, nessun dato personale). +- Nessuna richiesta verso domini terzi al caricamento delle pagine (test §11.4). Google Maps solo dopo click esplicito sul pulsante del blocco mappa, con testo che avvisa del trasferimento di dati a Google e link alla Cookie policy. +- Nessun banner cookie: non necessario in assenza di cookie non tecnici (Linee guida del Garante del 10 giugno 2021). Non aggiungerlo. +- Form contatti: informativa breve sotto il form + link alla Privacy policy + checkbox obbligatoria di presa visione; protezione anti-spam senza cookie e senza servizi terzi (honeypot + controllo tempo minimo di compilazione); nessun reCAPTCHA. +- `.htaccess`: header di sicurezza (§9.4) e Content-Security-Policy che consente `frame-src https://www.google.com` solo per la mappa. + +### 8.3 Privacy policy (`/privacy-policy/`) — struttura obbligatoria (Reg. UE 2016/679, artt. 13 ss.; D.Lgs. 196/2003 come modificato dal D.Lgs. 101/2018) +1. Titolare del trattamento: Studio Grasso (denominazione esatta da TODO-STUDIO), Via XX Settembre 163, 14048 Montegrosso d'Asti (AT), e-mail info@studiograssoezio.it, PEC studiotributariograssosrl@pec.it. Nessun DPO (non designato: non citarlo). +2. Tipologie di dati e finalità: + - *Dati di navigazione* (log del server di hosting: IP, user agent, pagine, orari): finalità di sicurezza e corretto funzionamento; base giuridica legittimo interesse (art. 6.1.f); conservazione limitata secondo le policy dell'hosting (indicare il fornitore quando scelto → TODO-STUDIO). + - *Dati del modulo di contatto* (nome e cognome, e-mail, telefono, oggetto, messaggio): finalità di rispondere alla richiesta e gestire il contatto precontrattuale; base giuridica art. 6.1.b (misure precontrattuali) e, per quanto non necessario, consenso; conservazione per il tempo necessario a gestire la richiesta e comunque non oltre 12 mesi, salvo instaurazione di un rapporto professionale (termini da confermare con lo studio). + - *Cookie e strumenti analoghi*: rimando alla Cookie policy. +3. Natura del conferimento e conseguenze del rifiuto (campi obbligatori del form). +4. Destinatari: fornitore di hosting e di posta elettronica (responsabili del trattamento), autorità competenti nei casi di legge; nessuna diffusione. +5. Trasferimenti extra-UE: nessuno per impostazione predefinita; Google Maps solo su azione dell'utente (rinvio alla Cookie policy). +6. Diritti dell'interessato (artt. 15–22 GDPR), revoca del consenso, reclamo al Garante per la protezione dei dati personali (www.garanteprivacy.it). +7. Minori: il sito non è destinato a minori. +8. Data di ultimo aggiornamento (generata a build time dal frontmatter, non dinamica). + +### 8.4 Cookie policy (`/cookie-policy/`) +- Dichiarare: il sito non utilizza cookie di profilazione né di analisi; non installa cookie al caricamento; eventuale memorizzazione tecnica locale della scelta mappa (sessionStorage); la mappa Google Maps è caricata solo su richiesta e in quel caso Google può installare cookie e trattare dati secondo la propria informativa (link a https://policies.google.com/privacy); istruzioni sintetiche per gestire i cookie nei principali browser; riferimento all'art. 122 del Codice privacy e alle Linee guida del Garante 10 giugno 2021; data di aggiornamento. + +### 8.5 Note legali (`/note-legali/`) +- Titolare del sito: denominazione, sede, P.IVA 01597790052, C.F. (se diverso, TODO), PEC, telefono; dati societari ex art. 2250 c.c. (se società; vedi §8.1). +- Professionisti: schede con titoli, Ordine/elenco e numeri di iscrizione (§4.2), riferimento L. 4/2013 per il tributarista, eventuale polizza RC. +- Contenuti del sito: informazioni di carattere generale che non costituiscono consulenza professionale né parere; lo studio non risponde di usi impropri; i link esterni sono forniti a titolo informativo. +- Proprietà intellettuale: testi, grafica e logo dello studio; marchi e denominazioni di enti citati appartengono ai rispettivi titolari. +- Foro/legge applicabile: legge italiana (clausola semplice, nessun foro esclusivo invalido). +- Credits tecnici (facoltativo, una riga). + +### 8.6 Accessibilità (`/accessibilita/`) +Pagina volontaria (lo studio non rientra nei soggetti obbligati dalla L. 4/2004 né dal D.Lgs. 82/2022 per un sito informativo): obiettivo WCAG 2.1 livello AA, tecnologie usate, limiti noti, recapito per segnalazioni (info@studiograssoezio.it), data di verifica. Non chiamarla «Dichiarazione di accessibilità AgID». + +### 8.7 Altri punti +- `meta viewport` standard, **senza** `user-scalable=no` / `maximum-scale`. +- Nessun testo legale copiato dal vecchio sito (era generico e citava servizi inesistenti): scrivere ex novo. +- `docs/CONFORMITA.md`: tabella requisito → norma → dove è implementato → stato (fatto / richiede dato dallo studio). + +--- + +## 9. SEO, performance, accessibilità + +### 9.1 SEO tecnica +- `lang="it"`, title e description uniche per pagina (§4.8), canonical assoluto da `SITE_URL`, Open Graph + Twitter card con `og-default.png`, `robots.txt` (Allow all + Sitemap), `@astrojs/sitemap`, `404.html`, URL puliti con trailing slash, redirect §5.3, un solo `

` per pagina, heading in ordine, `rel="noopener"` sugli esterni, `hreflang` non necessario (solo italiano). + +### 9.2 Dati strutturati (JSON-LD in `BaseLayout`) +- Home e tutte le pagine: `AccountingService` (schema.org) con `name` «Studio Grasso — Studio Tributario e Societario», `url`, `telephone` «+39 0141 951382», `email`, `vatID` «IT01597790052», `address` (sede principale, `PostalAddress`), `location` aggiuntiva per Asti, `openingHoursSpecification` (Mo–Fr 09:00–12:30 e 15:00–18:30), `areaServed` «Asti e provincia», `founder`/`employee` come `Person` con `jobTitle` esatti (§4.2), `sameAs` vuoto (nessun social). +- Pagine servizio: `Service` (`name`, `description`, `provider` → l'organizzazione, `areaServed`). +- Tutte le interne: `BreadcrumbList`. +- Validità: il test di conformità (§11.5) verifica che ogni JSON-LD sia JSON valido con `@context`/`@type` e che i campi sopra siano presenti. + +### 9.3 Performance (budget verificato da Lighthouse CI, §11.6) +- Lighthouse (mobile, pagine: home, servizi hub, un servizio, contatti): Performance ≥ 0.95, Accessibility = 1.0, Best Practices ≥ 0.95, SEO = 1.0. +- Budget: HTML + CSS per pagina ≤ 120 KB non compressi; JS totale ≤ 15 KB; font ≤ 2 file principali (≈ 100 KB); immagini responsive con `width/height` e `loading="lazy"` sotto la piega; nessuna richiesta esterna. +- `.htaccess`: compressione (deflate/brotli se disponibili), `Cache-Control` lungo per asset con hash, breve per HTML. + +### 9.4 Sicurezza (`public/.htaccess`, tutto dentro `` per compatibilità con hosting condivisi) +- Redirect HTTP → HTTPS e `www`/non-`www` secondo `SITE_URL` (commentato con istruzioni se l'hosting lo gestisce da pannello). +- 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'`, `X-Content-Type-Options: nosniff`, `Referrer-Policy: strict-origin-when-cross-origin`, `Permissions-Policy` restrittiva, `X-Frame-Options: SAMEORIGIN`, HSTS commentato (da attivare quando HTTPS è certo). Se Astro inietta script o stili inline, preferisci spostarli in file o usa hash nella CSP; `'unsafe-inline'` è ammesso solo per `style-src`. +- `ErrorDocument 404 /404.html`; negare l'accesso a file nascosti e a `*.map`. + +### 9.5 Accessibilità (WCAG 2.1 AA, verificata da §11.3) +- Skip link, landmark (`header/nav/main/footer`), `aria-current`, focus visibile ovunque, ordine di tabulazione logico, menu mobile e sottomenu usabili da tastiera e screen reader, contrasto AA, testo ridimensionabile al 200 %, `alt` significativi o vuoti per decorative, etichette `