From 8ce77de13771991a8eff4bb184d7be95622fc6eb Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Oct 2026 22:36:39 +0000 Subject: [PATCH] perf: CSS incluso nelle pagine, contrasto delle chip e soglie Lighthouse MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CSS delle pagine incluso nell'HTML: nessun foglio di stile bloccante (Lighthouse mobile: Performance 0.99–1, Accessibility, Best Practices e SEO 1) - token --gold-800 per il testo delle chip (contrasto 4.98:1) - lighthouserc: soglie di §9.3 bloccanti, audit informativi declassati ad avviso - verificati titoli (≤ 65 caratteri) e descrizioni (120–155) unici, nessun overflow orizzontale a 320 px Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ --- DECISIONS.md | 24 ++++++++++++++++++++++++ astro.config.mjs | 5 +++-- lighthouserc.cjs | 10 ++++++++++ src/styles/global.css | 2 +- src/styles/tokens.css | 1 + 5 files changed, 39 insertions(+), 3 deletions(-) diff --git a/DECISIONS.md b/DECISIONS.md index a066f89..e83f384 100644 --- a/DECISIONS.md +++ b/DECISIONS.md @@ -195,3 +195,27 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · - **Scelta:** il file resta dove previsto dal brief; una piccola integrazione in `astro.config.mjs` lo rimuove da `dist/` a fine build. - **Alternative scartate:** pubblicarlo (documento interno visibile online); spostarlo in `docs/` (diverso dalla struttura obbligatoria). - **Motivazione:** struttura del brief rispettata, pacchetto di rilascio pulito. + +## D-025 — CSS incluso nelle pagine + +- **Data:** 2026-10-15 +- **Contesto:** con `assetsInlineLimit: 0` (necessario perché nessuno script venga incluso inline, CSP `script-src 'self'`) Astro produceva 4–6 fogli di stile separati per pagina, tutti bloccanti per il rendering (segnalati da Lighthouse). +- **Scelta:** `build.inlineStylesheets: 'always'`: il CSS di ogni pagina è incluso nell'HTML (consentito da `style-src 'unsafe-inline'`). La pagina più pesante (home) misura circa 95 KB di HTML + CSS non compressi, sotto il budget di 120 KB. +- **Alternative scartate:** un unico foglio di stile esterno (una richiesta bloccante in più a ogni prima visita); soglia di inline più alta (avrebbe incluso anche gli script, vietati dalla CSP). +- **Motivazione:** prestazioni migliori (Lighthouse mobile 0.99–1) senza indebolire la CSP sugli script. + +## D-026 — Token `--gold-800` per il testo delle chip + +- **Data:** 2026-10-15 +- **Contesto:** il testo oro `--gold-700` sul fondo `--gold-100` delle chip dei valori ha contrasto 4.40:1, sotto il minimo 4.5:1 richiesto (§6.2). +- **Scelta:** nuovo token `--gold-800: #806219` (4.98:1 su `--gold-100`) usato solo per il testo delle chip; l'aspetto resta quello del mockup. +- **Alternative scartate:** schiarire il fondo delle chip (si perde la tinta calda del mockup). +- **Motivazione:** contrasto AA per tutto il testo (priorità della specifica scritta sui mockup). + +## D-027 — Audit di Lighthouse declassati ad avviso + +- **Data:** 2026-10-15 +- **Contesto:** il preset `lighthouse:recommended` trasforma in errore anche audit informativi o che dipendono dal server di test di LHCI (HTTP/1.1, assenza degli header del `.htaccess`), ad esempio `network-dependency-tree-insight`, che fallisce per qualsiasi catena HTML → font o script. +- **Scelta:** in `lighthouserc.cjs` restano errori bloccanti le quattro soglie di §9.3 (Performance ≥ 0.95, Accessibility = 1, Best Practices ≥ 0.95, SEO = 1) e tutti gli audit del preset; sono declassati a `warn` solo: `network-dependency-tree-insight`, `critical-request-chains`, `render-blocking-insight`, `render-blocking-resources`, `uses-http2`, `bf-cache`, `csp-xss`. +- **Alternative scartate:** togliere il preset (si perderebbero i controlli puntuali). +- **Motivazione:** regole «rumorose» declassate come previsto dal brief (§11.6), senza allentare le soglie. diff --git a/astro.config.mjs b/astro.config.mjs index 8c8c6de..3292e71 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -33,8 +33,9 @@ export default defineConfig({ compressHTML: true, build: { format: 'directory', - // Il CSS piccolo viene incluso nella pagina (consentito dalla CSP: style-src 'unsafe-inline'). - inlineStylesheets: 'auto', + // CSS incluso nella pagina: nessuna richiesta bloccante per il rendering + // (consentito dalla CSP: style-src 'unsafe-inline'; budget HTML+CSS ≤ 120 KB per pagina). + inlineStylesheets: 'always', }, devToolbar: { enabled: false }, integrations: [ diff --git a/lighthouserc.cjs b/lighthouserc.cjs index fcd4fd5..2542207 100644 --- a/lighthouserc.cjs +++ b/lighthouserc.cjs @@ -22,10 +22,20 @@ module.exports = { preset: 'lighthouse:recommended', aggregationMethod: 'median-run', assertions: { + // Soglie del brief §9.3: sono queste a bloccare la CI. 'categories:performance': ['error', { minScore: 0.95 }], 'categories:accessibility': ['error', { minScore: 1 }], 'categories:best-practices': ['error', { minScore: 0.95 }], 'categories:seo': ['error', { minScore: 1 }], + // Audit informativi o dipendenti dal server di test, declassati ad avviso + // (vedi DECISIONS.md). Restano visibili nei report. + 'network-dependency-tree-insight': 'warn', // segnala qualsiasi catena HTML → font/JS + 'critical-request-chains': 'warn', + 'render-blocking-insight': 'warn', + 'render-blocking-resources': 'warn', + 'uses-http2': 'warn', // il server statico di LHCI usa HTTP/1.1 + 'bf-cache': 'warn', + 'csp-xss': 'warn', // la CSP è un header del server (.htaccess), assente in LHCI }, }, upload: { diff --git a/src/styles/global.css b/src/styles/global.css index ed903f4..13ac817 100644 --- a/src/styles/global.css +++ b/src/styles/global.css @@ -347,7 +347,7 @@ button { padding: 0.35rem 0.8rem; border-radius: var(--radius-pill); background: var(--gold-100); - color: var(--gold-700); + color: var(--gold-800); font-size: var(--fs-xs); font-weight: 600; letter-spacing: 0.02em; diff --git a/src/styles/tokens.css b/src/styles/tokens.css index 891c2d1..d71f6c7 100644 --- a/src/styles/tokens.css +++ b/src/styles/tokens.css @@ -12,6 +12,7 @@ --navy-600: #1f4b74; --navy-100: #e6edf5; --navy-050: #f2f6fa; + --gold-800: #806219; /* testo su fondo gold-100 (chip): contrasto 4.98:1 */ --gold-700: #8a6a1e; /* accento su testo: contrasto AA su bianco e su carta */ --gold-500: #b8902e; /* solo decorativo o su fondo navy, mai come testo su chiaro */ --gold-300: #e3c878;