6
Visualizzare e provare
Alberto Balbo edited this page 2026-11-13 12:03:09 +01:00
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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

Home del sito su desktop, primo schermo: barra con gli indirizzi delle due sedi e i recapiti, intestazione bianca con il logo «Studio Grasso», il menu e il pulsante «Richiedi un preventivo», poi un riquadro navy arrotondato con il titolo «Consulenza fiscale, tributaria e societaria per imprese, professionisti e privati» (le ultime parole in corsivo oro), il pulsante oro «Richiedi un preventivo gratuito», il pulsante «Scopri i servizi» e, a destra, un anello oro con tre schede in vetro smerigliato

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

Home del sito su desktop a pagina intera: hero navy con la fascia di quattro numeri, «Aree di competenza» con sei schede in griglia (la prima, scura, alta due righe; l'ultima larga), «Come lavoriamo» con quattro passi numerati, «Lo studio» con i due professionisti, «Abilitazioni e iscrizioni» su fondo navy, «I nostri partner», banda navy «Sei interessato ad uno dei nostri servizi?», le due sedi con il pulsante «Carica la mappa» e il footer navy con il nome dello Studio in grande

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/)

Pagina «Lo studio» su desktop: testata navy con titolo e introduzione, testo «Un unico interlocutore per l'impresa e per la famiglia» con un'illustrazione, i quattro valori numerati, le schede dei due professionisti, abilitazioni e iscrizioni su fondo navy, partner e collaborazioni, banda del preventivo e footer

«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/)

Pagina «Servizi» su desktop: testata navy con il titolo «I nostri servizi», sei schede numerate in griglia (la prima, scura, alta due righe; l'ultima larga) con il link «Approfondisci», sezione «Come lavoriamo» con quattro passi, banda del preventivo e footer

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»

Pagina di dettaglio del servizio «Consulenza fiscale, tributaria e societaria» su desktop: testata navy con titolo e introduzione, elenco laterale «Tutti i servizi» con le icone e il riquadro navy «Hai bisogno di una consulenza?», sezioni numerate con le voci in piccole schede su due colonne, card dei servizi precedente e successivo, banda del preventivo e footer

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/)

Pagina «Contatti» su desktop: testata navy con titolo e introduzione, schede «Le sedi», «Recapiti» e «Orari», scheda «Scrivici una e-mail» con il pulsante dell'indirizzo, sezione «Come raggiungerci» con il riquadro della mappa da caricare, pulsanti «Apri in Google Maps» e «Apri in OpenStreetMap», link «Tutte le sedi e le indicazioni stradali» e footer navy

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/)

Pagina «Dove siamo» su desktop: testata navy con titolo e introduzione, due schede, una per la sede di Montegrosso d'Asti e una per la sede di Asti, ciascuna con il riquadro della mappa da caricare, i pulsanti «Apri in Google Maps» e «Apri in OpenStreetMap», gli orari o il ricevimento e i pulsanti «Indicazioni stradali» e «Chiama»; sotto, la sezione «Per un appuntamento» con recapiti e orari, poi la banda del preventivo e il footer

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.

Home (/) Contatti (/contatti/)
Home del sito su telefono (390 px), parte alta: intestazione con il logo e il pulsante del menu, riquadro navy con il titolo «Consulenza fiscale, tributaria e societaria per imprese, professionisti e privati», testo introduttivo, due pulsanti, tre punti con segno di spunta, tre schede informative e i quattro numeri su due colonne; sotto, l'inizio di «Aree di competenza» Pagina «Contatti» su telefono (390 px), parte alta: testata navy con titolo e introduzione, poi le schede «Le sedi», «Recapiti» e «Orari» una sotto l'altra e l'inizio della scheda «Scrivici una e-mail»
Intestazione compatta con menu ☰, hero navy con titolo, pulsanti, tre schede e i numeri, poi l'inizio delle aree di competenza. Schede «Le sedi», «Recapiti» e «Orari» in colonna unica, poi «Scrivici una e-mail».

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)

  1. 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 zip sito-studio-grasso-v1.0.0.zip. Dalla 1.0.1 lo zip (per esempio sito-studio-grasso-v1.1.0.zip) è l'unico allegato (vedi CI e release).
  2. Estrai lo zip in una cartella vuota: il sito è alla radice dell'archivio (index.html, .htaccess, cartelle delle pagine, _astro/).
  3. Servi la cartella con un piccolo server web locale. Aprire index.html con 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).
  4. 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-3 apre 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.