Table of Contents
Visualizzare e provare il sito
Anteprima delle pagine
Screenshot reali della build 1.1.0, con «riduci movimento» attivo (le animazioni legate allo scorrimento sono ferme nella posizione finale) e le mappe non ancora caricate (compaiono i riquadri con «Carica la mappa»). Per provare il sito vedi le sezioni 1 e 2.
Desktop
Home (/), primo schermo
Intestazione con menu («Lo studio», «Servizi», «Contatti», «Dove siamo», «Link utili»), telefono e pulsante «Richiedi un preventivo»; sotto, l’hero su fondo navy con titolo, testo introduttivo, due pulsanti, le tre qualifiche con il segno di spunta e, a destra, tre schede: due sedi, assistenza nel contenzioso, Centro autorizzato CAF.
Home (/), pagina intera
Dall'alto: hero con i numeri (6 aree di competenza, 9 abilitazioni e iscrizioni, 2 sedi, 2 professionisti), «Aree di competenza», «Come lavoriamo», «Lo studio» con i due professionisti, «Abilitazioni e iscrizioni», «I nostri partner», banda del preventivo, «Le nostre sedi» con la mappa su richiesta, footer con la P.IVA, le pagine legali e «Torna su».
Lo studio (/studio/)
«Chi siamo», «I nostri valori» (Efficienza, Professionalità, Trasparenza, Rapporto di fiducia), «I professionisti» con le schede del Dott. Ezio Grasso e della Dott.ssa Giulia Grasso, «Abilitazioni e iscrizioni», «I nostri partner» e collaborazioni.
Servizi (/servizi/)
Le sei schede dei servizi: Consulenza fiscale, tributaria e societaria; Contabilità fiscale; Contenzioso tributario; Centro autorizzato CAF; Servizi alle imprese, dipendenti e pensionati; Certificazione atti mediante firma digitale. Sotto, i quattro passi di «Come lavoriamo».
Pagina di dettaglio di un servizio, «Consulenza fiscale, tributaria e societaria»
Percorso di navigazione, elenco laterale degli altri servizi con il riquadro «Hai bisogno di una consulenza?», sezioni numerate «Consulenza fiscale», «Consulenza tributaria», «Consulenza societaria» e «Consulenza aziendale e direzionale», card «Precedente» e «Successivo».
Contatti (/contatti/)
Il modulo di contatto è disattivato: al suo posto la scheda «Scrivici una e-mail» con il pulsante che apre il programma di posta. In fondo, la mappa su richiesta con i link a Google Maps e OpenStreetMap.
Dove siamo (/dove-siamo/)
Una scheda per sede, con mappa su richiesta, orari (ad Asti ricevimento su appuntamento) e pulsanti «Indicazioni stradali» e «Chiama»; sotto, «Per un appuntamento» con recapiti e orari.
Telefono (390 px)
Solo la parte alta delle pagine; sul sito il menu si apre dal pulsante con le tre linee.
Rigenerare le immagini
Le immagini sono state ricavate dalla build 1.1.0 e vanno rifatte dopo una modifica visibile del sito. Dalla radice del repository (serve il browser dei test, vedi la sezione 5):
npm run build
node scripts/screenshots.mjs
Lo script salva gli screenshot a pagina intera di tutte le pagine, a 1440 px (desktop) e a 390 px (telefono), in docs/screenshots/, con «riduci movimento» attivo: le animazioni legate allo scorrimento restano nella posizione finale. Le immagini di questa pagina sono ridotte e salvate in formato WebP nella cartella images/ del repository della wiki.
1. Dalla release (il modo più rapido)
- Apri l'elenco delle release, scegli la versione più recente e scarica
sito-studio-grasso-vX.Y.Z.zip. Gitea aggiunge a ogni release anche «Source code (ZIP)» e «Source code (TAR.GZ)»: sono il codice sorgente, non il sito. La versione 1.0.0 ha anche altri allegati (tar.gz, impronte SHA-256, informazioni di build) che per vedere il sito non servono: basta lo zipsito-studio-grasso-v1.0.0.zip. Dalla 1.0.1 lo zip (per esempiosito-studio-grasso-v1.1.0.zip) è l'unico allegato (vedi CI e release). - Estrai lo zip in una cartella vuota: il sito è alla radice dell'archivio (
index.html,.htaccess, cartelle delle pagine,_astro/). - Servi la cartella con un piccolo server web locale. Aprire
index.htmlcon un doppio clic non basta, perché i collegamenti partono dalla radice del sito:- con Python 3, dentro la cartella estratta:
python3 -m http.server 8080(su Windows:py -m http.server 8080); - oppure con Node.js:
npx serve .(indica l'indirizzo da aprire).
- con Python 3, dentro la cartella estratta:
- Apri http://localhost:8080 nel browser.
Un server locale non applica il .htaccess: redirect, header di sicurezza e pagina 404 personalizzata si verificano sull'hosting (checklist in Pubblicare sull'hosting).
2. Dal codice sorgente
Requisiti: Git e Node.js LTS (versione in .nvmrc: 24).
git clone https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso.git
cd Studio_Grasso
npm ci
npm run dev # http://localhost:4321, si aggiorna a ogni modifica
npm run build # versione di produzione in dist/…
npm run preview # …servita su http://127.0.0.1:4321
Con Visual Studio Code (F5)
Aprire la cartella in VS Code, eseguire una volta npm ci, poi pannello Esegui e debug (Ctrl+Maiusc+D):
- Sito: sviluppo (Edge) oppure (Chrome), poi F5: parte il server di sviluppo e, appena è pronto, si apre il browser con il debugger collegato (punti di interruzione negli script di
src/scripts/). Il sito si aggiorna a ogni modifica. - Sito: anteprima della build (Edge): compila il sito e lo mostra come sarà in produzione.
Maiusc+F5 ferma il server e chiude il browser; dopo una pausa su un punto di interruzione nel browser chiude solo il browser: premerlo una seconda volta per fermare anche il server. Se npm run dev è già aperto in un terminale, chiuderlo prima: Astro avvia un solo server di sviluppo per progetto.
3. Prova guidata (circa 10 minuti)
- Home a schermo intero e su telefono (o con gli strumenti per sviluppatori del browser a 390 px): menu ☰, sottomenu «Servizi», banda «Richiedi un preventivo», footer con la P.IVA.
- Tastiera: premi Tab dall'inizio della pagina: compare «Vai al contenuto principale» e il focus è sempre visibile; Esc chiude menu e sottomenu.
- Mappe (home, Contatti, Dove siamo): nessuna mappa finché non premi «Carica la mappa»; dopo il clic si caricano le mappe della pagina e compare «Non caricare più le mappe», che le toglie e cancella la scelta.
- Privacy: strumenti per sviluppatori → Application/Archiviazione: nessun cookie; Network/Rete: nessuna richiesta verso altri domini prima del clic sulla mappa.
- Senza JavaScript (disattivalo dalle impostazioni del browser o degli strumenti per sviluppatori): il sito resta navigabile e al posto del pulsante della mappa restano i link a Google Maps e OpenStreetMap.
- Testo ingrandito (Ctrl/Cmd + fino al 200%): nessun contenuto tagliato o sovrapposto.
- Vecchi indirizzi:
/servizi/#contenzioso-tributario-3apre la pagina «Contenzioso tributario» (collegamenti del vecchio sito). - Pagine legali: Privacy policy, Cookie policy, Note legali, Accessibilità, raggiungibili dal footer di ogni pagina.
4. Il modulo di contatto (facoltativo)
Per impostazione predefinita il modulo è disattivato e la pagina Contatti mostra il pulsante «Scrivi a info@studiograssoezio.it». Per vedere il modulo in locale, su Windows (PowerShell, anche il terminale di VS Code):
$env:CONTACT_FORM_MODE = 'php'
npm run build
npm run preview
Poi, chiuso il server con Ctrl+C: Remove-Item Env:CONTACT_FORM_MODE e npm run build. Su Linux/macOS o in Git Bash: CONTACT_FORM_MODE=php npm run build && npm run preview.
Validazione, messaggi d'errore e anti-spam si provano così; l'invio reale richiede PHP sull'hosting (docs/DEPLOY.md, sezione 6). Al termine, npm run build ripristina la versione senza modulo.
5. Test automatici
npm run verify esegue gli stessi controlli della CI. La prima volta installare il browser dei test: npx playwright install --with-deps chromium.
| Controllo | Esito (22 ottobre 2026, versione 1.0.1, in locale su Windows con Node 24, npm run verify completo) |
|---|---|
| Lint, formattazione, tipi | 0 errori |
| Validità HTML | 18 pagine, 0 errori |
| Link interni, asset e ancore | nessun link rotto |
| End-to-end (Playwright) | 39 superati, 7 saltati: sono i test del modulo di contatto attivo, che si eseguono con CONTACT_FORM_MODE=php |
| Accessibilità (axe a 1440 e 390 px, tastiera, zoom, reflow) | 51 superati |
| Conformità (P.IVA, pagine legali, nessun tracciamento, titoli professionali, CSS…) | 1455 controlli superati su 18 pagine |
| Lighthouse (4 pagine × 3 esecuzioni, mediana) | Performance 0,99–1 · Accessibilità 1 · Best Practices 1 · SEO 1 |
| Pacchetto zip | 36 file identici a dist/, circa 394 KB (limite 5 MB), unico file di release/ |
Gli stessi controlli erano stati verificati il 16 ottobre 2026 nel container Linux usato dalla CI (Playwright 1.56.1, come root); vanno riverificati con la prima esecuzione su Gitea.








