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

118 lines
7.5 KiB
Markdown
Raw Blame History

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.
# 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.
```ts
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:
```md
---
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.
## Link utili (`src/content/link-utili.json`)
Ogni link è un blocco tra parentesi graffe, separato dal successivo da una virgola:
```json
{
"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).