@atlashub/smartstack-cli 1.13.2 → 1.14.1

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.
Files changed (214) hide show
  1. package/.documentation/agents.html +1 -1
  2. package/.documentation/apex.html +1 -1
  3. package/.documentation/business-analyse.html +1 -1
  4. package/.documentation/cli-commands.html +3 -3
  5. package/.documentation/commands.html +1 -1
  6. package/.documentation/efcore.html +1 -1
  7. package/.documentation/gitflow.html +231 -236
  8. package/.documentation/hooks.html +1 -1
  9. package/.documentation/index.html +1 -1
  10. package/.documentation/init.html +3 -3
  11. package/.documentation/installation.html +1075 -351
  12. package/.documentation/ralph-loop.html +1 -1
  13. package/.documentation/test-web.html +1 -1
  14. package/README.md +88 -20
  15. package/config/default-config.json +10 -1
  16. package/dist/index.js +276 -85
  17. package/dist/index.js.map +1 -1
  18. package/package.json +1 -1
  19. package/templates/agents/code-reviewer.md +163 -0
  20. package/templates/agents/efcore/db-deploy.md +25 -7
  21. package/templates/agents/efcore/db-reset.md +31 -10
  22. package/templates/agents/efcore/db-status.md +22 -5
  23. package/templates/agents/efcore/migration.md +70 -20
  24. package/templates/agents/gitflow/cleanup.md +8 -1
  25. package/templates/agents/gitflow/commit.md +7 -5
  26. package/templates/agents/gitflow/finish.md +6 -4
  27. package/templates/agents/gitflow/pr.md +8 -1
  28. package/templates/agents/gitflow/start.md +1 -1
  29. package/templates/commands/check-version.md +267 -0
  30. package/templates/commands/efcore/_shared.md +31 -2
  31. package/templates/commands/efcore/db-reset.md +18 -6
  32. package/templates/commands/efcore/migration.md +1 -1
  33. package/templates/commands/efcore/rebase-snapshot.md +1 -1
  34. package/templates/commands/efcore/squash.md +1 -0
  35. package/templates/commands/refactor.md +164 -0
  36. package/templates/project/DependencyInjection.Application.cs.template +25 -0
  37. package/templates/project/DependencyInjection.Infrastructure.cs.template +61 -0
  38. package/templates/project/DesignTimeExtensionsDbContextFactory.cs.template +70 -0
  39. package/templates/project/ExampleEntity.cs.template +116 -0
  40. package/templates/project/ExampleEntityConfiguration.cs.template +64 -0
  41. package/templates/project/ExampleService.cs.template +146 -0
  42. package/templates/project/ExtensionsDbContext.cs.template +41 -0
  43. package/templates/project/IExtensionsDbContext.cs.template +22 -0
  44. package/templates/project/Program.cs.template +47 -0
  45. package/templates/project/README.md +79 -0
  46. package/templates/ralph/README.md +10 -8
  47. package/templates/ralph/ralph.config.yaml +2 -2
  48. package/templates/skills/_shared.md +44 -44
  49. package/templates/skills/ai-prompt/SKILL.md +55 -55
  50. package/templates/skills/apex/SKILL.md +235 -0
  51. package/templates/skills/apex/steps/step-00-init.md +203 -0
  52. package/templates/skills/apex/steps/step-01-analyze.md +210 -0
  53. package/templates/skills/apex/steps/step-02-plan.md +217 -0
  54. package/templates/skills/apex/steps/step-03-execute.md +178 -0
  55. package/templates/skills/apex/steps/step-04-validate.md +217 -0
  56. package/templates/skills/apex/steps/step-05-examine.md +207 -0
  57. package/templates/skills/apex/steps/step-06-resolve.md +181 -0
  58. package/templates/skills/apex/steps/step-07-tests.md +206 -0
  59. package/templates/skills/apex/steps/step-08-run-tests.md +207 -0
  60. package/templates/skills/apex/templates/00-context.md +46 -0
  61. package/templates/skills/apex/templates/01-analyze.md +63 -0
  62. package/templates/skills/apex/templates/02-plan.md +63 -0
  63. package/templates/skills/apex/templates/03-execute.md +34 -0
  64. package/templates/skills/apex/templates/04-validate.md +61 -0
  65. package/templates/skills/apex/templates/05-examine.md +58 -0
  66. package/templates/skills/apex/templates/06-resolve.md +39 -0
  67. package/templates/skills/apex/templates/07-tests.md +56 -0
  68. package/templates/skills/apex/templates/08-run-tests.md +41 -0
  69. package/templates/skills/apex/templates/README.md +69 -0
  70. package/templates/skills/application/SKILL.md +50 -50
  71. package/templates/skills/application/templates-backend.md +25 -25
  72. package/templates/skills/application/templates-frontend.md +43 -43
  73. package/templates/skills/application/templates-i18n.md +29 -29
  74. package/templates/skills/application/templates-seed.md +77 -77
  75. package/templates/skills/business-analyse/SKILL.md +223 -0
  76. package/templates/skills/business-analyse/_shared.md +258 -0
  77. package/templates/skills/business-analyse/questionnaire/01-context.md +33 -0
  78. package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +35 -0
  79. package/templates/skills/business-analyse/questionnaire/03-scope.md +35 -0
  80. package/templates/skills/business-analyse/questionnaire/04-data.md +36 -0
  81. package/templates/skills/business-analyse/questionnaire/05-integrations.md +36 -0
  82. package/templates/skills/business-analyse/questionnaire/06-security.md +40 -0
  83. package/templates/skills/business-analyse/questionnaire/07-ui.md +36 -0
  84. package/templates/skills/business-analyse/questionnaire/08-performance.md +35 -0
  85. package/templates/skills/business-analyse/questionnaire/09-constraints.md +35 -0
  86. package/templates/skills/business-analyse/questionnaire/10-documentation.md +35 -0
  87. package/templates/skills/business-analyse/questionnaire.md +177 -177
  88. package/templates/skills/business-analyse/react/components.md +340 -0
  89. package/templates/skills/business-analyse/react/i18n-template.md +245 -0
  90. package/templates/skills/business-analyse/react/schema.md +151 -0
  91. package/templates/skills/business-analyse/steps/step-00-init.md +293 -0
  92. package/templates/skills/business-analyse/steps/step-01-discover.md +267 -0
  93. package/templates/skills/business-analyse/steps/step-02-analyse.md +243 -0
  94. package/templates/skills/business-analyse/steps/step-03-specify.md +317 -0
  95. package/templates/skills/business-analyse/steps/step-04-validate.md +239 -0
  96. package/templates/skills/business-analyse/steps/step-05-handoff.md +336 -0
  97. package/templates/skills/business-analyse/steps/step-06-doc-html.md +261 -0
  98. package/templates/skills/business-analyse/templates/00-context.md +105 -0
  99. package/templates/skills/business-analyse/templates/frd-brd.md +97 -0
  100. package/templates/skills/business-analyse/templates/frd-discovery.md +78 -0
  101. package/templates/skills/business-analyse/templates/frd-handoff.md +118 -0
  102. package/templates/skills/business-analyse/templates/frd-spec.md +168 -0
  103. package/templates/skills/business-analyse/templates-frd.md +217 -217
  104. package/templates/skills/business-analyse/templates-react.md +26 -26
  105. package/templates/skills/controller/SKILL.md +141 -92
  106. package/templates/skills/controller/postman-templates.md +15 -15
  107. package/templates/skills/controller/steps/step-00-init.md +191 -0
  108. package/templates/skills/controller/steps/step-01-analyze.md +146 -0
  109. package/templates/skills/controller/steps/step-02-plan.md +176 -0
  110. package/templates/skills/controller/steps/step-03-generate.md +219 -0
  111. package/templates/skills/controller/steps/step-04-perms.md +219 -0
  112. package/templates/skills/controller/steps/step-05-validate.md +107 -0
  113. package/templates/skills/controller/templates.md +77 -77
  114. package/templates/skills/documentation/SKILL.md +79 -79
  115. package/templates/skills/feature-full/SKILL.md +38 -38
  116. package/templates/skills/gitflow/SKILL.md +277 -0
  117. package/templates/{commands → skills}/gitflow/_shared.md +20 -20
  118. package/templates/skills/gitflow/phases/abort.md +173 -0
  119. package/templates/skills/gitflow/phases/cleanup.md +226 -0
  120. package/templates/skills/gitflow/phases/status.md +178 -0
  121. package/templates/skills/gitflow/steps/step-commit.md +255 -0
  122. package/templates/skills/gitflow/steps/step-finish.md +255 -0
  123. package/templates/skills/gitflow/steps/step-init.md +209 -0
  124. package/templates/skills/gitflow/steps/step-merge.md +225 -0
  125. package/templates/skills/gitflow/steps/step-plan.md +208 -0
  126. package/templates/skills/gitflow/steps/step-pr.md +235 -0
  127. package/templates/skills/gitflow/steps/step-start.md +334 -0
  128. package/templates/skills/gitflow/steps/step-sync.md +200 -0
  129. package/templates/skills/gitflow/templates/config.json +53 -0
  130. package/templates/skills/notification/SKILL.md +51 -51
  131. package/templates/skills/ralph-loop/SKILL.md +228 -0
  132. package/templates/skills/ralph-loop/steps/step-00-init.md +201 -0
  133. package/templates/skills/ralph-loop/steps/step-01-task.md +169 -0
  134. package/templates/skills/ralph-loop/steps/step-02-execute.md +173 -0
  135. package/templates/skills/ralph-loop/steps/step-03-commit.md +170 -0
  136. package/templates/skills/ralph-loop/steps/step-04-check.md +162 -0
  137. package/templates/skills/ralph-loop/steps/step-05-report.md +181 -0
  138. package/templates/skills/review-code/SKILL.md +219 -0
  139. package/templates/skills/review-code/references/clean-code-principles.md +140 -0
  140. package/templates/skills/review-code/references/code-quality-metrics.md +174 -0
  141. package/templates/skills/review-code/references/feedback-patterns.md +149 -0
  142. package/templates/skills/review-code/references/security-checklist.md +127 -0
  143. package/templates/skills/ui-components/SKILL.md +54 -54
  144. package/templates/skills/workflow/SKILL.md +46 -46
  145. package/templates/commands/ai-prompt.md +0 -315
  146. package/templates/commands/apex/1-analyze.md +0 -100
  147. package/templates/commands/apex/2-plan.md +0 -145
  148. package/templates/commands/apex/3-execute.md +0 -171
  149. package/templates/commands/apex/4-examine.md +0 -116
  150. package/templates/commands/apex/5-tasks.md +0 -209
  151. package/templates/commands/apex.md +0 -76
  152. package/templates/commands/application/create.md +0 -362
  153. package/templates/commands/application/templates-backend.md +0 -463
  154. package/templates/commands/application/templates-frontend.md +0 -517
  155. package/templates/commands/application/templates-i18n.md +0 -478
  156. package/templates/commands/application/templates-seed.md +0 -362
  157. package/templates/commands/application.md +0 -303
  158. package/templates/commands/business-analyse/0-orchestrate.md +0 -156
  159. package/templates/commands/business-analyse/1-init.md +0 -99
  160. package/templates/commands/business-analyse/2-discover.md +0 -143
  161. package/templates/commands/business-analyse/3-analyse.md +0 -106
  162. package/templates/commands/business-analyse/4-specify.md +0 -133
  163. package/templates/commands/business-analyse/5-validate.md +0 -132
  164. package/templates/commands/business-analyse/6-handoff.md +0 -157
  165. package/templates/commands/business-analyse/7-doc-html.md +0 -103
  166. package/templates/commands/business-analyse/_shared.md +0 -176
  167. package/templates/commands/business-analyse/bug.md +0 -118
  168. package/templates/commands/business-analyse/change-request.md +0 -144
  169. package/templates/commands/business-analyse/hotfix.md +0 -116
  170. package/templates/commands/business-analyse.md +0 -121
  171. package/templates/commands/controller/create.md +0 -216
  172. package/templates/commands/controller/postman-templates.md +0 -528
  173. package/templates/commands/controller/templates.md +0 -600
  174. package/templates/commands/controller.md +0 -337
  175. package/templates/commands/create/agent.md +0 -138
  176. package/templates/commands/create/command.md +0 -166
  177. package/templates/commands/create/hook.md +0 -234
  178. package/templates/commands/create/plugin.md +0 -329
  179. package/templates/commands/create/project.md +0 -508
  180. package/templates/commands/create/skill.md +0 -199
  181. package/templates/commands/create.md +0 -220
  182. package/templates/commands/documentation/module.md +0 -202
  183. package/templates/commands/documentation/templates.md +0 -432
  184. package/templates/commands/documentation.md +0 -190
  185. package/templates/commands/epct.md +0 -69
  186. package/templates/commands/explain.md +0 -186
  187. package/templates/commands/feature-full.md +0 -267
  188. package/templates/commands/gitflow/1-init.md +0 -188
  189. package/templates/commands/gitflow/10-start.md +0 -190
  190. package/templates/commands/gitflow/11-finish.md +0 -382
  191. package/templates/commands/gitflow/12-cleanup.md +0 -103
  192. package/templates/commands/gitflow/13-sync.md +0 -216
  193. package/templates/commands/gitflow/14-rebase.md +0 -251
  194. package/templates/commands/gitflow/2-status.md +0 -122
  195. package/templates/commands/gitflow/3-commit.md +0 -209
  196. package/templates/commands/gitflow/4-plan.md +0 -174
  197. package/templates/commands/gitflow/5-exec.md +0 -202
  198. package/templates/commands/gitflow/6-abort.md +0 -121
  199. package/templates/commands/gitflow/7-pull-request.md +0 -176
  200. package/templates/commands/gitflow/8-review.md +0 -113
  201. package/templates/commands/gitflow/9-merge.md +0 -157
  202. package/templates/commands/gitflow.md +0 -128
  203. package/templates/commands/implement.md +0 -663
  204. package/templates/commands/init.md +0 -567
  205. package/templates/commands/mcp-integration.md +0 -330
  206. package/templates/commands/notification.md +0 -129
  207. package/templates/commands/oneshot.md +0 -57
  208. package/templates/commands/quickstart.md +0 -154
  209. package/templates/commands/ralph-loop/cancel-ralph.md +0 -18
  210. package/templates/commands/ralph-loop/help.md +0 -126
  211. package/templates/commands/ralph-loop/ralph-loop.md +0 -120
  212. package/templates/commands/review.md +0 -106
  213. package/templates/commands/workflow.md +0 -193
  214. package/templates/gitflow/config.json +0 -138
@@ -1,7 +1,7 @@
1
- # Templates FRD - Business Analyse
1
+ # Templates FRD - Business Analysis
2
2
 
3
- > **Usage:** Templates pour les documents de spécification fonctionnelle (FRD)
4
- > **Contexte:** Business > Application > Module > Section
3
+ > **Usage:** Templates for functional specification documents (FRD)
4
+ > **Context:** Business > Application > Module > Section
5
5
 
6
6
  ---
7
7
 
@@ -13,65 +13,65 @@
13
13
  > **Module:** business/{application}/{module}
14
14
  > **Version:** 1.0
15
15
  > **Date:** {YYYY-MM-DD}
16
- > **Auteur:** Business Analyst
16
+ > **Author:** Business Analyst
17
17
 
18
- ## 1. Contexte Business
18
+ ## 1. Business Context
19
19
 
20
- ### 1.1 Description du besoin
21
- {Description claire du besoin métier exprimé par le stakeholder}
20
+ ### 1.1 Need Description
21
+ {Clear description of the business need expressed by the stakeholder}
22
22
 
23
- ### 1.2 Problème actuel
24
- {Situation actuelle et ses limitations}
23
+ ### 1.2 Current Problem
24
+ {Current situation and its limitations}
25
25
 
26
- ### 1.3 Valeur attendue
27
- {Bénéfices business mesurables}
26
+ ### 1.3 Expected Value
27
+ {Measurable business benefits}
28
28
 
29
29
  ## 2. Stakeholders
30
30
 
31
- | Rôle | Nom/Fonction | Implication | Niveau décision |
31
+ | Role | Name/Function | Involvement | Decision Level |
32
32
  |------|--------------|-------------|-----------------|
33
- | Sponsor | {nom} | {description} | Approbateur |
34
- | Product Owner | {nom} | {description} | Décideur |
35
- | Utilisateur clé | {nom} | {description} | Consulté |
33
+ | Sponsor | {name} | {description} | Approver |
34
+ | Product Owner | {name} | {description} | Decision Maker |
35
+ | Key User | {name} | {description} | Consulted |
36
36
 
37
- ## 3. Périmètre
37
+ ## 3. Scope
38
38
 
39
39
  ### 3.1 In Scope
40
- - [ ] {Fonctionnalité incluse 1}
41
- - [ ] {Fonctionnalité incluse 2}
40
+ - [ ] {Included feature 1}
41
+ - [ ] {Included feature 2}
42
42
 
43
43
  ### 3.2 Out of Scope
44
- - {Exclusion explicite 1}
45
- - {Exclusion explicite 2}
44
+ - {Explicit exclusion 1}
45
+ - {Explicit exclusion 2}
46
46
 
47
- ## 4. Questions ouvertes
47
+ ## 4. Open Questions
48
48
 
49
- | # | Question | Réponse | Statut |
49
+ | # | Question | Answer | Status |
50
50
  |---|----------|---------|--------|
51
- | Q1 | {Question} | {Réponse ou "En attente"} | ⏳/✅ |
51
+ | Q1 | {Question} | {Answer or "Pending"} | ⏳/✅ |
52
52
 
53
- ## 5. Contraintes identifiées
53
+ ## 5. Identified Constraints
54
54
 
55
- | Type | Contrainte | Impact |
55
+ | Type | Constraint | Impact |
56
56
  |------|------------|--------|
57
- | Technique | {contrainte} | {impact} |
58
- | Budget | {contrainte} | {impact} |
59
- | Délai | {contrainte} | {impact} |
60
- | Réglementaire | {contrainte} | {impact} |
57
+ | Technical | {constraint} | {impact} |
58
+ | Budget | {constraint} | {impact} |
59
+ | Schedule | {constraint} | {impact} |
60
+ | Regulatory | {constraint} | {impact} |
61
61
 
62
- ## 6. Dépendances
62
+ ## 6. Dependencies
63
63
 
64
- | Dépendance | Type | Module/Système | Criticité |
64
+ | Dependency | Type | Module/System | Criticality |
65
65
  |------------|------|----------------|-----------|
66
- | {dép} | Interne/Externe | {module} | Haute/Moyenne/Basse |
66
+ | {dep} | Internal/External | {module} | High/Medium/Low |
67
67
 
68
68
  ---
69
69
 
70
- ## Historique des versions
70
+ ## Version History
71
71
 
72
- | Version | Date | Auteur | Modifications |
73
- |---------|------|--------|---------------|
74
- | 1.0 | {date} | BA | Création initiale |
72
+ | Version | Date | Author | Changes |
73
+ |---------|------|--------|---------|
74
+ | 1.0 | {date} | BA | Initial creation |
75
75
  ```
76
76
 
77
77
  ---
@@ -83,90 +83,90 @@
83
83
 
84
84
  > **Module:** business/{application}/{module}
85
85
  > **Version:** 1.0
86
- > **Basé sur:** 1-discovery.md v1.0
86
+ > **Based on:** 1-discovery.md v1.0
87
87
 
88
- ## 1. Résumé exécutif
88
+ ## 1. Executive Summary
89
89
 
90
- {Synthèse en 3-5 phrases du besoin business et de la solution proposée}
90
+ {3-5 sentence summary of the business need and proposed solution}
91
91
 
92
- ## 2. Objectifs business
92
+ ## 2. Business Objectives
93
93
 
94
- | ID | Objectif | Métrique | Cible |
95
- |----|----------|----------|-------|
96
- | OBJ-001 | {objectif} | {KPI mesurable} | {valeur cible} |
94
+ | ID | Objective | Metric | Target |
95
+ |----|----------|--------|--------|
96
+ | OBJ-001 | {objective} | {Measurable KPI} | {target value} |
97
97
 
98
- ## 3. Règles métier
98
+ ## 3. Business Rules
99
99
 
100
- | ID | Règle | Catégorie | Priorité |
101
- |----|-------|-----------|----------|
102
- | BR-001 | {Description de la règle métier} | Validation/Calcul/Workflow | Must/Should/Could |
103
- | BR-002 | {Description} | {catégorie} | {priorité} |
100
+ | ID | Rule | Category | Priority |
101
+ |----|------|----------|----------|
102
+ | BR-001 | {Business rule description} | Validation/Calculation/Workflow | Must/Should/Could |
103
+ | BR-002 | {Description} | {category} | {priority} |
104
104
 
105
- ### 3.1 Détail des règles critiques
105
+ ### 3.1 Critical Rules Detail
106
106
 
107
- #### BR-001: {Nom règle}
107
+ #### BR-001: {Rule Name}
108
108
 
109
- **Énoncé:** {Formulation précise de la règle}
109
+ **Statement:** {Precise rule formulation}
110
110
 
111
111
  **Conditions:**
112
- - SI {condition A}
113
- - ET {condition B}
114
- - ALORS {résultat}
115
- - SINON {résultat alternatif}
112
+ - IF {condition A}
113
+ - AND {condition B}
114
+ - THEN {result}
115
+ - ELSE {alternative result}
116
116
 
117
- **Exemples:**
118
- | Entrée | Sortie attendue |
117
+ **Examples:**
118
+ | Input | Expected Output |
119
119
  |--------|-----------------|
120
- | {exemple 1} | {résultat 1} |
121
- | {exemple 2} | {résultat 2} |
120
+ | {example 1} | {result 1} |
121
+ | {example 2} | {result 2} |
122
122
 
123
- ## 4. Processus métier
123
+ ## 4. Business Process
124
124
 
125
- ### 4.1 Processus principal
125
+ ### 4.1 Main Process
126
126
 
127
127
  ```
128
128
  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
129
- Étape 1 │────►│ Étape 2 │────►│ Étape 3
129
+ Step 1 │────►│ Step 2 │────►│ Step 3
130
130
  │ {action} │ │ {action} │ │ {action} │
131
131
  └─────────────┘ └─────────────┘ └─────────────┘
132
132
  │ │ │
133
133
  ▼ ▼ ▼
134
- {acteur} {acteur} {acteur}
134
+ {actor} {actor} {actor}
135
135
  ```
136
136
 
137
- ### 4.2 Flux alternatifs
137
+ ### 4.2 Alternative Flows
138
138
 
139
- | Déclencheur | Flux | Résultat |
140
- |-------------|------|----------|
141
- | {condition} | {description du flux} | {état final} |
139
+ | Trigger | Flow | Result |
140
+ |---------|------|--------|
141
+ | {condition} | {flow description} | {final state} |
142
142
 
143
- ## 5. Données métier
143
+ ## 5. Business Data
144
144
 
145
- ### 5.1 Entités principales
145
+ ### 5.1 Main Entities
146
146
 
147
- | Entité | Description | Cardinalité |
147
+ | Entity | Description | Cardinality |
148
148
  |--------|-------------|-------------|
149
- | {Entité} | {description} | 1:N avec {autre entité} |
149
+ | {Entity} | {description} | 1:N with {other entity} |
150
150
 
151
- ### 5.2 Attributs clés (PAS de types techniques)
151
+ ### 5.2 Key Attributes (NO technical types)
152
152
 
153
- | Entité | Attribut | Description | Obligatoire |
154
- |--------|----------|-------------|-------------|
155
- | {Entité} | {attribut} | {description métier} | Oui/Non |
153
+ | Entity | Attribute | Description | Required |
154
+ |--------|-----------|-------------|----------|
155
+ | {Entity} | {attribute} | {business description} | Yes/No |
156
156
 
157
- ## 6. Intégrations
157
+ ## 6. Integrations
158
158
 
159
- | Système | Direction | Données | Fréquence |
160
- |---------|-----------|---------|-----------|
161
- | {système} | Entrée/Sortie/Bidirectionnel | {données} | Temps réel/Batch |
159
+ | System | Direction | Data | Frequency |
160
+ |--------|-----------|------|-----------|
161
+ | {system} | Input/Output/Bidirectional | {data} | Real-time/Batch |
162
162
 
163
163
  ---
164
164
 
165
- ## Historique des versions
165
+ ## Version History
166
166
 
167
- | Version | Date | Auteur | Modifications |
168
- |---------|------|--------|---------------|
169
- | 1.0 | {date} | BA | Création initiale |
167
+ | Version | Date | Author | Changes |
168
+ |---------|------|--------|---------|
169
+ | 1.0 | {date} | BA | Initial creation |
170
170
  ```
171
171
 
172
172
  ---
@@ -178,71 +178,71 @@
178
178
 
179
179
  > **Module:** business/{application}/{module}
180
180
  > **Version:** 1.0
181
- > **Basé sur:** 2-brd.md v1.0
181
+ > **Based on:** 2-brd.md v1.0
182
182
  > **Permission path:** business.{application}.{module}.*
183
183
 
184
- ## 1. Vue d'ensemble
184
+ ## 1. Overview
185
185
 
186
- ### 1.1 Objectif fonctionnel
187
- {Description de ce que le système doit faire}
186
+ ### 1.1 Functional Objective
187
+ {Description of what the system must do}
188
188
 
189
- ### 1.2 Acteurs
189
+ ### 1.2 Actors
190
190
 
191
- | Acteur | Description | Permissions requises |
191
+ | Actor | Description | Required Permissions |
192
192
  |--------|-------------|---------------------|
193
- | {Rôle} | {description} | `business.{app}.{module}.{action}` |
193
+ | {Role} | {description} | `business.{app}.{module}.{action}` |
194
194
 
195
- ## 2. Cas d'utilisation
195
+ ## 2. Use Cases
196
196
 
197
- ### UC-001: {Nom du cas d'utilisation}
197
+ ### UC-001: {Use Case Name}
198
198
 
199
- | Attribut | Valeur |
199
+ | Attribute | Value |
200
200
  |----------|--------|
201
201
  | **ID** | UC-001 |
202
- | **Nom** | {Nom} |
203
- | **Acteur principal** | {Rôle} |
204
- | **Préconditions** | {conditions requises} |
205
- | **Postconditions** | {état final} |
202
+ | **Name** | {Name} |
203
+ | **Primary Actor** | {Role} |
204
+ | **Preconditions** | {required conditions} |
205
+ | **Postconditions** | {final state} |
206
206
  | **Permission** | `business.{app}.{module}.{action}` |
207
207
 
208
- **Scénario principal:**
209
- 1. L'utilisateur {action}
210
- 2. Le système {réponse}
211
- 3. L'utilisateur {action}
212
- 4. Le système {réponse}
208
+ **Main Scenario:**
209
+ 1. The user {action}
210
+ 2. The system {response}
211
+ 3. The user {action}
212
+ 4. The system {response}
213
213
 
214
- **Scénarios alternatifs:**
214
+ **Alternative Scenarios:**
215
215
 
216
- | # | Condition | Étapes |
217
- |---|-----------|--------|
216
+ | # | Condition | Steps |
217
+ |---|-----------|-------|
218
218
  | 3a | {condition} | 3a.1 {action}, 3a.2 {action} |
219
219
 
220
- **Scénarios d'erreur:**
220
+ **Error Scenarios:**
221
221
 
222
- | # | Erreur | Message | Action |
223
- |---|--------|---------|--------|
224
- | E1 | {erreur} | {message utilisateur} | {comportement} |
222
+ | # | Error | Message | Action |
223
+ |---|-------|---------|--------|
224
+ | E1 | {error} | {user message} | {behavior} |
225
225
 
226
- ## 3. Exigences fonctionnelles
226
+ ## 3. Functional Requirements
227
227
 
228
- | ID | Exigence | UC lié | Priorité |
229
- |----|----------|--------|----------|
230
- | FR-001 | {Le système DOIT...} | UC-001 | Must |
231
- | FR-002 | {Le système DEVRAIT...} | UC-001 | Should |
228
+ | ID | Requirement | Related UC | Priority |
229
+ |----|-------------|------------|----------|
230
+ | FR-001 | {The system MUST...} | UC-001 | Must |
231
+ | FR-002 | {The system SHOULD...} | UC-001 | Should |
232
232
 
233
- ### 3.1 Détail FR-001
233
+ ### 3.1 Detail FR-001
234
234
 
235
- **Énoncé:** Le système DOIT {action spécifique}
235
+ **Statement:** The system MUST {specific action}
236
236
 
237
- **Critères d'acceptation:**
238
- - [ ] {Critère mesurable 1}
239
- - [ ] {Critère mesurable 2}
237
+ **Acceptance Criteria:**
238
+ - [ ] {Measurable criterion 1}
239
+ - [ ] {Measurable criterion 2}
240
240
 
241
- **Règles associées:** BR-001, BR-002
241
+ **Associated Rules:** BR-001, BR-002
242
242
 
243
- ## 4. Interface utilisateur
243
+ ## 4. User Interface
244
244
 
245
- ### 4.1 Wireframe - Écran principal
245
+ ### 4.1 Wireframe - Main Screen
246
246
 
247
247
  ```
248
248
  ┌─────────────────────────────────────────────────────────────┐
@@ -250,12 +250,12 @@
250
250
  ├─────────────────────────────────────────────────────────────┤
251
251
  │ │
252
252
  │ ┌─────────────────────────────────────────────────────┐ │
253
- │ │ FILTRE │ │
254
- │ │ [Champ 1 ▼] [Champ 2 ▼] [Rechercher] │ │
253
+ │ │ FILTER │ │
254
+ │ │ [Field 1 ▼] [Field 2 ▼] [Search] │ │
255
255
  │ └─────────────────────────────────────────────────────┘ │
256
256
  │ │
257
257
  │ ┌─────────────────────────────────────────────────────┐ │
258
- │ │ TABLEAU │ │
258
+ │ │ TABLE │ │
259
259
  │ │ ┌────────┬────────┬────────┬─────────┐ │ │
260
260
  │ │ │ Col 1 │ Col 2 │ Col 3 │ Actions │ │ │
261
261
  │ │ ├────────┼────────┼────────┼─────────┤ │ │
@@ -263,37 +263,37 @@
263
263
  │ │ └────────┴────────┴────────┴─────────┘ │ │
264
264
  │ └─────────────────────────────────────────────────────┘ │
265
265
  │ │
266
- │ [+ Nouveau] [< Prev] [Next >]
266
+ │ [+ New] [< Prev] [Next >]
267
267
  │ │
268
268
  └─────────────────────────────────────────────────────────────┘
269
269
  ```
270
270
 
271
- ### 4.2 Description des éléments UI
271
+ ### 4.2 UI Element Description
272
272
 
273
- | Élément | Type | Comportement | Permission |
274
- |---------|------|--------------|------------|
275
- | [+ Nouveau] | Bouton | Ouvre modal création | `{module}.create` |
276
- | [E] | Icône | Ouvre modal édition | `{module}.update` |
277
- | [D] | Icône | Confirmation + suppression | `{module}.delete` |
273
+ | Element | Type | Behavior | Permission |
274
+ |---------|------|----------|------------|
275
+ | [+ New] | Button | Opens create modal | `{module}.create` |
276
+ | [E] | Icon | Opens edit modal | `{module}.update` |
277
+ | [D] | Icon | Confirmation + delete | `{module}.delete` |
278
278
 
279
- ## 5. Validation et messages
279
+ ## 5. Validation and Messages
280
280
 
281
281
  ### 5.1 Validations
282
282
 
283
- | Champ | Règle | Message erreur |
284
- |-------|-------|----------------|
285
- | {champ} | {règle de validation} | {message i18n key} |
283
+ | Field | Rule | Error Message |
284
+ |-------|------|----------------|
285
+ | {field} | {validation rule} | {message i18n key} |
286
286
 
287
- ### 5.2 Messages système
287
+ ### 5.2 System Messages
288
288
 
289
- | Code | Type | Message (clé i18n) |
289
+ | Code | Type | Message (i18n key) |
290
290
  |------|------|-------------------|
291
291
  | MSG-001 | Success | `{module}.messages.created` |
292
292
  | MSG-002 | Error | `{module}.errors.notFound` |
293
293
 
294
- ## 6. Permissions détaillées
294
+ ## 6. Detailed Permissions
295
295
 
296
- ### 6.1 Matrice Rôle-Permission
296
+ ### 6.1 Role-Permission Matrix
297
297
 
298
298
  | Permission | Admin | Manager | User | ReadOnly |
299
299
  |------------|-------|---------|------|----------|
@@ -302,16 +302,16 @@
302
302
  | `business.{app}.{module}.update` | ✅ | ✅ | ❌ | ❌ |
303
303
  | `business.{app}.{module}.delete` | ✅ | ❌ | ❌ | ❌ |
304
304
 
305
- ### 6.2 Mapping Endpoint-Permission
305
+ ### 6.2 Endpoint-Permission Mapping
306
306
 
307
- | Endpoint | Méthode | Permission requise |
308
- |----------|---------|-------------------|
307
+ | Endpoint | Method | Required Permission |
308
+ |----------|--------|-------------------|
309
309
  | `/api/business/{module}` | GET | `{module}.read` |
310
310
  | `/api/business/{module}` | POST | `{module}.create` |
311
311
  | `/api/business/{module}/{id}` | PUT | `{module}.update` |
312
312
  | `/api/business/{module}/{id}` | DELETE | `{module}.delete` |
313
313
 
314
- ## 7. Scénarios Gherkin
314
+ ## 7. Gherkin Scenarios
315
315
 
316
316
  ```gherkin
317
317
  Feature: {FEAT-XXX} {Feature Name}
@@ -336,11 +336,11 @@ Feature: {FEAT-XXX} {Feature Name}
336
336
 
337
337
  ---
338
338
 
339
- ## Historique des versions
339
+ ## Version History
340
340
 
341
- | Version | Date | Auteur | Modifications |
342
- |---------|------|--------|---------------|
343
- | 1.0 | {date} | BA | Création initiale |
341
+ | Version | Date | Author | Changes |
342
+ |---------|------|--------|---------|
343
+ | 1.0 | {date} | BA | Initial creation |
344
344
  ```
345
345
 
346
346
  ---
@@ -352,126 +352,126 @@ Feature: {FEAT-XXX} {Feature Name}
352
352
 
353
353
  > **Module:** business/{application}/{module}
354
354
  > **Version:** 1.0
355
- > **Specs validées:** FRD v1.0 (validation.json)
356
- > **Implémentation:** `/implement FEAT-XXX`
355
+ > **Validated Specs:** FRD v1.0 (validation.json)
356
+ > **Implementation:** `/implement FEAT-XXX`
357
357
 
358
- ## INSTRUCTIONS DÉVELOPPEUR
358
+ ## DEVELOPER INSTRUCTIONS
359
359
 
360
- Ce document est un prompt autonome pour Claude Code. Exécutez:
360
+ This document is a self-contained prompt for Claude Code. Execute:
361
361
  ```
362
362
  /implement FEAT-XXX
363
363
  ```
364
364
 
365
365
  ---
366
366
 
367
- ## 1. CONTEXTE RAPIDE
367
+ ## 1. QUICK CONTEXT
368
368
 
369
- | Attribut | Valeur |
369
+ | Attribute | Value |
370
370
  |----------|--------|
371
371
  | Feature ID | FEAT-XXX |
372
372
  | Module | business/{application}/{module} |
373
- | Permission base | `business.{app}.{module}` |
374
- | Complexité | {Simple/Moyenne/Complexe} |
373
+ | Base Permission | `business.{app}.{module}` |
374
+ | Complexity | {Simple/Medium/Complex} |
375
375
 
376
- ## 2. [EXPLORE] PATTERNS EXISTANTS
376
+ ## 2. [EXPLORE] EXISTING PATTERNS
377
377
 
378
- AVANT de coder, explorer ces fichiers pour comprendre les patterns:
378
+ BEFORE coding, explore these files to understand the patterns:
379
379
 
380
380
  ```
381
381
  BACKEND:
382
- - src/SmartStack.Domain/Entities/ → Structure entités
383
- - src/SmartStack.Application/Features/ → Pattern CQRS
382
+ - src/SmartStack.Domain/Entities/ → Entity structure
383
+ - src/SmartStack.Application/Features/ → CQRS pattern
384
384
  - src/SmartStack.Infrastructure/Persistence/Configurations/ → EF Core
385
385
 
386
386
  FRONTEND:
387
- - web/smartstack-web/src/pages/business/ → Pages existantes
388
- - web/smartstack-web/src/components/ → Composants réutilisables
389
- - web/smartstack-web/src/services/api/ → Appels API
387
+ - web/smartstack-web/src/pages/business/ → Existing pages
388
+ - web/smartstack-web/src/components/ → Reusable components
389
+ - web/smartstack-web/src/services/api/ → API calls
390
390
  ```
391
391
 
392
- ## 3. FICHIERS À CRÉER
392
+ ## 3. FILES TO CREATE
393
393
 
394
394
  ### 3.1 Backend
395
395
 
396
- | Fichier | Template | Description |
397
- |---------|----------|-------------|
398
- | `Domain/Entities/{Entity}.cs` | Entité Domain | Propriétés + règles métier |
399
- | `Application/Features/{Module}/` | CQRS Commands/Queries | Handlers MediatR |
400
- | `Infrastructure/.../Configurations/` | EF Core Config | HasData si seed |
401
- | `Api/Controllers/Business/` | Controller API | Endpoints REST |
396
+ | File | Template | Description |
397
+ |------|----------|-------------|
398
+ | `Domain/Entities/{Entity}.cs` | Domain Entity | Properties + business rules |
399
+ | `Application/Features/{Module}/` | CQRS Commands/Queries | MediatR handlers |
400
+ | `Infrastructure/.../Configurations/` | EF Core Config | Config + HasData |
401
+ | `Api/Controllers/Business/` | API Controller | REST endpoints |
402
402
 
403
403
  ### 3.2 Frontend
404
404
 
405
- | Fichier | Template | Description |
406
- |---------|----------|-------------|
407
- | `pages/business/{app}/{module}/` | Page React | Liste + détail |
408
- | `services/api/{module}Api.ts` | Service API | Appels axios |
409
- | `i18n/locales/{lang}/{module}.json` | Traductions | FR, EN, IT, DE |
405
+ | File | Template | Description |
406
+ |------|----------|-------------|
407
+ | `pages/business/{app}/{module}/` | React Page | List + detail |
408
+ | `services/api/{module}Api.ts` | API Service | Axios calls |
409
+ | `i18n/locales/{lang}/{module}.json` | Translations | FR, EN, IT, DE |
410
410
 
411
- ## 4. SPÉCIFICATIONS DÉTAILLÉES
411
+ ## 4. DETAILED SPECIFICATIONS
412
412
 
413
- ### 4.1 Entité (attributs business, pas types C#)
413
+ ### 4.1 Entity (business attributes, not C# types)
414
414
 
415
- | Attribut | Description | Obligatoire | Règles |
416
- |----------|-------------|-------------|--------|
417
- | Id | Identifiant unique | Oui | GUID aléatoire |
418
- | {attr} | {description} | {Oui/Non} | {validation} |
415
+ | Attribute | Description | Required | Rules |
416
+ |-----------|-------------|----------|-------|
417
+ | Id | Unique identifier | Yes | Random GUID |
418
+ | {attr} | {description} | {Yes/No} | {validation} |
419
419
 
420
- ### 4.2 Endpoints API
420
+ ### 4.2 API Endpoints
421
421
 
422
- | Endpoint | Méthode | Permission | Body | Response |
423
- |----------|---------|------------|------|----------|
424
- | `/api/business/{module}` | GET | `.read` | - | Liste paginée |
425
- | `/api/business/{module}` | POST | `.create` | CreateDto | 201 + entité |
426
- | `/api/business/{module}/{id}` | GET | `.read` | - | Entité |
427
- | `/api/business/{module}/{id}` | PUT | `.update` | UpdateDto | 200 + entité |
422
+ | Endpoint | Method | Permission | Body | Response |
423
+ |----------|--------|------------|------|----------|
424
+ | `/api/business/{module}` | GET | `.read` | - | Paginated list |
425
+ | `/api/business/{module}` | POST | `.create` | CreateDto | 201 + entity |
426
+ | `/api/business/{module}/{id}` | GET | `.read` | - | Entity |
427
+ | `/api/business/{module}/{id}` | PUT | `.update` | UpdateDto | 200 + entity |
428
428
  | `/api/business/{module}/{id}` | DELETE | `.delete` | - | 204 |
429
429
 
430
- ### 4.3 Règles métier à implémenter
430
+ ### 4.3 Business Rules to Implement
431
431
 
432
- | BR-ID | Règle | Implémentation |
433
- |-------|-------|----------------|
434
- | BR-001 | {règle} | { l'implémenter} |
432
+ | BR-ID | Rule | Implementation |
433
+ |-------|------|----------------|
434
+ | BR-001 | {rule} | {where to implement} |
435
435
 
436
- ## 5. TESTS REQUIS
436
+ ## 5. REQUIRED TESTS
437
437
 
438
- - [ ] Test unitaire: Validation entité
439
- - [ ] Test integration: Endpoints API (200, 201, 400, 403, 404)
440
- - [ ] Test permission: Refus 403 sans permission
441
- - [ ] Test Postman: Collection générée
438
+ - [ ] Unit test: Entity validation
439
+ - [ ] Integration test: API endpoints (200, 201, 400, 403, 404)
440
+ - [ ] Permission test: 403 denial without permission
441
+ - [ ] Postman test: Collection generated
442
442
 
443
- ## 6. CHECKLIST POST-IMPLÉMENTATION
443
+ ## 6. POST-IMPLEMENTATION CHECKLIST
444
444
 
445
- - [ ] Build backend OK
446
- - [ ] Build frontend OK
447
- - [ ] Tests passent
448
- - [ ] Migration EF Core créée si entité
449
- - [ ] Permissions ajoutées dans PermissionConfiguration.cs
450
- - [ ] i18n complet (4 langues)
451
- - [ ] Documentation générée: `/business-analyse:7-doc-html FEAT-XXX`
445
+ - [ ] Backend build OK
446
+ - [ ] Frontend build OK
447
+ - [ ] Tests passing
448
+ - [ ] EF Core migration created if entity
449
+ - [ ] Permissions added in PermissionConfiguration.cs
450
+ - [ ] i18n complete (4 languages)
451
+ - [ ] Documentation generated: `/business-analyse:7-doc-html FEAT-XXX`
452
452
 
453
453
  ---
454
454
 
455
- ## EXÉCUTION
455
+ ## EXECUTION
456
456
 
457
457
  ```bash
458
458
  /implement FEAT-XXX
459
459
  ```
460
460
 
461
461
  Options:
462
- - `--phase=1` : Backend seulement
463
- - `--phase=2` : Frontend seulement
464
- - `--phase=3` : Tests seulement
465
- - `--phase=4` : Documentation seulement
462
+ - `--phase=1` : Backend only
463
+ - `--phase=2` : Frontend only
464
+ - `--phase=3` : Tests only
465
+ - `--phase=4` : Documentation only
466
466
  ```
467
467
 
468
468
  ---
469
469
 
470
- ## Validation des templates
470
+ ## Template Validation
471
471
 
472
- Chaque template DOIT:
473
- - [ ] Être en Markdown pur (pas de code technique)
474
- - [ ] Utiliser des tables pour les données structurées
475
- - [ ] Inclure les permissions avec le path complet
476
- - [ ] Avoir un historique de versions
477
- - [ ] Référencer les BR/FR/UC avec des IDs uniques
472
+ Each template MUST:
473
+ - [ ] Be pure Markdown (no technical code)
474
+ - [ ] Use tables for structured data
475
+ - [ ] Include permissions with full path
476
+ - [ ] Have version history
477
+ - [ ] Reference BR/FR/UC with unique IDs