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:
5 files changed
+39
-3
No files matched your search
@@ -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
@@ -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: [
|
||||
|
||||
@@ -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: {
|
||||
|
||||
@@ -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;
|
||||
|
||||
@@ -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;
|
||||
|
||||
Reference in new issue
Block a user