@atlashub/smartstack-cli 1.1.0

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

@@ -0,0 +1,362 @@
+# Templates DB Seed - Application Skill
+
+> Ces templates génèrent les seeds EF Core pour les entités de navigation et leurs traductions.
+
+---
+
+## RÈGLES DE GÉNÉRATION GUID (SÉCURITÉ CRITIQUE)
+
+> **IMPORTANT:** Les GUIDs prévisibles sont une faille de sécurité.
+> Utiliser TOUJOURS des GUIDs aléatoires générés cryptographiquement.
+
+### ❌ INTERDIT - Pattern prévisible
+
+```csharp
+// JAMAIS FAIRE CECI - Pattern prévisible = faille de sécurité
+private static Guid GenerateGuid(int index)
+{
+    return Guid.Parse($"11111111-1111-1111-1111-{index:D12}");
+}
+```
+
+### ✅ CORRECT - GUIDs aléatoires
+
+```csharp
+// Méthode 1: Génération à la volée (recommandé pour les seeds)
+// Générer les GUIDs avec PowerShell: [guid]::NewGuid().ToString()
+// Ou avec C#: Guid.NewGuid().ToString()
+
+// Méthode 2: Cache pour éviter les doublons dans une même exécution
+private static readonly Dictionary<string, Guid> _guidCache = new();
+
+private static Guid GetOrCreateGuid(string key)
+{
+    if (!_guidCache.TryGetValue(key, out var guid))
+    {
+        guid = Guid.NewGuid();
+        _guidCache[key] = guid;
+    }
+    return guid;
+}
+
+// Usage:
+var contextGuid = GetOrCreateGuid($"context.{contextCode}");
+var appGuid = GetOrCreateGuid($"app.{contextCode}.{appCode}");
+var moduleGuid = GetOrCreateGuid($"module.{contextCode}.{appCode}.{moduleCode}");
+```
+
+### Génération de GUIDs pour les Seeds
+
+```powershell
+# PowerShell (Windows) - Exécuter pour chaque entité
+[guid]::NewGuid().ToString()
+
+# Exemple de sortie:
+# f7a3c2e8-9d1b-4e5f-a6c8-2b4d9f7e1a3c
+# b2e8d4f6-1c9a-5b7e-8d3f-6a2c9e4b7d1f
+# ... générer autant que nécessaire
+```
+
+---
+
+## TEMPLATE: CONTEXT
+
+> **RAPPEL:** Les contexts (platform, personal, business) sont prédéfinis.
+> Ce template est fourni pour référence mais ne devrait PAS être utilisé pour créer de nouveaux contexts.
+
+### Navigation Entity
+
+```csharp
+// Dans NavigationContextConfiguration.cs - HasData()
+new {
+    Id = Guid.Parse("$CONTEXT_GUID"),  // GUID aléatoire généré
+    Code = "$CODE",           // ex: "business"
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    Icon = "$ICON",
+    IconType = IconType.Lucide,
+    Route = "/$CODE",
+    DisplayOrder = $ORDER,
+    IsActive = true,
+    CreatedAt = seedDate
+}
+```
+
+### Translations (4 langues)
+
+```csharp
+// Dans NavigationTranslationConfiguration.cs - GetSeedData()
+// Utiliser des GUIDs aléatoires pour chaque traduction
+
+translations.Add(new {
+    Id = Guid.Parse("$RANDOM_GUID_1"),  // Générer avec [guid]::NewGuid()
+    EntityType = NavigationEntityType.Context,
+    EntityId = $CONTEXT_GUID,
+    LanguageCode = "fr",
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    CreatedAt = seedDate
+});
+translations.Add(new {
+    Id = Guid.Parse("$RANDOM_GUID_2"),  // Générer avec [guid]::NewGuid()
+    EntityType = NavigationEntityType.Context,
+    EntityId = $CONTEXT_GUID,
+    LanguageCode = "en",
+    Label = "$LABEL_EN",
+    Description = "$DESC_EN",
+    CreatedAt = seedDate
+});
+translations.Add(new {
+    Id = Guid.Parse("$RANDOM_GUID_3"),  // Générer avec [guid]::NewGuid()
+    EntityType = NavigationEntityType.Context,
+    EntityId = $CONTEXT_GUID,
+    LanguageCode = "it",
+    Label = "$LABEL_IT",
+    Description = "$DESC_IT",
+    CreatedAt = seedDate
+});
+translations.Add(new {
+    Id = Guid.Parse("$RANDOM_GUID_4"),  // Générer avec [guid]::NewGuid()
+    EntityType = NavigationEntityType.Context,
+    EntityId = $CONTEXT_GUID,
+    LanguageCode = "de",
+    Label = "$LABEL_DE",
+    Description = "$DESC_DE",
+    CreatedAt = seedDate
+});
+```
+
+---
+
+## TEMPLATE: APPLICATION
+
+> **RAPPEL:** Les applications ne peuvent être créées que dans le context `business`.
+
+### Navigation Entity
+
+```csharp
+// Dans NavigationApplicationConfiguration.cs - HasData()
+new {
+    Id = Guid.Parse("$APP_GUID"),        // GUID aléatoire
+    ContextId = Guid.Parse("$BUSINESS_CONTEXT_GUID"),  // Toujours business
+    Code = "$CODE",
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    Icon = "$ICON",
+    IconType = IconType.Lucide,
+    Route = "/business/$CODE",  // Toujours sous /business/
+    DisplayOrder = $ORDER,
+    IsActive = true,
+    CreatedAt = seedDate
+}
+```
+
+### Translations (4 langues)
+
+```csharp
+// Application translations - GUIDs aléatoires
+translations.Add(new {
+    Id = Guid.Parse("$RANDOM_GUID_1"),
+    EntityType = NavigationEntityType.Application,
+    EntityId = $APP_GUID,
+    LanguageCode = "fr",
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    CreatedAt = seedDate
+});
+// ... en, it, de avec GUIDs aléatoires
+```
+
+---
+
+## TEMPLATE: MODULE
+
+### Navigation Entity
+
+```csharp
+// Dans NavigationModuleConfiguration.cs - HasData()
+new {
+    Id = Guid.Parse("$MODULE_GUID"),     // GUID aléatoire
+    ApplicationId = Guid.Parse("$APP_GUID"),
+    Code = "$CODE",
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    Icon = "$ICON",
+    IconType = IconType.Lucide,
+    Route = "/business/$APP/$CODE",
+    DisplayOrder = $ORDER,
+    IsActive = true,
+    CreatedAt = seedDate
+}
+```
+
+### Translations (4 langues)
+
+```csharp
+// Module translations - GUIDs aléatoires
+translations.Add(new {
+    Id = Guid.Parse("$RANDOM_GUID_1"),
+    EntityType = NavigationEntityType.Module,
+    EntityId = $MODULE_GUID,
+    LanguageCode = "fr",
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    CreatedAt = seedDate
+});
+// ... en, it, de
+```
+
+---
+
+## TEMPLATE: SECTION
+
+### Navigation Entity
+
+```csharp
+// Dans NavigationSectionConfiguration.cs - HasData()
+new {
+    Id = Guid.Parse("$SECTION_GUID"),    // GUID aléatoire
+    ModuleId = Guid.Parse("$MODULE_GUID"),
+    Code = "$CODE",
+    Label = "$LABEL_FR",
+    Description = "$DESC_FR",
+    Icon = "$ICON",
+    IconType = IconType.Lucide,
+    Route = "/business/$APP/$MODULE/$CODE",
+    DisplayOrder = $ORDER,
+    IsActive = true,
+    CreatedAt = seedDate
+}
+```
+
+---
+
+## TEMPLATE: PERMISSIONS SEED
+
+### Permission Entity
+
+```csharp
+// Dans PermissionConfiguration.cs - HasData()
+// Pour chaque action CRUD + assign + execute
+// TOUS les GUIDs doivent être aléatoires
+
+var seedDate = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);
+
+// Read
+new {
+    Id = Guid.Parse("$RANDOM_GUID_READ"),      // Générer avec [guid]::NewGuid()
+    Code = "business.$APP.$MODULE.read",
+    Name = "View $MODULE_LABEL",
+    Description = "View $MODULE_LABEL list and details",
+    Category = "business.$APP.$MODULE",
+    CreatedAt = seedDate
+},
+// Create
+new {
+    Id = Guid.Parse("$RANDOM_GUID_CREATE"),
+    Code = "business.$APP.$MODULE.create",
+    Name = "Create $MODULE_LABEL",
+    Description = "Create new $MODULE_LABEL",
+    Category = "business.$APP.$MODULE",
+    CreatedAt = seedDate
+},
+// Update
+new {
+    Id = Guid.Parse("$RANDOM_GUID_UPDATE"),
+    Code = "business.$APP.$MODULE.update",
+    Name = "Update $MODULE_LABEL",
+    Description = "Modify existing $MODULE_LABEL",
+    Category = "business.$APP.$MODULE",
+    CreatedAt = seedDate
+},
+// Delete
+new {
+    Id = Guid.Parse("$RANDOM_GUID_DELETE"),
+    Code = "business.$APP.$MODULE.delete",
+    Name = "Delete $MODULE_LABEL",
+    Description = "Remove $MODULE_LABEL",
+    Category = "business.$APP.$MODULE",
+    CreatedAt = seedDate
+}
+```
+
+### RolePermission Seed (Default Roles)
+
+```csharp
+// Dans RolePermissionConfiguration.cs - HasData()
+// SuperAdmin gets all permissions automatically (wildcard)
+
+// BusinessAdmin - gets all business permissions
+new { RoleId = Guid.Parse("...BusinessAdminRoleId..."), PermissionId = $PERM_READ_GUID },
+new { RoleId = Guid.Parse("...BusinessAdminRoleId..."), PermissionId = $PERM_CREATE_GUID },
+new { RoleId = Guid.Parse("...BusinessAdminRoleId..."), PermissionId = $PERM_UPDATE_GUID },
+new { RoleId = Guid.Parse("...BusinessAdminRoleId..."), PermissionId = $PERM_DELETE_GUID },
+
+// StandardUser - read only by default
+new { RoleId = Guid.Parse("...StandardUserRoleId..."), PermissionId = $PERM_READ_GUID }
+```
+
+---
+
+## EXEMPLE COMPLET: Module "Leads" dans "Business > CRM"
+
+### Variables
+
+```
+$CONTEXT = business (prédéfini)
+$APP = crm
+$APP_GUID = (générer avec [guid]::NewGuid())
+$MODULE = leads
+$MODULE_GUID = (générer avec [guid]::NewGuid())
+
+$LABEL_FR = Prospects
+$LABEL_EN = Leads
+$LABEL_IT = Contatti
+$LABEL_DE = Leads
+
+$DESC_FR = Gestion des prospects
+$DESC_EN = Lead management
+$DESC_IT = Gestione contatti
+$DESC_DE = Lead-Verwaltung
+
+$ICON = Users
+$ORDER = 1
+```
+
+### Fichiers à modifier
+
+1. `NavigationApplicationConfiguration.cs` - Ajouter application CRM (si nouveau)
+2. `NavigationModuleConfiguration.cs` - Ajouter module Leads
+3. `NavigationTranslationConfiguration.cs` - Ajouter 4 traductions × nombre d'entités
+4. `PermissionConfiguration.cs` - Ajouter permissions CRUD
+5. `RolePermissionConfiguration.cs` - Assigner aux rôles par défaut
+
+---
+
+## CHECKLIST SEED
+
+| Vérification | Status |
+|--------------|--------|
+| ☐ GUIDs aléatoires (PAS de pattern prévisible) | |
+| ☐ Context = "business" (pas platform/personal) | |
+| ☐ 4 langues pour chaque entité | |
+| ☐ Route alignée avec permission path | |
+| ☐ DisplayOrder cohérent | |
+| ☐ Permissions CRUD créées | |
+| ☐ RolePermissions assignés | |
+
+---
+
+## VALIDATION GUID AVANT COMMIT
+
+```bash
+# Vérifier qu'aucun GUID prévisible n'a été utilisé
+# Ces patterns sont INTERDITS:
+
+grep -r "11111111-1111" .  # Pattern 1111...
+grep -r "00000000-0000" .  # Pattern 0000...
+grep -r "aaaaaaaa-aaaa" .  # Pattern répétitif
+grep -r "{index:D12}" .    # Génération séquentielle
+
+# Si un de ces patterns est trouvé → CORRIGER avant commit
+```

package/templates/commands/application.md

@@ -0,0 +1,303 @@
+# /application - Skill Application SmartStack
+
+> **Synergie Skill/Commande:**
+> - **Skill** (`.claude/skills/application/`) → Invocation automatique par Claude
+> - **Commande** (`/application:create`) → Invocation manuelle par l'utilisateur
+> - Templates partagés dans `.claude/skills/application/templates-*.md`
+
+---
+
+## ARGUMENTS
+
+```
+/application:create <level> <parent> <code> [options]
+```
+
+| Variable | Description | Valeurs |
+|----------|-------------|---------|
+| `level` | Niveau de navigation | `context`, `application`, `module`, `section` |
+| `parent` | Code du parent | Ex: `platform`, `platform.administration` |
+| `code` | Code de l'entité | Ex: `products`, `crm`, `erp` |
+
+---
+
+## PHASE 0: VALIDATION CONTEXTES RÉSERVÉS (CRITIQUE)
+
+> **SÉCURITÉ:** Cette phase est OBLIGATOIRE avant toute génération.
+> Elle protège les contextes core de SmartStack contre les modifications non autorisées.
+
+### Règles de Protection
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    CONTEXTES RÉSERVÉS (CORE SMARTSTACK)                     │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  🔒 platform     → Administration système, NE PAS MODIFIER                  │
+│  🔒 personal     → Espace personnel utilisateur, NE PAS MODIFIER            │
+│  ✅ business     → Applications métier client, ZONE LIBRE                   │
+│                                                                             │
+│  APPLICATIONS RÉSERVÉES:                                                    │
+│  🔒 platform.administration  → Admin core SmartStack                        │
+│  🔒 personal.myspace         → Espace perso core SmartStack                 │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Validation Automatique
+
+```
+AVANT toute génération, VÉRIFIER:
+
+1. SI $LEVEL = "context":
+   RESERVED_CONTEXTS = ["platform", "personal", "business", "system"]
+   SI $CODE IN RESERVED_CONTEXTS:
+       ❌ ERREUR: "Les contextes sont prédéfinis et ne peuvent pas être créés."
+       ABORT
+
+2. SI $LEVEL = "application":
+   SI $PARENT IN ["platform", "personal"]:
+       ❌ ERREUR: "Le context '$PARENT' est réservé au core SmartStack."
+       ❌ ERREUR: "Utilisez le context 'business' pour vos applications métier."
+       SUGGÉRER: "/application:create application business $CODE"
+       ABORT
+
+3. SI $LEVEL = "module":
+   SI $PARENT commence par "platform." OU "personal.":
+       ❌ ERREUR: "Les modules core ne peuvent pas être modifiés."
+       ❌ ERREUR: "Créez vos modules dans 'business.*'"
+       ABORT
+
+4. SI tout est OK:
+   ✅ Continuer vers PHASE 1
+```
+
+### Messages d'Erreur Standards
+
+| Situation | Message |
+|-----------|---------|
+| Création context réservé | "Les contextes sont prédéfinis (platform, personal, business). Créez vos applications dans 'business'." |
+| Application dans platform | "Le context 'platform' est réservé à l'administration SmartStack. Utilisez 'business' pour vos applications métier." |
+| Application dans personal | "Le context 'personal' est réservé aux fonctionnalités utilisateur core. Utilisez 'business'." |
+| Module dans platform.* | "Les modules platform.* sont gérés par SmartStack. Créez vos modules dans business.*" |
+
+---
+
+## PHASE 1: PARSING & VALIDATION
+
+```
+1. EXTRAIRE level, parent, code des arguments
+2. EXÉCUTER PHASE 0 (validation contextes)
+3. SI validation OK → VALIDER que le parent existe (sauf pour context)
+4. DÉTECTER le context racine
+5. GÉNÉRER les chemins de route et permission
+```
+
+---
+
+## PHASE 2: COLLECTE DES TRADUCTIONS
+
+```typescript
+AskUserQuestion({
+  questions: [
+    {
+      header: "Labels FR",
+      question: "Libellés en français ?",
+      options: [
+        { label: "$CODE_PASCAL", description: "Label par défaut" }
+      ]
+    },
+    {
+      header: "Icône",
+      question: "Quelle icône Lucide ?",
+      options: [
+        { label: "Package", description: "Icône produit" },
+        { label: "Folder", description: "Icône générique" },
+        { label: "Settings", description: "Icône configuration" }
+      ]
+    }
+  ]
+})
+```
+
+---
+
+## PHASE 3: GÉNÉRATION DB SEED
+
+| Fichier | Action |
+|---------|--------|
+| `Navigation{Level}Configuration.cs` | Ajouter entité |
+| `NavigationTranslationConfiguration.cs` | Ajouter 4 traductions |
+| `PermissionConfiguration.cs` | Ajouter permissions CRUD |
+| `RolePermissionConfiguration.cs` | Assigner aux rôles |
+
+**Templates:** → `.claude/skills/application/templates-seed.md`
+
+---
+
+## PHASE 4: GÉNÉRATION BACKEND
+
+| Fichier | Action |
+|---------|--------|
+| `Permissions.cs` | Ajouter classe permissions |
+| `I{Entity}Service.cs` | Créer interface |
+| `{Entity}Service.cs` | Créer implémentation |
+| `{Entity}Dto.cs` | Créer DTOs |
+| `{Entity}.cs` | Créer entité Domain |
+| `{Entity}Configuration.cs` | Créer config EF |
+| `IApplicationDbContext.cs` | Ajouter DbSet |
+| `DependencyInjection.cs` | Enregistrer service |
+
+**Templates:** → `.claude/skills/application/templates-backend.md`
+
+**Chaîner:** → `/controller:create $AREA $MODULE $ENTITY`
+
+---
+
+## PHASE 5: GÉNÉRATION FRONTEND
+
+| Fichier | Action |
+|---------|--------|
+| `{Module}Page.tsx` | Créer page principale |
+| `{Module}ListView.tsx` | Créer composant liste |
+| `use{Module}Preferences.ts` | Créer hook préférences |
+| `{module}Api.ts` | Créer service API |
+| `App.tsx` | Ajouter routes |
+
+**Templates:** → `.claude/skills/application/templates-frontend.md`
+
+---
+
+## PHASE 6: GÉNÉRATION I18N
+
+| Fichier | Action |
+|---------|--------|
+| `fr/{module}.json` | Créer traductions FR |
+| `en/{module}.json` | Créer traductions EN |
+| `it/{module}.json` | Créer traductions IT |
+| `de/{module}.json` | Créer traductions DE |
+| `navigation.json` (×4) | Mettre à jour |
+| `i18n/index.ts` | Enregistrer namespace |
+
+**Templates:** → `.claude/skills/application/templates-i18n.md`
+
+---
+
+## PHASE 7: MIGRATION
+
+```bash
+# Chaîner automatiquement
+/efcore:migration Add{Level}{Code}
+```
+
+---
+
+## PHASE 8: VALIDATION
+
+```bash
+# Backend
+dotnet build
+dotnet test
+
+# Frontend
+cd web/smartstack-web
+npm run build
+npm run lint
+npm run test
+```
+
+---
+
+## PHASE 9: RÉSUMÉ
+
+```markdown
+## ✅ Création terminée
+
+### Fichiers créés
+- Backend: X fichiers
+- Frontend: X fichiers
+- i18n: 4 langues
+
+### Navigation
+- Route: /$ROUTE
+- Permission: $PERMISSION_PATH.*
+
+### Prochaines étapes
+1. Vérifier les seeds générés
+2. Tester avec Swagger
+3. Valider l'UI
+
+### Commandes utiles
+- `dotnet ef database update` - Appliquer migration
+- `npm run dev` - Lancer frontend
+```
+
+---
+
+## RÈGLES ABSOLUES
+
+1. **TOUJOURS** exécuter PHASE 0 (validation contextes) en premier
+2. **TOUJOURS** 4 langues (FR, EN, IT, DE)
+3. **TOUJOURS** respecter l'architecture en couches
+4. **TOUJOURS** implémenter les préférences utilisateur (template complet)
+5. **TOUJOURS** chaîner avec `/controller:create` et `/efcore:migration`
+6. **TOUJOURS** utiliser des GUIDs aléatoires (voir templates-seed.md)
+7. **JAMAIS** de violation d'architecture (WEB → Infrastructure)
+8. **JAMAIS** de traduction manquante
+9. **JAMAIS** de création dans les contextes réservés (platform, personal)
+
+---
+
+## EXEMPLES VALIDES ET INVALIDES
+
+### ✅ VALIDE - Applications métier client
+
+```bash
+# Créer une application dans business
+/application:create application business crm
+
+# Créer un module dans business.crm
+/application:create module business.crm leads
+
+# Créer une section dans business.crm.leads
+/application:create section business.crm.leads import
+```
+
+### ❌ INVALIDE - Tentatives sur contextes réservés
+
+```bash
+# ERREUR: Création de context
+/application:create context _ erp
+→ "Les contextes sont prédéfinis. Utilisez 'business'."
+
+# ERREUR: Application dans platform
+/application:create application platform sales
+→ "Le context 'platform' est réservé. Utilisez 'business'."
+
+# ERREUR: Module dans platform.administration
+/application:create module platform.administration custom
+→ "Les modules core ne peuvent pas être modifiés."
+```
+
+---
+
+## MAPPING NIVEAU → GÉNÉRATION
+
+| Niveau | DB Seed | Backend | Frontend | i18n |
+|--------|---------|---------|----------|------|
+| Context | ❌ (prédéfini) | ❌ | ❌ | ❌ |
+| Application | ✅ | ❌ | ✅ (layout) | ✅ (nav) |
+| Module | ✅ | ✅ (complet) | ✅ (complet) | ✅ (complet) |
+| Section | ✅ | ✅ (optionnel) | ✅ (tabs) | ✅ (nav) |
+
+---
+
+## SOURCES DE DONNÉES
+
+| Donnée | Source |
+|--------|--------|
+| Navigation entities | `src/SmartStack.Infrastructure/Persistence/Configurations/Navigation/` |
+| Translations | `NavigationTranslationConfiguration.cs` |
+| Permissions | `src/SmartStack.Application/Common/Authorization/Permissions.cs` |
+| i18n locales | `web/smartstack-web/src/i18n/locales/` |
+| Routes | `web/smartstack-web/src/App.tsx` |