unit-testing

name	unit-testing
description	Genera tests unitarios e integración para backend y/o frontend. Lee la spec y el código implementado. Requiere spec APPROVED e implementación completa.
argument-hint	<nombre-feature> [backend|frontend|ambos]

Unit Testing

Definition of Done — verificar al completar

• Cobertura ≥ 80% en lógica de negocio (quality gate bloqueante)
• Tests aislados — sin conexión a DB real ni servicios externos (siempre mocks)
• Escenario feliz + errores de negocio + validaciones de entrada cubiertos
• Los cambios no rompen contratos existentes del módulo

Prerequisito — Lee en paralelo

.github/specs/<feature>.spec.md        (criterios de aceptación)
código implementado en backend/ y/o frontend/
.claude/rules/backend.md               (stack de test: pytest + pytest-asyncio)
.claude/rules/frontend.md              (stack de test: Vitest + Testing Library)

Output por scope

Backend → backend/tests/

Archivo	Cubre
routes/test_<feature>_router.py	Endpoints: 200/201, 400, 401, 404, 422
services/test_<feature>_service.py	Lógica: happy path + errores de negocio
repositories/test_<feature>_repository.py	Queries: parámetros y retornos correctos

Frontend → frontend/src/__tests__/

Archivo	Cubre
components/<Feature>.test.*	Render + interacciones (click, submit)
hooks/use<Feature>.test.*	Estado inicial + respuesta API + error handling
pages/<Feature>Page.test.*	Render completo con providers

Patrones core

# Backend — AAA con AsyncMock (pytest-asyncio)
@pytest.mark.asyncio
async def test_create_success():
    # GIVEN
    repo = AsyncMock()
    repo.find_by_name.return_value = None
    repo.insert.return_value = {"id": "abc", "name": "test"}
    # WHEN
    result = await FeatureService(repo).create(FeatureCreate(name="test"))
    # THEN
    assert result["id"] == "abc"
    repo.insert.assert_called_once()

// Frontend — mock service + renderHook (Vitest + Testing Library)
vi.mock('../../services/featureService');
getFeatures.mockResolvedValue([{ id: '1' }]);
const { result } = renderHook(() => useFeature());
await waitFor(() => expect(result.current.items).toHaveLength(1));

Reglas

Ver .claude/rules/testing.md — AAA, aislamiento, determinismo, cobertura ≥ 80%.

Restricciones

• Solo tests/ o __tests__/. No modificar código fuente.
• Nunca conectar a DB real ni servicios externos — siempre mocks.