Bonnes pratiques (Web)

• Environnements

  • Considérer toutes les variables VITE_* comme publiques. Ne jamais y mettre de secrets.
  • Préférer window.RUNTIME_ENV (injection via vite.config.ts) pour les URLs en déploiement.
  • Utiliser getServerUrl()/getChatbotUrl() de apps/web/src/utils/runtime-env.ts au lieu d'accéder directement à import.meta.env.

• Appels API (ORPC)

  • Centraliser les appels via apps/web/src/utils/orpc.ts.
  • Laisser credentials: 'include' actif pour les sessions.
  • En cas d'erreur, s'appuyer sur les toasts sonner (config QueryClient), et invalider les queries pertinentes.

• Auth & RBAC

  • Les pages dans (protected) s'appuient sur beforeLoad et context.orpc.getMe.call() pour protéger l'accès.
  • Rediriger proprement vers /sign-in avec redirect et search.redirect.

• Devtools et debug

  • Activer TanStack Router Devtools et React Query Devtools (déjà intégrés dans __root.tsx).
  • Surveiller les requêtes et l'état du cache pour éviter des refetchs inutiles.

• Performance

  • Le vite.config.ts découpe les chunks via manualChunks (Rollup) : limiter les imports lourds côté pages.
  • Précharger intelligemment (Router defaultPreload: 'intent').

• UI & Thèmes

  • Garder une hiérarchie simple de composants (Radix + Tailwind) pour la maintenabilité.
  • Utiliser next-themes pour les thèmes, clé de stockage vite-ui-theme (voir __root.tsx).