lecoffre-back-mini/docs/ANALYSE.md

Analyse détaillée

Périmètre

Backend minimal Express TypeScript, endpoints tests et scripts utilitaires.

Stack

• Runtime: Node.js (TS → JS via tsc)
• Framework: Express 4, CORS, dotenv
• DB: pg (PostgreSQL)
• Paiement: Stripe SDK
• Messaging: Mailchimp transactional

Build et exécution

• Scripts: build, start, dev (ts-node), watch, scénarios test:* spécifiques.
• Dépendance locale: sdk-signer-client (path ../sdk-signer-client).
• Docker: clone/compile sdk-signer-client via SSH, build app, prune deps dev, exécution npm start.

Variables d’environnement

• À documenter dans .env (non listées ici). Recommandé d’ajouter .env.example.

Ports

• 8080 (exposé par Compose parent).

Risques et points d’attention

• Dépendance relative ../sdk-signer-client fragile hors CI; Docker règle via clone SSH mais nécessite agent/clé.
• Node 19‑alpine dans le builder: préférer LTS.
• Tests utilitaires JS isolés; aligner avec tests/ et ajouter assertions/rapports.

Actions proposées

• Externaliser sdk-signer-client en dépendance Git contrôlée (tag/commit) ou package binaire local packagé.
• Standardiser Node LTS et CI (lint, tests, build, audit sécurité).
• Fournir .env.example et documenter variables requises.