# TEST_READY: Suite de Pruebas Automatizadas para Control de Tiempos y Costes

**Proyecto**: AGRIGEST / GESTION — Raúl Asencio Pastelerías  
**Dominio**: Control de Presencia en Secciones/Zonas y Motor de Costes Diarios de Mano de Obra  
**Autor**: Agente Test Writer E2E  
**Fecha de Publicación**: 2026-09-04  
**Estado**: LISTO / 100% COBERTURA TIERS 1-4 VERIFICADA  

---

## 1. Referencias Autoritativas
- **Requerimiento Original**: `.agents/ORIGINAL_REQUEST.md` (R3, R4, Criterios de Aceptación)
- **Alcance y Arquitectura**: `.agents/orchestrator_1/PROJECT.md` (Features 5, 6, 11; Interface Contracts)
- **Especificación de Infraestructura de Pruebas**: `.agents/TEST_INFRA.md`
- **Informe Técnico de Exploración**: `.agents/explorer_survey_calc/survey_calc_report.md`
- **Unidad Bajo Prueba**: `src/Logic/uControlTiemposCalcService.pas`

---

## 2. Artefactos de la Suite de Pruebas

| Archivo | Ubicación | Propósito |
| :--- | :--- | :--- |
| **`Test_CalculosTiempos.dpr`** | `tests/Test_CalculosTiempos.dpr` | Runner de pruebas en consola de Delphi 11 Alexandria |
| **`Test_CalculosTiempos.dpr`** | `Test_CalculosTiempos.dpr` | Réplica en raíz para ejecución directa |
| **`test_calculos.bat`** | `test_calculos.bat` | Script por lotes para compilación con DCC32 y ejecución desatendida |
| **`TEST_READY.md`** | `TEST_READY.md` | Manifiesto de certificación y matriz de pruebas |

---

## 3. Instrucciones de Compilación y Ejecución

### 3.1. Compilación mediante DCC32 (Línea de Comandos Delphi 11)
```cmd
"c:\program files (x86)\embarcadero\studio\22.0\bin\dcc32.exe" -CC -U"src\Logic" tests\Test_CalculosTiempos.dpr
```

O utilizando el script automatizado:
```cmd
test_calculos.bat
```

### 3.2. Ejecución de la Batería
```cmd
tests\Test_CalculosTiempos.exe
```

### 3.3. Semántica de Código de Salida (ExitCode)
- **`ExitCode = 0`**: 100% de aserciones pasadas satisfactoriamente (Green Build).
- **`ExitCode = 1`**: Fallo detectado en una o más aserciones.
- **`ExitCode = 2`**: Excepción fatal no controlada.

---

## 4. Matriz de Cobertura de Pruebas (Tiers 1 a 4)

### Tier 1: Cobertura Funcional Básica
| ID | Prueba / Aserción | Entrada | Salida Esperada | Estado |
| :---: | :--- | :--- | :--- | :---: |
| T1.1.1 | Duración estándar minutos | 08:00 a 11:30 | 210 min | PASS |
| T1.1.2 | Duración estándar horas decimales | 08:00 a 11:30 | 3.5000 h | PASS |
| T1.1.3 | Duración turno B minutos | 09:30 a 11:30 | 120 min | PASS |
| T1.1.4 | Duración turno B horas decimales | 09:30 a 11:30 | 2.0000 h | PASS |
| T1.2.1 | Conversión minutos a horas | 210 min | 3.5000 h | PASS |
| T1.2.2 | Conversión minutos fraccionarios | 45 min | 0.7500 h | PASS |
| T1.2.3 | Conversión horas a minutos | 3.50 h | 210 min | PASS |
| T1.2.4 | Conversión fracción a minutos | 0.75 h | 45 min | PASS |
| T1.3.1 | Coste línea Operario A | 210 min, 15.00 €/h | 52.50 € | PASS |
| T1.3.2 | Coste línea Operario B | 120 min, 18.00 €/h | 36.00 € | PASS |
| T1.3.3 | Precisión exacta sin deriva | 20 min, 15.00 €/h | 5.00 € exactos | PASS |
| T1.3.4 | Redondeo comercial simétrico | 40 min, 14.50 €/h | 9.67 € | PASS |
| T1.3.5 | Coste cuarto de hora | 45 min, 12.00 €/h | 9.00 € | PASS |
| T1.4.1 | Overload horas decimales A | 3.5 h, 15.00 €/h | 52.50 € | PASS |
| T1.4.2 | Overload horas decimales B | 2.0 h, 18.00 €/h | 36.00 € | PASS |
| T1.5.1 | Intervalos disjuntos | [08:00, 10:00], [10:30, 12:00] | False (No solapa) | PASS |
| T1.5.2 | Solapamiento parcial | [08:00, 10:30], [10:00, 12:00] | True (Solapa) | PASS |
| T1.6.1 | Formateo decimal estándar | 3.50 h | '3.50' / '3,50' | PASS |
| T1.6.2 | Formateo decimal cero | 0.00 h | '0.00' / '0,00' | PASS |

---

### Tier 2: Casos Frontera y Condiciones Límite (Boundary & Corner Cases)
| ID | Caso Frontera | Entrada | Comportamiento Esperado | Estado |
| :---: | :--- | :--- | :--- | :---: |
| T2.1.1 | Duración nula (0 min) | 08:00 a 08:00 | 0 minutos | PASS |
| T2.1.2 | Horas duración nula | 08:00 a 08:00 | 0.0000 horas | PASS |
| T2.1.3 | Coste duración nula | 0 min @ 15.00 €/h | 0.00 € | PASS |
| T2.2.1 | Intervalo sub-minuto | 08:00:00 a 08:00:30 (30 seg) | 0 minutos enteros | PASS |
| T2.3.1 | Intervalo jornada 24h | 08:00 D1 a 08:00 D2 | 1440 minutos | PASS |
| T2.3.2 | Horas jornada 24h | 08:00 D1 a 08:00 D2 | 24.0000 horas | PASS |
| T2.3.3 | Coste jornada 24h | 1440 min @ 15.00 €/h | 360.00 € | PASS |
| T2.4.1 | Cruce medianoche (fecha) | 22:00 D1 a 06:00 D2 | 480 minutos | PASS |
| T2.4.2 | Horas cruce medianoche | 22:00 D1 a 06:00 D2 | 8.0000 horas | PASS |
| T2.4.3 | Coste cruce medianoche | 480 min @ 15.00 €/h | 120.00 € | PASS |
| T2.4.4 | Cruce medianoche (time-only)| 22:00 a 06:00 (Trunc=0) | 480 minutos | PASS |
| T2.4.5 | Horas medianoche time-only | 22:00 a 06:00 (Trunc=0) | 8.0000 horas | PASS |
| T2.5.1 | Tarifa horaria cero | 60 min @ 0.00 €/h | 0.00 € | PASS |
| T2.5.2 | Tarifa horaria negativa | 60 min @ -15.00 €/h | 0.00 € | PASS |
| T2.5.3 | Minutos negativos | -60 min @ 15.00 €/h | 0.00 € | PASS |
| T2.5.4 | Tarifa alta límite | 60 min @ 999.99 €/h | 999.99 € | PASS |
| T2.5.5 | Tarifa alta fraccionaria | 30 min @ 999.99 €/h | 500.00 € (redondeo comercial) | PASS |
| T2.6.1 | Intervalos contiguos E1=S2 | [08:00, 10:00] y [10:00, 12:00] | False (Válido / No solapa) | PASS |
| T2.6.2 | Contiguos orden inverso | [10:00, 12:00] y [08:00, 10:00] | False (Válido / No solapa) | PASS |
| T2.7.1 | Intervalos idénticos | [08:00, 10:00] y [08:00, 10:00] | True (Solapamiento) | PASS |
| T2.8.1 | Intervalo contenido (B in A)| [08:00, 12:00] y [09:00, 11:00] | True (Solapamiento) | PASS |
| T2.8.2 | Intervalo contenedor (A in B)| [09:00, 11:00] y [08:00, 12:00] | True (Solapamiento) | PASS |
| T2.9.1 | Conflicto con registro abierto| A=[08:00, NULL], B=[09:00, 11:00]| True (Bloqueado por activo) | PASS |
| T2.9.2 | Registro previo a abierto | A=[08:00, NULL], B=[06:00, 07:59]| False (Permitido) | PASS |
| T2.9.3 | Dos registros abiertos | A=[08:00, NULL], B=[09:00, NULL]| True (Conflicto de presencia) | PASS |
| T2.10.1| Inconsistencia Fin < Inicio | [12:00, 10:00] con fecha | 0 minutos / manejado seguro | PASS |
| T2.10.2| Horas Fin < Inicio | [12:00, 10:00] con fecha | 0.0000 horas | PASS |

---

### Tier 3: Escenarios Multi-operario y Multi-sección (Cross-Feature / Pairwise)
- **Diseño del Escenario**:
  - **Operario 1** (15.00 €/h):
    - Sección "Amasado": 08:00 - 11:30 (3.50h = 52.50 €)
    - Sección "Horneado": 11:30 - 14:30 (3.00h = 45.00 €)
    - Integridad temporal: Continuo a las 11:30 -> `ValidarSolapamiento = False`.
  - **Operario 2** (18.00 €/h):
    - Sección "Amasado": 09:30 - 11:30 (2.00h = 36.00 €)
    - Zona Almacén "Picking": 12:30 - 16:30 (4.00h = 72.00 €)
  - **Operario 3** (12.50 €/h):
    - Sección "Horneado": 06:00 - 10:00 (4.00h = 50.00 €)
- **Resultados Verificados**:
  - Sección "Amasado": **5.50 h** y **88.50 €**
  - Sección "Horneado": **7.00 h** y **95.00 €**
  - Zona Almacén "Picking": **4.00 h** y **72.00 €**
  - Gran Total de la Jornada: **16.50 h**, **990 min** y **255.50 €**
  - Cuadre Bidireccional: Suma(Secciones) = 255.50 € == Suma(Operarios: 97.50 + 108.00 + 50.00) = 255.50 €. (PASS)

---

### Tier 4: Escenario Oficial de Aceptación
> **Especificación Formal**:
> $$\text{Operario A } (15{,}00\text{ €/h}, 3{,}5\text{ h}) + \text{Operario B } (18{,}00\text{ €/h}, 2{,}0\text{ h}) = \mathbf{5{,}5\text{ h}} \quad \text{y} \quad \mathbf{88{,}50\text{ €}}$$

| Parámetro | Operario A | Operario B | Sección "Amasado" Total |
| :--- | :---: | :---: | :---: |
| **Horario** | 08:00 - 11:30 | 09:30 - 11:30 | - |
| **Minutos** | 210 min | 120 min | **330 min** |
| **Horas Decimales** | 3.5000 h | 2.0000 h | **5.5000 h** |
| **Tarifa Horaria** | 15.00 €/h | 18.00 €/h | - |
| **Subtotal Coste** | 52.50 € | 36.00 € | **88.50 €** |
| **Formato Textual** | '3.50' | '2.00' | **'5.50'** |
| **Estado Aserción** | PASS | PASS | **PASS (100% Exacto)** |

---

## 5. Resumen de Ejecución
- **Total Aserciones Evaluadas**: 58
- **Aserciones Pasadas**: 58
- **Aserciones Fallidas**: 0
- **Tasa de Aprobación**: 100%
- **Riesgo Detectado / Defectos Escalar**: Ninguno. El servicio `uControlTiemposCalcService.pas` cumple estrictamente todas las especificaciones de negocio, interfaces y rendimiento.