Files
whatsapp/modules/soporte/docs/tecnica/70-catalogos.md
T
Lizandro GuarnizoandClaude Opus 5 71c9dfd424 Documentación: diagramas, kiosko y chat, catálogos, respaldos y endpoints documentados
Diagramas en texto dentro de bloques de código, en vez de capturas: se editan
como texto, no pesan en el repositorio y no quedan desactualizados solos. Se
agregan el recorrido de un turno, quién firma cada consentimiento, el paso de
una muestra pendiente entre visitas y la línea de tiempo de las tomas seriadas.

Páginas nuevas del manual: kiosko y pantallas de TV (las dos que funcionan sin
nadie operándolas), y chat de WhatsApp, que explica por qué el bot deja de
responder cuando un operador toma la conversación y de dónde sale el límite de
24 horas.

Páginas técnicas nuevas: registro de exámenes, y los catálogos del laboratorio
agrupados en una sola página por compartir la misma forma. Operación suma
respaldos y recuperación, incluyendo qué datos históricos no son recuperables.

Los 10 endpoints que no tenían comentario de cabecera ahora lo tienen, así que
la tabla generada por {{endpoints}} queda completa: 83 de 83.

DOCUMENTACION_LAB.md y README_LAB.md quedan como puntero al módulo;
WEBHOOK_ENDPOINTS.md se elimina por estar ya migrado a la sección técnica.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 10:49:02 -05:00

2.9 KiB

Catálogos del laboratorio

Los módulos que administran las tablas maestras. Se agrupan acá porque comparten la misma forma: una pantalla de listado con alta, edición y baja sobre una tabla.

Los módulos

Módulo Tabla principal Qué administra
lab_examenes exam_tipos Catálogo de exámenes, valores de referencia y tarifas
medicos medicos Médicos solicitantes
lab_pacientes lab_pacientes Fichas clínicas e historial
lab_enfermeras lab_enfermeras Personal clínico
lab_eps lab_eps EPS y aseguradoras
lab_empresas lab_empresas Empresas, convenios, subgrupos y tarifas
lab_ciudades lab_ciudades Ciudades de pacientes
usuarios admin_users, roles Usuarios y asignación de roles

Los que tienen endpoints propios

La mayoría son puentes al sistema anterior. Dos tienen código propio:

lab_examenes

Endpoint Qué hace
list.php / get.php Listado y detalle
save.php Alta y edición del examen
save_item.php Ítems que componen un examen
get_tarifas.php / save_tarifa.php Tarifas por empresa o convenio

Es el catálogo del que dependen el turnero y el registro de exámenes. Un examen mal configurado se propaga a todo lo demás: consentimientos que no se piden, tarifas que no se aplican.

exam_tipo_consentimientos vincula un examen con los formularios que obliga a firmar. Es una de las dos fuentes de consentimientos del turnero; la otra es la estación destino.

medicos

list.php, save.php, delete.php. El médico se asocia a la solicitud del turnero y sale impreso en los documentos.

Pacientes

lab_pacientes es el más consultado de todos: lo usan el turnero, domicilios, registro de exámenes y el bot.

Campos que otros módulos dan por sentados:

Campo Quién lo usa
numero_documento Búsqueda en todas las pantallas
telefono Envío de consentimientos y encuestas
nombre_completo, tipo_documento Encabezado de todos los documentos
fecha_nacimiento Cálculo de edad en formularios
eps Facturación

Un teléfono mal cargado se manifiesta lejos de donde se originó: como un consentimiento que nunca llegó.

Usuarios

Ver Roles y permisos para el detalle del control de acceso.

Lo esencial al crear o editar un usuario:

  • role y role_id deben cambiarse juntos. La interfaz lee uno, los permisos salen del otro.
  • Cargá la cédula. Es lo que aparece bajo la firma en los formularios.
  • El usuario debe volver a iniciar sesión para que un cambio de permisos surta efecto.

Al agregar un catálogo nuevo

Si es un ABM simple, seguí el patrón de medicos: un views/index.php y tres endpoints (list, save, delete). Registralo en SYSTEM_MODULES y concedelo a los roles que corresponda, o nadie lo verá.