Lorenzo SanesiandClaude Opus 5.5
b83ce039fb
Deploy stack su Proxmox / deploy (push) Failing after 3s
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
1.2 KiB
1.2 KiB
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 watchin dev, build contsc. - Struttura:
src/routes/{public,private,admin,webhooks},src/plugins,src/services,src/db,src/config. - Config da env validata con
zodall'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/apiavvia 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.mdaggiornato con struttura e convenzioni API.