create-modoock-app 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +52 -0
- package/package.json +21 -0
- package/template/.cursor/agents/code-reviewer.md +25 -0
- package/template/.cursor/rules/agents.mdc +9 -0
- package/template/.cursor/rules/honey.mdc +226 -0
- package/template/.cursor/rules/ui.mdc +18 -0
- package/template/.cursor/skills/debug/SKILL.md +29 -0
- package/template/.dcdignore +3 -0
- package/template/AGENTS.md +89 -0
- package/template/CLAUDE.md +2 -0
- package/template/README.md +339 -0
- package/template/app/(local)/components/page.tsx +886 -0
- package/template/app/(local)/design-system/page.tsx +1140 -0
- package/template/app/(local)/layout.tsx +5 -0
- package/template/app/(local)/page.tsx +59 -0
- package/template/app/auth/layout.tsx +7 -0
- package/template/app/auth/login/page.tsx +76 -0
- package/template/app/favicon.ico +0 -0
- package/template/app/globals.css +365 -0
- package/template/app/layout.tsx +28 -0
- package/template/components/layout/app-layout.tsx +30 -0
- package/template/components/layout/header.tsx +72 -0
- package/template/components/layout/index.ts +3 -0
- package/template/components/layout/side-nav.tsx +163 -0
- package/template/components/shared/detail-header.tsx +39 -0
- package/template/components/shared/index.ts +8 -0
- package/template/components/shared/info-card.tsx +75 -0
- package/template/components/shared/summary-card.tsx +31 -0
- package/template/components/shared/table-section.tsx +38 -0
- package/template/components/shared/timeline-list.tsx +31 -0
- package/template/components/ui/action-stack.tsx +42 -0
- package/template/components/ui/badge.tsx +43 -0
- package/template/components/ui/button.tsx +104 -0
- package/template/components/ui/icon.tsx +78 -0
- package/template/components/ui/index.ts +28 -0
- package/template/components/ui/input.tsx +376 -0
- package/template/components/ui/loader.tsx +78 -0
- package/template/components/ui/metric-bar.tsx +49 -0
- package/template/components/ui/modal.tsx +177 -0
- package/template/components/ui/select.tsx +458 -0
- package/template/components/ui/stepper.tsx +96 -0
- package/template/components/ui/tab.tsx +85 -0
- package/template/components/ui/user-table.tsx +806 -0
- package/template/eslint.config.mjs +18 -0
- package/template/knowledge-base/design-system/components/action-stack.mdc +17 -0
- package/template/knowledge-base/design-system/components/badges.mdc +16 -0
- package/template/knowledge-base/design-system/components/buttons.mdc +21 -0
- package/template/knowledge-base/design-system/components/detail-header.mdc +17 -0
- package/template/knowledge-base/design-system/components/dropdowns.mdc +12 -0
- package/template/knowledge-base/design-system/components/info-list.mdc +17 -0
- package/template/knowledge-base/design-system/components/inputs.mdc +23 -0
- package/template/knowledge-base/design-system/components/menu.mdc +20 -0
- package/template/knowledge-base/design-system/components/modals.mdc +24 -0
- package/template/knowledge-base/design-system/components/selects.mdc +39 -0
- package/template/knowledge-base/design-system/components/stepper.mdc +18 -0
- package/template/knowledge-base/design-system/components/tables.mdc +59 -0
- package/template/knowledge-base/design-system/components/tabs.mdc +17 -0
- package/template/knowledge-base/design-system/components.mdc +91 -0
- package/template/knowledge-base/design-system/tokens.mdc +24 -0
- package/template/knowledge-base/examples/bad/README.md +8 -0
- package/template/knowledge-base/examples/good/README.md +13 -0
- package/template/knowledge-base/metadata/catalog.yaml +245 -0
- package/template/knowledge-base/patterns/components/reuse-existing.mdc +26 -0
- package/template/knowledge-base/patterns/data-fetching/local-data.mdc +20 -0
- package/template/knowledge-base/patterns/layouts/app-shell.mdc +20 -0
- package/template/knowledge-base/patterns/pages/data-table-page.mdc +31 -0
- package/template/knowledge-base/patterns/pages/workflow-page.mdc +27 -0
- package/template/knowledge-base/rules/accessibility/responsive.mdc +31 -0
- package/template/knowledge-base/rules/architecture/layout.mdc +52 -0
- package/template/knowledge-base/rules/architecture/single-screen.mdc +62 -0
- package/template/knowledge-base/rules/code-quality/jsx.mdc +19 -0
- package/template/knowledge-base/rules/global/naming.mdc +12 -0
- package/template/knowledge-base/rules/global/technology.mdc +19 -0
- package/template/knowledge-base/rules/global/ui-copy.mdc +20 -0
- package/template/knowledge-base/rules/performance/client.mdc +20 -0
- package/template/knowledge-base/rules/ui/information-density.mdc +36 -0
- package/template/knowledge-base/rules/ui/interaction.mdc +47 -0
- package/template/knowledge-base/rules/ui/simple-ui.mdc +58 -0
- package/template/knowledge-base/validation/accessibility.mdc +13 -0
- package/template/knowledge-base/validation/architecture.mdc +10 -0
- package/template/knowledge-base/validation/ast-grep/do-what-brooooooklyn-said.yml +15 -0
- package/template/knowledge-base/validation/ast-grep/no-nested-links.yml +12 -0
- package/template/knowledge-base/validation/ast-grep/rewrite-svg-attribute.yml +19 -0
- package/template/knowledge-base/validation/code-quality.mdc +18 -0
- package/template/knowledge-base/validation/performance.mdc +11 -0
- package/template/knowledge-base/validation/ui.mdc +26 -0
- package/template/next.config.ts +21 -0
- package/template/package-lock.json +6938 -0
- package/template/package.json +30 -0
- package/template/postcss.config.mjs +7 -0
- package/template/public/identity/full_logo_black.svg +27 -0
- package/template/public/identity/full_logo_color.svg +38 -0
- package/template/public/identity/full_logo_white.svg +34 -0
- package/template/public/identity/logo_icon_black.svg +6 -0
- package/template/public/identity/logo_icon_color.svg +13 -0
- package/template/public/identity/logo_icon_white.svg +13 -0
- package/template/public/login-hero.png +0 -0
- package/template/sgconfig.yml +11 -0
- package/template/tsconfig.json +43 -0
|
@@ -0,0 +1,339 @@
|
|
|
1
|
+
# Modoock Projects Boilerplate
|
|
2
|
+
|
|
3
|
+
Boilerplate d’application web Modoock : une interface d’entreprise destinée à des utilisateurs peu habitués aux systèmes d’information. Le projet sert à la fois de **socle de développement** (design system, composants réutilisables, règles) et de **démonstration** de plusieurs modules métier, avec des données locales fictives.
|
|
4
|
+
|
|
5
|
+
L’interface est en français. Chaque page métier vise une lecture immédiate : un écran, un objectif, un tableau principal, les détails secondaires dans une fiche ou un onglet.
|
|
6
|
+
|
|
7
|
+
## Objectif
|
|
8
|
+
|
|
9
|
+
Fournir un point de départ cohérent pour construire des applications Modoock :
|
|
10
|
+
|
|
11
|
+
- une identité visuelle unique (tokens, typographie, couleurs) ;
|
|
12
|
+
- des composants d’interface réutilisables, sans HTML brut quand un composant existe déjà ;
|
|
13
|
+
- des pages dashboard sans scroll global sur grand écran ;
|
|
14
|
+
- des règles de développement centralisées dans `knowledge-base/` ;
|
|
15
|
+
- des modules d’exemple (projets, équipements, infrastructure, recherche) pour illustrer les patterns.
|
|
16
|
+
|
|
17
|
+
Il n’y a pas de backend : les listes et fiches s’appuient sur des fichiers de données déterministes dans `app/`.
|
|
18
|
+
|
|
19
|
+
## Stack
|
|
20
|
+
|
|
21
|
+
| Élément | Choix |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| Framework | Next.js 16 (App Router) |
|
|
24
|
+
| UI | React 19, TypeScript 5 |
|
|
25
|
+
| Styles | Tailwind CSS 4, tokens dans `app/globals.css` |
|
|
26
|
+
| Icônes | `lucide-react`, uniquement via le composant `Icon` |
|
|
27
|
+
| Police | Montserrat (`next/font`) |
|
|
28
|
+
| Qualité | ESLint (`eslint-config-next`) |
|
|
29
|
+
|
|
30
|
+
Les versions exactes sont dans `package.json`. Aucune autre librairie d’icônes ou d’animation n’est prévue.
|
|
31
|
+
|
|
32
|
+
## Démarrage
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npm install
|
|
36
|
+
npm run dev
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Ouvrir [http://localhost:3000](http://localhost:3000).
|
|
40
|
+
|
|
41
|
+
Autres commandes :
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
npm run lint # ESLint
|
|
45
|
+
npm run typecheck # TypeScript, dont props JSX
|
|
46
|
+
npm run sg:scan # faits structurels
|
|
47
|
+
npm run build # build de production
|
|
48
|
+
npm run start # serveur de production
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Architecture
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
app/ Pages (App Router) et données de démonstration
|
|
55
|
+
components/
|
|
56
|
+
ui/ Composants génériques du Design System
|
|
57
|
+
layout/ Structure de l’application (header, menu, layout)
|
|
58
|
+
shared/ Blocs métier réutilisés par plusieurs pages
|
|
59
|
+
knowledge-base/
|
|
60
|
+
rules/ Contraintes (global, architecture, ui, accessibility)
|
|
61
|
+
patterns/ Comment le repo résout une classe de problème
|
|
62
|
+
examples/ Exemples good/ et bad/
|
|
63
|
+
design-system/ Tokens et contraintes de composants
|
|
64
|
+
validation/ Comment détecter une violation
|
|
65
|
+
metadata/ catalog.yaml — index de charge (load, open, description)
|
|
66
|
+
.cursor/rules/ agents.mdc (pointeur vers AGENTS.md), honey.mdc (style), ui.mdc (rappel Cursor)
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Chaque dossier de composants expose son API publique dans un `index.ts`. Les pages importent depuis ces index, pas depuis les fichiers internes.
|
|
70
|
+
|
|
71
|
+
### Layout
|
|
72
|
+
|
|
73
|
+
`AppLayout` entoure toute l’application :
|
|
74
|
+
|
|
75
|
+
- **SideNav** : menu latéral bleu (couleur primaire), repliable (icônes seules / icônes + libellés).
|
|
76
|
+
- **Header** : titre de page, description éventuelle, retour arrière et actualisation.
|
|
77
|
+
|
|
78
|
+
Sur `md+`, les pages dashboard et fiche restent dans la hauteur de l’écran : le tableau ou les cartes défilent à l’intérieur. Sous `md`, le scroll de page est autorisé et les tableaux deviennent des cartes empilées.
|
|
79
|
+
|
|
80
|
+
## Modules
|
|
81
|
+
|
|
82
|
+
| Route | Module | Rôle |
|
|
83
|
+
| --- | --- | --- |
|
|
84
|
+
| `/` | Dashboard | Vitrine des champs, boutons, icônes, loaders et d’un tableau d’exemple |
|
|
85
|
+
| `/projects` | Projets | Portefeuille : recherche, filtres, synthèse, tableau, fiche `/projects/[id]` |
|
|
86
|
+
| `/equipment` | Équipements | Parc (ex. médical) : statuts, maintenance, fiche avec onglets |
|
|
87
|
+
| `/infrastructure` | Infrastructure | Catalogue de services : métriques, filtres, actions groupées, fiche service |
|
|
88
|
+
| `/infrastructure/incidents` | Incidents | Incidents liés aux services, fiche avec timeline |
|
|
89
|
+
| `/research` | Recherche | Expériences, datasets, runs, événements, comparaison de métriques |
|
|
90
|
+
| `/tables` | Tables | Quatre attitudes de tableau (Sprinter, Analyste, Focus, À la une) |
|
|
91
|
+
| `/design-system` | Design System | Documentation visuelle des tokens et composants |
|
|
92
|
+
|
|
93
|
+
### Projets
|
|
94
|
+
|
|
95
|
+
Vue globale du portefeuille (environ 300 projets générés de façon déterministe). Statut, priorité, équipe, chef de projet, avancement, échéance, budget, tâches et activité récente. La fiche détaille l’équipe, les dates, l’avancement et le budget, plus l’historique d’activité.
|
|
96
|
+
|
|
97
|
+
### Équipements
|
|
98
|
+
|
|
99
|
+
Suivi d’un parc : opérationnel, maintenance, intervention urgente, hors service. La fiche regroupe informations, incidents, interventions et historique de maintenance.
|
|
100
|
+
|
|
101
|
+
### Infrastructure et incidents
|
|
102
|
+
|
|
103
|
+
Services (environnement, région, type, équipe, CPU, mémoire, latence, erreurs, déploiements). Sélection multiple, export CSV et actions simulées (redémarrage, coupure du monitoring). Les incidents ont gravité, statut, impact et historique.
|
|
104
|
+
|
|
105
|
+
### Recherche
|
|
106
|
+
|
|
107
|
+
Expériences par domaine (vision, NLP, robotique, IA générative, bioinformatique, climat), avec datasets, runs et événements. Un onglet compare les métriques de plusieurs expériences.
|
|
108
|
+
|
|
109
|
+
## Flux du contexte (règles, composants, code)
|
|
110
|
+
|
|
111
|
+
Le projet ne se pilote pas depuis `app/`. On travaille dans un **contexte** : une demande, des règles, un catalogue de composants, des tokens. `app/` n’est que le banc de test de cette chaîne.
|
|
112
|
+
|
|
113
|
+
Les règles restent dans `knowledge-base/`. Elles ne sont **pas** déplacées vers `.cursor/rules/` : Cursor, Claude, Codex et Copilot suivent le **même** index (`catalog.yaml`) et le **même** routeur.
|
|
114
|
+
|
|
115
|
+
### Qui fait quoi
|
|
116
|
+
|
|
117
|
+
| Pièce | Rôle | On y va pour… |
|
|
118
|
+
| --- | --- | --- |
|
|
119
|
+
| Demande (prompt) | Périmètre | **Quoi** faire, rien de plus |
|
|
120
|
+
| `knowledge-base/` | Texte des règles | **Comment** le faire |
|
|
121
|
+
| `knowledge-base/metadata/catalog.yaml` | Index de charge | **Quel fichier** ouvrir, et avec quoi |
|
|
122
|
+
| `AGENTS.md` | Routeur canonique | Procédure de charge, pas les règles |
|
|
123
|
+
| `CLAUDE.md` | Import Claude Code | `@AGENTS.md` et `@.cursor/rules/honey.mdc` — ne pas y recopier le texte |
|
|
124
|
+
| `.cursor/rules/agents.mdc` | Pointeur Cursor | Follow `AGENTS.md` — ne pas y recopier le routeur |
|
|
125
|
+
| `.cursor/rules/ui.mdc` | Rappel Cursor (glob UI) | Même procédure que le routeur |
|
|
126
|
+
| `.cursor/rules/honey.mdc` | Style d’écriture (tous les agents, un fichier) | Moins de code, moins de prose — ne pas recopier ni découper |
|
|
127
|
+
| `components/*/index.ts` | Ce qui existe | Réutiliser l’export ; pas de `.mdc` obligatoire |
|
|
128
|
+
| `knowledge-base/design-system/components/*.mdc` | Règles particulières | Seulement si le catalog les liste |
|
|
129
|
+
| `knowledge-base/validation/` + `ast-grep/` | Détection | Comment échouer ; `npm run sg:scan` |
|
|
130
|
+
| `app/globals.css` | Tokens | Pas de valeur visuelle en dur |
|
|
131
|
+
|
|
132
|
+
Codex / Copilot / Cursor lisent `AGENTS.md` (Always = ouvrir `honey.mdc` s’il n’est pas déjà en contexte). Claude Code lit `CLAUDE.md`, qui importe `@AGENTS.md` et `@.cursor/rules/honey.mdc`. Cursor injecte `honey.mdc` (always-on) et `agents.mdc` (pointeur) ; `ui.mdc` si un `.tsx` d’`app/` ou `components/` est ouvert. Ne pas recopier le routeur ni Honey.
|
|
133
|
+
|
|
134
|
+
### Schéma global
|
|
135
|
+
|
|
136
|
+
```
|
|
137
|
+
USER TASK
|
|
138
|
+
│
|
|
139
|
+
▼
|
|
140
|
+
AGENTS.md ← routeur canonique
|
|
141
|
+
▲
|
|
142
|
+
├── CLAUDE.md (@AGENTS.md) ← Claude Code
|
|
143
|
+
└── .cursor/rules/agents.mdc ← pointeur Cursor
|
|
144
|
+
│
|
|
145
|
+
▼
|
|
146
|
+
catalog.yaml ← index unique
|
|
147
|
+
│
|
|
148
|
+
├── load: ui ──► path (socle à chaque edit UI)
|
|
149
|
+
├── description match ──► path (à la demande)
|
|
150
|
+
└── open: ──► paths liés (graphe du pattern / de la règle)
|
|
151
|
+
│
|
|
152
|
+
▼
|
|
153
|
+
knowledge-base/**/*.mdc + components/*/index.ts ← contraintes + API réelle
|
|
154
|
+
│
|
|
155
|
+
▼
|
|
156
|
+
CODE
|
|
157
|
+
│
|
|
158
|
+
├── npm run lint → ESLint
|
|
159
|
+
├── npm run typecheck → TypeScript (props JSX = type public)
|
|
160
|
+
├── npm run sg:scan → faits structurels prouvables (reste stupide)
|
|
161
|
+
├── validation/*.mdc → Design System / UX / architecture
|
|
162
|
+
└── agent → contexte et jugement
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### 1. Routeur multi-agents
|
|
166
|
+
|
|
167
|
+
`AGENTS.md` est la seule copie de la procédure. `CLAUDE.md` l’importe (`@AGENTS.md`) et importe Honey. `agents.mdc` pointe vers `AGENTS.md` (le pied Next.js de `AGENTS.md` ne se copie pas).
|
|
168
|
+
|
|
169
|
+
```
|
|
170
|
+
Codex / Copilot Claude Cursor
|
|
171
|
+
│ │ │
|
|
172
|
+
▼ ▼ ▼
|
|
173
|
+
AGENTS.md CLAUDE.md AGENTS.md
|
|
174
|
+
+ open honey.mdc @AGENTS.md + honey.mdc (injecté)
|
|
175
|
+
@honey.mdc + agents.mdc (pointeur)
|
|
176
|
+
│ │ │
|
|
177
|
+
└────────────┬───────┴──────────────────────┘
|
|
178
|
+
▼
|
|
179
|
+
catalog.yaml
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
Honey : un fichier, tous les agents, pas de copie, pas de découpage. Cursor l’injecte ; Codex / Copilot l’ouvrent (Always) ; Claude Code l’importe. Cursor seulement : `ui.mdc` (glob UI) = rappel de charge, pas un 2ᵉ rulebook.
|
|
183
|
+
|
|
184
|
+
Honey n’est **pas** généré (`skills/honey/SKILL.md` / `scripts/build-rules.js` n’existent pas). On l’édite dans `.cursor/rules/honey.mdc`.
|
|
185
|
+
|
|
186
|
+
### 2. Catalog — schéma d’une entrée
|
|
187
|
+
|
|
188
|
+
`knowledge-base/metadata/catalog.yaml` : sections `files`, `patterns`, `validation`.
|
|
189
|
+
|
|
190
|
+
```yaml
|
|
191
|
+
# files: / patterns:
|
|
192
|
+
- path: knowledge-base/…/exemple.mdc # obligatoire — chemin exact
|
|
193
|
+
description: … # match à la demande
|
|
194
|
+
load: ui # optionnel — socle UI
|
|
195
|
+
open: # optionnel — graphe de charge
|
|
196
|
+
- knowledge-base/…/autre.mdc
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
| Champ | Effet |
|
|
200
|
+
| --- | --- |
|
|
201
|
+
| `path` | Fichier à ouvrir (nom exact : `tabs.mdc`, pas `tab.mdc`) |
|
|
202
|
+
| `description` | Si elle matche le besoin → ouvrir `path` |
|
|
203
|
+
| `load: ui` | Edit `app/**` ou `components/**` → ouvrir `path` sans matcher |
|
|
204
|
+
| `open:` | Après `path`, ouvrir aussi ces fichiers (ne pas y recopier les règles) |
|
|
205
|
+
|
|
206
|
+
Sans `load` : à la demande seulement. `alwaysApply` / `globs` dans le catalog sont des métadonnées ; **seul** `.cursor/rules/` injecte dans Cursor.
|
|
207
|
+
|
|
208
|
+
**Socle actuel** (`load: ui`) : `components.mdc`, `tokens.mdc`, `simple-ui.mdc`, `layout.mdc`.
|
|
209
|
+
|
|
210
|
+
**Graphe actuel** (`open:`) :
|
|
211
|
+
|
|
212
|
+
```
|
|
213
|
+
data-table-page.mdc ──open──► tables.mdc
|
|
214
|
+
workflow-page.mdc ──open──► stepper.mdc
|
|
215
|
+
action-stack.mdc
|
|
216
|
+
detail-header.mdc
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
(`layout.mdc` et `components.mdc` sont déjà `load: ui`, pas besoin de les re-lister.)
|
|
220
|
+
|
|
221
|
+
### 3. Découverte des composants
|
|
222
|
+
|
|
223
|
+
```
|
|
224
|
+
CODE KNOWLEDGE BASE
|
|
225
|
+
components/*/index.ts design-system/components/*.mdc
|
|
226
|
+
│ │
|
|
227
|
+
▼ ▼
|
|
228
|
+
« qu’est-ce qui existe ? » « quelles règles en plus ? »
|
|
229
|
+
Icon, Loader, TimelineList… seulement si catalog.yaml liste le fichier
|
|
230
|
+
pas de .mdc obligatoire
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
Règle écrite une fois : `knowledge-base/design-system/components.mdc` (`## Discovery`). Pas de `.mdc` = on utilise l’export, on n’invente pas un wrapper.
|
|
234
|
+
|
|
235
|
+
### 4. Couches de charge (tous les agents)
|
|
236
|
+
|
|
237
|
+
```
|
|
238
|
+
Toujours → routeur + honey.mdc
|
|
239
|
+
Edit UI → catalog load: ui + index.ts
|
|
240
|
+
Besoin → catalog description → path → open:
|
|
241
|
+
Après code → knowledge-base/validation/ (fichier du thème) ; code-reviewer sur le diff
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
### 5. Découpe d’un module (page liste)
|
|
245
|
+
|
|
246
|
+
Pattern `knowledge-base/patterns/pages/data-table-page.mdc` :
|
|
247
|
+
|
|
248
|
+
```
|
|
249
|
+
/entité → une liste, une entité
|
|
250
|
+
/entité/[id] → le lié (incidents, runs, events…)
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
Interdit : plusieurs listes d’entités sur la page liste (onglets ou non). Good : `/projects` + `/projects/[id]`. Fail : `knowledge-base/validation/ui.mdc`.
|
|
254
|
+
|
|
255
|
+
### 6. Ajouter une règle plus tard
|
|
256
|
+
|
|
257
|
+
Le texte va dans un `.mdc` sous `knowledge-base/`. **Proposer d’abord** (New rules), attendre le oui.
|
|
258
|
+
|
|
259
|
+
| Cas | Fichiers à toucher |
|
|
260
|
+
| --- | --- |
|
|
261
|
+
| Phrase dans une règle déjà listée | Ce `.mdc` seulement |
|
|
262
|
+
| Nouveau fichier de règle | `.mdc` + entrée `catalog.yaml` (`path` + `description`) |
|
|
263
|
+
| Socle à chaque edit UI | + `load: ui` sur cette entrée |
|
|
264
|
+
| Charger avec un pattern | + `open:` sur l’entrée pattern |
|
|
265
|
+
| Composant, API suffisante | Export `index.ts` seulement |
|
|
266
|
+
| Composant + règles particulières | `.mdc` + entrée catalog (sans `load: ui`) |
|
|
267
|
+
| Fail structurel prouvable | YAML dans `validation/ast-grep/` (`sg:scan` reste stupide) |
|
|
268
|
+
| Fail DS / UX / architecture | + ligne dans `validation/*.mdc` |
|
|
269
|
+
| Changer la **procédure** de charge | `AGENTS.md` seulement (`ui.mdc` s’il répète). Ne pas recopier dans `CLAUDE.md` / `agents.mdc` |
|
|
270
|
+
|
|
271
|
+
On ne recopie pas la table besoin → fichier dans le README ni dans le routeur.
|
|
272
|
+
|
|
273
|
+
### Comment interagir avec ce contexte
|
|
274
|
+
|
|
275
|
+
**Avant d’écrire :**
|
|
276
|
+
|
|
277
|
+
1. Lire la demande telle quelle — ne pas l’étendre.
|
|
278
|
+
2. Inspecter le code déjà là (composants et usages).
|
|
279
|
+
3. Ouvrir `catalog.yaml` : tous les `load: ui` si edit UI ; puis les `description` qui matchent ; puis chaque `open:`.
|
|
280
|
+
4. Lire `components/*/index.ts` — c’est le catalogue réel.
|
|
281
|
+
5. Réutiliser : export existant → pattern → composition. Primitive Design System nouvelle / dépendance / token / archi globale → question au développeur (format AGENTS.md). Ne pas cacher la primitive dans la page.
|
|
282
|
+
|
|
283
|
+
**Pendant :**
|
|
284
|
+
|
|
285
|
+
- Chaque décision vient de la demande ou d’une règle existante.
|
|
286
|
+
- Plusieurs options → question, partie en pause.
|
|
287
|
+
- Ne pas inventer une règle, ne pas modifier `knowledge-base/` sans accord.
|
|
288
|
+
- Cas récurrent non couvert → proposer une règle et son `path` catalog, attendre.
|
|
289
|
+
|
|
290
|
+
**Après :**
|
|
291
|
+
|
|
292
|
+
- Contrôler via `knowledge-base/validation/` du thème.
|
|
293
|
+
- Nouvel export → `index.ts` du dossier.
|
|
294
|
+
- `npm run lint`, `npm run typecheck` et `npm run sg:scan` (corriger les **error**). Typecheck prouve que les props JSX existent sur le type du composant.
|
|
295
|
+
- Signaler hypothèses et choix encore ouverts.
|
|
296
|
+
|
|
297
|
+
## Composants
|
|
298
|
+
|
|
299
|
+
### UI (`components/ui/`)
|
|
300
|
+
|
|
301
|
+
`ClickableButton`, `Input`, `Textarea`, `Badge`, `UserTable`, `Select` / `MultiSelect` / `SelectFilter`, `Modal`, `Tabs`, `Icon`, `Loader`, `MetricBar`.
|
|
302
|
+
|
|
303
|
+
`UserTable` gère tri, pagination, message vide, transposition, et sous `md` le passage tableau → cartes (toutes les colonnes restent accessibles).
|
|
304
|
+
|
|
305
|
+
### Shared (`components/shared/`)
|
|
306
|
+
|
|
307
|
+
`SummaryCard` (chiffre clé), `InfoCard` / `InfoList` (fiches détail), `TableSection`, `TimelineList`.
|
|
308
|
+
|
|
309
|
+
### Layout (`components/layout/`)
|
|
310
|
+
|
|
311
|
+
`AppLayout`, `Header`, `SideNav`.
|
|
312
|
+
|
|
313
|
+
Avant d’ajouter un composant, consulter ces `index.ts`. Un composant Design System nouveau demande une validation. Une page qui suit un pattern existant, non.
|
|
314
|
+
|
|
315
|
+
## Design System
|
|
316
|
+
|
|
317
|
+
Les tokens vivent dans `app/globals.css` : couleurs (primary bleu, success, warning, danger, info, accent), typographie, espacements, rayons.
|
|
318
|
+
|
|
319
|
+
- L’orange / jaune est réservé aux alertes critiques, jamais comme couleur décorative.
|
|
320
|
+
- Les pages ne redéfinissent pas de couleurs, tailles ou espacements déjà tokenisés.
|
|
321
|
+
- La page `/design-system` documente le langage visuel.
|
|
322
|
+
|
|
323
|
+
## Données
|
|
324
|
+
|
|
325
|
+
Chaque module métier a un fichier `*-data.ts` à côté de ses pages. Les jeux volumineux (projets, infrastructure, incidents) sont générés avec une **graine fixe** pour rester identiques entre serveur et client.
|
|
326
|
+
|
|
327
|
+
Il n’y a pas d’API, d’authentification ni de persistance : les actions (export, redémarrage, etc.) sont simulées dans le navigateur.
|
|
328
|
+
|
|
329
|
+
## Conventions de développement
|
|
330
|
+
|
|
331
|
+
`knowledge-base/` est la source de vérité. Charge et index : section **Flux du contexte** ci-dessus (`catalog.yaml` : `load`, `description`, `open:`).
|
|
332
|
+
|
|
333
|
+
Principes appliqués au quotidien :
|
|
334
|
+
|
|
335
|
+
- textes d’interface en français, vocabulaire direct ;
|
|
336
|
+
- une page liste = une entité ; le lié va sur `/[id]` ;
|
|
337
|
+
- un seul tableau visible à la fois ;
|
|
338
|
+
- pas de nouvelle dépendance, couleur, composant Design System ou convention sans poser la question ; si oui, implémenter ;
|
|
339
|
+
- code minimal : rien « au cas où ».
|