Files
Alby96andClaude Sonnet 5.5 31ac5b7f68
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Canceled after 40m56s
CI / Link esterni (non bloccante) (push) Canceled after 0s
ci: Gitea Actions, release con il solo zip del sito e documentazione senza Forgejo
Il progetto vive in modo definitivo su Gitea: i workflow passano da .forgejo/ a
.gitea/workflows/ e la documentazione non nomina più la piattaforma precedente.

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

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

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 11:15:08 +02:00

9.0 KiB
Raw Permalink Blame History

Aggiornare i contenuti del sito

Guida per lo Studio: dove si trovano i testi e i dati e come modificarli. Non serve conoscere la programmazione, ma bisogna rispettare la forma dei file (virgolette, virgole, trattini all'inizio delle righe degli elenchi).

Come si modifica un file

Dal browser (consigliato): aprire il repository su Gitea, entrare nel file, premere l'icona a forma di matita («Modifica file»), fare la modifica, scrivere in basso una breve descrizione (es. docs: aggiorna orari di agosto) e confermare con Commit. La verifica automatica (CI) parte da sola: dopo qualche minuto, nella scheda Actions, un segno verde indica che è tutto a posto; una croce rossa indica un errore, con la spiegazione nel dettaglio dell'esecuzione.

Dal computer: modificare il file con un editor di testo (es. Visual Studio Code), poi npm run verify e commit.

Le modifiche diventano visibili sul sito solo dopo una nuova release e il suo caricamento sull'hosting (vedi in fondo).

Dove si trovano i contenuti

Cosa File
Recapiti, indirizzi, orari, P.IVA, PEC src/data/studio.ts (parte iniziale, oggetto studio)
Professionisti e qualifiche src/data/studio.ts (professionisti)
Abilitazioni e iscrizioni (i 9 riquadri) src/data/studio.ts (abilitazioni)
Valori, partner, collaborazioni src/data/studio.ts (valori, partner, collaborazioni)
Servizi (un file per ogni pagina di servizio) src/content/servizi/*.md
Link utili src/content/link-utili.json
Privacy policy, Cookie policy, Note legali, Accessibilità src/content/legali/*.md
Testi delle pagine (home, Lo studio, Contatti…), titoli e descrizioni per Google src/data/pagine.ts
Banda «Sei interessato…», testi della mappa e del modulo src/data/testi.ts
Voci del menu src/data/navigazione.ts

Recapiti e orari (src/data/studio.ts)

I valori sono tra apici: si modifica solo il testo tra gli apici, lasciando apici e virgola finale.

email: 'info@studiograssoezio.it',
  • Telefono: ogni numero ha due forme: display (come appare, con spazi) ed e164 (per la chiamata, solo + e cifre): { display: '+39 0141 951382', e164: '+390141951382' },
  • Orari: nell'oggetto orari le fasce sono in formato 24 ore ('09:00'); i testi giorni, giorniEsteso, giorniBreve e notaAsti sono quelli mostrati. Se cambiano i giorni di apertura, aggiornare insieme ai tre testi anche giorniSettimana, l'elenco in inglese usato dai motori di ricerca (es. ['Monday', 'Tuesday', 'Wednesday', 'Thursday'] per «dal lunedì al giovedì»).
  • Indirizzo di una sede: si modifica solo in indirizzo; la ricerca per le indicazioni stradali, i link a Google Maps e OpenStreetMap e il titolo della mappa si aggiornano da soli. Vanno invece cambiati a mano mappa.embedUrl (su Google Maps: Condividi → Incorpora una mappa, poi copiare l'indirizzo dopo src=") e la descrizione della pagina «Dove siamo» in src/data/pagine.ts (doveSiamoPagina), che cita le vie.
  • Dati mancanti: i campi con null (es. denominazione: null) non compaiono sul sito finché non vengono compilati: scrivere il valore tra apici al posto di null, es. denominazione: 'Studio Tributario Grasso S.r.l.',. L'elenco dei dati da completare è in TODO-STUDIO.md.
  • Per l'apostrofo nei testi visibili usare ’ (es. Montegrosso d’Asti).

Un dato modificato qui si aggiorna automaticamente in tutte le pagine (intestazione, footer, contatti, pagine legali, dati per i motori di ricerca), con le sole eccezioni indicate sopra per l'indirizzo. I controlli automatici leggono gli stessi dati: un orario o un recapito aggiornato non fa fallire la verifica.

Servizi (src/content/servizi/*.md)

Ogni servizio è un file con un'intestazione tra due righe --- e il testo sotto:

---
titolo: 'Contabilità fiscale'
slug: contabilita-fiscale # indirizzo: /servizi/contabilita-fiscale/ (non cambiarlo)
ordine: 2 # posizione negli elenchi
icona: calculator # nome di un'icona da https://lucide.dev/icons/
anchorLegacy: contabilita-fiscale-2 # non modificare (collegamenti del vecchio sito)
sommario: 'Testo breve della card (massimo 160 caratteri).'
sottotitolo: 'Frase sotto il titolo della pagina.'
descrizioneSeo: 'Descrizione per Google, tra 120 e 155 caratteri.'
---

Paragrafo introduttivo.

## Titolo di un gruppo

- Prima voce della lista (diventa una riga con la spunta)
- Seconda voce
  • ## all'inizio della riga crea un titolo di gruppo; - crea una voce dell'elenco.
  • Un link: [testo del link](/servizi/contenzioso-tributario/).
  • Se un campo non rispetta le regole (es. descrizione troppo lunga), la verifica si ferma e indica file e campo da correggere.
  • Nuovo servizio: copiare un file esistente, cambiare nome del file, slug, ordine e anchorLegacy (un nome nuovo qualsiasi, diverso da quelli degli altri servizi); compare da solo in menu, home, pagina Servizi e footer. I sei servizi originali non vanno eliminati: la verifica controlla che ci siano tutti.

Ogni link è un blocco tra parentesi graffe, separato dal successivo da una virgola:

{
  "id": "inps",
  "ordine": 5,
  "nome": "INPS",
  "descrizione": "Istituto Nazionale della Previdenza Sociale: pensioni, prestazioni e servizi online.",
  "url": "https://www.inps.it"
}

Gli indirizzi devono iniziare con https://. Prima di una release: npm run test:links -- --external controlla che i siti esterni rispondano.

Pagine legali (src/content/legali/*.md)

Sono scritte come i servizi (Markdown). In più contengono:

  • segnaposto tra doppie graffe, es. {{email}}, {{bloccoTitolare}}, sostituiti automaticamente con i dati di studio.ts: non cancellarli e non inventarne di nuovi (la verifica si fermerebbe). Elenco completo in src/lib/legal.ts;
  • blocchi condizionali, es. <!-- se:modulo --> … <!-- /se:modulo -->: il testo compare solo quando la condizione è vera (qui: modulo di contatto attivo).

Dopo ogni modifica sostanziale aggiornare la data aggiornato: nell'intestazione (formato AAAA-MM-GG) e far rivedere il testo al consulente privacy.

Testi delle pagine (src/data/pagine.ts)

Contiene, pagina per pagina, titoli, sottotitoli, paragrafi e i meta per i motori di ricerca: titolo (breve: «— Studio Grasso…» viene aggiunto da solo) e descrizione (tra 120 e 155 caratteri, con località e servizi). I paragrafi sono elenchi di frasi tra apici, separate da virgole.

Regole sui contenuti (verificate in automatico dove possibile):

  • solo fatti veri e verificabili: niente numeri, anni di esperienza, clienti, recensioni o superlativi;
  • titoli professionali esatti: «commercialista» solo per la Dott.ssa Giulia Grasso (ODCEC di Asti), anche nelle descrizioni per Google e nei testi alternativi delle immagini; lo Studio è «Studio Grasso — Studio Tributario e Societario»;
  • niente tariffe né promesse di risultato o di tempi di risposta (è ammesso «ti rispondiamo nel più breve tempo possibile»);
  • dare del «tu» nelle frasi rivolte al visitatore («Richiedi un preventivo»).

Immagini

Foto e loghi autorizzati vanno consegnati a chi gestisce il sito: vedi public/images/README.md.

Pubblicare le modifiche

  1. Verifica verde (segno verde nella scheda Actions, oppure npm run verify in locale).
  2. Chiedere a chi gestisce il sito di creare una nuova release (aggiornamento della versione e del CHANGELOG, poi tag: vedi README, «Fare una release»). Al termine del workflow la release compare nella sezione Release del repository, con un solo file allegato: lo zip sito-studio-grasso-vX.Y.Z.zip, che contiene il sito da caricare. Gli archivi «Source code (ZIP)» e «Source code (TAR.GZ)» che Gitea aggiunge da solo contengono il codice sorgente, non il sito: non vanno caricati sull'hosting.
  3. Caricare lo zip sito-studio-grasso-vX.Y.Z.zip sull'hosting come descritto in docs/DEPLOY.md (o automaticamente, se è stato attivato il deploy automatico).