Files
Studio_Grasso/docs/CONTENUTI.md
T
Claude 0d0bebf708 fix: correzioni della revisione finale (testi, visuale, brief, codice)
- testi: «lo Studio» uniforme, «Centro autorizzato CAF», ripetizioni tolte
  nei servizi e in «Lo studio», valori senza superlativi, meta corrette,
  testo della mappa di §10.2, numeri e indirizzi con spazi non separabili
- visuale: breadcrumb, anello della banda CTA, card dei professionisti,
  pager e sidebar dei servizi su mobile, pagine legali a colonna singola,
  pulsante e-mail su una riga, card sedi allineate
- dati: fatti della sede di Asti da studio.ts/testi.ts, sede.telefono
- 404 e conferma senza canonical; avviso mappa senza JavaScript
- controlli: CSP per direttive (endpoint), anno da SOURCE_DATE_EPOCH,
  URL del sito controllati sulla build locale, import file:// e tar da
  stdin per Windows, .gitattributes, porta libera corretta
- modulo: pattern del telefono valido, avviso visibile, Esc sul
  sottomenu aperto al passaggio del mouse; contact.php con -f, senza
  mbstring obbligatorio, fuso Europe/Rome
- release: note --shell-safe, ripiego REST automatico, RELEASE_TOKEN;
  deploy di esempio senza esclusione di contact.php; nginx /privacy/
- DECISIONS D-040–D-044, TODO C4 e riferimenti di riga aggiornati

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
2026-10-16 00:13:01 +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, 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); 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).