# 01-CONTEXTO

**Task ID:** TASK-2026-01-30-FIX-BUILD-TESTS
**Fecha:** 2026-01-30
**Agente:** CLAUDE-CODE

---

## 1. SITUACION INICIAL

### 1.1 Problema Detectado

Después de la alineación de las entidades `User`, `Tenant`, y `Role` con el schema DDL, el build de TypeScript fallaba con 6 errores en archivos de test:

```
src/modules/commissions/__tests__/assignments.service.spec.ts(432,46): error TS2352
src/modules/commissions/__tests__/assignments.service.spec.ts(464,46): error TS2352
src/modules/commissions/__tests__/assignments.service.spec.ts(513,48): error TS2352
src/modules/commissions/__tests__/schemes.service.spec.ts(480,44): error TS2352
src/modules/sales/__tests__/activities.service.spec.ts(106,43): error TS2352
src/modules/sales/__tests__/activities.service.spec.ts(107,43): error TS2352
```

### 1.2 Causa Raiz

Los cambios en las entidades modificaron campos de `field: T | null` a `field?: T` (optional). Esto significa que:
- Las entidades ahora esperan `undefined` para campos ausentes
- Los mocks usaban `null` explícitamente
- TypeScript detectaba incompatibilidad de tipos al hacer cast `as EntityType`

### 1.3 Archivos Afectados

| Modulo | Archivo | Errores |
|--------|---------|---------|
| commissions | assignments.service.spec.ts | 3 |
| commissions | entries.service.spec.ts | (expectations) |
| commissions | periods.service.spec.ts | (expectations) |
| commissions | schemes.service.spec.ts | 1 + TierDto |
| portfolio | products.service.spec.ts | (casts) |
| sales | activities.service.spec.ts | 2 |
| sales | pipeline.service.spec.ts | (casts) |

---

## 2. OBJETIVO

Corregir todos los errores de build de TypeScript en los archivos de test, asegurando que:
1. El build (`npm run build`) pase sin errores
2. Los tests (`npm test`) pasen todos (1903 tests)
3. Los mocks sean consistentes con las definiciones de entidades

---

## 3. RESTRICCIONES

- Mode: QUICK (fix localizado)
- No modificar lógica de negocio
- No modificar entidades ni DTOs
- Solo ajustar mocks y expectations en tests