- 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
9.7 KiB
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:
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…)
- Aprire il File Manager del pannello ed entrare nella cartella pubblica del dominio (
public_htmlsu cPanel,httpdocssu Plesk). - Fare una copia di sicurezza del sito esistente (o scaricarla), poi svuotare la cartella.
- Caricare lo zip e usare Estrai (Extract) nella stessa cartella.
- Verificare che nella cartella ci siano
index.htmle.htaccess(attivare «mostra file nascosti»), poi eliminare lo zip. - 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, predefinitohttps://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
- Estrarre lo zip sul proprio computer in una cartella vuota.
- Con il programma FTP (es. FileZilla, modalità di trasferimento automatica o binaria) caricare il contenuto della cartella,
.htaccesscompreso, nella cartella pubblica del dominio, sostituendo i file esistenti. - Eliminare dal server i file del vecchio sito non più presenti (es. vecchie pagine
.phpo.html), dopo averne fatto una copia.
4. Server con nginx
-
Copiare
sito-studio-grasso-vX.Y.Z.tar.gzsul server ed estrarlo:sudo mkdir -p /var/www/studio-grasso sudo tar -xzf sito-studio-grasso-vX.Y.Z.tar.gz -C /var/www/studio-grasso -
Usare come base
deploy/nginx.conf.example(redirect HTTPS e www,try_files,error_page 404, header di sicurezza, cache, compressione, blocco dei file nascosti): adattareserver_namee certificati, poisudo nginx -t && sudo systemctl reload nginx. -
Il
.htaccessè ignorato da nginx (e bloccato dalla configurazione).
5. Object storage (S3 compatibile, hosting statico)
- Estrarre il tar.gz e caricare il contenuto nel bucket (es.
rclone sync sito/ remote:bucket), con «documento indice»index.htmle «documento di errore»404.html. - Il
.htaccessnon è 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 inpublic/.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())
- In
src/data/studio.tsimpostaremode: 'php'(oggettocontactForm). - Copiare
deploy/optional-php-form/contact.phpinpublic/contact.phpe controllare le costanti in testa al file:DESTINATARIO(predefinitoinfo@studiograssoezio.it) eMITTENTE(una casella del dominio del sito, es.noreply@…, perché molti hosting rifiutano mittenti esterni). npm run verify, commit e nuova release: il pacchetto conterràcontact.php.- 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)
- Scegliere un fornitore con sede e server nell'Unione europea e conforme al GDPR; nominarlo responsabile del trattamento.
- In
src/data/studio.tsimpostaremode: 'endpoint'eendpoint: 'https://…'. - Aggiornare la Content-Security-Policy (
public/.htaccessedeploy/nginx.conf.example): aggiungere il dominio del fornitore aform-action. - 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 ehttp://reindirizza ahttps://.- Il dominio con/senza «www» reindirizza alla versione usata in
SITE_URL. https://dominio/privacyreindirizza a/privacy-policy/;https://dominio/studioa/studio/.- Un indirizzo inesistente (es.
/prova-404/) mostra la pagina «Pagina non trovata». https://dominio/sitemap-index.xmle/robots.txtsono raggiungibili.- Gli header di sicurezza sono presenti (es. con 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 è 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.
- Copiarlo in
.forgejo/workflows/deploy.yml. - 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_keyssul server); - B — FTPS con lftp:
FTP_HOST,FTP_USER,FTP_PASSWORD,FTP_PATH(es./public_html); - C — rclone (object storage):
RCLONE_CONFIG(contenuto dirclone.conf),RCLONE_DEST.
- A — rsync su SSH:
- Facoltativo: variabile del repository
SITE_URLper il controllo finale; segretoFORGEJO_TOKENse il token automatico non può scaricare gli allegati delle release. - Aggiungere al passo «Strumenti» i programmi della variante scelta (
rsync openssh-client,lftporclone).
10. Pubblicare la release a mano (senza workflow)
Se le Actions non sono disponibili:
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/.