Files
Alby96andClaude Opus 5.5 3befe7e266 fix: CI adattata a Forgejo, revisione completa del codice e avvio in debug
Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è
mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato
anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi
del sito, dei controlli e della documentazione.

CI e rilascio:
- continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno
  irraggiungibile avrebbe reso rossa la CI;
- artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati);
- token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico;
- dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL;
- ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server;
  sostituzione dei file senza mai lasciarli mancanti;
- tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip).

Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di
focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop
senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe,
giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati.

Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail,
a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in
quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante
MODALITA_PREDEFINITA per attivarlo.

Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore,
«commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive,
HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test.

Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso),
deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata,
procedura nginx che toglie i file delle versioni precedenti.

Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il
debugger collegato.

Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e
decisioni D-045…D-055.

Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root);
job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in
Docker; release-upload.sh e deploy di esempio contro API e shell simulate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 13:40:16 +02:00

64 lines
2.2 KiB
JavaScript

#!/usr/bin/env node
/**
* Screenshot a pagina intera di tutte le pagine del sito (desktop 1440 px e mobile 390 px) in
* docs/screenshots/. Richiede `npm run build`. Uso: `node scripts/screenshots.mjs [--out dir]`.
*/
import { mkdir } from 'node:fs/promises';
import { resolve } from 'node:path';
import { chromium } from 'playwright';
import { EXTRA_PAGES, readSitemapPaths } from './lib/pages.mjs';
import { root, startPreview } from './lib/preview-server.mjs';
const outArg = process.argv.indexOf('--out');
const outDir = resolve(root, outArg > -1 ? process.argv[outArg + 1] : 'docs/screenshots');
const only = process.argv.includes('--only')
? process.argv[process.argv.indexOf('--only') + 1]
: null;
const viewports = [
{ name: 'desktop', width: 1440, height: 900, isMobile: false },
{ name: 'mobile', width: 390, height: 844, isMobile: true },
];
const slug = (path) =>
path === '/'
? 'home'
: path
.replace(/^\/|\/$/g, '')
.replace(/\.html$/, '')
.replace(/\//g, '--');
const paths = [...readSitemapPaths(resolve(root, 'dist')), ...EXTRA_PAGES].filter(
(p) => !only || p === only,
);
await mkdir(outDir, { recursive: true });
const server = await startPreview();
// browser avviato dentro il try: se non parte (Chromium mancante) il server viene comunque
// fermato, invece di restare attivo in background su Linux e macOS
let browser;
try {
browser = await chromium.launch();
for (const vp of viewports) {
const context = await browser.newContext({
viewport: { width: vp.width, height: vp.height },
deviceScaleFactor: 1,
isMobile: vp.isMobile,
hasTouch: vp.isMobile,
locale: 'it-IT',
reducedMotion: 'reduce',
});
const page = await context.newPage();
for (const path of paths) {
await page.goto(server.base + path, { waitUntil: 'networkidle' });
await page.evaluate(() => document.fonts.ready);
const file = resolve(outDir, `${slug(path)}-${vp.name}.png`);
await page.screenshot({ path: file, fullPage: true });
console.log(` ${vp.name.padEnd(7)} ${path} → ${file.replace(root + '/', '')}`);
}
await context.close();
}
} finally {
await browser?.close().catch(() => {});
await server.stop();
}