@@ -0,0 +1,78 @@
|
||||
# Workflow — CoHaiSe Web
|
||||
|
||||
## Boucle de développement
|
||||
|
||||
```sh
|
||||
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
|
||||
|
||||
```sh
|
||||
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é
|
||||
|
||||
```sh
|
||||
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.
|
||||
Reference in New Issue
Block a user