Tracking de muestras para el Data Lab: el viaje de vuelta del sync

La ida ya existía: ingest_paciente.php recibe el payload con los exámenes y
los guarda (y responde con examenes_guardados como acuse); el ERP genera las
muestras solo, a partir del tipo de muestra de su catálogo — por eso el
payload NO necesita campos nuevos.

Lo que no existía era la vuelta: que el sistema del laboratorio pueda saber
qué pasó con cada muestra sin que nadie mire el ERP. get_tracking_muestras.php
lo resuelve consultando por rango de fechas (tope 31 días) o por documento,
con la misma autenticación X-Lab-Key del ingest. Devuelve, por turno: fecha,
código, paciente, exámenes en CÓDIGO LEGACY (el que el Data Lab entiende) y
cada muestra con tipo, estado, motivo de rechazo, hora y quién la recibió.
Solo lectura.

scripts/test_tracking_muestras.php: 11 pruebas ejecutando el endpoint real
contra la base real con el caso E018 del 27/08 — sus 10 muestras, el
coprológico rechazado con su motivo, el filtro por documento, la clave, y
la cordura de parámetros.

Pendiente humano (no de código): crear MYBPC3 y SONDA en el módulo Exámenes;
son los únicos 2 códigos de 265 vistos en RIPS esta semana sin mapeo, y no
los invento porque llevan precio y tipo de muestra clínicos.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Lizandro Guarnizo
2026-08-27 12:56:29 -05:00
co-authored by Claude Fable 5
parent 398ea98b0b
commit 0bcb518619
2 changed files with 214 additions and 0 deletions
+140
View File
@@ -0,0 +1,140 @@
<?php
/**
* GET /api/lab/get_tracking_muestras.php
* Tracking de muestras para el Data Lab / RIPS Manager (server-a-server).
*
* La sincronización de entrada ya existe: ingest_paciente.php recibe los
* exámenes y el ERP genera y marca las muestras. Este endpoint es la vuelta:
* el sistema del laboratorio consulta qué pasó con cada muestra — recibida,
* rechazada y por qué, pendiente — sin depender de que nadie mire el ERP.
*
* Autenticación: header X-Lab-Key: <LAB_SYNC_KEY> (igual que el ingest).
*
* Parámetros:
* desde Y-m-d opcional (por defecto: hoy)
* hasta Y-m-d opcional (por defecto: igual a desde)
* documento string opcional — solo ese paciente
*
* Respuesta:
* { ok, desde, hasta, total, turnos: [ { fecha, turno, estado_turno,
* numero_documento, paciente, examenes: [cod_legacy…],
* muestras: [ { tipo, nombre_tipo, estado, motivo_rechazo,
* recibida_at, recibida_por } ] } ] }
*
* Solo lectura: no crea, no modifica, no borra.
*/
ob_start();
require_once __DIR__ . '/../../config/config.php';
header('Content-Type: application/json; charset=utf-8');
function salir(array $r, int $code = 200): void {
ob_clean();
http_response_code($code);
echo json_encode($r, JSON_UNESCAPED_UNICODE);
exit;
}
if ($_SERVER['REQUEST_METHOD'] !== 'GET') {
salir(['ok' => false, 'error' => 'Método no permitido'], 405);
}
// ── Autenticación por API key, idéntica al ingest ────────────────────────
$keyHeader = $_SERVER['HTTP_X_LAB_KEY'] ?? $_SERVER['HTTP_X_LAB_SYNC_KEY'] ?? '';
if (!defined('LAB_SYNC_KEY') || !$keyHeader || !hash_equals(LAB_SYNC_KEY, $keyHeader)) {
salir(['ok' => false, 'error' => 'No autorizado'], 401);
}
// ── Parámetros ───────────────────────────────────────────────────────────
$hoy = date('Y-m-d');
$desde = $_GET['desde'] ?? $hoy;
$hasta = $_GET['hasta'] ?? $desde;
if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $desde)) $desde = $hoy;
if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $hasta)) $hasta = $desde;
if ($desde > $hasta) [$desde, $hasta] = [$hasta, $desde];
// Tope de 31 días por consulta: es un endpoint de sincronización, no de archivo
if ((strtotime($hasta) - strtotime($desde)) > 31 * 86400) {
salir(['ok' => false, 'error' => 'Rango máximo: 31 días'], 400);
}
$documento = trim($_GET['documento'] ?? '');
$pdo = Database::getInstance()->getConnection();
// ── Turnos del rango con paciente y solicitud ────────────────────────────
$where = "DATE(t.creado_at) BETWEEN :desde AND :hasta AND ts.id IS NOT NULL";
$binds = ['desde' => $desde, 'hasta' => $hasta];
if ($documento !== '') {
$where .= " AND p.numero_documento = :doc";
$binds['doc'] = $documento;
}
$stmt = $pdo->prepare(
"SELECT t.id AS turno_id, t.codigo AS turno, t.estado AS estado_turno,
DATE(t.creado_at) AS fecha,
ts.id AS solicitud_id,
p.numero_documento, p.nombre_completo AS paciente
FROM turnero_turnos t
JOIN turnero_solicitudes ts ON ts.turno_id = t.id
LEFT JOIN lab_pacientes p ON p.id = ts.paciente_id
WHERE {$where}
ORDER BY t.creado_at"
);
$stmt->execute($binds);
$turnos = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (!$turnos) {
salir(['ok' => true, 'desde' => $desde, 'hasta' => $hasta, 'total' => 0, 'turnos' => []]);
}
$solIds = array_column($turnos, 'solicitud_id');
$ph = implode(',', array_fill(0, count($solIds), '?'));
// ── Muestras de esas solicitudes, con nombre del tipo y quién recibió ────
$stmtM = $pdo->prepare(
"SELECT m.solicitud_id, m.tipo_muestra AS tipo, m.estado, m.motivo_rechazo,
m.recibida_at, u.full_name AS recibida_por,
tm.nombre AS nombre_tipo
FROM turnero_muestras m
LEFT JOIN admin_users u ON u.id = m.recibida_por
LEFT JOIN lab_tipos_muestra tm
ON tm.codigo COLLATE utf8mb4_unicode_ci = m.tipo_muestra COLLATE utf8mb4_unicode_ci
WHERE m.solicitud_id IN ({$ph})"
);
$stmtM->execute($solIds);
$muestrasPorSol = [];
foreach ($stmtM->fetchAll(PDO::FETCH_ASSOC) as $m) {
$sid = (int) $m['solicitud_id'];
unset($m['solicitud_id']);
$muestrasPorSol[$sid][] = $m;
}
// ── Exámenes (códigos legacy, que son los que el Data Lab entiende) ──────
$stmtE = $pdo->prepare(
"SELECT i.solicitud_id, COALESCE(NULLIF(et.codigo_legacy,''), et.codigo) AS cod
FROM turnero_examen_items i
JOIN exam_tipos et ON et.id = i.exam_tipo_id
WHERE i.solicitud_id IN ({$ph})"
);
$stmtE->execute($solIds);
$examenesPorSol = [];
foreach ($stmtE->fetchAll(PDO::FETCH_ASSOC) as $e) {
$examenesPorSol[(int) $e['solicitud_id']][] = $e['cod'];
}
$salida = [];
foreach ($turnos as $t) {
$sid = (int) $t['solicitud_id'];
$salida[] = [
'fecha' => $t['fecha'],
'turno' => $t['turno'],
'estado_turno' => $t['estado_turno'],
'numero_documento' => $t['numero_documento'],
'paciente' => $t['paciente'],
'examenes' => $examenesPorSol[$sid] ?? [],
'muestras' => $muestrasPorSol[$sid] ?? [],
];
}
salir(['ok' => true, 'desde' => $desde, 'hasta' => $hasta,
'total' => count($salida), 'turnos' => $salida]);