@@ -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`.
|
||||
@@ -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`.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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 |
|
||||
@@ -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