Files
CoHaiSe/docs/workflow.md
T
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +01:00

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, Spinner ou cn doit être répliqué à la main dans :
    • CoHaiSe/frontend/shared
    • CoHaiSe-CLOUD/frontend/shared
    • CoHaiSe-CRM/frontend/shared
  • tokens.css doit rester strictement identique dans les trois (comparer par md5sum). Les composants, eux, peuvent diverger : chaque app les redéfinit à sa main.
  • Après modification : npm run build --workspace=frontend/shared, puis make web pour 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, remote origin 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.yml absents).
  • Ne jamais committer .env, node_modules/, dist/ (exclus par .gitignore).

Pièges connus

  1. .dev en HSTS-preload : /etc/hosts ne fera jamais fonctionner cohaise.dev en local. Tester sur localhost.
  2. backend/shared est construit mais jamais utilisé : une erreur de types venant de là n'affecte pas le site, mais bloque npm run typecheck.
  3. docker/README.md historique : ne sert que les images ; le fonctionnement réel est dans docs/deployment.md.
  4. Aucun code splitting : tout le site tient dans un seul bundle, ce qui est volontaire pour une vitrine.