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
23 lines
1.2 KiB
Markdown
23 lines
1.2 KiB
Markdown
# 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.
|