deploy / deploy (push) Successful in 1m24s
rebuild the public site on the Next.js App Router with static export, per-section SEO pages, metadata, sitemap, robots and a generated OG image add full-screen scroll-snap regions, staged scroll reveals, a hash-free tab navigation with a sliding indicator and region-by-region menu scrolling replace the theme text toggle with animated sun/moon icons restructure the CRM API into config, middleware, models, routes, services and utils layers redesign the CRM shell with a single surface, tab rail, full-width blurred DataTable, record dialogs and mask-based icons update Docker/Nginx publishing, Makefile targets, shared UI polish and docs Co-authored-by: Gitea Actions <-[email protected]>
86 lines
3.4 KiB
Markdown
86 lines
3.4 KiB
Markdown
# Workflow — CoHaiSe Web
|
|
|
|
## Boucle de développement
|
|
|
|
```sh
|
|
make dev # Next.js sur http://localhost:3000, hot reload
|
|
```
|
|
|
|
Le serveur de dev sert `frontend/web` avec Next.js. Il n'a pas besoin de Docker
|
|
ni de `.env`. Pour tester le formulaire de contact, l'API CRM doit tourner sur
|
|
`http://localhost:8082` (ou définir `NEXT_PUBLIC_CRM_API_URL`).
|
|
|
|
## 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/app/**` |
|
|
| Routes et métadonnées SEO | `frontend/web/app/*/page.tsx`, `frontend/web/app/lib/site.ts` |
|
|
| Sitemap / robots / image OG | `frontend/web/app/sitemap.ts`, `robots.ts`, `opengraph-image.tsx` |
|
|
| Animations d'entrée | `frontend/web/app/hooks/useScrollReveal.ts` + `globals.css` |
|
|
| Cache, en-têtes, 404 | `docker/nginx/web.conf` + `docker/nginx/snippets/` |
|
|
| Port public | `COHAISE_HTTP_PORT` dans `.env` |
|
|
| Thème par défaut | script inline de `frontend/web/app/layout.tsx` |
|
|
|
|
## 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/`, `out/`, `.next/`
|
|
(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 avec le reste** : il est consommé par
|
|
`backend/crm`, mais une erreur de types ici bloque aussi `npm run typecheck`.
|
|
3. **`docker/README.md` historique** : ne sert que les images ; le
|
|
fonctionnement réel est dans `docs/deployment.md`.
|
|
4. **Export statique** : `next build` écrit dans `out/`, pas `dist/`. Ne pas
|
|
ajouter de route dynamique sans vérifier la compatibilité avec
|
|
`output: "export"`.
|
|
5. **Pas d'ESLint** : `typescript-eslint` ne supporte pas TypeScript 7.0. Seuls
|
|
`typecheck` et `build` vérifient le code.
|