@the-bearded-bear/claude-craft 8.8.1 → 8.8.2

package/Dev/i18n/es/Symfony/commands/check-testing.md

@@ -15,183 +15,201 @@ $ARGUMENTS : Ruta del proyecto Symfony a auditar (opcional, por defecto: directo
 
 ## MISIÓN
 
-Eres un experto en tests de software encargado de auditar la estrategia de testing de un proyecto Symfony: tests unitarios, de integración, funcionales, cobertura de código y tests de mutación.
+Eres un experto en pruebas de software encargado de auditar la estrategia de testing de un proyecto Symfony: pruebas unitarias, de integración, funcionales, cobertura de código y pruebas de mutación.
 
-### Paso 1: Verificación del Entorno de Test
+### Paso 1: Verificación del Entorno de Pruebas
 
-1. Identifica el directorio del proyecto
-2. Verifica la presencia de PHPUnit en composer.json
-3. Verifica la configuración de PHPUnit (phpunit.xml.dist)
-4. Verifica la presencia de la carpeta tests/
+1. Identificar el directorio del proyecto
+2. Verificar la presencia de PHPUnit en composer.json
+3. Verificar la configuración de PHPUnit (phpunit.xml.dist)
+4. Verificar la presencia del directorio tests/
 
 **Referencia a las reglas**: `.claude/rules/symfony-testing.md`
 
-### Paso 2: Estructura de Tests
+### Paso 2: Estructura de las Pruebas
 
-Analiza la estructura de la carpeta tests/:
+Analizar la estructura del directorio tests/:
 
 ```bash
-# Listar la estructura de tests
+# Listar la estructura de las pruebas
 docker run --rm -v $(pwd):/app php:8.2-cli find /app/tests -type d
 ```
 
-#### Organización de Tests (3 puntos)
+#### Organización de las Pruebas (3 puntos)
 
-- [ ] Carpeta `tests/Unit/` para tests unitarios
-- [ ] Carpeta `tests/Integration/` para tests de integración
-- [ ] Carpeta `tests/Functional/` para tests funcionales
+- [ ] Directorio `tests/Unit/` para pruebas unitarias
+- [ ] Directorio `tests/Integration/` para pruebas de integración
+- [ ] Directorio `tests/Functional/` para pruebas funcionales
 - [ ] Estructura espejo de src/ en tests/
 - [ ] Namespace correctamente configurado
 - [ ] Fixtures en tests/Fixtures/
-- [ ] Mocks en tests/Mock/ o inline
-- [ ] Configuración de test separada (config/packages/test/)
-- [ ] Base de datos de test separada
-- [ ] Tests aislados e independientes
+- [ ] Mocks en tests/Mock/ o en línea
+- [ ] Configuración de prueba separada (config/packages/test/)
+- [ ] Base de datos de prueba separada
+- [ ] Pruebas aisladas e independientes
 
 **Puntos obtenidos**: ___/3
 
-### Paso 3: Tests Unitarios
+### Paso 3: Pruebas Unitarias
 
-Ejecuta los tests unitarios:
+Ejecutar las pruebas unitarias:
 
 ```bash
-# Ejecutar tests unitarios únicamente
+# Ejecutar solo las pruebas unitarias
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit tests/Unit --testdox
 
-# Contar tests unitarios
+# Contar las pruebas unitarias
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit tests/Unit --list-tests | wc -l
 ```
 
-#### Tests Unitarios Domain (7 puntos)
+#### Pruebas Unitarias del Dominio (7 puntos)
 
-- [ ] Tests para todas las Entities del Domain
-- [ ] Tests para todos los Value Objects
-- [ ] Tests para todos los Domain Services
-- [ ] Tests para los Use Cases / Application Services
+- [ ] Pruebas para todas las Entidades del Dominio
+- [ ] Pruebas para todos los Value Objects
+- [ ] Pruebas para todos los Servicios de Dominio
+- [ ] Pruebas para los Use Cases / Application Services
 - [ ] Sin dependencias externas (BD, API, filesystem)
 - [ ] Uso de mocks para las dependencias
-- [ ] Tests de casos límite y errores
-- [ ] Tests de validaciones de negocio
-- [ ] Fast feedback (< 1 segundo para todos los tests unitarios)
-- [ ] Cobertura de tests unitarios > 90%
+- [ ] Pruebas de casos límite y errores
+- [ ] Pruebas de las validaciones de negocio
+- [ ] Retroalimentación rápida (< 1 segundo para todas las pruebas unitarias)
+- [ ] Cobertura de las pruebas unitarias > 90%
 
-Número de tests unitarios: ___
+Número de pruebas unitarias: ___
 Tiempo de ejecución: ___ segundos
 
 **Puntos obtenidos**: ___/7
 
-### Paso 4: Tests de Integración
+### Paso 4: Pruebas de Integración
 
-Ejecuta los tests de integración:
+Ejecutar las pruebas de integración:
 
 ```bash
-# Ejecutar tests de integración
+# Ejecutar las pruebas de integración
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit tests/Integration --testdox
 ```
 
-#### Tests de Integración Infrastructure (5 puntos)
+#### Pruebas de Integración de Infraestructura (5 puntos)
 
-- [ ] Tests para todos los Repositories (con base de datos)
-- [ ] Tests para los Adapters externos (Email, API, etc.)
-- [ ] Tests para los Event Listeners / Subscribers
-- [ ] Tests para los Services con dependencias Symfony
-- [ ] Uso de base de datos de test
-- [ ] Rollback o reset después de cada test
-- [ ] Fixtures para datos de test
-- [ ] Tests de transacciones y restricciones BD
-- [ ] Aislamiento de tests (sin orden requerido)
-- [ ] Tests de casos de error (conexión fallida, etc.)
+- [ ] Pruebas para todos los Repositorios (con base de datos)
+- [ ] Pruebas para los Adaptadores externos (Email, API, etc.)
+- [ ] Pruebas para los Event Listeners / Subscribers
+- [ ] Pruebas para los Servicios con dependencias de Symfony
+- [ ] Uso de base de datos de prueba
+- [ ] Rollback o reset después de cada prueba
+- [ ] Fixtures para datos de prueba
+- [ ] Pruebas de transacciones y restricciones de BD
+- [ ] Aislamiento de pruebas (sin orden requerido)
+- [ ] Pruebas de casos de error (conexión fallida, etc.)
 
-Número de tests de integración: ___
+Número de pruebas de integración: ___
 Tiempo de ejecución: ___ segundos
 
 **Puntos obtenidos**: ___/5
 
-### Paso 5: Tests Funcionales
+### Paso 5: Pruebas Funcionales
 
-Ejecuta los tests funcionales:
+Ejecutar las pruebas funcionales:
 
 ```bash
-# Ejecutar tests funcionales
+# Ejecutar las pruebas funcionales
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit tests/Functional --testdox
 
 # Verificar si Behat está instalado
-docker run --rm -v $(pwd):/app php:8.2-cli test -f /app/vendor/bin/behat && echo "✅ Behat encontrado" || echo "⚠️ Behat faltante"
+docker run --rm -v $(pwd):/app php:8.2-cli test -f /app/vendor/bin/behat && echo "✅ Behat encontrado" || echo "⚠️ Behat ausente"
 ```
 
-#### Tests Funcionales (5 puntos)
+#### Pruebas Funcionales (5 puntos)
 
-- [ ] Tests para todas las rutas API/Web importantes
-- [ ] Tests de controllers con WebTestCase
-- [ ] Tests de formularios
-- [ ] Tests de autenticaciones y autorizaciones
-- [ ] Tests de workflows completos (recorrido de usuario)
-- [ ] Tests con Behat para escenarios de negocio (opcional)
-- [ ] Tests de respuestas HTTP (códigos, headers, body)
-- [ ] Tests de validaciones del lado API
-- [ ] Tests de casos de error (404, 403, 500)
-- [ ] Tests de redirecciones
+- [ ] Pruebas para todas las rutas API/Web importantes
+- [ ] Pruebas de los controladores con WebTestCase
+- [ ] Pruebas de los formularios
+- [ ] Pruebas de autenticaciones y autorizaciones
+- [ ] Pruebas de flujos completos (recorridos de usuario)
+- [ ] Pruebas con Behat para escenarios de negocio (opcional)
+- [ ] Pruebas de respuestas HTTP (códigos, cabeceras, cuerpo)
+- [ ] Pruebas de validaciones del lado de la API
+- [ ] Pruebas de casos de error (404, 403, 500)
+- [ ] Pruebas de redirecciones
 
-Número de tests funcionales: ___
-Tests Behat presentes: [SÍ|NO]
+Número de pruebas funcionales: ___
+Pruebas Behat presentes: [SÍ|NO]
 
 **Puntos obtenidos**: ___/5
 
 ### Paso 6: Cobertura de Código
 
-Genera el informe de cobertura:
+Generar el informe de cobertura:
 
 ```bash
-# Generar cobertura de código (requiere xdebug o pcov)
+# Generar la cobertura de código (requiere xdebug o pcov)
 docker run --rm -v $(pwd):/app php:8.2-cli php -d memory_limit=-1 /app/vendor/bin/phpunit --coverage-text --coverage-html=/app/var/coverage
 
-# Mostrar resumen de cobertura
+# Mostrar el resumen de cobertura
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit --coverage-text | grep "Lines:"
 ```
 
 #### Cobertura de Código (5 puntos)
 
 - [ ] Cobertura global ≥ 80%
-- [ ] Cobertura Domain ≥ 90%
-- [ ] Cobertura Application ≥ 85%
-- [ ] Cobertura Infrastructure ≥ 70%
-- [ ] Cobertura de branches (condicionales) ≥ 75%
+- [ ] Cobertura del Dominio ≥ 90%
+- [ ] Cobertura de la Aplicación ≥ 85%
+- [ ] Cobertura de la Infraestructura ≥ 70%
+- [ ] Cobertura de ramas (condicionales) ≥ 75%
 - [ ] Informe de cobertura generado (HTML)
-- [ ] Exclusión explícita del código no testeable
-- [ ] Sin código crítico no cubierto
-- [ ] Tests de excepciones y casos de error
+- [ ] Exclusión explícita del código no testable
+- [ ] Sin código crítico sin cobertura
+- [ ] Pruebas de excepciones y casos de error
 - [ ] Configuración de cobertura en phpunit.xml
 
 Cobertura global: ___%
-Cobertura Domain: ___%
-Cobertura Application: ___%
-Cobertura Infrastructure: ___%
+Cobertura del Dominio: ___%
+Cobertura de la Aplicación: ___%
+Cobertura de la Infraestructura: ___%
 
 **Puntos obtenidos**: ___/5
 
-### Paso 7: Tests de Mutación con Infection
+Configuración PHPUnit esperada:
+
+```xml
+<coverage processUncoveredFiles="true">
+    <include>
+        <directory suffix=".php">src</directory>
+    </include>
+    <exclude>
+        <directory>src/Kernel.php</directory>
+        <directory>src/DataFixtures</directory>
+    </exclude>
+    <report>
+        <html outputDirectory="var/coverage"/>
+        <text outputFile="php://stdout" showUncoveredFiles="false"/>
+    </report>
+</coverage>
+```
+
+### Paso 7: Pruebas de Mutación con Infection
 
-Ejecuta los tests de mutación:
+Ejecutar las pruebas de mutación:
 
 ```bash
 # Verificar si Infection está instalado
-docker run --rm -v $(pwd):/app php:8.2-cli test -f /app/vendor/bin/infection && echo "✅ Infection encontrado" || echo "❌ Infection faltante"
+docker run --rm -v $(pwd):/app php:8.2-cli test -f /app/vendor/bin/infection && echo "✅ Infection encontrado" || echo "❌ Infection ausente"
 
 # Ejecutar Infection
 docker run --rm -v $(pwd):/app infection/infection --min-msi=70 --min-covered-msi=80 --threads=4
 ```
 
-#### Tests de Mutación (5 puntos)
+#### Pruebas de Mutación (5 puntos)
 
 - [ ] Infection instalado y configurado
 - [ ] MSI (Mutation Score Indicator) ≥ 70%
 - [ ] Covered MSI ≥ 80%
-- [ ] Tests detectan mutaciones en Domain
-- [ ] Tests detectan mutaciones en Application
+- [ ] Las pruebas detectan mutaciones en el Dominio
+- [ ] Las pruebas detectan mutaciones en la Aplicación
 - [ ] Sin mutantes escapados en el código crítico
-- [ ] Configuración infection.json presente
+- [ ] Archivo infection.json presente con configuración
 - [ ] Timeout configurado correctamente
-- [ ] Exclusiones justificadas en config
+- [ ] Exclusiones justificadas en la configuración
 - [ ] Informe de mutación generado
 
 MSI: ___%
@@ -201,50 +219,231 @@ Mutantes escapados: ___
 
 **Puntos obtenidos**: ___/5
 
-### Paso 8: Cálculo de la Puntuación Testing
+Configuración esperada de Infection (infection.json):
+
+```json
+{
+    "source": {
+        "directories": ["src"]
+    },
+    "logs": {
+        "text": "var/infection.log",
+        "html": "var/infection-report.html"
+    },
+    "mutators": {
+        "@default": true
+    },
+    "minMsi": 70,
+    "minCoveredMsi": 80
+}
+```
+
+### Paso 8: Cálculo de la Puntuación de Testing
 
 **PUNTUACIÓN TESTING**: ___/25 puntos
 
 Detalles:
-- Organización de Tests: ___/3
-- Tests Unitarios Domain: ___/7
-- Tests de Integración Infrastructure: ___/5
-- Tests Funcionales: ___/5
+- Organización de las Pruebas: ___/3
+- Pruebas Unitarias del Dominio: ___/7
+- Pruebas de Integración de Infraestructura: ___/5
+- Pruebas Funcionales: ___/5
 - Cobertura de Código: ___/5
-- Tests de Mutación: ___/5
+- Pruebas de Mutación: ___/5
+
+### Paso 9: Informe Detallado
+
+```
+=================================================
+   AUDITORÍA DE TESTING SYMFONY
+=================================================
+
+📊 PUNTUACIÓN: ___/25
+
+📁 Organización de las Pruebas              : ___/3 [✅|⚠️|❌]
+🎯 Pruebas Unitarias del Dominio            : ___/7 [✅|⚠️|❌]
+🔌 Pruebas de Integración de Infraestructura: ___/5 [✅|⚠️|❌]
+🌐 Pruebas Funcionales                      : ___/5 [✅|⚠️|❌]
+📊 Cobertura de Código                      : ___/5 [✅|⚠️|❌]
+🦠 Pruebas de Mutación                      : ___/5 [✅|⚠️|❌]
+
+=================================================
+   ESTADÍSTICAS GLOBALES
+=================================================
+
+Número total de pruebas       : ___
+Pruebas unitarias             : ___
+Pruebas de integración        : ___
+Pruebas funcionales           : ___
+Pruebas Behat                 : ___
+
+Tiempo total de ejecución     : ___ segundos
+Cobertura global              : ___%
+MSI (Mutation Score)          : ___%
+
+=================================================
+   COBERTURA POR CAPA
+=================================================
+
+Dominio         : ___% [✅|⚠️|❌] (objetivo: 90%)
+Aplicación      : ___% [✅|⚠️|❌] (objetivo: 85%)
+Infraestructura : ___% [✅|⚠️|❌] (objetivo: 70%)
+Presentación    : ___% [✅|⚠️|❌] (objetivo: 70%)
+
+Archivos sin cobertura : ___
+Métodos sin cobertura  : ___
+Líneas sin cobertura   : ___
+
+=================================================
+   PRUEBAS DE MUTACIÓN
+=================================================
+
+MSI (Mutation Score)       : ___% [✅|⚠️|❌] (objetivo: 70%)
+Covered MSI                : ___% [✅|⚠️|❌] (objetivo: 80%)
+
+Mutantes generados         : ___
+Mutantes eliminados        : ___ (detectados por las pruebas)
+Mutantes escapados         : ___ (no detectados)
+Mutantes timeout           : ___
+Mutantes con error         : ___
+
+Archivos con mutantes escapados críticos:
+❌ src/Domain/Entity/Order.php - 3 mutantes escapados
+❌ src/Application/UseCase/CreateUser.php - 2 mutantes escapados
+
+=================================================
+   PROBLEMAS DETECTADOS
+=================================================
+
+Pruebas Faltantes:
+❌ Sin pruebas para src/Domain/Entity/Invoice.php
+❌ Sin pruebas para src/Application/UseCase/ProcessPayment.php
+⚠️ Baja cobertura para src/Infrastructure/Repository/OrderRepository.php (45%)
+
+Pruebas Lentas:
+⚠️ tests/Integration/RepositoryTest.php - 15s (optimizar con fixtures)
+⚠️ tests/Functional/ApiTest.php - 12s (usar cliente HTTP simulado)
+
+Pruebas Inestables (Flaky):
+❌ tests/Integration/EmailServiceTest.php - falla a veces
+⚠️ tests/Functional/CheckoutTest.php - dependiente del orden de ejecución
+
+Configuración:
+❌ Infection no instalado
+⚠️ Cobertura de código no configurada en phpunit.xml
+❌ Base de datos de prueba no separada
+
+=================================================
+   TOP 3 ACCIONES PRIORITARIAS
+=================================================
+
+1. 🎯 [ACCIÓN CRÍTICA] - Alcanzar el 80% de cobertura de código
+   Impacto: ⭐⭐⭐⭐⭐ | Esfuerzo: 🔥🔥🔥🔥
+   - Añadir pruebas para Invoice, ProcessPayment
+   - Probar todos los casos de error
+   - Probar todas las ramas condicionales
+
+2. 🎯 [ACCIÓN IMPORTANTE] - Instalar y configurar Infection
+   Impacto: ⭐⭐⭐⭐ | Esfuerzo: 🔥🔥
+   Comando: composer require --dev infection/infection
+   Objetivo MSI ≥ 70%
+
+3. 🎯 [ACCIÓN RECOMENDADA] - Separar y optimizar las pruebas
+   Impacto: ⭐⭐⭐ | Esfuerzo: 🔥🔥
+   - Separar Unit/Integration/Functional
+   - Usar base de datos en memoria para las pruebas
+   - Optimizar los fixtures
+
+=================================================
+   RECOMENDACIONES
+=================================================
+
+Instalación de herramientas:
+```bash
+composer require --dev phpunit/phpunit ^10.0
+composer require --dev infection/infection
+composer require --dev symfony/test-pack
+composer require --dev behat/behat
+composer require --dev friends-of-behat/symfony-extension
+composer require --dev doctrine/doctrine-fixtures-bundle
+```
+
+Configuración phpunit.xml.dist:
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="tests/bootstrap.php"
+         colors="true">
+    <testsuites>
+        <testsuite name="unit">
+            <directory>tests/Unit</directory>
+        </testsuite>
+        <testsuite name="integration">
+            <directory>tests/Integration</directory>
+        </testsuite>
+        <testsuite name="functional">
+            <directory>tests/Functional</directory>
+        </testsuite>
+    </testsuites>
+    <coverage processUncoveredFiles="true">
+        <include>
+            <directory suffix=".php">src</directory>
+        </include>
+    </coverage>
+</phpunit>
+```
+
+Buenas prácticas:
+- Usar factories para crear los objetos de prueba
+- Usar builders para los objetos complejos
+- Crear aserciones personalizadas reutilizables
+- Aislar las pruebas con setUp/tearDown
+- Usar data providers para probar múltiples casos
+- Simular solo las dependencias externas
+- Probar primero el Happy Path, luego los casos de error
+
+CI/CD:
+- Ejecutar las pruebas en cada commit
+- Bloquear los merges si las pruebas fallan
+- Generar y publicar los informes de cobertura
+- Ejecutar Infection en las Pull Requests
+- Alertar si la cobertura disminuye
+
+=================================================
+```
 
 ## Comandos Docker Útiles
 
 ```bash
-# Ejecutar todos los tests
+# Ejecutar todas las pruebas
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit
 
-# Tests unitarios únicamente
+# Solo pruebas unitarias
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit tests/Unit
 
-# Tests con cobertura
+# Pruebas con cobertura
 docker run --rm -v $(pwd):/app php:8.2-cli php -d xdebug.mode=coverage /app/vendor/bin/phpunit --coverage-text
 
 # Infection (mutation testing)
 docker run --rm -v $(pwd):/app infection/infection --threads=4 --min-msi=70
 
-# Behat (tests BDD)
+# Behat (pruebas BDD)
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/behat
 
-# Listar todos los tests
+# Listar todas las pruebas
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit --list-tests
 
-# Ejecutar un test específico
+# Ejecutar una prueba específica
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit tests/Unit/Domain/Entity/UserTest.php
 
-# Tests con salida detallada
+# Pruebas con salida detallada
 docker run --rm -v $(pwd):/app php:8.2-cli /app/vendor/bin/phpunit --testdox
 ```
 
 ## IMPORTANTE
 
-- Utiliza SIEMPRE Docker para los comandos
-- NO almacenes NUNCA archivos en /tmp (usar var/ del proyecto)
-- Proporciona estadísticas precisas
-- Identifica archivos críticos sin tests
-- Sugiere tests concretos a añadir
+- Usar SIEMPRE Docker para los comandos
+- NUNCA almacenar archivos en /tmp (usar var/ del proyecto)
+- Proporcionar estadísticas precisas
+- Identificar los archivos críticos sin pruebas
+- Sugerir pruebas concretas a añadir