CI/CD verificabile
La pipeline esegue format check, lint, typecheck, coverage, docs, build static export, report exposure, E2E e assert finali sull'output.
Engineering Quality
Questa pagina raccoglie le scelte tecniche che rendono il progetto più di una demo catalogo: export statico, report pubblici, test di flusso e accessibilità verificabile.
Ogni controllo è pensato per ridurre regressioni reali su UX, accessibilità, documentazione pubblica e compatibilità con Pages.
La pipeline esegue format check, lint, typecheck, coverage, docs, build static export, report exposure, E2E e assert finali sull'output.
Le soglie Vitest sono bloccanti: statement 80%, branch 75%, function 80% e line 80%. Il report HTML viene pubblicato su GitHub Pages.
I moduli di dominio sono documentati con TSDoc/JSDoc e TypeDoc genera una reference pubblica sotto /docs/.
Next.js esporta asset statici in out/, con immagini non ottimizzate server-side, trailing slash e base path compatibile con project Pages.
Il carrello usa semantica dialog, focus management, Escape close, overlay close, tab order prevedibile e annunci aria-live.
Playwright copre i flussi shopper reali: catalogo, search, filtri, dark mode, dettaglio prodotto, carrello e checkout mock.
Static Commerce Architecture
Il progetto privilegia una superficie frontend solida e pubblicabile su GitHub Pages, quindi alcune scelte sono intenzionalmente statiche.