@atlashub/smartstack-cli 1.13.2 → 1.14.0

package/templates/skills/controller/templates.md

@@ -1,7 +1,7 @@
-# Templates Controller SmartStack
+# SmartStack Controller Templates
 
-> **Note:** Ces templates sont utilisés par le skill `controller` et la commande `/controller:create`.
-> Adapter les variables `{Area}`, `{Module}`, `{Entity}`, `{PermissionPath}` selon le contexte.
+> **Note:** These templates are used by the `controller` skill and `/controller:create` command.
+> Adapt variables `{Area}`, `{Module}`, `{Entity}`, `{PermissionPath}` according to context.
 
 ---
 
@@ -341,7 +341,7 @@ public record PagedResult<T>(
 
 ```csharp
 // src/SmartStack.Api/Controllers/AuthController.cs
-// NOTE: Ce controller existe déjà - utiliser comme référence pour patterns auth
+// NOTE: This controller already exists - use as reference for auth patterns
 
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
@@ -406,7 +406,7 @@ public class AuthController : ControllerBase
             _logger.LogWarning(
                 "Login failed: Account disabled - {Email} from {IpAddress}",
                 request.Email, ipAddress);
-            return Unauthorized(new ErrorResponse("Compte désactivé", "ACCOUNT_DISABLED"));
+            return Unauthorized(new ErrorResponse("Account disabled", "ACCOUNT_DISABLED"));
         }
 
         if (user.IsLocked)
@@ -415,7 +415,7 @@ public class AuthController : ControllerBase
             _logger.LogCritical(
                 "SECURITY: Login attempt on locked account - User: {Email} (ID: {UserId}) from {IpAddress}",
                 request.Email, user.Id, ipAddress);
-            return Unauthorized(new ErrorResponse("Compte verrouillé", "ACCOUNT_LOCKED_BY_ADMIN"));
+            return Unauthorized(new ErrorResponse("Account locked", "ACCOUNT_LOCKED_BY_ADMIN"));
         }
 
         // Check brute force protection
@@ -429,7 +429,7 @@ public class AuthController : ControllerBase
             _logger.LogCritical(
                 "SECURITY: Account temporarily locked due to brute force - User: {Email} (ID: {UserId}) from {IpAddress}",
                 request.Email, user.Id, ipAddress);
-            return Unauthorized(new ErrorResponse("Compte temporairement verrouillé", "ACCOUNT_LOCKED"));
+            return Unauthorized(new ErrorResponse("Account temporarily locked", "ACCOUNT_LOCKED"));
         }
 
         if (!_passwordService.VerifyPassword(request.Password, user.PasswordHash))
@@ -512,7 +512,7 @@ public class AuthController : ControllerBase
             "Password changed for user {Email} - All sessions invalidated",
             user.Email);
 
-        return Ok(new ChangePasswordResponse("Mot de passe modifié", true));
+        return Ok(new ChangePasswordResponse("Password changed", true));
     }
 
     #endregion
@@ -533,7 +533,7 @@ public class AuthController : ControllerBase
 
 ```csharp
 // src/SmartStack.Application/Common/Authorization/Permissions.cs
-// AJOUTER dans la classe existante
+// ADD to existing class
 
 public static class Permissions
 {
@@ -546,7 +546,7 @@ public static class Permissions
         public const string Create = "{permission.path}.create";
         public const string Update = "{permission.path}.update";
         public const string Delete = "{permission.path}.delete";
-        // Optionnel selon module
+        // Optional depending on module
         public const string Assign = "{permission.path}.assign";
         public const string Execute = "{permission.path}.execute";
         public const string Export = "{permission.path}.export";
@@ -558,31 +558,31 @@ public static class Permissions
 
 ## Template PermissionConfiguration Seed
 
-> **CRITIQUE:** Ce template est OBLIGATOIRE. Sans ces entrées, tous les appels API retourneront 403 Forbidden.
+> **CRITICAL:** This template is MANDATORY. Without these entries, all API calls will return 403 Forbidden.
 
 ```csharp
 // src/SmartStack.Infrastructure/Persistence/Configurations/Navigation/PermissionConfiguration.cs
-// AJOUTER dans la méthode Configure(), section HasData
+// ADD in Configure() method, HasData section
 
 // ============================================
-// ÉTAPE 1: Déclarer le ModuleId
+// STEP 1: Declare ModuleId
 // ============================================
-// Vérifier dans ModuleConfiguration.cs si le module existe déjà
-// Sinon, créer le module d'abord via /application skill
+// Check in ModuleConfiguration.cs if module already exists
+// Otherwise, create the module first via /application skill
 
-var {module}ModuleId = Guid.Parse("{GUID-DU-MODULE}");  // Récupérer depuis ModuleConfiguration.cs
+var {module}ModuleId = Guid.Parse("{MODULE-GUID}");  // Get from ModuleConfiguration.cs
 
 // ============================================
-// ÉTAPE 2: Ajouter les permissions (HasData)
+// STEP 2: Add permissions (HasData)
 // ============================================
 
 // Pattern: {context}.{application}.{module}.{action}
-// Exemple: platform.administration.users.read
+// Example: platform.administration.users.read
 
 var seedDate = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);
 
 builder.HasData(
-    // Wildcard permission (accès complet au module)
+    // Wildcard permission (full module access)
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-1}"),
@@ -647,13 +647,13 @@ builder.HasData(
         CreatedAt = seedDate
     }
 
-    // Actions optionnelles selon le module:
-    // - PermissionAction.Assign  → Pour assigner des ressources/rôles
-    // - PermissionAction.Execute → Pour exécuter des actions (export, etc.)
+    // Optional actions depending on module:
+    // - PermissionAction.Assign  → To assign resources/roles
+    // - PermissionAction.Execute → To execute actions (export, etc.)
 );
 ```
 
-### Génération de GUIDs
+### GUID Generation
 
 ```bash
 # PowerShell (Windows)
@@ -663,13 +663,13 @@ builder.HasData(
 uuidgen | tr '[:upper:]' '[:lower:]'
 ```
 
-### Validation Cohérence Permissions.cs ↔ PermissionConfiguration.cs
+### Validation Consistency Permissions.cs ↔ PermissionConfiguration.cs
 
-> **RÈGLE:** Chaque constante dans `Permissions.cs` DOIT avoir une entrée correspondante dans `PermissionConfiguration.cs`
+> **RULE:** Each constant in `Permissions.cs` MUST have a corresponding entry in `PermissionConfiguration.cs`
 
 ```
 ┌─────────────────────────────────────────────────────────────────────────────┐
-│                         VALIDATION DE COHÉRENCE                             │
+│                         CONSISTENCY VALIDATION                             │
 ├─────────────────────────────────────────────────────────────────────────────┤
 │                                                                             │
 │  Permissions.cs                    PermissionConfiguration.cs               │
@@ -679,26 +679,26 @@ uuidgen | tr '[:upper:]' '[:lower:]'
 │  Permissions.Support.Tickets.Update→  Path = "platform.support.tickets.update"│
 │  Permissions.Support.Tickets.Delete→  Path = "platform.support.tickets.delete"│
 │                                                                             │
-│  ⚠️  ERREUR FRÉQUENTE:                                                      │
+│  WARNING: COMMON ERROR:                                                    │
 │  - Permissions.cs: "platform.support.tickets.read"                          │
-│  - PermissionConfiguration.cs: MANQUANT                                     │
-│  → Résultat: 403 Forbidden pour TOUS les utilisateurs                       │
+│  - PermissionConfiguration.cs: MISSING                                     │
+│  → Result: 403 Forbidden for ALL users                                     │
 │                                                                             │
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
 
-### Commande post-génération
+### Post-generation commands
 
-Après avoir ajouté les entrées dans les deux fichiers:
+After adding entries in both files:
 
 ```bash
-# 1. Créer la migration
+# 1. Create migration
 /efcore:migration Add{Module}Permissions
 
-# 2. Appliquer la migration
+# 2. Apply migration
 /efcore:db-deploy
 
-# 3. Vérifier (optionnel)
+# 3. Verify (optional)
 /efcore:db-status
 ```
 
@@ -707,7 +707,7 @@ Après avoir ajouté les entrées dans les deux fichiers:
 ## Template Controller avec Relations
 
 ```csharp
-// Pour les controllers avec entités liées (ex: Tickets avec Comments)
+// For controllers with related entities (ex: Tickets with Comments)
 
 #region GET with Includes
 
@@ -786,7 +786,7 @@ public async Task<ActionResult<ChildDto>> AddChild(
 
 ---
 
-## Patterns Réutilisables
+## Reusable Patterns
 
 ### Error Response Standard
 
@@ -824,7 +824,7 @@ public static class QueryableExtensions
 ### Log Context Pattern
 
 ```csharp
-// Toujours inclure le contexte utilisateur dans les logs
+// Always include user context in logs
 _logger.LogInformation(
     "User {User} ({UserId}) performed {Action} on {Entity} {EntityId}",
     _currentUser.Email,
@@ -838,7 +838,7 @@ _logger.LogInformation(
 
 ## Template Section-Level Permissions (Level 4)
 
-> **Usage:** Quand un Module a plusieurs sous-pages/onglets avec permissions différentes (ex: AI → Dashboard, Settings, Prompts)
+> **Usage:** When a Module has multiple sub-pages/tabs with different permissions (ex: AI → Dashboard, Settings, Prompts)
 
 ### Permissions.cs - Section
 
@@ -866,24 +866,24 @@ public static class Admin
 
 ```csharp
 // src/SmartStack.Infrastructure/Persistence/Configurations/Navigation/PermissionConfiguration.cs
-// AJOUTER dans la méthode Configure(), section HasData
+// ADD in Configure() method, HasData section
 
 // ============================================
-// ÉTAPE 1: Déclarer le SectionId
+// STEP 1: Declare SectionId
 // ============================================
-// Récupérer depuis NavigationSectionConfiguration.cs
+// Get from NavigationSectionConfiguration.cs
 
-var {section}SectionId = Guid.Parse("{GUID-DE-LA-SECTION}");
+var {section}SectionId = Guid.Parse("{SECTION-GUID}");
 
 // ============================================
-// ÉTAPE 2: Ajouter les permissions Section (Level 4)
+// STEP 2: Add Section permissions (Level 4)
 // ============================================
 
 // Pattern: {context}.{application}.{module}.{section}.{action}
-// Exemple: platform.administration.ai.settings.read
+// Example: platform.administration.ai.settings.read
 
 builder.HasData(
-    // Wildcard permission (accès complet à la section)
+    // Wildcard permission (full section access)
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-1}"),
@@ -948,7 +948,7 @@ builder.HasData(
         CreatedAt = seedDate
     },
 
-    // Execute permission (optionnel)
+    // Execute permission (optional)
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-6}"),
@@ -967,8 +967,8 @@ builder.HasData(
 
 ## Template Resource-Level Permissions (Level 5)
 
-> **Usage:** Pour le niveau de granularité le plus fin (ex: Prompts → Blocks, Users → Profiles)
-> **CRITIQUE:** Utilisé quand une Section contient des sous-ressources avec permissions distinctes
+> **Usage:** For the finest granularity level (ex: Prompts → Blocks, Users → Profiles)
+> **CRITICAL:** Used when a Section contains sub-resources with distinct permissions
 
 ### Permissions.cs - Resource
 
@@ -1000,24 +1000,24 @@ public static class Admin
 
 ```csharp
 // src/SmartStack.Infrastructure/Persistence/Configurations/Navigation/PermissionConfiguration.cs
-// AJOUTER dans la méthode Configure(), section HasData
+// ADD in Configure() method, HasData section
 
 // ============================================
-// ÉTAPE 1: Déclarer le ResourceId
+// STEP 1: Declare ResourceId
 // ============================================
-// Récupérer depuis NavigationResourceConfiguration.cs
+// Get from NavigationResourceConfiguration.cs
 
-var {resource}ResourceId = Guid.Parse("{GUID-DE-LA-RESOURCE}");
+var {resource}ResourceId = Guid.Parse("{RESOURCE-GUID}");
 
 // ============================================
-// ÉTAPE 2: Ajouter les permissions Resource (Level 5)
+// STEP 2: Add Resource permissions (Level 5)
 // ============================================
 
 // Pattern: {context}.{application}.{module}.{section}.{resource}.{action}
-// Exemple: platform.administration.ai.prompts.blocks.read
+// Example: platform.administration.ai.prompts.blocks.read
 
 builder.HasData(
-    // Wildcard permission (accès complet à la resource)
+    // Wildcard permission (full resource access)
     new
     {
         Id = Guid.Parse("{NOUVEAU-GUID-1}"),
@@ -1086,9 +1086,9 @@ builder.HasData(
 
 ---
 
-## Template Bulk Operations (Insertion en Masse)
+## Template Bulk Operations (Batch Insertion)
 
-> **OBLIGATOIRE:** Toujours prévoir les endpoints bulk lors de la création d'un controller CRUD
+> **MANDATORY:** Always provide bulk endpoints when creating a CRUD controller
 
 ### Permissions.cs - Bulk Operations
 
@@ -1103,7 +1103,7 @@ public static class {Module}
     public const string Update = "{path}.update";
     public const string Delete = "{path}.delete";
 
-    // Bulk operations (OBLIGATOIRE pour tout module CRUD)
+    // Bulk operations (MANDATORY for all CRUD modules)
     public const string BulkCreate = "{path}.bulk-create";
     public const string BulkUpdate = "{path}.bulk-update";
     public const string BulkDelete = "{path}.bulk-delete";
@@ -1115,7 +1115,7 @@ public static class {Module}
 ### PermissionConfiguration.cs - Bulk Permissions Seed
 
 ```csharp
-// Ajouter après les permissions CRUD standard
+// Add after standard CRUD permissions
 
 // Bulk Create permission
 new
@@ -1187,7 +1187,7 @@ new
 
 ```csharp
 // src/SmartStack.Api/Controllers/{Area}/{Module}Controller.cs
-// AJOUTER après les endpoints CRUD standard
+// ADD after standard CRUD endpoints
 
 #region BULK OPERATIONS
 
@@ -1403,40 +1403,40 @@ public record BulkUpdate{Entity}Request(
 
 ---
 
-## Hiérarchie Complète des Permissions
+## Complete Permissions Hierarchy
 
 ```
 ┌─────────────────────────────────────────────────────────────────────────────────┐
-│                    HIÉRARCHIE COMPLÈTE DES PERMISSIONS                          │
+│                      COMPLETE PERMISSIONS HIERARCHY                             │
 ├─────────────────────────────────────────────────────────────────────────────────┤
 │                                                                                 │
 │  Level 1: CONTEXT                                                               │
 │  └─ Path: {context}.*                                                           │
-│     └─ Ex: platform.* → Accès complet au context platform                       │
+│     └─ Ex: platform.* → Full platform context access                            │
 │                                                                                 │
 │  Level 2: APPLICATION                                                           │
 │  └─ Path: {context}.{application}.*                                             │
-│     └─ Ex: platform.administration.* → Accès complet à l'administration         │
+│     └─ Ex: platform.administration.* → Full administration access               │
 │                                                                                 │
 │  Level 3: MODULE                                                                │
 │  └─ Path: {context}.{application}.{module}.{action}                             │
-│     └─ Ex: platform.administration.users.read → Lecture des users               │
-│     └─ BULK: platform.administration.users.bulk-create → Création en masse      │
+│     └─ Ex: platform.administration.users.read → Read users                      │
+│     └─ BULK: platform.administration.users.bulk-create → Batch create          │
 │                                                                                 │
 │  Level 4: SECTION                                                               │
 │  └─ Path: {context}.{application}.{module}.{section}.{action}                   │
-│     └─ Ex: platform.administration.ai.settings.update → MAJ paramètres IA       │
+│     └─ Ex: platform.administration.ai.settings.update → Update AI settings     │
 │                                                                                 │
 │  Level 5: RESOURCE (finest granularity)                                         │
 │  └─ Path: {context}.{application}.{module}.{section}.{resource}.{action}        │
-│     └─ Ex: platform.administration.ai.prompts.blocks.delete → Suppr. blocs      │
+│     └─ Ex: platform.administration.ai.prompts.blocks.delete → Delete blocks    │
 │                                                                                 │
 └─────────────────────────────────────────────────────────────────────────────────┘
 ```
 
 ---
 
-## Checklist Controller avec Permissions Complètes
+## Controller Checklist with Complete Permissions
 
 ```
 □ CRUD Standard
@@ -1455,14 +1455,14 @@ public record BulkUpdate{Entity}Request(
   □ GET /api/.../export     → {path}.export
   □ POST /api/.../import    → {path}.import
 
-□ Permissions Configurées
-  □ Permissions.cs - Constantes définies
+□ Permissions Configured
+  □ Permissions.cs - Constants defined
   □ PermissionConfiguration.cs - Seed HasData
-  □ Migration EF Core créée
-  □ Migration appliquée
+  □ EF Core Migration created
+  □ Migration applied
 
-□ Niveau Permission Correct
-  □ Module (Level 3) - Pour CRUD principal
-  □ Section (Level 4) - Si sous-pages avec perms différentes
-  □ Resource (Level 5) - Si sous-ressources avec perms distinctes
+□ Correct Permission Level
+  □ Module (Level 3) - For main CRUD
+  □ Section (Level 4) - If sub-pages with different permissions
+  □ Resource (Level 5) - If sub-resources with distinct permissions
 ```

package/templates/skills/documentation/SKILL.md

@@ -1,134 +1,134 @@
 ---
 name: documentation
 description: |
-  Génère automatiquement la documentation technique pour SmartStack.
-  Utiliser ce skill quand:
-  - L'utilisateur demande de créer/générer de la documentation
-  - L'utilisateur mentionne "documenter", "documentation", "doc", "MCD", "schéma"
-  - L'utilisateur veut documenter un module, une table, un outil, ou un test
-  - Après l'implémentation d'une feature pour générer sa documentation
-  Types: user module, developer tools, database MCD, testing tools
+  Automatically generates technical documentation for SmartStack.
+  Use this skill when:
+  - User asks to create/generate documentation
+  - User mentions "document", "documentation", "doc", "ERD", "schema"
+  - User wants to document a module, table, tool, or test
+  - After implementing a feature to generate its documentation
+  Types: user module, developer tools, database ERD, testing tools
 ---
 
 # Skill Documentation SmartStack
 
-> **Note:** Ce skill fonctionne en synergie avec la commande `/documentation:module`.
+> **Note:** This skill works in synergy with the `/documentation:module` command.
 
-**Référence:** [_shared.md](../_shared.md) pour architecture, i18n
+**Reference:** [_shared.md](../_shared.md) for architecture, i18n
 
-## QUAND CE SKILL S'ACTIVE
+## WHEN THIS SKILL ACTIVATES
 
-Claude invoque automatiquement ce skill quand il détecte :
+Claude automatically invokes this skill when it detects:
 
-| Déclencheur | Exemple |
-|-------------|---------|
-| Demande explicite | "Documente le module SLA" |
-| Mention de documentation | "Il faudrait créer la doc pour..." |
-| Après implémentation | "La feature est terminée, génère la doc" |
-| Question sur structure | "Comment est organisée la documentation ?" |
-| Mots-clés | "MCD", "schéma", "diagramme", "documenter" |
+| Trigger | Example |
+|---------|---------|
+| Explicit request | "Document the SLA module" |
+| Documentation mention | "We should create the doc for..." |
+| After implementation | "The feature is done, generate the doc" |
+| Structure question | "How is the documentation organized?" |
+| Keywords | "ERD", "schema", "diagram", "document" |
 
 ---
 
-## WORKFLOW AUTOMATIQUE
+## AUTOMATIC WORKFLOW
 
-### ÉTAPE 1: DÉTECTION DU TYPE
+### STEP 1: TYPE DETECTION
 
-Analyser la demande pour identifier :
+Analyze the request to identify:
 
-| Indice | → Type |
-|--------|--------|
-| Module fonctionnel (SLA, Tickets, Users) | `user` |
-| Outil dev (Docker, Postman, VS Code) | `developer` |
-| Tables, schéma, base de données | `database` |
-| Tests (sécurité, charge, E2E) | `testing` |
+| Clue | → Type |
+|------|--------|
+| Functional module (SLA, Tickets, Users) | `user` |
+| Dev tool (Docker, Postman, VS Code) | `developer` |
+| Tables, schema, database | `database` |
+| Tests (security, load, E2E) | `testing` |
 
-### ÉTAPE 2: EXTRACTION DE LA CIBLE
+### STEP 2: TARGET EXTRACTION
 
-Identifier le nom spécifique :
+Identify the specific name:
 - Module: `sla`, `tickets`, `users`, `permissions`
-- Outil: `docker`, `postman`, `playwright`, `maildev`
-- Schéma: `support`, `auth`, `nav`, `usr`
+- Tool: `docker`, `postman`, `playwright`, `maildev`
+- Schema: `support`, `auth`, `nav`, `usr`
 - Test: `security`, `load`, `e2e`
 
-### ÉTAPE 3: EXÉCUTION
+### STEP 3: EXECUTION
 
-Suivre le workflow de la commande `/documentation:module` :
+Follow the workflow of the `/documentation:module` command:
 
 ```
-TYPE = type détecté (user|developer|database|testing)
-TARGET = cible extraite
+TYPE = detected type (user|developer|database|testing)
+TARGET = extracted target
 
-→ Exécuter le workflow complet de /documentation:module
+→ Execute the complete /documentation:module workflow
 ```
 
 ---
 
-## RÉFÉRENCE RAPIDE
+## QUICK REFERENCE
 
-### Types de documentation
+### Documentation types
 
-| Type | Description | Sortie |
+| Type | Description | Output |
 |------|-------------|--------|
-| `user` | Module utilisateur avec maquettes UI | `docs/user/{context}/{Module}DocPage.tsx` |
-| `developer` | Guide d'outil de développement | `docs/developer/tools/{Tool}Page.tsx` |
-| `database` | Schéma avec diagramme MCD | `docs/developer/database/{Schema}SchemaPage.tsx` |
-| `testing` | Outil de test | `docs/developer/testing/{Tool}TestingPage.tsx` |
+| `user` | User module with UI mockups | `docs/user/{context}/{Module}DocPage.tsx` |
+| `developer` | Development tool guide | `docs/developer/tools/{Tool}Page.tsx` |
+| `database` | Schema with ERD diagram | `docs/developer/database/{Schema}SchemaPage.tsx` |
+| `testing` | Testing tool | `docs/developer/testing/{Tool}TestingPage.tsx` |
 
-### Outils Developer disponibles
+### Available Developer tools
 
-| Catégorie | Outils |
-|-----------|--------|
-| Environnement Local | Docker Compose, MailDev, VS Code, Variables d'env |
-| Tests API | Postman, REST Client, Swagger/OpenAPI |
-| Tests E2E | Microsoft Playwright, Inspector, Trace Viewer |
-| Tests Charge | NBomber (.NET), k6, Azure Load Testing |
-| Tests Sécurité | OWASP ZAP, Security Code Scan, Snyk, OWASP ASVS |
+| Category | Tools |
+|----------|-------|
+| Local Environment | Docker Compose, MailDev, VS Code, Environment variables |
+| API Testing | Postman, REST Client, Swagger/OpenAPI |
+| E2E Testing | Microsoft Playwright, Inspector, Trace Viewer |
+| Load Testing | NBomber (.NET), k6, Azure Load Testing |
+| Security Testing | OWASP ZAP, Security Code Scan, Snyk, OWASP ASVS |
 
 ---
 
-## RÈGLES ABSOLUES
+## ABSOLUTE RULES
 
-1. **JAMAIS** de texte en dur → `useTranslation('docs')`
-2. **JAMAIS** d'ASCII art → composants React/HTML pour MCD
-3. **TOUJOURS** lire les sources avant de générer
-4. **TOUJOURS** demander confirmation avant de créer
-5. **TOUJOURS** mettre à jour App.tsx et index parents
-6. **TOUJOURS** ajouter le module dans `UserIndexPage.tsx` (SI type == `user`)
+1. **NEVER** hardcoded text → `useTranslation('docs')`
+2. **NEVER** ASCII art → React/HTML components for ERD
+3. **ALWAYS** read sources before generating
+4. **ALWAYS** confirm before creating
+5. **ALWAYS** update App.tsx and parent indexes
+6. **ALWAYS** add module in `UserIndexPage.tsx` (IF type == `user`)
 
 ---
 
-## INTÉGRATION UserIndexPage (TYPE: user)
+## UserIndexPage Integration (TYPE: user)
 
-**OBLIGATOIRE** pour les modules `user`: Ajouter le module à la hiérarchie de navigation.
+**MANDATORY** for `user` modules: Add the module to the navigation hierarchy.
 
-| Fichier | Modification |
-|---------|--------------|
-| `UserIndexPage.tsx` | Ajouter icône + entrée dans `modules[]` de l'application parente |
-| `fr/docs.json` | Ajouter `user.modules.{module}.name` et `.description` |
-| `en/docs.json` | Ajouter `user.modules.{module}.name` et `.description` |
+| File | Modification |
+|------|--------------|
+| `UserIndexPage.tsx` | Add icon + entry in `modules[]` of parent application |
+| `fr/docs.json` | Add `user.modules.{module}.name` and `.description` |
+| `en/docs.json` | Add `user.modules.{module}.name` and `.description` |
 
-**Applications parentes:**
-- `Platform > Administration`: modules admin (users, roles, ai, entra...)
-- `Platform > Support`: modules support (tickets, sla, templates...)
-- `Personal > MySpace`: modules personnels (profile, preferences...)
+**Parent applications:**
+- `Platform > Administration`: admin modules (users, roles, ai, entra...)
+- `Platform > Support`: support modules (tickets, sla, templates...)
+- `Personal > MySpace`: personal modules (profile, preferences...)
 
-**Vérification:** Le module doit apparaître sur `/docs/user` sous son application.
+**Verification:** The module should appear on `/docs/user` under its application.
 
 ---
 
-## SOURCES DE DONNÉES
+## DATA SOURCES
 
-| Donnée | Source |
-|--------|--------|
-| Schémas DB | `src/SmartStack.Infrastructure/Persistence/Configurations/` |
+| Data | Source |
+|------|--------|
+| DB schemas | `src/SmartStack.Infrastructure/Persistence/Configurations/` |
 | Tables | `ApplicationDbContextModelSnapshot.cs` |
-| Documentation existante | `web/smartstack-web/src/pages/docs/` |
-| Outils de test | WebSearch (versions actuelles) |
+| Existing documentation | `web/smartstack-web/src/pages/docs/` |
+| Testing tools | WebSearch (current versions) |
 
 ---
 
-## FICHIERS ASSOCIÉS
+## ASSOCIATED FILES
 
-- **Templates React:** [templates.md](templates.md)
-- **Commande complète:** `.claude/commands/documentation-module.md`
+- **React Templates:** [templates.md](templates.md)
+- **Complete Command:** `.claude/commands/documentation-module.md`