feat: init repo
deploy / deploy (push) Canceled after 0s

This commit is contained in:
2026-11-10 19:56:03 +01:00
commit 858d862fed
166 changed files with 13336 additions and 0 deletions
+67
View File
@@ -0,0 +1,67 @@
# Agents — CoHaiSe Web
Conventions de travail pour un agent (ou un nouveau contributeur) reprenant ce
dépôt seul. Paired avec `README.md` (démarrage rapide) et les autres fichiers
de `docs/`.
## Commandes
| Action | Commande |
| --- | --- |
| Dev hot-reload | `make dev` (Vite 5173) |
| Vérifier les types | `npm run typecheck` |
| Builder | `npm run build` |
| Reconstruire + publier | `make web` |
| Santé | `curl -I http://localhost:8080/healthz` |
| Conteneurs | `make ps`, `make logs` |
Aucun linter, aucun test, aucune CI : `typecheck` + `build` sont les seules
vérifications automatiques. Exécuter les deux avant de déclarer un travail fini.
## Règles du dépôt
1. **Ne pas toucher aux volumes** : pas de `docker volume rm`, pas de `docker
compose down -v`. Les volumes ne sont jamais supprimés par les cibles.
2. **Ne pas committer ni pousser** sans demande explicite.
3. **Ne pas lire `.env`** : il contient des secrets d'autres apps. Écrire
`SESSION_SECRET` est autorisé, le recopier depuis un autre dépôt aussi, le
diffuser non.
4. **Ne pas créer de backend** : ce dépôt est une vitrine statique. Toute
fonctionnalité nécessitant une API appartient à `CoHaiSe-CLOUD` ou
`CoHaiSe-CRM`.
5. **`.env.example` n'est pas la vérité** : il contient des clés héritées que le
compose n'utilise pas. Seul `COHAISE_HTTP_PORT` est lu.
## Conventions de code
- TypeScript strict, project references (`tsconfig.json` racine).
- React 19, pas de routeur : la navigation est un état dans `App.tsx`.
- Tailwind 4 via `@import "tailwindcss"` ; **pas de classes arbitraires en
dur** : passer par les jetons `--cohaise-*` (`@theme inline`).
- Style visuel : `Button`, `Card`, `cn` depuis `@cohaise/ui`. Pas de
`<div class="bg-…">` quand un composant existe.
- `.editorconfig` : 2 espaces, LF, UTF-8.
## Duplication du design system
`frontend/shared` existe à l'identique dans les trois dépôts CoHaiSe. Avant de
modifier un fichier partagé :
1. chercher d'abord si le besoin n'est pas déjà couvert par un jeton ;
2. si modification : appliquer dans les **trois** dépôts ;
3. vérifier `md5sum */frontend/shared/src/styles/tokens.css` → trois digests
identiques.
Ne jamais « améliorer » un composant d'un seul dépôt sans répercuter : les
palettes doivent rester synchronisées.
## Pièges
- `cohaise.dev` est HSTS-preloadé : `/etc/hosts` ne sert à rien, tester via
`localhost:8080`.
- `backend/shared` est construit mais inutilisé : une erreur de types ici ne
casse pas le site.
- `docker/README.md` décrit la build d'image uniquement ; pour le service,
`docs/deployment.md`.
- Après `make web`, vérifier que le symlink a bien basculé :
`docker compose exec nginx ls -l /usr/share/nginx/html/current`.
+90
View File
@@ -0,0 +1,90 @@
# Architecture — CoHaiSe Web
Vitrine statique. Il n'y a **ni API, ni base de données, ni session** : un bundle
Vite servi par nginx. Tout le reste (build, publication, en-têtes) tient dans
`docker/`.
## Pile
| Élément | Version | Où |
| --- | --- | --- |
| React | 19 | `frontend/web` |
| Vite | 8 | `frontend/web/vite.config.ts` |
| Tailwind CSS | 4 (`@tailwindcss/vite`) | `frontend/web/src/styles/index.css` |
| TypeScript | 7 (`typescript` en devDependency racine) | `tsconfig.json` (project references) |
`package.json` racine : `workspaces: ["frontend/*", "backend/*"]`, scripts
`build` (`tsc --build` puis build de chaque paquet), `typecheck`, `clean`.
## Découpage
```
frontend/
shared/ @cohaise/ui — design system, DUPLOQUÉ dans les 3 dépôts CoHaiSe
web/ @cohaise/web — la vitrine
backend/
shared/ @cohaise/server — couche serveur, PRÉSENTE mais INUTILISÉE ici
docker/ Dockerfile, Dockerfile.app, nginx/, publish.sh
```
`backend/shared` est référencé par `tsconfig.json` racine et donc **construit**
par `npm run build`, mais aucun paquet ne l'importe et `docker-compose.yml` ne
construit pas `Dockerfile.api`. C'est un reliquat du monorepo à trois apps :
inoffensif, mais inutile dans ce dépôt.
## Chaîne de build
Deux images, deux rôles :
1. **`docker/Dockerfile.app`** (`target: export`) — stage `builder` `node:22-alpine` :
`npm ci`, puis `npm run build --workspace=frontend/shared` et
`--workspace=${APP_DIR}` (`APP_DIR: frontend/web` passé par compose). Stage
`export` `alpine:3.21` : recopie `dist/` dans `/app/dist`.
2. **`docker/publish.sh`** — tourne dans le conteneur `app-build` avec le volume
`app_data` monté : copie dans `releases/<UTC>-<pid>`, puis bascule atomique du
lien `current` (`ln -sfn` + `mv -T`). La version précédente reste servie
pendant la copie ; une release plus vieille que 5 minutes est purgée.
Publication **atomique** : nginx ne voit jamais un répertoire à moitié écrit.
## Service de rendu
`docker/Dockerfile` : `nginx:1.27-alpine` + `docker/nginx/web.conf`.
| Point | Comportement | Référence |
| --- | --- | --- |
| Racine | `/usr/share/nginx/html/current` (symlink) | `nginx/web.conf:6` |
| `/healthz` | `200 ok`, log coupé | `web.conf:16-20` |
| `/assets/` | `expires 1y`, `Cache-Control: public, immutable` | `cache-immutable.conf` |
| Racine applicative | `no-cache`, fallback SPA `try_files → @spa → /index.html` | `web.conf:29-37` |
| gzip | actif, `min_length 1024` | `web.conf:11-14` |
| En-têtes | `snippets/security-headers.conf` au niveau serveur **et** dans chaque `location` | `web.conf:9,23,30` |
## Front
- **Pas de routeur** : deux onglets commutés par `useState` (`src/App.tsx:25-29`).
- **Pas de code splitting** : `main.tsx` importe `App` en statique, aucun
`React.lazy`.
- **Thème clair/sombre** : script inline dans `index.html` (anti-FOUC) lit
`localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`, puis pose la
classe `.dark` sur `<html>`. Le basculeur écrit via `useTheme`.
- **Design system** : `Button`, `Card`, `cn` sont les seuls composants utilisés.
`Input` est un `<input>` brut, `DemoCard` (seul utilisateur de `Skeleton`) n'est
jamais monté.
- **Aucun appel réseau** : pas de `fetch`, `axios`, `WebSocket`, ni
`import.meta.env`. Fonts (woff2) et favicon en local, aucune ressource tierce.
## Jetons
`frontend/shared/src/styles/tokens.css` est la source des couleurs ; Tailwind 4
les reçoit par `@theme inline` (`theme.css`). L'application lit le fichier via :
```css
@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../../../frontend/shared/src";
```
`--cohaise-destructive` est un rouge (`#d32f2f` clair / `#ef4444` sombre),
l'accent de marque est le carmin `--cohaise-accent` (`#b71c1c`), l'avertissement
reste jaune (`--cohaise-warning`). Voir `standards.md`.
+86
View File
@@ -0,0 +1,86 @@
# API et modèle de données — CoHaiSe CRM
Base : **`/api/crm`**, plus `GET /healthz` (sonde base, `503` si indisponible).
`attachUser` sur les quatre préfixes ; `requireAuth` sur chaque route sauf la
connexion. **Aucune route n'est protégée par un rôle** depuis `007_no_roles.sql`.
## Routes
| Méthode | Chemin | Fichier |
| --- | --- | --- |
| POST | `/api/crm/auth/login` | `routes/auth.ts:64` |
| POST | `/api/crm/auth/logout` | `routes/auth.ts:98` |
| GET | `/api/crm/auth/me` | `routes/auth.ts:105` |
| POST | `/api/crm/auth/change-password` | `routes/auth.ts:114` |
| GET | `/api/crm/countries?q=` | `routes/countries.ts:46` |
| POST | `/api/crm/countries` | `routes/countries.ts:57` |
| PATCH | `/api/crm/countries/:id` | `routes/countries.ts:88` |
| DELETE | `/api/crm/countries/:id` | `routes/countries.ts:132` |
| GET | `/api/crm/organizations?q&page&limit` | `routes/organizations.ts:105` |
| GET | `/api/crm/organizations/:id` | `routes/organizations.ts:135` |
| POST | `/api/crm/organizations` | `routes/organizations.ts:146` |
| PATCH | `/api/crm/organizations/:id` | `routes/organizations.ts:200` |
| DELETE | `/api/crm/organizations/:id` | `routes/organizations.ts:262` |
| GET | `/api/crm/contacts?q&organizationId&page&limit` | `routes/contacts.ts:96` |
| GET | `/api/crm/contacts/:id` | `routes/contacts.ts:140` |
| POST | `/api/crm/contacts` | `routes/contacts.ts:151` |
| PATCH | `/api/crm/contacts/:id` | `routes/contacts.ts:202` |
| DELETE | `/api/crm/contacts/:id` | `routes/contacts.ts:260` |
### Conventions communes
- Corps validés par Zod (`createX`/`updateX`, `credentials`, `changePassword`).
- `:id` UUID validé par regex ⇒ **404** sinon (pays : entier `> 0` sinon 404).
- Pagination : `limit` borné `1..100`, défaut 25 ; `q` fait une recherche
texte.
- Unicité violée (`1062`), FK référencée (`1451`/`1452`) ⇒ **409**.
- Suppression : `DELETE FROM countries` en dur ;
`organizations` et `contacts` passent à `deleted_at = NOW()` et disparaissent
des listes (`WHERE deleted_at IS NULL`).
- Réponse d'erreur :
```json
{ "error": { "status": 404, "code": "NOT_FOUND", "message": "…", "requestId": "…" } }
```
## Modèle de données
`backend/crm/migrations/` — 8 fichiers, application stricte dans l'ordre,
checksum SHA-256 par fichier.
| Fichier | Contenu |
| --- | --- |
| `000_schema_migrations.sql` | table de suivi (`version`, `applied_at`, `checksum`) |
| `001_initial_schema.sql` | 15 tables : `roles, users, password_reset_tokens, countries, tags, organizations, contacts, contact_tags, pipeline_stages, deals, deal_stage_history, activities, tasks, settings, audit_logs` — 30 FK, 7 `CHECK` |
| `002_reference_data.sql` | seeds : 3 rôles, 7 étapes de pipeline, **19 pays**, 4 réglages, 5 tags |
| `003_integrity_backstop.sql` | FK `users.role_id` (`RESTRICT`) + 6 `CHECK` de longueur |
| `004_audit_precision.sql` | `DATETIME(3)` sur les journaux d'audit, l'historique de pipeline, deals, activités, tâches, `last_login_at` |
| `005_user_sessions.sql` | table `user_sessions` (`token_hash CHAR(64)`, FK `CASCADE`) ; purge confiée au service |
| `006_active_identity.sql` | colonnes générées `contacts.active_email`, `organizations.active_name` (`IF(deleted_at IS NULL, …, NULL) STORED`) + index uniques dédiés |
| `007_no_roles.sql` | **suppression des rôles** : `DROP FOREIGN KEY fk_users_role`, `DROP COLUMN role_id`, `DROP TABLE roles` |
> `007` laisse `002` (seeds de rôles) et `003` (FK réintroduite) intacts : ces
> fichiers ne se re-modifient jamais, une migration appliquée est figée.
### Entités exposées
| Table | Identifiant | Remarques |
| --- | --- | --- |
| `users` | `CHAR(36)` UUID | `first_name`, `last_name`, `must_change_password`, `is_active`, soft delete |
| `organizations` | UUID | FK `countries` (`SET NULL`), `owner_id`, `created_by` |
| `contacts` | UUID | FK `organizations` (`SET NULL`), pays, `owner_id` |
| `countries` | `INT UNSIGNED` | suppression physique |
| `user_sessions` | — | `token_hash`, `expires_at`, `revoked_at` |
Hors API : `deals`, `activities`, `tasks`, `tags`, `contact_tags`,
`pipeline_stages`, `settings`, `password_reset_tokens`, `audit_logs`.
## Dérive de migrations
`runMigrations()` ne joue que les versions absentes et enregistre le SHA-256 du
SQL ; `assertNoDrift()` refuse le démarrage si un fichier déjà appliqué a changé.
CLI : `cohaise-migrate --dir <dossier> [--dry-run] [--check]`, codes `0` / `1`
(erreur ou dérive) / `2` (configuration).
Le DDL MariaDB n'est pas transactionnel : une migration interrompue se corrige
par un **nouveau** fichier, jamais en éditant l'ancien.
+90
View File
@@ -0,0 +1,90 @@
# Déploiement — CoHaiSe Web
## Prérequis
Docker avec le plugin Compose, `make`. Rien d'autre : la vitrine n'a besoin
d'aucun secret, d'aucune base, d'aucun compte.
```sh
cp .env.example .env # optionnel
make up # build + démarrage sur 8080
```
## Compose
`docker-compose.yml` — projet **`cohaise-web`**, deux services, un volume :
| Service | Image | Port | Rôle |
| --- | --- | --- | --- |
| `app-build` | `docker/Dockerfile.app` | — | build Vite, `restart: "no"` |
| `nginx` | `docker/Dockerfile` | `${COHAISE_HTTP_PORT:-8080}:80` | rendu, `restart: unless-stopped` |
Volume unique : `app_data` (`/usr/share/nginx/html`), monté par les deux. Aucun
`depends_on` : le lien est le partage du volume. `app-build` publie puis
s'arrête ; nginx n'a jamais à redémarrer.
Healthcheck nginx : `wget -qO- http://127.0.0.1/healthz`, 10 s d'intervalle,
3 s de timeout, 3 essais.
## Variables
Seule variable consommée : `COHAISE_HTTP_PORT` (défaut `8080`), lue par la
substitution Compose — il n'y a pas de `env_file`.
Le `.env.example` contient encore les clés des anciennes apps (CRM, Cloud,
`SESSION_SECRET`…) : **inutiles ici**, la stack n'en lit aucune. Ne pas les
supprimer sans vérifier qu'aucune autre cible ne les référence.
## Commandes
```sh
make help # liste complète
make up # build + démarrage
make web # reconstruire et republier la vitrine (sans interruption)
make reload # nginx -s reload, sans coupure
make build # construire les images sans redémarrer
make ps # état
make logs # journaux suivis
make dev # Vite local sur 5173 (hors Docker)
make down # arrêt, volumes conservés
```
`make help` affiche aussi `npm run typecheck` / `npm run build` sous
« Vérification » : aucune cible Makefile ne les exécute, ce sont des commandes
npm à taper directement.
## Vérification
```sh
curl -I http://localhost:8080/healthz # HTTP/1.1 200 ok
curl -s http://localhost:8080/ | head # index.html servi par le symlink current
```
## Publication d'une version
```sh
make web
```
1. `app-build` reconstruit l'image et exécute `publish.sh` ;
2. la nouvelle copie est écrite dans `releases/<horodatage>` ;
3. le lien `current` bascule par `mv -T` (atomique) ;
4. nginx sert immédiatement la nouvelle version, sans reload.
En cas de régression, l'ancienne release existe encore quelques minutes : on peut
re-basculer le lien manuellement dans le conteneur avant la purge automatique.
## Exposition publique
Le port est publié **sans bind IP** (`0.0.0.0:8080`). L'exposition sur Internet
passe par le tunnel cloudflared, qui vit dans un conteneur **hors de ce dépôt** :
ne rien y changer depuis ici. Le `.dev` est HSTS-preload, donc `/etc/hosts` ne
sert jamais à tester `cohaise.dev` en local — utiliser `localhost:8080`.
## Arrêt
```sh
make down # conteneurs + réseau, volume app_data conservé
```
Les volumes ne sont jamais supprimés par les cibles du Makefile.
+66
View File
@@ -0,0 +1,66 @@
# Sécurité — CoHaiSe Web
Surface minimale : une application statique, sans comptes, sans cookies, sans
données. Ce document recense ce qui **est** protégé et ce qui **ne l'est pas**,
pour éviter de partir d'hypothèses fausses.
## Ce qui est en place
### En-têtes nginx
`docker/nginx/snippets/security-headers.conf` :
```nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
Referrer-Policy: strict-origin-when-cross-origin
```
Le snippet est inclus au niveau `server` **et** dans chaque `location` (fichiers
`assets`, `/`, `/healthz`) : les réponses d'erreur et de santé portent les mêmes
en-têtes que la page.
### Aucune donnée sensible
- Aucun appel réseau côté client (vérifié : pas de `fetch`, `XMLHttpRequest`,
`axios`, `WebSocket`).
- Aucune clé, aucun `import.meta.env` dans `frontend/`.
- `.env` exclu de git (`.gitignore`) et des images (`.dockerignore`).
- Seul stockage navigateur : `localStorage["cohaise-theme"]`.
- Aucun cookie : le design system ne pose pas de cookie, `backend/shared` n'est
pas déployé.
### Ressources
Fonts woff2 et favicon hébergées localement — aucune requête vers un tiers,
donc aucun en-tête `Referrer-Policy` à négocier avec un CDN et aucun
`connect-src` à ouvrir.
## Ce qui n'est pas en place
| Élément | État | Conséquence |
| --- | --- | --- |
| CSP | **absente** | une injection dans un fichier HTML servi briserait la règle du moins cher possible ; le site n'a aucun script tiers, ajouter une CSP stricte est peu coûteux |
| HSTS | absent | le `.dev` est HSTS-preloadé par le navigateur, donc le trafic est déjà forcé en HTTPS : l'absence d'en-tête ici ne change rien côté navigateur, mais un autre domaine servirait en clair |
| `Permissions-Policy` | absent | caméra/micro/geolocalisation jamais sollicités |
| Bind `127.0.0.1` | non | le port `8080` est publié sur toutes les interfaces ; seul le tunnel définit l'accès réel. Pour un hébergement partagé, restreindre à `127.0.0.1:${COHAISE_HTTP_PORT}:80` dans `docker-compose.yml` |
| Rate limiting | non pertinent | aucun endpoint dynamique |
| TLS | hors du dépôt | nginx n'écoute que le `80`, le terminus HTTPS est le tunnel |
## Chaîne de confiance
```
tunnel cloudflared → nginx:8080 → /usr/share/nginx/html/current → releases/<id>
```
- `current` est un lien créé par `publish.sh` : un contenu publié ne peut pas
être modifié à l'écriture, seulement remplacé de façon atomique.
- nginx tourne en `nginx:1.27-alpine` sans module tiers ajouté.
- Le conteneur n'a pas de droits particuliers déclarés, pas de `cap_add`.
## À ne pas faire
- Ne pas brancher de clé ou de token dans le front : ce dépôt n'a pas de back.
- Ne pas ajouter de ressource externe (font CDN, script analytics) sans réviser
les en-têtes et `index.html`.
- Ne pas publier `.env` : il contient des clés héritées d'autres apps.
+87
View File
@@ -0,0 +1,87 @@
# Standards — CoHaiSe Web
Conventions à respecter pour que ce dépôt reste cohérent avec les deux autres
(`CoHaiSe-CLOUD`, `CoHaiSe-CRM`), qui partagent le même design system.
## Formatage
`.editorconfig` fait foi :
| Réglage | Valeur |
| --- | --- |
| Charset | UTF-8, fin de ligne LF |
| Indentation | 2 espaces (pas de tabs) |
| `trim_trailing_whitespace` | `false` pour `*.md`, vrai ailleurs |
Aucun Prettier/ESLint n'est installé : l'éditeur et l'`.editorconfig` sont la
seule norme mécanique.
## Palette
Source unique : `frontend/shared/src/styles/tokens.css`.
| Jeton | Rôle | Valeur |
| --- | --- | --- |
| `--cohaise-accent` | accent de marque (liens, focus, éléments primaires) | carmin `#b71c1c` (`crimson-700`) |
| `--cohaise-destructive` | suppression, erreurs, champs invalides | `#d32f2f` clair / `#ef4444` sombre |
| `--cohaise-destructive-foreground` | texte posé dessus | `#ffffff` clair / `#1a0505` sombre |
| `--cohaise-warning` | avertissement, badges d'état | jaune `yellow-500` |
| `--cohaise-surface`, `--cohaise-background` | fonds | gris chaud `#f7f5f4` / `#050000` |
Règles :
- **L'orange n'existe plus** : `--cohaise-amber-*` a été retiré. Ne pas le
réintroduire — le rouge a remplacé l'ambre sur le bouton destructif pour des
raisons de contraste (≥4.5:1 en clair comme en sombre).
- Ne pas dériver la palette dans un seul dépôt : `tokens.css` doit rester
identique partout.
- Toute nouvelle couleur doit être lisible **comme texte** sur le fond
d'application ET comme fond avec un texte posé dessus. Vérifier les deux cas.
## Typographies
Chargées en local (`frontend/shared/fonts/*.woff2`), jamais par CDN :
| Usage | Police |
| --- | --- |
| Texte courant | Poppins 400/600 |
| Titres display | Orbitron, Cinzel |
| Code / monospace | JetBrains Mono |
## Composants
`@cohaise/ui` expose `Button`, `Card` (+ sous-composants), `Input`, `Skeleton`,
`Spinner` et l'utilitaire `cn`.
- Un composant partagé ne doit pas connaître le métier d'une app.
- Une variante visuelle propre à une app se développe **dans cette app**, pas
dans `frontend/shared`.
- `Skeleton` et `Spinner` sont prévus pour les états de chargement ; ne pas
réinventer un spinner.
## Thème
- Bascule clair/sombre par la classe `.dark` sur `<html>`.
- Script inline dans `index.html` (avant le bundle) : lit
`localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`. C'est lui qui
évite le flash de thème.
- `color-scheme: light dark` déclaré pour les contrôles natifs.
- Toute règle sombre va dans le bloc `.dark` de `tokens.css`, pas en
`@media (prefers-color-scheme: dark)` : la préférence utilisateur prime.
## Git
- Branche `main` unique, remote `origin` sur `git.cohaise.dev`.
- Pas de convention de message imposée par l'historique (dépôt neuf).
- N'exclure de git que : `.env*` (sauf `.env.example`), `node_modules/`,
`dist/`, `*.log`, `backups/`.
- `docs/` est **versionné** (la ligne `docs/` de `.gitignore` a été retirée).
## Interdépôts
| Élément | Attendu |
| --- | --- |
| `frontend/shared/src/styles/tokens.css` | identique (même `md5sum`) |
| Composants `@cohaise/ui` | dupliqués, **peuvent diverger** |
| Ports | web `8080`, CRM `8082`, Cloud `8083` |
| Remotes | un dépôt Git autonome par app, aucun lien de code entre eux |
+78
View File
@@ -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.