workspace-v1/orchestration/directivas/simco/SIMCO-TESTING.md

SIMCO-TESTING

Version: 1.0.0 Tipo: Directiva Operacional Prioridad: P0 Alias: @TESTING Creado: 2026-01-10 Depende de: SIMCO-BACKEND.md, SIMCO-FRONTEND.md

---

1. Proposito

Establecer estandares minimos de testing para todos los proyectos, definiendo cobertura requerida, tipos de tests y convenciones de nomenclatura.

---

2. Principios de Testing

2.1 Testing como Requisito

• Todo codigo nuevo DEBE incluir tests
• Tests antes de PR (no despues)
• Cobertura minima es un gate de CI/CD

2.2 Piramide de Testing

         ╱╲
        ╱  ╲
       ╱E2E ╲        (pocos, lentos, costosos)
      ╱──────╲
     ╱Integr. ╲      (algunos, moderados)
    ╱──────────╲
   ╱   Unit     ╲    (muchos, rapidos, baratos)
  ╱──────────────╲

2.3 Test-Driven Approach

1. Escribir test que falla
2. Implementar codigo minimo
3. Refactorizar
4. Repetir

---

3. Cobertura Minima por Tipo

3.1 Backend

Tipo	Cobertura Minima	Herramienta
Unit	70%	Jest
Integration	50%	Jest + Supertest
E2E	30%	Jest + Supertest

3.2 Frontend

Tipo	Cobertura Minima	Herramienta
Components	60%	Jest + Testing Library
Hooks	70%	Jest
E2E	20%	Playwright/Cypress

3.3 Database

Tipo	Cobertura	Herramienta
Migrations	100%	Script validacion
Rollback	100%	Script validacion
Functions	80%	pgTAP

---

4. Tipos de Tests Requeridos

4.1 Unit Tests

Proposito: Probar funciones/metodos aislados

Caracteristicas:

• Sin dependencias externas
• Mocks para servicios
• Rapidos (<100ms por test)

// Ejemplo: user.service.spec.ts
describe('UserService', () => {
  describe('create', () => {
    it('should create a user with valid data', async () => {
      // Arrange
      const dto = { email: 'test@test.com', password: '123456' };

      // Act
      const result = await service.create(dto);

      // Assert
      expect(result).toBeDefined();
      expect(result.email).toBe(dto.email);
    });
  });
});

4.2 Integration Tests

Proposito: Probar interaccion entre componentes

Caracteristicas:

• Base de datos de prueba
• Servicios reales (no mocks)
• Moderadamente rapidos

// Ejemplo: auth.integration.spec.ts
describe('Auth Integration', () => {
  beforeAll(async () => {
    await setupTestDatabase();
  });

  it('should login and return valid token', async () => {
    const response = await request(app)
      .post('/api/v1/auth/login')
      .send({ email: 'test@test.com', password: '123456' });

    expect(response.status).toBe(200);
    expect(response.body.token).toBeDefined();
  });
});

4.3 E2E Tests

Proposito: Probar flujos completos de usuario

Caracteristicas:

• Ambiente completo
• Desde UI hasta DB
• Lentos pero completos

// Ejemplo: login.e2e.spec.ts
describe('Login Flow', () => {
  it('should allow user to login', async () => {
    await page.goto('/login');
    await page.fill('[data-testid="email"]', 'user@test.com');
    await page.fill('[data-testid="password"]', '123456');
    await page.click('[data-testid="submit"]');

    await expect(page).toHaveURL('/dashboard');
  });
});

---

5. Nomenclatura de Archivos de Test

5.1 Patrones por Tipo

Tipo	Patron	Ejemplo
Unit	{nombre}.spec.ts	user.service.spec.ts
Integration	{nombre}.integration.spec.ts	auth.integration.spec.ts
E2E	{nombre}.e2e.spec.ts	login.e2e.spec.ts

5.2 Ubicacion

src/
├── modules/
│   └── auth/
│       ├── auth.service.ts
│       ├── auth.service.spec.ts        # Unit test junto al archivo
│       └── __tests__/
│           └── auth.integration.spec.ts
test/
└── e2e/
    └── auth/
        └── login.e2e.spec.ts

---

6. Estructura de Carpetas de Test

6.1 Backend (NestJS)

apps/backend/
├── src/
│   └── modules/
│       └── {modulo}/
│           ├── {modulo}.service.spec.ts
│           ├── {modulo}.controller.spec.ts
│           └── __tests__/
│               ├── {modulo}.integration.spec.ts
│               └── fixtures/
├── test/
│   ├── e2e/
│   │   └── {modulo}/
│   │       └── {feature}.e2e.spec.ts
│   ├── fixtures/
│   └── setup.ts
└── jest.config.js

6.2 Frontend (React)

apps/frontend/
├── src/
│   └── components/
│       └── {Component}/
│           ├── {Component}.tsx
│           ├── {Component}.test.tsx
│           └── __tests__/
│               └── integration.test.tsx
├── tests/
│   └── e2e/
│       └── {feature}/
│           └── {scenario}.spec.ts
└── playwright.config.ts

---

7. Comandos de Ejecucion

7.1 Backend

# Unit tests
npm run test

# Unit tests con cobertura
npm run test:cov

# Integration tests
npm run test:integration

# E2E tests
npm run test:e2e

# Watch mode
npm run test:watch

7.2 Frontend

# Component tests
npm run test

# Cobertura
npm run test:coverage

# E2E con Playwright
npm run test:e2e

# E2E con UI
npm run test:e2e:ui

7.3 Scripts en package.json

{
  "scripts": {
    "test": "jest",
    "test:cov": "jest --coverage",
    "test:watch": "jest --watch",
    "test:integration": "jest --config jest.integration.config.js",
    "test:e2e": "jest --config jest.e2e.config.js"
  }
}

---

8. Monitoreo Basico

8.1 Metricas de Testing

Metrica	Descripcion	Umbral
Coverage %	Porcentaje de lineas cubiertas	>70%
Test Pass Rate	% de tests pasando	100%
Test Duration	Tiempo total de ejecucion	<5min CI
Flaky Tests	Tests inconsistentes	0

8.2 Reportes

# Generar reporte HTML de cobertura
npm run test:cov -- --coverageReporters=html

# Ubicacion: coverage/lcov-report/index.html

8.3 CI/CD Integration

# .github/workflows/test.yml
test:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v3
    - name: Run tests
      run: npm run test:cov
    - name: Check coverage threshold
      run: |
        coverage=$(cat coverage/coverage-summary.json | jq '.total.lines.pct')
        if (( $(echo "$coverage < 70" | bc -l) )); then
          echo "Coverage $coverage% is below 70%"
          exit 1
        fi        

---

9. Integracion con CI/CD

9.1 Gates de Calidad

Gate	Descripcion	Bloquea PR
Tests Pass	Todos los tests pasan	SI
Coverage Min	Cobertura >= umbral	SI
No New Flaky	Sin tests flaky nuevos	SI
Performance	Tiempo < limite	NO

9.2 Pre-commit Hooks

# .husky/pre-commit
npm run test:staged
npm run lint-staged

---

10. Anti-patrones a Evitar

Anti-patron	Problema	Solucion
Tests sin asserts	No validan nada	Agregar expect()
Mocks excesivos	No prueban integracion	Balance unit/integration
Tests lentos	Bloquean desarrollo	Optimizar o mover a nightly
Datos hardcoded	Fragiles	Usar factories/fixtures
Skip tests	Deuda tecnica	Arreglar o eliminar

---

11. Referencias

Directiva	Proposito
SIMCO-BACKEND.md	Estructura backend
SIMCO-FRONTEND.md	Estructura frontend
SIMCO-DEVOPS.md	CI/CD

---

Ultima actualizacion: 2026-01-10 Mantenido por: Orchestration Team