@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/fr/Symfony/commands/migration-plan.md

@@ -0,0 +1,347 @@
+---
+description: Planification Migration Base de Données
+argument-hint: [arguments]
+---
+
+# Planification Migration Base de Données
+
+Tu es un DBA et architecte Symfony senior. Tu dois planifier une migration de base de données complexe avec une stratégie zero-downtime, incluant le rollback et les tests.
+
+## Arguments
+$ARGUMENTS
+
+Arguments :
+- Description de la migration (ex: "Ajouter table audit_log", "Renommer colonne user.name vers full_name")
+
+Exemple : `/symfony:migration-plan "Ajouter système de versioning sur les documents"`
+
+## MISSION
+
+### Étape 1 : Analyser le Changement
+
+```
+══════════════════════════════════════════════════════════════
+📋 ANALYSE MIGRATION
+══════════════════════════════════════════════════════════════
+
+Description : {Description de la migration}
+Date prévue : {YYYY-MM-DD}
+Environnements : dev → staging → production
+
+──────────────────────────────────────────────────────────────
+🔍 ÉTAT ACTUEL
+──────────────────────────────────────────────────────────────
+
+Tables impactées :
+- table_1 (X lignes)
+- table_2 (Y lignes)
+
+Dépendances :
+- Entités : Entity1, Entity2
+- Services : Service1, Service2
+- Contrôleurs : Controller1
+
+──────────────────────────────────────────────────────────────
+⚠️ ÉVALUATION DES RISQUES
+──────────────────────────────────────────────────────────────
+
+| Risque | Probabilité | Impact | Mitigation |
+|--------|-------------|--------|------------|
+| Lock table long | Moyenne | Haute | Migration en étapes |
+| Perte de données | Faible | Critique | Backup + test restore |
+| Downtime | Moyenne | Haute | Blue/Green + feature flags |
+```
+
+### Étape 2 : Stratégie de Migration
+
+#### Pattern Expand/Contract (Zero-Downtime)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ PHASE 1: EXPAND (Ajout)                                     │
+│ - Ajouter nouvelle colonne/table                            │
+│ - Colonne nullable ou avec valeur par défaut                │
+│ - Pas de suppression                                        │
+│ - App continue de fonctionner                               │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│ PHASE 2: MIGRATE (Données)                                  │
+│ - Copier/transformer les données                            │
+│ - Batch processing pour gros volumes                        │
+│ - Validation des données migrées                            │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│ PHASE 3: UPDATE (Application)                               │
+│ - Déployer le code utilisant la nouvelle structure          │
+│ - Écriture dans ancien ET nouveau pendant la transition     │
+│ - Feature flag si nécessaire                                │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│ PHASE 4: CONTRACT (Nettoyage)                               │
+│ - Supprimer l'ancienne colonne/table                        │
+│ - Supprimer le code de compatibilité                        │
+│ - Peut être fait plus tard, en toute sécurité               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Étape 3 : Générer les Migrations
+
+#### Migration 1 : Expand (ajout structure)
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version{TIMESTAMP}_Expand extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Phase 1: Ajouter la nouvelle structure';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // Ajouter nouvelle colonne (nullable pour compatibilité)
+        $this->addSql('ALTER TABLE {table} ADD COLUMN {new_column} VARCHAR(255) DEFAULT NULL');
+
+        // Ajouter nouvelle table
+        $this->addSql('CREATE TABLE {new_table} (
+            id UUID PRIMARY KEY,
+            {table}_id UUID NOT NULL REFERENCES {table}(id),
+            version INT NOT NULL DEFAULT 1,
+            created_at TIMESTAMP NOT NULL DEFAULT NOW()
+        )');
+
+        // Ajouter index (CONCURRENTLY pour PostgreSQL)
+        $this->addSql('CREATE INDEX CONCURRENTLY idx_{table}_{column} ON {table}({column})');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP INDEX IF EXISTS idx_{table}_{column}');
+        $this->addSql('DROP TABLE IF EXISTS {new_table}');
+        $this->addSql('ALTER TABLE {table} DROP COLUMN IF EXISTS {new_column}');
+    }
+}
+```
+
+#### Migration 2 : Data Migration
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version{TIMESTAMP}_MigrateData extends AbstractMigration
+{
+    private const BATCH_SIZE = 1000;
+
+    public function getDescription(): string
+    {
+        return 'Phase 2: Migrer les données existantes';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // Migration par batch pour éviter les locks longs
+        $connection = $this->connection;
+
+        $totalRows = (int) $connection->fetchOne('SELECT COUNT(*) FROM {table} WHERE {new_column} IS NULL');
+        $processed = 0;
+
+        $this->write("Migrating $totalRows rows...");
+
+        while ($processed < $totalRows) {
+            $this->addSql("
+                UPDATE {table}
+                SET {new_column} = {transformation}
+                WHERE id IN (
+                    SELECT id FROM {table}
+                    WHERE {new_column} IS NULL
+                    LIMIT " . self::BATCH_SIZE . "
+                )
+            ");
+
+            $processed += self::BATCH_SIZE;
+            $this->write("Processed $processed / $totalRows");
+        }
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql("UPDATE {table} SET {new_column} = NULL");
+    }
+}
+```
+
+#### Migration 3 : Contract (nettoyage)
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version{TIMESTAMP}_Contract extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Phase 4: Supprimer l\'ancienne structure (À exécuter APRÈS validation complète)';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // Vérifier que toutes les données sont migrées
+        $count = $this->connection->fetchOne('SELECT COUNT(*) FROM {table} WHERE {new_column} IS NULL');
+        if ($count > 0) {
+            throw new \RuntimeException("Migration incomplète: $count lignes non migrées");
+        }
+
+        // Rendre la colonne NOT NULL
+        $this->addSql('ALTER TABLE {table} ALTER COLUMN {new_column} SET NOT NULL');
+
+        // Supprimer l'ancienne colonne
+        $this->addSql('ALTER TABLE {table} DROP COLUMN {old_column}');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE {table} ADD COLUMN {old_column} VARCHAR(255)');
+        $this->addSql('UPDATE {table} SET {old_column} = {reverse_transformation}');
+        $this->addSql('ALTER TABLE {table} ALTER COLUMN {new_column} DROP NOT NULL');
+    }
+}
+```
+
+### Étape 4 : Plan de Déploiement
+
+```
+══════════════════════════════════════════════════════════════
+📅 PLAN DE DÉPLOIEMENT
+══════════════════════════════════════════════════════════════
+
+## Pré-requis
+
+- [ ] Backup base de données
+- [ ] Test de restauration backup
+- [ ] Fenêtre de maintenance communiquée
+- [ ] Équipe disponible
+
+## J-1 : Préparation
+
+- [ ] Merger les migrations dans main
+- [ ] Déployer en staging
+- [ ] Exécuter les migrations staging
+- [ ] Tests E2E complets
+
+## Jour J : Production
+
+### 09:00 - Phase 1 : Expand
+```bash
+# Backup
+docker compose exec db pg_dump -U user db > backup_$(date +%Y%m%d_%H%M%S).sql
+
+# Migration expand
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\Version{TIMESTAMP}_Expand' --up
+```
+
+### 09:15 - Phase 2 : Data Migration
+```bash
+# Exécuter en monitoring
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\Version{TIMESTAMP}_MigrateData' --up
+```
+
+### 09:30 - Phase 3 : Deploy New Code
+```bash
+# Déployer l'application avec le nouveau code
+./deploy.sh production
+```
+
+### 10:00 - Validation
+- [ ] Smoke tests
+- [ ] Vérifier les logs (pas d'erreurs)
+- [ ] Vérifier les métriques
+- [ ] Tester les fonctionnalités impactées
+
+### J+7 - Phase 4 : Contract (optionnel)
+```bash
+# Après validation complète
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\Version{TIMESTAMP}_Contract' --up
+```
+
+══════════════════════════════════════════════════════════════
+🔙 PLAN DE ROLLBACK
+══════════════════════════════════════════════════════════════
+
+### Rollback Phase 1 (Expand)
+```bash
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\Version{TIMESTAMP}_Expand' --down
+```
+
+### Rollback Phase 2 (Data)
+```bash
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\Version{TIMESTAMP}_MigrateData' --down
+```
+
+### Rollback Complet (si critique)
+```bash
+# Restaurer le backup
+docker compose exec db psql -U user db < backup_YYYYMMDD_HHMMSS.sql
+
+# Redéployer l'ancienne version
+git checkout {previous_tag}
+./deploy.sh production
+```
+
+══════════════════════════════════════════════════════════════
+✅ CHECKLIST POST-MIGRATION
+══════════════════════════════════════════════════════════════
+
+- [ ] Toutes les migrations exécutées avec succès
+- [ ] Pas d'erreurs dans les logs
+- [ ] Métriques de performance nominales
+- [ ] Tests fonctionnels OK
+- [ ] Utilisateurs informés (si impact visible)
+- [ ] Documentation mise à jour
+- [ ] Backup supprimé après validation (J+30)
+```
+
+### Commandes Utiles
+
+```bash
+# Statut des migrations
+docker compose exec php php bin/console doctrine:migrations:status
+
+# Voir les migrations en attente
+docker compose exec php php bin/console doctrine:migrations:list
+
+# Exécuter une migration spécifique
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\VersionXXX' --up
+
+# Rollback d'une migration
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\VersionXXX' --down
+
+# Valider le schéma
+docker compose exec php php bin/console doctrine:schema:validate
+```

package/Dev/i18n/fr/Symfony/commands/optimize-doctrine.md

@@ -0,0 +1,327 @@
+---
+description: Optimisation Requêtes Doctrine
+argument-hint: [arguments]
+---
+
+# Optimisation Requêtes Doctrine
+
+Tu es un expert Doctrine et DBA. Tu dois analyser les requêtes Doctrine du projet, identifier les problèmes de performance (N+1, index manquants, requêtes lentes) et proposer des optimisations.
+
+## Arguments
+$ARGUMENTS
+
+Arguments :
+- (Optionnel) Chemin vers une entité ou repository spécifique
+
+Exemple : `/symfony:optimize-doctrine` ou `/symfony:optimize-doctrine src/Entity/Order.php`
+
+## MISSION
+
+### Étape 1 : Activer le Profiling
+
+```yaml
+# config/packages/dev/doctrine.yaml
+doctrine:
+    dbal:
+        profiling_collect_backtrace: true
+
+when@dev:
+    doctrine:
+        dbal:
+            logging: true
+```
+
+### Étape 2 : Identifier les Problèmes
+
+#### Détecter les N+1 Queries
+
+```php
+// PROBLÈME: N+1
+$orders = $orderRepository->findAll();
+foreach ($orders as $order) {
+    echo $order->getCustomer()->getName(); // 1 requête par order!
+}
+
+// SOLUTION: Eager Loading
+$orders = $orderRepository->createQueryBuilder('o')
+    ->leftJoin('o.customer', 'c')
+    ->addSelect('c')
+    ->getQuery()
+    ->getResult();
+```
+
+#### Analyser avec le Debug Toolbar
+
+```bash
+# Vérifier le nombre de requêtes
+docker compose exec php php bin/console doctrine:query:sql "SELECT 1"
+
+# Profiler
+docker compose exec php php bin/console debug:container doctrine.dbal.default_connection
+```
+
+### Étape 3 : Optimisations Courantes
+
+#### 3.1 Lazy Loading → Eager Loading
+
+```php
+// Repository
+class OrderRepository extends ServiceEntityRepository
+{
+    public function findWithRelations(): array
+    {
+        return $this->createQueryBuilder('o')
+            ->leftJoin('o.customer', 'c')->addSelect('c')
+            ->leftJoin('o.items', 'i')->addSelect('i')
+            ->leftJoin('i.product', 'p')->addSelect('p')
+            ->orderBy('o.createdAt', 'DESC')
+            ->getQuery()
+            ->getResult();
+    }
+}
+```
+
+#### 3.2 Partial Selects (réduire les données)
+
+```php
+// Ne récupérer que les champs nécessaires
+$results = $this->createQueryBuilder('u')
+    ->select('partial u.{id, email, name}')
+    ->getQuery()
+    ->getResult();
+
+// Ou utiliser un DTO
+$results = $this->createQueryBuilder('u')
+    ->select('NEW App\DTO\UserListDTO(u.id, u.email, u.name)')
+    ->getQuery()
+    ->getResult();
+```
+
+#### 3.3 Pagination Efficace
+
+```php
+use Doctrine\ORM\Tools\Pagination\Paginator;
+
+public function findPaginated(int $page, int $limit = 20): Paginator
+{
+    $query = $this->createQueryBuilder('o')
+        ->leftJoin('o.customer', 'c')->addSelect('c')
+        ->orderBy('o.createdAt', 'DESC')
+        ->setFirstResult(($page - 1) * $limit)
+        ->setMaxResults($limit)
+        ->getQuery();
+
+    return new Paginator($query, fetchJoinCollection: true);
+}
+```
+
+#### 3.4 Cursor Pagination (meilleure performance)
+
+```php
+public function findAfterCursor(?string $cursor, int $limit = 20): array
+{
+    $qb = $this->createQueryBuilder('o')
+        ->orderBy('o.id', 'ASC')
+        ->setMaxResults($limit + 1);
+
+    if ($cursor) {
+        $qb->where('o.id > :cursor')
+           ->setParameter('cursor', $cursor);
+    }
+
+    $results = $qb->getQuery()->getResult();
+
+    $hasMore = count($results) > $limit;
+    if ($hasMore) {
+        array_pop($results);
+    }
+
+    return [
+        'items' => $results,
+        'nextCursor' => $hasMore ? end($results)->getId() : null,
+    ];
+}
+```
+
+#### 3.5 Batch Processing
+
+```php
+public function processLargeDataset(): void
+{
+    $batchSize = 100;
+    $i = 0;
+
+    $query = $this->createQueryBuilder('o')
+        ->getQuery()
+        ->iterate(); // Utilise un cursor
+
+    foreach ($query as $row) {
+        $order = $row[0];
+        $this->process($order);
+
+        if (++$i % $batchSize === 0) {
+            $this->getEntityManager()->flush();
+            $this->getEntityManager()->clear(); // Libère la mémoire
+        }
+    }
+
+    $this->getEntityManager()->flush();
+}
+```
+
+#### 3.6 Index Stratégiques
+
+```php
+#[ORM\Entity]
+#[ORM\Table(name: 'orders')]
+#[ORM\Index(columns: ['status'], name: 'idx_order_status')]
+#[ORM\Index(columns: ['customer_id', 'created_at'], name: 'idx_order_customer_date')]
+#[ORM\Index(columns: ['created_at'], name: 'idx_order_created')]
+class Order
+{
+    // ...
+}
+```
+
+#### 3.7 Cache des Résultats
+
+```php
+// Second Level Cache (config)
+doctrine:
+    orm:
+        second_level_cache:
+            enabled: true
+            region_cache_driver:
+                type: pool
+                pool: cache.doctrine.orm.second_level
+
+// Entity avec cache
+#[ORM\Cache(usage: 'READ_ONLY')]
+class Country
+{
+    // Données rarement modifiées
+}
+
+// Query cache
+$results = $this->createQueryBuilder('c')
+    ->getQuery()
+    ->enableResultCache(3600, 'countries_list')
+    ->getResult();
+```
+
+### Étape 4 : Analyse des Index
+
+```sql
+-- PostgreSQL: Index non utilisés
+SELECT schemaname, tablename, indexrelname, idx_scan, idx_tup_read
+FROM pg_stat_user_indexes
+WHERE idx_scan = 0
+ORDER BY pg_relation_size(indexrelid) DESC;
+
+-- PostgreSQL: Tables sans index (hors PK)
+SELECT tablename
+FROM pg_tables
+WHERE schemaname = 'public'
+AND tablename NOT IN (
+    SELECT DISTINCT tablename
+    FROM pg_indexes
+    WHERE schemaname = 'public'
+);
+
+-- MySQL: Requêtes lentes
+SELECT * FROM mysql.slow_log ORDER BY start_time DESC LIMIT 10;
+```
+
+### Étape 5 : Générer le Rapport
+
+```
+══════════════════════════════════════════════════════════════
+📊 RAPPORT OPTIMISATION DOCTRINE
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+🔍 PROBLÈMES DÉTECTÉS
+──────────────────────────────────────────────────────────────
+
+### N+1 Queries (Critique)
+
+| Fichier | Ligne | Relation | Impact |
+|---------|-------|----------|--------|
+| OrderController.php | 45 | order→customer | 100+ req/page |
+| ProductService.php | 78 | product→category | 50+ req/page |
+
+### Index Manquants (Important)
+
+| Table | Colonnes | Requêtes affectées |
+|-------|----------|-------------------|
+| orders | status | findByStatus() |
+| products | category_id, active | findActiveByCategory() |
+
+### Requêtes Lentes (> 100ms)
+
+| Requête | Temps moyen | Appels/jour |
+|---------|-------------|-------------|
+| SELECT * FROM orders... | 250ms | 1500 |
+| SELECT * FROM products... | 180ms | 3000 |
+
+──────────────────────────────────────────────────────────────
+🔧 SOLUTIONS PROPOSÉES
+──────────────────────────────────────────────────────────────
+
+### 1. Corriger N+1 - OrderController.php
+
+```php
+// AVANT
+$orders = $this->orderRepository->findAll();
+
+// APRÈS
+$orders = $this->orderRepository->findWithCustomer();
+```
+
+### 2. Ajouter Index
+
+```php
+#[ORM\Index(columns: ['status'], name: 'idx_order_status')]
+```
+
+### 3. Activer le Query Cache
+
+```php
+->enableResultCache(3600, 'orders_list')
+```
+
+──────────────────────────────────────────────────────────────
+📈 IMPACT ESTIMÉ
+──────────────────────────────────────────────────────────────
+
+| Optimisation | Avant | Après | Gain |
+|--------------|-------|-------|------|
+| Page Orders | 102 req | 3 req | -97% |
+| Temps moyen | 450ms | 80ms | -82% |
+| Charge DB | 100% | 30% | -70% |
+
+──────────────────────────────────────────────────────────────
+🎯 PROCHAINES ÉTAPES
+──────────────────────────────────────────────────────────────
+
+1. [ ] Appliquer les eager loadings
+2. [ ] Créer les migrations pour les index
+3. [ ] Configurer le Second Level Cache
+4. [ ] Monitorer avec Blackfire/Profiler
+```
+
+## Commandes Utiles
+
+```bash
+# Valider le schéma
+docker compose exec php php bin/console doctrine:schema:validate
+
+# Voir les requêtes générées
+docker compose exec php php bin/console doctrine:query:dql "SELECT o FROM App\Entity\Order o" --dump-sql
+
+# Créer migration pour index
+docker compose exec php php bin/console make:migration
+
+# Stats des entités
+docker compose exec php php bin/console doctrine:mapping:info
+```