@atlashub/smartstack-cli 1.1.0

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

@@ -0,0 +1,326 @@
+---
+description: Populate database with test or initial data
+agent: efcore-db-seed
+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.
+
+---
+
+## RÈGLES DE CONFORMITÉ (OBLIGATOIRE)
+
+> **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
+
+---
+
+## STEP 0: Verification environnement et connexion
+
+> **Include:** `_env-check.md` (etapes 0.1 a 0.5)
+
+### 0.1 Detecter et afficher l'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}
+
+================================================================================
+```
+
+---
+
+## STEP 1: Detect available seeding methods
+
+```bash
+# Search for COMPLIANT seed methods only
+SEED_METHODS=""
+
+# 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
+
+# 2. HasData() in configurations (RECOMMENDED)
+if grep -rq "\.HasData(" . --include="*.cs" 2>/dev/null; then
+  SEED_METHODS="$SEED_METHODS hasdata"
+fi
+
+# 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
+```
+
+---
+
+## STEP 2: Display options
+
+```
+================================================================================
+                         EF CORE - DATABASE SEED
+================================================================================
+
+DETECTED METHODS:
+```
+
+**If methods found:**
+
+```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?",
+    header: "Seed",
+    options: options,
+    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
+```
+
+---
+
+## STEP 4: Verification
+
+```bash
+# Verify seeding via EF Core context
+STARTUP_PROJECT=$(find . -name "*.csproj" -exec grep -l "Microsoft.AspNetCore" {} \; | head -1)
+
+# 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"
+```
+
+---
+
+## STEP 5: Summary
+
+```
+================================================================================
+                         SEEDING COMPLETE
+================================================================================
+
+METHOD:      {method used}
+COMPLIANT:   ✓ EF Core native (no raw SQL)
+
+✓ Database populated successfully
+
+NEXT COMMANDS:
+  /efcore:db-status  → Check status
+  dotnet run         → Launch application
+
+================================================================================
+```
+
+---
+
+## Migration de scripts SQL existants
+
+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');
+────────────────────────────────────────────────────────────────────────────────
+
+APRÈS (CORRECT):
+────────────────────────────────────────────────────────────────────────────────
+// UserConfiguration.cs
+builder.HasData(new User
+{
+    Id = Guid.Parse("7f3c9a2e-8d1b-4e5f-a6c8-9b4d2f7e1a3c"),
+    Name = "Admin",
+    Email = "admin@test.com"
+});
+────────────────────────────────────────────────────────────────────────────────
+
+Puis: dotnet ef migrations add MigrateSeedData
+```
+
+---
+
+## Support
+
+> **Questions ou problèmes avec le seeding EF Core?**
+>
+> 📧 **support@atlshub.ch**

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

@@ -0,0 +1,214 @@
+---
+description: Display migrations and database status
+agent: efcore-db-status
+model: haiku
+---
+
+# EF Core Database Status
+
+Displays the complete status of EF Core migrations and database connection.
+
+**Quick command, read-only, no modifications.**
+
+---
+
+## STEP 1: Detect configuration
+
+```bash
+# Check config files
+CONFIG_LOCAL="appsettings.Local.json"
+CONFIG_DEV="appsettings.Development.json"
+CONFIG_DEFAULT="appsettings.json"
+
+if [ -f "$CONFIG_LOCAL" ]; then
+  CONFIG_USED="$CONFIG_LOCAL"
+elif [ -f "$CONFIG_DEV" ]; then
+  CONFIG_USED="$CONFIG_DEV"
+else
+  CONFIG_USED="$CONFIG_DEFAULT"
+fi
+
+# Detect EF Core project
+CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
+PROJECT_DIR=$(dirname "$CSPROJ")
+PROJECT_NAME=$(basename "$CSPROJ" .csproj)
+```
+
+---
+
+## STEP 2: Test connection
+
+```bash
+cd "$PROJECT_DIR"
+
+# Test connection with EF Core
+CONNECTION_OK=$(dotnet ef database list 2>&1)
+if echo "$CONNECTION_OK" | grep -q "error\|Error\|failed"; then
+  CONNECTION_STATUS="❌ Failed"
+  CONNECTION_ERROR="$CONNECTION_OK"
+else
+  CONNECTION_STATUS="✓ OK"
+fi
+```
+
+---
+
+## STEP 3: List migrations
+
+```bash
+# Migrations in code
+CODE_MIGRATIONS=$(dotnet ef migrations list 2>/dev/null | grep -v "^Build" | grep -v "^$")
+TOTAL_MIGRATIONS=$(echo "$CODE_MIGRATIONS" | wc -l)
+
+# Applied vs pending migrations
+APPLIED=$(dotnet ef migrations list 2>/dev/null | grep "(Pending)" -v | grep -v "^Build" | wc -l)
+PENDING=$(dotnet ef migrations list 2>/dev/null | grep "(Pending)" | wc -l)
+```
+
+---
+
+## STEP 4: Display report
+
+```
+================================================================================
+                         EF CORE - DATABASE STATUS
+================================================================================
+
+PROJECT
+  Name:          {PROJECT_NAME}
+  Config:        {CONFIG_USED}
+  DbContext:     {CONTEXT_NAME}
+
+CONNECTION
+  Status:        {CONNECTION_STATUS}
+  Server:        {SERVER}
+  Database:      {DATABASE}
+
+MIGRATIONS
+  Total:         {TOTAL_MIGRATIONS}
+  Applied:       {APPLIED} ✓
+  Pending:       {PENDING} {⚠️ if > 0}
+
+================================================================================
+```
+
+**If pending migrations:**
+
+```
+PENDING MIGRATIONS
+────────────────────────────────────────────────────────────────────────────────
+  1. {MigrationName1}  (Pending)
+  2. {MigrationName2}  (Pending)
+────────────────────────────────────────────────────────────────────────────────
+
+→ Use /efcore:db-deploy to apply migrations
+```
+
+**If connection error:**
+
+```
+⚠️  CONNECTION PROBLEM
+────────────────────────────────────────────────────────────────────────────────
+{CONNECTION_ERROR}
+────────────────────────────────────────────────────────────────────────────────
+
+CHECKS:
+  1. Is SQL Server running?
+  2. Is appsettings.Local.json configured?
+  3. Does the database exist?
+
+COMMANDS:
+  /efcore:db-reset   → Create/recreate database
+  /gitflow:10-start  → Configure appsettings.Local.json
+```
+
+---
+
+## STEP 4.5: Check "1 migration per feature" rule
+
+```bash
+# Current branch
+CURRENT_BRANCH=$(git branch --show-current)
+
+# Extract branch type
+if [[ "$CURRENT_BRANCH" == feature/* ]]; then
+  BRANCH_TYPE="Feature"
+  BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's/feature\///' | sed 's/-/_/g')
+elif [[ "$CURRENT_BRANCH" == hotfix/* ]]; then
+  BRANCH_TYPE="Hotfix"
+  BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's/hotfix\///' | sed 's/-/_/g')
+else
+  BRANCH_TYPE=""
+fi
+
+# If on a feature/hotfix, count migrations for this branch
+if [ -n "$BRANCH_TYPE" ]; then
+  # Search for migrations matching the branch pattern
+  BRANCH_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -iE "${BRANCH_TYPE}.*${BRANCH_NAME}" | grep -v "Designer" | grep -v "Snapshot" | wc -l)
+fi
+```
+
+**Display verification:**
+
+```
+"1 MIGRATION PER FEATURE" RULE
+────────────────────────────────────────────────────────────────────────────────
+  Branch:       {CURRENT_BRANCH}
+  Migrations:   {BRANCH_MIGRATIONS} for this branch
+```
+
+**If BRANCH_MIGRATIONS > 1:**
+
+```
+  ⚠️  WARNING: {BRANCH_MIGRATIONS} migrations detected for this branch!
+      Rule: 1 migration only per feature/hotfix
+
+      RECOMMENDED ACTION:
+        /efcore:migration  → Recreate as single migration
+
+      Multiple migrations cause problems during merge.
+────────────────────────────────────────────────────────────────────────────────
+```
+
+**If BRANCH_MIGRATIONS == 1:**
+
+```
+  ✓ Rule respected: 1 migration for this branch
+────────────────────────────────────────────────────────────────────────────────
+```
+
+**If BRANCH_MIGRATIONS == 0 and pending modifications:**
+
+```
+  ○ No migrations for this branch
+    → Use /efcore:migration if you modified the model
+────────────────────────────────────────────────────────────────────────────────
+```
+
+---
+
+## STEP 5: Additional info (optional)
+
+```bash
+# Database size (if connection OK)
+DB_SIZE=$(sqlcmd -S "$SERVER" -E -Q "SELECT CAST(SUM(size * 8 / 1024.0) AS DECIMAL(10,2)) AS 'MB' FROM sys.master_files WHERE database_id = DB_ID('$DATABASE')" -h -1 2>/dev/null)
+
+# Number of tables
+TABLE_COUNT=$(sqlcmd -S "$SERVER" -E -d "$DATABASE" -Q "SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE = 'BASE TABLE'" -h -1 2>/dev/null)
+```
+
+```
+STATISTICS
+  Size:          {DB_SIZE} MB
+  Tables:        {TABLE_COUNT}
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--verbose` | Display all migrations with details |
+| `--json` | JSON output for scripting |
+| `--context {name}` | Specify the DbContext |