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.
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
·La dirección, que valida los resultados y quiere ver el dinero y el consumo de reactivos en orden.
·El tecnólogo, que hoy transcribe a mano y pasaría a solo revisar lo que mandó el equipo.
·Administración, que admite pacientes, cobra, factura y cierra la caja.
·Los convenios, que entran por su propio portal a bajar los informes de sus pacientes.
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
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.
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.
·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
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
Etiquetas
Sale una etiqueta por tubo con el código de barras de esa muestra. Es lo que el analizador va a leer.
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
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
Validación
La dirección técnica valida. Recién ahí el informe existe para el paciente.
6
Entrega
El informe se manda por WhatsApp o correo en PDF y queda publicado en el portal del paciente o del convenio.
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
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
Área
Marca y modelo
Protocolo
Conexión
Pruebas
Analizador de bioquímica
Bioquímica
Por confirmar / Por confirmar
ASTM E1381 / E1394
Serie RS-232
9
Analizador de hematología
Hematología
Por confirmar / Por confirmar
HL7 v2.3.1
Red TCP/IP
5
Mapeo de pruebas equipo → sistema
Equipo
Código del equipo
Analito del sistema
Analizador de bioquímica
GLU
GLU
Analizador de bioquímica
CHOL
CHOL
Analizador de bioquímica
HDL-C
HDL
Analizador de bioquímica
LDL-C
LDL
Analizador de bioquímica
TRIG
TRIG
Analizador de bioquímica
TGO
TGO
Analizador de bioquímica
TGP
TGP
Analizador de bioquímica
UREA
URE
Analizador de bioquímica
CREA
CREA
Analizador de hematología
WBC
WBC
Analizador de hematología
RBC
RBC
Analizador de hematología
HGB
HGB
Analizador de hematología
HCT
HCT
Analizador de hematología
PLT
PLT
Lo que hace falta para conectar los equipos
Pieza
Para qué
Mini PC en el laboratorio
Corre el agente que escucha a los equipos y los ordena antes de enviarlos.
Switch de red
Los dos equipos y la mini PC en la misma red, cada uno con su cable.
Cable serie o de red por equipo
Depende del puerto que tenga cada analizador.
Túnel SSH al servidor
La mini PC empuja los resultados al sistema; si se cae internet, los guarda y los manda cuando vuelve.
Impresora de etiquetas
Cada 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ódigo
Examen
Área
Método
Precio
BIO001
Glucosa en ayunas
Bioquímica
Enzimático (GOD-PAP)
S/ 18.00
BIO002
Perfil Lipídico
Bioquímica
Enzimático colorimétrico
S/ 45.00
BIO003
Perfil Hepático
Bioquímica
Cinético UV / colorimétrico
S/ 55.00
BIO007
Perfil Renal
Bioquímica
Cinético / enzimático
S/ 50.00
BIO010
Calcio sérico
Bioquímica
Colorimétrico (Arsenazo III)
S/ 20.00
HEM001
Hemograma Completo Automatizado
Hematología
Impedancia + fotometría
S/ 25.00
HOR001
TSH ultrasensible
Inmunoensayo
ECLIA
S/ 38.00
HOR002
T4 Libre
Inmunoensayo
ECLIA
S/ 42.00
HOR003
T3 Libre
Inmunoensayo
ECLIA
S/ 42.00
HOR004
Anti-TPO
Inmunoensayo
ECLIA
S/ 55.00
HOR006
Vitamina B12
Inmunoensayo
ECLIA
S/ 60.00
URO001
Examen Completo de Orina
Uroanálisis
Tira reactiva + microscopía
S/ 15.00
MIC001
Urocultivo
Microbiología
Cultivo + antibiograma
S/ 40.00
Perfiles (3)
Perfil
Incluye
Precio
Perfil Control
3 exámenes
S/ 65.00
Perfil Tiroideo
3 exámenes
S/ 105.00
Perfil Metabólico
3 exámenes
S/ 98.00
Margen por examen (mostrador y convenio)
Examen
Costo puesto
Mostrador
Queda
Convenio −30%
Queda
Glucosa en ayunas
S/ 1.88
S/ 18.00
S/ 16.12 (89.55555555555557%)
S/ 12.60
S/ 10.72 (85.07936507936509%)
Perfil Lipídico
S/ 10.72
S/ 45.00
S/ 34.28 (76.17777777777778%)
S/ 31.50
S/ 20.78 (65.96825396825398%)
Perfil Hepático
S/ 11.51
S/ 55.00
S/ 43.49 (79.07272727272728%)
S/ 38.50
S/ 26.99 (70.1038961038961%)
Perfil Renal
S/ 9.48
S/ 50.00
S/ 40.52 (81.04%)
S/ 35.00
S/ 25.52 (72.91428571428571%)
Calcio sérico
S/ 2.22
S/ 20.00
S/ 17.78 (88.9%)
S/ 14.00
S/ 11.78 (84.14285714285714%)
Hemograma Completo Automatizado
S/ 1.40
S/ 25.00
S/ 23.60 (94.4%)
S/ 17.50
S/ 16.10 (92%)
TSH ultrasensible
S/ 7.71
S/ 38.00
S/ 30.29 (79.71052631578948%)
S/ 26.60
S/ 18.89 (71.01503759398497%)
T4 Libre
S/ 8.16
S/ 42.00
S/ 33.84 (80.57142857142858%)
S/ 29.40
S/ 21.24 (72.24489795918367%)
T3 Libre
S/ 8.16
S/ 42.00
S/ 33.84 (80.57142857142858%)
S/ 29.40
S/ 21.24 (72.24489795918367%)
Anti-TPO
S/ 10.84
S/ 55.00
S/ 44.16 (80.29090909090908%)
S/ 38.50
S/ 27.66 (71.84415584415585%)
Vitamina B12
S/ 12.30
S/ 60.00
S/ 47.70 (79.5%)
S/ 42.00
S/ 29.70 (70.71428571428571%)
Examen Completo de Orina
S/ 1.06
S/ 15.00
S/ 13.94 (92.93333333333334%)
S/ 10.50
S/ 9.44 (89.9047619047619%)
Urocultivo
S/ 7.11
S/ 40.00
S/ 32.89 (82.22500000000001%)
S/ 28.00
S/ 20.89 (74.60714285714286%)
Reactivos e insumos (21)
Código
Insumo
Stock
Mínimo
Costo
Flete
RE-GLU
Reactivo Glucosa (GOD-PAP)
310 test
150
S/ 1.20
S/ 0.14
RE-COL
Reactivo Colesterol (CHOD-PAP)
108 test
120
S/ 1.80
S/ 0.22
RE-TRIG
Reactivo Triglicéridos (GPO-PAP)
180 test
100
S/ 1.90
S/ 0.23
RE-HDL
Reactivo HDL/LDL directo
150 test
100
S/ 2.60
S/ 0.31
RE-HEP
Reactivos hepáticos (TGO/TGP/BIL/FA)
120 test
90
S/ 2.40
S/ 0.29
RE-REN
Reactivos renales (Urea/Crea/Ác. úrico)
95 test
100
S/ 2.10
S/ 0.25
RE-CA
Reactivo Calcio (Arsenazo III)
140 test
80
S/ 1.50
S/ 0.18
KIT-TSH
Kit TSH ultrasensible (ECLIA)
180 test
80
S/ 6.40
S/ 0.77
KIT-T4
Kit T4/T3 Libre (ECLIA)
120 test
70
S/ 6.80
S/ 0.82
KIT-ATPO
Kit Anti-TPO (ECLIA)
60 test
40
S/ 9.20
S/ 1.10
KIT-B12
Kit Vitamina B12 (ECLIA)
48 test
40
S/ 10.50
S/ 1.26
RE-DIL
Diluyente hematología
900 test
300
S/ 0.35
S/ 0.04
RE-LIS
Lisante hematología
210 test
300
S/ 0.55
S/ 0.07
IN-EDTA
Tubo tapa lila (EDTA) 4 mL
620 unid
400
S/ 0.35
S/ 0.04
IN-GEL
Tubo tapa amarilla (gel) 5 mL
210 unid
300
S/ 0.42
S/ 0.05
DS-CUB
Cubetas de reacción
150 unid
500
S/ 0.05
S/ 0.02
IN-URO
Tira reactiva de orina (10 par.)
300 unid
150
S/ 0.60
S/ 0.07
MC-AGAR
Placa agar CLED / Mac Conkey
60 placa
30
S/ 2.60
S/ 0.31
MC-DISC
Discos de antibiograma (set)
45 set
20
S/ 3.40
S/ 0.41
DS-FRA
Frasco estéril para orina
240 unid
100
S/ 0.35
S/ 0.04
CT-N2
Control Bioquímica Nivel 2
6 vial
4
S/ 22.00
S/ 2.64
Convenios
Convenio
Tipo
Descuento
Crédito
Usuario B2B
Clínica en convenio
Laboratorio
30%
sí
clinica
Centro médico en convenio
Laboratorio
25%
sí
centro
Gastos operativos del mes
Concepto
Categoría
Monto
Alquiler del local
Local
S/ 1,800.00
Planilla (3 personas)
Personal
S/ 4,800.00
Servicios (luz, agua, internet)
Servicios
S/ 620.00
Mantenimiento de equipos
Equipos
S/ 380.00
Controles y calibradores
Calidad
S/ 290.00
Flete de reactivos
Logística
S/ 240.00
Horas al mes que hoy se van transcribiendo
Pacientes por día
Horas al mes
10
17.3 h
13
22.5 h
15
26 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:
·Marca, modelo y número de serie de los dos analizadores (bioquímica y hematología).
·Nombre comercial, razón social, RUC y dirección del laboratorio para los comprobantes.
·Logo y colores oficiales.
·Precios reales del catálogo y tarifas de los convenios.
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.