Piattaforma ITI TECHNOLOGY: monorepo, Medusa, API, sito, area riservata e deploy

Monorepo npm con apps/public (Angular SSR), apps/private (Angular SPA),
apps/api (Fastify), packages/shared e packages/styles; Medusa 2.21 in medusa/;
infrastruttura Docker (Postgres PostGIS+pgvector, Redis, Caddy, backup) e
workflow Gitea Actions per il deploy via SSH a ogni push su master.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018jQyT6dR9czzGwqb7FkG6u

prompts/08-api-scaffold.md

@@ -0,0 +1,22 @@
+# 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.