@atlashub/smartstack-cli 1.11.0 → 1.12.0

package/templates/commands/efcore/db-seed.md

@@ -6,377 +6,98 @@ model: haiku
 
 # EF Core Database Seed
 
-Inserts test or initial data into the database using EF Core HasData() or Seeder classes.
-
-> **CLAUDE INSTRUCTION:** The `AskUserQuestion({...})` blocks are instructions to use the `AskUserQuestion` tool in an **interactive** manner. You MUST execute the tool with these parameters to get the user's response BEFORE continuing.
+> **Ref:** [_shared.md](_shared.md)
 
 ---
 
-## RÈGLES DE CONFORMITÉ (OBLIGATOIRE)
+## Conformité
 
-> **INTERDIT - Violations CLAUDE.md:**
-> - ❌ Scripts SQL (.sql files) dans le repository
-> - ❌ Utilisation de `sqlcmd` avec SQL brut
-> - ❌ `migrationBuilder.Sql()` avec INSERT statements
->
-> **OBLIGATOIRE - Méthodes autorisées:**
-> - ✅ `HasData()` dans les configurations EF Core
-> - ✅ Classes `IDataSeeder` exécutées au démarrage
-> - ✅ Migrations EF Core avec données typées
->
-> **Contact support:** support@atlshub.ch
+| ❌ INTERDIT | ✅ OBLIGATOIRE |
+|-------------|----------------|
+| Scripts .sql dans repo | `HasData()` dans configurations |
+| `sqlcmd` avec INSERT | Classes `IDataSeeder` |
+| `migrationBuilder.Sql()` INSERT | Migrations EF Core typées |
 
 ---
 
-## STEP 0: Verification environnement et connexion
-
-> **Include:** `_env-check.md` (etapes 0.1 a 0.5)
-
-### 0.1 Detecter et afficher l'environnement
+## STEP 0: Vérification Environnement
 
 ```bash
-# Scanner les fichiers appsettings
-API_DIR=$(find . -type d -name "*.Api" | head -1)
-[ -z "$API_DIR" ] && API_DIR="src/SmartStack.Api"
-
-# Selectionner l'environnement
-ENV_FLAG="${1#--env=}"
-if [ -n "$ENV_FLAG" ] && [ "$ENV_FLAG" != "$1" ]; then
-  SELECTED_ENV="appsettings.${ENV_FLAG}.json"
-elif [ -f "$API_DIR/appsettings.Local.json" ]; then
-  SELECTED_ENV="appsettings.Local.json"
-else
-  echo "ERROR: Aucun fichier appsettings trouve"
-  exit 1
-fi
-
-# Extraire connection string
-CONNECTION_STRING=$(powershell -Command "
-  \$json = Get-Content '$API_DIR/$SELECTED_ENV' | ConvertFrom-Json
-  \$json.ConnectionStrings.DefaultConnection
-")
-
-DATABASE_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Database=\K[^;]+')
-SERVER_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Server=\K[^;]+')
-
-# Protection Production
-if [[ "$SELECTED_ENV" == *"Production"* ]]; then
-  echo "BLOQUE: Seed interdit en environnement Production"
-  exit 1
-fi
-```
-
-### 0.2 Afficher le resume
-
-```
-================================================================================
-                         EF CORE - DATABASE SEED
-================================================================================
-
-ENVIRONNEMENT: {SELECTED_ENV}
-
-BASE DE DONNEES CIBLE:
-  Server:   {SERVER_NAME}
-  Database: {DATABASE_NAME}
-
-================================================================================
+detect_environment
+block_production
 ```
 
 ---
 
-## STEP 1: Detect available seeding methods
+## STEP 1: Détecter Méthodes Disponibles
 
 ```bash
-# Search for COMPLIANT seed methods only
-SEED_METHODS=""
+# HasData() dans configurations (RECOMMANDÉ)
+grep -rq "\.HasData(" . --include="*.cs" && SEED_METHODS+=" hasdata"
 
-# 1. DbSeeder or DataSeeder class
-if grep -rq "class.*Seeder\|class.*Seed\|IDataSeeder" . --include="*.cs" 2>/dev/null; then
-  SEED_METHODS="$SEED_METHODS seeder-class"
-fi
+# Classes IDataSeeder
+grep -rq "IDataSeeder\|class.*Seeder" . --include="*.cs" && SEED_METHODS+=" seeder-class"
 
-# 2. HasData() in configurations (RECOMMENDED)
-if grep -rq "\.HasData(" . --include="*.cs" 2>/dev/null; then
-  SEED_METHODS="$SEED_METHODS hasdata"
-fi
+# Argument --seed dans Program.cs
+grep -q "\-\-seed" ./Program.cs && SEED_METHODS+=" cli-argument"
 
-# 3. --seed argument in Program.cs
-if grep -q "\-\-seed" ./Program.cs 2>/dev/null; then
-  SEED_METHODS="$SEED_METHODS cli-argument"
-fi
-
-# WARNING: Detect forbidden SQL scripts
-if [ -f "./scripts/seed.sql" ] || [ -f "./Data/seed.sql" ]; then
-  echo "⚠️  WARNING: SQL seed scripts detected - FORBIDDEN by CLAUDE.md"
-  echo "   Please migrate to HasData() in EF Core configurations"
-  echo "   Contact: support@atlshub.ch"
-fi
+# WARNING si scripts SQL détectés
+[ -f "./scripts/seed.sql" ] && echo "⚠️ Scripts SQL détectés - INTERDIT"
 ```
 
 ---
 
-## STEP 2: Display options
-
-```
-================================================================================
-                         EF CORE - DATABASE SEED
-================================================================================
-
-DETECTED METHODS:
-```
-
-**If methods found:**
+## STEP 2: Sélection Méthode
 
 ```javascript
-// Build options dynamically - ONLY COMPLIANT METHODS
-options = []
-
-if (SEED_METHODS.includes("hasdata")) {
-  options.push({
-    label: "HasData (Recommended)",
-    description: "Data seeded via EF Core migrations - compliant"
-  })
-}
-
-if (SEED_METHODS.includes("seeder-class")) {
-  options.push({
-    label: "Seeder Class",
-    description: "Execute DbSeeder/DataSeeder class at startup"
-  })
-}
-
-if (SEED_METHODS.includes("cli-argument")) {
-  options.push({
-    label: "CLI --seed",
-    description: "Launch app with --seed argument"
-  })
-}
-
 AskUserQuestion({
   questions: [{
-    question: "Which seeding method to use?",
+    question: "Méthode de seeding?",
     header: "Seed",
-    options: options,
+    options: [
+      { label: "HasData (Recommandé)", description: "Via migrations EF Core" },
+      { label: "Seeder Class", description: "Exécuter DbSeeder/DataSeeder" },
+      { label: "CLI --seed", description: "Lancer app avec --seed" }
+    ],
     multiSelect: false
   }]
 })
 ```
 
-**If no method found:**
-
-```
-⚠️  No seeding method detected
-
-SOLUTION RECOMMANDÉE - HasData():
-────────────────────────────────────────────────────────────────────────────────
-Ajoutez HasData() dans vos fichiers *Configuration.cs :
-
-public class UserConfiguration : IEntityTypeConfiguration<User>
-{
-    public void Configure(EntityTypeBuilder<User> builder)
-    {
-        builder.HasData(new User
-        {
-            Id = Guid.Parse("7f3c9a2e-8d1b-4e5f-a6c8-9b4d2f7e1a3c"), // Random GUID
-            Name = "Admin",
-            Email = "admin@example.com",
-            CreatedAt = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc)
-        });
-    }
-}
-────────────────────────────────────────────────────────────────────────────────
-
-Puis créez une migration:
-  dotnet ef migrations add SeedInitialData
-
-ALTERNATIVE - Seeder Class:
-────────────────────────────────────────────────────────────────────────────────
-public interface IDataSeeder
-{
-    Task SeedAsync(CancellationToken ct = default);
-}
-
-public class DatabaseSeeder : IDataSeeder
-{
-    private readonly ApplicationDbContext _context;
-
-    public async Task SeedAsync(CancellationToken ct = default)
-    {
-        if (!await _context.Users.AnyAsync(ct))
-        {
-            _context.Users.Add(new User { ... });
-            await _context.SaveChangesAsync(ct);
-        }
-    }
-}
-────────────────────────────────────────────────────────────────────────────────
-
-❌ INTERDIT: Création de scripts SQL (.sql files)
-   Contact: support@atlshub.ch
-```
-
----
-
-## STEP 3: Execute seeding
-
-### Option A: HasData (via migrations)
-
-```bash
-# Les données sont déjà dans les migrations
-# Simplement appliquer les migrations
-STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
-INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)
-
-dotnet ef database update \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT"
-
-echo "✓ HasData() seed applied via migrations"
-```
-
-### Option B: Seeder Class
-
-```bash
-# Detect startup project
-STARTUP_PROJECT=$(find . -name "*.csproj" -exec grep -l "Microsoft.AspNetCore" {} \; | head -1)
-
-# Execute with seed option
-dotnet run --project "$STARTUP_PROJECT" -- --seed
-
-echo "✓ Seeder class executed"
-```
-
-### Option C: CLI --seed
-
-```bash
-STARTUP_PROJECT=$(find . -name "*.csproj" -exec grep -l "Microsoft.AspNetCore" {} \; | head -1)
-dotnet run --project "$STARTUP_PROJECT" -- --seed
-```
+**Si aucune méthode:** afficher guide HasData() et IDataSeeder.
 
 ---
 
-## STEP 4: Verification
+## STEP 3: Exécution
 
-```bash
-# Verify seeding via EF Core context
-STARTUP_PROJECT=$(find . -name "*.csproj" -exec grep -l "Microsoft.AspNetCore" {} \; | head -1)
+**HasData:** `dotnet ef database update`
 
-# Run verification endpoint or check via application
-echo "Verification: Launch application and check data"
-echo "  dotnet run --project $STARTUP_PROJECT"
-echo ""
-echo "Or check via EF Core:"
-echo "  dotnet ef dbcontext info"
-```
+**Seeder Class:** `dotnet run --project "$STARTUP_PROJECT" -- --seed`
 
 ---
 
-## STEP 5: Resume
-
-**Afficher un resume apres le seeding:**
+## Résumé
 
 ```
-===============================================================================
-                         DONNÉES INSÉRÉES
-===============================================================================
-
-DÉTAILS SEED
--------------------------------------------------------------------------------
-  • Environnement: {SELECTED_ENV}
-  • Base:          {DATABASE_NAME}
-  • Méthode:       {method_used}
-
-OPÉRATIONS EFFECTUÉES
--------------------------------------------------------------------------------
-  ✓ Données initiales insérées avec succès
-  ✓ Méthode conforme: {method_used}
-
-CONFORMITÉ
--------------------------------------------------------------------------------
-  ✓ EF Core natif (HasData ou Seeder)
-  ✓ Pas de SQL brut
-  ✓ Conforme aux règles CLAUDE.md
-
-===============================================================================
-                         PROCHAINES ÉTAPES
-===============================================================================
-
-1. Vérifier le statut de la base:
-   /efcore:db-status
-
-2. Lancer l'application:
-   dotnet run --project {STARTUP_PROJECT}
-
-3. Vérifier les données via l'API:
-   GET /api/{entities}
-
-===============================================================================
-```
-
-**Si aucune méthode de seeding détectée:**
-
-```
-===============================================================================
-                    AUCUNE MÉTHODE DE SEED DÉTECTÉE
-===============================================================================
-
-PROBLÈME
--------------------------------------------------------------------------------
-  ✗ Aucune méthode de seeding trouvée dans le projet
-
-MÉTHODES RECHERCHÉES
--------------------------------------------------------------------------------
-  ○ HasData() dans les configurations EF Core
-  ○ Classes IDataSeeder / DbSeeder
-  ○ Argument --seed dans Program.cs
-
-===============================================================================
-                         ACTIONS SUGGÉRÉES
-===============================================================================
-
-1. RECOMMANDÉ - Ajouter HasData() dans vos configurations:
-   Voir documentation ci-dessus
-
-2. ALTERNATIVE - Créer une classe Seeder:
-   Implémenter IDataSeeder
-
-3. Besoin d'aide?
-   support@atlshub.ch
-
-===============================================================================
+SEED - {DATABASE_NAME}
+├── Environnement: {SELECTED_ENV}
+├── Méthode: {method_used}
+├── Conformité: ✓ EF Core natif, ✓ Pas de SQL brut
+└── Prochains: /efcore:db-status, dotnet run
 ```
 
 ---
 
-## Migration de scripts SQL existants
+## Guide Migration SQL → HasData
 
-Si vous avez des scripts SQL legacy, migrez-les vers HasData():
-
-```
-AVANT (INTERDIT):
-────────────────────────────────────────────────────────────────────────────────
--- scripts/seed.sql
-INSERT INTO Users (Id, Name, Email) VALUES (1, 'Admin', 'admin@test.com');
-────────────────────────────────────────────────────────────────────────────────
+```csharp
+// ❌ AVANT (INTERDIT): scripts/seed.sql
+INSERT INTO Users (Id, Name) VALUES (1, 'Admin');
 
-APRÈS (CORRECT):
-────────────────────────────────────────────────────────────────────────────────
-// UserConfiguration.cs
-builder.HasData(new User
-{
+// ✅ APRÈS (CORRECT): UserConfiguration.cs
+builder.HasData(new User {
     Id = Guid.Parse("7f3c9a2e-8d1b-4e5f-a6c8-9b4d2f7e1a3c"),
-    Name = "Admin",
-    Email = "admin@test.com"
+    Name = "Admin"
 });
-────────────────────────────────────────────────────────────────────────────────
-
-Puis: dotnet ef migrations add MigrateSeedData
+// Puis: dotnet ef migrations add SeedData
 ```
-
----
-
-## Support
-
-> **Questions ou problèmes avec le seeding EF Core?**
->
-> 📧 **support@atlshub.ch**