Introduction
Pulse ERP — vision, périmètre et principes d'architecture.
Introduction
Pulse ERP est une plateforme ERP/CRM moderne (mono-app Nuxt 4) qui gère le cycle de vie d'équipements professionnels pour la grande distribution alimentaire — vente, location longue durée (LLD) avec cession à des bailleurs, location courte durée (LCD), maintenance et SAV.
Cette documentation est la référence technique de la plateforme :
architecture, modules métier livrés et conventions maison à respecter avant
toute contribution.
Socle technique
Nuxt 4 SSR + Nuxt UI 4 + Tailwind 4 + Better Auth (MFA + Organization) +
Prisma + PostgreSQL 16 + Zod + Vitest + Playwright. Mono-app file-based avec API
Nitro REST dans app/pulse/.
Architecture en couches
Toute fonctionnalité respecte le sens route API → service → repository :
| Couche | Responsabilité | Ne fait jamais |
|---|---|---|
| Route API | parse, vérifie la permission, appelle un service | de logique métier |
| Service | logique métier, transactions, audit | d'accès Prisma direct |
| Repository | accès Prisma pur | de logique métier |
Conventions inviolables
- Multi-tenant strict — toujours filtrer par
organizationIdlu depuis la session, jamais depuis le body. - Validation Zod en entrée de service (
validateBody/Query/Params). - Audit log systématique sur toute mutation sensible.
- i18n — aucune chaîne en dur côté UI ; clés présentes dans
fr.jsoneten.jsondans la même PR.