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]>
This commit was merged in pull request #1.
This commit is contained in:
+76
-4
@@ -13,8 +13,10 @@ Conventions à respecter pour que ce dépôt reste cohérent avec les deux autre
|
||||
| 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.
|
||||
Aucun Prettier n'est installé : l'éditeur et l'`.editorconfig` sont la seule
|
||||
norme mécanique. ESLint a été retiré de `frontend/web` : `typescript-eslint`
|
||||
ne supporte pas encore TypeScript 7.0. Ne pas le réintroduire tant que ce
|
||||
support n'existe pas.
|
||||
|
||||
## Palette
|
||||
|
||||
@@ -62,19 +64,89 @@ Chargées en local (`frontend/shared/fonts/*.woff2`), jamais par CDN :
|
||||
## Thème
|
||||
|
||||
- Bascule clair/sombre par la classe `.dark` sur `<html>`.
|
||||
- Script inline dans `index.html` (avant le bundle) : lit
|
||||
- Script inline dans `frontend/web/app/layout.tsx` (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.
|
||||
|
||||
## Next.js (vitrine)
|
||||
|
||||
- Tout fichier qui utilise un hook, un événement ou une API navigateur porte
|
||||
`"use client"` ; les pages et le layout restent des Server Components.
|
||||
- Les métadonnées SEO vont dans `export const metadata` (page ou layout), pas
|
||||
dans un composant client. Une page = une entrée dans `app/lib/site.ts` pour
|
||||
rester alignée avec le sitemap.
|
||||
- Les données statiques vivent dans `app/data/`. Un objet contenant des
|
||||
fonctions ou des icônes React ne doit jamais traverser la frontière
|
||||
serveur → client : le composant importe la donnée lui-même.
|
||||
- Une section = une région plein écran : `<Section>` pose `data-region` et
|
||||
`min-h-dvh`. Ne pas créer de section hors de ce composant, sinon elle
|
||||
échappe au scroll-snap.
|
||||
- Les reveals passent par `data-reveal` / `data-reveal-delay` et
|
||||
`useScrollReveal` (délai par région via `data-region-delay`) ; ne pas
|
||||
animer un élément sans prévoir son état sans JS.
|
||||
- `next build` produit `out/` (`output: "export"`). Ne pas ajouter de route
|
||||
dynamique sans vérifier la compatibilité avec l'export statique.
|
||||
- Le menu de l'en-tête est une barre d'onglets, pas une liste d'ancres : aucun
|
||||
`#` n'est écrit dans l'URL. Sur l'accueil, clic → séquence GSAP région par
|
||||
région et pastille qui glisse vers l'onglet ; ailleurs, la cible passe par
|
||||
`setPendingSection`/`sessionStorage` puis est rejointe après le retour à `/`.
|
||||
`scrollToSection` suspend le snap (`data-scroll-anim`) le temps de la
|
||||
séquence, sinon le navigateur saute directement à la destination ; la durée
|
||||
renvoyée prolonge le verrou d'onglet. L'onglet actif suit la région visible
|
||||
(bande centrale) sauf pendant le défilement déclenché par un clic, où il
|
||||
reste sur l'entrée choisie. Une cible imbriquée (About dans la région Stack)
|
||||
est ramenée à sa région par `scrollToSection`, car le snap opère par région.
|
||||
- Les pages SEO autonomes (`/services`, `/about`, …) réutilisent une seule
|
||||
région sans pied de page et tiennent dans le viewport (règle
|
||||
`section[data-region]:only-child` dans `globals.css`). Ne pas les laisser
|
||||
défiler : le menu est justement là pour ramener aux régions de l'accueil.
|
||||
|
||||
## Front CRM
|
||||
|
||||
- La page ne défile **jamais** : le shell est en `h-dvh overflow-hidden`, et les
|
||||
zones de contenu (`DataTable`, dialogue) portent `min-h-0` + `overflow-auto`.
|
||||
Ne pas retirer `min-h-0` d'un parent flex, sinon le tableau repousse la page.
|
||||
- Toute liste passe par `components/DataTable.tsx` : colonnes triables,
|
||||
recherche, actions de ligne, squelette et cartes sous `md`. Ne pas recréer un
|
||||
`<table>` dans une page.
|
||||
- Les formulaires de création/édition passent par `RecordDialog` ; seul son
|
||||
corps défile. Les boutons d'action de ligne utilisent `RowActionButton`.
|
||||
- Les pictogrammes viennent des WebP du dépôt, rendus par `MaskIcon` dans
|
||||
`components/icons.tsx` : `FolderMaskIcon`/`UsersMaskIcon`/`ActivityMaskIcon`
|
||||
pour le rail, `PenMaskIcon`, `TrashMaskIcon`, `SearchMaskIcon`,
|
||||
`CloseMaskIcon`, `LogoutMaskIcon` pour les actions. Le masque CSS +
|
||||
`background-color: currentColor` permet au survol de les teinter en accent ou
|
||||
en destructif sans filtre. Ne pas revenir à un `<img>` : les fichiers sont
|
||||
blancs et disparaîtraient sur fond clair. `components/glyphs.tsx` ne garde que
|
||||
les flèches (`ChevronDownGlyph`, `ArrowUpGlyph`).
|
||||
- L'en-tête du CRM porte `.glass` (défini dans `theme.css`, commun à la vitrine
|
||||
et au CRM) ; la surface de travail reste sans flou et `DataTable` porte son
|
||||
propre fond translucide (`bg-surface/80 backdrop-blur-xl`), avec un en-tête
|
||||
sticky à `/90` pour garder le texte lisible quand les lignes passent dessous.
|
||||
- Les champs (`Input` partagé, selects, recherche) réagissent au survol par un
|
||||
bord accent ; le bouton de déconnexion est une icône seule
|
||||
(`LogoutMaskIcon`) avec `aria-label` et `title`, jamais un libellé visible.
|
||||
|
||||
## Backend CRM
|
||||
|
||||
- Une route valide l'entrée (Zod), appelle un service, renvoie le statut HTTP.
|
||||
Aucune requête SQL directement dans `routes/`.
|
||||
- Un service reçoit `db` et des données déjà typées ; il lève `AppError` pour
|
||||
les cas métier (404, 409, 422) et laisse remonter le reste.
|
||||
- Les noms de colonnes SQL restent dans les services et `models/types.ts` ;
|
||||
l'API expose ses propres champs.
|
||||
- Les erreurs de contrainte MariaDB passent par `utils/dbErrors.ts` (1062,
|
||||
1451, 1452), jamais par une comparaison de message.
|
||||
|
||||
## 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/`.
|
||||
`dist/`, `.next/`, `out/`, `*.log`, `backups/`.
|
||||
- `docs/` est **versionné** (la ligne `docs/` de `.gitignore` a été retirée).
|
||||
|
||||
## Interdépôts
|
||||
|
||||
Reference in New Issue
Block a user