perf: CSS incluso nelle pagine, contrasto delle chip e soglie Lighthouse

- 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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
This commit is contained in:
Claude committed 2026-10-15 22:36:39 +00:00
1 parent b8575c0ed4
commit 8ce77de137
5 files changed
+39 -3

No files matched your search

+24
View File
@@ -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.
+3 -2
View File
@@ -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: [
+10
View File
@@ -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: {
+1 -1
View File
@@ -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;
+1
View File
@@ -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;