license: built full stack, test and documentation

CLAUDE.md

@@ -25,7 +25,7 @@ nazionale svedese.
 | OpenAPI | **scegliere UNO** tra `darkaonline/l5-swagger` o `dedoc/scramble` (ora ci sono entrambi) |
 | Linked Art | `ml/json-ld` (serializzazione) + `opis/json-schema` (validazione contro gli schema RAÄ) |
 | Frontend | Vite + TypeScript, MPA con isole, Tailwind v4 + daisyUI, Leaflet |
-| Docs | MkDocs Material (`documentation/`) |
+| Docs | MkDocs Material (`docs/` + `mkdocs.yml` alla root; publish via GitHub Pages, `.github/workflows/docs.yml`) |
 | Qualità | SonarQube locale (`http://sonar.local`) |
 
 ## 3. Architettura dati (decisione chiave)
@@ -115,13 +115,15 @@ Motivi e asimmetria backend/frontend:
 Usare i target del `Makefile` (incapsulano la strategia host/container del §6bis):
 
 ```bash
-make up                       # avvia l'intero stack dev (Vite HMR + backend + db + redis + docs + mailpit)
+make up                       # avvia l'intero stack dev (Vite HMR + backend + db + redis + mailpit)
 make migrate                  # artisan migrate (container come UID host)
 make import                   # ETL da v1 (quando implementato)
 make artisan c="test --coverage-clover=coverage.xml"   # test backend
 make be-update                # composer update (host)
 make fe-install               # npm install host (package-lock + type-check IDE)
 make fe-rebuild               # ricostruisce l'immagine frontend dopo modifiche a package.json
+make docs                     # anteprima MkDocs (http://localhost:8001/adc/) — publish: GitHub Pages
+make docs-check               # build --strict della doc, come in CI (prima del push)
 make permissions              # fix permessi storage (una tantum, sudo)
 make help                     # elenco completo
 ```