@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/Symfony/commands/generate-crud.md

@@ -0,0 +1,127 @@
+---
+description: Generación CRUD Completo
+argument-hint: [arguments]
+---
+
+# Generación CRUD Completo
+
+Eres un desarrollador senior de Symfony. Debes generar un CRUD completo respetando Clean Architecture, incluyendo Entity, Repository, Controller, Templates, Form y Tests.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Nombre de la entidad (ej: `Product`, `BlogPost`)
+- (Opcional) Campos en formato `nombre:tipo` separados por comas
+
+Ejemplo: `/symfony:generate-crud Product name:string,price:decimal,description:text`
+
+## MISIÓN
+
+### Paso 1: Análisis de Necesidades
+
+Verificar:
+- La entidad no existe ya
+- Las convenciones de nomenclatura Symfony
+- La estructura del proyecto (DDD o estándar)
+
+### Paso 2: Generación de Archivos
+
+#### Estructura a crear (Clean Architecture)
+
+```
+src/
+├── Domain/
+│   └── {Entity}/
+│       ├── Entity/
+│       │   └── {Entity}.php
+│       ├── Repository/
+│       │   └── {Entity}RepositoryInterface.php
+│       └── ValueObject/
+│           └── {Entity}Id.php
+├── Application/
+│   └── {Entity}/
+│       ├── Command/
+│       │   ├── Create{Entity}Command.php
+│       │   ├── Update{Entity}Command.php
+│       │   └── Delete{Entity}Command.php
+│       ├── Handler/
+│       │   ├── Create{Entity}Handler.php
+│       │   ├── Update{Entity}Handler.php
+│       │   └── Delete{Entity}Handler.php
+│       ├── Query/
+│       │   ├── Get{Entity}Query.php
+│       │   └── List{Entities}Query.php
+│       └── DTO/
+│           └── {Entity}DTO.php
+├── Infrastructure/
+│   └── Persistence/
+│       └── Doctrine/
+│           └── {Entity}Repository.php
+└── Presentation/
+    └── Controller/
+        └── {Entity}Controller.php
+
+templates/
+└── {entity}/
+    ├── index.html.twig
+    ├── show.html.twig
+    ├── new.html.twig
+    ├── edit.html.twig
+    └── _form.html.twig
+
+tests/
+├── Unit/
+│   └── Domain/
+│       └── {Entity}/
+│           └── {Entity}Test.php
+└── Functional/
+    └── Controller/
+        └── {Entity}ControllerTest.php
+```
+
+### Paso 3: Templates de Código
+
+[El contenido continúa con los mismos templates del archivo inglés, traduciendo solo los comentarios y mensajes]
+
+### Paso 4: Migración Doctrine
+
+```bash
+docker compose exec php php bin/console make:migration
+docker compose exec php php bin/console doctrine:migrations:migrate
+```
+
+### Paso 5: Resumen
+
+```
+══════════════════════════════════════════════════════════════
+✅ CRUD GENERADO - {Entity}
+══════════════════════════════════════════════════════════════
+
+📁 Archivos creados:
+- src/Domain/{Entity}/Entity/{Entity}.php
+- src/Domain/{Entity}/Repository/{Entity}RepositoryInterface.php
+- src/Domain/{Entity}/ValueObject/{Entity}Id.php
+- src/Infrastructure/Persistence/Doctrine/{Entity}Repository.php
+- src/Presentation/Controller/{Entity}Controller.php
+- templates/{entity}/index.html.twig
+- templates/{entity}/show.html.twig
+- templates/{entity}/new.html.twig
+- templates/{entity}/edit.html.twig
+- tests/Unit/Domain/{Entity}/{Entity}Test.php
+- tests/Functional/Controller/{Entity}ControllerTest.php
+
+🔧 Comandos a ejecutar:
+docker compose exec php php bin/console make:migration
+docker compose exec php php bin/console doctrine:migrations:migrate
+docker compose exec php vendor/bin/phpunit tests/Unit/Domain/{Entity}/
+
+📌 Rutas creadas:
+- GET    /{entities}              {entity}_index
+- GET    /{entities}/new          {entity}_new
+- POST   /{entities}              {entity}_new
+- GET    /{entities}/{id}         {entity}_show
+- GET    /{entities}/{id}/edit    {entity}_edit
+- POST   /{entities}/{id}/edit    {entity}_edit
+- POST   /{entities}/{id}         {entity}_delete
+```

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

@@ -0,0 +1,114 @@
+---
+description: Planificación de Migración de Base de Datos
+argument-hint: [arguments]
+---
+
+# Planificación de Migración de Base de Datos
+
+Eres un DBA y arquitecto senior de Symfony. Debes planificar una migración de base de datos compleja con una estrategia zero-downtime, incluyendo el rollback y los tests.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Descripción de la migración (ej: "Añadir tabla audit_log", "Renombrar columna user.name a full_name")
+
+Ejemplo: `/symfony:migration-plan "Añadir sistema de versionado en los documentos"`
+
+## MISIÓN
+
+### Paso 1: Analizar el Cambio
+
+```
+══════════════════════════════════════════════════════════════
+📋 ANÁLISIS DE MIGRACIÓN
+══════════════════════════════════════════════════════════════
+
+Descripción: {Descripción de la migración}
+Fecha prevista: {YYYY-MM-DD}
+Entornos: dev → staging → producción
+
+──────────────────────────────────────────────────────────────
+🔍 ESTADO ACTUAL
+──────────────────────────────────────────────────────────────
+
+Tablas impactadas:
+- table_1 (X filas)
+- table_2 (Y filas)
+
+Dependencias:
+- Entidades: Entity1, Entity2
+- Services: Service1, Service2
+- Controladores: Controller1
+
+──────────────────────────────────────────────────────────────
+⚠️ EVALUACIÓN DE RIESGOS
+──────────────────────────────────────────────────────────────
+
+| Riesgo | Probabilidad | Impacto | Mitigación |
+|--------|-------------|---------|------------|
+| Lock table largo | Media | Alta | Migración en etapas |
+| Pérdida de datos | Baja | Crítica | Backup + test restore |
+| Downtime | Media | Alta | Blue/Green + feature flags |
+```
+
+### Paso 2: Estrategia de Migración
+
+#### Pattern Expand/Contract (Zero-Downtime)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ FASE 1: EXPAND (Adición)                                    │
+│ - Añadir nueva columna/tabla                                │
+│ - Columna nullable o con valor por defecto                  │
+│ - Sin eliminación                                           │
+│ - App continúa funcionando                                  │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│ FASE 2: MIGRATE (Datos)                                     │
+│ - Copiar/transformar los datos                              │
+│ - Batch processing para grandes volúmenes                   │
+│ - Validación de datos migrados                              │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│ FASE 3: UPDATE (Aplicación)                                 │
+│ - Desplegar código usando la nueva estructura               │
+│ - Escritura en antiguo Y nuevo durante la transición        │
+│ - Feature flag si necesario                                 │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│ FASE 4: CONTRACT (Limpieza)                                 │
+│ - Eliminar antigua columna/tabla                            │
+│ - Eliminar código de compatibilidad                         │
+│ - Puede hacerse más tarde, con seguridad                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Paso 3: Generar las Migraciones
+
+[El contenido continúa con las migraciones en español...]
+
+### Comandos Útiles
+
+```bash
+# Estado de migraciones
+docker compose exec php php bin/console doctrine:migrations:status
+
+# Ver migraciones pendientes
+docker compose exec php php bin/console doctrine:migrations:list
+
+# Ejecutar una migración específica
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\VersionXXX' --up
+
+# Rollback de una migración
+docker compose exec php php bin/console doctrine:migrations:execute 'DoctrineMigrations\VersionXXX' --down
+
+# Validar el esquema
+docker compose exec php php bin/console doctrine:schema:validate
+```

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

@@ -0,0 +1,100 @@
+---
+description: Optimización de Consultas Doctrine
+argument-hint: [arguments]
+---
+
+# Optimización de Consultas Doctrine
+
+Eres un experto en Doctrine y DBA. Debes analizar las consultas Doctrine del proyecto, identificar problemas de rendimiento (N+1, índices faltantes, consultas lentas) y proponer optimizaciones.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- (Opcional) Ruta hacia una entidad o repository específico
+
+Ejemplo: `/symfony:optimize-doctrine` o `/symfony:optimize-doctrine src/Entity/Order.php`
+
+## MISIÓN
+
+### Paso 1: Activar el Profiling
+
+```yaml
+# config/packages/dev/doctrine.yaml
+doctrine:
+    dbal:
+        profiling_collect_backtrace: true
+
+when@dev:
+    doctrine:
+        dbal:
+            logging: true
+```
+
+### Paso 2: Identificar los Problemas
+
+#### Detectar N+1 Queries
+
+```php
+// PROBLEMA: N+1
+$orders = $orderRepository->findAll();
+foreach ($orders as $order) {
+    echo $order->getCustomer()->getName(); // ¡1 consulta por order!
+}
+
+// SOLUCIÓN: Eager Loading
+$orders = $orderRepository->createQueryBuilder('o')
+    ->leftJoin('o.customer', 'c')
+    ->addSelect('c')
+    ->getQuery()
+    ->getResult();
+```
+
+#### Analizar con el Debug Toolbar
+
+```bash
+# Verificar número de consultas
+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
+```
+
+### Paso 3: Optimizaciones Comunes
+
+#### 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();
+    }
+}
+```
+
+[El contenido continúa con optimizaciones...]
+
+## Comandos Útiles
+
+```bash
+# Validar el esquema
+docker compose exec php php bin/console doctrine:schema:validate
+
+# Ver consultas generadas
+docker compose exec php php bin/console doctrine:query:dql "SELECT o FROM App\Entity\Order o" --dump-sql
+
+# Crear migración para índices
+docker compose exec php php bin/console make:migration
+
+# Stats de entidades
+docker compose exec php php bin/console doctrine:mapping:info
+```