# 08 — Scaffold API Fastify

Leggi `CLAUDE.md`.

## Obiettivo
Creare `apps/api` con struttura, configurazione e logging, senza logica di dominio.

## Cosa fare
- Fastify + TypeScript, avvio con `tsx watch` in dev, build con `tsc`.
- Struttura: `src/routes/{public,private,admin,webhooks}`, `src/plugins`, `src/services`, `src/db`, `src/config`.
- Config da env validata con `zod` all'avvio (il server non parte se manca qualcosa).
- Logging con pino: console in dev (pino-pretty), file con rotazione in produzione (`LOG_DIR`).
- Plugin base: `@fastify/helmet`, `@fastify/cors` (origini da env: dominio pubblico + area privata, `credentials: true`), `@fastify/cookie`, `@fastify/rate-limit` (limite globale ragionevole).
- Validazione input/output con schemi (TypeBox o zod via `fastify-type-provider-zod`), scegline uno e documentalo.
- Error handler centralizzato con risposte JSON coerenti `{ error: { code, message } }`, senza stack in produzione.
- Route `GET /health`.

## Criteri di accettazione
- `npm run dev -w apps/api` avvia il server; `GET /health` → 200.
- Avvio con env mancante → errore chiaro che elenca le variabili mancanti.
- In modalità produzione i log finiscono su file.
- `CLAUDE.md` aggiornato con struttura e convenzioni API.