Files
Studio_Grasso/docs/CONTENUTI.md
T
Claude ac69a4351f fix: revisione legale e dei fatti prima del rilascio
- privacy: sezione sulle mappe di Google (consenso, contitolarità C-40/17,
  Data Privacy Framework), PEC personale della Dott.ssa Giulia Grasso,
  trasferimenti condizionati a fornitori.soloSee, art. 13, frasi sul
  consenso e sul modulo solo quando servono, grammatica dei destinatari
- mappe: avviso sulla scelta valida per tutto il sito e pulsante
  «Non caricare più le mappe» con test di revoca
- modulo: checkbox di presa visione, informativa breve dai dati dello
  Studio, nota diversa per php/endpoint, fornitori.modulo obbligatorio
  in modalità endpoint, messaggi da testi.ts
- contact.php: HMAC dell'IP con segreto casuale, cartella privata
  0700/0600 fuori dalla webroot, cancellazione dopo un'ora
- note legali e accessibilità: D.Lgs. 139/2005 e Codice deontologico,
  clausola di responsabilità, usi di JavaScript completi
- testi senza promesse di tempi; TODO B2/B3/B4/B5/C12, DECISIONS D-036–D-039

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
2026-10-15 23:35:06 +00:00

7.5 KiB
Raw 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 Forgejo, entrare nel file, premere l'icona a forma di matita («Modifica file»), fare la modifica, scrivere in basso una breve descrizione (es. docs: aggiorna orari di agosto) e confermare con Commit. La verifica automatica (CI) parte da sola: dopo qualche minuto, nella scheda Actions, un segno verde indica che è tutto a posto; una croce rossa indica un errore, con la spiegazione nel dettaglio dell'esecuzione.

Dal 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 (testo delle 6 pagine) 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.
  • 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).

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); compare da solo in menu, home, pagina Servizi e footer.

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 separati 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); 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»). La release produce lo zip da caricare.
  3. Caricare lo zip sull'hosting come descritto in docs/DEPLOY.md (o automaticamente, se è stato attivato il deploy automatico).