REPORTE MATRIZ CONDICIONES

Fuente:   /var/www/html/qareportes/app/Http/Controllers/Cloud/ReportController.php

1) Nombre del reporte

• Nombre: Reporte Matriz Condiciones

• Código / Alias:  report_matriz_condiciones_

• Responsable:  Equipo de Reportes Cloud

• Propósito (1 línea):

2) Alcance temporal

• Campo(s) de fecha utilizados: 

• first_date, second_date (calculados con utils->range_days)

• fecha_de_inspeccion (en consulta a ERP).

• fecha_limite_entrega (normalizada y desglosada en mes/año).

• Tipo de rango (diario / mensual / personalizado): Mensual (últimos 8 meses, retroactivos).

• Inclusión de horas (sí/no).: Sí, en created_date (usa DATETIME). En filtros principales, no.

• Zona horaria: La del servidor 

3) Origen de datos (tablas/APIs)

3.1 Conexión / Base: CAPACITACION

• Tabla / Recurso: tabMatriz de Condiciones

• Alias (si aplica): cnd

• Campos utilizados (clave → descripción):

• cnd.agencia → Agencia

• cnd.id_sucursal → Código

• cnd.division_nacional → Zona

• cnd.nombre_completo → Responsable

• Condiciones (WHERE) aplicadas:

• fecha_de_inspeccion >= fecha_ini

• fecha_de_inspeccion <= fecha_fin

• Tipo de unión con otras fuentes (JOIN y llave): LEFT JOIN tabTabla Matriz de Condiciones mtr ON cnd.name = mtr.parent

• Observaciones (ej. particiones, índices):

• Se calcula mes_entrega y anio_entrega a partir de la fecha límite.

• Se marca campo calculado medidas_correctivas = "SI" cuando al menos una acción a tomar está llena, caso contrario "NO".

• Índices añadidos en tablas dinámicas: status, created_date.

3.2 Conexión / Base:   CAPACITACION

• Tabla / Recurso: tabTabla Matriz de Condiciones

• Alias (si aplica): mtr

• Campos utilizados (clave → descripción):

• mtr.tipo → Tipo de peligro

• mtr.peligro → Tipo de riesgo

• mtr.area → Zona de observación

• mtr.condicion_matriz → Condición de observación

• mtr.nivel_de_avance → Nivel de avance

• mtr.riesgo → Riesgo

• mtr.acciones_a_tomar_1 → Acción a tomar 1

• mtr.acciones_a_tomar_2 → Acción a tomar 2

• mtr.acciones_a_tomar_3 → Acción a tomar 3

• mtr.fecha_limite → Fecha límite de entrega

• Condiciones (WHERE) aplicadas: Se heredan del filtro general aplicado en cnd.fecha_de_inspeccion (rango de fechas).

• Tipo de unión con otras fuentes (JOIN y llave): LEFT JOIN con cnd (llave: cnd.name = mtr.parent).

• Observaciones (ej. particiones, índices): 

• El reporte construye tablas dinámicas mensuales report_matriz_condiciones_YYYY_MM.

• Se agrega truncado de tabla en recreaciones (TRUNCATE).

• Los índices aplicados en la creación de tabla: status, created_date.

4) Filtros globales del reporte

• Inclusiones (must-have): Registros dentro del rango de fechas válidas.

• Exclusiones (reglas de descarte): Si la tabla no se crea correctamente → va a error_reports

• Reglas por estado / habilitado: Campo status (1 = OK, 0 = error).

• Parámetros externos (si el usuario puede filtrarlo): fecha_inicio, fecha_fin (en getMatrizCondiciones).

5) Transformaciones y Reglas de negocio

• Derivaciones de campos (cómo se calculan): 

• mes_entrega → mes textual desde fecha_limite_entrega.

• anio_entrega → año de fecha_limite_entrega.

• Mapeos de estado:

• medidas_correctivas = 'SI' si alguna acción (acciones_a_tomar_1/2/3) no está vacía; caso contrario 'NO'.

• Reglas de validación (p.ej., sólo registros validados): 

• Inserta en emp_reportes_validation cada corrida.

• Verifica existencia de tabla con verifyExistTable.

• Reglas condicionales (si X entonces Y):

• Si tabla no existe → se crea.

• Si ya existe → se trunca.

• Si falla creación → registra error.

6) Estructura de salida

• Tabla/archivo destino: report_matriz_condiciones_YYYY_MM

• Particionado / sufijo: Por año/mes (YYYY_MM)

• Clave(s) primaria(s) o únicas: id AUTO_INCREMENT

• Columnas del reporte (nombre → tipo → descripción):

• id → INT PRIMARY KEY → Identificador único del registro

• agencia → VARCHAR → Nombre de la agencia

• codigo → VARCHAR → Código asociado

• zona → VARCHAR → Zona geográfica

• responsable → VARCHAR → Responsable asignado

• tipo_de_peligro → VARCHAR → Tipo de peligro identificado

• tipo_de_riesgo → VARCHAR → Tipo de riesgo asociado

• zona_observacion → VARCHAR → Zona donde se realizó la observación

• condicion_de_observacion → VARCHAR → Condición observada

• nivel_de_avance → VARCHAR → Nivel de avance en la corrección

• riesgo → VARCHAR → Riesgo identificado

• acciones_a_tomar_1 → VARCHAR → Primera acción correctiva a tomar

• acciones_a_tomar_2 → VARCHAR → Segunda acción correctiva a tomar

• acciones_a_tomar_3 → VARCHAR → Tercera acción correctiva a tomar

• fecha_limite_entrega → DATE → Fecha límite de entrega de acciones

• medidas_correctivas → VARCHAR → Medidas correctivas propuestas

• mes_entrega → VARCHAR → Mes de la entrega

• anio_entrega → VARCHAR → Año de la entrega

• created_date → DATETIME → Fecha de creación del registro

• status → TINYINT → Estado del registro (1 = activo, 0 = inactivo)

• Ordenamiento por defecto: No definido en código.

7) Frecuencia y operación

• Frecuencia de actualización: PENDIENTE (Esperando info de Eduardo)

• Ventana que recalcula (días/meses): 8 meses atrás.

• Tamaño de lote / paginado (chunking): 900 registros por bloque (array_chunk).

• Tolerancia a fallos / reintentos: Si falla API → guarda status 0 en emp_reportes_validation.

• Tiempos de ejecución esperados: PENDIENTE (Esperando info de Eduardo)

8) Calidad y controles

• Validaciones previas/post:  Validación de tabla creada (verifyExistTable).

• Controles de duplicados: Truncado de tabla al recrear evita duplicados.

• Métricas de completitud (qué se monitorea): Registro en emp_reportes_validation (incluye status y fechas).

9) Dependencias externas

• APIs / servicios y endpoints:

• APIS: 

• RECURSOS_HUMANOS/api/matriz_condiciones/{first_date}/{second_date}

• APICAPACITACION/method/send-query-database

• Autenticación / headers:

• "Accept: application/json", "Content-Type: application/json"
  
  

• Mapeos y contratos de datos: JSON devuelto por APIs, convertido a registros de tablas.

10) Historial de cambios

2025-10-01 13:35 - Elian Franco Arroyo Rodas - Documentación inicial