Files
Studio_Grasso/docs/DEPLOY.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

134 lines
9.7 KiB
Markdown

# Pubblicare il sito sull'hosting
Il sito è un insieme di **file statici**: funziona su qualsiasi hosting (Apache/LiteSpeed con o senza PHP, nginx, object storage). Ogni release pubblicata su Forgejo contiene:
| File | Uso |
| ---------------------------------- | ------------------------------------------------------------------------------------------- |
| `sito-studio-grasso-vX.Y.Z.zip` | formato consigliato per i pannelli di hosting (cPanel, Plesk, Aruba, Register, SiteGround…) |
| `sito-studio-grasso-vX.Y.Z.tar.gz` | server Linux con accesso SSH, nginx, object storage |
| `SHA256SUMS.txt` | impronte per verificare che i file scaricati siano integri |
| `BUILD-INFO.txt` | versione, commit, data e strumenti usati per la build |
Il **contenuto del sito è alla radice dell'archivio** (non c'è una cartella da aprire): `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, le cartelle delle pagine e `_astro/`.
> Il file `.htaccess` è **nascosto** (inizia con un punto): assicurarsi che il programma FTP o il file manager mostri i file nascosti e che venga caricato.
## 1. Scaricare e verificare il pacchetto
Dalla pagina **Release** del repository Forgejo scaricare lo zip (o il tar.gz) e `SHA256SUMS.txt` nella stessa cartella, poi:
```bash
sha256sum -c SHA256SUMS.txt --ignore-missing # Linux
shasum -a 256 -c SHA256SUMS.txt --ignore-missing # macOS
```
Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorithm SHA256` e confrontare con la riga corrispondente di `SHA256SUMS.txt`.
## 2. Hosting con pannello (cPanel, Plesk, DirectAdmin…)
1. Aprire il **File Manager** del pannello ed entrare nella cartella pubblica del dominio (`public_html` su cPanel, `httpdocs` su Plesk).
2. Fare una copia di sicurezza del sito esistente (o scaricarla), poi svuotare la cartella.
3. Caricare lo zip e usare **Estrai** (Extract) nella stessa cartella.
4. Verificare che nella cartella ci siano `index.html` **e** `.htaccess` (attivare «mostra file nascosti»), poi eliminare lo zip.
5. Attivare il certificato **HTTPS** (Let's Encrypt/AutoSSL) dal pannello, se non è già attivo.
### Note sul `.htaccess`
- Il redirect **HTTP → HTTPS** è attivo: se l'hosting lo gestisce già dal pannello, o se il certificato non è ancora attivo, commentare le tre righe indicate nella sezione «Redirect».
- Il redirect tra dominio **con e senza «www»** è commentato: decommentare la variante coerente con il dominio usato per la build (`SITE_URL`, predefinito `https://www.grassoezio.it` → variante A).
- **HSTS** è commentato: attivarlo solo quando HTTPS funziona su tutto il dominio.
- Se compare un **errore 500** dopo il caricamento, l'hosting non consente una direttiva: commentare la riga indicata nel log degli errori del pannello (tutte le direttive dei moduli sono già dentro `<IfModule>`).
- La configurazione è stata provata su Apache 2.4 con `AllowOverride All` (vedi DECISIONS.md, D-034).
## 3. FTP / SFTP
1. Estrarre lo zip **sul proprio computer** in una cartella vuota.
2. Con il programma FTP (es. FileZilla, modalità di trasferimento automatica o binaria) caricare **il contenuto** della cartella, `.htaccess` compreso, nella cartella pubblica del dominio, sostituendo i file esistenti.
3. Eliminare dal server i file del vecchio sito non più presenti (es. vecchie pagine `.php` o `.html`), dopo averne fatto una copia.
## 4. Server con nginx
1. Copiare `sito-studio-grasso-vX.Y.Z.tar.gz` sul server ed estrarlo:
```bash
sudo mkdir -p /var/www/studio-grasso
sudo tar -xzf sito-studio-grasso-vX.Y.Z.tar.gz -C /var/www/studio-grasso
```
2. Usare come base [`deploy/nginx.conf.example`](../deploy/nginx.conf.example) (redirect HTTPS e www, `try_files`, `error_page 404`, header di sicurezza, cache, compressione, blocco dei file nascosti): adattare `server_name` e certificati, poi `sudo nginx -t && sudo systemctl reload nginx`.
3. Il `.htaccess` è ignorato da nginx (e bloccato dalla configurazione).
## 5. Object storage (S3 compatibile, hosting statico)
1. Estrarre il tar.gz e caricare il contenuto nel bucket (es. `rclone sync sito/ remote:bucket`), con «documento indice» `index.html` e «documento di errore» `404.html`.
2. Il `.htaccess` non è usato: configurare **nel CDN o nel servizio** redirect HTTPS, il redirect `/privacy` → `/privacy-policy/` e gli header di sicurezza (Content-Security-Policy, X-Content-Type-Options, Referrer-Policy, X-Frame-Options, Permissions-Policy) come in `public/.htaccess`.
## 6. Modulo di contatto (facoltativo)
Per impostazione predefinita il modulo è **disattivato** (`contactForm.mode = 'off'`): la pagina Contatti mostra il pulsante «Scrivi a info@studiograssoezio.it». Nessun dato passa dal server del sito.
### Modalità `php` (hosting con PHP 7.4+ e funzione `mail()`)
1. In `src/data/studio.ts` impostare `mode: 'php'` (oggetto `contactForm`).
2. Copiare `deploy/optional-php-form/contact.php` in `public/contact.php` e controllare le costanti in testa al file: `DESTINATARIO` (predefinito `info@studiograssoezio.it`) e `MITTENTE` (una casella **del dominio del sito**, es. `noreply@…`, perché molti hosting rifiutano mittenti esterni).
3. `npm run verify`, commit e nuova release: il pacchetto conterrà `contact.php`.
4. Dopo il deploy inviare una richiesta di prova e verificare la ricezione (anche nella cartella spam).
Il gestore:
- valida i campi e scarta in silenzio gli invii con il campo trappola compilato;
- rifiuta gli invii troppo rapidi (meno di 3 secondi) e quelli oltre 5 all'ora dallo stesso indirizzo IP;
- non salva il contenuto dei messaggi e reindirizza a `/contatti/grazie/`.
Il contatore degli invii è un file per IP con un nome cifrato (HMAC dell'IP con un segreto casuale generato al primo uso), cancellato dopo un'ora. Sta in una cartella privata **fuori dalla cartella pubblica**: la costante `CARTELLA_LIMITI`, predefinita `../.studio-grasso-form`, cioè accanto a `public_html`. Se l'hosting non permette di scrivere lì, indicare una cartella privata scrivibile. Senza una cartella sicura il limite non si applica.
La Privacy policy si aggiorna automaticamente.
### Modalità `endpoint` (servizio esterno di gestione moduli)
1. Scegliere un fornitore **con sede e server nell'Unione europea** e conforme al GDPR; nominarlo responsabile del trattamento.
2. In `src/data/studio.ts` impostare `mode: 'endpoint'` e `endpoint: 'https://…'`.
3. **Aggiornare la Content-Security-Policy** (`public/.htaccess` e `deploy/nginx.conf.example`): aggiungere il dominio del fornitore a `form-action`.
4. Indicare denominazione e sede del fornitore in `studio.fornitori.modulo` (senza, la build si ferma): compaiono nella Privacy policy e sotto il modulo. Far rivedere la Privacy policy al consulente.
## 7. Controlli dopo la pubblicazione
- [ ] `https://` attivo, il lucchetto del browser è presente e `http://` reindirizza a `https://`.
- [ ] Il dominio con/senza «www» reindirizza alla versione usata in `SITE_URL`.
- [ ] `https://dominio/privacy` reindirizza a `/privacy-policy/`; `https://dominio/studio` a `/studio/`.
- [ ] Un indirizzo inesistente (es. `/prova-404/`) mostra la pagina «Pagina non trovata».
- [ ] `https://dominio/sitemap-index.xml` e `/robots.txt` sono raggiungibili.
- [ ] Gli header di sicurezza sono presenti (es. con [securityheaders.com](https://securityheaders.com) o `curl -I https://dominio/`).
- [ ] Le mappe si caricano solo premendo «Carica la mappa».
- [ ] Lighthouse sul sito pubblicato (Chrome → DevTools → Lighthouse, modalità mobile): valori in linea con quelli della CI.
- [ ] Modulo (se attivo): richiesta di prova ricevuta.
- [ ] Google Search Console: inviare la sitemap `sitemap-index.xml` (facoltativo).
## 8. Tornare alla versione precedente
Scaricare dalla pagina Release il pacchetto della versione precedente e ripetere la procedura (punto 2, 3, 4 o 5). Ogni release è completa e indipendente.
## 9. Deploy automatico (facoltativo, da attivare quando l'hosting è definito)
[`deploy/forgejo-deploy.yml.example`](../deploy/forgejo-deploy.yml.example) è un workflow pronto ma **non attivo**: alla pubblicazione di una release (o su avvio manuale) scarica il pacchetto, ne verifica l'impronta e lo pubblica, poi controlla che le pagine principali rispondano.
1. Copiarlo in `.forgejo/workflows/deploy.yml`.
2. Decommentare **una** variante e creare i segreti del repository (Impostazioni → Actions → Segreti):
- **A — rsync su SSH:** `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY` (chiave privata dedicata, con la chiave pubblica in `~/.ssh/authorized_keys` sul server);
- **B — FTPS con lftp:** `FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH` (es. `/public_html`);
- **C — rclone (object storage):** `RCLONE_CONFIG` (contenuto di `rclone.conf`), `RCLONE_DEST`.
3. Facoltativo: variabile del repository `SITE_URL` per il controllo finale; segreto `FORGEJO_TOKEN` se il token automatico non può scaricare gli allegati delle release.
4. Aggiungere al passo «Strumenti» i programmi della variante scelta (`rsync openssh-client`, `lftp` o `rclone`).
## 10. Pubblicare la release a mano (senza workflow)
Se le Actions non sono disponibili:
```bash
RELEASE_VERSION=vX.Y.Z npm run package
FORGEJO_URL=https://forgejo.example.it FORGEJO_REPO=proprietario/repository \
FORGEJO_TOKEN=<token write:repository> scripts/release-upload.sh vX.Y.Z
```
Il tag deve già esistere sul server (`git push origin vX.Y.Z`). Lo script crea la release (o aggiorna quella esistente) con le note del CHANGELOG e carica i quattro file di `release/`.