Files
Studio_Grasso/scripts/check-links.mjs
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

84 lines
3.1 KiB
JavaScript

#!/usr/bin/env node
/**
* Controllo dei link (brief §11.8) con linkinator sul sito servito da `astro preview`.
*
* npm run test:links link interni, immagini, asset, CSS e ancore (#…): bloccante
* npm run test:links -- --external anche i link verso siti esterni (da eseguire prima di un
* rilascio; dipende dalla rete)
*
* Le pagine di partenza sono lette dalla sitemap generata (più 404 e pagina di conferma).
*/
import { resolve } from 'node:path';
import { LinkChecker, LinkState } from 'linkinator';
import { siteUrl } from '../site.config.mjs';
import { EXTRA_PAGES, readSitemapPaths } from './lib/pages.mjs';
import { root, startPreview } from './lib/preview-server.mjs';
const external = process.argv.includes('--external');
// URL assoluti del sito (canonical, og:url, og:image, JSON-LD): controllati sulla build locale,
// non sul dominio di produzione, che prima della pubblicazione ospita ancora il vecchio sito.
const SITE = siteUrl();
const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
const dist = resolve(root, 'dist');
const seeds = [...readSitemapPaths(dist), ...EXTRA_PAGES];
const server = await startPreview({ port: 4323 });
const base = server.base;
let exitCode = 0;
try {
const checker = new LinkChecker();
const result = await checker.check({
path: seeds.map((p) => base + p),
recurse: true,
concurrency: external ? 4 : 10,
timeout: external ? 20_000 : 10_000,
checkCss: true,
checkFragments: true,
retryErrors: external,
retryErrorsCount: 2,
urlRewriteExpressions: [
{ pattern: new RegExp(`^${escapeRe(SITE)}(?=/|$)`), replacement: base },
],
linksToSkip: async (link) => {
if (link.startsWith(base)) return false;
if (new RegExp(`^${escapeRe(SITE)}(?=/|$)`).test(link)) return false; // riscritto su base
if (!/^https?:\/\//.test(link)) return true; // mailto:, tel:, data:
return !external;
},
// Alcuni siti istituzionali rifiutano i controlli automatici: segnalati come avviso.
statusCodes: external
? { 401: 'warn', 403: 'warn', 405: 'warn', 429: 'warn', 999: 'warn' }
: {},
});
const checked = result.links.filter((l) => l.state !== LinkState.SKIPPED);
const broken = result.links.filter((l) => l.state === LinkState.BROKEN);
const internal = checked.filter((l) => l.url.startsWith(base));
const outside = checked.filter((l) => !l.url.startsWith(base));
const show = (u) => (u ?? '').replace(base, '');
console.log(
`Link controllati: ${internal.length} interni${external ? `, ${outside.length} esterni` : ''} ` +
`(partenza da ${seeds.length} pagine).`,
);
if (!external)
console.log('Link esterni non controllati: usa `npm run test:links -- --external`.');
if (broken.length > 0) {
exitCode = 1;
console.error(`\n✘ ${broken.length} link non funzionanti:`);
for (const l of broken) {
console.error(
` - ${show(l.url)} (stato ${l.status ?? 'nessuna risposta'}) nella pagina ${show(l.parent)}`,
);
}
} else {
console.log('✔ Nessun link non funzionante.');
}
} finally {
await server.stop();
}
process.exit(exitCode);