@atlashub/smartstack-cli 1.13.2 → 1.14.1

package/templates/skills/application/templates-frontend.md

@@ -1,28 +1,28 @@
 # Templates Frontend - Application Skill
 
-> Ces templates génèrent le code React/TypeScript pour les nouvelles applications/modules.
+> These templates generate React/TypeScript code for new applications/modules.
 
 ---
 
-## ARCHITECTURE FRONTEND
+## FRONTEND ARCHITECTURE
 
 ```
 web/smartstack-web/src/
 ├── pages/$CONTEXT/$MODULE/
-│   ├── $MODULE_PASCALPage.tsx          # Page principale (liste)
-│   ├── $MODULE_PASCALDetailPage.tsx    # Page détail
-│   └── Create$MODULE_PASCALPage.tsx    # Page création
+│   ├── $MODULE_PASCALPage.tsx          # Main page (list)
+│   ├── $MODULE_PASCALDetailPage.tsx    # Detail page
+│   └── Create$MODULE_PASCALPage.tsx    # Create page
 ├── components/$MODULE/
-│   ├── $MODULE_PASCALListView.tsx      # Composant liste réutilisable
-│   ├── $MODULE_PASCALForm.tsx          # Formulaire CRUD
-│   └── $MODULE_PASCALFilters.tsx       # Filtres
+│   ├── $MODULE_PASCALListView.tsx      # Reusable list component
+│   ├── $MODULE_PASCALForm.tsx          # CRUD form
+│   └── $MODULE_PASCALFilters.tsx       # Filters
 ├── components/common/
-│   └── (composants partagés)
+│   └── (shared components)
 ├── hooks/
-│   ├── use$MODULE_PASCALPreferences.ts # Hook préférences
-│   └── use$MODULE_PASCAL.ts            # Hook API
+│   ├── use$MODULE_PASCALPreferences.ts # Preferences hook
+│   └── use$MODULE_PASCAL.ts            # API hook
 ├── services/api/
-│   └── $moduleApi.ts                   # Service API
+│   └── $moduleApi.ts                   # API service
 └── i18n/locales/
     ├── fr/$module.json
     ├── en/$module.json
@@ -32,7 +32,7 @@ web/smartstack-web/src/
 
 ---
 
-## TEMPLATE: PAGE PRINCIPALE
+## TEMPLATE: MAIN PAGE
 
 ```tsx
 // pages/$CONTEXT/$MODULE/$MODULE_PASCALPage.tsx
@@ -56,7 +56,7 @@ export function $MODULE_PASCALPage() {
 
 ---
 
-## TEMPLATE: LISTE VIEW (Composant réutilisable)
+## TEMPLATE: LIST VIEW (Reusable component)
 
 ```tsx
 // components/$MODULE/$MODULE_PASCALListView.tsx
@@ -70,7 +70,7 @@ import { use$MODULE_PASCALPreferences } from '@/hooks/use$MODULE_PASCALPreferenc
 import { Pagination } from '@/components/common/Pagination';
 import { ColumnSelector } from '@/components/common/ColumnSelector';
 import { ViewModeToggle } from '@/components/common/ViewModeToggle';
-import { EntityCard } from '@/components/ui/EntityCard';  // ⚠️ OBLIGATOIRE pour Grid view
+import { EntityCard } from '@/components/ui/EntityCard';  // ⚠️ MANDATORY for Grid view
 
 interface $ENTITY_PASCALDto {
   id: string;
@@ -320,7 +320,7 @@ export function $MODULE_PASCALListView({
           </table>
         </div>
       ) : (
-        /* Grid view - ⚠️ OBLIGATOIRE: utiliser EntityCard */
+        /* Grid view - ⚠️ MANDATORY: use EntityCard */
         <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-6">
           {data?.items.map((item) => (
             <EntityCard
@@ -361,7 +361,7 @@ export function $MODULE_PASCALListView({
 
 ---
 
-## TEMPLATE: HOOK PRÉFÉRENCES
+## TEMPLATE: PREFERENCES HOOK
 
 ```tsx
 // hooks/use$MODULE_PASCALPreferences.ts
@@ -477,25 +477,25 @@ export const $moduleApi = {
 
 ## TEMPLATE: ROUTES (App.tsx)
 
-### ⚠️ RÈGLE CRITIQUE: ROUTES IMBRIQUÉES OBLIGATOIRES
+### ⚠️ CRITICAL RULE: NESTED ROUTES MANDATORY
 
-React Router v7 **exige** des routes imbriquées (nested routes) pour les applications multi-modules.
+React Router v7 **requires** nested routes for multi-module applications.
 
-**❌ INTERDIT - Routes plates (causent des redirections vers Home)**
+**❌ FORBIDDEN - Flat routes (cause redirects to Home)**
 ```tsx
 <Route path="$APPLICATION" element={<Navigate to="/$CONTEXT/$APPLICATION/$DEFAULT_MODULE" replace />} />
 <Route path="$APPLICATION/$MODULE" element={<$MODULE_PASCALPage />} />
 ```
 
-**✅ OBLIGATOIRE - Routes imbriquées avec index**
+**✅ MANDATORY - Nested routes with index**
 ```tsx
-// Ajouter dans App.tsx
+// Add to App.tsx
 
 import { $MODULE_PASCALPage } from '@/pages/$CONTEXT/$MODULE/$MODULE_PASCALPage';
 import { $MODULE_PASCALDetailPage } from '@/pages/$CONTEXT/$MODULE/$MODULE_PASCALDetailPage';
 import { Create$MODULE_PASCALPage } from '@/pages/$CONTEXT/$MODULE/Create$MODULE_PASCALPage';
 
-// Dans les routes - STRUCTURE IMBRIQUÉE
+// In routes - NESTED STRUCTURE
 <Route path="$APPLICATION">
   <Route index element={<Navigate to="$DEFAULT_MODULE" replace />} />
   <Route path="$MODULE" element={<$MODULE_PASCALPage />} />
@@ -505,27 +505,27 @@ import { Create$MODULE_PASCALPage } from '@/pages/$CONTEXT/$MODULE/Create$MODULE
 </Route>
 ```
 
-### Pourquoi cette structure ?
+### Why this structure?
 
-| Aspect | Routes plates | Routes imbriquées |
-|--------|--------------|-------------------|
-| Matching | Ambigu entre siblings | Hiérarchique clair |
-| Navigate | Doit être absolu | Peut être relatif |
-| Outlet | Non supporté | Supporté |
-| Redirect | Peut échouer | Fonctionne toujours |
+| Aspect | Flat routes | Nested routes |
+|--------|------------|----------------|
+| Matching | Ambiguous between siblings | Hierarchical clear |
+| Navigate | Must be absolute | Can be relative |
+| Outlet | Not supported | Supported |
+| Redirect | Can fail | Always works |
 
 ---
 
-## CHECKLIST FRONTEND
-
-| Vérification | Status |
-|--------------|--------|
-| ☐ Page principale créée | |
-| ☐ Composant ListView créé | |
-| ☐ Hook préférences créé | |
-| ☐ Service API créé | |
-| ☐ Routes ajoutées dans App.tsx | |
-| ☐ Utilise apiClient (pas d'appel direct) | |
-| ☐ Pas d'import Infrastructure | |
-| ☐ npm run build réussi | |
-| ☐ npm run lint réussi | |
+## FRONTEND CHECKLIST
+
+| Check | Status |
+|-------|--------|
+| ☐ Main page created | |
+| ☐ ListView component created | |
+| ☐ Preferences hook created | |
+| ☐ API service created | |
+| ☐ Routes added to App.tsx | |
+| ☐ Uses apiClient (no direct calls) | |
+| ☐ No Infrastructure imports | |
+| ☐ npm run build successful | |
+| ☐ npm run lint successful | |

package/templates/skills/application/templates-i18n.md

@@ -1,14 +1,14 @@
 # Templates i18n - Application Skill
 
-> Ces templates génèrent les fichiers de traduction pour les 4 langues obligatoires.
+> These templates generate translation files for the 4 mandatory languages.
 
 ---
 
-## STRUCTURE DES FICHIERS
+## FILE STRUCTURE
 
 ```
 web/smartstack-web/src/i18n/locales/
-├── fr/$module.json    # Français (langue principale)
+├── fr/$module.json    # French (main language)
 ├── en/$module.json    # English
 ├── it/$module.json    # Italiano
 └── de/$module.json    # Deutsch
@@ -16,7 +16,7 @@ web/smartstack-web/src/i18n/locales/
 
 ---
 
-## TEMPLATE: FRANÇAIS (fr/$module.json)
+## TEMPLATE: FRENCH (fr/$module.json)
 
 ```json
 {
@@ -194,7 +194,7 @@ web/smartstack-web/src/i18n/locales/
 
 ---
 
-## TEMPLATE: ITALIANO (it/$module.json)
+## TEMPLATE: ITALIAN (it/$module.json)
 
 ```json
 {
@@ -283,7 +283,7 @@ web/smartstack-web/src/i18n/locales/
 
 ---
 
-## TEMPLATE: DEUTSCH (de/$module.json)
+## TEMPLATE: GERMAN (de/$module.json)
 
 ```json
 {
@@ -372,9 +372,9 @@ web/smartstack-web/src/i18n/locales/
 
 ---
 
-## MISE À JOUR NAVIGATION.JSON
+## UPDATE NAVIGATION.JSON
 
-Pour chaque entité de navigation créée, mettre à jour les fichiers `navigation.json` :
+For each navigation entity created, update the `navigation.json` files:
 
 ### fr/navigation.json
 
@@ -430,18 +430,18 @@ Pour chaque entité de navigation créée, mettre à jour les fichiers `navigati
 
 ---
 
-## ENREGISTREMENT i18n
+## i18n REGISTRATION
 
-Ajouter le namespace dans `i18n/index.ts` :
+Add the namespace to `i18n/index.ts`:
 
 ```typescript
-// Ajouter l'import
+// Add the import
 import $module_fr from './locales/fr/$module.json';
 import $module_en from './locales/en/$module.json';
 import $module_it from './locales/it/$module.json';
 import $module_de from './locales/de/$module.json';
 
-// Ajouter dans les resources
+// Add to resources
 resources: {
   fr: {
     // ... existing
@@ -464,7 +464,7 @@ resources: {
 
 ---
 
-## EXEMPLE COMPLET: Module "Products"
+## COMPLETE EXAMPLE: "Products" Module
 
 ### Variables
 
@@ -488,31 +488,31 @@ $SUBTITLE_DE = Verwalten Sie Ihren Produktkatalog
 
 ---
 
-## CHECKLIST I18N
+## i18n CHECKLIST
 
-| Vérification | Status |
-|--------------|--------|
-| ☐ fr/$module.json créé | |
-| ☐ en/$module.json créé | |
-| ☐ it/$module.json créé | |
-| ☐ de/$module.json créé | |
-| ☐ navigation.json mis à jour (4 langues) | |
-| ☐ Namespace enregistré dans i18n/index.ts | |
-| ☐ Toutes les clés présentes dans les 4 fichiers | |
-| ☐ Pas de clés manquantes | |
+| Check | Status |
+|-------|--------|
+| ☐ fr/$module.json created | |
+| ☐ en/$module.json created | |
+| ☐ it/$module.json created | |
+| ☐ de/$module.json created | |
+| ☐ navigation.json updated (4 languages) | |
+| ☐ Namespace registered in i18n/index.ts | |
+| ☐ All keys present in 4 files | |
+| ☐ No missing keys | |
 
 ---
 
-## OUTILS DE VALIDATION
+## VALIDATION TOOLS
 
 ```bash
-# Vérifier que toutes les clés sont présentes dans les 4 langues
-# Script à exécuter depuis web/smartstack-web
+# Verify that all keys are present in 4 languages
+# Script to run from web/smartstack-web
 
-# Liste les clés du fichier français (référence)
+# List keys from French file (reference)
 jq -r 'paths(scalars) | join(".")' src/i18n/locales/fr/$module.json > /tmp/fr_keys.txt
 
-# Compare avec les autres langues
+# Compare with other languages
 for lang in en it de; do
   jq -r 'paths(scalars) | join(".")' src/i18n/locales/$lang/$module.json > /tmp/${lang}_keys.txt
   diff /tmp/fr_keys.txt /tmp/${lang}_keys.txt

package/templates/skills/application/templates-seed.md

@@ -1,14 +1,14 @@
 # Templates DB Seed - Application Skill
 
-> Ces templates génèrent les seeds EF Core pour les entités de navigation et leurs traductions.
+> These templates generate EF Core seeds for navigation entities and their translations.
 
 ---
 
-## RÈGLES DE GÉNÉRATION GUID
+## GUID GENERATION RULES
 
 ```csharp
-// JAMAIS de GUIDs séquentiels générés par NewGuid()
-// TOUJOURS utiliser la méthode déterministe
+// NEVER generate sequential GUIDs with NewGuid()
+// ALWAYS use the deterministic method
 
 private static Guid GenerateGuid(int index)
 {
@@ -16,8 +16,8 @@ private static Guid GenerateGuid(int index)
     return Guid.Parse($"11111111-1111-1111-1111-{index:D12}");
 }
 
-// Pour les seeds existants, continuer la séquence
-// Vérifier le dernier index utilisé dans NavigationTranslationConfiguration.cs
+// For existing seeds, continue the sequence
+// Check the last index used in NavigationTranslationConfiguration.cs
 ```
 
 ---
@@ -27,25 +27,25 @@ private static Guid GenerateGuid(int index)
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationContextConfiguration.cs - HasData()
+// In NavigationContextConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$CONTEXT_GUID"),
-    Code = "$CODE",           // ex: "erp"
-    Label = "$LABEL_FR",      // ex: "ERP"
-    Description = "$DESC_FR", // ex: "Gestion d'entreprise"
-    Icon = "$ICON",           // ex: "Building2"
+    Code = "$CODE",           // e.g.: "erp"
+    Label = "$LABEL_EN",      // e.g.: "ERP"
+    Description = "$DESC_EN", // e.g.: "Enterprise management"
+    Icon = "$ICON",           // e.g.: "Building2"
     IconType = IconType.Lucide,
-    Route = "/$CODE",         // ex: "/erp"
-    DisplayOrder = $ORDER,    // ex: 4
+    Route = "/$CODE",         // e.g.: "/erp"
+    DisplayOrder = $ORDER,    // e.g.: 4
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
-// Dans NavigationTranslationConfiguration.cs - GetSeedData()
+// In NavigationTranslationConfiguration.cs - GetSeedData()
 // Context translations
 translations.Add(new {
     Id = GenerateGuid(index++),
@@ -92,23 +92,23 @@ translations.Add(new {
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationApplicationConfiguration.cs - HasData()
+// In NavigationApplicationConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$APP_GUID"),
     ContextId = Guid.Parse("$CONTEXT_GUID"),
-    Code = "$CODE",           // ex: "sales"
-    Label = "$LABEL_FR",      // ex: "Ventes"
-    Description = "$DESC_FR", // ex: "Gestion des ventes"
-    Icon = "$ICON",           // ex: "TrendingUp"
+    Code = "$CODE",           // e.g.: "sales"
+    Label = "$LABEL_EN",      // e.g.: "Sales"
+    Description = "$DESC_EN", // e.g.: "Sales management"
+    Icon = "$ICON",           // e.g.: "TrendingUp"
     IconType = IconType.Lucide,
-    Route = "/$CONTEXT/$CODE", // ex: "/erp/sales"
+    Route = "/$CONTEXT/$CODE", // e.g.: "/erp/sales"
     DisplayOrder = $ORDER,
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
 // Application translations
@@ -157,23 +157,23 @@ translations.Add(new {
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationModuleConfiguration.cs - HasData()
+// In NavigationModuleConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$MODULE_GUID"),
     ApplicationId = Guid.Parse("$APP_GUID"),
-    Code = "$CODE",                    // ex: "products"
-    Label = "$LABEL_FR",               // ex: "Produits"
-    Description = "$DESC_FR",          // ex: "Gestion des produits"
-    Icon = "$ICON",                    // ex: "Package"
+    Code = "$CODE",                    // e.g.: "products"
+    Label = "$LABEL_EN",               // e.g.: "Products"
+    Description = "$DESC_EN",          // e.g.: "Product management"
+    Icon = "$ICON",                    // e.g.: "Package"
     IconType = IconType.Lucide,
-    Route = "/$CONTEXT/$APP/$CODE",    // ex: "/erp/sales/products"
+    Route = "/$CONTEXT/$APP/$CODE",    // e.g.: "/erp/sales/products"
     DisplayOrder = $ORDER,
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
 // Module translations
@@ -222,23 +222,23 @@ translations.Add(new {
 ### Navigation Entity
 
 ```csharp
-// Dans NavigationSectionConfiguration.cs - HasData()
+// In NavigationSectionConfiguration.cs - HasData()
 new {
     Id = Guid.Parse("$SECTION_GUID"),
     ModuleId = Guid.Parse("$MODULE_GUID"),
-    Code = "$CODE",                           // ex: "inventory"
-    Label = "$LABEL_FR",                      // ex: "Inventaire"
-    Description = "$DESC_FR",                 // ex: "Gestion des stocks"
-    Icon = "$ICON",                           // ex: "Warehouse"
+    Code = "$CODE",                           // e.g.: "inventory"
+    Label = "$LABEL_EN",                      // e.g.: "Inventory"
+    Description = "$DESC_EN",                 // e.g.: "Inventory management"
+    Icon = "$ICON",                           // e.g.: "Warehouse"
     IconType = IconType.Lucide,
-    Route = "/$CONTEXT/$APP/$MODULE/$CODE",   // ex: "/erp/sales/products/inventory"
+    Route = "/$CONTEXT/$APP/$MODULE/$CODE",   // e.g.: "/erp/sales/products/inventory"
     DisplayOrder = $ORDER,
     IsActive = true,
     CreatedAt = seedDate
 }
 ```
 
-### Translations (4 langues)
+### Translations (4 languages)
 
 ```csharp
 // Section translations
@@ -287,8 +287,8 @@ translations.Add(new {
 ### Permission Entity
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
-// Pour chaque action CRUD + assign + execute
+// In PermissionConfiguration.cs - HasData()
+// For each CRUD action + assign + execute
 
 // Read
 new {
@@ -331,7 +331,7 @@ new {
 ### RolePermission Seed (Default Roles)
 
 ```csharp
-// Dans RolePermissionConfiguration.cs - HasData()
+// In RolePermissionConfiguration.cs - HasData()
 // SuperAdmin gets all permissions automatically (wildcard)
 
 // PlatformAdmin - if platform context
@@ -348,15 +348,15 @@ new { RoleId = Guid.Parse("...StandardUserRoleId..."), PermissionId = $PERM_READ
 
 ## TEMPLATE: SECTION PERMISSIONS SEED (Level 4)
 
-> **Usage:** Quand un Module a des sous-pages avec permissions différentes
+> **Usage:** When a Module has sub-pages with different permissions
 
 ### Permission Entity - Section Level
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
+// In PermissionConfiguration.cs - HasData()
 // Pattern: {context}.{application}.{module}.{section}.{action}
 
-// Déclarer le SectionId (doit correspondre à NavigationSectionConfiguration.cs)
+// Declare SectionId (must match NavigationSectionConfiguration.cs)
 var {section}SectionId = Guid.Parse("$SECTION_GUID");
 
 // Wildcard Section
@@ -413,7 +413,7 @@ new {
     Description = "Delete in $SECTION_LABEL",
     CreatedAt = seedDate
 },
-// Execute (optionnel)
+// Execute (optional)
 new {
     Id = Guid.Parse("$PERM_SECTION_EXECUTE_GUID"),
     Path = "$CONTEXT.$APP.$MODULE.$SECTION.execute",
@@ -430,15 +430,15 @@ new {
 
 ## TEMPLATE: RESOURCE PERMISSIONS SEED (Level 5)
 
-> **Usage:** Niveau le plus fin - sous-ressources avec permissions distinctes (ex: Prompts → Blocks)
+> **Usage:** Finest level - sub-resources with distinct permissions (e.g.: Prompts → Blocks)
 
 ### Permission Entity - Resource Level
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
+// In PermissionConfiguration.cs - HasData()
 // Pattern: {context}.{application}.{module}.{section}.{resource}.{action}
 
-// Déclarer le ResourceId (doit correspondre à NavigationResourceConfiguration.cs)
+// Declare ResourceId (must match NavigationResourceConfiguration.cs)
 var {resource}ResourceId = Guid.Parse("$RESOURCE_GUID");
 
 // Wildcard Resource
@@ -501,13 +501,13 @@ new {
 
 ## TEMPLATE: BULK OPERATIONS PERMISSIONS
 
-> **OBLIGATOIRE:** Toujours prévoir pour les modules CRUD
+> **MANDATORY:** Always provide for CRUD modules
 
 ### Permission Entity - Bulk Operations
 
 ```csharp
-// Dans PermissionConfiguration.cs - HasData()
-// Ajouter après les permissions CRUD standard
+// In PermissionConfiguration.cs - HasData()
+// Add after standard CRUD permissions
 
 // Bulk Create
 new {
@@ -568,7 +568,7 @@ new {
 
 ---
 
-## EXEMPLE COMPLET: Module "Products" dans "ERP > Sales"
+## COMPLETE EXAMPLE: "Products" Module in "ERP > Sales"
 
 ### Variables
 
@@ -594,54 +594,54 @@ $ICON = Package
 $ORDER = 1
 ```
 
-### Fichiers à modifier
+### Files to modify
 
-1. `NavigationContextConfiguration.cs` - Ajouter context ERP (si nouveau)
-2. `NavigationApplicationConfiguration.cs` - Ajouter application Sales
-3. `NavigationModuleConfiguration.cs` - Ajouter module Products
-4. `NavigationTranslationConfiguration.cs` - Ajouter 4 traductions × nombre d'entités
-5. `PermissionConfiguration.cs` - Ajouter permissions CRUD
-6. `RolePermissionConfiguration.cs` - Assigner aux rôles par défaut
+1. `NavigationContextConfiguration.cs` - Add ERP context (if new)
+2. `NavigationApplicationConfiguration.cs` - Add Sales application
+3. `NavigationModuleConfiguration.cs` - Add Products module
+4. `NavigationTranslationConfiguration.cs` - Add 4 translations × number of entities
+5. `PermissionConfiguration.cs` - Add CRUD permissions
+6. `RolePermissionConfiguration.cs` - Assign to default roles
 
 ---
 
-## CHECKLIST SEED
-
-| Vérification | Status |
-|--------------|--------|
-| ☐ GUID déterministe (pas NewGuid) | |
-| ☐ 4 langues pour chaque entité | |
-| ☐ Index translations continue la séquence existante | |
-| ☐ Route alignée avec permission path | |
-| ☐ DisplayOrder cohérent | |
-| ☐ Permissions CRUD créées (Level 3 - Module) | |
-| ☐ Permissions Section si sous-pages (Level 4) | |
-| ☐ Permissions Resource si sous-ressources (Level 5) | |
-| ☐ Permissions Bulk Operations créées | |
-| ☐ RolePermissions assignés | |
+## SEED CHECKLIST
+
+| Check | Status |
+|-------|--------|
+| ☐ Deterministic GUID (not NewGuid) | |
+| ☐ 4 languages for each entity | |
+| ☐ Index translations continue existing sequence | |
+| ☐ Route aligned with permission path | |
+| ☐ DisplayOrder consistent | |
+| ☐ CRUD permissions created (Level 3 - Module) | |
+| ☐ Section permissions if sub-pages (Level 4) | |
+| ☐ Resource permissions if sub-resources (Level 5) | |
+| ☐ Bulk Operations permissions created | |
+| ☐ RolePermissions assigned | |
 
 ---
 
-## HIÉRARCHIE DES PERMISSIONS (5 Niveaux)
+## PERMISSIONS HIERARCHY (5 Levels)
 
 ```
 Level 1: CONTEXT
 └─ Path: {context}.*
-   └─ Ex: platform.* → Accès complet au context
+   └─ E.g.: platform.* → Full context access
 
 Level 2: APPLICATION
 └─ Path: {context}.{application}.*
-   └─ Ex: platform.administration.* → Accès complet à l'app
+   └─ E.g.: platform.administration.* → Full app access
 
 Level 3: MODULE
 └─ Path: {context}.{application}.{module}.{action}
-   └─ Ex: platform.administration.users.read
+   └─ E.g.: platform.administration.users.read
 
 Level 4: SECTION
 └─ Path: {context}.{application}.{module}.{section}.{action}
-   └─ Ex: platform.administration.ai.settings.update
+   └─ E.g.: platform.administration.ai.settings.update
 
 Level 5: RESOURCE (finest granularity)
 └─ Path: {context}.{application}.{module}.{section}.{resource}.{action}
-   └─ Ex: platform.administration.ai.prompts.blocks.delete
+   └─ E.g.: platform.administration.ai.prompts.blocks.delete
 ```