@atlashub/smartstack-cli 4.17.1 → 4.19.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.
Files changed (167) hide show
  1. package/package.json +1 -1
  2. package/templates/agents/ba-reader.md +86 -80
  3. package/templates/agents/ba-writer.md +321 -413
  4. package/templates/agents/docs-context-reader.md +3 -3
  5. package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +133 -0
  6. package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +126 -0
  7. package/templates/skills/apex/SKILL.md +29 -16
  8. package/templates/skills/apex/_shared.md +62 -9
  9. package/templates/skills/apex/references/analysis-methods.md +8 -6
  10. package/templates/skills/apex/references/challenge-questions.md +5 -5
  11. package/templates/skills/apex/references/core-seed-data.md +68 -45
  12. package/templates/skills/apex/references/frontend-route-wiring-app-tsx.md +26 -21
  13. package/templates/skills/apex/references/parallel-execution.md +156 -0
  14. package/templates/skills/apex/references/person-extension-pattern.md +12 -12
  15. package/templates/skills/apex/references/post-checks.md +1748 -1726
  16. package/templates/skills/apex/references/smartstack-api.md +63 -57
  17. package/templates/skills/apex/references/smartstack-frontend-compliance.md +594 -0
  18. package/templates/skills/apex/references/smartstack-frontend.md +1246 -1842
  19. package/templates/skills/apex/references/smartstack-layers.md +98 -145
  20. package/templates/skills/apex/steps/step-00-init.md +30 -6
  21. package/templates/skills/apex/steps/step-01-analyze.md +27 -23
  22. package/templates/skills/apex/steps/step-02-plan.md +12 -12
  23. package/templates/skills/apex/steps/step-03-execute.md +198 -143
  24. package/templates/skills/apex/steps/step-04-examine.md +24 -93
  25. package/templates/skills/apex/steps/step-05-deep-review.md +16 -16
  26. package/templates/skills/apex/steps/step-06-resolve.md +9 -9
  27. package/templates/skills/apex/steps/step-07-tests.md +3 -1
  28. package/templates/skills/apex/steps/step-08-run-tests.md +1 -1
  29. package/templates/skills/business-analyse/SKILL.md +182 -301
  30. package/templates/skills/business-analyse/_shared.md +119 -336
  31. package/templates/skills/business-analyse/html/ba-interactive.html +703 -82
  32. package/templates/skills/business-analyse/html/build-html.js +41 -3
  33. package/templates/skills/business-analyse/html/src/partials/cadrage-context.html +34 -0
  34. package/templates/skills/business-analyse/html/src/partials/cadrage-risks.html +48 -0
  35. package/templates/skills/business-analyse/html/src/partials/cadrage-scope.html +49 -0
  36. package/templates/skills/business-analyse/html/src/partials/cadrage-stakeholders.html +55 -0
  37. package/templates/skills/business-analyse/html/src/partials/cadrage-success.html +34 -0
  38. package/templates/skills/business-analyse/html/src/partials/consol-datamodel.html +8 -0
  39. package/templates/skills/business-analyse/html/src/partials/consol-flows.html +29 -0
  40. package/templates/skills/business-analyse/html/src/partials/consol-interactions.html +8 -0
  41. package/templates/skills/business-analyse/html/src/partials/consol-permissions.html +8 -0
  42. package/templates/skills/business-analyse/html/src/partials/decomp-dependencies.html +38 -0
  43. package/templates/skills/business-analyse/html/src/partials/decomp-modules.html +51 -0
  44. package/templates/skills/business-analyse/html/src/partials/handoff-summary.html +24 -0
  45. package/templates/skills/business-analyse/html/src/partials/module-spec-container.html +4 -0
  46. package/templates/skills/business-analyse/html/src/scripts/01-data-init.js +17 -1
  47. package/templates/skills/business-analyse/html/src/scripts/02-navigation.js +31 -5
  48. package/templates/skills/business-analyse/html/src/scripts/05-render-specs.js +100 -63
  49. package/templates/skills/business-analyse/html/src/scripts/06-render-mockups.js +372 -0
  50. package/templates/skills/business-analyse/html/src/scripts/10-comments.js +41 -13
  51. package/templates/skills/business-analyse/html/src/styles/09-mockups-html.css +136 -0
  52. package/templates/skills/business-analyse/patterns/suggestion-catalog.md +7 -5
  53. package/templates/skills/business-analyse/questionnaire/02-stakeholders-scope.md +142 -0
  54. package/templates/skills/business-analyse/questionnaire/03-data-ui.md +94 -0
  55. package/templates/skills/business-analyse/questionnaire/04-risks-metrics.md +150 -0
  56. package/templates/skills/business-analyse/questionnaire/05-cross-module.md +69 -0
  57. package/templates/skills/business-analyse/questionnaire.md +23 -280
  58. package/templates/skills/business-analyse/react/application-viewer.md +2 -2
  59. package/templates/skills/business-analyse/react/components.md +4 -4
  60. package/templates/skills/business-analyse/react/i18n-template.md +1 -1
  61. package/templates/skills/business-analyse/react/schema.md +14 -14
  62. package/templates/skills/business-analyse/references/acceptance-criteria.md +25 -25
  63. package/templates/skills/business-analyse/references/analysis-semantic-checks.md +3 -3
  64. package/templates/skills/business-analyse/references/compilation-structure-cards.md +1 -1
  65. package/templates/skills/business-analyse/references/consolidation-structural-checks.md +7 -7
  66. package/templates/skills/business-analyse/references/deploy-data-build.md +14 -12
  67. package/templates/skills/business-analyse/references/deploy-modes.md +10 -10
  68. package/templates/skills/business-analyse/references/detection-strategies.md +6 -6
  69. package/templates/skills/business-analyse/references/html-data-mapping.md +15 -15
  70. package/templates/skills/business-analyse/references/naming-conventions.md +4 -4
  71. package/templates/skills/business-analyse/references/review-data-mapping.md +29 -29
  72. package/templates/skills/business-analyse/references/robustness-checks.md +36 -33
  73. package/templates/skills/business-analyse/references/spec-auto-inference.md +2 -2
  74. package/templates/skills/business-analyse/references/ui-dashboard-spec.md +1 -1
  75. package/templates/skills/business-analyse/references/ui-resource-cards.md +1 -1
  76. package/templates/skills/business-analyse/references/validation-checklist.md +9 -6
  77. package/templates/skills/business-analyse/references/wireframe-svg-style-guide.md +2 -2
  78. package/templates/skills/business-analyse/schemas/application-schema.json +8 -8
  79. package/templates/skills/business-analyse/schemas/feature-schema.json +3 -3
  80. package/templates/skills/business-analyse/schemas/index-schema.json +47 -0
  81. package/templates/skills/business-analyse/schemas/project-schema.json +6 -6
  82. package/templates/skills/business-analyse/schemas/sections/analysis-schema.json +1 -1
  83. package/templates/skills/business-analyse/schemas/sections/handoff-schema.json +5 -3
  84. package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +4 -4
  85. package/templates/skills/business-analyse/schemas/sections/specification-schema.json +1 -1
  86. package/templates/skills/business-analyse/schemas/shared/common-defs.json +4 -3
  87. package/templates/skills/business-analyse/steps/step-00-init.md +93 -134
  88. package/templates/skills/business-analyse/steps/step-01-cadrage.md +136 -172
  89. package/templates/skills/business-analyse/steps/step-02-structure.md +175 -0
  90. package/templates/skills/business-analyse/steps/step-03-specify.md +198 -0
  91. package/templates/skills/business-analyse/steps/step-04-consolidate.md +478 -0
  92. package/templates/skills/business-analyse/steps/step-05-deploy.md +220 -0
  93. package/templates/skills/business-analyse/steps/step-06-review.md +51 -69
  94. package/templates/skills/business-analyse/templates/tpl-frd.md +1 -1
  95. package/templates/skills/business-analyse/templates/tpl-handoff.md +20 -17
  96. package/templates/skills/business-analyse/templates/tpl-launch-displays.md +2 -2
  97. package/templates/skills/business-analyse/templates-react.md +2 -2
  98. package/templates/skills/derive-prd/SKILL.md +92 -0
  99. package/templates/skills/derive-prd/references/acceptance-criteria.md +169 -0
  100. package/templates/skills/derive-prd/references/entity-domain-mapping.md +115 -0
  101. package/templates/skills/{business-analyse → derive-prd}/references/handoff-file-templates.md +131 -120
  102. package/templates/skills/{business-analyse → derive-prd}/references/handoff-mappings.md +95 -95
  103. package/templates/skills/{business-analyse → derive-prd}/references/handoff-seeddata-generation.md +312 -312
  104. package/templates/skills/{business-analyse → derive-prd}/references/prd-generation.md +262 -258
  105. package/templates/skills/derive-prd/references/readiness-scoring.md +104 -0
  106. package/templates/skills/derive-prd/schemas/handoff-schema.json +95 -0
  107. package/templates/skills/derive-prd/steps/step-00-validate.md +130 -0
  108. package/templates/skills/derive-prd/steps/step-01-transform.md +206 -0
  109. package/templates/skills/derive-prd/steps/step-02-export.md +181 -0
  110. package/templates/skills/{business-analyse → derive-prd}/templates/tpl-progress.md +172 -172
  111. package/templates/skills/ralph-loop/SKILL.md +10 -4
  112. package/templates/skills/ralph-loop/references/category-completeness.md +20 -4
  113. package/templates/skills/ralph-loop/references/compact-loop.md +80 -48
  114. package/templates/skills/ralph-loop/references/init-resume-recovery.md +4 -2
  115. package/templates/skills/ralph-loop/references/parallel-execution.md +27 -27
  116. package/templates/skills/ralph-loop/steps/step-00-init.md +19 -9
  117. package/templates/skills/ralph-loop/steps/step-01-task.md +12 -4
  118. package/templates/skills/ralph-loop/steps/step-02-execute.md +9 -4
  119. package/templates/skills/ralph-loop/steps/step-03-commit.md +1 -1
  120. package/templates/skills/ralph-loop/steps/step-04-check.md +5 -21
  121. package/templates/skills/ralph-loop/steps/step-05-report.md +6 -1
  122. package/templates/skills/apex/references/agent-teams-protocol.md +0 -203
  123. package/templates/skills/business-analyse/_architecture.md +0 -124
  124. package/templates/skills/business-analyse/_elicitation.md +0 -206
  125. package/templates/skills/business-analyse/_module-loop.md +0 -115
  126. package/templates/skills/business-analyse/_suggestions.md +0 -34
  127. package/templates/skills/business-analyse/questionnaire/00-application.md +0 -160
  128. package/templates/skills/business-analyse/questionnaire/00b-project.md +0 -85
  129. package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +0 -189
  130. package/templates/skills/business-analyse/questionnaire/03-scope.md +0 -164
  131. package/templates/skills/business-analyse/questionnaire/04-data.md +0 -88
  132. package/templates/skills/business-analyse/questionnaire/05-integrations.md +0 -58
  133. package/templates/skills/business-analyse/questionnaire/06-security.md +0 -68
  134. package/templates/skills/business-analyse/questionnaire/07-ui.md +0 -76
  135. package/templates/skills/business-analyse/questionnaire/08-performance.md +0 -42
  136. package/templates/skills/business-analyse/questionnaire/09-constraints.md +0 -45
  137. package/templates/skills/business-analyse/questionnaire/10-documentation.md +0 -43
  138. package/templates/skills/business-analyse/questionnaire/11-data-lifecycle.md +0 -59
  139. package/templates/skills/business-analyse/questionnaire/12-migration.md +0 -58
  140. package/templates/skills/business-analyse/questionnaire/13-cross-module.md +0 -69
  141. package/templates/skills/business-analyse/questionnaire/14-risk-assumptions.md +0 -135
  142. package/templates/skills/business-analyse/questionnaire/15-success-metrics.md +0 -136
  143. package/templates/skills/business-analyse/references/agent-module-prompt.md +0 -362
  144. package/templates/skills/business-analyse/references/agent-pooling-best-practices.md +0 -557
  145. package/templates/skills/business-analyse/references/cache-warming-strategy.md +0 -566
  146. package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +0 -41
  147. package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +0 -74
  148. package/templates/skills/business-analyse/references/cadrage-pre-analysis.md +0 -115
  149. package/templates/skills/business-analyse/references/cadrage-shared-modules.md +0 -68
  150. package/templates/skills/business-analyse/references/cadrage-structure-cards.md +0 -85
  151. package/templates/skills/business-analyse/references/team-orchestration.md +0 -1022
  152. package/templates/skills/business-analyse/references/validate-incremental-html.md +0 -121
  153. package/templates/skills/business-analyse/steps/step-01b-applications.md +0 -419
  154. package/templates/skills/business-analyse/steps/step-02-decomposition.md +0 -387
  155. package/templates/skills/business-analyse/steps/step-03a-data.md +0 -16
  156. package/templates/skills/business-analyse/steps/step-03a1-setup.md +0 -506
  157. package/templates/skills/business-analyse/steps/step-03a2-analysis.md +0 -301
  158. package/templates/skills/business-analyse/steps/step-03b-ui.md +0 -425
  159. package/templates/skills/business-analyse/steps/step-03c-compile.md +0 -611
  160. package/templates/skills/business-analyse/steps/step-03d-validate.md +0 -783
  161. package/templates/skills/business-analyse/steps/step-04-consolidation.md +0 -17
  162. package/templates/skills/business-analyse/steps/step-04a-collect.md +0 -415
  163. package/templates/skills/business-analyse/steps/step-04b-analyze.md +0 -163
  164. package/templates/skills/business-analyse/steps/step-04c-decide.md +0 -186
  165. package/templates/skills/business-analyse/steps/step-05a-handoff.md +0 -840
  166. package/templates/skills/business-analyse/steps/step-05b-deploy.md +0 -522
  167. package/templates/skills/business-analyse/steps/step-05c-ralph-readiness.md +0 -703
@@ -1,189 +0,0 @@
1
- # Categorie 2 : Parties prenantes
2
-
3
- > **Usage :** Identification de toutes les personnes concernees et de leurs besoins reels
4
- > **Quand charger :** TOUJOURS (noyau)
5
- > **Objectif :** Comprendre QUI utilise le systeme, COMMENT et POURQUOI
6
-
7
- ---
8
-
9
- ## 2.1 Identification des utilisateurs
10
-
11
- > **But :** Dresser la carte complete de toutes les personnes qui interagiront avec le systeme.
12
-
13
- | # | Question | Type de reponse |
14
- |---|----------|-----------------|
15
- | Q2.1 | Qui sont les personnes qui utiliseront ce systeme au quotidien ? Decrivez leurs postes et ce qu'ils font dans l'entreprise. | Liste de profils utilisateurs |
16
- | Q2.2 | Y a-t-il des personnes qui ne l'utiliseront pas directement mais qui beneficieront des resultats (rapports, donnees, decisions) ? | Liste de beneficiaires indirects |
17
- | Q2.3 | Qui est le decideur final sur ce projet ? Qui peut dire "oui, on lance" ou "non, on arrete" ? | Nom et role du decideur |
18
- | Q2.4 | Y a-t-il des personnes ou des services qui pourraient s'opposer a ce projet ou le freiner ? Pourquoi ? | Liste de resistances potentielles |
19
-
20
- **Reformulation guidee pour Q2.1 :**
21
- ```
22
- question: "Qui sont les personnes qui utiliseront ce systeme au quotidien ?"
23
- header: "Utilisateurs"
24
- options:
25
- - label: "Equipe operationnelle"
26
- description: "Les personnes qui font le travail quotidien et saisissent les donnees"
27
- - label: "Responsables et managers"
28
- description: "Les personnes qui supervisent, valident et prennent des decisions"
29
- - label: "Direction"
30
- description: "Les personnes qui consultent les tableaux de bord et les indicateurs"
31
- - label: "Equipe support"
32
- description: "Les personnes qui aident les utilisateurs et resolvent les problemes"
33
- ```
34
-
35
- ---
36
-
37
- ## 2.2 Le quotidien de chaque utilisateur
38
-
39
- > **But :** Comprendre concretement ce que chaque type d'utilisateur fait et a besoin de faire.
40
-
41
- | # | Question | Type de reponse |
42
- |---|----------|-----------------|
43
- | Q2.5 | Pour chaque type d'utilisateur : quelles sont les 3 a 5 taches principales qu'il doit accomplir avec ce systeme ? | Taches par profil utilisateur |
44
- | Q2.6 | A quelle frequence chaque utilisateur se servira-t-il du systeme ? Tous les jours ? Plusieurs fois par jour ? Une fois par semaine ? | Frequence d'utilisation par profil |
45
- | Q2.7 | Quel est le niveau de confort de chaque utilisateur avec les outils informatiques ? Certains sont-ils plus a l'aise que d'autres ? | Niveau d'aisance par profil |
46
- | Q2.8 | Pour chaque utilisateur : quelles sont ses 2 a 3 plus grandes frustrations avec la facon de travailler actuelle ? | Frustrations par profil |
47
-
48
- **Reformulation guidee pour Q2.5 :**
49
- ```
50
- question: "Quelles sont les taches principales de chaque type d'utilisateur ?"
51
- header: "Taches"
52
- options:
53
- - label: "Saisie et creation"
54
- description: "Creer de nouvelles fiches, saisir des informations, remplir des formulaires"
55
- - label: "Consultation et recherche"
56
- description: "Chercher des informations, consulter des fiches, verifier des donnees"
57
- - label: "Validation et approbation"
58
- description: "Verifier le travail des autres, approuver des demandes, valider des etapes"
59
- - label: "Suivi et reporting"
60
- description: "Suivre l'avancement, consulter des indicateurs, generer des rapports"
61
- ```
62
-
63
- ---
64
-
65
- ## 2.3 Les niveaux d'acces
66
-
67
- > **But :** Definir qui peut voir quoi et faire quoi, en langage simple.
68
-
69
- | # | Question | Type de reponse |
70
- |---|----------|-----------------|
71
- | Q2.9 | Tous les utilisateurs doivent-ils voir les memes informations ? Si non, qui voit quoi ? | Regles de visibilite des donnees |
72
- | Q2.10 | Qui a le droit de modifier ou supprimer des informations ? Tout le monde ou seulement certaines personnes ? | Regles de modification |
73
- | Q2.11 | Y a-t-il des actions sensibles qui necessitent une validation par un superieur avant d'etre executees (approbation, suppression, publication) ? | Liste des actions a valider |
74
- | Q2.12 | Quand un nouvel utilisateur rejoint l'equipe, quel niveau d'acces doit-il avoir par defaut ? | Acces initial |
75
-
76
- **Reformulation guidee pour Q2.9 :**
77
- ```
78
- question: "Tous les utilisateurs voient-ils les memes informations ?"
79
- header: "Visibilite"
80
- options:
81
- - label: "Oui, tout est visible par tous"
82
- description: "Pas de restriction, tous les utilisateurs voient toutes les donnees"
83
- - label: "Non, selon le role"
84
- description: "Chaque role ne voit que les informations qui le concernent"
85
- - label: "Non, selon le service"
86
- description: "Chaque service ou equipe ne voit que ses propres donnees"
87
- - label: "C'est complexe"
88
- description: "Les regles de visibilite dependent de plusieurs criteres combines"
89
- ```
90
-
91
- ---
92
-
93
- ## 2.4 La conduite du changement
94
-
95
- > **But :** Anticiper les resistances et planifier l'adoption.
96
-
97
- | # | Question | Type de reponse |
98
- |---|----------|-----------------|
99
- | Q2.13 | Comment reagiront les utilisateurs face a ce changement ? Qui sera enthousiaste et qui sera reticent ? | Cartographie des attitudes |
100
- | Q2.14 | Y a-t-il eu des tentatives precedentes de resoudre ce probleme ? Qu'est-ce qui a fonctionne ou echoue ? | Historique des initiatives passees |
101
-
102
- ---
103
-
104
- ## Guide d'elicitation approfondi
105
-
106
- ### Techniques de relance par question
107
-
108
- | Question | Si la reponse est vague ou insuffisante | Relance recommandee |
109
- |----------|----------------------------------------|---------------------|
110
- | Q2.1 (utilisateurs directs) | Un seul type d'utilisateur mentionne | "Pensez aux differents moments de la journee : qui intervient le matin pour la saisie ? Qui consulte les rapports l'apres-midi ? Qui gere les cas particuliers ? Y a-t-il un administrateur, un auditeur, ou un processus automatique ?" |
111
- | Q2.2 (beneficiaires indirects) | "Personne d'autre" | "Quand une information est creee dans le systeme, qui en a besoin ensuite ? La direction consulte-t-elle des chiffres qui en dependent ? Un autre service attend-il des resultats ?" |
112
- | Q2.4 (oppositions) | "Personne ne s'opposera" | "Quand un nouvel outil est introduit, qui doit changer ses habitudes le plus ? Cette personne est-elle favorable au changement ?" |
113
- | Q2.5 (taches par role) | Taches generiques ("gerer les donnees") | "Prenons le role {role} : quand il arrive le matin et ouvre le systeme, quelle est sa premiere action ? Que fait-il ensuite ? A quel moment considere-t-il que sa tache est terminee ?" |
114
- | Q2.6 (frequence) | "Regulierement" | "Combien de fois par jour ? Est-ce 3 fois par jour ou 30 fois ? Y a-t-il des periodes plus intenses que d'autres (debut de mois, fin d'annee) ?" |
115
- | Q2.7 (aisance informatique) | "Ils se debrouillent" | "Si je donnais un nouveau logiciel a cet utilisateur sans formation, combien de temps lui faudrait-il pour etre autonome ? 5 minutes, 1 heure, une journee ?" |
116
- | Q2.8 (frustrations) | "Rien de special" | "Quelle tache fait le plus soupirer vos equipes ? Quelle question posent-ils le plus souvent ? De quoi se plaignent-ils en pause cafe ?" |
117
- | Q2.9 (visibilite) | Reponse ambigue | "Prenons un exemple : un employe du service A peut-il voir les donnees du service B ? Un stagiaire voit-il la meme chose qu'un directeur ?" |
118
- | Q2.13 (changement) | "Ca ira" (trop optimiste) | "La derniere fois qu'un nouvel outil a ete introduit, comment ca s'est passe ? Certains utilisateurs l'ont-ils evite ou contourne ?" |
119
-
120
- ### Signaux d'alerte a detecter
121
-
122
- | Signal du client | Probleme sous-jacent | Action de l'analyste |
123
- |------------------|---------------------|----------------------|
124
- | "Tous les utilisateurs font la meme chose" | **Roles non differencies** | "Qui peut supprimer une fiche ? Qui ne fait que consulter ? Qui valide le travail des autres ?" |
125
- | Un seul type d'utilisateur identifie | **Parties prenantes manquantes** | Proposer systematiquement : administrateur, utilisateur quotidien, lecteur seul, auditeur, support technique |
126
- | Melange entre titre de poste et niveau d'acces | **Confusion role metier et acces** | Separer : le role metier (chef de projet, comptable) ET son niveau d'acces (consultation, modification, administration) |
127
- | "Tout le monde doit tout voir" | **Securite non reflechie** | "Meme les stagiaires ? Meme les prestataires externes ? Meme les donnees salariales ou financieres ?" |
128
- | "Personne ne s'y opposera" | **Resistance sous-estimee** | "Quels utilisateurs devront changer le plus leurs habitudes ? Cette personne a-t-elle ete consultee ?" |
129
-
130
- ### Regles d'enchainement
131
-
132
- | Apres | Si la reponse indique... | Alors |
133
- |-------|-------------------------|-------|
134
- | Q2.1 | Plus de 4 types d'utilisateurs | Approfondir Q2.5 par lots (2 roles par lot maximum) |
135
- | Q2.4 | Resistances identifiees | Insister sur Q2.13-Q2.14 pour anticiper la conduite du changement |
136
- | Q2.7 | Utilisateurs peu a l'aise | Prioriser les questions d'interface utilisateur (categorie 07) |
137
- | Q2.9 | Regles de visibilite complexes | Charger le questionnaire de securite (categorie 06) en priorite |
138
- | Q2.11 | Actions a valider identifiees | Noter pour la phase de specification : workflows d'approbation a modeliser |
139
- | Q2.14 | Echecs passes | Comprendre les raisons d'echec pour ne pas les reproduire |
140
-
141
- ---
142
-
143
- ## Regle de mapping des roles vers les permissions
144
-
145
- > **Important :** Les roles identifies ici sont des profils metier. Ils seront mappes
146
- > vers des niveaux d'acces de la plateforme lors de la phase de specification.
147
- >
148
- > Cette correspondance est transparente pour le client. Il definit des profils
149
- > en langage naturel, le systeme s'occupe de la traduction technique.
150
-
151
- | Profil utilisateur decrit par le client | Niveau d'acces correspondant |
152
- |-----------------------------------------|-----------------------------|
153
- | "Il gere tout, c'est l'administrateur" | Administration complete |
154
- | "Il supervise et valide" | Lecture, creation, modification, validation |
155
- | "Il saisit et modifie au quotidien" | Lecture, creation, modification |
156
- | "Il consulte les rapports" | Lecture seule |
157
-
158
- ---
159
-
160
- ## Mapping vers le cadrage
161
-
162
- | Reponse | Alimente |
163
- |---------|----------|
164
- | Q2.1, Q2.2, Q2.3, Q2.4 | `cadrage.stakeholders[]` |
165
- | Q2.5, Q2.6, Q2.7, Q2.8 | `cadrage.stakeholders[].tasks`, `.frequency`, `.painPoints` |
166
- | Q2.9, Q2.10, Q2.11, Q2.12 | `cadrage.applicationRoles[]` |
167
- | Q2.13, Q2.14 | `cadrage.risks[]` (risque adoption) |
168
-
169
- ---
170
-
171
- ## Strategie de questionnement
172
-
173
- ### Ordre des questions en 4 lots
174
-
175
- **Lot 1 (Q2.1, Q2.2, Q2.3, Q2.4) : Qui est concerne ?**
176
- - Identifier tous les acteurs du projet
177
- - Ne pas oublier les beneficiaires indirects et les opposants potentiels
178
-
179
- **Lot 2 (Q2.5, Q2.6, Q2.7, Q2.8) : Que font-ils au quotidien ?**
180
- - Detailler les taches, frequences et frustrations par profil
181
- - Si plus de 4 profils : traiter les 2 plus importants d'abord
182
-
183
- **Lot 3 (Q2.9, Q2.10, Q2.11, Q2.12) : Qui a le droit de faire quoi ?**
184
- - Etablir les regles de visibilite et de modification
185
- - Identifier les actions sensibles necessitant validation
186
-
187
- **Lot 4 (Q2.13, Q2.14) : Comment vont-ils reagir ?**
188
- - Anticiper les resistances et tirer les lecons du passe
189
- - Ce lot peut etre fusionne avec le lot 3 si le projet est simple
@@ -1,164 +0,0 @@
1
- # Categorie 3 : Perimetre fonctionnel
2
-
3
- > **Usage :** Definir ce que le systeme doit faire et ne pas faire, avec des priorites claires
4
- > **Quand charger :** TOUJOURS (noyau)
5
- > **Objectif :** Delimiter le perimetre et hierarchiser les fonctionnalites
6
-
7
- ---
8
-
9
- ## 3.1 Les fonctionnalites attendues
10
-
11
- > **But :** Lister tout ce que le systeme doit permettre de faire, puis hierarchiser.
12
-
13
- | # | Question | Type de reponse |
14
- |---|----------|-----------------|
15
- | Q3.1 | Listez toutes les fonctionnalites que vous souhaitez dans ce systeme. Ne vous censurez pas, notez tout ce qui vous vient a l'esprit. | Liste libre de fonctionnalites |
16
- | Q3.2 | Parmi cette liste, quelles sont les fonctionnalites INDISPENSABLES ? Celles sans lesquelles le systeme n'a aucun interet ? | Liste de fonctionnalites vitales |
17
- | Q3.3 | Quelles fonctionnalites seraient tres utiles mais pourraient attendre une deuxieme version si necessaire ? | Liste de fonctionnalites importantes |
18
- | Q3.4 | Y a-t-il des choses que le systeme ne doit explicitement PAS faire ? Des limites claires a poser ? | Liste d'exclusions |
19
-
20
- **Reformulation guidee pour Q3.2 :**
21
- ```
22
- question: "Quelles fonctionnalites sont absolument indispensables ?"
23
- header: "Indispensable"
24
- options:
25
- - label: "Creer et consulter les fiches"
26
- description: "La base : pouvoir ajouter de nouvelles informations et les retrouver"
27
- - label: "Suivre l'avancement"
28
- description: "Voir ou en est chaque element, son statut et son historique"
29
- - label: "Controler les acces"
30
- description: "S'assurer que chaque personne ne voit et fait que ce qu'elle a le droit"
31
- - label: "Generer des rapports"
32
- description: "Produire des syntheses et des indicateurs pour la prise de decision"
33
- ```
34
-
35
- **Test de priorite :**
36
- > Pour chaque fonctionnalite classee comme indispensable, poser la question :
37
- > "Si on enlevait cette fonctionnalite, le systeme aurait-il encore de la valeur ?"
38
- > - Si la reponse est "non" : c'est bien indispensable
39
- > - Si la reponse est "oui, mais..." : c'est important mais pas vital
40
-
41
- ---
42
-
43
- ## 3.2 Le parcours principal
44
-
45
- > **But :** Comprendre le flux de travail principal de bout en bout.
46
-
47
- | # | Question | Type de reponse |
48
- |---|----------|-----------------|
49
- | Q3.5 | Decrivez le parcours typique d'un utilisateur du debut a la fin : il ouvre le systeme, que fait-il en premier ? Puis ensuite ? Comment termine-t-il sa tache ? | Liste d'etapes ordonnees |
50
- | Q3.6 | A quels moments l'utilisateur doit-il prendre une decision ? Quelles sont les options possibles a chaque point de decision ? | Points de decision et options |
51
- | Q3.7 | Que se passe-t-il quand quelque chose ne se deroule pas comme prevu ? Quels sont les cas particuliers ou les exceptions ? | Scenarios alternatifs |
52
- | Q3.8 | Que se passe-t-il quand une erreur survient ? Comment l'utilisateur est-il informe ? Que doit-il faire pour corriger ? | Gestion des erreurs |
53
-
54
- **Reformulation guidee pour Q3.5 :**
55
- ```
56
- question: "Decrivez le parcours typique d'un utilisateur du debut a la fin"
57
- header: "Parcours"
58
- options:
59
- - label: "Saisie puis validation"
60
- description: "L'utilisateur cree une fiche, un responsable la valide, elle est publiee"
61
- - label: "Recherche puis action"
62
- description: "L'utilisateur cherche une information, puis effectue une action dessus"
63
- - label: "Reception puis traitement"
64
- description: "Une demande arrive, l'utilisateur la traite etape par etape"
65
- - label: "Suivi continu"
66
- description: "L'utilisateur surveille un tableau de bord et intervient quand necessaire"
67
- ```
68
-
69
- ---
70
-
71
- ## 3.3 Les besoins transversaux
72
-
73
- > **But :** Identifier les fonctionnalites qui traversent tout le systeme.
74
-
75
- | # | Question | Type de reponse |
76
- |---|----------|-----------------|
77
- | Q3.9 | Les utilisateurs ont-ils besoin de recevoir des notifications ou des alertes ? Si oui, dans quelles situations ? | Liste de situations de notification |
78
- | Q3.10 | Faut-il pouvoir exporter des donnees du systeme (rapports, fichiers, impressions) ? Dans quel format et pour qui ? | Besoins d'export |
79
- | Q3.11 | Faut-il pouvoir importer des donnees dans le systeme depuis une source externe (fichiers, autres logiciels) ? | Besoins d'import |
80
- | Q3.12 | Faut-il garder un historique de qui a fait quoi et quand ? Pour quelles actions ? | Besoins de tracabilite |
81
-
82
- **Reformulation guidee pour Q3.9 :**
83
- ```
84
- question: "Les utilisateurs ont-ils besoin de recevoir des notifications ou des alertes ?"
85
- header: "Alertes"
86
- options:
87
- - label: "Oui, en temps reel"
88
- description: "Notifications instantanees quand quelque chose de nouveau arrive ou change"
89
- - label: "Oui, par email"
90
- description: "Recapitulatif par email quotidien ou a chaque evenement important"
91
- - label: "Oui, les deux"
92
- description: "Notification en temps reel dans l'application et recapitulatif par email"
93
- - label: "Non, pas necessaire"
94
- description: "Les utilisateurs consulteront le systeme de leur propre initiative"
95
- ```
96
-
97
- ---
98
-
99
- ## Guide d'elicitation approfondi
100
-
101
- ### Techniques de relance par question
102
-
103
- | Question | Si la reponse est vague ou insuffisante | Relance recommandee |
104
- |----------|----------------------------------------|---------------------|
105
- | Q3.1 (liste de fonctionnalites) | Moins de 5 elements | "Pensez a une journee complete de travail. De l'ouverture de session a la fermeture, quelles actions devriez-vous pouvoir faire ? Creation ? Recherche ? Modification ? Exportation ? Suivi ?" |
106
- | Q3.2 (indispensable) | Tout est marque comme indispensable | "Si vous ne pouviez garder que 3 fonctionnalites pour un premier lancement, lesquelles choisiriez-vous ? Les autres sont tres importantes mais pourraient venir dans un second temps." |
107
- | Q3.4 (exclusions) | "Je ne vois pas" | "Certains utilisateurs pourraient-ils s'attendre a des fonctionnalites que vous ne souhaitez PAS inclure ? Par exemple : gestion financiere, messagerie integree, application mobile ?" |
108
- | Q3.5 (parcours principal) | Moins de 3 etapes | "Detaillons : l'utilisateur arrive sur l'ecran d'accueil. Que voit-il ? Ou clique-t-il ? Que remplit-il ? Que se passe-t-il quand il valide ? Qui est notifie ?" |
109
- | Q3.6 (decisions) | "Il n'y a pas vraiment de choix" | "A chaque etape, l'utilisateur peut-il annuler ? Revenir en arriere ? Sauvegarder en brouillon ? Deleguer a quelqu'un d'autre ?" |
110
- | Q3.7 (cas particuliers) | "Il n'y en a pas" | "Que se passe-t-il si l'utilisateur n'a pas toutes les informations ? Si une donnee est incorrecte ? Si deux personnes modifient la meme fiche en meme temps ?" |
111
- | Q3.8 (erreurs) | "On verra" | "Prenons un exemple : l'utilisateur oublie un champ obligatoire. Le systeme le bloque ? L'avertit ? Le laisse continuer avec un rappel plus tard ?" |
112
- | Q3.9 (notifications) | Reponse vague | "Quand un element change de statut, qui doit etre prevenu ? Quand une action urgente est requise, comment l'utilisateur le sait-il aujourd'hui ?" |
113
- | Q3.12 (tracabilite) | "On ne sait pas" | "Si dans 6 mois quelqu'un demande 'Qui a modifie cette fiche et pourquoi ?', devez-vous pouvoir repondre ?" |
114
-
115
- ### Signaux d'alerte a detecter
116
-
117
- | Signal du client | Probleme sous-jacent | Action de l'analyste |
118
- |------------------|---------------------|----------------------|
119
- | Tout est indispensable (> 10 elements vitaux) | **Priorites non definies** | Appliquer le test : "Si on enlevait cette fonctionnalite, le systeme aurait-il encore de la valeur ?" |
120
- | Aucune exclusion identifiee | **Perimetre non borne** | "Y a-t-il des aspects qui relevent d'un autre projet, d'un autre service, ou d'une version future ?" |
121
- | Parcours lineaire sans alternative | **Seul le cas ideal est decrit** | "Que se passe-t-il a l'etape X si la condition Y n'est pas remplie ? Si l'utilisateur change d'avis ?" |
122
- | Melange fonctionnel et technique | **Solution dans le perimetre** | Separer : "gerer les commandes" (ce que fait le systeme) est fonctionnel, "utiliser tel outil" (comment il le fait) est technique |
123
- | Fonctionnalites tres detaillees pour certains sujets et vagues pour d'autres | **Expertise inegale** | Approfondir les zones vagues : "Ce sujet semble moins detaille. Est-ce parce qu'il est moins important ou parce qu'il est moins bien connu ?" |
124
-
125
- ### Regles d'enchainement
126
-
127
- | Apres | Si la reponse indique... | Alors |
128
- |-------|-------------------------|-------|
129
- | Q3.1 | Plus de 15 fonctionnalites | Passer plus de temps sur Q3.2 pour hierarchiser |
130
- | Q3.2 | Plus de 10 elements indispensables | Challenger chaque element avec le test de priorite |
131
- | Q3.5 | Parcours avec approbation | Charger les questions de workflow (categorie 11 cycle de vie) |
132
- | Q3.7 | Beaucoup de cas particuliers | Prevoir de la complexite dans l'estimation des modules |
133
- | Q3.9 | Notifications en temps reel souhaitees | Noter pour la specification : integration de notifications |
134
- | Q3.11 | Import de donnees existantes | Charger le questionnaire de migration (categorie 12) |
135
- | Q3.12 | Tracabilite requise | Noter pour la specification : journal d'activite |
136
-
137
- ---
138
-
139
- ## Mapping vers le cadrage
140
-
141
- | Reponse | Alimente |
142
- |---------|----------|
143
- | Q3.1, Q3.2, Q3.3 | `cadrage.globalScope` (indispensable, important, optionnel, hors perimetre) |
144
- | Q3.4 | `cadrage.globalScope.outOfScope` |
145
- | Q3.5, Q3.6, Q3.7, Q3.8 | `cadrage.coverageMatrix` + base pour les cas d'utilisation |
146
- | Q3.9, Q3.10, Q3.11, Q3.12 | `cadrage.coverageMatrix` + detection de modules transversaux |
147
-
148
- ---
149
-
150
- ## Strategie de questionnement
151
-
152
- ### Ordre des questions en 3 lots
153
-
154
- **Lot 1 (Q3.1, Q3.2, Q3.3, Q3.4) : Quoi et dans quel ordre ?**
155
- - Commencer par un brainstorming libre (Q3.1) puis hierarchiser
156
- - Bien definir les limites (Q3.4) pour eviter les derives
157
-
158
- **Lot 2 (Q3.5, Q3.6, Q3.7, Q3.8) : Comment ca se deroule ?**
159
- - Cartographier le parcours principal puis les variantes
160
- - Ne pas accepter un parcours uniquement ideal
161
-
162
- **Lot 3 (Q3.9, Q3.10, Q3.11, Q3.12) : Quels besoins transversaux ?**
163
- - Identifier les fonctionnalites qui traversent tout le systeme
164
- - Ces reponses orientent le choix des questionnaires conditionnels
@@ -1,88 +0,0 @@
1
- # Category 4: Data
2
-
3
- > **Usage:** Definition of entities and data rules
4
- > **When to load:** If feature is data-centric or full module
5
-
6
- ---
7
-
8
- ## 4.1 Entities
9
-
10
- | # | Question | Answer Type |
11
- |---|----------|-------------|
12
- | Q4.1 | What are the main entities handled? | List |
13
- | Q4.2 | For each entity: important attributes? | Per entity |
14
- | Q4.3 | What relationships exist between entities? | Text schema |
15
- | Q4.4 | Expected data volume? | Estimation |
16
- | Q4.4b | For each entity: should the Code be auto-generated or user-provided? | Per entity |
17
- | Q4.4c | If auto-generated: what strategy? (sequential, daily timestamp, yearly, UUID short) | Per entity |
18
- | Q4.4d | What prefix represents this entity? (2-6 lowercase letters, e.g., emp, inv) | Per entity |
19
-
20
- ## 4.2 Data Rules
21
-
22
- | # | Question | Answer Type |
23
- |---|----------|-------------|
24
- | Q4.5 | What validations on data? | List of rules |
25
- | Q4.6 | Which fields are required vs optional? | Per field |
26
- | Q4.7 | What specific formats/constraints? | List |
27
- | Q4.8 | Sensitive data to protect? | List + level |
28
-
29
- ---
30
-
31
- ## Technical Mapping
32
-
33
- | Business Concept | Platform |
34
- |-----------------|------------|
35
- | Main entity | Domain Entity |
36
- | Required attribute | `[Required]` |
37
- | Unique attribute | `HasIndex().IsUnique()` |
38
- | 1:N relationship | Navigation property |
39
- | Sensitive data | Encryption + audit |
40
- | Code auto-generation | `ICodeGenerator<T>.NextCodeAsync()` with retry — see `apex/references/code-generation.md` |
41
- | Code pattern config | `analysis.entities[].codePattern` in feature.json |
42
-
43
- > **⚠️ RBAC EXCLUSION: The following concepts are handled by the platform's RBAC system
44
- > and MUST NOT be modeled as entity attributes or separate entities:**
45
- >
46
- > | Concept | ❌ Wrong (entity attribute) | ✅ Correct (RBAC) |
47
- > |---------|---------------------------|-------------------|
48
- > | User role | `User.Role` property | Permission set `{app}.{module}.*` |
49
- > | Access level | `User.AccessLevel` enum | Permission matrix per role |
50
- > | Is admin | `User.IsAdmin` boolean | `{app}.{module}.admin` permission |
51
- > | Can edit | `User.CanEdit` boolean | `{app}.{module}.update` permission |
52
- >
53
- > When Q4.2 asks for "important attributes", **exclude** any role/permission/access concept.
54
-
55
- ## Elicitation Guide
56
-
57
- ### Follow-ups by Question
58
-
59
- | Question | If answer is vague/insufficient | Probe |
60
- |----------|-------------------------------|-------|
61
- | Q4.1 (entities) | Single entity listed | "Cette entité a-t-elle des sous-éléments ? (lignes de commande, pièces jointes, historique)" |
62
- | Q4.1 (entities) | Mentions "User" as entity | "L'utilisateur est géré par la plateforme (Identity). Décrivez plutôt l'entité MÉTIER (Client, Employee, Contact...)" |
63
- | Q4.2 (attributes) | Liste de champs techniques (ID, CreatedDate) | "Les champs techniques (Id, TenantId, audit) sont auto-gérés. Quels sont les attributs MÉTIER ?" |
64
- | Q4.3 (relationships) | "1:N" without detail | "Un {Parent} peut avoir combien de {Children} max ? Un {Child} peut-il exister sans {Parent} ?" |
65
- | Q4.4 (volume) | "Beaucoup" | "Ordre de grandeur : dizaines, centaines, milliers, millions ? Croissance par mois ?" |
66
- | Q4.4b (code pattern) | "User enters the code" or no answer | "Le code doit-il suivre un format spécifique ? (numéro séquentiel, date, combinaison ?)" |
67
- | Q4.4c (code strategy) | No answer | Propose strategy based on entity type: invoices/orders → timestamp-daily, employees/customers → sequential, references/categories → uuid-short, contracts → year-sequential, tickets → timestamp-minute |
68
- | Q4.4d (code prefix) | Too long or ambiguous | "Le préfixe est limité à 2-6 lettres minuscules. Exemple : 'emp' pour Employee, 'inv' pour Invoice, 'ctr' pour Contract." |
69
- | Q4.5 (validations) | Validations basiques seulement | "Y a-t-il des règles inter-champs ? (date fin > date début, montant selon statut)" |
70
- | Q4.8 (sensitive) | "Non" | "Pas de données personnelles (nom, email, téléphone) ? Pas de données financières ?" |
71
-
72
- ### Anti-patterns to Detect
73
-
74
- | Signal | Anti-pattern | Action |
75
- |--------|-------------|--------|
76
- | Entity "User" avec attributs métier | **Confusion User/Identity** | La plateforme gère les Users via Identity. L'entité métier = Client, Employee, Contact |
77
- | Attributs Id, TenantId, CreatedBy listés | **Champs techniques comme métier** | Ces champs sont auto-générés par `AuditableEntity`. Ne pas les lister. |
78
- | Pas de soft delete mentionné | **Suppression non clarifiée** | "Les données supprimées sont-elles effacées définitivement ou archivées ?" → `SoftDeletableEntity` |
79
- | Aucune contrainte d'unicité | **Unicité non vérifiée** | "Deux entités peuvent-elles avoir le même nom/code/email ?" |
80
-
81
- ### Entity Patterns
82
-
83
- | Besoin métier | Base class plateforme | Inclut automatiquement |
84
- |---------------|----------------------|----------------------|
85
- | Entité simple | `Entity` | Id, TenantId |
86
- | Avec audit | `AuditableEntity` | + CreatedBy, CreatedDate, ModifiedBy, ModifiedDate |
87
- | Avec suppression logique | `SoftDeletableEntity` | + IsDeleted, DeletedBy, DeletedDate |
88
- | Avec hiérarchie | `HierarchicalEntity` | + ParentId, Level, Path |
@@ -1,58 +0,0 @@
1
- # Category 5: Integrations
2
-
3
- > **Usage:** Connections with internal and external systems
4
- > **When to load:** If feature involves integrations
5
-
6
- ---
7
-
8
- ## 5.1 Existing Systems
9
-
10
- | # | Question | Answer Type |
11
- |---|----------|-------------|
12
- | Q5.1 | What internal systems should we integrate with? | List |
13
- | Q5.2 | What external systems? | List |
14
- | Q5.3 | Existing APIs to use? | Documentation |
15
- | Q5.4 | Data to import from another system? | List + format |
16
-
17
- ## 5.2 Data Flows
18
-
19
- | # | Question | Answer Type |
20
- |---|----------|-------------|
21
- | Q5.5 | Flow direction? (inbound/outbound/bidirectional) | Per system |
22
- | Q5.6 | Synchronization frequency? | Real-time/Batch |
23
- | Q5.7 | Data conflict management? | Strategy |
24
- | Q5.8 | Fallback if external system unavailable? | Behavior |
25
-
26
- ---
27
-
28
- ## Integration Patterns
29
-
30
- | Integration Type | Pattern | When to use |
31
- |-----------------|---------|-------------|
32
- | REST API | HttpClient + Polly | Appel synchrone à un service externe avec retry/circuit-breaker |
33
- | Message Queue | MassTransit | Communication asynchrone entre modules/services |
34
- | Webhook | Controller endpoint | Réception d'événements depuis un système externe |
35
- | Real-time | SignalR | Notifications temps réel vers le navigateur |
36
- | Batch import | Background job (Hangfire) | Import/traitement de gros volumes en arrière-plan |
37
- | File storage | Azure Blob / local | Upload/download de documents et pièces jointes |
38
-
39
- ## Elicitation Guide
40
-
41
- ### Follow-ups by Question
42
-
43
- | Question | If answer is vague/insufficient | Probe |
44
- |----------|-------------------------------|-------|
45
- | Q5.1 (internal) | "Aucun" | "Ce module doit-il notifier d'autres modules ? Lire des données d'un autre contexte ?" |
46
- | Q5.2 (external) | "Aucun" | "Pas d'envoi d'emails ? Pas de connexion ERP, CRM, comptabilité ? Pas de SSO externe ?" |
47
- | Q5.3 (APIs) | "Oui il y a une API" | "Avez-vous la documentation (Swagger/OpenAPI) ? Quel format (REST/SOAP/GraphQL) ? Auth (API key, OAuth) ?" |
48
- | Q5.6 (frequency) | "Temps réel" | "Temps réel = chaque seconde (SignalR) ou à chaque modification (event-driven) ? Quelle latence acceptable ?" |
49
- | Q5.7 (conflicts) | "Pas de conflits" | "Si le système externe envoie une donnée qui existe déjà, on écrase, on ignore ou on signale ?" |
50
- | Q5.8 (fallback) | "Ça ne devrait pas arriver" | "Si le service est down 1h, que fait l'utilisateur ? File d'attente, mode dégradé, retry ?" |
51
-
52
- ### Anti-patterns to Detect
53
-
54
- | Signal | Anti-pattern | Action |
55
- |--------|-------------|--------|
56
- | Intégration synchrone pour tout | **Couplage fort** | Si l'autre système peut être lent/down, proposer pattern asynchrone (MassTransit) |
57
- | "On verra plus tard pour l'intégration" | **Intégration non planifiée** | Documenter minimum : système cible, direction du flux, format attendu |
58
- | Pas de stratégie d'erreur | **Pas de résilience** | Toute intégration externe DOIT avoir un fallback (Polly retry + circuit breaker) |
@@ -1,68 +0,0 @@
1
- # Category 6: Security & Permissions
2
-
3
- > **Usage:** Definition of access and restrictions
4
- > **When to load:** ALWAYS (core, minimal)
5
-
6
- ---
7
-
8
- ## 6.1 Access
9
-
10
- | # | Question | Answer Type |
11
- |---|----------|-------------|
12
- | Q6.1 | Who can VIEW data? | List of roles |
13
- | Q6.2 | Who can CREATE entries? | List of roles |
14
- | Q6.3 | Who can MODIFY? | List of roles |
15
- | Q6.4 | Who can DELETE? | List of roles |
16
-
17
- ## 6.2 Restrictions
18
-
19
- | # | Question | Answer Type |
20
- |---|----------|-------------|
21
- | Q6.5 | Geographic restrictions? | Countries/regions |
22
- | Q6.6 | Time-based restrictions? (hours, periods) | Ranges |
23
- | Q6.7 | Audit trail required? Which actions? | List |
24
- | Q6.8 | Regulatory compliance? (GDPR, etc.) | List of standards |
25
-
26
- ---
27
-
28
- ## Platform Permission
29
-
30
- **Format:** `{application}.{module}.{action}`
31
-
32
- | Action | Permission |
33
- |--------|------------|
34
- | Read | `.read` |
35
- | Create | `.create` |
36
- | Update | `.update` |
37
- | Delete | `.delete` |
38
- | Export | `.export` |
39
- | Import | `.import` |
40
- | Admin | `.admin` |
41
-
42
- > **⚠️ RBAC ARCHITECTURE: La plateforme gère les rôles et permissions via son système RBAC intégré (HasData).**
43
- >
44
- > - Les rôles identifiés en Q6.1-Q6.4 sont des **ensembles de permissions**, pas des données métier
45
- > - L'accès est contrôlé par des permissions attribuées aux rôles, pas par des propriétés d'entité
46
- > - Ne jamais proposer de créer une entité `Role`, `UserRole`, ou un attribut `User.Role`
47
- > - Le mapping rôle → permissions se fait dans la **Permission Matrix** (step-03c-compile)
48
-
49
- ## Elicitation Guide
50
-
51
- ### Follow-ups by Question
52
-
53
- | Question | If answer is vague/insufficient | Probe |
54
- |----------|-------------------------------|-------|
55
- | Q6.1-Q6.4 (access) | "Admin peut tout faire" | "Tout = aussi supprimer ? Aussi exporter des données sensibles ? Aussi modifier les données d'un autre tenant ?" |
56
- | Q6.1-Q6.4 (access) | Un seul rôle défini | "Qui ne fait que consulter ? Qui peut modifier mais pas supprimer ? Qui valide les actions critiques ?" |
57
- | Q6.4 (delete) | "Tout le monde peut supprimer" | "Suppression logique ou physique ? Confirmation requise ? Possibilité de restaurer ?" |
58
- | Q6.7 (audit) | "Non" | "Pas besoin de savoir qui a modifié quoi et quand ? Pas de traçabilité réglementaire ?" |
59
- | Q6.8 (compliance) | "Pas concerné" | "Données personnelles (RGPD) ? Données financières (SOX) ? Données de santé (HDS) ?" |
60
-
61
- ### Anti-patterns to Detect
62
-
63
- | Signal | Anti-pattern | Action |
64
- |--------|-------------|--------|
65
- | "Admin = accès total sans restriction" | **Super-admin sans granularité** | Même l'admin devrait avoir des permissions explicites, pas un bypass global |
66
- | Aucune mention de multi-tenant | **Isolation oubliée** | La plateforme est multi-tenant : chaque requête est filtrée par TenantId automatiquement |
67
- | Pas d'audit trail | **Traçabilité absente** | `AuditableEntity` fournit CreatedBy/ModifiedBy. Suffisant ou besoin d'un audit log détaillé ? |
68
- | Permissions uniquement CRUD | **Actions métier non couvertes** | Y a-t-il des actions spécifiques ? (valider, approuver, archiver, publier) → permissions custom |
@@ -1,76 +0,0 @@
1
- # Category 7: User Interface
2
-
3
- > **Usage:** Definition of user experience
4
- > **When to load:** If feature is UI-centric or full module
5
-
6
- ---
7
-
8
- ## 7.1 Experience
9
-
10
- | # | Question | Answer Type |
11
- |---|----------|-------------|
12
- | Q7.1 | Target devices? (desktop, mobile, tablet) | List |
13
- | Q7.2 | Browsers to support? | List + versions |
14
- | Q7.3 | Accessibility required? (WCAG level) | A/AA/AAA |
15
- | Q7.4 | Dark/light mode required? | Yes/No |
16
-
17
- ## 7.2 Screens
18
-
19
- | # | Question | Answer Type |
20
- |---|----------|-------------|
21
- | Q7.5 | Main screens needed? | List |
22
- | Q7.6 | Existing mockups/wireframes? | Documents |
23
- | Q7.7 | Key information per screen? | Per screen |
24
- | Q7.8 | Possible actions per screen? | Per screen |
25
-
26
- ## 7.3 Dashboards & Analytics
27
-
28
- | # | Question | Answer Type |
29
- |---|----------|-------------|
30
- | Q7.9 | Dashboards ou tableaux de bord requis ? | List (noms + descriptions) |
31
- | Q7.10 | KPIs à afficher par dashboard ? | Per dashboard: nom, métrique, format (number/currency/percent), seuils |
32
- | Q7.11 | Types de graphiques souhaités ? | Per KPI: bar, line, pie, area, scatter, kpi-card |
33
- | Q7.12 | Filtres temporels ? | Période par défaut + plages disponibles (jour/semaine/mois/trimestre/année) |
34
-
35
- ---
36
-
37
- ## UI Components
38
-
39
- | Need | Component | Détail |
40
- |------|-----------|--------|
41
- | List with pagination | DataTable | Tri, pagination, sélection, actions inline |
42
- | Creation form | Form page (`/create` route) | Validation FluentValidation, i18n des erreurs |
43
- | Edit form | Form page (`/:id/edit` route) | Pré-remplissage, dirty check, optimistic locking |
44
- | Filters | FilterBar | Filtres combinables, persistance URL params |
45
- | Export | ExportButton | CSV/Excel, respecte les filtres actifs |
46
- | Cards/Grid | CardGrid | Affichage visuel alternatif au tableau |
47
- | Detail view | DetailPanel | Side panel ou page dédiée |
48
- | Status/Workflow | StatusBadge + Timeline | Affichage état + historique transitions |
49
- | Tooltips/Infobulles | Tooltip | Info contextuelle sur champs/actions |
50
- | KPI Card | StatCard | Valeur numérique + tendance + icône |
51
- | Chart (Bar/Line/Pie) | RechartsChart | Graphique interactif via Recharts |
52
- | Dashboard layout | DashboardGrid | Grille responsive de KPI + charts |
53
-
54
- ## Elicitation Guide
55
-
56
- ### Follow-ups by Question
57
-
58
- | Question | If answer is vague/insufficient | Probe |
59
- |----------|-------------------------------|-------|
60
- | Q7.1 (devices) | "Desktop uniquement" | "Aucun accès mobile ? Même pas en consultation ? Tablette en atelier/terrain ?" |
61
- | Q7.5 (screens) | "Un écran de liste" | "Avec pages dédiées pour création et édition ? Détail en page avec onglets ?" |
62
- | Q7.5 (screens) | Pas de mention dashboard | "L'utilisateur a-t-il besoin d'un tableau de bord avec des KPIs avant de plonger dans les données ?" |
63
- | Q7.7 (key info) | "Toutes les colonnes" | "Sur mobile/petit écran, quelles 3-4 colonnes sont indispensables ? Le reste = détail secondaire" |
64
- | Q7.8 (actions) | "CRUD classique" | "Actions métier spécifiques ? (valider, dupliquer, archiver, changer statut, assigner)" |
65
- | Q7.9 (dashboards) | "Juste des chiffres" | "Les tendances/comparaisons ne seraient-elles pas plus lisibles en graphique ? Bar chart pour comparer, line chart pour évoluer ?" |
66
- | Q7.10 (KPIs) | Pas de seuils définis | "À partir de quel seuil un KPI est-il en alerte ? En critique ? (ex: stock < 10 = warning, < 3 = critique)" |
67
-
68
- ### Anti-patterns to Detect
69
-
70
- | Signal | Anti-pattern | Action |
71
- |--------|-------------|--------|
72
- | "Un seul gros formulaire avec tout" | **Formulaire monolithique** | Proposer des étapes/wizard ou des onglets par section logique |
73
- | Aucune mention de feedback utilisateur | **UX silencieuse** | "Quels messages de succès/erreur ? Toast, notification, redirect ?" |
74
- | "Identique à [autre app]" | **Copier sans adapter** | "Quelles différences de contexte ? L'utilisateur fait-il le même parcours ?" |
75
- | Actions sans confirmation | **Actions destructives non protégées** | "La suppression nécessite-t-elle une confirmation ? Un motif ? Une double validation ?" |
76
- | "Juste des chiffres sur la page" | **Dashboard sans visualisation** | "Les tendances/comparaisons ne seraient-elles pas plus lisibles en graphique ? Bar chart pour comparer, line chart pour évoluer ?" |