Architecture

Applications

• apps/web porte l'expérience utilisateur, les routes Better Auth et le futur calendrier.
• apps/api expose les capacités métier synchrones sous /v1 et publie son contrat OpenAPI.
• apps/jobs héberge les traitements asynchrones et durables déclenchés par événements Inngest.
• apps/docs documente les conventions techniques et opérationnelles.

Packages

• packages/ui contient les composants shadcn et les tokens Tailwind partagés.
• packages/database possède le schéma Prisma et le client Neon paresseux.
• packages/auth configure Better Auth côté serveur et navigateur.
• packages/api-client génère un client typé depuis NestJS.
• packages/utils accueille uniquement les utilitaires réellement transverses.
• packages/config centralise les configurations TypeScript.

Flux de contrat

NestJS -> openapi.json -> openapi-typescript -> @flavonaut/api-client -> Next.js

Lancer bun run api:generate après toute modification de contrôleur ou de DTO exposé.