Plateforme Kogitec¶
Bienvenue dans la documentation technique de la Plateforme Kogitec.
La plateforme est un monorepo TypeScript full-stack construit avec npm workspaces. Elle comprend un frontend React et un backend Express, organisés en modules indépendants.
Stack technique¶
| Couche | Technologies |
|---|---|
| Langage | TypeScript (strict mode, ESNext) |
| Client | React 19, React Router 7, MUI 7, RxJS, Socket.io-client |
| Serveur | Express 5, MongoDB 7, Socket.io 4 |
| Build | Vite 8 (client), ESBuild (serveur), tsx (dev) |
| Tests | Jest 30 avec ts-jest |
| Qualité | ESLint + Prettier |
Organisation des modules¶
La plateforme est divisée en deux catégories de modules :
Modules plateforme¶
Les modules plateforme fournissent les fonctionnalités fondamentales et les services essentiels au fonctionnement global du système.
- core — Composants React de base, shell d'application, Express, i18n
- schema — Schémas Zod, infrastructure pub/sub, génération de formulaires
- socket — Transport WebSocket via Socket.io
- doc — Store de documents réactif avec MongoDB
- security — Authentification et autorisation
- metaltura — Éditeur de diagrammes de classes et moteur de modèles
- console — Console développeur pour l'inspection et le débogage
Modules application¶
Les modules application implémentent les fonctionnalités métier spécifiques.
- app — Point d'entrée principal de l'application
- beneva — Module d'assurance Beneva
- chat — Messagerie en temps réel
- kitchen — Gestion de tables et colonnes
- members — Gestion des membres et contrats
Architecture¶
Consultez la vue d'ensemble de l'architecture pour un diagramme complet du système et les interactions entre les composants.