- 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
118 lines
7.5 KiB
Markdown
118 lines
7.5 KiB
Markdown
# 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).
|