Documentación funcional de la demostración personalizada

medicLab — Sistema de laboratorio clínico

Laboratorio de análisis clínicos en Huaraz, con equipos automatizados de bioquímica y hematología

Esta página describe el sistema completo. Está pensada para que cualquiera —una persona o un modelo de lenguaje— pueda leerla desde el enlace y armar con ella lo que necesite: una propuesta, un manual, una ficha técnica o un guion de demostración.

Abrir el sistema

1. Qué es este sistema

Sistema a medida para un laboratorio clínico que ya tiene sus equipos automatizados pero los trabaja desconectados: el analizador imprime, alguien copia los valores en un papel y después los digita. La demostración conecta los dos analizadores al sistema: el resultado entra solo en la orden del paciente, el tecnólogo revisa, la dirección valida y el informe sale en PDF por WhatsApp, por correo o desde el portal del paciente. Alrededor de eso está el resto de lo que pidió: admisión por DNI con RENIEC (y pasaporte o carné de extranjería para el paciente extranjero), etiquetas de tubo con código de barras, inventario de reactivos con kardex, costos por examen, caja y facturación electrónica.

Para quién es

Ficha

Laboratorio medicLab
Responsable Luis Martín Domínguez Villanueva · Director
Sede Huaraz · Huaraz, Áncash
Usuarios del sistema 3 personas: dirección, laboratorio y administración
Volumen declarado entre 10 y 15 pacientes por día (338 al mes aproximadamente)
Equipos a interfazar 2: analizador de bioquímica y analizador de hematología
Pruebas mapeadas equipo → sistema 14
Exámenes en el catálogo 13 exámenes y 3 perfiles
Áreas del laboratorio Bioquímica, Inmunoensayo, Hematología, Microbiología, Uroanálisis
Reactivos e insumos en kardex 21 de 4 proveedores
Convenios activos Clínica en convenio (−30%) · Centro médico en convenio (−25%)
RUC y razón social Por confirmar

Sobre los datos que se ven dentro

  • · El volumen de pacientes, los dos equipos por interfazar, la entrega por WhatsApp y correo, la necesidad de inventario y de orden en el dinero, y los pacientes extranjeros son los que el laboratorio describió en la reunión.
  • · Los pacientes, los precios, los reactivos y los convenios son datos de trabajo para mostrar el sistema en uso.
  • · La marca es provisional: los colores y el logo se ajustan a los del laboratorio.
  • · El sistema no guarda nada en un servidor: al recargar la página vuelve al punto de partida.

2. Cómo entrar a la demostración

El sistema está en https://mediclab.medikagency.com. Cada perfil ve solo los módulos de su trabajo.

UsuarioPerfilQué puede hacer
luis Dirección Acceso total · valida resultados, ve costos, kardex, convenios, caja y facturación
admin Administración Admite pacientes por DNI o pasaporte, crea órdenes, cobra y cierra su caja
tecnologo Laboratorio Recibe los resultados del equipo, los revisa, imprime etiquetas y controla el almacén

Contraseña en todos los perfiles: demo123

Los convenios entran por /b2b con su propio usuario (clinica, centro), y el paciente ve su informe en /portal con su documento y el código de la orden. Todos con la misma clave.

3. Qué problemas resuelve

Los equipos de bioquímica y hematología no están conectados: el resultado se anota en un papel y se digita.

Los dos analizadores mandan sus resultados al sistema (ASTM E1381 / E1394 en bioquímica, HL7 v2.3.1 en hematología). El valor entra directo en la orden del paciente y el tecnólogo solo revisa y valida.

Cada transcripción es una oportunidad de error de tipeo.

El valor que sale del analizador es el que queda en el informe: nadie lo vuelve a escribir. La trazabilidad muestra que ese resultado llegó del equipo y no de un teclado.

Se pierde tiempo copiando y volviendo a revisar.

Contando 4 minutos por paciente, con 13 pacientes al día se van 22.5 horas al mes solo en transcribir. Con la interfaz ese tiempo desaparece.

¿Cómo sabe el equipo a qué paciente pertenece la muestra?

Por la etiqueta. Cada tubo sale rotulado con su código de barras, el analizador lo lee y por eso el resultado cae en la orden correcta sin que nadie lo dirija.

No hay control de reactivos: no se sabe qué entró, qué salió ni qué se perdió.

El kardex registra entradas, salidas, mermas y ajustes con su saldo y su valor. Las salidas las genera la receta del examen procesado, así que nadie tiene que anotarlas.

El dinero se lleva aparte y sin orden.

Caja con apertura y cierre de turno, cobros por medio de pago y liquidación del día en PDF. Boletas y facturas salen del mismo cobro contra SUNAT.

Llegan pacientes extranjeros y el sistema solo entiende DNI.

Se admite por DNI, carné de extranjería o pasaporte. Con DNI los datos se traen de RENIEC; con documento extranjero se registran una vez y desde la segunda visita el paciente ya sale buscando ese número.

En el laboratorio no siempre hay internet.

La admisión, las etiquetas y la llegada de resultados trabajan contra la mini PC del laboratorio. Lo que se hace sin conexión queda en cola y sube solo cuando el internet vuelve.

El resultado se entrega hoy por WhatsApp y por correo.

Se sigue entregando así, pero desde el sistema: el informe validado se manda por WhatsApp o correo en PDF, y además queda en el portal del paciente.

4. Los módulos, uno por uno

15 módulos.

1. Dashboard

Ruta: #/ · Perfiles: Todos

Para qué sirve. El día del laboratorio en una pantalla.

Qué contiene

  • ·Órdenes del día (13), pacientes atendidos e informes publicados.
  • ·Órdenes por hora, separando mostrador de convenio.
  • ·Estado de los analizadores y cuántos resultados entraron solos.

2. Interfaz con equipos

Ruta: #/equipos · Perfiles: Dirección, Laboratorio

Para qué sirve. El módulo central: el analizador escribe en la orden.

Qué contiene

  • ·Los dos analizadores con su protocolo, su conexión y su puerto (ASTM E1381 / E1394 y HL7 v2.3.1).
  • ·14 pruebas mapeadas: el código con que el equipo nombra la prueba y el analito del sistema.
  • ·Muestras esperando en cada equipo y el resultado entrando en vivo a la orden.
  • ·La trama tal cual la manda el analizador, para ver qué llegó y qué se aplicó.
  • ·El esquema del puente: analizador, switch, mini PC, túnel al servidor.

Reglas que aplica

  • ·El resultado que llega del equipo no se puede editar sin que quede registrado quién lo cambió.

3. Admisión

Ruta: #/admision · Perfiles: Dirección, Administración

Para qué sirve. Registrar al paciente y crear su orden.

Qué contiene

  • ·DNI con consulta a RENIEC, o carné de extranjería y pasaporte a mano.
  • ·Selección de exámenes o perfiles del catálogo.
  • ·Etiquetas de tubo con código de barras, una por tipo de tubo.
  • ·Origen: mostrador o convenio, con el precio que corresponde.

Reglas que aplica

  • ·Si el servicio de consulta no responde, el sistema lo dice: nunca muestra los datos de otra persona.

4. Órdenes

Ruta: #/ordenes · Perfiles: Todos

Para qué sirve. Dónde está cada orden, en tiempo real.

Qué contiene

  • ·Estados: registrada, en proceso, digitada, validada y publicada.
  • ·Filtro por área, origen y estado.
  • ·Tiempo de entrega comprometido por examen.

5. Resultados

Ruta: #/resultados · Perfiles: Dirección, Laboratorio

Para qué sirve. Revisar, validar y entregar.

Qué contiene

  • ·Valores con su rango de referencia y marca automática de alto o bajo.
  • ·Comparación con el resultado anterior del mismo paciente.
  • ·Trazabilidad: si el valor llegó del equipo, lo dice y nombra el equipo.
  • ·Envío del informe por WhatsApp o correo y publicación al portal.

Reglas que aplica

  • ·Un resultado no se publica sin la validación de la dirección técnica.

6. Catálogo y precios

Ruta: #/catalogo · Perfiles: Todos

Para qué sirve. Qué se hace y a cuánto.

Qué contiene

  • ·13 exámenes con su método, área y tiempo de entrega.
  • ·3 perfiles con precio de paquete.
  • ·Precio de lista y precio por convenio.

7. Inventario

Ruta: #/inventario · Perfiles: Dirección, Laboratorio

Para qué sirve. Reactivos, lotes y vencimientos.

Qué contiene

  • ·21 insumos con stock, mínimo, lote y vencimiento.
  • ·Alertas de bajo mínimo y de producto por vencer.
  • ·Proveedor de cada insumo.

8. Kardex

Ruta: #/kardex · Perfiles: Dirección, Laboratorio

Para qué sirve. Cada movimiento de reactivo, con su saldo y su valor.

Qué contiene

  • ·Entradas, salidas, mermas y ajustes (10 movimientos sembrados).
  • ·Valor del almacén a costo puesto, con flete incluido.
  • ·Pérdida por mermas del mes, en unidades y en soles.

Reglas que aplica

  • ·Las salidas las genera el sistema al procesar el examen: nadie digita el consumo.

9. Costos y márgenes

Ruta: #/costos · Perfiles: Dirección

Para qué sirve. Cuánto queda por cada examen.

Qué contiene

  • ·Costo del insumo más flete contra el precio de mostrador y el de convenio.
  • ·Desglose por reactivo de cada examen.
  • ·Gastos operativos del mes.

10. Caja y ventas

Ruta: #/ventas · Perfiles: Dirección, Administración

Para qué sirve. El dinero del día.

Qué contiene

  • ·Cobros por medio de pago, con apertura y cierre de turno.
  • ·Boletas, facturas y tickets internos separados.
  • ·Liquidación del día en PDF.

11. Convenios

Ruta: #/convenios · Perfiles: Dirección

Para qué sirve. Quién refiere muestras y cuánto debe.

Qué contiene

  • ·2 convenios con su descuento, su consumo del mes y su deuda.
  • ·Cobro con código y estado de pago.
  • ·Bloqueo del portal B2B por falta de pago.

12. Reportes

Ruta: #/reportes · Perfiles: Dirección

Para qué sirve. Cómo va el mes.

Qué contiene

  • ·Ingresos por área del laboratorio.
  • ·Mostrador contra convenio a lo largo del mes.
  • ·Exámenes más pedidos.

13. Configuración

Ruta: #/configuracion · Perfiles: Dirección

Para qué sirve. Membrete, plantillas, internet y sedes.

Qué contiene

  • ·Datos de la empresa y membrete del informe.
  • ·Tres plantillas de informe con su gasto de papel.
  • ·Simulación de caída de internet con la cola de sincronización.
  • ·Lo que cuesta hoy transcribir a mano, en horas al mes.

14. Portal del paciente

Ruta: /portal · Perfiles: Público

Para qué sirve. El informe sin volver al laboratorio.

Qué contiene

  • ·Ingreso con documento y código de orden.
  • ·Descarga del informe en PDF.
  • ·Historial de resultados anteriores.

15. Portal del convenio (B2B)

Ruta: /b2b · Perfiles: Convenios

Para qué sirve. Cada convenio baja sus informes solo.

Qué contiene

  • ·Informes de sus pacientes, listos para descargar.
  • ·Consumo del mes y estado de cuenta.
  • ·Se bloquea si el convenio está en deuda.

5. El flujo de trabajo

  1. 1

    Admisión

    Se escribe el documento —DNI, carné de extranjería o pasaporte— y se eligen los exámenes. La orden nace con su código de muestra.

  2. 2

    Etiquetas

    Sale una etiqueta por tubo con el código de barras de esa muestra. Es lo que el analizador va a leer.

  3. 3

    Proceso en el equipo

    El analizador corre la muestra y manda sus valores al sistema, que los aplica a la orden que corresponde.

  4. 4

    Revisión

    El tecnólogo mira lo que llegó, ve lo que está fuera de rango y lo compara con el resultado anterior del paciente.

  5. 5

    Validación

    La dirección técnica valida. Recién ahí el informe existe para el paciente.

  6. 6

    Entrega

    El informe se manda por WhatsApp o correo en PDF y queda publicado en el portal del paciente o del convenio.

  7. 7

    Cierre

    Caja cuadra el turno, la liquidación sale en PDF y el kardex ya descontó los reactivos que se usaron.

6. Perfiles y permisos

Cada perfil ve solo los módulos de su trabajo. Si intenta abrir otro, el sistema lo bloquea con un aviso, no lo esconde: la persona sabe que existe y que no le corresponde.

Dirección

Usuario luis

Acceso total · valida resultados, ve costos, kardex, convenios, caja y facturación

Módulos: todos

Administración

Usuario admin

Admite pacientes por DNI o pasaporte, crea órdenes, cobra y cierra su caja

Módulos: dashboard, admision, ordenes, catalogo, ventas, comprobante, portal

Laboratorio

Usuario tecnologo

Recibe los resultados del equipo, los revisa, imprime etiquetas y controla el almacén

Módulos: dashboard, ordenes, resultados, equipos, catalogo, inventario, kardex

7. Reglas que el sistema hace cumplir

No son advertencias que se puedan ignorar: son bloqueos.

El valor del equipo no se vuelve a escribir.

Por qué. Cada transcripción es un error posible; el sistema guarda el valor tal como llegó del analizador.

Cada tubo lleva su etiqueta con código de barras.

Por qué. Es lo que permite que el equipo sepa de qué orden es la muestra sin que nadie se lo indique.

Un resultado no se publica sin validación.

Por qué. Revisa el tecnólogo, firma la dirección: es lo que exige la responsabilidad del informe.

El consumo de reactivos no se digita.

Por qué. Sale solo de la receta del examen procesado. Un kardex que depende de que alguien lo anote no dura un mes.

Sin internet el laboratorio no se detiene.

Por qué. La atención y los equipos trabajan contra la mini PC local; lo pendiente se sincroniza cuando vuelve la conexión.

RENIEC solo responde por DNI.

Por qué. El paciente extranjero se registra a mano una vez, y el sistema no inventa datos que no tiene.

8. Alcance y datos del sistema

Equipos a interfazar (2)

EquipoÁreaMarca y modeloProtocoloConexiónPruebas
Analizador de bioquímicaBioquímicaPor confirmar / Por confirmarASTM E1381 / E1394Serie RS-2329
Analizador de hematologíaHematologíaPor confirmar / Por confirmarHL7 v2.3.1Red TCP/IP5

Mapeo de pruebas equipo → sistema

EquipoCódigo del equipoAnalito del sistema
Analizador de bioquímicaGLUGLU
Analizador de bioquímicaCHOLCHOL
Analizador de bioquímicaHDL-CHDL
Analizador de bioquímicaLDL-CLDL
Analizador de bioquímicaTRIGTRIG
Analizador de bioquímicaTGOTGO
Analizador de bioquímicaTGPTGP
Analizador de bioquímicaUREAURE
Analizador de bioquímicaCREACREA
Analizador de hematologíaWBCWBC
Analizador de hematologíaRBCRBC
Analizador de hematologíaHGBHGB
Analizador de hematologíaHCTHCT
Analizador de hematologíaPLTPLT

Lo que hace falta para conectar los equipos

PiezaPara qué
Mini PC en el laboratorioCorre el agente que escucha a los equipos y los ordena antes de enviarlos.
Switch de redLos dos equipos y la mini PC en la misma red, cada uno con su cable.
Cable serie o de red por equipoDepende del puerto que tenga cada analizador.
Túnel SSH al servidorLa mini PC empuja los resultados al sistema; si se cae internet, los guarda y los manda cuando vuelve.
Impresora de etiquetasCada tubo sale con su código de barras y el equipo lo lee: por eso el resultado cae en la orden correcta.

Catálogo de exámenes (13)

CódigoExamenÁreaMétodoPrecio
BIO001Glucosa en ayunasBioquímicaEnzimático (GOD-PAP)S/ 18.00
BIO002Perfil LipídicoBioquímicaEnzimático colorimétricoS/ 45.00
BIO003Perfil HepáticoBioquímicaCinético UV / colorimétricoS/ 55.00
BIO007Perfil RenalBioquímicaCinético / enzimáticoS/ 50.00
BIO010Calcio séricoBioquímicaColorimétrico (Arsenazo III)S/ 20.00
HEM001Hemograma Completo AutomatizadoHematologíaImpedancia + fotometríaS/ 25.00
HOR001TSH ultrasensibleInmunoensayoECLIAS/ 38.00
HOR002T4 LibreInmunoensayoECLIAS/ 42.00
HOR003T3 LibreInmunoensayoECLIAS/ 42.00
HOR004Anti-TPOInmunoensayoECLIAS/ 55.00
HOR006Vitamina B12InmunoensayoECLIAS/ 60.00
URO001Examen Completo de OrinaUroanálisisTira reactiva + microscopíaS/ 15.00
MIC001UrocultivoMicrobiologíaCultivo + antibiogramaS/ 40.00

Perfiles (3)

PerfilIncluyePrecio
Perfil Control3 exámenesS/ 65.00
Perfil Tiroideo3 exámenesS/ 105.00
Perfil Metabólico3 exámenesS/ 98.00

Margen por examen (mostrador y convenio)

ExamenCosto puestoMostradorQuedaConvenio −30%Queda
Glucosa en ayunasS/ 1.88S/ 18.00S/ 16.12 (89.55555555555557%)S/ 12.60S/ 10.72 (85.07936507936509%)
Perfil LipídicoS/ 10.72S/ 45.00S/ 34.28 (76.17777777777778%)S/ 31.50S/ 20.78 (65.96825396825398%)
Perfil HepáticoS/ 11.51S/ 55.00S/ 43.49 (79.07272727272728%)S/ 38.50S/ 26.99 (70.1038961038961%)
Perfil RenalS/ 9.48S/ 50.00S/ 40.52 (81.04%)S/ 35.00S/ 25.52 (72.91428571428571%)
Calcio séricoS/ 2.22S/ 20.00S/ 17.78 (88.9%)S/ 14.00S/ 11.78 (84.14285714285714%)
Hemograma Completo AutomatizadoS/ 1.40S/ 25.00S/ 23.60 (94.4%)S/ 17.50S/ 16.10 (92%)
TSH ultrasensibleS/ 7.71S/ 38.00S/ 30.29 (79.71052631578948%)S/ 26.60S/ 18.89 (71.01503759398497%)
T4 LibreS/ 8.16S/ 42.00S/ 33.84 (80.57142857142858%)S/ 29.40S/ 21.24 (72.24489795918367%)
T3 LibreS/ 8.16S/ 42.00S/ 33.84 (80.57142857142858%)S/ 29.40S/ 21.24 (72.24489795918367%)
Anti-TPOS/ 10.84S/ 55.00S/ 44.16 (80.29090909090908%)S/ 38.50S/ 27.66 (71.84415584415585%)
Vitamina B12S/ 12.30S/ 60.00S/ 47.70 (79.5%)S/ 42.00S/ 29.70 (70.71428571428571%)
Examen Completo de OrinaS/ 1.06S/ 15.00S/ 13.94 (92.93333333333334%)S/ 10.50S/ 9.44 (89.9047619047619%)
UrocultivoS/ 7.11S/ 40.00S/ 32.89 (82.22500000000001%)S/ 28.00S/ 20.89 (74.60714285714286%)

Reactivos e insumos (21)

CódigoInsumoStockMínimoCostoFlete
RE-GLUReactivo Glucosa (GOD-PAP)310 test150S/ 1.20S/ 0.14
RE-COLReactivo Colesterol (CHOD-PAP)108 test120S/ 1.80S/ 0.22
RE-TRIGReactivo Triglicéridos (GPO-PAP)180 test100S/ 1.90S/ 0.23
RE-HDLReactivo HDL/LDL directo150 test100S/ 2.60S/ 0.31
RE-HEPReactivos hepáticos (TGO/TGP/BIL/FA)120 test90S/ 2.40S/ 0.29
RE-RENReactivos renales (Urea/Crea/Ác. úrico)95 test100S/ 2.10S/ 0.25
RE-CAReactivo Calcio (Arsenazo III)140 test80S/ 1.50S/ 0.18
KIT-TSHKit TSH ultrasensible (ECLIA)180 test80S/ 6.40S/ 0.77
KIT-T4Kit T4/T3 Libre (ECLIA)120 test70S/ 6.80S/ 0.82
KIT-ATPOKit Anti-TPO (ECLIA)60 test40S/ 9.20S/ 1.10
KIT-B12Kit Vitamina B12 (ECLIA)48 test40S/ 10.50S/ 1.26
RE-DILDiluyente hematología900 test300S/ 0.35S/ 0.04
RE-LISLisante hematología210 test300S/ 0.55S/ 0.07
IN-EDTATubo tapa lila (EDTA) 4 mL620 unid400S/ 0.35S/ 0.04
IN-GELTubo tapa amarilla (gel) 5 mL210 unid300S/ 0.42S/ 0.05
DS-CUBCubetas de reacción150 unid500S/ 0.05S/ 0.02
IN-UROTira reactiva de orina (10 par.)300 unid150S/ 0.60S/ 0.07
MC-AGARPlaca agar CLED / Mac Conkey60 placa30S/ 2.60S/ 0.31
MC-DISCDiscos de antibiograma (set)45 set20S/ 3.40S/ 0.41
DS-FRAFrasco estéril para orina240 unid100S/ 0.35S/ 0.04
CT-N2Control Bioquímica Nivel 26 vial4S/ 22.00S/ 2.64

Convenios

ConvenioTipoDescuentoCréditoUsuario B2B
Clínica en convenioLaboratorio30%clinica
Centro médico en convenioLaboratorio25%centro

Gastos operativos del mes

ConceptoCategoríaMonto
Alquiler del localLocalS/ 1,800.00
Planilla (3 personas)PersonalS/ 4,800.00
Servicios (luz, agua, internet)ServiciosS/ 620.00
Mantenimiento de equiposEquiposS/ 380.00
Controles y calibradoresCalidadS/ 290.00
Flete de reactivosLogísticaS/ 240.00

Horas al mes que hoy se van transcribiendo

Pacientes por díaHoras al mes
1017.3 h
1322.5 h
1526 h

Cómo está construido

Aplicación web que corre en el navegador, empaquetada en su propio contenedor y servida por HTTPS, sobre un servidor dedicado al laboratorio. Se entra con un enlace desde cualquier computadora, tablet o celular, sin límite de dispositivos y sin licencia por puesto.

9. Integraciones

Interfaz con los analizadores Servicio adicional al sistema

Se cotiza por equipo. Necesita mini PC, switch, cable por equipo e impresora de etiquetas. Falta: Marca y modelo exactos de cada analizador. Número de serie de cada equipo. Puerto de salida que tiene cada uno (serie o red) y si ya trae licencia de interfaz.

Consulta de identidad por DNI (RENIEC) En el alcance

Autocompletado del paciente al escribir su DNI; el paquete de consultas se contrata a nombre del laboratorio.

Facturación electrónica SUNAT En el alcance

Boletas y facturas emitidas desde el mismo cobro, opcionales por atención.

Entrega por WhatsApp y correo En el alcance

El informe validado se manda en PDF por los mismos canales que ya usan hoy.

Portal del paciente y portal B2B En el alcance

El paciente y cada convenio entran con su propio acceso a descargar informes.

Trabajo sin internet En el alcance

La operación sigue contra la mini PC del laboratorio y sincroniza cuando vuelve la conexión.

10. Qué falta levantar con el cliente

La demostración funciona con datos de trabajo. Para pasar a producción hay que cargar lo que el cliente use de verdad:

11. Glosario

Interfaz
La conexión entre el analizador y el sistema: el equipo manda el resultado y el sistema lo guarda en la orden.
ASTM / HL7
Los dos idiomas en que hablan los analizadores de laboratorio. El sistema entiende ambos.
Mini PC
La computadora pequeña que se instala en el laboratorio: escucha a los equipos y empuja los resultados al servidor.
Mapeo de pruebas
La tabla que dice que lo que el equipo llama GLU es la glucosa del catálogo.
Código de muestra
El número que va en la etiqueta del tubo y que el equipo lee para saber de quién es la muestra.
Kardex
El registro de todos los movimientos de un insumo, con su saldo y su valor después de cada uno.
Validación
La firma de la dirección técnica sobre un resultado; sin ella el informe no se publica.