@atlashub/smartstack-cli 1.11.0 → 1.12.0

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

@@ -6,451 +6,112 @@ model: sonnet
 
 # EF Core Database Reset
 
-Drops and recreates the database, then applies all migrations using EF Core CLI only.
-
-**WARNING: This command DELETES all data!**
-
-> **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)
+> **WARNING:** SUPPRIME TOUTES LES DONNÉES!
 
 ---
 
-## RÈGLES DE CONFORMITÉ (OBLIGATOIRE)
+## Conformité
 
-> **INTERDIT - Violations CLAUDE.md:**
-> - ❌ Utilisation de `sqlcmd` avec SQL brut
-> - ❌ Scripts SQL (.sql files) dans le repository
-> - ❌ Commandes SQL directes pour backup/restore
->
-> **OBLIGATOIRE - Méthodes autorisées:**
-> - ✅ `dotnet ef database drop` pour supprimer
-> - ✅ `dotnet ef database update` pour recréer
-> - ✅ Backup via outils externes (SQL Server Management Studio, Azure)
->
-> **Contact support:** support@atlshub.ch
+| ❌ INTERDIT | ✅ OBLIGATOIRE |
+|-------------|----------------|
+| `sqlcmd` avec SQL brut | `dotnet ef database drop` |
+| Scripts .sql dans repo | `dotnet ef database update` |
+| Backup via scripts | Backup via SSMS/Azure |
 
 ---
 
-## STEP 0: Verification environnement et connexion (CRITIQUE)
-
-> **Include:** `_env-check.md` - TOUTES les etapes car commande destructive
-
-### 0.1 Detecter les fichiers appsettings
-
-```bash
-# Scanner les fichiers appsettings
-API_DIR=$(find . -type d -name "*.Api" | head -1)
-[ -z "$API_DIR" ] && API_DIR="src/SmartStack.Api"
-
-echo "FICHIERS APPSETTINGS DISPONIBLES:"
-find "$API_DIR" -maxdepth 1 -name "appsettings*.json" 2>/dev/null | while read f; do
-  echo "  - $(basename $f)"
-done
-```
-
-### 0.2 Selectionner l'environnement
+## STEP 0: Vérification Environnement
 
 ```bash
-# Priorite: --env flag > appsettings.Local.json > erreur
-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"
-  echo "  Creez appsettings.Local.json ou utilisez --env {Environment}"
-  exit 1
-fi
-
-echo ""
-echo "ENVIRONNEMENT SELECTIONNE: $SELECTED_ENV"
+detect_environment
+block_production  # BLOQUANT si Production
 ```
 
-### 0.3 Extraire et afficher la connexion
-
-```bash
-# 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[^;]+')
-CONNECTION_MASKED=$(echo "$CONNECTION_STRING" | sed 's/Password=[^;]*/Password=****/g')
-```
-
-### 0.4 Afficher le WARNING avec details de la base
-
-```
-================================================================================
-              EF CORE - DATABASE RESET (OPERATION DESTRUCTIVE)
-================================================================================
-
-ENVIRONNEMENT: {SELECTED_ENV}
-
-BASE DE DONNEES QUI SERA SUPPRIMEE:
-  Server:   {SERVER_NAME}
-  Database: {DATABASE_NAME}
-  String:   {CONNECTION_MASKED}
-
-================================================================================
-```
-
-### 0.5 Protection Production (BLOQUANT)
-
-```bash
-# Bloquer si Production detecte
-if [[ "$SELECTED_ENV" == *"Production"* ]]; then
-  echo "================================================================================
-                         BLOQUE - ENVIRONNEMENT PRODUCTION
-================================================================================
-
-ERREUR: Reset interdit en environnement Production
-
-Cette commande est bloquee pour proteger les donnees de production.
-
-OPTIONS:
-1. Utilisez appsettings.Local.json (defaut, recommande)
-2. Utilisez --env Development ou --env Staging
-
-Contact: support@atlshub.ch
-
-================================================================================"
-  exit 1
-fi
-```
+Afficher: base qui sera supprimée (SERVER, DATABASE).
 
 ---
 
-## STEP 1: Confirmation obligatoire (avec nom de la base)
-
-> **CRITIQUE:** L'utilisateur doit voir exactement quelle base sera supprimee.
+## STEP 1: Confirmation
 
 ```javascript
 AskUserQuestion({
   questions: [{
-    question: "DANGER: Supprimer DEFINITIVEMENT la base '" + DATABASE_NAME + "' sur " + SERVER_NAME + "? TOUTES LES DONNEES SERONT PERDUES!",
+    question: "DANGER: Supprimer DÉFINITIVEMENT '" + DATABASE_NAME + "'? TOUTES LES DONNÉES SERONT PERDUES!",
     header: "Reset DB",
     options: [
-      { label: "Oui, supprimer " + DATABASE_NAME, description: "Drop + Recreate (DATA LOSS IRREVERSIBLE)" },
-      { label: "Non, annuler", description: "Conserver la base actuelle" }
+      { label: "Oui, supprimer " + DATABASE_NAME, description: "Drop + Recreate (IRRÉVERSIBLE)" },
+      { label: "Non, annuler", description: "Conserver la base" }
     ],
     multiSelect: false
   }]
 })
 ```
 
-**If No → Stop immediately**
-
----
-
-## STEP 2: Detecter les projets EF Core
-
-```bash
-# Detect EF Core projects
-STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
-INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)
-
-if [ -z "$INFRA_PROJECT" ]; then
-  INFRA_PROJECT=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
-fi
-
-echo "Startup project: $STARTUP_PROJECT"
-echo "Infrastructure project: $INFRA_PROJECT"
-```
-
 ---
 
-## STEP 3: Backup recommendation
+## STEP 2: Backup (optionnel)
 
 ```javascript
 AskUserQuestion({
   questions: [{
-    question: "Do you need to backup data before deletion?",
+    question: "Backup nécessaire avant suppression?",
     header: "Backup",
     options: [
-      { label: "No backup needed", description: "Development data only - proceed" },
-      { label: "Manual backup first", description: "I'll backup via SSMS/Azure Portal" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-**If manual backup:**
-
-```
-================================================================================
-                         BACKUP INSTRUCTIONS
-================================================================================
-
-Pour sauvegarder votre base de données AVANT le reset:
-
-OPTION 1 - SQL Server Management Studio (SSMS):
-  1. Connectez-vous à votre serveur
-  2. Clic droit sur la DB → Tasks → Back Up...
-  3. Sélectionnez destination et lancez
-
-OPTION 2 - Azure Portal (si Azure SQL):
-  1. Azure Portal → Votre DB → Export
-  2. Configurez le storage account
-  3. Lancez l'export
-
-OPTION 3 - Azure Data Studio:
-  1. Connectez-vous → Clic droit DB → Backup
-
-Une fois le backup effectué, relancez /efcore:db-reset
-
-================================================================================
-```
-
-**Stop and wait for user to complete backup manually**
-
----
-
-## STEP 4: Check migration state BEFORE drop
-
-```bash
-echo "Checking migration state..."
-
-# List migrations in codebase
-CODE_MIGRATIONS=$(dotnet ef migrations list \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --no-build 2>/dev/null | grep -E "^[0-9]{14}_" | wc -l)
-
-echo "  Migrations in codebase: $CODE_MIGRATIONS"
-
-# Try to get applied migrations from database (may fail if DB doesn't exist)
-APPLIED_MIGRATIONS=$(dotnet ef migrations list \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --no-build 2>/dev/null | grep -E "^\s*[0-9]{14}_.*\(Applied\)" | wc -l)
-
-echo "  Migrations applied in DB: $APPLIED_MIGRATIONS"
-
-# List migration names for display
-echo ""
-echo "Migrations in codebase:"
-dotnet ef migrations list \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --no-build 2>/dev/null | grep -E "^[0-9]{14}_" | head -20
-```
-
----
-
-## STEP 5: Confirm migration reset strategy
-
-> **IMPORTANT:** If migrations were squashed (fewer migrations in code than previously applied),
-> applying all migrations will create a fresh database with the NEW migration history.
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "How should we handle migrations after database reset?",
-    header: "Migrations",
-    options: [
-      { label: "Apply current migrations", description: "Use migrations currently in codebase (recommended after squash)" },
-      { label: "Cancel reset", description: "Stop and review migration state first" }
+      { label: "Non", description: "Données dev uniquement - continuer" },
+      { label: "Backup manuel", description: "Via SSMS/Azure Portal" }
     ],
     multiSelect: false
   }]
 })
 ```
 
-**If "Cancel reset" → Stop immediately and suggest:**
-
-```
-================================================================================
-                    RESET CANCELLED - REVIEW MIGRATIONS
-================================================================================
-
-Pour vérifier l'état des migrations:
-
-  /efcore:db-status     → Voir les migrations appliquées vs disponibles
-  /efcore:scan          → Scanner les migrations sur toutes les branches
-
-Si des migrations ont été squashées:
-  - Les anciennes migrations n'existent plus dans le code
-  - Le reset appliquera uniquement les nouvelles migrations
-  - C'est le comportement ATTENDU après un squash
-
-Si vous voulez restaurer d'anciennes migrations:
-  - Vérifiez l'historique git: git log --oneline -- "**/Migrations/"
-  - Restaurez les fichiers: git checkout <commit> -- path/to/Migrations/
-
-================================================================================
-```
+Si backup manuel: afficher instructions SSMS/Azure, stopper.
 
 ---
 
-## STEP 6: Drop database
+## STEP 3: Drop Database
 
 ```bash
-echo "Dropping database..."
-
-# Use EF Core CLI only (NO sqlcmd)
-dotnet ef database drop \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --force
-
-if [ $? -eq 0 ]; then
-  echo "  Database dropped successfully"
-else
-  echo "  WARNING: Drop command returned error (database may not exist)"
-fi
+dotnet ef database drop --project "$INFRA_PROJECT" --startup-project "$STARTUP_PROJECT" --force
 ```
 
 ---
 
-## STEP 7: Recreate and apply migrations
+## STEP 4: Recreate + Apply
 
 ```bash
-echo "Applying all migrations..."
-
-# Apply all migrations (creates database if missing)
-dotnet ef database update \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --verbose
-
-if [ $? -ne 0 ]; then
-  echo "ERROR: Failed to apply migrations"
-  exit 1
-fi
-
-echo "  Database recreated with all migrations"
+dotnet ef database update --project "$INFRA_PROJECT" --startup-project "$STARTUP_PROJECT" --verbose
 ```
 
 ---
 
-## STEP 8: Optional seed
+## STEP 5: Seed (optionnel)
 
 ```javascript
 AskUserQuestion({
   questions: [{
-    question: "Populate database with test data (via HasData)?",
+    question: "Peupler avec données test (HasData)?",
     header: "Seed",
     options: [
-      { label: "Yes (recommended)", description: "Apply HasData seed from migrations" },
-      { label: "No", description: "Empty database" }
+      { label: "Oui (recommandé)", description: "Appliquer HasData" },
+      { label: "Non", description: "Base vide" }
     ],
     multiSelect: false
   }]
 })
 ```
 
-**If yes:**
-
-```bash
-# HasData is already applied via migrations
-# If additional seeding needed, use Seeder class
-if grep -rq "IDataSeeder\|class.*Seeder" . --include="*.cs" 2>/dev/null; then
-  echo "Executing DataSeeder..."
-  dotnet run --project "$STARTUP_PROJECT" -- --seed
-else
-  echo "  HasData() seed already applied via migrations"
-fi
-```
-
----
-
-## STEP 9: Verification
-
-```bash
-echo "Verifying database..."
-
-# Check migrations status
-dotnet ef migrations list \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --no-build 2>/dev/null | tail -10
-
-echo ""
-echo "  Use /efcore:db-status for detailed status"
-```
-
 ---
 
-## STEP 10: Resume
-
-**Afficher un resume apres le reset:**
+## Résumé
 
 ```
-===============================================================================
-                         BASE DE DONNÉES RÉINITIALISÉE
-===============================================================================
-
-DÉTAILS RESET
--------------------------------------------------------------------------------
-  • Environnement: {SELECTED_ENV}
-  • Serveur:       {SERVER_NAME}
-  • Base:          {DATABASE_NAME}
-
-OPÉRATIONS EFFECTUÉES
--------------------------------------------------------------------------------
-  ✓ Ancienne base supprimée (dotnet ef database drop)
-  ✓ Nouvelle base créée (dotnet ef database update)
-  ✓ {N} migration(s) appliquée(s)
-  {seed_applied ? "✓ Données initiales insérées (HasData)" : "○ Base vide (pas de seed)"}
-
-CONFORMITÉ
--------------------------------------------------------------------------------
-  ✓ EF Core CLI uniquement (pas de SQL brut)
-  ✓ Conforme aux règles CLAUDE.md
-
-===============================================================================
-                         PROCHAINES ÉTAPES
-===============================================================================
-
-1. Vérifier le statut de la base:
-   /efcore:db-status
-
-2. Ajouter des données de test (si nécessaire):
-   /efcore:db-seed
-
-3. Lancer l'application:
-   dotnet run --project {STARTUP_PROJECT}
-
-===============================================================================
-```
-
-**Si le reset a échoué:**
-
-```
-===============================================================================
-                    ÉCHEC DU RESET
-===============================================================================
-
-ERREUR
--------------------------------------------------------------------------------
-  ✗ {error_message}
-
-DÉTAILS
--------------------------------------------------------------------------------
-  • Environnement: {SELECTED_ENV}
-  • Serveur:       {SERVER_NAME}
-  • Base:          {DATABASE_NAME}
-
-===============================================================================
-                         ACTIONS SUGGÉRÉES
-===============================================================================
-
-1. Vérifier que SQL Server est démarré
-
-2. Vérifier les permissions sur la base
-
-3. Consulter les logs détaillés:
-   dotnet ef database update --verbose
-
-4. Contacter le support si le problème persiste:
-   support@atlshub.ch
-
-===============================================================================
+RESET - {DATABASE_NAME}
+├── Environnement: {SELECTED_ENV}
+├── Opérations: ✓ Drop, ✓ Create, ✓ {N} migrations
+├── Conformité: ✓ EF Core CLI uniquement
+└── Prochains: /efcore:db-status, /efcore:db-seed
 ```
 
 ---
@@ -459,23 +120,13 @@ DÉTAILS
 
 | Option | Description |
 |--------|-------------|
-| `--env {name}` | Utiliser appsettings.{name}.json (ex: --env Development) |
+| `--env {name}` | Utiliser appsettings.{name}.json |
 
-## Security
+## Protections
 
 | Protection | Description |
 |------------|-------------|
-| Env Display | Affiche la base de donnees AVANT confirmation |
-| Confirmation | Demande explicite avec le NOM de la base |
-| Production Block | Bloque si appsettings.Production.json detecte |
-| Migration Check | Displays migration state and asks before applying |
-| EF Core Only | No raw SQL commands - uses dotnet ef CLI |
-| Manual Backup | User directed to SSMS/Azure for backups |
-
----
-
-## Support
-
-> **Questions ou problèmes avec le reset EF Core?**
->
-> 📧 **support@atlshub.ch**
+| Env Display | Affiche base AVANT confirmation |
+| Confirmation | Demande explicite avec NOM |
+| Production Block | Bloque si Production détecté |
+| EF Core Only | Pas de SQL brut |