Compare commits
4
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
f9f5a43a14 | ||
|
|
b7b985b3fa | ||
|
|
31ac5b7f68 | ||
|
|
083489ac8b |
No files matched your search
@@ -1,107 +0,0 @@
|
||||
# =============================================================================
|
||||
# CI — verifica completa a ogni push su main e a ogni pull request.
|
||||
#
|
||||
# RUNNER: `runs-on: docker` è il label più comune di forgejo-runner. Se il runner
|
||||
# dell'istanza usa un altro label (es. `ubuntu-latest`, `self-hosted`), sostituirlo
|
||||
# in tutti i job: Impostazioni del repository → Actions → Runner mostra i label disponibili.
|
||||
#
|
||||
# CONTAINER: l'immagine Playwright DEVE avere la stessa versione di @playwright/test
|
||||
# in package.json (oggi 1.56.1). Aggiornando Playwright, aggiornare anche qui e in release.yml.
|
||||
#
|
||||
# AZIONI: referenziate con URL completo su code.forgejo.org, così il workflow non dipende
|
||||
# dall'impostazione DEFAULT_ACTIONS_URL dell'istanza.
|
||||
#
|
||||
# ARTIFACT: upload-artifact@v3 (supportato da Forgejo) con include-hidden-files, altrimenti
|
||||
# salta .lighthouseci/ e dist/.htaccess. Per passare alla v4 usare il fork per Forgejo
|
||||
# https://code.forgejo.org/forgejo/upload-artifact@v4: actions/upload-artifact@v4 accetta solo
|
||||
# github.com e su Forgejo fallisce sempre (GHESNotSupportedError).
|
||||
#
|
||||
# NON BLOCCANTE: Forgejo ignora `continue-on-error` a livello di job; va messo sullo step.
|
||||
#
|
||||
# DOMINIO: la variabile del repository SITE_URL (Impostazioni → Actions → Variabili), se
|
||||
# impostata, sostituisce il dominio predefinito di site.config.mjs in build e test.
|
||||
#
|
||||
# SEGRETI: questo workflow non ne usa. Il segreto facoltativo RELEASE_TOKEN serve solo a
|
||||
# release.yml (vedi il commento in quel file e il README).
|
||||
# =============================================================================
|
||||
name: CI
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
pull_request:
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
ASTRO_TELEMETRY_DISABLED: '1'
|
||||
CI: 'true'
|
||||
SITE_URL: ${{ vars.SITE_URL }}
|
||||
|
||||
jobs:
|
||||
verify:
|
||||
name: Verifica (lint, build, test, Lighthouse)
|
||||
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
|
||||
container:
|
||||
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
|
||||
timeout-minutes: 30
|
||||
steps:
|
||||
- uses: https://code.forgejo.org/actions/checkout@v4
|
||||
|
||||
- uses: https://code.forgejo.org/actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc
|
||||
cache: npm
|
||||
|
||||
- name: Dipendenze
|
||||
run: npm ci
|
||||
|
||||
- name: npm run verify
|
||||
run: npm run verify
|
||||
|
||||
- name: Report Playwright (solo in caso di errore)
|
||||
if: failure()
|
||||
uses: https://code.forgejo.org/actions/upload-artifact@v3 # per la v4: forgejo/upload-artifact@v4 (vedi in alto)
|
||||
with:
|
||||
name: playwright-report
|
||||
path: playwright-report
|
||||
retention-days: 14
|
||||
|
||||
- name: Report Lighthouse
|
||||
if: always()
|
||||
uses: https://code.forgejo.org/actions/upload-artifact@v3
|
||||
with:
|
||||
name: lighthouse
|
||||
path: .lighthouseci
|
||||
include-hidden-files: true # cartella nascosta: senza, l'action non carica nulla
|
||||
retention-days: 14
|
||||
|
||||
- name: Artifact dist
|
||||
uses: https://code.forgejo.org/actions/upload-artifact@v3
|
||||
with:
|
||||
name: dist
|
||||
path: dist
|
||||
include-hidden-files: true # comprende dist/.htaccess
|
||||
retention-days: 7
|
||||
|
||||
external-links:
|
||||
name: Link esterni (non bloccante)
|
||||
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
|
||||
container:
|
||||
image: node:24
|
||||
timeout-minutes: 15
|
||||
steps:
|
||||
- uses: https://code.forgejo.org/actions/checkout@v4
|
||||
|
||||
- name: Dipendenze
|
||||
run: npm ci
|
||||
env:
|
||||
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
|
||||
|
||||
- name: Build
|
||||
run: npm run build
|
||||
|
||||
- name: Controllo dei link esterni
|
||||
# non bloccante: dipende dalla rete del runner e dai siti esterni. Su Forgejo deve stare
|
||||
# sullo step: a livello di job viene ignorato e un link esterno rotto renderebbe rossa la CI.
|
||||
continue-on-error: true
|
||||
run: npm run test:links -- --external
|
||||
@@ -1,117 +0,0 @@
|
||||
# =============================================================================
|
||||
# Release — a ogni tag vX.Y.Z: verifica completa, pacchetto (zip, tar.gz, SHA256SUMS.txt,
|
||||
# BUILD-INFO.txt) e pubblicazione nella sezione «Release» del repository Forgejo.
|
||||
#
|
||||
# Come rilasciare (dettagli nel README):
|
||||
# 1. aggiornare "version" in package.json e la sezione ## [X.Y.Z] di CHANGELOG.md;
|
||||
# 2. commit su main; 3. git tag vX.Y.Z && git push origin vX.Y.Z
|
||||
# Il workflow si ferma se il tag non coincide con la versione di package.json o se manca
|
||||
# la sezione del CHANGELOG.
|
||||
#
|
||||
# RUNNER: `runs-on: docker` è il label più comune di forgejo-runner; sostituirlo se il
|
||||
# runner dell'istanza ne usa un altro (es. `ubuntu-latest`).
|
||||
#
|
||||
# TOKEN: per impostazione predefinita la release è pubblicata con il token automatico del
|
||||
# workflow (su Forgejo ha il permesso di scrittura sul repository). Per usare un token personale
|
||||
# creare un access token (Impostazioni utente → Applicazioni → Genera token, permesso
|
||||
# «write:repository») e salvarlo come segreto del repository RELEASE_TOKEN (Impostazioni del
|
||||
# repository → Actions → Segreti): se esiste viene usato al posto del token automatico. Serve
|
||||
# per avviare il deploy automatico facoltativo, perché le modifiche fatte con il token
|
||||
# automatico non avviano altri workflow. NON usare nomi che iniziano con FORGEJO_, GITEA_ o
|
||||
# GITHUB_: sono riservati, e secrets.FORGEJO_TOKEN è sempre il token automatico.
|
||||
#
|
||||
# PUBBLICAZIONE: prima con l'action forgejo-release; se l'action non riesce (es. strumenti
|
||||
# mancanti nell'immagine), lo step successivo pubblica la stessa release con l'API REST
|
||||
# (scripts/release-upload.sh, solo curl e node).
|
||||
#
|
||||
# DOMINIO: la variabile del repository SITE_URL, se impostata, sostituisce il dominio
|
||||
# predefinito di site.config.mjs (canonical, sitemap, robots.txt, dati strutturati).
|
||||
# =============================================================================
|
||||
name: Release
|
||||
|
||||
on:
|
||||
push:
|
||||
tags: ['v*.*.*']
|
||||
|
||||
env:
|
||||
ASTRO_TELEMETRY_DISABLED: '1'
|
||||
CI: 'true'
|
||||
SITE_URL: ${{ vars.SITE_URL }}
|
||||
|
||||
jobs:
|
||||
release:
|
||||
name: Pacchetto e pubblicazione
|
||||
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
|
||||
container:
|
||||
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
|
||||
timeout-minutes: 40
|
||||
steps:
|
||||
- uses: https://code.forgejo.org/actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 0
|
||||
|
||||
- uses: https://code.forgejo.org/actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc
|
||||
cache: npm
|
||||
|
||||
- name: Data riproducibile (data del commit)
|
||||
run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV"
|
||||
|
||||
- name: Dipendenze
|
||||
run: npm ci
|
||||
|
||||
- name: Controlli preliminari (tag, versione, CHANGELOG)
|
||||
env:
|
||||
RELEASE_VERSION: ${{ github.ref_name }}
|
||||
run: |
|
||||
node -e 'const v=require("./package.json").version; const t=process.env.RELEASE_VERSION.replace(/^v/,""); if (v!==t) { console.error(`Il tag ${process.env.RELEASE_VERSION} non corrisponde a package.json (${v})`); process.exit(1); }'
|
||||
node scripts/changelog-notes.mjs "$RELEASE_VERSION" > /dev/null
|
||||
|
||||
- name: npm run verify # nessuna release senza test verdi
|
||||
run: npm run verify
|
||||
|
||||
- name: npm run package # crea release/ e ne verifica il contenuto
|
||||
run: npm run package
|
||||
env:
|
||||
RELEASE_VERSION: ${{ github.ref_name }}
|
||||
|
||||
- name: Note di rilascio dal CHANGELOG
|
||||
id: notes
|
||||
run: |
|
||||
{
|
||||
echo 'notes<<NOTES_EOF'
|
||||
node scripts/changelog-notes.mjs "${{ github.ref_name }}" --shell-safe
|
||||
echo 'NOTES_EOF'
|
||||
} >> "$GITHUB_OUTPUT"
|
||||
|
||||
- name: Pubblica la release su Forgejo
|
||||
id: action
|
||||
continue-on-error: true # in caso di errore pubblica lo step successivo (API REST)
|
||||
uses: https://code.forgejo.org/actions/forgejo-release@v2
|
||||
with:
|
||||
direction: upload
|
||||
url: ${{ github.server_url }}
|
||||
repo: ${{ github.repository }}
|
||||
tag: ${{ github.ref_name }}
|
||||
token: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
|
||||
release-dir: release # contiene SOLO zip, tar.gz, SHA256SUMS.txt, BUILD-INFO.txt
|
||||
release-notes: ${{ steps.notes.outputs.notes }}
|
||||
prerelease: ${{ contains(github.ref_name, '-') }}
|
||||
verbose: true
|
||||
|
||||
- name: Pubblica la release (API REST, se l'action non è riuscita)
|
||||
if: steps.action.outcome == 'failure'
|
||||
env:
|
||||
FORGEJO_URL: ${{ github.server_url }}
|
||||
FORGEJO_REPO: ${{ github.repository }}
|
||||
FORGEJO_TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
|
||||
run: bash scripts/release-upload.sh "${{ github.ref_name }}" release
|
||||
|
||||
- name: Report Playwright (solo in caso di errore)
|
||||
if: failure()
|
||||
uses: https://code.forgejo.org/actions/upload-artifact@v3 # per la v4: forgejo/upload-artifact@v4 (vedi ci.yml)
|
||||
with:
|
||||
name: playwright-report
|
||||
path: playwright-report
|
||||
retention-days: 14
|
||||
@@ -0,0 +1,146 @@
|
||||
# =============================================================================
|
||||
# CI — verifica completa a ogni push su main e a ogni pull request (Gitea Actions).
|
||||
#
|
||||
# Il job «verify» ripete passo per passo `npm run verify` (stesso ordine): nella pagina
|
||||
# dell'esecuzione si vede subito quale controllo è fallito. Alla fine costruisce anche lo zip
|
||||
# di rilascio e ne verifica il contenuto (`scripts/package.mjs` + `scripts/check-package.mjs`),
|
||||
# così un errore di pacchetto emerge qui e non al momento del tag. Modificando gli script
|
||||
# `verify`/`test` di package.json, aggiornare anche questi passi.
|
||||
#
|
||||
# RUNNER: i job usano il label `ubuntu-latest`, quello predefinito di act_runner. Se il runner
|
||||
# è stato registrato con un altro label, sostituirlo in tutti i job: Impostazioni del
|
||||
# repository → Actions → Runner (o Amministrazione → Actions → Runner) mostra i label.
|
||||
#
|
||||
# CONTAINER: l'immagine Playwright DEVE avere la stessa versione di @playwright/test
|
||||
# in package.json (oggi 1.56.1). Aggiornando Playwright, aggiornare anche qui e in release.yml.
|
||||
#
|
||||
# AZIONI: referenziate con URL completo su github.com, così il workflow non dipende
|
||||
# dall'impostazione DEFAULT_ACTIONS_URL dell'istanza. Il runner deve poter raggiungere
|
||||
# github.com; in alternativa usare le copie ospitate su https://gitea.com/actions/.
|
||||
#
|
||||
# ARTIFACT: upload-artifact@v3, l'unica versione che funziona su Gitea: actions/upload-artifact@v4
|
||||
# fallisce sempre con GHESNotSupportedError. Gli upload sono sullo step con `continue-on-error`,
|
||||
# così un problema dello storage non rende rossa una verifica andata a buon fine.
|
||||
#
|
||||
# TIMEOUT: i limiti sono larghi perché la rete del runner di casa è lenta: il primo avvio scarica
|
||||
# l'immagine Playwright (oltre 1 GB, più di venti minuti) e ogni esecuzione clona le action da
|
||||
# github.com, scarica Node e le dipendenze npm. A immagine presente e con la rete libera la
|
||||
# verifica dura pochi minuti.
|
||||
#
|
||||
# CACHE: niente `cache: npm` in setup-node. Il server di cache del runner non è raggiungibile
|
||||
# dal container del job (connect ETIMEDOUT verso l'indirizzo del runner): ogni esecuzione
|
||||
# aspettava cinque minuti prima di proseguire con un avviso. Le dipendenze si scaricano con
|
||||
# `npm ci` a ogni esecuzione.
|
||||
#
|
||||
# NON BLOCCANTE: il controllo dei link esterni ha `continue-on-error` sullo step (non sul job).
|
||||
#
|
||||
# DOMINIO: la variabile del repository SITE_URL (Impostazioni → Actions → Variabili), se
|
||||
# impostata, sostituisce il dominio predefinito di site.config.mjs in build e test.
|
||||
#
|
||||
# SEGRETI: questo workflow non ne usa. Il segreto facoltativo RELEASE_TOKEN serve solo a
|
||||
# release.yml (vedi il commento in quel file e il README).
|
||||
# =============================================================================
|
||||
name: CI
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
pull_request:
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
ASTRO_TELEMETRY_DISABLED: '1'
|
||||
CI: 'true'
|
||||
SITE_URL: ${{ vars.SITE_URL }}
|
||||
|
||||
jobs:
|
||||
verify:
|
||||
name: Verifica (lint, build, test, Lighthouse, pacchetto)
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
container:
|
||||
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
|
||||
timeout-minutes: 90 # la rete del runner è lenta (vedi TIMEOUT)
|
||||
steps:
|
||||
- uses: https://github.com/actions/checkout@v4
|
||||
|
||||
- uses: https://github.com/actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc # niente `cache: npm`: vedi CACHE in testa al file
|
||||
|
||||
- name: Dipendenze
|
||||
run: npm ci
|
||||
|
||||
- name: Lint
|
||||
run: npm run lint
|
||||
|
||||
- name: Formattazione
|
||||
run: npm run format:check
|
||||
|
||||
- name: Controllo dei tipi (astro check)
|
||||
run: npm run check
|
||||
|
||||
- name: Build
|
||||
run: npm run build
|
||||
|
||||
- name: HTML valido
|
||||
run: npm run test:html
|
||||
|
||||
- name: Link interni
|
||||
run: npm run test:links
|
||||
|
||||
- name: Test end-to-end
|
||||
run: npm run test:e2e
|
||||
|
||||
- name: Test di accessibilità
|
||||
run: npm run test:a11y
|
||||
|
||||
- name: Conformità legale
|
||||
run: npm run test:compliance
|
||||
|
||||
- name: Lighthouse
|
||||
run: npm run test:lighthouse
|
||||
|
||||
- name: Pacchetto zip (creazione e verifica del contenuto)
|
||||
run: node scripts/package.mjs && npm run test:package
|
||||
|
||||
- name: Report Playwright (solo in caso di errore)
|
||||
if: failure()
|
||||
continue-on-error: true
|
||||
uses: https://github.com/actions/upload-artifact@v3
|
||||
with:
|
||||
name: playwright-report
|
||||
path: playwright-report
|
||||
retention-days: 14
|
||||
|
||||
- name: Report Lighthouse
|
||||
if: always()
|
||||
continue-on-error: true
|
||||
uses: https://github.com/actions/upload-artifact@v3
|
||||
with:
|
||||
name: lighthouse
|
||||
path: .lighthouseci
|
||||
include-hidden-files: true # necessario: dalla v3.2.0 le cartelle nascoste (.lighthouseci) sono escluse
|
||||
retention-days: 14
|
||||
|
||||
external-links:
|
||||
name: Link esterni (non bloccante)
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
container:
|
||||
image: node:24
|
||||
timeout-minutes: 45 # la rete del runner è lenta (vedi TIMEOUT)
|
||||
steps:
|
||||
- uses: https://github.com/actions/checkout@v4
|
||||
|
||||
- name: Dipendenze
|
||||
run: npm ci
|
||||
env:
|
||||
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
|
||||
|
||||
- name: Build
|
||||
run: npm run build
|
||||
|
||||
- name: Controllo dei link esterni
|
||||
# non bloccante: dipende dalla rete del runner e dai siti esterni, quindi un link
|
||||
# irraggiungibile non deve rendere rossa la CI
|
||||
continue-on-error: true
|
||||
run: npm run test:links -- --external
|
||||
@@ -0,0 +1,97 @@
|
||||
# =============================================================================
|
||||
# Release — a ogni tag vX.Y.Z: verifica completa, creazione dello zip del sito e
|
||||
# pubblicazione nella sezione «Release» del repository con UN SOLO file allegato:
|
||||
# sito-studio-grasso-vX.Y.Z.zip (il contenuto va estratto nella cartella pubblica
|
||||
# dell'hosting, .htaccess compreso). Gitea aggiunge da solo alla release i due archivi
|
||||
# «Source code» del codice sorgente: non sono il sito, serve lo zip sito-studio-grasso-….
|
||||
#
|
||||
# Come rilasciare (dettagli nel README):
|
||||
# 1. aggiornare "version" in package.json e la sezione ## [X.Y.Z] di CHANGELOG.md;
|
||||
# 2. commit su main; 3. git tag vX.Y.Z && git push origin vX.Y.Z
|
||||
# Il workflow si ferma se il tag non coincide con la versione di package.json o se manca
|
||||
# la sezione del CHANGELOG, che diventa il testo della release.
|
||||
#
|
||||
# RUNNER: i job usano il label `ubuntu-latest`, quello predefinito di act_runner; sostituirlo
|
||||
# se il runner ne usa un altro (Impostazioni del repository → Actions → Runner).
|
||||
#
|
||||
# TOKEN: per impostazione predefinita la release è pubblicata con il token automatico del
|
||||
# workflow (il job chiede il permesso `contents: write`). Se la release non viene creata (errore
|
||||
# 403 o 404 nello step di pubblicazione: ad esempio un amministratore ha limitato i permessi dei
|
||||
# token automatici) creare un access token (Impostazioni utente → Applicazioni → Genera token, permesso
|
||||
# «write:repository») e salvarlo come segreto del repository RELEASE_TOKEN (Impostazioni del
|
||||
# repository → Actions → Segreti): se esiste viene usato al posto del token automatico. NON
|
||||
# usare nomi che iniziano con GITEA_ o GITHUB_: sono riservati.
|
||||
#
|
||||
# PUBBLICAZIONE: scripts/release-upload.sh (solo curl e node) usa l'API REST di Gitea: crea
|
||||
# la release in bozza, carica lo zip e solo allora la pubblica. Lo stesso script serve a mano.
|
||||
#
|
||||
# AZIONI e ARTIFACT: come in ci.yml (URL completo su github.com, upload-artifact@v3).
|
||||
#
|
||||
# DOMINIO: la variabile del repository SITE_URL, se impostata, sostituisce il dominio
|
||||
# predefinito di site.config.mjs (canonical, sitemap, robots.txt, dati strutturati).
|
||||
# =============================================================================
|
||||
name: Release
|
||||
|
||||
on:
|
||||
push:
|
||||
tags: ['v*.*.*']
|
||||
|
||||
env:
|
||||
ASTRO_TELEMETRY_DISABLED: '1'
|
||||
CI: 'true'
|
||||
SITE_URL: ${{ vars.SITE_URL }}
|
||||
|
||||
jobs:
|
||||
release:
|
||||
name: Zip del sito e pubblicazione
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
permissions:
|
||||
contents: write # crea la release e carica lo zip con il token automatico (Gitea 1.26 e successivi)
|
||||
container:
|
||||
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
|
||||
timeout-minutes: 90 # largo come in ci.yml: la rete del runner è lenta (vedi TIMEOUT)
|
||||
steps:
|
||||
- uses: https://github.com/actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 0
|
||||
|
||||
- uses: https://github.com/actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc # niente `cache: npm`: vedi CACHE in ci.yml
|
||||
|
||||
- name: Data riproducibile (data del commit)
|
||||
run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV"
|
||||
|
||||
- name: Dipendenze
|
||||
run: npm ci
|
||||
|
||||
- name: Controlli preliminari (tag, versione, CHANGELOG)
|
||||
env:
|
||||
RELEASE_VERSION: ${{ github.ref_name }}
|
||||
run: |
|
||||
node -e 'const v=require("./package.json").version; const t=process.env.RELEASE_VERSION.replace(/^v/,""); if (v!==t) { console.error(`Il tag ${process.env.RELEASE_VERSION} non corrisponde a package.json (${v})`); process.exit(1); }'
|
||||
node scripts/changelog-notes.mjs "$RELEASE_VERSION" > /dev/null
|
||||
|
||||
- name: npm run verify # nessuna release senza test verdi
|
||||
run: npm run verify
|
||||
|
||||
- name: npm run package # crea release/ con lo zip e ne verifica il contenuto
|
||||
run: npm run package
|
||||
env:
|
||||
RELEASE_VERSION: ${{ github.ref_name }}
|
||||
|
||||
- name: Pubblica la release con lo zip
|
||||
env:
|
||||
GITEA_URL: ${{ github.server_url }}
|
||||
GITEA_REPO: ${{ github.repository }}
|
||||
GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
|
||||
run: bash scripts/release-upload.sh "${{ github.ref_name }}" release
|
||||
|
||||
- name: Report Playwright (solo in caso di errore)
|
||||
if: failure()
|
||||
continue-on-error: true
|
||||
uses: https://github.com/actions/upload-artifact@v3
|
||||
with:
|
||||
name: playwright-report
|
||||
path: playwright-report
|
||||
retention-days: 14
|
||||
+12
-4
@@ -4,7 +4,15 @@ Tutte le modifiche rilevanti a questo progetto sono documentate in questo file.
|
||||
|
||||
Il formato segue [Keep a Changelog](https://keepachangelog.com/it-IT/1.1.0/) e il progetto adotta il [Versionamento Semantico](https://semver.org/lang/it/).
|
||||
|
||||
## [Non rilasciato]
|
||||
## [1.0.1] - 2026-10-22
|
||||
|
||||
### Modificato
|
||||
|
||||
- Il repository risiede in via definitiva su Gitea: i workflow di CI e di release sono in `.gitea/workflows/` e usano Gitea Actions (runner `act_runner` con label `ubuntu-latest`).
|
||||
- La release contiene un solo file allegato, `sito-studio-grasso-vX.Y.Z.zip`: il sito pronto da estrarre nella cartella pubblica dell'hosting, `.htaccess` compreso. Non vengono più pubblicati l'archivio tar.gz, `SHA256SUMS.txt` e `BUILD-INFO.txt`.
|
||||
- La CI esegue i controlli di `npm run verify` come passi separati, così la pagina dell'esecuzione mostra subito quale è fallito, e alla fine crea lo zip di rilascio e ne verifica il contenuto.
|
||||
- La release è pubblicata da `scripts/release-upload.sh` con l'API REST di Gitea (variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`), senza action esterne.
|
||||
- L'esempio di deploy automatico, sempre disattivato, è `deploy/gitea-deploy.yml.example` e lavora sul nuovo zip unico.
|
||||
|
||||
### Aggiunto
|
||||
|
||||
@@ -13,8 +21,8 @@ Il formato segue [Keep a Changelog](https://keepachangelog.com/it-IT/1.1.0/) e i
|
||||
|
||||
### Corretto
|
||||
|
||||
- CI su Forgejo: il controllo dei link esterni non blocca più la CI (Forgejo ignora `continue-on-error` sul job); il report Lighthouse e il `.htaccess` arrivano negli artifact; il token personale per le release è `RELEASE_TOKEN` (il prefisso `FORGEJO_` è riservato).
|
||||
- Release: lo script di ripiego crea la release in bozza e la pubblica solo dopo i file, pubblica anche una bozza rimasta a metà, sostituisce un file senza mai lasciarlo mancante e controlla che il tag sia sul server; il tar.gz è identico su Windows, macOS e Linux.
|
||||
- CI: il controllo dei link esterni non blocca più la CI (`continue-on-error` sullo step); il report Lighthouse viene allegato all'esecuzione; il token personale per le release è il segreto `RELEASE_TOKEN`.
|
||||
- Release: lo script crea la release in bozza e la pubblica solo dopo i file, pubblica anche una bozza rimasta a metà, sostituisce un file senza mai lasciarlo mancante e controlla che il tag sia sul server.
|
||||
- Layout mobile su Safari/iOS precedenti alla 16.4 e sfocatura dell'intestazione su Chrome, Edge e Firefox (CSS generato per i browser supportati).
|
||||
- Accessibilità: anello di focus con contrasto di almeno 3:1 su ogni fondo; bersagli touch di 44 px per la freccia del sottomenu, i recapiti e i link del footer su mobile; nessuna zona morta sotto le voci del menu; HTML valido nella pagina Servizi.
|
||||
- Intestazione desktop: voci del menu e logo non vanno più a capo vicino ai 960 e ai 1100 px; il numero di telefono compare da 1140 px, quando c'è spazio.
|
||||
@@ -41,5 +49,5 @@ Prima versione del nuovo sito dello Studio Grasso — Studio Tributario e Societ
|
||||
- Modulo di contatto configurabile (disattivato, PHP, servizio esterno) con presa visione dell'informativa, informativa breve generata dai dati dello Studio e anti-spam senza cookie; il gestore PHP registra solo un'impronta crittografica dell'IP, cancellata dopo un'ora al primo invio successivo.
|
||||
- `.htaccess` con HTTPS, header di sicurezza e Content-Security-Policy; configurazione nginx di esempio.
|
||||
- Test automatici: validità HTML, link, end-to-end, accessibilità (axe), conformità, Lighthouse.
|
||||
- CI e release su Forgejo Actions: pacchetti zip e tar.gz riproducibili con impronte SHA-256.
|
||||
- CI e release con le Actions del repository: pacchetto di rilascio riproducibile.
|
||||
- Documentazione: deploy, aggiornamento dei contenuti, checklist di conformità, decisioni, dati da fornire.
|
||||
+76
-45
@@ -4,10 +4,10 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
|
||||
|
||||
---
|
||||
|
||||
## D-001 — Repository esistente su Forgejo e branch di lavoro
|
||||
## D-001 — Repository esistente su Gitea e branch di lavoro
|
||||
|
||||
- **Data:** 2026-10-15
|
||||
- **Contesto:** il brief (§14.0) prevede `git init`, ma il repository `BalboSoft/Studio_Grasso` esiste già su Forgejo con un commit iniziale (README di due righe e `.gitignore`).
|
||||
- **Contesto:** il brief (§14.0) prevede `git init`, ma il repository `BalboSoft/Studio_Grasso` esiste già su Gitea con un commit iniziale (README di due righe e `.gitignore`).
|
||||
- **Scelta:** si lavora sul clone del repository esistente. Lo sviluppo avviene sul branch `feat/sito-v1` (un commit per fase, Conventional Commits in italiano); a fine fase 8 il branch viene unito in `main` con un merge commit (`--no-ff`), così `main` locale è pronto per il push.
|
||||
- **Alternative scartate:** `git init` di un nuovo repository (perderebbe la storia remota e richiederebbe un push forzato); commit diretti su `main` (meno leggibile la storia per fasi).
|
||||
- **Motivazione:** conserva la storia remota, nessun push forzato necessario, `main` resta pulito fino al merge finale.
|
||||
@@ -267,8 +267,8 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
|
||||
## D-033 — Pacchetto di rilascio riproducibile e verificato senza dipendenze aggiuntive
|
||||
|
||||
- **Data:** 2026-10-15
|
||||
- **Contesto:** §12.4 chiede archivi zip e tar.gz deterministici; §11.7 chiede di estrarli e confrontarli 1:1 con `dist/`. L'immagine CI potrebbe non avere `unzip`.
|
||||
- **Scelta:** `scripts/package.mjs` usa `archiver` (ZipArchive/TarArchive) con voci ordinate, permessi 0644, fuso orario UTC e data fissa = `SOURCE_DATE_EPOCH` o data dell'ultimo commit (il workflow di release la imposta dal commit del tag). `check-package.mjs` legge lo zip con un lettore minimale in Node (directory centrale, store/deflate, controllo CRC32) ed estrae il tar.gz con `tar` di sistema; confronta percorsi, dimensioni e impronte con `dist/` e verifica `SHA256SUMS.txt` sia in Node sia con `sha256sum -c`. Due esecuzioni consecutive producono archivi identici (verificato). Il pacchetto fallisce se il tag non coincide con `package.json`.
|
||||
- **Contesto:** §12.4 chiede uno zip deterministico; §11.7 chiede di aprirlo e confrontarlo 1:1 con `dist/`. L'immagine CI potrebbe non avere `unzip`.
|
||||
- **Scelta:** `scripts/package.mjs` usa `archiver` (ZipArchive) con voci ordinate, permessi 0644, fuso orario UTC e data fissa = `SOURCE_DATE_EPOCH` o data dell'ultimo commit (il workflow di release la imposta dal commit del tag). Il contenuto di `dist/` sta alla radice dello zip, `.htaccess` compreso, senza cartelle di primo livello. `check-package.mjs` legge lo zip con un lettore minimale in Node (directory centrale, store/deflate, controllo CRC32); verifica che in `release/` ci sia solo lo zip, che non superi 5 MB e che percorsi, dimensioni e contenuto coincidano con `dist/` (pagine del sitemap e `.htaccess` comprese). A parità di `dist/` lo zip è identico su Windows, macOS e Linux. Il pacchetto fallisce se il tag non coincide con `package.json`. Il pacchetto è un solo file: D-057.
|
||||
- **Alternative scartate:** `unzip`/`zip` di sistema (non garantiti nel container); librerie di estrazione aggiuntive.
|
||||
- **Motivazione:** integrità verificabile ovunque, nessuna dipendenza in più.
|
||||
|
||||
@@ -280,14 +280,15 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
|
||||
- **Alternative scartate:** nessuna verifica (solo revisione del codice).
|
||||
- **Motivazione:** ridurre il rischio al primo deploy. Le prove non fanno parte di `npm run verify` (richiedono server non presenti nel container CI).
|
||||
|
||||
## D-035 — Workflow Forgejo
|
||||
## D-035 — Workflow Gitea
|
||||
|
||||
- **Data:** 2026-10-15
|
||||
- **Contesto:** §12.2–12.3.
|
||||
- **Scelta:** `ci.yml` (push su main, pull request, avvio manuale) con `npm run verify` nel container Playwright 1.56.1 e Node da `.nvmrc`, report Playwright e Lighthouse come artifact, job dei link esterni non bloccante; `release.yml` sui tag `v*.*.*` con controllo preliminare tag/versione/CHANGELOG, `SOURCE_DATE_EPOCH` dal commit, `verify`, `package`, note dal CHANGELOG e `forgejo-release@v2` (token `FORGEJO_TOKEN` se presente, altrimenti quello automatico); alternativa via API REST (`scripts/release-upload.sh`) commentata. Telemetria di Astro disattivata (`ASTRO_TELEMETRY_DISABLED`). Il deploy automatico resta un esempio non attivo (`deploy/forgejo-deploy.yml.example`, evento `release: published`, varianti rsync/FTPS/rclone).
|
||||
- **Alternative scartate:** `workflow_run` per il deploy (non supportato da Forgejo Actions).
|
||||
- **Motivazione:** nessuna release senza test verdi; workflow indipendenti dalla configurazione dell'istanza.
|
||||
- **Aggiornamento (2026-10-16):** `continue-on-error` del job dei link esterni spostato sullo step, artifact con i file nascosti e token `RELEASE_TOKEN` al posto di `FORGEJO_TOKEN`: vedi D-045.
|
||||
- **Scelta:** `ci.yml` (push su main, pull request, avvio manuale) con i comandi di `npm run verify` nel container Playwright 1.56.1 e Node da `.nvmrc`, report Playwright e Lighthouse come artifact, job dei link esterni non bloccante; `release.yml` sui tag `v*.*.*` con controllo preliminare tag/versione/CHANGELOG, `SOURCE_DATE_EPOCH` dal commit, `verify`, `package`, note dal CHANGELOG e pubblicazione con `scripts/release-upload.sh` (API REST di Gitea; token `RELEASE_TOKEN` se presente, altrimenti quello automatico). Telemetria di Astro disattivata (`ASTRO_TELEMETRY_DISABLED`). Il deploy automatico resta un esempio non attivo (`deploy/gitea-deploy.yml.example`, evento `release`, varianti rsync/FTPS/rclone).
|
||||
- **Alternative scartate:** un job di deploy dentro `release.yml`, che porterebbe nel workflow attivo segreti e varianti ancora da scegliere (D-047).
|
||||
- **Motivazione:** nessuna release senza test verdi; workflow che non dipendono dall'impostazione `DEFAULT_ACTIONS_URL` dell'istanza (D-056).
|
||||
- **Aggiornamento (2026-10-16):** `continue-on-error` del job dei link esterni spostato sullo step, `include-hidden-files` per il report Lighthouse e token personale `RELEASE_TOKEN` (segreto facoltativo): vedi D-045.
|
||||
- **Aggiornamento (2026-10-22):** la CI ripete i controlli come passi separati e alla fine crea e verifica lo zip; la release è un solo file zip pubblicato senza action esterna: vedi D-056 e D-057.
|
||||
|
||||
## D-036 — Checkbox del modulo: presa visione, non consenso
|
||||
|
||||
@@ -375,91 +376,89 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
|
||||
- **Alternative scartate:** spostare i link dentro il riquadro e poi fuori dopo il caricamento (layout che cambia a ogni stato).
|
||||
- **Motivazione:** §7.8 e §10.2; un solo asse di allineamento nelle card.
|
||||
|
||||
## D-043 — Release: note sicure per la shell e ripiego automatico sull'API REST
|
||||
## D-043 — Release: note dal CHANGELOG e pubblicazione con l'API REST
|
||||
|
||||
- **Data:** 2026-10-16
|
||||
- **Contesto:** il comportamento di `forgejo-release@v2` con note che contengono apici inversi o virgolette e le sue dipendenze nell'immagine Playwright non sono verificabili senza l'istanza. Alcune istanze potrebbero non accettare segreti con prefisso `FORGEJO_`, e gli eventi creati con il token automatico non avviano altri workflow (deploy automatico).
|
||||
- **Scelta:** il workflow usa l'action indicata dal brief (§12.3) con le note prodotte da `changelog-notes.mjs --shell-safe`, che converte `codice` in «codice» e toglie `"`, `\` e `$(`. L'action ha `continue-on-error`: se non riesce, lo step successivo pubblica la stessa release con `scripts/release-upload.sh` (solo curl e node, già provato contro un'API simulata), che legge le note dal CHANGELOG senza passare dalla shell. Token: `FORGEJO_TOKEN`, oppure `RELEASE_TOKEN`, oppure quello automatico. Il deploy di esempio non esclude più `contact.php` e protegge `.well-known/`, `.user.ini` e `cgi-bin/`.
|
||||
- **Alternative scartate:** solo l'API REST (il brief prescrive l'action); note senza alcuna trasformazione.
|
||||
- **Motivazione:** nessuna release bloccata o alterata da un dettaglio dell'istanza. Consigliato un primo rilascio di prova sull'istanza reale prima di comunicare la versione.
|
||||
- **Aggiornamento (2026-10-16):** su Forgejo `secrets.FORGEJO_TOKEN` è sempre il token automatico e il prefisso `FORGEJO_` è riservato: il token personale è solo `RELEASE_TOKEN` (D-045). Il ripiego REST ora crea la release in bozza e la pubblica dopo i file (D-046).
|
||||
- **Contesto:** le note della release sono la sezione del CHANGELOG, che contiene apici inversi e virgolette: passate come testo a una shell o a un'action, rischiano di essere alterate o di rompere il comando. Un'action esterna di release aggiungerebbe inoltre dipendenze da verificare nell'immagine Playwright. Gli eventi prodotti con il token automatico del workflow non avviano altri workflow (deploy automatico, D-047).
|
||||
- **Scelta:** la release è pubblicata da `scripts/release-upload.sh` (solo curl e node), che legge le note dal CHANGELOG con `changelog-notes.mjs` e le inserisce nel JSON con node, senza passare da interpolazioni di shell. Nessuna action esterna di release. Token: `RELEASE_TOKEN` se presente, altrimenti quello automatico. Il deploy di esempio non esclude più `contact.php` e protegge `.well-known/`, `.user.ini` e `cgi-bin/`.
|
||||
- **Alternative scartate:** un'action esterna di pubblicazione (una dipendenza in più da raggiungere e da tenere aggiornata, con le note passate come testo alla shell); note senza alcuna trasformazione passate a una riga di shell.
|
||||
- **Motivazione:** nessuna release bloccata o alterata da un dettaglio dell'istanza o del testo delle note. Consigliato un primo rilascio di prova sull'istanza reale prima di comunicare la versione.
|
||||
- **Aggiornamento (2026-10-16):** il token personale è solo `RELEASE_TOKEN`: i nomi dei segreti che iniziano con `GITEA_` o `GITHUB_` sono riservati (D-045). Lo script crea la release in bozza e la pubblica dopo i file (D-046).
|
||||
- **Aggiornamento (2026-10-22):** la pubblicazione passa solo dallo script, senza altri passi di ripiego (D-056). L'opzione `--shell-safe` di `changelog-notes.mjs` non serve più ed è stata tolta.
|
||||
|
||||
## D-044 — Controlli coerenti con la configurazione e portabili
|
||||
|
||||
- **Data:** 2026-10-16
|
||||
- **Contesto:** la revisione del codice ha trovato tre situazioni in cui `verify` falliva senza un difetto del sito, più tre problemi di portabilità su Windows:
|
||||
- **Contesto:** la revisione del codice ha trovato tre situazioni in cui `verify` falliva senza un difetto del sito, più due problemi di portabilità su Windows:
|
||||
- la modalità `endpoint` con la CSP aggiornata;
|
||||
- una release a cavallo d'anno, con `SOURCE_DATE_EPOCH` dell'anno precedente;
|
||||
- il controllo dei link esterni, che verificava canonical e JSON-LD sul dominio di produzione, dove c'è ancora il vecchio sito;
|
||||
- su Windows: `import()` con un percorso assoluto, `tar` di Git Bash con «C:\…» e il checkout con CRLF.
|
||||
- su Windows: `import()` con un percorso assoluto e il checkout con CRLF.
|
||||
- **Scelta:**
|
||||
- La CSP è confrontata per direttive; una direttiva ripetuta è un errore (il browser applica solo la prima); in modalità `endpoint`, `form-action` deve contenere anche l'origine di `contactForm.endpoint` (provato con una configurazione temporanea).
|
||||
- L'anno del footer è calcolato con `src/lib/build.ts`, lo stesso modulo usato dal sito.
|
||||
- Gli URL del dominio del sito sono riscritti verso la build locale e controllati lì.
|
||||
- Portabilità: import con URL `file://`, `tar` alimentato da stdin, `.gitattributes` con `eol=lf`.
|
||||
- Portabilità: import con URL `file://`, `.gitattributes` con `eol=lf`.
|
||||
- Altre correzioni:
|
||||
- il ripiego di `freePort` restituisce la porta assegnata;
|
||||
- il pattern del telefono è valido anche con il flag `v` dei browser attuali, con un test sul formato;
|
||||
- l'avviso di invio troppo rapido è visibile;
|
||||
- Esc chiude il sottomenu aperto al passaggio del mouse (WCAG 1.4.13);
|
||||
- `contact.php` usa il mittente della busta (`-f`), non richiede mbstring (rifiuta l'UTF-8 non valido prima di contare i caratteri), non produce avvisi con `open_basedir` e usa il fuso Europe/Rome;
|
||||
- Esc su un sottomenu aperto al passaggio del mouse riporta il focus sul pulsante se era su un link del sottomenu;
|
||||
- `--shell-safe` neutralizza ogni `$` ($).
|
||||
- Esc su un sottomenu aperto al passaggio del mouse riporta il focus sul pulsante se era su un link del sottomenu.
|
||||
- **Alternative scartate:** documentare i limiti invece di correggerli.
|
||||
- **Motivazione:** `npm run verify` deve fallire solo per difetti reali (§11) e funzionare su Linux, macOS e Windows.
|
||||
|
||||
## D-045 — CI su Forgejo 16: job non bloccante, artifact, token e runner
|
||||
## D-045 — CI su Gitea: job non bloccante, artifact, token e runner
|
||||
|
||||
- **Data:** 2026-10-16
|
||||
- **Contesto:** sull'istanza le run della CI e della release restano «in attesa»: l'unico runner registrato («Ferrari», globale) è offline e non si è mai collegato (nessuna versione, nessun label). La revisione ha trovato tre difetti che si sarebbero presentati con il runner online:
|
||||
- Forgejo ignora `continue-on-error` a livello di job: il job «Link esterni (non bloccante)» avrebbe reso rossa la CI al primo sito esterno irraggiungibile;
|
||||
- `upload-artifact@v3` (v3.2.1) esclude i file nascosti: il report Lighthouse (`.lighthouseci/`) e `dist/.htaccess` non venivano mai caricati;
|
||||
- `secrets.FORGEJO_TOKEN` è sempre il token automatico e i nomi con prefisso `FORGEJO_`, `GITEA_` o `GITHUB_` sono riservati: `RELEASE_TOKEN` non veniva mai usato.
|
||||
- **Contesto:** la revisione dei workflow ha trovato difetti che si sarebbero presentati con il runner online:
|
||||
- `continue-on-error` a livello di job non è garantito dalla documentazione di Gitea Actions: il job «Link esterni (non bloccante)» avrebbe potuto rendere rossa la CI al primo sito esterno irraggiungibile;
|
||||
- il report Lighthouse sta in una cartella nascosta (`.lighthouseci/`): senza un'indicazione esplicita, il caricamento degli artifact potrebbe non includerla;
|
||||
- i nomi dei segreti che iniziano con `GITEA_` o `GITHUB_` sono riservati: il token personale per le release non può chiamarsi `GITEA_TOKEN`, serve un nome diverso (`RELEASE_TOKEN`).
|
||||
- **Scelta:**
|
||||
- `continue-on-error` sullo step «Controllo dei link esterni»;
|
||||
- `include-hidden-files: true` negli upload del report Lighthouse e di `dist`;
|
||||
- `continue-on-error` sullo step «Controllo dei link esterni», non sul job;
|
||||
- `include-hidden-files: true` nell'upload del report Lighthouse: dalla v3.2.0 `upload-artifact` esclude per impostazione predefinita i file e le cartelle nascosti, come `.lighthouseci/`, e l'opzione è quella che li fa caricare;
|
||||
- token `secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN` in release.yml;
|
||||
- per una futura v4 degli artifact il commento indica il fork `code.forgejo.org/forgejo/upload-artifact@v4`, perché `actions/upload-artifact@v4` fallisce su Forgejo con `GHESNotSupportedError`;
|
||||
- `upload-artifact@v3`, perché `actions/upload-artifact@v4` fallisce su Gitea con `GHESNotSupportedError` (D-056);
|
||||
- `runs-on: ubuntu-latest` in tutti i job, il label predefinito di `act_runner`, con un commento che invita ad adattarlo se il runner ne usa un altro;
|
||||
- variabile del repository `SITE_URL` passata a build e test di CI e release (D-051).
|
||||
|
||||
I due job sono stati eseguiti in locale negli stessi container del runner (Playwright 1.56.1 noble come root, node:24): verdi, `verify` in circa 6 minuti. Il runner non è stato configurato: decisione rimandata dal manutentore.
|
||||
I job sono stati eseguiti in locale negli stessi container del runner (Playwright 1.56.1 noble come root, node:24): verdi, `verify` in circa 6 minuti.
|
||||
|
||||
- **Alternative scartate:** `actions/upload-artifact@v4` (non funziona su Forgejo); il controllo dei link esterni in un workflow pianificato (si perderebbe il controllo a ogni push).
|
||||
- **Motivazione:** la CI deve diventare verde appena un runner con label `docker` è online, senza altre correzioni.
|
||||
- **Alternative scartate:** `actions/upload-artifact@v4` (non funziona su Gitea); il controllo dei link esterni in un workflow pianificato (si perderebbe il controllo a ogni push).
|
||||
- **Motivazione:** la CI deve diventare verde appena un runner con label `ubuntu-latest` è online, senza altre correzioni.
|
||||
|
||||
## D-046 — Release: pubblicazione dopo i file e controllo del tag nel ripiego REST
|
||||
## D-046 — Release: pubblicazione dopo i file e controllo del tag
|
||||
|
||||
- **Data:** 2026-10-16
|
||||
- **Contesto:** `scripts/release-upload.sh`:
|
||||
- creava la release già pubblicata prima di caricare i file;
|
||||
- lasciava in bozza una release creata dall'action fallita a metà;
|
||||
- lasciava in bozza una release rimasta a metà dopo un errore;
|
||||
- cancellava un file prima di caricare il nuovo;
|
||||
- non verificava il tag (senza tag Forgejo lo crea sulla punta del branch predefinito).
|
||||
|
||||
Inoltre il tar.gz cambiava impronta tra Windows e Linux, perché l'header gzip registra il sistema operativo.
|
||||
|
||||
- non verificava il tag (senza tag Gitea lo crea sulla punta del branch predefinito).
|
||||
- **Scelta:**
|
||||
- release nuova: bozza, file, poi pubblicazione con titolo e note del CHANGELOG;
|
||||
- release esistente, anche in bozza: caricamento del nuovo file, cancellazione del vecchio, pubblicazione;
|
||||
- tag verificato sul server e confrontato con quello locale;
|
||||
- byte 9 dell'header gzip fissato a 3.
|
||||
- tag verificato sul server e confrontato con quello locale.
|
||||
|
||||
Provato contro un'API simulata in 7 scenari: release nuova, bozza, release pubblicata, tag mancante, tag diverso, errore di caricamento su release nuova e su release pubblicata.
|
||||
|
||||
- **Alternative scartate:** chiedere una conferma (es. `FORCE=1`) per sostituire i file di una release pubblicata. È il comportamento documentato, e ora la sostituzione non lascia mai la release senza un file.
|
||||
- **Motivazione:** nessuna release pubblicata senza file o con il tag sul commit sbagliato; pacchetto identico su ogni piattaforma a parità di versione di Node.js.
|
||||
- **Motivazione:** nessuna release pubblicata senza file o con il tag sul commit sbagliato.
|
||||
|
||||
## D-047 — Deploy automatico di esempio: evento, ultima release e percorsi protetti
|
||||
|
||||
- **Data:** 2026-10-16
|
||||
- **Contesto:** l'action forgejo-release pubblica la release passando da bozza a pubblicata, e Forgejo notifica il passaggio come «edited». L'esempio ascoltava solo «published» e quindi non partiva. Non escludeva le pre-release, e con un segreto `DEPLOY_PATH` mancante `rsync --delete` avrebbe sincronizzato la radice del server.
|
||||
- **Contesto:** `scripts/release-upload.sh` (usato da release.yml) crea la release in bozza, carica lo zip e solo allora la pubblica; poiché il tag esiste già, Gitea notifica il passaggio come modifica della release («edited») e non come «published». L'esempio ascoltava solo «published» e quindi non partiva. Non escludeva le pre-release, e con un segreto `DEPLOY_PATH` mancante `rsync --delete` avrebbe sincronizzato la radice del server.
|
||||
- **Scelta:**
|
||||
- eventi `published` ed `edited`;
|
||||
- un job «controllo» lascia proseguire solo una release stabile che sia l'ultima pubblicata e, per «edited», solo se i file sono stati caricati nell'ultima ora (la pubblicazione di release.yml o di release-upload.sh): una modifica successiva di titolo o note, anche dell'ultima release, non avvia il deploy; l'avvio manuale procede sempre;
|
||||
- eventi `published` ed `edited` (i due tipi che Gitea supporta per `release`);
|
||||
- un job «controllo» lascia proseguire solo una release stabile che sia l'ultima pubblicata e, per «edited», solo se lo zip è stato caricato nell'ultima ora (la pubblicazione di release.yml o di release-upload.sh): una modifica successiva di titolo o note, anche dell'ultima release, non avvia il deploy; l'avvio manuale procede sempre, con un tag nel formato `vX.Y.Z`;
|
||||
- se l'API delle release non risponde lo step fallisce, invece di saltare il deploy in silenzio;
|
||||
- download con il token automatico; dominio per il controllo finale dalla variabile `SITE_URL` o da `BUILD-INFO.txt`;
|
||||
- download dello zip `sito-studio-grasso-vX.Y.Z.zip` con il token automatico, controllo di integrità (`unzip -t`) e della presenza di `index.html` e `.htaccess`; dominio per il controllo finale dalla variabile `SITE_URL` o dalla riga `Sitemap:` del `robots.txt` contenuto nello zip;
|
||||
- l'avvio automatico richiede che la release sia pubblicata con il token personale (`RELEASE_TOKEN`): Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro workflow; senza il segreto si avvia a mano dalla scheda Actions;
|
||||
- controlli su `DEPLOY_PATH`, `FTP_PATH` e `RCLONE_DEST`; per rsync, sincronizzazione solo se nella cartella c'è il file di conferma `.deploy-studio-grasso`, creato a mano una volta.
|
||||
- **Alternative scartate:** un job di deploy dentro release.yml attivato da una variabile: più robusto, ma porta nel workflow attivo segreti e varianti commentate. Scartato anche il solo evento `published`, che con l'action non scatta.
|
||||
- **Alternative scartate:** un job di deploy dentro release.yml attivato da una variabile: più robusto, ma porta nel workflow attivo segreti e varianti commentate. Scartato anche il solo evento `published`, che con la pubblicazione da bozza non scatta.
|
||||
- **Motivazione:** l'esempio deve funzionare quando viene attivato, non deve ripubblicare versioni per una semplice modifica delle note e non deve poter sincronizzare con `--delete` una cartella diversa da quella del sito (per FTP la guida avverte di non indicare la radice dell'account).
|
||||
|
||||
## D-048 — Browser supportati dal CSS generato
|
||||
@@ -585,3 +584,35 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data ·
|
||||
|
||||
- **Alternative scartate:** ridurre la spaziatura delle voci (cambia il design a tutte le larghezze); spostare il passaggio al menu mobile oltre i 960 px (punto di interruzione condiviso da molti componenti, D-028).
|
||||
- **Motivazione:** intestazione ordinata a ogni larghezza desktop, senza cambiare il design alle larghezze comuni.
|
||||
|
||||
## D-056 — Repository definitivo su Gitea: workflow in `.gitea/workflows`
|
||||
|
||||
- **Data:** 2026-10-22
|
||||
- **Contesto:** il repository `BalboSoft/Studio_Grasso` risiede in via definitiva sull'istanza Gitea `https://gitea.encke-hake.ts.net`: CI, release e deploy automatico devono funzionare con Gitea Actions (runner `act_runner`), senza dipendere dalla configurazione dell'istanza e indicando subito, in caso di errore, quale controllo è fallito.
|
||||
- **Scelta:**
|
||||
- workflow in `.gitea/workflows/` (`ci.yml`, `release.yml`); l'esempio di deploy automatico, sempre disattivato, è `deploy/gitea-deploy.yml.example`, da copiare in `.gitea/workflows/deploy.yml` per attivarlo;
|
||||
- `runs-on: ubuntu-latest` in tutti i job, il label predefinito di `act_runner`; un commento in ogni workflow ricorda di adattarlo se il runner ne usa un altro. Container: Playwright `v1.56.1-noble` (stessa versione di `@playwright/test`) per verifica e release, `node:24` per i link esterni;
|
||||
- azioni di terze parti con URL completo su github.com (`uses: https://github.com/actions/checkout@v4`), così non dipendono dall'impostazione `DEFAULT_ACTIONS_URL` dell'istanza; il runner deve poter raggiungere github.com;
|
||||
- artifact con `upload-artifact@v3`, perché la v4 non funziona su Gitea (fallisce con `GHESNotSupportedError`); gli upload stanno su step con `continue-on-error`, così un problema dello storage non rende rossa una verifica riuscita;
|
||||
- CI: il job «verify» ripete passo per passo `npm run verify`, nello stesso ordine (lint, formattazione, controllo dei tipi, build, HTML, link interni, end-to-end, accessibilità, conformità, Lighthouse), poi crea lo zip di rilascio (`scripts/package.mjs`) e ne verifica il contenuto (`npm run test:package`); il controllo dei link esterni è un job a parte e non bloccante (D-045). Modificando gli script `verify` o `test` di `package.json` vanno aggiornati anche i passi;
|
||||
- release: a ogni tag `vX.Y.Z` il workflow controlla tag, versione e CHANGELOG, esegue `verify` e `package` e pubblica la release con `scripts/release-upload.sh`, che usa l'API REST di Gitea (variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`), senza action esterne di release (D-043);
|
||||
- token e variabili: segreto facoltativo `RELEASE_TOKEN` (token personale con permesso `write:repository`); se manca si usa il token automatico del workflow. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Il dominio si imposta con la variabile del repository `SITE_URL` (D-051).
|
||||
- `timeout-minutes` larghi (90 per `verify` e per la release, 45 per il controllo dei link esterni; prima 30, 40 e 15): la rete del runner di casa è lenta. Il 22 ottobre 2026 la prima esecuzione ha impiegato più di venti minuti per scaricare l'immagine Playwright (oltre 1 GB), tre minuti per clonare `setup-node` da github.com e minuti per le dipendenze; lo scarico dell'immagine si ripete se il runner la elimina con la pulizia delle immagini inutilizzate;
|
||||
- niente `cache: npm` in `setup-node`: il server di cache del runner non è raggiungibile dal container del job (`getCacheEntry failed: connect ETIMEDOUT`), e a ogni esecuzione il passo aspettava circa cinque minuti prima di proseguire con un avviso. Le dipendenze si scaricano con `npm ci`;
|
||||
- **Alternative scartate:**
|
||||
- le copie delle azioni ospitate su gitea.com: restano la via d'uscita, indicata nel commento di `ci.yml`, se il runner non raggiunge github.com, ma i workflow usano le azioni originali senza un secondo repository di azioni da tenere allineato;
|
||||
- `actions/upload-artifact@v4`, che non funziona su Gitea;
|
||||
- workflow in `.github/workflows`: sono scritti per Gitea Actions (URL completi delle azioni, `upload-artifact@v3`, label di `act_runner`) e la cartella indicata dalla documentazione di Gitea è `.gitea/workflows/`;
|
||||
- un unico passo `npm run verify` nella CI: in caso di errore bisognerebbe leggere il log per capire quale controllo è fallito.
|
||||
- **Motivazione:** CI e release usano solo funzioni documentate di Gitea Actions e non dipendono dalle azioni predefinite dell'istanza né da action di terzi per la pubblicazione; la pagina dell'esecuzione mostra subito il controllo fallito e un errore di pacchetto emerge nella CI, non al momento del tag.
|
||||
|
||||
## D-057 — Release con un solo file: lo zip del sito
|
||||
|
||||
- **Data:** 2026-10-22
|
||||
- **Contesto:** la release serve a ottenere i file del sito da copiare sull'hosting per metterlo online. Il pacchetto conteneva quattro file (zip, tar.gz, `SHA256SUMS.txt`, `BUILD-INFO.txt`): per copiare il sito bastava lo zip, il resto era da capire e ignorare. Gitea, inoltre, aggiunge da solo a ogni release due archivi, «Source code (ZIP)» e «Source code (TAR.GZ)», che contengono il codice sorgente del repository e non il sito.
|
||||
- **Scelta:** la release ha un solo file allegato, `sito-studio-grasso-vX.Y.Z.zip`, con il contenuto di `dist/` alla radice (nessuna cartella di primo livello) e `.htaccess` compreso: va estratto nella cartella pubblica dell'hosting. L'archivio tar.gz, `SHA256SUMS.txt` e `BUILD-INFO.txt` non vengono più creati. `package.mjs` crea solo lo zip, `check-package.mjs` verifica che `release/` contenga solo quello (D-033) e `release-upload.sh` carica i file che trova in `release/`. Versione del pacchetto: 1.0.1. Dove si spiega come scaricare il sito va detto di scegliere lo zip `sito-studio-grasso-vX.Y.Z.zip`, non i «Source code» di Gitea.
|
||||
- **Alternative scartate:**
|
||||
- tar.gz, `SHA256SUMS.txt` e `BUILD-INFO.txt` accanto allo zip: più file tra cui scegliere per chi deve solo copiare il sito; il tar.gz serviva ai server Linux, dove però lo zip si estrae con `unzip` (come nell'esempio di deploy);
|
||||
- `BUILD-INFO.txt` dentro lo zip: aggiungerebbe un file alla radice pubblica del sito, raggiungibile da chiunque conosca l'indirizzo;
|
||||
- impronte SHA-256 separate: l'integrità è garantita dalla verifica del contenuto dello zip contro `dist/` prima della pubblicazione (D-033) e, nel deploy di esempio, dal controllo `unzip -t` dopo il download.
|
||||
- **Motivazione:** chi pubblica il sito scarica un file e lo copia sull'hosting, senza altri passaggi. Conseguenza: i «Source code» che Gitea mette in ogni release non sono il sito, e le guide di deploy lo dicono. Il dominio per cui è costruito il pacchetto non è più scritto in `BUILD-INFO.txt`: il deploy di esempio lo legge dalla variabile `SITE_URL` o dal `robots.txt` contenuto nello zip (D-047).
|
||||
@@ -1,10 +1,10 @@
|
||||
# Sito web dello Studio Grasso
|
||||
|
||||
Sito statico dello **Studio Grasso — Studio Tributario e Societario** (Montegrosso d'Asti e Asti), realizzato con [Astro](https://astro.build/). Nessun tracciamento, nessun cookie, nessuna risorsa di terze parti caricata senza un'azione esplicita dell'utente; pacchetto di rilascio universale (solo file statici, con `.htaccess`) pronto per qualsiasi hosting.
|
||||
Sito statico dello **Studio Grasso — Studio Tributario e Societario** (Montegrosso d'Asti e Asti), realizzato con [Astro](https://astro.build/). Nessun tracciamento, nessun cookie, nessuna risorsa di terze parti caricata senza un'azione esplicita dell'utente; pacchetto di rilascio universale (un file zip di soli file statici, con `.htaccess`) pronto per qualsiasi hosting.
|
||||
|
||||
- Requisiti di progetto: [`docs/BRIEF.md`](docs/BRIEF.md) · Mockup: [`docs/mockups/`](docs/mockups/)
|
||||
- Decisioni tecniche: [`DECISIONS.md`](DECISIONS.md) · Dati da fornire: [`TODO-STUDIO.md`](TODO-STUDIO.md) · Novità: [`CHANGELOG.md`](CHANGELOG.md)
|
||||
- Wiki del repository (come vedere e provare il sito, CI e release, dati da fornire): [Wiki](https://forgejo.encke-hake.ts.net/BalboSoft/Studio_Grasso/wiki/Home) · Release: [v1.0.0](https://forgejo.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases/tag/v1.0.0)
|
||||
- Wiki del repository (come vedere e provare il sito, CI e release, dati da fornire): [Wiki](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/wiki/Home) · Release (lo zip del sito da mettere online): [elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases)
|
||||
- Pubblicazione sull'hosting: [`docs/DEPLOY.md`](docs/DEPLOY.md) · Aggiornare i contenuti: [`docs/CONTENUTI.md`](docs/CONTENUTI.md) · Conformità: [`docs/CONFORMITA.md`](docs/CONFORMITA.md)
|
||||
|
||||
## Requisiti
|
||||
@@ -21,7 +21,7 @@ npm run dev # sito in sviluppo su http://localhost:4321 (si aggiorna a ogn
|
||||
npm run build # genera il sito statico in dist/
|
||||
npm run preview # serve dist/ su http://127.0.0.1:4321
|
||||
npm run verify # tutti i controlli di qualità (gli stessi della CI)
|
||||
npm run package # crea il pacchetto di rilascio in release/
|
||||
npm run package # crea lo zip di rilascio in release/
|
||||
```
|
||||
|
||||
### Avvio in debug con VS Code
|
||||
@@ -53,10 +53,10 @@ Maiusc+F5 ferma il server e chiude il browser quando è selezionata la sessione
|
||||
| `npm run test:lighthouse` | Lighthouse CI: Performance ≥ 0.95, Accessibility 1, Best Practices ≥ 0.95, SEO 1 |
|
||||
| `npm test` | html + link + e2e + a11y + conformità |
|
||||
| `npm run verify` | lint + formattazione + tipi + build + `npm test` + Lighthouse |
|
||||
| `npm run package` | build + pacchetto in `release/` + verifica del pacchetto (`test:package`) |
|
||||
| `npm run package` | build + zip in `release/` + verifica del contenuto dello zip (`test:package`) |
|
||||
| `npm run icons` | rigenera marchio, favicon, apple-touch-icon e immagine di condivisione |
|
||||
|
||||
`npm run verify` deve terminare senza errori prima di ogni rilascio: è il comando eseguito dalla CI.
|
||||
`npm run verify` deve terminare senza errori prima di ogni rilascio: la CI ne ripete i controlli uno per uno e `release.yml` lo esegue prima di creare lo zip.
|
||||
|
||||
## Struttura
|
||||
|
||||
@@ -73,8 +73,9 @@ src/scripts/ piccoli script: menu, mappa su consenso, modulo, ancore del v
|
||||
public/ .htaccess, favicon e immagini statiche (copiati così come sono)
|
||||
scripts/ script di test, pacchetto, icone, note di rilascio, upload della release
|
||||
tests/ e2e/ e a11y/ (Playwright), helpers/
|
||||
deploy/ nginx.conf.example, optional-php-form/contact.php, esempio di deploy automatico
|
||||
.forgejo/workflows ci.yml (verifica) e release.yml (pubblicazione della release)
|
||||
deploy/ nginx.conf.example, optional-php-form/contact.php, gitea-deploy.yml.example
|
||||
(esempio di deploy automatico, disattivato)
|
||||
.gitea/workflows/ ci.yml (verifica e zip di prova) e release.yml (zip e pubblicazione della release)
|
||||
.vscode/ launch.json e tasks.json: avvio del sito in debug (F5)
|
||||
docs/ brief, mockup, guide di deploy e contenuti, conformità
|
||||
site.config.mjs dominio pubblico del sito (unica fonte per build, test e pacchetto)
|
||||
@@ -96,7 +97,7 @@ npm run verify
|
||||
Remove-Item Env:SITE_URL
|
||||
```
|
||||
|
||||
In Git Bash, macOS o Linux: `SITE_URL=https://studiograssoezio.it npm run verify`. Per un cambio di dominio definitivo modificare invece il valore in `site.config.mjs`, oppure la variabile del repository `SITE_URL` su Forgejo (Impostazioni → Actions → Variabili), che CI e release usano per la build.
|
||||
In Git Bash, macOS o Linux: `SITE_URL=https://studiograssoezio.it npm run verify`. Per un cambio di dominio definitivo modificare invece il valore in `site.config.mjs`, oppure la variabile del repository `SITE_URL` su Gitea (Impostazioni → Actions → Variabili), che CI e release usano per la build. Lo zip della release contiene un sito costruito per quel dominio.
|
||||
|
||||
Per verificare il modulo attivo (validazione, anti-spam, pagina di conferma), in PowerShell:
|
||||
|
||||
@@ -110,21 +111,27 @@ npm run build # ripristina la versione senza modulo
|
||||
|
||||
In Git Bash, macOS o Linux: `CONTACT_FORM_MODE=php npm run build && npx playwright test tests/e2e/form.spec.ts && npm run build`.
|
||||
|
||||
## Pubblicare il repository su Forgejo
|
||||
## Pubblicare il repository su Gitea
|
||||
|
||||
Questo repository è un clone di `https://forgejo.encke-hake.ts.net/BalboSoft/Studio_Grasso.git`: il remote `origin` è già configurato. Per un repository nuovo: `git remote add origin <url-del-repository>`.
|
||||
Il repository è su Gitea: <https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso>. In un clone il remote `origin` è già configurato (`git remote -v` per controllare). Per un repository nuovo: `git remote add origin <url-del-repository>`.
|
||||
|
||||
```bash
|
||||
git push -u origin main # pubblica il codice: parte la CI (.forgejo/workflows/ci.yml)
|
||||
git push -u origin main # pubblica il codice: parte la CI (.gitea/workflows/ci.yml)
|
||||
git push origin vX.Y.Z # pubblica un tag: parte la release (.gitea/workflows/release.yml)
|
||||
```
|
||||
|
||||
Consigliato: proteggere il branch `main` (Impostazioni del repository → Branch → Protezione: niente push forzati, merge solo con CI verde) e lavorare con branch e pull request. I messaggi di commit seguono [Conventional Commits](https://www.conventionalcommits.org/it/) in italiano (`feat:`, `fix:`, `docs:`, `ci:`, `test:`, `chore:`).
|
||||
Consigliato: proteggere il branch `main` (Impostazioni del repository → Branch → nuova regola per `main`: niente push forzati, merge solo con i controlli di stato, cioè la CI, superati) e lavorare con branch e pull request. I messaggi di commit seguono [Conventional Commits](https://www.conventionalcommits.org/it/) in italiano (`feat:`, `fix:`, `docs:`, `ci:`, `test:`, `chore:`).
|
||||
|
||||
La CI richiede un **runner Forgejo Actions** con label `docker` (modificabile in cima ai file dei workflow). Le azioni sono indicate con URL completo su `code.forgejo.org`, quindi non dipendono dalla configurazione dell'istanza.
|
||||
**CI e release usano Gitea Actions**, con i workflow in `.gitea/workflows/`:
|
||||
|
||||
- `ci.yml` parte a ogni push su `main`, a ogni pull request e a mano dalla scheda **Actions**: ripete passo per passo i controlli di `npm run verify` (così si vede subito quale è fallito), poi crea lo zip di rilascio e ne verifica il contenuto.
|
||||
- `release.yml` parte a ogni tag `vX.Y.Z`: verifica tutto, crea lo zip e lo pubblica nella sezione **Release** (vedi sotto).
|
||||
|
||||
I job girano su un **runner** `act_runner` con label `ubuntu-latest`, il label predefinito di `act_runner` (modificabile in cima ai file dei workflow). Perché i workflow partano, le Actions devono essere attive sul repository (Impostazioni del repository → «Enable Repository Actions») e il runner deve essere registrato su Gitea. I runner del repository, con i loro label, e il token per registrarne uno nuovo si trovano in Impostazioni del repository → Actions → Runner (`<url-del-repository>/settings/actions/runners`); i passi per l'installazione e la registrazione sono nella [guida di Gitea Actions](https://docs.gitea.com/usage/actions/quickstart). Le azioni di terze parti (checkout, setup-node, upload-artifact) sono indicate con URL completo su `github.com`, quindi non dipendono dalla configurazione dell'istanza, ma il runner deve poter raggiungere `github.com`. I report dei test sono caricati con `upload-artifact@v3`: la v4 non funziona su Gitea.
|
||||
|
||||
## Fare una release
|
||||
|
||||
1. Aggiornare `version` in `package.json` (SemVer: `1.0.1` correzioni, `1.1.0` novità, `2.0.0` cambiamenti importanti) e `npm install` per allineare `package-lock.json`.
|
||||
1. Aggiornare `version` in `package.json` (SemVer: si aumenta l'ultima cifra per le correzioni, la cifra centrale per le novità, la prima per i cambiamenti importanti) e `npm install` per allineare `package-lock.json`.
|
||||
2. Aggiungere in `CHANGELOG.md` la sezione `## [X.Y.Z] - AAAA-MM-GG`: diventa il testo della release.
|
||||
3. `npm run verify`, commit (`chore(release): prepara vX.Y.Z`) e push su `main`.
|
||||
4. Creare e pubblicare il tag:
|
||||
@@ -134,15 +141,17 @@ La CI richiede un **runner Forgejo Actions** con label `docker` (modificabile in
|
||||
git push origin vX.Y.Z
|
||||
```
|
||||
|
||||
Il workflow `release.yml` verifica che tag, `package.json` e CHANGELOG coincidano, esegue `npm run verify` e `npm run package` e pubblica nella sezione **Release** del repository: `sito-studio-grasso-vX.Y.Z.zip`, `.tar.gz`, `SHA256SUMS.txt`, `BUILD-INFO.txt`.
|
||||
Il workflow `release.yml` verifica che tag, `package.json` e CHANGELOG coincidano, esegue `npm run verify` e `npm run package` e pubblica nella sezione **Release** del repository (<https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases>) un solo file allegato: **`sito-studio-grasso-vX.Y.Z.zip`**. È il sito pronto da estrarre nella cartella pubblica dell'hosting: il contenuto di `dist/` sta alla radice dello zip, `.htaccess` compreso, senza cartelle di primo livello. Il dominio del sito è quello di `site.config.mjs`, oppure la variabile del repository `SITE_URL` se impostata (vedi «Configurazione»).
|
||||
|
||||
**Token:** per impostazione predefinita la release è pubblicata con il token automatico del workflow, che su Forgejo ha il permesso di scrittura sul repository. Per usare un token personale (necessario per avviare in automatico il deploy facoltativo, `docs/DEPLOY.md` sezione 9, perché le modifiche fatte con il token automatico non avviano altri workflow) creare un _access token_ (Impostazioni utente → Applicazioni → Genera nuovo token, permesso **`write:repository`**) e salvarlo come segreto del repository **`RELEASE_TOKEN`** (Impostazioni del repository → Actions → Segreti): il workflow lo usa al posto di quello automatico. Non usare nomi che iniziano con `FORGEJO_`, `GITEA_` o `GITHUB_`: Forgejo li riserva, e `secrets.FORGEJO_TOKEN` è sempre il token automatico.
|
||||
**Quale file scaricare:** a ogni release Gitea aggiunge da solo due archivi, «Source code (ZIP)» e «Source code (TAR.GZ)». Contengono il codice sorgente, **non** il sito: per metterlo online scegliere sempre lo zip `sito-studio-grasso-vX.Y.Z.zip`. La procedura di pubblicazione sull'hosting è in [`docs/DEPLOY.md`](docs/DEPLOY.md).
|
||||
|
||||
Il workflow pubblica la release con l'action `forgejo-release`; se l'action non riesce, lo step successivo la pubblica con l'API REST (`scripts/release-upload.sh`, solo `curl` e `node`). Lo stesso script serve anche a mano (istruzioni in testa al file e in `docs/DEPLOY.md`).
|
||||
**Token:** per impostazione predefinita la release è pubblicata con il token automatico del workflow. Se lo step di pubblicazione fallisce con errore 403 o 404, oppure per avviare in automatico il deploy facoltativo (`docs/DEPLOY.md` sezione 9: le azioni compiute con il token automatico non avviano altri workflow), creare un _access token_ (Impostazioni utente → Applicazioni → Genera nuovo token, permesso **`write:repository`**) e salvarlo come segreto del repository **`RELEASE_TOKEN`** (Impostazioni del repository → Actions → Segreti): se esiste, il workflow lo usa al posto di quello automatico. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`.
|
||||
|
||||
La release è pubblicata da `scripts/release-upload.sh` (solo `curl` e `node`) con l'API REST di Gitea, senza action esterne: crea la release in bozza, carica lo zip e solo allora la pubblica. Lo stesso script serve anche a mano (istruzioni in testa al file e in `docs/DEPLOY.md`).
|
||||
|
||||
## Aggiornare le dipendenze
|
||||
|
||||
Le versioni sono bloccate (senza `^`) e `package-lock.json` è committato. Per aggiornare: `npm install <pacchetto>@<versione> --save-exact`, poi `npm run verify`. **Playwright:** la versione di `@playwright/test`, `playwright` e `playwright-core` deve coincidere con l'immagine `mcr.microsoft.com/playwright:vX.Y.Z-noble` usata in `.forgejo/workflows/ci.yml` e `release.yml` (oggi 1.56.1).
|
||||
Le versioni sono bloccate (senza `^`) e `package-lock.json` è committato. Per aggiornare: `npm install <pacchetto>@<versione> --save-exact`, poi `npm run verify`. **Playwright:** la versione di `@playwright/test`, `playwright` e `playwright-core` deve coincidere con l'immagine `mcr.microsoft.com/playwright:vX.Y.Z-noble` usata in `.gitea/workflows/ci.yml` e `release.yml` (oggi 1.56.1): aggiornandola, cambiare la versione in tutti e due i file.
|
||||
|
||||
## Note
|
||||
|
||||
|
||||
+1
-1
@@ -35,7 +35,7 @@ La Privacy policy cita il fornitore di hosting come responsabile del trattamento
|
||||
|
||||
### B3. Dominio definitivo del nuovo sito
|
||||
|
||||
Il sito è costruito per `https://www.grassoezio.it` (canonical, sitemap, robots.txt, dati strutturati). Se il dominio sarà diverso (es. `studiograssoezio.it`), cambiare il valore predefinito in `site.config.mjs`, riga 9 (vale per build, controlli e pacchetto), oppure impostare la variabile del repository `SITE_URL` su Forgejo (Impostazioni → Actions → Variabili), che CI e release usano per la build. In locale la variabile `SITE_URL` va impostata per tutti i comandi (`npm run verify`, `npm run package`), non solo per la build (README, «Configurazione»). Nel `.htaccess` (`public/.htaccess`, sezione «Redirect», punto 2) decommentare la regola www/non-www coerente con il dominio scelto.
|
||||
Il sito è costruito per `https://www.grassoezio.it` (canonical, sitemap, robots.txt, dati strutturati). Se il dominio sarà diverso (es. `studiograssoezio.it`), cambiare il valore predefinito in `site.config.mjs`, riga 9 (vale per build, controlli e pacchetto), oppure impostare la variabile del repository `SITE_URL` su Gitea (Impostazioni → Actions → Variabili), che CI e release usano per la build. In locale la variabile `SITE_URL` va impostata per tutti i comandi (`npm run verify`, `npm run package`), non solo per la build (README, «Configurazione»). Nel `.htaccess` (`public/.htaccess`, sezione «Redirect», punto 2) decommentare la regola www/non-www coerente con il dominio scelto.
|
||||
|
||||
### B4. Validazione dei testi legali
|
||||
|
||||
|
||||
@@ -1,27 +1,39 @@
|
||||
# =============================================================================
|
||||
# DEPLOY AUTOMATICO (DISATTIVATO) — esempio per Forgejo Actions.
|
||||
# DEPLOY AUTOMATICO (DISATTIVATO) — esempio per Gitea Actions.
|
||||
#
|
||||
# Per attivarlo: copiare questo file in .forgejo/workflows/deploy.yml, scegliere UNA delle
|
||||
# Per attivarlo: copiare questo file in .gitea/workflows/deploy.yml, scegliere UNA delle
|
||||
# varianti qui sotto (rsync su SSH, FTPS con lftp, object storage con rclone), decommentarla
|
||||
# e creare i segreti del repository indicati (Impostazioni → Actions → Segreti).
|
||||
# e creare i segreti del repository indicati (Impostazioni → Actions → Segreti). I nomi dei
|
||||
# segreti non possono iniziare con GITEA_ o GITHUB_.
|
||||
# Istruzioni complete in docs/DEPLOY.md, sezione «Deploy automatico».
|
||||
#
|
||||
# Pubblica il contenuto dello zip della release, sito-studio-grasso-vX.Y.Z.zip: l'unico file
|
||||
# allegato da release.yml (i due archivi «Source code» che Gitea aggiunge da solo sono il
|
||||
# codice sorgente, non il sito). Dopo il download ne controlla l'integrità (unzip -t) e la
|
||||
# presenza di index.html e .htaccess.
|
||||
#
|
||||
# Si avvia quando release.yml pubblica una release stabile oppure a mano (workflow_dispatch,
|
||||
# indicando il tag: serve anche per tornare a una versione precedente). Pubblica il pacchetto
|
||||
# della release, già verificato.
|
||||
# - Evento: l'action forgejo-release crea la release in bozza e poi la pubblica, e Forgejo
|
||||
# notifica questo passaggio come «edited», non come «published». Per questo si ascoltano
|
||||
# entrambi, e il job «controllo» procede solo per una release stabile che sia l'ultima
|
||||
# pubblicata e, per «edited», solo se i file sono stati caricati nell'ultima ora (cioè è la
|
||||
# pubblicazione fatta da release.yml o da scripts/release-upload.sh). Modificare in seguito
|
||||
# titolo o note di una release, anche l'ultima, non avvia il deploy. Dopo un ritorno manuale
|
||||
# a una versione precedente segnare come pre-release la versione ritirata.
|
||||
# - Token: l'avvio automatico funziona solo se release.yml pubblica la release con un token
|
||||
# personale (segreto RELEASE_TOKEN): le modifiche fatte con il token automatico non avviano
|
||||
# altri workflow. Senza il segreto, avviarlo a mano dalla scheda Actions.
|
||||
# indicando il tag: serve anche per tornare a una versione precedente).
|
||||
# - Evento: per «release» Gitea supporta i tipi published (release non in bozza creata) ed
|
||||
# edited (release modificata); una bozza non genera alcun evento. release.yml e
|
||||
# scripts/release-upload.sh creano la release in bozza, caricano lo zip e solo allora la
|
||||
# pubblicano: Gitea notifica questo passaggio come modifica, non come «published». Per questo
|
||||
# si ascoltano entrambi i tipi, e il job «controllo» procede solo per una release stabile che
|
||||
# sia l'ultima pubblicata e, per le modifiche, solo se lo zip è stato caricato nell'ultima ora
|
||||
# (cioè è la pubblicazione fatta da release.yml o da scripts/release-upload.sh). Modificare
|
||||
# in seguito titolo o note di una release, anche l'ultima, non avvia il deploy. Dopo un
|
||||
# ritorno manuale a una versione precedente segnare come pre-release la versione ritirata.
|
||||
# - Token: Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro
|
||||
# workflow (per evitare cicli). L'avvio automatico funziona quindi solo se release.yml
|
||||
# pubblica la release con un token personale (segreto RELEASE_TOKEN). Senza il segreto,
|
||||
# avviarlo a mano dalla scheda Actions del repository.
|
||||
# - File: per gli eventi di release Gitea legge il workflow dal commit del tag, quindi questo
|
||||
# file deve già essere nel commit su cui è messo il tag. Per una release uscita prima di
|
||||
# aggiungerlo, usare l'avvio manuale.
|
||||
# I file gestiti dall'hosting (.well-known/, .user.ini, cgi-bin/) sono esclusi dalla
|
||||
# sincronizzazione, quindi non vengono cancellati.
|
||||
# RUNNER: `runs-on: docker`, adattare il label come negli altri workflow.
|
||||
# RUNNER: `runs-on: ubuntu-latest`, il label predefinito di act_runner, come negli altri
|
||||
# workflow: sostituirlo se il runner ne usa un altro.
|
||||
# =============================================================================
|
||||
name: Deploy
|
||||
|
||||
@@ -31,13 +43,13 @@ on:
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
tag:
|
||||
description: 'Tag della release da pubblicare (es. v1.0.0)'
|
||||
description: 'Tag della release da pubblicare (es. v1.0.1)'
|
||||
required: true
|
||||
|
||||
jobs:
|
||||
controllo:
|
||||
name: Release da pubblicare
|
||||
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
container:
|
||||
image: debian:stable-slim
|
||||
outputs:
|
||||
@@ -48,7 +60,7 @@ jobs:
|
||||
env:
|
||||
EVENTO: ${{ github.event_name }}
|
||||
AZIONE: ${{ github.event.action }}
|
||||
TAG_MANUALE: ${{ inputs.tag }}
|
||||
TAG_MANUALE: ${{ github.event.inputs.tag }}
|
||||
TAG_RELEASE: ${{ github.event.release.tag_name }}
|
||||
BOZZA: ${{ github.event.release.draft }}
|
||||
PRERELEASE: ${{ github.event.release.prerelease }}
|
||||
@@ -56,6 +68,9 @@ jobs:
|
||||
run: |
|
||||
set -eu
|
||||
if [ "$EVENTO" = workflow_dispatch ]; then
|
||||
# il tag finisce in un indirizzo di download: solo vX.Y.Z (o vX.Y.Z-suffisso)
|
||||
printf '%s' "$TAG_MANUALE" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.]+)?$' \
|
||||
|| { echo "tag non valido: $TAG_MANUALE (atteso vX.Y.Z)" >&2; exit 1; }
|
||||
echo "tag=$TAG_MANUALE" >> "$GITHUB_OUTPUT"
|
||||
exit 0
|
||||
fi
|
||||
@@ -64,10 +79,10 @@ jobs:
|
||||
exit 0
|
||||
fi
|
||||
apt-get update -qq && apt-get install -y -qq --no-install-recommends ca-certificates curl jq >/dev/null
|
||||
# «edited» anche per le modifiche successive: si procede solo se i file sono appena stati
|
||||
# caricati, cioè se è la pubblicazione fatta da release.yml o da release-upload.sh
|
||||
# modifica anziché prima pubblicazione: si procede solo se lo zip è appena stato
|
||||
# caricato, cioè se è la pubblicazione fatta da release.yml o da release-upload.sh
|
||||
if [ "$AZIONE" != published ]; then
|
||||
ULTIMO_FILE="$(jq -r '[.release.assets[].created_at] | max // empty' "$GITHUB_EVENT_PATH")"
|
||||
ULTIMO_FILE="$(jq -r '[(.release.assets // [])[].created_at] | max // empty' "$GITHUB_EVENT_PATH")"
|
||||
if [ -z "$ULTIMO_FILE" ] || [ $(( $(date +%s) - $(date -d "$ULTIMO_FILE" +%s) )) -gt 3600 ]; then
|
||||
echo "$TAG_RELEASE: modifica di una release già pubblicata, nessun deploy (per ripubblicarla usare l'avvio manuale)."
|
||||
exit 0
|
||||
@@ -91,29 +106,28 @@ jobs:
|
||||
deploy:
|
||||
needs: controllo
|
||||
if: needs.controllo.outputs.tag != ''
|
||||
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
container:
|
||||
image: debian:stable-slim
|
||||
environment: produzione
|
||||
steps:
|
||||
- name: Strumenti
|
||||
run: apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip
|
||||
# aggiungere: rsync openssh-client (variante A) · lftp (variante B) · rclone (variante C)
|
||||
|
||||
- name: Scarica il pacchetto della release
|
||||
- name: Scarica e controlla lo zip della release
|
||||
env:
|
||||
TAG: ${{ needs.controllo.outputs.tag }}
|
||||
TOKEN: ${{ secrets.GITHUB_TOKEN }} # il token automatico basta per scaricare
|
||||
TOKEN: ${{ secrets.GITHUB_TOKEN }} # token automatico del workflow
|
||||
run: |
|
||||
set -eu
|
||||
VERSION="${TAG#v}"
|
||||
BASE="${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}"
|
||||
curl -fsSL -H "Authorization: token ${TOKEN}" -o pacchetto.zip "${BASE}/sito-studio-grasso-v${VERSION}.zip"
|
||||
curl -fsSL -H "Authorization: token ${TOKEN}" -o SHA256SUMS.txt "${BASE}/SHA256SUMS.txt"
|
||||
curl -fsSL -H "Authorization: token ${TOKEN}" -o BUILD-INFO.txt "${BASE}/BUILD-INFO.txt"
|
||||
grep " sito-studio-grasso-v${VERSION}.zip$" SHA256SUMS.txt | sed "s/sito-studio-grasso-v${VERSION}.zip/pacchetto.zip/" | sha256sum -c -
|
||||
grep ' BUILD-INFO.txt$' SHA256SUMS.txt | sha256sum -c -
|
||||
curl -fsSL -H "Authorization: token ${TOKEN}" -o pacchetto.zip \
|
||||
"${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}/sito-studio-grasso-v${VERSION}.zip"
|
||||
unzip -tq pacchetto.zip # integrità: si ferma se lo zip è danneggiato o incompleto
|
||||
mkdir sito && unzip -q pacchetto.zip -d sito
|
||||
for f in index.html .htaccess; do
|
||||
[ -f "sito/$f" ] || { echo "manca $f nel pacchetto: non è lo zip del sito" >&2; exit 1; }
|
||||
done
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Variante A — rsync su SSH (VPS o hosting con accesso SSH)
|
||||
@@ -185,10 +199,14 @@ jobs:
|
||||
SITE_URL: ${{ vars.SITE_URL }}
|
||||
run: |
|
||||
set -eu
|
||||
# dominio per cui è stato costruito il pacchetto (BUILD-INFO.txt, scritto da
|
||||
# scripts/package.mjs), se la variabile del repository SITE_URL non è impostata
|
||||
SITE_URL="${SITE_URL:-$(sed -n 's/^SITE_URL: //p' BUILD-INFO.txt)}"
|
||||
: "${SITE_URL:?dominio del sito non trovato in BUILD-INFO.txt}"
|
||||
# dominio per cui è stato costruito il pacchetto: la riga «Sitemap:» del robots.txt
|
||||
# (scritto in build da src/pages/robots.txt.ts), se la variabile del repository SITE_URL
|
||||
# non è impostata
|
||||
if [ -z "$SITE_URL" ]; then
|
||||
SITE_URL="$(tr -d '\r' < sito/robots.txt | sed -n 's|^Sitemap: \(.*\)/sitemap-index\.xml$|\1|p' | head -n 1)"
|
||||
fi
|
||||
SITE_URL="${SITE_URL%/}"
|
||||
: "${SITE_URL:?dominio del sito non trovato (riga Sitemap: di robots.txt nel pacchetto)}"
|
||||
for p in / /servizi/ /contatti/ /sitemap-index.xml /robots.txt; do
|
||||
code=$(curl -s -o /dev/null -w '%{http_code}' "${SITE_URL}${p}")
|
||||
echo "${p} → ${code}"; [ "$code" = 200 ]
|
||||
+108
-68
@@ -1,6 +1,6 @@
|
||||
# PROMPT PER CLAUDE CODE — Nuovo sito web «Studio Grasso» (Studio Tributario e Societario)
|
||||
|
||||
Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformità legale, test, CI/CD Forgejo, packaging release.
|
||||
Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformità legale, test, CI/CD su Gitea, packaging release.
|
||||
|
||||
> **Per chi legge (Claude Code):** questo documento è l'unica fonte dei requisiti e contiene tutto ciò che serve per costruire il sito da zero: contenuti già estratti dal sito attuale (§4), specifiche di design con mockup (§6–7, Appendici A–C), vincoli legali (§8), suite di test (§11), pipeline CI e packaging (§12). Non sono previste domande di chiarimento: dove un'informazione manca, applica le regole di §0 e registra la scelta in `DECISIONS.md`.
|
||||
|
||||
@@ -23,7 +23,7 @@ Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformit
|
||||
|
||||
- **Cliente.** Studio Grasso — Studio Tributario e Societario. Sede principale a Montegrosso d'Asti (AT), sede secondaria ad Asti (ricevimento su appuntamento). Due professionisti: **Dott. Ezio Grasso** (tributarista qualificato I.N.T. ai sensi della L. 4/2013, difensore tributario abilitato MEF, CTU e perito del Tribunale di Asti, responsabile Centro Autorizzato CAF) e **Dott.ssa Giulia Grasso** (Dottore Commercialista, ODCEC di Asti). Clientela: imprese, professionisti, privati, dipendenti e pensionati.
|
||||
- **Sito attuale.** `http://www.grassoezio.it/` (realizzato nel 2016). Problemi da non ripetere: solo HTTP; cookie banner con "consenso implicito" (non conforme alle Linee guida del Garante del 10/6/2021); `meta viewport` con `user-scalable=no` (viola l'accessibilità); Google Analytics e Google Maps caricati senza consenso; informativa privacy generica che cita servizi non usati (AdSense, YouTube, LiveChat, Hotjar, social plugin); terminologia normativa in parte superata (vedi §4.9). **I contenuti sono già stati estratti e riportati in §4: non devi fare scraping del vecchio sito e non devi copiarne immagini, loghi o codice.**
|
||||
- **Risultato atteso.** Un repository Git locale, pronto per essere pubblicato su un'istanza Forgejo, contenente: sito statico completo (tutte le pagine di §5), suite di test (§11), workflow CI (verifica a ogni push/PR) e workflow Release (a ogni tag `vX.Y.Z` pubblica nella sezione *Release* di Forgejo un `.zip` e un `.tar.gz` del sito pronti per qualsiasi hosting, con checksum), documentazione per deploy e per l'aggiornamento dei contenuti da parte dello studio.
|
||||
- **Risultato atteso.** Un repository Git locale, pronto per essere pubblicato su Gitea (istanza `https://gitea.encke-hake.ts.net`, repository `BalboSoft/Studio_Grasso`), contenente: sito statico completo (tutte le pagine di §5), suite di test (§11), workflow CI (Gitea Actions: verifica a ogni push su `main`, a ogni pull request e a mano) e workflow Release (a ogni tag `vX.Y.Z` verifica tutto e pubblica nella sezione *Release* di Gitea **un solo file allegato**, `sito-studio-grasso-vX.Y.Z.zip`: il sito pronto da estrarre nella cartella pubblica di qualsiasi hosting), documentazione per deploy e per l'aggiornamento dei contenuti da parte dello studio.
|
||||
- **Hosting di destinazione.** Non ancora definito (scenario più probabile: hosting condiviso italiano Apache/LiteSpeed con PHP; possibile anche nginx o object storage). Il pacchetto deve quindi essere **universale**: solo file statici, con `.htaccess` incluso e configurazione nginx di esempio fuori dal pacchetto.
|
||||
- **Stile.** Semplice ma moderno: sobrio, ordinato, molto leggibile, "istituzionale senza essere datato". Fiducia e chiarezza, niente effetti speciali.
|
||||
|
||||
@@ -59,8 +59,8 @@ Versione 1.0 · 14 ottobre 2026 · Brief completo: contenuti, design, conformit
|
||||
| SEO | `@astrojs/sitemap`, `robots.txt`, meta/OG/canonical centralizzati in `BaseLayout.astro`, JSON-LD (§9.2) | |
|
||||
| Test | Playwright (`@playwright/test`) + `@axe-core/playwright`, `html-validate`, `linkinator`, `@lhci/cli`, script Node custom per conformità e pacchetto (§11) | |
|
||||
| Qualità codice | ESLint (config Astro + TS), Prettier (`prettier-plugin-astro`), Stylelint (facoltativo), EditorConfig | `npm run lint` e `npm run format:check` fanno parte di `verify`. |
|
||||
| Packaging | `scripts/package.mjs` con `archiver` (zip + tar.gz deterministici) e `SHA256SUMS.txt` | §12.3 |
|
||||
| CI | Forgejo Actions (`.forgejo/workflows/*.yml`) | §12 |
|
||||
| Packaging | `scripts/package.mjs` con `archiver` (un solo zip deterministico) | §12.4 |
|
||||
| CI | Gitea Actions (`.gitea/workflows/*.yml`), runner `act_runner` con label `ubuntu-latest` | §12 |
|
||||
|
||||
### 3.2 Struttura del repository (obbligatoria)
|
||||
|
||||
@@ -69,12 +69,12 @@ sito-studio-grasso/
|
||||
├── .editorconfig .nvmrc .gitignore .prettierrc eslint.config.js
|
||||
├── astro.config.mjs tsconfig.json package.json package-lock.json
|
||||
├── playwright.config.ts lighthouserc.cjs .htmlvalidate.json
|
||||
├── README.md # panoramica, comandi, come pubblicare su Forgejo, come rilasciare
|
||||
├── README.md # panoramica, comandi, come pubblicare su Gitea, come rilasciare
|
||||
├── CHANGELOG.md # Keep a Changelog, versione 1.0.0 iniziale
|
||||
├── DECISIONS.md # log decisioni (§0.4)
|
||||
├── TODO-STUDIO.md # dati/azioni richiesti allo studio (§0.5)
|
||||
├── docs/
|
||||
│ ├── DEPLOY.md # come usare il pacchetto release su cPanel/Plesk/FTP/nginx; deploy automatico futuro
|
||||
│ ├── DEPLOY.md # come usare lo zip della release su cPanel/Plesk/FTP/nginx; deploy automatico futuro
|
||||
│ ├── CONTENUTI.md # guida non tecnica per aggiornare testi, servizi, orari, link utili
|
||||
│ ├── CONFORMITA.md # checklist legale (§8) con stato e riferimenti ai file
|
||||
│ └── mockups/ # copia dei PNG dei mockup, se forniti insieme a questo brief (facoltativo)
|
||||
@@ -93,20 +93,20 @@ sito-studio-grasso/
|
||||
│ ├── assets/ (logo.svg, logo-mark.svg, illustrazioni SVG originali)
|
||||
│ └── scripts/ (menu.ts, map-consent.ts, form.ts, legacy-anchors.ts) — piccoli, senza dipendenze
|
||||
├── scripts/
|
||||
│ ├── package.mjs # crea release/*.zip, *.tar.gz, SHA256SUMS.txt, BUILD-INFO.txt
|
||||
│ ├── package.mjs # crea release/sito-studio-grasso-vX.Y.Z.zip (unico file)
|
||||
│ ├── check-compliance.mjs # test di conformità sul dist (§11.5)
|
||||
│ ├── check-package.mjs # test di integrità del pacchetto (§11.7)
|
||||
│ ├── generate-icons.mjs # favicon/apple-touch/og da logo.svg (sharp)
|
||||
│ ├── changelog-notes.mjs # estrae dal CHANGELOG la sezione della versione (note di rilascio)
|
||||
│ └── release-upload.sh # fallback: upload asset release via API Forgejo (curl)
|
||||
│ └── release-upload.sh # pubblica la release e carica lo zip via API REST di Gitea (curl)
|
||||
├── tests/
|
||||
│ ├── e2e/*.spec.ts # smoke, navigazione, menu mobile, form, no-third-party, no-cookies
|
||||
│ └── a11y/*.spec.ts # axe su tutte le pagine + tastiera
|
||||
├── deploy/
|
||||
│ ├── nginx.conf.example
|
||||
│ ├── optional-php-form/contact.php # handler form (modalità "php", §10.1)
|
||||
│ └── forgejo-deploy.yml.example # workflow deploy futuro (rsync/FTPS), disattivato
|
||||
└── .forgejo/workflows/ci.yml release.yml
|
||||
│ └── gitea-deploy.yml.example # workflow deploy futuro (rsync/FTPS), disattivato
|
||||
└── .gitea/workflows/ci.yml release.yml
|
||||
```
|
||||
|
||||
### 3.3 Script npm (nomi obbligatori)
|
||||
@@ -118,7 +118,7 @@ test (= html+links+e2e+a11y+compliance) · verify (= lint + format:check + check
|
||||
package (= build + scripts/package.mjs + test:package) · icons (= scripts/generate-icons.mjs)
|
||||
```
|
||||
|
||||
`npm run verify` è il comando che la CI esegue; deve terminare con exit code 0 in locale prima di considerare chiusa la fase 6.
|
||||
`npm run verify` è il comando di riferimento: la CI ne ripete i passi uno per uno (§12.2) e il workflow di release lo esegue per intero (§12.3); deve terminare con exit code 0 in locale prima di considerare chiusa la fase 6.
|
||||
|
||||
---
|
||||
|
||||
@@ -582,7 +582,7 @@ Pagina volontaria (lo studio non rientra nei soggetti obbligati dalla L. 4/2004
|
||||
|
||||
---
|
||||
|
||||
## 11. Test e quality gate (tutti eseguiti da `npm run verify`)
|
||||
## 11. Test e quality gate (eseguiti da `npm run verify`; il controllo del pacchetto, 11.7, da `npm run package`)
|
||||
|
||||
| # | Suite | Strumento | Cosa verifica (criterio di superamento) |
|
||||
|---|---|---|---|
|
||||
@@ -592,21 +592,24 @@ Pagina volontaria (lo studio non rientra nei soggetti obbligati dalla L. 4/2004
|
||||
| 11.4 | **E2E e privacy** | Playwright (`tests/e2e`) su `astro preview` | Ogni pagina → 200, un solo `h1`, `title` e `description` unici, `lang="it"`, canonical corretto; navigazione header/footer funzionante; 404 branded; **nessuna richiesta di rete verso host ≠ `localhost`** su tutte le pagine; **`context.cookies()` vuoto** dopo navigazione; `localStorage` vuoto; mappa: nessun iframe prima del click, iframe Google dopo il click; form (se attivo): validazione, honeypot, pagina grazie; anchor legacy → redirect alla pagina servizio; nessun errore in console. |
|
||||
| 11.5 | **Conformità** | `scripts/check-compliance.mjs` su `dist/` | In **ogni** pagina: stringa `P.IVA 01597790052` nel footer; link a `/privacy-policy/`, `/cookie-policy/`, `/note-legali/`; pagine legali esistenti e con `h1`; nessun `http://` in `src`/`href` di risorse; nessun riferimento a `fonts.googleapis.com`, `gstatic`, `analytics`, `gtag`, `cdn.`; nessun `<iframe>` statico; nessun `user-scalable=no`; nessun placeholder (`TODO`, `lorem`, `XXX`, `[da`); tutte le `<img>` con `alt`; JSON-LD valido con i campi di §9.2; sitemap che elenca tutte le pagine (e nessuna in più, tranne `grazie` se `noindex`); `robots.txt` con `Sitemap:`; `.htaccess` e `404.html` presenti; i 9 badge e i 6 servizi presenti (confronto con `studio.ts`/collection); le parole «commercialist*» compaiono solo nelle frasi che riguardano la Dott.ssa Giulia Grasso, l'ODCEC o l'OCC (controllo per frase con whitelist; fallimento = errore); il riferimento alla L. 4/2013 compare nella scheda del Dott. Ezio Grasso e nelle Note legali. |
|
||||
| 11.6 | **Lighthouse** | `@lhci/cli` (`lighthouserc.cjs`, preset mobile, 3 run, mediana) su home, `/servizi/`, un servizio, `/contatti/` | Soglie §9.3 come `assert` con `minScore` sulle 4 categorie (`categories:performance`, ecc.), preset `lighthouse:recommended` con le regole rumorose declassate a `warn`; Chrome = eseguibile di Playwright (`chromePath` ottenuto con `require('playwright').chromium.executablePath()`), così funziona anche nel container CI. |
|
||||
| 11.7 | **Pacchetto** | `scripts/check-package.mjs` dopo `scripts/package.mjs` | Lo zip e il tar.gz contengono alla radice `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, `favicon.svg`, tutte le pagine; estrazione in cartella temporanea e confronto 1:1 con `dist/` (nessun file mancante/extra, dimensioni uguali); `SHA256SUMS.txt` verificato con `sha256sum -c`; nome file = `sito-studio-grasso-v<versione>.<ext>`; dimensione zip ≤ 5 MB; `BUILD-INFO.txt` contiene versione, commit, data. |
|
||||
| 11.8 | **Link** | `linkinator` ricorsivo su `astro preview` | Zero link interni rotti (incluse immagini e asset). Link esterni: verificati in un job separato **non bloccante** della CI (`continue-on-error: true`) perché dipendono dalla rete del runner; in locale eseguire `npm run test:links -- --external` prima del rilascio. |
|
||||
| 11.7 | **Pacchetto** | `scripts/check-package.mjs` dopo `scripts/package.mjs` (eseguito da `npm run package`; la CI lo esegue come ultimo passo) | `release/` contiene solo lo zip, con nome `sito-studio-grasso-v<versione>.zip`; lo zip, letto con CRC e dimensioni, contiene alla radice `index.html`, `404.html`, `.htaccess`, `robots.txt`, `sitemap-index.xml`, `favicon.svg`, tutte le pagine; confronto 1:1 con `dist/` (nessun file mancante/extra, contenuto identico, nessuna cartella di primo livello); dimensione zip ≤ 5 MB. |
|
||||
| 11.8 | **Link** | `linkinator` ricorsivo su `astro preview` | Zero link interni rotti (incluse immagini e asset). Link esterni: verificati in un job separato della CI, con `continue-on-error: true` sullo step (non sul job), così non è bloccante: dipendono dalla rete del runner. In locale eseguire `npm run test:links -- --external` prima del rilascio. |
|
||||
|
||||
Regole: i test leggono l'elenco pagine da `sitemap` (nessuna lista hardcoded da tenere allineata); ogni test ha messaggi di errore in italiano che dicono *cosa* e *dove*; Playwright produce report HTML in `playwright-report/` (gitignored, caricato come artifact in CI quando fallisce).
|
||||
Regole: i test leggono l'elenco pagine da `sitemap` (nessuna lista hardcoded da tenere allineata); ogni test ha messaggi di errore in italiano che dicono *cosa* e *dove*; Playwright produce report HTML in `playwright-report/` (gitignored, caricato come artifact in CI quando fallisce); il report Lighthouse (`.lighthouseci/`) è sempre allegato all'esecuzione della CI.
|
||||
|
||||
---
|
||||
|
||||
## 12. CI/CD su Forgejo e packaging della release
|
||||
## 12. CI/CD su Gitea e packaging della release
|
||||
|
||||
### 12.1 Convenzioni
|
||||
- Branch `main` protetto (consiglio nel README). Commit con Conventional Commits in italiano (`feat: …`, `fix: …`, `docs: …`, `ci: …`, `test: …`).
|
||||
- Versioni SemVer; tag `vX.Y.Z` (es. `v1.0.0`); `package.json.version` allineata; `CHANGELOG.md` aggiornato ad ogni versione (la sezione della versione diventa le note di rilascio).
|
||||
- Le action vengono referenziate con URL completo su `code.forgejo.org` così da non dipendere dalla configurazione `DEFAULT_ACTIONS_URL` dell'istanza. `runs-on` usa il label `docker` (il più comune per `forgejo-runner`): **in cima ai workflow inserisci un commento che spiega come cambiarlo** (es. `ubuntu-latest`) e come impostare il segreto facoltativo `FORGEJO_TOKEN`.
|
||||
- Piattaforma: Gitea, istanza `https://gitea.encke-hake.ts.net`, repository `BalboSoft/Studio_Grasso` (https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso). I workflow sono in `.gitea/workflows/` e girano con Gitea Actions su un runner `act_runner`.
|
||||
- `runs-on` usa il label `ubuntu-latest`, quello predefinito di `act_runner`: **in cima ai workflow inserisci un commento che spiega come cambiarlo** se il runner è registrato con un altro label.
|
||||
- Le action di terze parti vengono referenziate con URL completo su `github.com` (es. `https://github.com/actions/checkout@v4`), così da non dipendere dall'impostazione `DEFAULT_ACTIONS_URL` dell'istanza. Per gli artifact si usa `actions/upload-artifact@v3`: la v4 non funziona su Gitea. L'immagine Playwright del container (`mcr.microsoft.com/playwright:v1.56.1-noble`) ha la stessa versione di `@playwright/test`.
|
||||
- Segreti e variabili (Impostazioni del repository → Actions): segreto **facoltativo** `RELEASE_TOKEN` (token personale con permesso `write:repository`, usato al posto del token automatico del workflow per pubblicare la release; vedi §12.3) e variabile `SITE_URL` con il dominio del sito, che sostituisce il valore predefinito di `site.config.mjs` in build e test. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Il commento in cima ai workflow spiega anche questo.
|
||||
|
||||
### 12.2 `.forgejo/workflows/ci.yml` — verifica a ogni push/PR (riferimento, adatta le versioni)
|
||||
### 12.2 `.gitea/workflows/ci.yml` — verifica a ogni push su `main`, a ogni PR e a mano (riassunto del workflow reale, adatta le versioni)
|
||||
|
||||
```yaml
|
||||
name: CI
|
||||
@@ -614,102 +617,139 @@ on:
|
||||
push:
|
||||
branches: [main]
|
||||
pull_request:
|
||||
workflow_dispatch:
|
||||
env:
|
||||
ASTRO_TELEMETRY_DISABLED: '1'
|
||||
CI: 'true'
|
||||
SITE_URL: ${{ vars.SITE_URL }} # variabile del repository (facoltativa)
|
||||
jobs:
|
||||
verify:
|
||||
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
container:
|
||||
image: mcr.microsoft.com/playwright:v1.56.0-noble # DEVE coincidere con la versione di @playwright/test in package.json
|
||||
image: mcr.microsoft.com/playwright:v1.56.1-noble # DEVE coincidere con la versione di @playwright/test in package.json
|
||||
timeout-minutes: 90
|
||||
steps:
|
||||
- uses: https://code.forgejo.org/actions/checkout@v4
|
||||
- uses: https://code.forgejo.org/actions/setup-node@v4
|
||||
- uses: https://github.com/actions/checkout@v4
|
||||
- uses: https://github.com/actions/setup-node@v4
|
||||
with:
|
||||
node-version: 22
|
||||
cache: npm
|
||||
node-version-file: .nvmrc
|
||||
- run: npm ci
|
||||
- run: npm run verify
|
||||
# i passi di `npm run verify`, uno per uno e nello stesso ordine
|
||||
- run: npm run lint
|
||||
- run: npm run format:check
|
||||
- run: npm run check
|
||||
- run: npm run build
|
||||
- run: npm run test:html
|
||||
- run: npm run test:links
|
||||
- run: npm run test:e2e
|
||||
- run: npm run test:a11y
|
||||
- run: npm run test:compliance
|
||||
- run: npm run test:lighthouse
|
||||
- run: node scripts/package.mjs && npm run test:package # crea lo zip di rilascio e ne verifica il contenuto
|
||||
- name: Report Playwright (solo in caso di errore)
|
||||
if: failure()
|
||||
uses: https://code.forgejo.org/actions/upload-artifact@v3 # usare @v4 se l'istanza Forgejo lo supporta
|
||||
continue-on-error: true
|
||||
uses: https://github.com/actions/upload-artifact@v3 # la v4 non funziona su Gitea
|
||||
with:
|
||||
name: playwright-report
|
||||
path: playwright-report
|
||||
- name: Artifact dist
|
||||
uses: https://code.forgejo.org/actions/upload-artifact@v3
|
||||
- name: Report Lighthouse
|
||||
if: always()
|
||||
continue-on-error: true
|
||||
uses: https://github.com/actions/upload-artifact@v3
|
||||
with:
|
||||
name: dist
|
||||
path: dist
|
||||
name: lighthouse
|
||||
path: .lighthouseci
|
||||
include-hidden-files: true # cartella nascosta: senza, l'action non carica nulla
|
||||
external-links:
|
||||
runs-on: docker
|
||||
runs-on: ubuntu-latest
|
||||
container:
|
||||
image: node:22
|
||||
continue-on-error: true
|
||||
image: node:24
|
||||
timeout-minutes: 45
|
||||
steps:
|
||||
- uses: https://code.forgejo.org/actions/checkout@v4
|
||||
- uses: https://github.com/actions/checkout@v4
|
||||
- run: npm ci
|
||||
env:
|
||||
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
|
||||
- run: npm run build
|
||||
- run: npm run test:links -- --external
|
||||
continue-on-error: true # non bloccante: dipende dalla rete del runner e dai siti esterni
|
||||
```
|
||||
|
||||
### 12.3 `.forgejo/workflows/release.yml` — pubblicazione in Release a ogni tag
|
||||
- Il job `verify` ripete passo per passo `npm run verify`: nella pagina dell'esecuzione si vede subito quale controllo è fallito. In coda costruisce anche lo zip di rilascio e ne verifica il contenuto (`scripts/package.mjs` + `scripts/check-package.mjs`), così un errore di pacchetto emerge in CI e non al momento del tag. Modificando gli script `verify`/`test` di `package.json`, aggiornare anche questi passi.
|
||||
- Gli upload degli artifact hanno `continue-on-error`: un problema dello storage non deve rendere rossa una verifica andata a buon fine.
|
||||
|
||||
### 12.3 `.gitea/workflows/release.yml` — pubblicazione in Release a ogni tag (riassunto del workflow reale)
|
||||
|
||||
```yaml
|
||||
name: Release
|
||||
on:
|
||||
push:
|
||||
tags: ['v*.*.*']
|
||||
env:
|
||||
ASTRO_TELEMETRY_DISABLED: '1'
|
||||
CI: 'true'
|
||||
SITE_URL: ${{ vars.SITE_URL }} # variabile del repository (facoltativa)
|
||||
jobs:
|
||||
release:
|
||||
runs-on: docker
|
||||
runs-on: ubuntu-latest # label del runner: adattare se diverso
|
||||
container:
|
||||
image: mcr.microsoft.com/playwright:v1.56.0-noble
|
||||
image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test
|
||||
timeout-minutes: 90
|
||||
steps:
|
||||
- uses: https://code.forgejo.org/actions/checkout@v4
|
||||
- uses: https://github.com/actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 0
|
||||
- uses: https://github.com/actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc
|
||||
- run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV" # data riproducibile = data del commit
|
||||
- run: npm ci
|
||||
- run: npm run verify # nessuna release senza test verdi
|
||||
- run: npm run package # crea release/ (zip, tar.gz, SHA256SUMS.txt, BUILD-INFO.txt) e li verifica
|
||||
- name: Controlli preliminari (tag, versione, CHANGELOG)
|
||||
env:
|
||||
RELEASE_VERSION: ${{ github.ref_name }}
|
||||
- name: Note di rilascio dal CHANGELOG
|
||||
id: notes
|
||||
run: |
|
||||
{
|
||||
echo 'notes<<NOTES_EOF'
|
||||
node scripts/changelog-notes.mjs "${{ github.ref_name }}"
|
||||
echo 'NOTES_EOF'
|
||||
} >> "$GITHUB_OUTPUT"
|
||||
- name: Pubblica la release su Forgejo
|
||||
uses: https://code.forgejo.org/actions/forgejo-release@v2 # input: direction, url, repo, tag, token, release-dir, release-notes, prerelease, override, verbose
|
||||
node -e '…' # il tag deve coincidere con "version" di package.json
|
||||
node scripts/changelog-notes.mjs "$RELEASE_VERSION" > /dev/null # deve esistere la sezione del CHANGELOG
|
||||
- run: npm run verify # nessuna release senza test verdi
|
||||
- run: npm run package # crea release/ con il solo zip e ne verifica il contenuto
|
||||
env:
|
||||
RELEASE_VERSION: ${{ github.ref_name }}
|
||||
- name: Pubblica la release con lo zip
|
||||
env:
|
||||
GITEA_URL: ${{ github.server_url }}
|
||||
GITEA_REPO: ${{ github.repository }}
|
||||
GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
|
||||
run: bash scripts/release-upload.sh "${{ github.ref_name }}" release
|
||||
- name: Report Playwright (solo in caso di errore)
|
||||
if: failure()
|
||||
continue-on-error: true
|
||||
uses: https://github.com/actions/upload-artifact@v3
|
||||
with:
|
||||
direction: upload
|
||||
url: ${{ github.server_url }}
|
||||
repo: ${{ github.repository }}
|
||||
tag: ${{ github.ref_name }}
|
||||
token: ${{ secrets.FORGEJO_TOKEN || secrets.GITHUB_TOKEN }}
|
||||
release-dir: release # contiene SOLO zip, tar.gz, SHA256SUMS.txt, BUILD-INFO.txt
|
||||
release-notes: ${{ steps.notes.outputs.notes }}
|
||||
verbose: true
|
||||
name: playwright-report
|
||||
path: playwright-report
|
||||
```
|
||||
|
||||
- Fallback: `scripts/release-upload.sh` crea la release e carica gli asset via API REST (`POST /api/v1/repos/{owner}/{repo}/releases` e `POST …/releases/{id}/assets?name=…`) usando `FORGEJO_URL`, `FORGEJO_REPO`, `FORGEJO_TOKEN`; documentato in DEPLOY.md per l'uso manuale o come step alternativo.
|
||||
- `README.md` deve spiegare: il token automatico può non avere il permesso di creare release su alcune istanze → creare un *access token* con scope `write:repository` e salvarlo come segreto `FORGEJO_TOKEN` nel repository.
|
||||
- Come rilasciare: aggiornare `version` in `package.json` e la sezione `## [X.Y.Z]` di `CHANGELOG.md`, committare su `main`, poi `git tag vX.Y.Z && git push origin vX.Y.Z`. Il workflow si ferma se il tag non coincide con la versione di `package.json` o se manca la sezione del CHANGELOG, che diventa il testo della release.
|
||||
- Pubblicazione: `scripts/release-upload.sh` (solo `curl` e `node`) usa l'API REST di Gitea (`POST /api/v1/repos/{owner}/{repo}/releases`, poi `POST …/releases/{id}/assets?name=…`) con le variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`, senza action esterne di release. Controlla che il tag sia già sul server e punti allo stesso commit del tag locale, crea la release in bozza, carica lo zip e solo allora la pubblica; se la release esiste già sostituisce il file con lo stesso nome. Le note sono la sezione del `CHANGELOG.md` estratta da `scripts/changelog-notes.mjs`. Lo stesso script si usa anche a mano (documentato in DEPLOY.md).
|
||||
- Token: per impostazione predefinita la release è pubblicata con il token automatico del workflow. `README.md` deve spiegare che, se la release non viene creata (errore 403 o 404 nello step di pubblicazione), occorre creare un *access token* personale con permesso `write:repository` e salvarlo come segreto del repository `RELEASE_TOKEN` (se esiste, viene usato al posto del token automatico). Non usare nomi che iniziano con `GITEA_` o `GITHUB_`.
|
||||
- Contenuto della release: **un solo file allegato**, `sito-studio-grasso-vX.Y.Z.zip`. Gitea aggiunge da solo a ogni release due archivi, «Source code (ZIP)» e «Source code (TAR.GZ)»: contengono il codice sorgente, **non** il sito. Per mettere il sito online va scaricato lo zip `sito-studio-grasso-vX.Y.Z.zip` dall'elenco delle release (https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases).
|
||||
|
||||
### 12.4 Pacchetto di rilascio (`scripts/package.mjs`)
|
||||
- Input: `dist/` (dopo `npm run build`), versione da `RELEASE_VERSION` (tag) oppure `package.json`.
|
||||
- Output in `release/`: `sito-studio-grasso-v<versione>.zip` (formato primario: tutti i pannelli hosting — cPanel, Plesk, Aruba, Register, SiteGround, ecc. — estraggono zip), `sito-studio-grasso-v<versione>.tar.gz` (server Linux/SSH, nginx, object storage), `SHA256SUMS.txt`, `BUILD-INFO.txt` (versione, commit, data ISO, Node, Astro).
|
||||
- Layout degli archivi: **contenuto di `dist/` alla radice** (nessuna cartella di primo livello), `.htaccess` incluso; voci ordinate e mtime fisso (archivi riproducibili).
|
||||
- Output in `release/`: **un solo file**, `sito-studio-grasso-v<versione>.zip` (tutti i pannelli hosting — cPanel, Plesk, Aruba, Register, SiteGround, ecc. — estraggono zip). È l'unico file della cartella, e quindi l'unico allegato della release.
|
||||
- Layout dello zip: **contenuto di `dist/` alla radice** (nessuna cartella di primo livello), `.htaccess` incluso; voci ordinate e date fisse (`SOURCE_DATE_EPOCH`, altrimenti la data dell'ultimo commit): a parità di `dist/` lo zip è identico, anche tra sistemi operativi diversi.
|
||||
- Esclusioni: `*.map`, file di sistema.
|
||||
- `docs/DEPLOY.md`: procedura per cPanel/Plesk (upload zip → estrai in `public_html`/`httpdocs` → verifica `.htaccess`), FTP/SFTP (estrazione locale + upload binario), nginx (config in `deploy/nginx.conf.example`: `try_files`, `error_page 404`, header di sicurezza, cache), oggetti statici (S3-compatible). Checklist post-deploy: HTTPS attivo, redirect `/privacy`, 404, `sitemap-index.xml` raggiungibile, test Lighthouse su produzione.
|
||||
- `docs/DEPLOY.md`: procedura per cPanel/Plesk (scarica `sito-studio-grasso-vX.Y.Z.zip` dalla pagina della release, non gli archivi «Source code» → upload zip → estrai in `public_html`/`httpdocs` → verifica `.htaccess`), FTP/SFTP (estrazione locale + upload binario), nginx (config in `deploy/nginx.conf.example`: `try_files`, `error_page 404`, header di sicurezza, cache), oggetti statici (S3-compatible). Checklist post-deploy: HTTPS attivo, redirect `/privacy`, 404, `sitemap-index.xml` raggiungibile, test Lighthouse su produzione.
|
||||
|
||||
### 12.5 Deploy automatico futuro (destinazione da definire)
|
||||
- `deploy/forgejo-deploy.yml.example`: job `deploy` che si attiva dopo `release` (o su `workflow_dispatch`), scarica l'asset della release o usa `dist/` e pubblica con **una** delle varianti commentate: `rsync` su SSH (segreti `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY`), `lftp` FTPS (`FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH`), `rclone` per object storage. Il file non va attivato (resta `.example`), DEPLOY.md spiega come abilitarlo.
|
||||
- `deploy/gitea-deploy.yml.example`: job `deploy` che si avvia alla pubblicazione di una release (o a mano con `workflow_dispatch`, indicando il tag), scarica dalla release lo zip `sito-studio-grasso-vX.Y.Z.zip` già verificato e pubblica con **una** delle varianti commentate: `rsync` su SSH (segreti `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_SSH_KEY`), `lftp` FTPS (`FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH`), `rclone` per object storage. Il file non è attivo (resta `.example`): per attivarlo si copia in `.gitea/workflows/deploy.yml`; DEPLOY.md spiega come.
|
||||
|
||||
---
|
||||
|
||||
## 13. Documentazione da produrre
|
||||
|
||||
- `README.md`: cos'è, requisiti, comandi (`dev`, `build`, `verify`, `package`), struttura, come pubblicare su Forgejo (`git remote add origin …`, push `main`, push del tag), come fare una release (bump versione + CHANGELOG + tag), configurazioni (`SITE_URL`, `contactForm.mode`), link a docs/.
|
||||
- `README.md`: cos'è, requisiti, comandi (`dev`, `build`, `verify`, `package`), struttura, come pubblicare su Gitea (`git remote add origin …`, push `main`, push del tag), come fare una release (bump versione + CHANGELOG + tag), segreto facoltativo `RELEASE_TOKEN` e quale file scaricare dalla release (lo zip `sito-studio-grasso-vX.Y.Z.zip`, non gli archivi «Source code»), configurazioni (`SITE_URL`, anche come variabile del repository per CI e release; `contactForm.mode`), link a docs/.
|
||||
- `docs/CONTENUTI.md`: guida **non tecnica** (per lo studio) per modificare orari, recapiti, testi dei servizi, link utili, pagine legali; dove si trovano i file; come chiedere la pubblicazione (commit → tag → release).
|
||||
- `docs/DEPLOY.md` (§12.4–12.5), `docs/CONFORMITA.md` (§8.7), `DECISIONS.md` (§0.4), `TODO-STUDIO.md` (§0.5), `CHANGELOG.md`, `public/images/README.md` (immagini che lo studio può fornire: foto della sede e dei professionisti con dimensioni consigliate, loghi degli enti solo se autorizzati).
|
||||
|
||||
@@ -724,23 +764,23 @@ jobs:
|
||||
4. **Conformità** — pagine legali (§8.3–8.6), `.htaccess` (§9.4, §5.3), `robots.txt`, sitemap, `docs/CONFORMITA.md`, aggiornamento `TODO-STUDIO.md`. Commit.
|
||||
5. **SEO, performance, accessibilità** — meta per pagina, JSON-LD completo, ottimizzazione immagini/asset, `prefers-reduced-motion`, `print.css`, controllo contrasto. Commit.
|
||||
6. **Test** — suite §11 completa; `npm run verify` verde in locale (installa i browser Playwright con `npx playwright install --with-deps chromium` se mancano). Commit.
|
||||
7. **CI/CD e packaging** — workflow §12.2–12.3, `package.mjs`, `check-package.mjs`, `changelog-notes.mjs`, `release-upload.sh`, `deploy/*`; esegui `npm run package` in locale e verifica il contenuto dello zip (`unzip -l`). Commit.
|
||||
7. **CI/CD e packaging** — workflow in `.gitea/workflows/` (§12.2–12.3), `package.mjs`, `check-package.mjs`, `changelog-notes.mjs`, `release-upload.sh`, `deploy/*`; esegui `npm run package` in locale e verifica il contenuto dello zip (`unzip -l`). Commit.
|
||||
8. **Documentazione e QA finale** — docs §13; rilettura di tutte le pagine nel browser headless (screenshot desktop e mobile di ogni pagina in `docs/screenshots/`, gitignorabili se > 2 MB totali); controllo ortografico dei testi italiani; `npm run verify` finale. Commit `chore(release): prepara v1.0.0` (senza tag).
|
||||
9. **Report finale** (unico momento in cui ti fermi) — stampa in chat: elenco pagine generate; risultato di ogni suite di test con numeri (pagine testate, violazioni, punteggi Lighthouse, dimensione zip); contenuto di `TODO-STUDIO.md` (bloccanti in evidenza); decisioni principali; comandi esatti per pubblicare su Forgejo e creare la prima release (`git remote add origin <url>`, `git push -u origin main`, `git tag v1.0.0`, `git push origin v1.0.0`) e il promemoria sul segreto `FORGEJO_TOKEN`.
|
||||
9. **Report finale** (unico momento in cui ti fermi) — stampa in chat: elenco pagine generate; risultato di ogni suite di test con numeri (pagine testate, violazioni, punteggi Lighthouse, dimensione zip); contenuto di `TODO-STUDIO.md` (bloccanti in evidenza); decisioni principali; comandi esatti per pubblicare su Gitea e creare la prima release (`git remote add origin https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso.git`, `git push -u origin main`, `git tag v1.0.0`, `git push origin v1.0.0`), il promemoria sul segreto facoltativo `RELEASE_TOKEN` (§12.3) e sulla variabile `SITE_URL`, e l'indicazione di quale file scaricare dalla release per mettere il sito online: `sito-studio-grasso-v1.0.0.zip`, non gli archivi «Source code».
|
||||
|
||||
---
|
||||
|
||||
## 15. Criteri di accettazione (Definition of Done)
|
||||
|
||||
- [ ] `npm run verify` termina con exit code 0 (lint, format, check, build, HTML, link interni, e2e, a11y, conformità, Lighthouse con soglie §9.3).
|
||||
- [ ] `npm run package` produce zip + tar.gz + SHA256SUMS + BUILD-INFO verificati da `check-package`.
|
||||
- [ ] `npm run package` produce in `release/` il solo `sito-studio-grasso-v<versione>.zip`, verificato da `check-package`.
|
||||
- [ ] Tutte le pagine di §5.1 esistono, con i contenuti di §4 integrali e gli aggiornamenti di §4.9.
|
||||
- [ ] Nessuna richiesta esterna, nessun cookie, nessun banner; mappa e Google solo su click.
|
||||
- [ ] Footer con P.IVA e link legali in ogni pagina; pagine legali complete e coerenti con l'uso reale; riferimento L. 4/2013 presente.
|
||||
- [ ] Nessuna attribuzione errata di titoli professionali (controllo automatico §11.5 + rilettura manuale in fase 8).
|
||||
- [ ] Nessun placeholder, nessun dato inventato; `TODO-STUDIO.md` elenca tutto ciò che manca con istruzioni.
|
||||
- [ ] Mobile: menu e sottomenu accessibili, layout corretto a 360–390 px; desktop corretto a 1440 px.
|
||||
- [ ] Workflow CI e Release presenti, con action referenziate via URL completo e commento sul label del runner.
|
||||
- [ ] Workflow CI e Release presenti in `.gitea/workflows/`, con action referenziate via URL completo e commento sul label del runner (`ubuntu-latest`); la release pubblica un solo allegato, lo zip del sito.
|
||||
- [ ] Documentazione §13 completa; `DECISIONS.md` aggiornato; commit atomici con Conventional Commits.
|
||||
- [ ] Nessun push, tag o deploy effettuato.
|
||||
|
||||
|
||||
+3
-3
@@ -4,7 +4,7 @@ Guida per lo Studio: dove si trovano i testi e i dati e come modificarli. Non se
|
||||
|
||||
## 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 browser (consigliato):** aprire il [repository su Gitea](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso), 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.
|
||||
|
||||
@@ -114,5 +114,5 @@ Foto e loghi autorizzati vanno consegnati a chi gestisce il sito: vedi `public/i
|
||||
## 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).
|
||||
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»). Al termine del workflow la release compare nella sezione [Release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases) del repository, con un solo file allegato: lo zip `sito-studio-grasso-vX.Y.Z.zip`, che contiene il sito da caricare. Gli archivi «Source code (ZIP)» e «Source code (TAR.GZ)» che Gitea aggiunge da solo contengono il codice sorgente, non il sito: non vanno caricati sull'hosting.
|
||||
3. Caricare lo zip `sito-studio-grasso-vX.Y.Z.zip` sull'hosting come descritto in `docs/DEPLOY.md` (o automaticamente, se è stato attivato il deploy automatico).
|
||||
+41
-30
@@ -1,34 +1,42 @@
|
||||
# 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:
|
||||
Il sito è un insieme di **file statici**: funziona su qualsiasi hosting (Apache/LiteSpeed con o senza PHP, nginx, object storage). Ogni release pubblicata su Gitea ([elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases)) contiene un solo file allegato, quello del sito:
|
||||
|
||||
| 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 |
|
||||
| File | Uso |
|
||||
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `sito-studio-grasso-vX.Y.Z.zip` | il sito pronto, per ogni tipo di hosting: pannelli (cPanel, Plesk, Aruba, Register, SiteGround…), FTP, server Linux con SSH, nginx, object storage |
|
||||
|
||||
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/`.
|
||||
> **Quale file scaricare.** Nella pagina di ogni release Gitea aggiunge da solo anche «Source code (ZIP)» e «Source code (TAR.GZ)»: contengono il **codice sorgente** del sito, non il sito pronto, e non vanno caricati sull'hosting. Scaricare sempre e solo `sito-studio-grasso-vX.Y.Z.zip`.
|
||||
|
||||
Il **contenuto del sito è alla radice dello zip** (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
|
||||
## 1. Scaricare e controllare il pacchetto
|
||||
|
||||
Dalla pagina **Release** del repository Forgejo scaricare lo zip (o il tar.gz) e `SHA256SUMS.txt` nella stessa cartella, poi:
|
||||
1. Aprire l'[elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases) del repository e, nella release che si vuole pubblicare (di norma la più recente), scaricare **`sito-studio-grasso-vX.Y.Z.zip`**. Non scaricare i due «Source code».
|
||||
2. Facoltativo, ma utile prima di caricare il sito: estrarre lo zip in una cartella vuota del proprio computer e controllare che contenga `index.html` **e** `.htaccess`. Un file scaricato a metà o danneggiato dà un errore.
|
||||
|
||||
```bash
|
||||
sha256sum -c SHA256SUMS.txt --ignore-missing # Linux
|
||||
shasum -a 256 -c SHA256SUMS.txt --ignore-missing # macOS
|
||||
```
|
||||
Su Windows (PowerShell):
|
||||
|
||||
Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorithm SHA256` e confrontare con la riga corrispondente di `SHA256SUMS.txt`.
|
||||
```powershell
|
||||
Expand-Archive .\sito-studio-grasso-vX.Y.Z.zip -DestinationPath .\sito
|
||||
Get-ChildItem .\sito -Force # devono comparire index.html e .htaccess
|
||||
```
|
||||
|
||||
Su Linux e macOS:
|
||||
|
||||
```bash
|
||||
unzip -t sito-studio-grasso-vX.Y.Z.zip # «No errors detected» se lo zip è integro
|
||||
unzip -q sito-studio-grasso-vX.Y.Z.zip -d sito
|
||||
ls -a sito # devono comparire index.html e .htaccess
|
||||
```
|
||||
|
||||
## 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.
|
||||
3. Caricare lo zip `sito-studio-grasso-vX.Y.Z.zip` (non i «Source code») 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.
|
||||
|
||||
@@ -42,30 +50,30 @@ Su Windows (PowerShell): `Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorith
|
||||
|
||||
## 3. FTP / SFTP
|
||||
|
||||
1. Estrarre lo zip **sul proprio computer** in una cartella vuota.
|
||||
1. Estrarre lo zip del sito **sul proprio computer** in una cartella vuota (sezione 1).
|
||||
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, estrarlo in una cartella temporanea e sincronizzare la cartella servita. Così vengono tolti anche i file che non fanno più parte del sito: estraendo direttamente nella cartella servita, le pagine eliminate in una nuova versione (o aggiunte in una versione più recente, quando si torna indietro) resterebbero raggiungibili.
|
||||
1. Copiare `sito-studio-grasso-vX.Y.Z.zip` sul server (ad esempio con `scp`), estrarlo con `unzip` in una cartella temporanea e sincronizzare la cartella servita. Così vengono tolti anche i file che non fanno più parte del sito: estraendo direttamente nella cartella servita, le pagine eliminate in una nuova versione (o aggiunte in una versione più recente, quando si torna indietro) resterebbero raggiungibili.
|
||||
|
||||
```bash
|
||||
sudo mkdir -p /var/www/studio-grasso
|
||||
d=$(sudo mktemp -d)
|
||||
sudo tar -xzf sito-studio-grasso-vX.Y.Z.tar.gz -C "$d"
|
||||
sudo unzip -q sito-studio-grasso-vX.Y.Z.zip -d "$d"
|
||||
sudo rsync -rlt --delete --exclude .well-known/ "$d"/ /var/www/studio-grasso/
|
||||
sudo rm -rf "$d"
|
||||
```
|
||||
|
||||
`rsync -rlt` (non `-a`) lascia invariati permessi e proprietario della cartella servita. Senza rsync: svuotare la cartella (tranne `.well-known/`) e poi estrarre l'archivio. La stessa procedura vale per gli aggiornamenti e per tornare a una versione precedente.
|
||||
`rsync -rlt` (non `-a`) lascia invariati permessi e proprietario della cartella servita. Senza rsync: svuotare la cartella (tranne `.well-known/`) e poi estrarre lo zip. Servono i programmi `unzip` e `rsync` (su Debian e Ubuntu: `sudo apt install unzip rsync`). La stessa procedura vale per gli aggiornamenti e per tornare a una versione precedente.
|
||||
|
||||
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` e, se l'esito è positivo, `sudo systemctl reload nginx`. Gli header di sicurezza stanno solo nel blocco `server` e valgono per ogni risposta: non aggiungere `add_header` dentro le `location`, perché annullerebbe tutti quelli ereditati (HSTS compreso).
|
||||
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`.
|
||||
1. Estrarre lo zip (`unzip -q sito-studio-grasso-vX.Y.Z.zip -d sito`) 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)
|
||||
@@ -113,21 +121,24 @@ La Privacy policy si aggiorna automaticamente.
|
||||
|
||||
## 8. Tornare alla versione precedente
|
||||
|
||||
Scaricare dalla pagina Release il pacchetto della versione precedente e ripetere la procedura (sezioni 2, 3, 4 o 5). Ogni release è completa e indipendente. Togliere sempre i file della versione sostituita (cartella svuotata, punto 3 dell'FTP, sincronizzazione della sezione 4, `rclone sync`): altrimenti le pagine aggiunte nella versione più recente restano raggiungibili.
|
||||
Scaricare dall'[elenco delle release](https://gitea.encke-hake.ts.net/BalboSoft/Studio_Grasso/releases) lo zip `sito-studio-grasso-vX.Y.Z.zip` della versione precedente e ripetere la procedura (sezioni 2, 3, 4 o 5). Ogni release è completa e indipendente. Togliere sempre i file della versione sostituita (cartella svuotata, punto 3 dell'FTP, sincronizzazione della sezione 4, `rclone sync`): altrimenti le pagine aggiunte nella versione più recente restano raggiungibili.
|
||||
|
||||
## 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**: quando `release.yml` pubblica una release stabile (o su avvio manuale, indicando il tag) scarica il pacchetto, ne verifica l'impronta e lo pubblica, poi controlla che le pagine principali rispondano. Le pre-release (tag con «-», es. `v1.1.0-rc.1`) non vengono pubblicate, e nemmeno una release che non sia l'ultima. Modificare in seguito titolo o note di una release, anche dell'ultima, non avvia il deploy: parte solo la pubblicazione fatta dal workflow di release o da `scripts/release-upload.sh`. L'avvio manuale serve anche per tornare a una versione precedente: in quel caso segnare come pre-release la versione ritirata, così resta «ultima» quella online.
|
||||
[`deploy/gitea-deploy.yml.example`](../deploy/gitea-deploy.yml.example) è un workflow pronto ma **non attivo**: quando `release.yml` pubblica una release stabile (o su avvio manuale, indicando il tag) scarica lo zip `sito-studio-grasso-vX.Y.Z.zip` della release, ne controlla l'integrità (`unzip -t`) e la presenza di `index.html` e `.htaccess`, lo pubblica, poi controlla che le pagine principali rispondano. Le pre-release (tag con «-», es. `v1.1.0-rc.1`) non vengono pubblicate, e nemmeno una release che non sia l'ultima. Modificare in seguito titolo o note di una release, anche dell'ultima, non avvia il deploy: parte solo la pubblicazione fatta dal workflow di release o da `scripts/release-upload.sh`. L'avvio manuale serve anche per tornare a una versione precedente: in quel caso segnare come pre-release la versione ritirata, così resta «ultima» quella online.
|
||||
|
||||
1. Copiarlo in `.forgejo/workflows/deploy.yml`.
|
||||
Per le release Gitea supporta gli eventi `published` (release non in bozza creata) ed `edited` (release modificata); una bozza non genera alcun evento. Il workflow di release crea la release in bozza, carica lo zip e solo allora la pubblica: Gitea notifica questo passaggio come modifica, non come `published`. Per questo il deploy ascolta entrambi gli eventi e il suo primo job («controllo») decide se procedere.
|
||||
|
||||
1. Copiarlo in `.gitea/workflows/deploy.yml` e committarlo su `main`. Per gli eventi di release Gitea legge il workflow dal commit del tag: il file deve quindi essere già nel commit su cui è messo il tag. Per una release uscita prima di aggiungerlo, usare l'avvio manuale.
|
||||
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). `DEPLOY_PATH` è la cartella pubblica del sito. Prima del primo deploy creare sul server il file di conferma `.deploy-studio-grasso` in quella cartella (es. `touch /var/www/studio-grasso/.deploy-studio-grasso`): senza, lo step si ferma, così un percorso sbagliato (la home, `/var/www`…) non viene mai sincronizzato con `--delete`. Lo step si ferma anche se il segreto manca o vale `/`, `~`, `.`, `/home` o `/root`;
|
||||
- **B — FTPS con lftp:** `FTP_HOST`, `FTP_USER`, `FTP_PASSWORD`, `FTP_PATH` (es. `/public_html`). `FTP_PATH` è la cartella pubblica del sito, **mai** la radice dell'account quando questa è la home (cPanel): la sincronizzazione cancellerebbe posta, configurazioni e altri siti;
|
||||
- **C — rclone (object storage):** `RCLONE_CONFIG` (contenuto di `rclone.conf`), `RCLONE_DEST`.
|
||||
3. **Avvio automatico:** le modifiche fatte con il token automatico dei workflow non avviano altri workflow. Perché il deploy parta da solo, `release.yml` deve pubblicare la release con un token personale: segreto `RELEASE_TOKEN` (vedi README, «Fare una release»). Non usare nomi che iniziano con `FORGEJO_`, `GITEA_` o `GITHUB_`: Forgejo li riserva, e `secrets.FORGEJO_TOKEN` è sempre il token automatico. Senza il segreto il deploy si avvia a mano dalla scheda **Actions** (indicando il tag).
|
||||
4. Facoltativo: variabile del repository `SITE_URL`, usata dalla build di CI e release (dominio del sito). Il controllo finale del deploy usa la stessa variabile oppure, se non è impostata, il dominio scritto in `BUILD-INFO.txt` del pacchetto (cioè quello di `site.config.mjs` al momento della build).
|
||||
3. **Avvio automatico:** Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro workflow (per evitare cicli). Perché il deploy parta da solo, `release.yml` deve quindi pubblicare la release con un token personale: segreto `RELEASE_TOKEN`, un _access token_ con permesso `write:repository` (vedi README, «Fare una release»). I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Senza il segreto il deploy si avvia a mano dalla scheda **Actions** del repository (workflow «Deploy», indicando il tag).
|
||||
4. Facoltativo: variabile del repository `SITE_URL` (Impostazioni → Actions → Variabili), usata dalla build di CI e release (dominio del sito). Il controllo finale del deploy usa la stessa variabile oppure, se non è impostata, il dominio della riga `Sitemap:` del `robots.txt` contenuto nello zip (cioè quello di `site.config.mjs` al momento della build).
|
||||
5. Le varianti A e B sincronizzano la cartella con `--delete` ma **non toccano** `.well-known/`, `.user.ini` e `cgi-bin/`, gestiti dall'hosting. Se l'hosting ne usa altri, aggiungere le esclusioni.
|
||||
6. Aggiungere al passo «Strumenti» i programmi della variante scelta (`rsync openssh-client`, `lftp` o `rclone`).
|
||||
6. Aggiungere al passo «Strumenti» i programmi della variante scelta (`rsync openssh-client`, `lftp` o `rclone`; `unzip` c'è già).
|
||||
7. I job usano il label `ubuntu-latest`, il predefinito di `act_runner`, come `ci.yml` e `release.yml`: sostituirlo se il runner ne usa un altro.
|
||||
|
||||
## 10. Pubblicare la release a mano (senza workflow)
|
||||
|
||||
@@ -135,8 +146,8 @@ Se le Actions non sono disponibili (su Windows eseguire i comandi in Git Bash):
|
||||
|
||||
```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
|
||||
GITEA_URL=https://gitea.encke-hake.ts.net GITEA_REPO=BalboSoft/Studio_Grasso \
|
||||
GITEA_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 si ferma se manca o se punta a un commit diverso dal tag locale. Come l'action del workflow, crea la release in bozza, carica i quattro file di `release/` e solo alla fine la pubblica con titolo e note del CHANGELOG. Se la release esiste già (anche come bozza lasciata da un tentativo non riuscito), sostituisce i file con lo stesso nome, caricando il nuovo prima di cancellare il vecchio, e la pubblica con le note aggiornate.
|
||||
`GITEA_TOKEN` è un _access token_ personale con permesso `write:repository` (Impostazioni utente → Applicazioni). Il tag deve già esistere sul server (`git push origin vX.Y.Z`): lo script (solo `curl` e `node`, usa l'API REST di Gitea) si ferma se manca o se punta a un commit diverso dal tag locale. Come il workflow, crea la release in bozza, carica lo zip di `release/` e solo alla fine la pubblica con titolo e note del CHANGELOG. Se la release esiste già (anche come bozza lasciata da un tentativo non riuscito), sostituisce il file con lo stesso nome, caricando il nuovo prima di cancellare il vecchio, e la pubblica con le note aggiornate.
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "sito-studio-grasso",
|
||||
"version": "1.0.0",
|
||||
"version": "1.0.1",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "sito-studio-grasso",
|
||||
"version": "1.0.0",
|
||||
"version": "1.0.1",
|
||||
"license": "UNLICENSED",
|
||||
"dependencies": {
|
||||
"@astrojs/sitemap": "3.7.4",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "sito-studio-grasso",
|
||||
"version": "1.0.0",
|
||||
"version": "1.0.1",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"description": "Sito web statico dello Studio Grasso — Studio Tributario e Societario (Montegrosso d'Asti e Asti)",
|
||||
|
||||
@@ -1,21 +1,13 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Stampa la sezione di CHANGELOG.md relativa a una versione: diventa il testo della release.
|
||||
* Uso: `node scripts/changelog-notes.mjs v1.0.0 [--shell-safe]` (oppure 1.0.0). Esce con
|
||||
* Uso: `node scripts/changelog-notes.mjs v1.0.0` (oppure 1.0.0). Esce con
|
||||
* codice 1 se la sezione non esiste, così non si pubblica una release senza note.
|
||||
*
|
||||
* `--shell-safe` (usato da release.yml): niente caratteri che una shell interpreterebbe se
|
||||
* l'action li inserisse tra virgolette doppie: `codice` → «codice», " → ”, \ → /, $ → $.
|
||||
*/
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { resolve } from 'node:path';
|
||||
|
||||
const args = process.argv.slice(2);
|
||||
const shellSafe = args.includes('--shell-safe');
|
||||
const arg = (args.find((a) => !a.startsWith('--')) ?? process.env.RELEASE_VERSION ?? '').replace(
|
||||
/^refs\/tags\//,
|
||||
'',
|
||||
);
|
||||
const arg = (process.argv[2] ?? process.env.RELEASE_VERSION ?? '').replace(/^refs\/tags\//, '');
|
||||
const version = arg.replace(/^v/, '');
|
||||
if (!/^\d+\.\d+\.\d+/.test(version)) {
|
||||
console.error('Uso: node scripts/changelog-notes.mjs vX.Y.Z');
|
||||
@@ -44,11 +36,4 @@ if (!body) {
|
||||
console.error(`La sezione ${version} di CHANGELOG.md è vuota.`);
|
||||
process.exit(1);
|
||||
}
|
||||
const safe = (text) =>
|
||||
text
|
||||
.replace(/`([^`\n]*)`/g, '«$1»')
|
||||
.replace(/`/g, '')
|
||||
.replace(/"/g, '”')
|
||||
.replace(/\\/g, '/')
|
||||
.replace(/\$/g, '$');
|
||||
process.stdout.write(`${shellSafe ? safe(body) : body}\n`);
|
||||
process.stdout.write(`${body}\n`);
|
||||
+16
-96
@@ -1,17 +1,15 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Integrità del pacchetto di rilascio (brief §11.7), da eseguire dopo scripts/package.mjs:
|
||||
* Integrità del pacchetto di rilascio, da eseguire dopo scripts/package.mjs:
|
||||
*
|
||||
* - in release/ ci sono solo zip, tar.gz, SHA256SUMS.txt e BUILD-INFO.txt, con i nomi attesi;
|
||||
* - le impronte di SHA256SUMS.txt sono corrette (anche con `sha256sum -c`, se disponibile);
|
||||
* - zip e tar.gz, estratti in una cartella temporanea, contengono esattamente i file di dist/
|
||||
* (stessi percorsi, dimensioni e contenuto), alla radice, con .htaccess e tutte le pagine;
|
||||
* - lo zip non supera 5 MB; BUILD-INFO.txt riporta versione, commit e data.
|
||||
* - in release/ c'è solo lo zip, con il nome atteso (nessun altro file);
|
||||
* - lo zip, aperto con un lettore minimale (CRC e dimensioni compresi), contiene esattamente
|
||||
* i file di dist/ (stessi percorsi, dimensioni e contenuto), alla radice, con .htaccess e
|
||||
* tutte le pagine del sitemap;
|
||||
* - lo zip non supera 5 MB.
|
||||
*/
|
||||
import { execFileSync, spawnSync } from 'node:child_process';
|
||||
import { createHash } from 'node:crypto';
|
||||
import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync } from 'node:fs';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { crc32, inflateRawSync } from 'node:zlib';
|
||||
import { readSitemapPaths } from './lib/pages.mjs';
|
||||
@@ -63,32 +61,6 @@ function readZip(file) {
|
||||
return entries;
|
||||
}
|
||||
|
||||
/**
|
||||
* Estrazione del tar.gz con `tar` di sistema in una cartella temporanea. L'archivio arriva da
|
||||
* stdin: su Windows il GNU tar di Git Bash interpreta «C:\…» come host remoto.
|
||||
*/
|
||||
function readTarGz(file) {
|
||||
const dir = mkdtempSync(join(tmpdir(), 'sito-studio-grasso-'));
|
||||
try {
|
||||
execFileSync('tar', ['-xzf', '-'], { cwd: dir, input: readFileSync(file) });
|
||||
const entries = new Map();
|
||||
for (const rel of listAll(dir)) entries.set(rel, readFileSync(join(dir, rel)));
|
||||
return entries;
|
||||
} finally {
|
||||
rmSync(dir, { recursive: true, force: true });
|
||||
}
|
||||
}
|
||||
|
||||
function listAll(dir, base = '') {
|
||||
const out = [];
|
||||
for (const e of readdirSync(join(dir, base), { withFileTypes: true })) {
|
||||
const rel = base ? `${base}/${e.name}` : e.name;
|
||||
if (e.isDirectory()) out.push(...listAll(dir, rel));
|
||||
else out.push(rel);
|
||||
}
|
||||
return out.sort();
|
||||
}
|
||||
|
||||
function compareWithDist(label, entries, expected) {
|
||||
const names = [...entries.keys()].sort();
|
||||
const missing = expected.filter((f) => !entries.has(f));
|
||||
@@ -130,80 +102,28 @@ try {
|
||||
console.error(`✘ ${e.message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
const names = archiveNames(version);
|
||||
const expectedRelease = [names.zip, names.tgz, 'SHA256SUMS.txt', 'BUILD-INFO.txt'].sort();
|
||||
const { zip } = archiveNames(version);
|
||||
|
||||
if (!existsSync(releaseDir)) {
|
||||
console.error('✘ release/ assente: eseguire `npm run package`.');
|
||||
process.exit(1);
|
||||
}
|
||||
const present = readdirSync(releaseDir).sort();
|
||||
for (const f of expectedRelease) if (!present.includes(f)) fail(`release/: manca ${f}`);
|
||||
const present = readdirSync(releaseDir);
|
||||
if (!present.includes(zip)) fail(`release/: manca ${zip}`);
|
||||
for (const f of present)
|
||||
if (!expectedRelease.includes(f))
|
||||
fail(`release/: file inatteso ${f} (la cartella deve contenere solo il pacchetto)`);
|
||||
if (f !== zip) fail(`release/: file inatteso ${f} (la cartella deve contenere solo lo zip)`);
|
||||
|
||||
// impronte
|
||||
const sumsFile = join(releaseDir, 'SHA256SUMS.txt');
|
||||
if (existsSync(sumsFile)) {
|
||||
const lines = readFileSync(sumsFile, 'utf8').trim().split('\n');
|
||||
const listed = new Set();
|
||||
for (const line of lines) {
|
||||
const m = line.match(/^([0-9a-f]{64}) {2}(.+)$/);
|
||||
if (!m) {
|
||||
fail(`SHA256SUMS.txt: riga non valida «${line}»`);
|
||||
continue;
|
||||
}
|
||||
listed.add(m[2]);
|
||||
const target = join(releaseDir, m[2]);
|
||||
if (!existsSync(target)) fail(`SHA256SUMS.txt: il file ${m[2]} non esiste`);
|
||||
else if (sha256(readFileSync(target)) !== m[1])
|
||||
fail(`SHA256SUMS.txt: impronta errata per ${m[2]}`);
|
||||
}
|
||||
for (const f of [names.zip, names.tgz]) if (!listed.has(f)) fail(`SHA256SUMS.txt: manca ${f}`);
|
||||
const tool = spawnSync('sha256sum', ['-c', 'SHA256SUMS.txt'], {
|
||||
cwd: releaseDir,
|
||||
encoding: 'utf8',
|
||||
});
|
||||
if (tool.error)
|
||||
console.log(' (sha256sum non disponibile: impronte verificate solo con Node.js)');
|
||||
else if (tool.status !== 0) fail(`sha256sum -c non superato:\n${tool.stdout}${tool.stderr}`);
|
||||
else console.log(` sha256sum -c: ${tool.stdout.trim().split('\n').join(' · ')}`);
|
||||
}
|
||||
|
||||
// contenuto degli archivi
|
||||
const expected = listFiles(distDir);
|
||||
const zipPath = join(releaseDir, names.zip);
|
||||
const tgzPath = join(releaseDir, names.tgz);
|
||||
const zipPath = join(releaseDir, zip);
|
||||
if (existsSync(zipPath)) {
|
||||
const size = statSync(zipPath).size;
|
||||
if (size > MAX_ZIP)
|
||||
fail(`${names.zip}: ${(size / 1048576).toFixed(2)} MB oltre il limite di 5 MB`);
|
||||
if (size > MAX_ZIP) fail(`${zip}: ${(size / 1048576).toFixed(2)} MB oltre il limite di 5 MB`);
|
||||
try {
|
||||
compareWithDist(names.zip, readZip(zipPath), expected);
|
||||
compareWithDist(zip, readZip(zipPath), expected);
|
||||
} catch (e) {
|
||||
fail(`${names.zip}: ${e.message}`);
|
||||
fail(`${zip}: ${e.message}`);
|
||||
}
|
||||
}
|
||||
if (existsSync(tgzPath)) {
|
||||
try {
|
||||
compareWithDist(names.tgz, readTarGz(tgzPath), expected);
|
||||
} catch (e) {
|
||||
fail(`${names.tgz}: ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
// BUILD-INFO
|
||||
const infoFile = join(releaseDir, 'BUILD-INFO.txt');
|
||||
if (existsSync(infoFile)) {
|
||||
const info = readFileSync(infoFile, 'utf8');
|
||||
if (!info.includes(`Versione: ${version}`)) fail('BUILD-INFO.txt: manca «Versione»');
|
||||
if (!/^Commit: [0-9a-f]{7,40}$/m.test(info)) fail('BUILD-INFO.txt: manca l’hash del commit');
|
||||
if (!/^Data: \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/m.test(info))
|
||||
fail('BUILD-INFO.txt: manca la data ISO');
|
||||
if (!/^Node\.js: v\d+/m.test(info) || !/^Astro: \d+/m.test(info))
|
||||
fail('BUILD-INFO.txt: mancano le versioni di Node.js e Astro');
|
||||
}
|
||||
|
||||
if (errors.length) {
|
||||
console.error(`✘ Pacchetto v${version}: ${errors.length} errori`);
|
||||
@@ -212,5 +132,5 @@ if (errors.length) {
|
||||
}
|
||||
const zipKb = (statSync(zipPath).size / 1024).toFixed(1);
|
||||
console.log(
|
||||
`✔ Pacchetto v${version} verificato: ${expected.length} file identici a dist/ in zip (${zipKb} KB) e tar.gz, impronte corrette.`,
|
||||
`✔ Pacchetto v${version} verificato: ${expected.length} file identici a dist/ nello zip (${zipKb} KB), unico file di release/.`,
|
||||
);
|
||||
@@ -33,7 +33,6 @@ export function resolveVersion() {
|
||||
|
||||
export const archiveNames = (version) => ({
|
||||
zip: `${ARCHIVE_PREFIX}-v${version}.zip`,
|
||||
tgz: `${ARCHIVE_PREFIX}-v${version}.tar.gz`,
|
||||
});
|
||||
|
||||
/** Elenco ordinato dei file di una cartella (percorsi relativi con «/»), esclusioni applicate. */
|
||||
|
||||
+25
-84
@@ -1,25 +1,21 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Pacchetto di rilascio (brief §12.4). Da `dist/` crea in `release/`:
|
||||
* Pacchetto di rilascio. Da `dist/` crea in `release/` un solo file:
|
||||
*
|
||||
* sito-studio-grasso-v<versione>.zip per i pannelli di hosting (cPanel, Plesk, …)
|
||||
* sito-studio-grasso-v<versione>.tar.gz per server Linux/SSH, nginx, object storage
|
||||
* SHA256SUMS.txt impronte SHA-256 (verificabili con `sha256sum -c`)
|
||||
* BUILD-INFO.txt versione, commit, data, Node, Astro
|
||||
* sito-studio-grasso-v<versione>.zip da estrarre nella cartella pubblica dell'hosting
|
||||
*
|
||||
* Il contenuto di dist/ è alla radice degli archivi (nessuna cartella di primo livello), con
|
||||
* `.htaccess`. Voci ordinate, date fisse e header gzip senza il sistema operativo: a parità di
|
||||
* dist/ (e di versione di Node.js) gli archivi sono identici anche tra Windows, macOS e Linux.
|
||||
* Il contenuto di dist/ è alla radice dello zip (nessuna cartella di primo livello), con
|
||||
* `.htaccess`. Voci ordinate e date fisse: a parità di dist/ lo zip è identico anche tra
|
||||
* Windows, macOS e Linux.
|
||||
* Versione: variabile RELEASE_VERSION (tag vX.Y.Z) oppure package.json.
|
||||
*/
|
||||
process.env.TZ = 'UTC';
|
||||
|
||||
import { createHash } from 'node:crypto';
|
||||
import { createReadStream, createWriteStream, existsSync, readFileSync, statSync } from 'node:fs';
|
||||
import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
|
||||
import { join, resolve } from 'node:path';
|
||||
import { createWriteStream, existsSync, readFileSync, statSync } from 'node:fs';
|
||||
import { mkdir, rm } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { pipeline } from 'node:stream/promises';
|
||||
import { TarArchive, ZipArchive } from 'archiver';
|
||||
import { ZipArchive } from 'archiver';
|
||||
import { siteUrl } from '../site.config.mjs';
|
||||
import {
|
||||
archiveEpoch,
|
||||
@@ -29,7 +25,6 @@ import {
|
||||
listFiles,
|
||||
releaseDir,
|
||||
resolveVersion,
|
||||
root,
|
||||
} from './lib/release.mjs';
|
||||
|
||||
if (!existsSync(join(distDir, 'index.html'))) {
|
||||
@@ -44,82 +39,28 @@ try {
|
||||
console.error(`✘ ${e.message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
const names = archiveNames(version);
|
||||
const { zip } = archiveNames(version);
|
||||
const files = listFiles(distDir);
|
||||
const date = new Date(archiveEpoch() * 1000);
|
||||
|
||||
await rm(releaseDir, { recursive: true, force: true });
|
||||
await mkdir(releaseDir, { recursive: true });
|
||||
|
||||
async function build(archive, target) {
|
||||
const output = createWriteStream(target);
|
||||
const done = pipeline(archive, output);
|
||||
archive.on('warning', (err) => {
|
||||
throw err;
|
||||
});
|
||||
for (const rel of files) {
|
||||
// contenuto letto in memoria: l'ordine delle voci resta quello dell'elenco ordinato
|
||||
archive.append(readFileSync(join(distDir, rel)), { name: rel, date, mode: 0o644 });
|
||||
}
|
||||
await archive.finalize();
|
||||
await done;
|
||||
const target = join(releaseDir, zip);
|
||||
const archive = new ZipArchive({ zlib: { level: 9 } });
|
||||
const output = createWriteStream(target);
|
||||
const done = pipeline(archive, output);
|
||||
archive.on('warning', (err) => {
|
||||
throw err;
|
||||
});
|
||||
for (const rel of files) {
|
||||
// contenuto letto in memoria: l'ordine delle voci resta quello dell'elenco ordinato
|
||||
archive.append(readFileSync(join(distDir, rel)), { name: rel, date, mode: 0o644 });
|
||||
}
|
||||
await archive.finalize();
|
||||
await done;
|
||||
|
||||
/**
|
||||
* Il byte 9 dell'header gzip indica il sistema operativo (zlib scrive 10 su Windows, 19 su
|
||||
* macOS, 3 altrove): lo si fissa a 3 (Unix) così il tar.gz non dipende dalla piattaforma.
|
||||
* Il byte non è coperto da alcun CRC (flag FHCRC assente; il CRC finale riguarda i dati).
|
||||
*/
|
||||
async function normalizeGzipOs(file) {
|
||||
const buf = await readFile(file);
|
||||
const isGzip = buf[0] === 0x1f && buf[1] === 0x8b && buf[2] === 8;
|
||||
if (!isGzip || (buf[3] & 0x02) !== 0) throw new Error(`${file}: header gzip inatteso`);
|
||||
if (buf[9] !== 3) {
|
||||
buf[9] = 3;
|
||||
await writeFile(file, buf);
|
||||
}
|
||||
}
|
||||
|
||||
await build(new ZipArchive({ zlib: { level: 9 } }), join(releaseDir, names.zip));
|
||||
await build(new TarArchive({ gzip: true, gzipOptions: { level: 9 } }), join(releaseDir, names.tgz));
|
||||
await normalizeGzipOs(join(releaseDir, names.tgz));
|
||||
|
||||
const sha256 = (file) =>
|
||||
new Promise((ok, ko) => {
|
||||
const hash = createHash('sha256');
|
||||
createReadStream(file)
|
||||
.on('data', (d) => hash.update(d))
|
||||
.on('end', () => ok(hash.digest('hex')))
|
||||
.on('error', ko);
|
||||
});
|
||||
|
||||
const pkgLock = JSON.parse(readFileSync(resolve(root, 'package-lock.json'), 'utf8'));
|
||||
const astroVersion = pkgLock.packages?.['node_modules/astro']?.version ?? 'sconosciuta';
|
||||
const info = [
|
||||
'Sito web dello Studio Grasso — Studio Tributario e Societario',
|
||||
`Versione: ${version}`,
|
||||
`Commit: ${gitCommit()}`,
|
||||
`Data: ${new Date().toISOString()}`,
|
||||
`Data dei file negli archivi: ${date.toISOString()}`,
|
||||
`Node.js: ${process.version}`,
|
||||
`Astro: ${astroVersion}`,
|
||||
`SITE_URL: ${siteUrl()}`,
|
||||
`File: ${files.length}`,
|
||||
'',
|
||||
'Pubblicazione: estrarre il contenuto dell’archivio nella cartella pubblica del sito',
|
||||
'(es. public_html o httpdocs), includendo il file nascosto .htaccess. Vedi docs/DEPLOY.md.',
|
||||
'',
|
||||
].join('\n');
|
||||
await writeFile(join(releaseDir, 'BUILD-INFO.txt'), info);
|
||||
|
||||
const sums = [];
|
||||
for (const name of [names.zip, names.tgz, 'BUILD-INFO.txt']) {
|
||||
sums.push(`${await sha256(join(releaseDir, name))} ${name}`);
|
||||
}
|
||||
await writeFile(join(releaseDir, 'SHA256SUMS.txt'), sums.join('\n') + '\n');
|
||||
|
||||
const kb = (f) => `${(statSync(join(releaseDir, f)).size / 1024).toFixed(1)} KB`;
|
||||
const kb = (statSync(target).size / 1024).toFixed(1);
|
||||
console.log(`✔ Pacchetto v${version} creato in release/ (${files.length} file da dist/):`);
|
||||
for (const f of [names.zip, names.tgz, 'SHA256SUMS.txt', 'BUILD-INFO.txt']) {
|
||||
console.log(` ${f.padEnd(40)} ${kb(f)}`);
|
||||
}
|
||||
console.log(` ${zip} ${kb} KB`);
|
||||
console.log(` commit ${gitCommit().slice(0, 12)} · dominio ${siteUrl()}`);
|
||||
+39
-24
@@ -1,22 +1,22 @@
|
||||
#!/usr/bin/env bash
|
||||
# =============================================================================
|
||||
# Pubblica una release su Forgejo tramite API REST e carica i file di release/.
|
||||
# Alternativa manuale (o step di riserva) all'action forgejo-release del workflow.
|
||||
# Pubblica una release su Gitea tramite API REST e carica i file di release/ (lo zip del sito).
|
||||
# Lo usa release.yml; si può eseguire anche a mano.
|
||||
#
|
||||
# Uso:
|
||||
# FORGEJO_URL=https://forgejo.example.it \
|
||||
# FORGEJO_REPO=proprietario/repository \
|
||||
# FORGEJO_TOKEN=<token con permesso write:repository> \
|
||||
# GITEA_URL=https://gitea.encke-hake.ts.net \
|
||||
# GITEA_REPO=proprietario/repository \
|
||||
# GITEA_TOKEN=<token con permesso write:repository> \
|
||||
# scripts/release-upload.sh v1.0.0 [cartella] # cartella predefinita: release
|
||||
#
|
||||
# Prima eseguire `npm run package` con RELEASE_VERSION=v1.0.0 e pubblicare il tag
|
||||
# (git push origin v1.0.0): lo script si ferma se il tag non è sul server oppure se punta a
|
||||
# un commit diverso dal tag locale. Le note della release sono prese da CHANGELOG.md.
|
||||
#
|
||||
# Come l'action, una release nuova viene creata in bozza, riceve i file e solo alla fine viene
|
||||
# pubblicata. Se la release esiste già (anche come bozza lasciata dall'action), i file con lo
|
||||
# stesso nome vengono sostituiti (prima si carica il nuovo, poi si cancella il vecchio) e la
|
||||
# release viene pubblicata con titolo e note del CHANGELOG.
|
||||
# Una release nuova viene creata in bozza, riceve i file e solo alla fine viene pubblicata.
|
||||
# Se la release esiste già (anche come bozza rimasta a metà), i file con lo stesso nome
|
||||
# vengono sostituiti (prima si carica il nuovo, poi si cancella il vecchio) e la release viene
|
||||
# pubblicata con titolo e note del CHANGELOG.
|
||||
# =============================================================================
|
||||
set -euo pipefail
|
||||
|
||||
@@ -26,15 +26,22 @@ DIR="${2:-release}"
|
||||
die() { echo "✘ $*" >&2; exit 1; }
|
||||
|
||||
[ -n "$TAG" ] || die "indicare il tag, es.: scripts/release-upload.sh v1.0.0"
|
||||
[ -n "${FORGEJO_URL:-}" ] || die "variabile FORGEJO_URL mancante (es. https://forgejo.example.it)"
|
||||
[ -n "${FORGEJO_REPO:-}" ] || die "variabile FORGEJO_REPO mancante (es. proprietario/repository)"
|
||||
[ -n "${FORGEJO_TOKEN:-}" ] || die "variabile FORGEJO_TOKEN mancante"
|
||||
[ -n "${GITEA_URL:-}" ] || die "variabile GITEA_URL mancante (es. https://gitea.encke-hake.ts.net)"
|
||||
[ -n "${GITEA_REPO:-}" ] || die "variabile GITEA_REPO mancante (es. proprietario/repository)"
|
||||
[ -n "${GITEA_TOKEN:-}" ] || die "variabile GITEA_TOKEN mancante"
|
||||
[ -d "$DIR" ] || die "cartella $DIR assente: eseguire prima npm run package"
|
||||
command -v curl >/dev/null || die "curl non installato"
|
||||
command -v node >/dev/null || die "node non installato"
|
||||
|
||||
API="${FORGEJO_URL%/}/api/v1/repos/${FORGEJO_REPO}"
|
||||
AUTH="Authorization: token ${FORGEJO_TOKEN}"
|
||||
# nessun file da caricare = pacchetto non creato: meglio fermarsi che pubblicare una release vuota
|
||||
FILES=()
|
||||
for FILE in "$DIR"/*; do
|
||||
[ -f "$FILE" ] && FILES+=("$FILE")
|
||||
done
|
||||
[ "${#FILES[@]}" -gt 0 ] || die "nessun file in $DIR: eseguire prima npm run package"
|
||||
|
||||
API="${GITEA_URL%/}/api/v1/repos/${GITEA_REPO}"
|
||||
AUTH="Authorization: token ${GITEA_TOKEN}"
|
||||
|
||||
# Valore di un campo (anche annidato: «commit.sha») di un oggetto JSON letto da stdin.
|
||||
json_field() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{let v=JSON.parse(s);for(const k of process.argv[1].split("."))v=v==null?undefined:v[k];if(v===undefined)process.exit(1);console.log(typeof v==="object"?JSON.stringify(v):v)})' "$1"; }
|
||||
@@ -43,7 +50,8 @@ asset_ids() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{c
|
||||
urlencode() { node -e 'console.log(encodeURIComponent(process.argv[1]))' "$1"; }
|
||||
|
||||
TAG_URL="$(urlencode "$TAG")"
|
||||
NOTES="$(node scripts/changelog-notes.mjs "$TAG")"
|
||||
NOTES="$(node "$(dirname "${BASH_SOURCE[0]}")/changelog-notes.mjs" "$TAG")" \
|
||||
|| die "note della release non disponibili: manca la sezione di $TAG in CHANGELOG.md"
|
||||
PRERELEASE=false
|
||||
case "$TAG" in *-*) PRERELEASE=true ;; esac
|
||||
# Dati della release; $1 = true per la bozza, false per pubblicarla.
|
||||
@@ -52,10 +60,10 @@ payload() {
|
||||
"$TAG" "$NOTES" "$1" "$PRERELEASE"
|
||||
}
|
||||
|
||||
echo "→ Release $TAG su $FORGEJO_REPO"
|
||||
echo "→ Release $TAG su $GITEA_REPO"
|
||||
|
||||
# 1) il tag deve essere già sul server: senza, Forgejo lo creerebbe sulla punta del branch
|
||||
# predefinito (un altro commit) e avvierebbe release.yml
|
||||
# 1) il tag deve essere già sul server: senza, Gitea lo creerebbe sulla punta del branch
|
||||
# predefinito (un altro commit)
|
||||
TAG_JSON="$(curl -fsS -H "$AUTH" "$API/tags/$TAG_URL")" \
|
||||
|| die "tag $TAG assente sul server (o token senza accesso al repository): eseguire prima git push origin $TAG"
|
||||
SERVER_SHA="$(printf '%s' "$TAG_JSON" | json_field commit.sha)" || die "risposta inattesa per il tag $TAG"
|
||||
@@ -64,27 +72,34 @@ if LOCAL_SHA="$(git rev-parse --verify --quiet "refs/tags/$TAG^{commit}" 2>/dev/
|
||||
|| die "il tag $TAG sul server punta a $SERVER_SHA, quello locale a $LOCAL_SHA: pacchetto e tag non coincidono"
|
||||
fi
|
||||
|
||||
# 2) release esistente (pubblicata o bozza) oppure nuova bozza
|
||||
if EXISTING="$(curl -fsS -H "$AUTH" "$API/releases/tags/$TAG_URL" 2>/dev/null)"; then
|
||||
# 2) release esistente (pubblicata o bozza) oppure nuova bozza: solo un 404 vuol dire «non
|
||||
# esiste ancora»; qualunque altro errore (rete, 401, 403, 5xx) ferma lo script
|
||||
EXISTING_FILE="$(mktemp)"
|
||||
trap 'rm -f "$EXISTING_FILE"' EXIT
|
||||
EXISTING_CODE="$(curl -sS -o "$EXISTING_FILE" -w '%{http_code}' -H "$AUTH" "$API/releases/tags/$TAG_URL")" \
|
||||
|| die "il server non risponde ($GITEA_URL)"
|
||||
if [ "$EXISTING_CODE" = "200" ]; then
|
||||
EXISTING="$(cat "$EXISTING_FILE")"
|
||||
RELEASE_ID="$(printf '%s' "$EXISTING" | json_field id)"
|
||||
if [ "$(printf '%s' "$EXISTING" | json_field draft)" = "true" ]; then
|
||||
echo " bozza già esistente (id $RELEASE_ID): caricamento dei file e pubblicazione"
|
||||
else
|
||||
echo " release già pubblicata (id $RELEASE_ID): sostituzione dei file con lo stesso nome"
|
||||
fi
|
||||
else
|
||||
elif [ "$EXISTING_CODE" = "404" ]; then
|
||||
CREATED="$(curl -fsS -X POST -H "$AUTH" -H 'Content-Type: application/json' -d "$(payload true)" "$API/releases")" \
|
||||
|| die "creazione della release non riuscita (il token ha il permesso write:repository?)"
|
||||
RELEASE_ID="$(printf '%s' "$CREATED" | json_field id)"
|
||||
echo " bozza creata (id $RELEASE_ID)"
|
||||
else
|
||||
die "lettura della release $TAG non riuscita (HTTP $EXISTING_CODE): controllare l'indirizzo, il token e riprovare"
|
||||
fi
|
||||
|
||||
# 3) file: prima il nuovo, poi la cancellazione dell'eventuale versione precedente, così un
|
||||
# errore a metà non lascia la release senza quel file
|
||||
ASSETS="$(curl -fsS -H "$AUTH" "$API/releases/$RELEASE_ID/assets")" \
|
||||
|| die "elenco dei file della release $RELEASE_ID non disponibile"
|
||||
for FILE in "$DIR"/*; do
|
||||
[ -f "$FILE" ] || continue
|
||||
for FILE in "${FILES[@]}"; do
|
||||
NAME="$(basename "$FILE")"
|
||||
OLD_IDS="$(printf '%s' "$ASSETS" | asset_ids "$NAME")"
|
||||
curl -fsS -X POST -H "$AUTH" -F "attachment=@${FILE}" \
|
||||
@@ -101,4 +116,4 @@ done
|
||||
curl -fsS -X PATCH -H "$AUTH" -H 'Content-Type: application/json' -d "$(payload false)" \
|
||||
"$API/releases/$RELEASE_ID" >/dev/null \
|
||||
|| die "pubblicazione non riuscita: la release $RELEASE_ID potrebbe essere rimasta in bozza"
|
||||
echo "✔ Release $TAG pubblicata: ${FORGEJO_URL%/}/${FORGEJO_REPO}/releases/tag/$TAG"
|
||||
echo "✔ Release $TAG pubblicata: ${GITEA_URL%/}/${GITEA_REPO}/releases/tag/$TAG"
|
||||
+3
-3
@@ -1,10 +1,10 @@
|
||||
/**
|
||||
* Dominio pubblico del sito: UNICA FONTE per la build (astro.config.mjs), i controlli, i test e
|
||||
* il pacchetto di rilascio (canonical, sitemap, robots.txt, dati strutturati, BUILD-INFO.txt).
|
||||
* il pacchetto di rilascio (canonical, sitemap, robots.txt, dati strutturati).
|
||||
*
|
||||
* Per un dominio diverso: cambiare qui il valore predefinito, oppure impostare la variabile
|
||||
* d'ambiente SITE_URL per tutti i comandi (build, verify, package); nei workflow Forgejo la
|
||||
* imposta la variabile del repository SITE_URL (Impostazioni → Actions → Variabili).
|
||||
* d'ambiente SITE_URL per tutti i comandi (build, verify, package); nei workflow di Gitea Actions
|
||||
* la imposta la variabile del repository SITE_URL (Impostazioni → Actions → Variabili).
|
||||
*/
|
||||
export const SITE_URL_PREDEFINITO = 'https://www.grassoezio.it';
|
||||
|
||||
|
||||
Reference in new issue
Block a user