Testing Skill - SmartKet ERP

🎯 Propósito

Esta skill facilita la creación, ejecución y mantenimiento de pruebas en SmartKet, integrando los scripts existentes de /Pruebas y proporcionando templates para tests automatizados.

🧪 Estrategia de Testing

Pirámide de Testing

         /\
        /E2E\         ← Pocos, críticos (Dusk, flow completo)
       /------\
      /  API  \       ← Moderados (Feature tests, endpoints)
     /----------\
    /   UNIT     \    ← Muchos, rápidos (Services, Models)
   /--------------\

Regla: 70% Unit, 20% API, 10% E2E

Tipos de Prueba en SmartKet

1. •Unit Tests - Lógica de Services y Modelos
2. •Feature Tests - Endpoints API completos
3. •Database Tests - Migraciones y seeders
4. •Frontend Tests - Componentes Vue (Vitest)
5. •Integration Tests - Flujos multi-tenant

📋 Checklist de Testing

Antes de Commit

• • Tests de la funcionalidad nueva/modificada pasan
• • Tests existentes no se rompieron
• • Coverage mínimo: 60% en Services

Antes de Deploy

• • Suite completa ejecutada (test-all.ps1)
• • Tests de integración multi-tenant pasados
• • Diagnósticos de API (api-tester.php) OK
• • Tests de navegador críticos (login, registro) OK

🛠️ Scripts de Testing

1. Ejecutar Suite Completa

.\. agent\skills\testing\scripts\test-runner.ps1

Qué hace:

• •Tests PHPUnit (backend)
• •Tests Vitest (frontend)
• •Diagnosis de API
• •Diagnosis de DB

2. Probar Endpoints API

cd smartket-api
php ..\.agent\skills\testing\scripts\api-tester.php

Qué hace: Prueba endpoints críticos con datos reales

3. Diagnóstico de Base de Datos

cd smartket-api
php ..\.agent\skills\testing\scripts\db-diagnostics.php

Qué hace: Verifica esquemas landlord y tenant

📚 Templates de Tests

Feature Test Template

Ver: .agent/skills/testing/examples/feature-test-example.php

// Test de endpoint API
test('can create product', function () {
    $response = $this->postJson('/api/products', [
        'name' => 'Test Product',
        'price' => 99.99
    ]);
    
    $response->assertStatus(201)
             ->assertJsonStructure(['id', 'name', 'price']);
});

Unit Test Template

Ver: .agent/skills/testing/examples/unit-test-example.php

// Test de Service
test('ProductService creates product correctly', function () {
    $service = new ProductService();
    $product = $service->create(['name' => 'Test', 'price' => 50]);
    
    expect($product)->toBeInstanceOf(Product::class)
                    ->and($product->name)->toBe('Test');
});

🚨 Tests Críticos Obligatorios

Backend

1. •Auth: Login, logout, token refresh
2. •Multi-Tenant: Aislamiento de datos
3. •RBAC: Permisos granulares
4. •Business Logic: Cálculos de ventas, stock

Frontend

1. •Login Flow: Desde landing hasta app
2. •Dashboard: Carga correcta de datos
3. •Components: Buttons, modals, forms

📖 Integración con /Pruebas

Los scripts de /Pruebas existentes están integrados:

• •diagnostico-usuario.php → Verificar usuarios'
• •simular-login.php → Test manual de auth
• •test-cors.ps1 → Validar CORS
• •README.md → Documentación de uso

Usar estos para debugging manual cuando los tests automatizados fallen.

🎓 Cuándo Usar Esta Skill

✅ Usar cuando:

• •Agregues nueva funcionalidad (TDD)
• •Refactorices código existente
• •Debuggees error de producción
• •Prepares deployment

❌ No reemplaza:

• •Testing manual de UX
• •Code review humano

💡 Best Practices

1. •Tests rápidos: Unit tests < 100ms
2. •Tests aislados: No depender de orden
3. •Data factories: Usa factories para datos de prueba
4. •Cleanup: Tests deben limpiar lo que crean
5. •Descriptivos: Nombre debe describir qué prueba

// ❌ Malo
test('test 1', function () { ... });

// ✅ Bueno
test('customer can purchase product when in stock', function () { ... });