2.9 KiB
2.9 KiB
Workflow — CoHaiSe Web
Boucle de développement
make dev # Vite sur http://localhost:5173, hot reload
Le serveur de dev sert frontend/web avec server.host: true, port 5173
(vite.config.ts). Il n'a pas besoin de Docker ni de .env.
Vérification avant de valider
npm run typecheck # tsc --build sur toutes les références
npm run build # typecheck + build de chaque workspace
curl -I http://localhost:8080/healthz
Il n'y a ni linter, ni testeur, ni CI dans ce dépôt : typecheck et build
sont les seules garanties automatiques. .editorconfig porte les conventions
(2 espaces, LF, UTF-8 ; pas de trim_trailing_whitespace pour les .md).
Reconstruire le site publié
make web # build + publication atomique
make reload # uniquement si nginx/web.conf a changé
make web ne coupe jamais le service : la copie se fait à côté, le lien
bascule ensuite.
Modifier le design system
Point le plus important : frontend/shared est dupliqué dans les trois
dépôts CoHaiSe. Il n'y a pas de version centrale.
- Un correctif de
Button,Card,Input,Skeleton,Spinneroucndoit être répliqué à la main dans :CoHaiSe/frontend/sharedCoHaiSe-CLOUD/frontend/sharedCoHaiSe-CRM/frontend/shared
tokens.cssdoit rester strictement identique dans les trois (comparer parmd5sum). Les composants, eux, peuvent diverger : chaque app les redéfinit à sa main.- Après modification :
npm run build --workspace=frontend/shared, puismake webpour republier.
Où changer quoi
| Besoin | Fichier |
|---|---|
| Couleur, rayon, police, ombre | frontend/shared/src/styles/tokens.css |
| Composant partagé | frontend/shared/src/components/*.tsx |
| Page, layout, contenu | frontend/web/src/** |
| Routage (onglets) | frontend/web/src/App.tsx |
| Cache, en-têtes, fallback SPA | docker/nginx/web.conf + docker/nginx/snippets/ |
| Port public | COHAISE_HTTP_PORT dans .env |
| Thème par défaut | script inline de frontend/web/index.html |
Git
- Branche
main, remoteorigin https://git.cohaise.dev/Esiah/CoHaiSe.git. - Historique vierge (un commit initial) : aucune convention de message héritée.
- Pas de hooks, pas de CI (
.github/,.gitlab-ci.ymlabsents). - Ne jamais committer
.env,node_modules/,dist/(exclus par.gitignore).
Pièges connus
.deven HSTS-preload :/etc/hostsne fera jamais fonctionnercohaise.deven local. Tester surlocalhost.backend/sharedest construit mais jamais utilisé : une erreur de types venant de là n'affecte pas le site, mais bloquenpm run typecheck.docker/README.mdhistorique : ne sert que les images ; le fonctionnement réel est dansdocs/deployment.md.- Aucun code splitting : tout le site tient dans un seul bundle, ce qui est volontaire pour une vitrine.