@atlashub/smartstack-cli 1.13.2 → 1.14.0

package/templates/skills/business-analyse/templates-frd.md

@@ -1,7 +1,7 @@
-# Templates FRD - Business Analyse
+# Templates FRD - Business Analysis
 
-> **Usage:** Templates pour les documents de spécification fonctionnelle (FRD)
-> **Contexte:** Business > Application > Module > Section
+> **Usage:** Templates for functional specification documents (FRD)
+> **Context:** Business > Application > Module > Section
 
 ---
 
@@ -13,65 +13,65 @@
 > **Module:** business/{application}/{module}
 > **Version:** 1.0
 > **Date:** {YYYY-MM-DD}
-> **Auteur:** Business Analyst
+> **Author:** Business Analyst
 
-## 1. Contexte Business
+## 1. Business Context
 
-### 1.1 Description du besoin
-{Description claire du besoin métier exprimé par le stakeholder}
+### 1.1 Need Description
+{Clear description of the business need expressed by the stakeholder}
 
-### 1.2 Problème actuel
-{Situation actuelle et ses limitations}
+### 1.2 Current Problem
+{Current situation and its limitations}
 
-### 1.3 Valeur attendue
-{Bénéfices business mesurables}
+### 1.3 Expected Value
+{Measurable business benefits}
 
 ## 2. Stakeholders
 
-| Rôle | Nom/Fonction | Implication | Niveau décision |
+| Role | Name/Function | Involvement | Decision Level |
 |------|--------------|-------------|-----------------|
-| Sponsor | {nom} | {description} | Approbateur |
-| Product Owner | {nom} | {description} | Décideur |
-| Utilisateur clé | {nom} | {description} | Consulté |
+| Sponsor | {name} | {description} | Approver |
+| Product Owner | {name} | {description} | Decision Maker |
+| Key User | {name} | {description} | Consulted |
 
-## 3. Périmètre
+## 3. Scope
 
 ### 3.1 In Scope
-- [ ] {Fonctionnalité incluse 1}
-- [ ] {Fonctionnalité incluse 2}
+- [ ] {Included feature 1}
+- [ ] {Included feature 2}
 
 ### 3.2 Out of Scope
-- {Exclusion explicite 1}
-- {Exclusion explicite 2}
+- {Explicit exclusion 1}
+- {Explicit exclusion 2}
 
-## 4. Questions ouvertes
+## 4. Open Questions
 
-| # | Question | Réponse | Statut |
+| # | Question | Answer | Status |
 |---|----------|---------|--------|
-| Q1 | {Question} | {Réponse ou "En attente"} | ⏳/✅ |
+| Q1 | {Question} | {Answer or "Pending"} | ⏳/✅ |
 
-## 5. Contraintes identifiées
+## 5. Identified Constraints
 
-| Type | Contrainte | Impact |
+| Type | Constraint | Impact |
 |------|------------|--------|
-| Technique | {contrainte} | {impact} |
-| Budget | {contrainte} | {impact} |
-| Délai | {contrainte} | {impact} |
-| Réglementaire | {contrainte} | {impact} |
+| Technical | {constraint} | {impact} |
+| Budget | {constraint} | {impact} |
+| Schedule | {constraint} | {impact} |
+| Regulatory | {constraint} | {impact} |
 
-## 6. Dépendances
+## 6. Dependencies
 
-| Dépendance | Type | Module/Système | Criticité |
+| Dependency | Type | Module/System | Criticality |
 |------------|------|----------------|-----------|
-| {dép} | Interne/Externe | {module} | Haute/Moyenne/Basse |
+| {dep} | Internal/External | {module} | High/Medium/Low |
 
 ---
 
-## Historique des versions
+## Version History
 
-| Version | Date | Auteur | Modifications |
-|---------|------|--------|---------------|
-| 1.0 | {date} | BA | Création initiale |
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | {date} | BA | Initial creation |
 ```
 
 ---
@@ -83,90 +83,90 @@
 
 > **Module:** business/{application}/{module}
 > **Version:** 1.0
-> **Basé sur:** 1-discovery.md v1.0
+> **Based on:** 1-discovery.md v1.0
 
-## 1. Résumé exécutif
+## 1. Executive Summary
 
-{Synthèse en 3-5 phrases du besoin business et de la solution proposée}
+{3-5 sentence summary of the business need and proposed solution}
 
-## 2. Objectifs business
+## 2. Business Objectives
 
-| ID | Objectif | Métrique | Cible |
-|----|----------|----------|-------|
-| OBJ-001 | {objectif} | {KPI mesurable} | {valeur cible} |
+| ID | Objective | Metric | Target |
+|----|----------|--------|--------|
+| OBJ-001 | {objective} | {Measurable KPI} | {target value} |
 
-## 3. Règles métier
+## 3. Business Rules
 
-| ID | Règle | Catégorie | Priorité |
-|----|-------|-----------|----------|
-| BR-001 | {Description de la règle métier} | Validation/Calcul/Workflow | Must/Should/Could |
-| BR-002 | {Description} | {catégorie} | {priorité} |
+| ID | Rule | Category | Priority |
+|----|------|----------|----------|
+| BR-001 | {Business rule description} | Validation/Calculation/Workflow | Must/Should/Could |
+| BR-002 | {Description} | {category} | {priority} |
 
-### 3.1 Détail des règles critiques
+### 3.1 Critical Rules Detail
 
-#### BR-001: {Nom règle}
+#### BR-001: {Rule Name}
 
-**Énoncé:** {Formulation précise de la règle}
+**Statement:** {Precise rule formulation}
 
 **Conditions:**
-- SI {condition A}
-- ET {condition B}
-- ALORS {résultat}
-- SINON {résultat alternatif}
+- IF {condition A}
+- AND {condition B}
+- THEN {result}
+- ELSE {alternative result}
 
-**Exemples:**
-| Entrée | Sortie attendue |
+**Examples:**
+| Input | Expected Output |
 |--------|-----------------|
-| {exemple 1} | {résultat 1} |
-| {exemple 2} | {résultat 2} |
+| {example 1} | {result 1} |
+| {example 2} | {result 2} |
 
-## 4. Processus métier
+## 4. Business Process
 
-### 4.1 Processus principal
+### 4.1 Main Process
 
 ```
 ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
-│   Étape 1   │────►│   Étape 2   │────►│   Étape 3   │
+│   Step 1    │────►│   Step 2    │────►│   Step 3    │
 │  {action}   │     │  {action}   │     │  {action}   │
 └─────────────┘     └─────────────┘     └─────────────┘
       │                   │                   │
       ▼                   ▼                   ▼
-  {acteur}            {acteur}            {acteur}
+   {actor}            {actor}            {actor}
 ```
 
-### 4.2 Flux alternatifs
+### 4.2 Alternative Flows
 
-| Déclencheur | Flux | Résultat |
-|-------------|------|----------|
-| {condition} | {description du flux} | {état final} |
+| Trigger | Flow | Result |
+|---------|------|--------|
+| {condition} | {flow description} | {final state} |
 
-## 5. Données métier
+## 5. Business Data
 
-### 5.1 Entités principales
+### 5.1 Main Entities
 
-| Entité | Description | Cardinalité |
+| Entity | Description | Cardinality |
 |--------|-------------|-------------|
-| {Entité} | {description} | 1:N avec {autre entité} |
+| {Entity} | {description} | 1:N with {other entity} |
 
-### 5.2 Attributs clés (PAS de types techniques)
+### 5.2 Key Attributes (NO technical types)
 
-| Entité | Attribut | Description | Obligatoire |
-|--------|----------|-------------|-------------|
-| {Entité} | {attribut} | {description métier} | Oui/Non |
+| Entity | Attribute | Description | Required |
+|--------|-----------|-------------|----------|
+| {Entity} | {attribute} | {business description} | Yes/No |
 
-## 6. Intégrations
+## 6. Integrations
 
-| Système | Direction | Données | Fréquence |
-|---------|-----------|---------|-----------|
-| {système} | Entrée/Sortie/Bidirectionnel | {données} | Temps réel/Batch |
+| System | Direction | Data | Frequency |
+|--------|-----------|------|-----------|
+| {system} | Input/Output/Bidirectional | {data} | Real-time/Batch |
 
 ---
 
-## Historique des versions
+## Version History
 
-| Version | Date | Auteur | Modifications |
-|---------|------|--------|---------------|
-| 1.0 | {date} | BA | Création initiale |
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | {date} | BA | Initial creation |
 ```
 
 ---
@@ -178,71 +178,71 @@
 
 > **Module:** business/{application}/{module}
 > **Version:** 1.0
-> **Basé sur:** 2-brd.md v1.0
+> **Based on:** 2-brd.md v1.0
 > **Permission path:** business.{application}.{module}.*
 
-## 1. Vue d'ensemble
+## 1. Overview
 
-### 1.1 Objectif fonctionnel
-{Description de ce que le système doit faire}
+### 1.1 Functional Objective
+{Description of what the system must do}
 
-### 1.2 Acteurs
+### 1.2 Actors
 
-| Acteur | Description | Permissions requises |
+| Actor | Description | Required Permissions |
 |--------|-------------|---------------------|
-| {Rôle} | {description} | `business.{app}.{module}.{action}` |
+| {Role} | {description} | `business.{app}.{module}.{action}` |
 
-## 2. Cas d'utilisation
+## 2. Use Cases
 
-### UC-001: {Nom du cas d'utilisation}
+### UC-001: {Use Case Name}
 
-| Attribut | Valeur |
+| Attribute | Value |
 |----------|--------|
 | **ID** | UC-001 |
-| **Nom** | {Nom} |
-| **Acteur principal** | {Rôle} |
-| **Préconditions** | {conditions requises} |
-| **Postconditions** | {état final} |
+| **Name** | {Name} |
+| **Primary Actor** | {Role} |
+| **Preconditions** | {required conditions} |
+| **Postconditions** | {final state} |
 | **Permission** | `business.{app}.{module}.{action}` |
 
-**Scénario principal:**
-1. L'utilisateur {action}
-2. Le système {réponse}
-3. L'utilisateur {action}
-4. Le système {réponse}
+**Main Scenario:**
+1. The user {action}
+2. The system {response}
+3. The user {action}
+4. The system {response}
 
-**Scénarios alternatifs:**
+**Alternative Scenarios:**
 
-| # | Condition | Étapes |
-|---|-----------|--------|
+| # | Condition | Steps |
+|---|-----------|-------|
 | 3a | {condition} | 3a.1 {action}, 3a.2 {action} |
 
-**Scénarios d'erreur:**
+**Error Scenarios:**
 
-| # | Erreur | Message | Action |
-|---|--------|---------|--------|
-| E1 | {erreur} | {message utilisateur} | {comportement} |
+| # | Error | Message | Action |
+|---|-------|---------|--------|
+| E1 | {error} | {user message} | {behavior} |
 
-## 3. Exigences fonctionnelles
+## 3. Functional Requirements
 
-| ID | Exigence | UC lié | Priorité |
-|----|----------|--------|----------|
-| FR-001 | {Le système DOIT...} | UC-001 | Must |
-| FR-002 | {Le système DEVRAIT...} | UC-001 | Should |
+| ID | Requirement | Related UC | Priority |
+|----|-------------|------------|----------|
+| FR-001 | {The system MUST...} | UC-001 | Must |
+| FR-002 | {The system SHOULD...} | UC-001 | Should |
 
-### 3.1 Détail FR-001
+### 3.1 Detail FR-001
 
-**Énoncé:** Le système DOIT {action spécifique}
+**Statement:** The system MUST {specific action}
 
-**Critères d'acceptation:**
-- [ ] {Critère mesurable 1}
-- [ ] {Critère mesurable 2}
+**Acceptance Criteria:**
+- [ ] {Measurable criterion 1}
+- [ ] {Measurable criterion 2}
 
-**Règles associées:** BR-001, BR-002
+**Associated Rules:** BR-001, BR-002
 
-## 4. Interface utilisateur
+## 4. User Interface
 
-### 4.1 Wireframe - Écran principal
+### 4.1 Wireframe - Main Screen
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
@@ -250,12 +250,12 @@
 ├─────────────────────────────────────────────────────────────┤
 │                                                             │
 │  ┌─────────────────────────────────────────────────────┐   │
-│  │ FILTRE                                               │   │
-│  │ [Champ 1 ▼] [Champ 2 ▼] [Rechercher]               │   │
+│  │ FILTER                                               │   │
+│  │ [Field 1 ▼] [Field 2 ▼] [Search]                   │   │
 │  └─────────────────────────────────────────────────────┘   │
 │                                                             │
 │  ┌─────────────────────────────────────────────────────┐   │
-│  │ TABLEAU                                              │   │
+│  │ TABLE                                                │   │
 │  │ ┌────────┬────────┬────────┬─────────┐              │   │
 │  │ │ Col 1  │ Col 2  │ Col 3  │ Actions │              │   │
 │  │ ├────────┼────────┼────────┼─────────┤              │   │
@@ -263,37 +263,37 @@
 │  │ └────────┴────────┴────────┴─────────┘              │   │
 │  └─────────────────────────────────────────────────────┘   │
 │                                                             │
-│  [+ Nouveau]                           [< Prev] [Next >]   │
+│  [+ New]                                [< Prev] [Next >]  │
 │                                                             │
 └─────────────────────────────────────────────────────────────┘
 ```
 
-### 4.2 Description des éléments UI
+### 4.2 UI Element Description
 
-| Élément | Type | Comportement | Permission |
-|---------|------|--------------|------------|
-| [+ Nouveau] | Bouton | Ouvre modal création | `{module}.create` |
-| [E] | Icône | Ouvre modal édition | `{module}.update` |
-| [D] | Icône | Confirmation + suppression | `{module}.delete` |
+| Element | Type | Behavior | Permission |
+|---------|------|----------|------------|
+| [+ New] | Button | Opens create modal | `{module}.create` |
+| [E] | Icon | Opens edit modal | `{module}.update` |
+| [D] | Icon | Confirmation + delete | `{module}.delete` |
 
-## 5. Validation et messages
+## 5. Validation and Messages
 
 ### 5.1 Validations
 
-| Champ | Règle | Message erreur |
-|-------|-------|----------------|
-| {champ} | {règle de validation} | {message i18n key} |
+| Field | Rule | Error Message |
+|-------|------|----------------|
+| {field} | {validation rule} | {message i18n key} |
 
-### 5.2 Messages système
+### 5.2 System Messages
 
-| Code | Type | Message (clé i18n) |
+| Code | Type | Message (i18n key) |
 |------|------|-------------------|
 | MSG-001 | Success | `{module}.messages.created` |
 | MSG-002 | Error | `{module}.errors.notFound` |
 
-## 6. Permissions détaillées
+## 6. Detailed Permissions
 
-### 6.1 Matrice Rôle-Permission
+### 6.1 Role-Permission Matrix
 
 | Permission | Admin | Manager | User | ReadOnly |
 |------------|-------|---------|------|----------|
@@ -302,16 +302,16 @@
 | `business.{app}.{module}.update` | ✅ | ✅ | ❌ | ❌ |
 | `business.{app}.{module}.delete` | ✅ | ❌ | ❌ | ❌ |
 
-### 6.2 Mapping Endpoint-Permission
+### 6.2 Endpoint-Permission Mapping
 
-| Endpoint | Méthode | Permission requise |
-|----------|---------|-------------------|
+| Endpoint | Method | Required Permission |
+|----------|--------|-------------------|
 | `/api/business/{module}` | GET | `{module}.read` |
 | `/api/business/{module}` | POST | `{module}.create` |
 | `/api/business/{module}/{id}` | PUT | `{module}.update` |
 | `/api/business/{module}/{id}` | DELETE | `{module}.delete` |
 
-## 7. Scénarios Gherkin
+## 7. Gherkin Scenarios
 
 ```gherkin
 Feature: {FEAT-XXX} {Feature Name}
@@ -336,11 +336,11 @@ Feature: {FEAT-XXX} {Feature Name}
 
 ---
 
-## Historique des versions
+## Version History
 
-| Version | Date | Auteur | Modifications |
-|---------|------|--------|---------------|
-| 1.0 | {date} | BA | Création initiale |
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | {date} | BA | Initial creation |
 ```
 
 ---
@@ -352,126 +352,126 @@ Feature: {FEAT-XXX} {Feature Name}
 
 > **Module:** business/{application}/{module}
 > **Version:** 1.0
-> **Specs validées:** FRD v1.0 (validation.json)
-> **Implémentation:** `/implement FEAT-XXX`
+> **Validated Specs:** FRD v1.0 (validation.json)
+> **Implementation:** `/implement FEAT-XXX`
 
-## INSTRUCTIONS DÉVELOPPEUR
+## DEVELOPER INSTRUCTIONS
 
-Ce document est un prompt autonome pour Claude Code. Exécutez:
+This document is a self-contained prompt for Claude Code. Execute:
 ```
 /implement FEAT-XXX
 ```
 
 ---
 
-## 1. CONTEXTE RAPIDE
+## 1. QUICK CONTEXT
 
-| Attribut | Valeur |
+| Attribute | Value |
 |----------|--------|
 | Feature ID | FEAT-XXX |
 | Module | business/{application}/{module} |
-| Permission base | `business.{app}.{module}` |
-| Complexité | {Simple/Moyenne/Complexe} |
+| Base Permission | `business.{app}.{module}` |
+| Complexity | {Simple/Medium/Complex} |
 
-## 2. [EXPLORE] PATTERNS EXISTANTS
+## 2. [EXPLORE] EXISTING PATTERNS
 
-AVANT de coder, explorer ces fichiers pour comprendre les patterns:
+BEFORE coding, explore these files to understand the patterns:
 
 ```
 BACKEND:
-- src/SmartStack.Domain/Entities/ → Structure entités
-- src/SmartStack.Application/Features/ → Pattern CQRS
+- src/SmartStack.Domain/Entities/ → Entity structure
+- src/SmartStack.Application/Features/ → CQRS pattern
 - src/SmartStack.Infrastructure/Persistence/Configurations/ → EF Core
 
 FRONTEND:
-- web/smartstack-web/src/pages/business/ → Pages existantes
-- web/smartstack-web/src/components/ → Composants réutilisables
-- web/smartstack-web/src/services/api/ → Appels API
+- web/smartstack-web/src/pages/business/ → Existing pages
+- web/smartstack-web/src/components/ → Reusable components
+- web/smartstack-web/src/services/api/ → API calls
 ```
 
-## 3. FICHIERS À CRÉER
+## 3. FILES TO CREATE
 
 ### 3.1 Backend
 
-| Fichier | Template | Description |
-|---------|----------|-------------|
-| `Domain/Entities/{Entity}.cs` | Entité Domain | Propriétés + règles métier |
-| `Application/Features/{Module}/` | CQRS Commands/Queries | Handlers MediatR |
-| `Infrastructure/.../Configurations/` | EF Core Config | HasData si seed |
-| `Api/Controllers/Business/` | Controller API | Endpoints REST |
+| File | Template | Description |
+|------|----------|-------------|
+| `Domain/Entities/{Entity}.cs` | Domain Entity | Properties + business rules |
+| `Application/Features/{Module}/` | CQRS Commands/Queries | MediatR handlers |
+| `Infrastructure/.../Configurations/` | EF Core Config | Config + HasData |
+| `Api/Controllers/Business/` | API Controller | REST endpoints |
 
 ### 3.2 Frontend
 
-| Fichier | Template | Description |
-|---------|----------|-------------|
-| `pages/business/{app}/{module}/` | Page React | Liste + détail |
-| `services/api/{module}Api.ts` | Service API | Appels axios |
-| `i18n/locales/{lang}/{module}.json` | Traductions | FR, EN, IT, DE |
+| File | Template | Description |
+|------|----------|-------------|
+| `pages/business/{app}/{module}/` | React Page | List + detail |
+| `services/api/{module}Api.ts` | API Service | Axios calls |
+| `i18n/locales/{lang}/{module}.json` | Translations | FR, EN, IT, DE |
 
-## 4. SPÉCIFICATIONS DÉTAILLÉES
+## 4. DETAILED SPECIFICATIONS
 
-### 4.1 Entité (attributs business, pas types C#)
+### 4.1 Entity (business attributes, not C# types)
 
-| Attribut | Description | Obligatoire | Règles |
-|----------|-------------|-------------|--------|
-| Id | Identifiant unique | Oui | GUID aléatoire |
-| {attr} | {description} | {Oui/Non} | {validation} |
+| Attribute | Description | Required | Rules |
+|-----------|-------------|----------|-------|
+| Id | Unique identifier | Yes | Random GUID |
+| {attr} | {description} | {Yes/No} | {validation} |
 
-### 4.2 Endpoints API
+### 4.2 API Endpoints
 
-| Endpoint | Méthode | Permission | Body | Response |
-|----------|---------|------------|------|----------|
-| `/api/business/{module}` | GET | `.read` | - | Liste paginée |
-| `/api/business/{module}` | POST | `.create` | CreateDto | 201 + entité |
-| `/api/business/{module}/{id}` | GET | `.read` | - | Entité |
-| `/api/business/{module}/{id}` | PUT | `.update` | UpdateDto | 200 + entité |
+| Endpoint | Method | Permission | Body | Response |
+|----------|--------|------------|------|----------|
+| `/api/business/{module}` | GET | `.read` | - | Paginated list |
+| `/api/business/{module}` | POST | `.create` | CreateDto | 201 + entity |
+| `/api/business/{module}/{id}` | GET | `.read` | - | Entity |
+| `/api/business/{module}/{id}` | PUT | `.update` | UpdateDto | 200 + entity |
 | `/api/business/{module}/{id}` | DELETE | `.delete` | - | 204 |
 
-### 4.3 Règles métier à implémenter
+### 4.3 Business Rules to Implement
 
-| BR-ID | Règle | Implémentation |
-|-------|-------|----------------|
-| BR-001 | {règle} | {où l'implémenter} |
+| BR-ID | Rule | Implementation |
+|-------|------|----------------|
+| BR-001 | {rule} | {where to implement} |
 
-## 5. TESTS REQUIS
+## 5. REQUIRED TESTS
 
-- [ ] Test unitaire: Validation entité
-- [ ] Test integration: Endpoints API (200, 201, 400, 403, 404)
-- [ ] Test permission: Refus 403 sans permission
-- [ ] Test Postman: Collection générée
+- [ ] Unit test: Entity validation
+- [ ] Integration test: API endpoints (200, 201, 400, 403, 404)
+- [ ] Permission test: 403 denial without permission
+- [ ] Postman test: Collection generated
 
-## 6. CHECKLIST POST-IMPLÉMENTATION
+## 6. POST-IMPLEMENTATION CHECKLIST
 
-- [ ] Build backend OK
-- [ ] Build frontend OK
-- [ ] Tests passent
-- [ ] Migration EF Core créée si entité
-- [ ] Permissions ajoutées dans PermissionConfiguration.cs
-- [ ] i18n complet (4 langues)
-- [ ] Documentation générée: `/business-analyse:7-doc-html FEAT-XXX`
+- [ ] Backend build OK
+- [ ] Frontend build OK
+- [ ] Tests passing
+- [ ] EF Core migration created if entity
+- [ ] Permissions added in PermissionConfiguration.cs
+- [ ] i18n complete (4 languages)
+- [ ] Documentation generated: `/business-analyse:7-doc-html FEAT-XXX`
 
 ---
 
-## EXÉCUTION
+## EXECUTION
 
 ```bash
 /implement FEAT-XXX
 ```
 
 Options:
-- `--phase=1` : Backend seulement
-- `--phase=2` : Frontend seulement
-- `--phase=3` : Tests seulement
-- `--phase=4` : Documentation seulement
+- `--phase=1` : Backend only
+- `--phase=2` : Frontend only
+- `--phase=3` : Tests only
+- `--phase=4` : Documentation only
 ```
 
 ---
 
-## Validation des templates
+## Template Validation
 
-Chaque template DOIT:
-- [ ] Être en Markdown pur (pas de code technique)
-- [ ] Utiliser des tables pour les données structurées
-- [ ] Inclure les permissions avec le path complet
-- [ ] Avoir un historique de versions
-- [ ] Référencer les BR/FR/UC avec des IDs uniques
+Each template MUST:
+- [ ] Be pure Markdown (no technical code)
+- [ ] Use tables for structured data
+- [ ] Include permissions with full path
+- [ ] Have version history
+- [ ] Reference BR/FR/UC with unique IDs