-

CLAUDE.md

@@ -284,26 +284,29 @@ XX. **Nome Problema (FIX/IMPLEMENTATO DATA):** - **Problema:** Descrizione breve
 6. [ ] Gestire sezioni header/footer ripetute su ogni pagina
 7. [ ] UI per relazioni tra dataset multipli
 
-**Comandi utili:**
+**Comandi utili (usa il Makefile!):**
 
 ```bash
-# Build backend
-cd src && dotnet build
+# IMPORTANTE: Usa sempre il Makefile per compilare e avviare l'applicazione
 
-# Build frontend
-cd frontend && npm run build
+make help              # Mostra tutti i comandi disponibili
+make install           # Installa tutte le dipendenze (NuGet + npm)
+make dev               # Avvia backend e frontend in parallelo (dev mode)
+make build             # Compila tutto per produzione
 
-# Run backend (porta 5000)
-cd src/Apollinare.API && dotnet run
+make backend-run       # Avvia solo backend (porta 5000)
+make frontend-run      # Avvia solo frontend (porta 5173)
+make backend-watch     # Backend con hot reload (dotnet watch)
 
-# Run frontend dev (porta 5173)
-cd frontend && npm run dev
+make clean             # Pulisce artefatti di build
+make lint              # Esegue ESLint sul frontend
+make check             # Verifica prerequisiti installati (dotnet, node, npm)
 ```
 
 **IMPORTANTE:** Dopo modifiche al codice, i servizi backend e frontend vanno **sempre riavviati** per vedere le modifiche:
 
-- Backend: fermare con `Ctrl+C` e rilanciare `dotnet run`
-- Frontend: in dev mode (`npm run dev`) il hot-reload è automatico per la maggior parte delle modifiche, ma per modifiche strutturali (nuovi file, cambi a tipi, etc.) potrebbe essere necessario riavviare
+- Backend: fermare con `Ctrl+C` e rilanciare `make backend-run`
+- Frontend: in dev mode (`make frontend-run`) il hot-reload è automatico per la maggior parte delle modifiche, ma per modifiche strutturali (nuovi file, cambi a tipi, etc.) potrebbe essere necessario riavviare
 
 ---