seiche-server
Backend Fastify 5 (TypeScript strict, Node 22 via tsx). Sert l'API /api/* et, en production, le front prébuildé (SEICHE_PUBLIC_DIR) sur le même port — zéro CORS, 1 conteneur.
Scripts
| Script | Rôle |
|---|---|
pnpm dev |
Serveur en watch sur http://localhost:8787 (défauts config) |
pnpm start |
Serveur en mode prod (idem, sans watch) |
pnpm setup |
Crée le compte admin initial (idempotent ; SEICHE_ADMIN_USERNAME / SEICHE_ADMIN_PASSWORD, mdp ≥ 12 car.) |
pnpm db:generate |
drizzle-kit generate — génère les migrations dans drizzle/ |
pnpm test |
Vitest (API injectée, SQLite :memory:) — 30 tests |
pnpm typecheck |
tsc --noEmit |
Les migrations sont appliquées automatiquement au boot (migrate() de Drizzle, dossier drizzle/).
Structure
src/
├── main.ts # boot : dataDir, DB + migrations, listen, shutdown propre
├── app.ts # buildApp (trustProxy, logger, plugins, routes)
├── config.ts # toutes les variables d'env (voir .env.example racine)
├── validation.ts # schémas Zod partagés
├── setup.ts # création idempotente du compte admin
├── auth/ # password (argon2id), session + CSRF, rate-limit
├── routes/ # auth, external, health
├── db/ # client libsql (WAL) + schema Drizzle
├── external/ # client du service REST externe (adaptateurs example/http)
└── drizzle/ # migrations versionnées (drizzle/)
API
| Route | Accès | Rôle |
|---|---|---|
GET /api/health |
public | healthcheck |
POST /api/auth/login |
rate-limit | session httpOnly + cookie CSRF (double-submit) |
POST /api/auth/logout · GET /api/auth/session |
session | révocation / état de la session |
GET /api/external/health · GET /api/external/items · POST /api/external/items |
session | pont vers le service externe (adaptateurs example / http) |
Erreurs : corps JSON { statusCode, error, message, code, ... } (le code machine est stable, le message ne fuit jamais les détails internes).
Tests
pnpm test
Les tests injectent Fastify (app.inject) avec une base :memory: par worker (tests/helpers.ts : makeConfig, openTestDb, cookies) — pas de dépendance au réseau.