- Astro 7.4.0 in output statico, TypeScript strict, sitemap - ESLint (flat config, Astro + TS), Prettier, EditorConfig, .nvmrc - configurazioni di Playwright, Lighthouse CI e html-validate - script npm di §3.3 (segnaposto per gli script non ancora implementati) - README, DECISIONS, TODO-STUDIO e CHANGELOG iniziali - mockup e brief in docs/ Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
7.2 KiB
7.2 KiB
Registro delle decisioni
Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · contesto · scelta · alternative scartate · motivazione.
D-001 — Repository esistente su Forgejo e branch di lavoro
- Data: 2026-10-15
- Contesto: il brief (§14.0) prevede
git init, ma il repositoryBalboSoft/Studio_Grassoesiste già su Forgejo con un commit iniziale (README di due righe e.gitignore). - Scelta: si lavora sul clone del repository esistente. Lo sviluppo avviene sul branch
feat/sito-v1(un commit per fase, Conventional Commits in italiano); a fine fase 8 il branch viene unito inmaincon un merge commit (--no-ff), cosìmainlocale è pronto per il push. - Alternative scartate:
git initdi un nuovo repository (perderebbe la storia remota e richiederebbe un push forzato); commit diretti sumain(meno leggibile la storia per fasi). - Motivazione: conserva la storia remota, nessun push forzato necessario,
mainresta pulito fino al merge finale.
D-002 — Sostituzione del .gitignore iniziale
- Data: 2026-10-15
- Contesto: il
.gitignoredel commit iniziale è il modello «VisualStudio» (C#/.NET), non pertinente a un progetto Node/Astro. - Scelta: sostituito con un
.gitignorespecifico (node_modules,dist,release,.astro,test-results,playwright-report,.lighthouseci, file di sistema). - Alternative scartate: aggiungere le voci in coda al modello esistente (centinaia di regole inutili, alcune potenzialmente fuorvianti).
- Motivazione: semplicità e chiarezza (§0.3, punto 4).
D-003 — Versione di Node.js
- Data: 2026-10-15
- Contesto: il brief chiede «Node.js LTS corrente (≥ 22)». A ottobre 2026 la LTS attiva è Node 24 (Krypton); Node 22 è in manutenzione.
eslint-plugin-astro3.x richiede Node^22.22.3 || ^24.16.0 || >=26.3.0, Astro 7 richiede>=22.22.0. - Scelta:
.nvmrc=24;engines.node=>=22.22.3. Sviluppo e test eseguiti con Node 24.22.0. - Alternative scartate: Node 22 come riferimento (LTS in manutenzione);
engines>=24(escluderebbe inutilmente Node 22 aggiornato). - Motivazione: LTS attiva per lo sviluppo, compatibilità dichiarata con il minimo realmente supportato dalle dipendenze.
D-004 — Astro 7.4.0
- Data: 2026-10-15
- Contesto: il brief chiede l'ultima versione stabile di Astro, verificata con
npm view astro version. - Scelta:
astro@7.4.0(risultato dinpm view astro versionil 2026-10-15), con@astrojs/sitemap@3.7.4. - Alternative scartate: nessuna (requisito esplicito).
- Motivazione: requisito del brief §3.1.
D-005 — TypeScript 6.0.3 invece di 7.0.2
- Data: 2026-10-15
- Contesto: l'ultima TypeScript è la 7.0.2, ma
@astrojs/check@0.9.10dichiaratypescript ^5 || ^6etypescript-eslint@8.71.2richiedetypescript <6.1.0. - Scelta:
typescript@6.0.3(ultima 6.x), modalitàstricttramiteastro/tsconfigs/strict. - Alternative scartate: TypeScript 7 (fuori dai peer delle dipendenze, rischio di
astro checknon funzionante). - Motivazione: compatibilità garantita dalle dipendenze ufficiali.
D-006 — Playwright 1.56.1 (versione bloccata)
- Data: 2026-10-15
- Contesto: il brief usa come riferimento l'immagine CI
mcr.microsoft.com/playwright:v1.56.0-noblee chiede che coincida con la versione di@playwright/test. L'ambiente di sviluppo dispone di Chromium revision 1194, quella usata da Playwright 1.56.x; le versioni successive (1.57+) richiedono un Chromium diverso. - Scelta:
@playwright/test@1.56.1eplaywright@1.56.1(ultima patch della 1.56); immagine CImcr.microsoft.com/playwright:v1.56.1-noble. - Alternative scartate: Playwright 1.64.1 (richiederebbe lo scaricamento di un nuovo browser e un'immagine diversa da quella indicata nel brief).
- Motivazione: test riproducibili in locale e in CI con lo stesso browser; aggiornare Playwright significa aggiornare insieme
package.jsone l'immagine dei workflow (documentato nel README).
D-007 — Versioni esatte delle dipendenze
- Data: 2026-10-15
- Contesto: riproducibilità della build e del pacchetto di rilascio.
- Scelta: tutte le dipendenze sono dichiarate con versione esatta (senza
^) epackage-lock.jsonè committato; la CI usanpm ci. - Alternative scartate: intervalli semver (
^x.y.z). - Motivazione: build identiche nel tempo; gli aggiornamenti diventano commit espliciti.
D-008 — Avvisi di npm audit sulle dipendenze di sviluppo
- Data: 2026-10-15
- Contesto:
npm auditsegnala 17 vulnerabilità, tutte in dipendenze transitive di strumenti di sviluppo (soprattutto@lhci/cli:tmp,uuid,basic-ftp,extract-zip).npm audit --omit=dev= 0 vulnerabilità. - Scelta: nessuna azione; nessuno di questi pacchetti finisce nel sito pubblicato (che contiene solo file statici).
- Alternative scartate:
npm audit fix --force(introdurrebbe versioni incompatibili e romperebbe Lighthouse CI). - Motivazione: rischio nullo per il sito pubblicato; gli strumenti girano solo in locale/CI su input fidato.
D-009 — Nessun eslint-plugin-jsx-a11y
- Data: 2026-10-15
- Contesto: le regole a11y di
eslint-plugin-astrorichiedonoeslint-plugin-jsx-a11y, che non supporta ESLint 10. - Scelta: si usa la configurazione
recommendeddieslint-plugin-astro; l'accessibilità è verificata da axe-core (tutte le pagine, due viewport), html-validate (regole WCAG) e Lighthouse (punteggio 1.0). - Alternative scartate: declassare ESLint alla 9 solo per questo plugin.
- Motivazione: copertura a11y più forte a runtime che in lint statico; toolchain aggiornata.
D-010 — Icone Lucide senza astro-icon
- Data: 2026-10-15
- Contesto: il brief consente
@iconify-json/lucide+astro-iconoppure file SVG insrc/icons/. - Scelta: componente
Icon.astroche legge i tracciati da@iconify-json/lucide(JSON) a build time e genera SVG inline conaria-hidden="true". Nessuna integrazione aggiuntiva. - Alternative scartate:
astro-icon(porta con sé@iconify/toolse decine di dipendenze transitive, compatibilità con Astro 7 non dichiarata); copiare a mano i file SVG (manutenzione più scomoda). - Motivazione: zero runtime, meno dipendenze, stesso set di icone (Lucide, licenza ISC).
D-011 — Script segnaposto in fase 0
- Data: 2026-10-15
- Contesto: il brief chiede di definire in fase 0 tutti gli script npm di §3.3 «anche se vuoti».
- Scelta: gli script in
scripts/sono creati come segnaposto e implementati nelle fasi 1 (icone), 6 (test) e 7 (packaging e release). - Alternative scartate: nessuna.
- Motivazione: requisito del brief §14.0.
D-012 — Mockup e brief in docs/
- Data: 2026-10-15
- Contesto: i mockup sono stati forniti in formato WebP (non PNG come indicato nell'Appendice A).
- Scelta: copiati in
docs/mockups/con i nomi dell'Appendice A ed estensione.webp; il brief completo è conservato indocs/BRIEF.mdcome riferimento dei requisiti. - Alternative scartate: convertirli in PNG (file più pesanti senza benefici).
- Motivazione: il riferimento visivo resta nel repository insieme ai requisiti.