Sección 01
Visión General
El módulo de Banco de Sangre gestiona dos flujos principales e independientes que comparten infraestructura de laboratorio y almacén:
🩸 Flujo Disponente Donador
Proceso completo desde el registro inicial hasta el almacenamiento de hemocomponentes procesados y disponibles para surtido.
BancoSangre🏥 Flujo Receptor CENSUR
Solicitud de productos sanguíneos, tipar y cruzar, pedido a sede, cobro y vigilancia de reacciones transfusionales.
BancoSangreSocios| Flujo | Actor Principal | Modelo Central | Descripción |
|---|---|---|---|
| Disponente | Donador de sangre | BancoSangre |
Proceso completo desde registro hasta almacenamiento de hemocomponentes |
| Receptor / CENSUR | Receptor de sangre | BancoSangreSocios |
Solicitud, tipar y cruzar, entrega de productos sanguíneos |
Sección 02
Modelos de Datos
1. BancoSangre — Expediente del Disponente
models/bancoDeSangre/modelBancoSangre.js
| Campo | Tipo | Referencia | Descripción |
|---|---|---|---|
paciente | ObjectId | Paciente | Paciente/donador |
cuestionarioautoexclusion | ObjectId | modelCuestioExclusion | Cuestionario de autoexclusión |
signosvitales | ObjectId | SignosVitalesBS | Talla, peso, IMC, T/A |
historiaclinica | ObjectId | HistoriaClinicaBS | Historia clínica completa |
hojaevolucion | ObjectId | hojaEvolucionBS | Exploración física del médico |
reaccionesderivadas | ObjectId | ReaccionesDerivadasBS | Reacciones durante la donación |
flebotomia | ObjectId | FlebotomiaBS | Datos de la extracción de sangre |
laboratorio | [ObjectId] | LaboratorioBS | Estudios de laboratorio |
almacen | [ObjectId] | productosAlmacenStock | Hemocomponentes generados |
proceso | String | — | NUEVO · ENFERMERIA · DOCTOR · FLEBOTOMIA · SEROLOGIA · FINALIZADO |
estatus | String | — | DISPONIBLE · DIFERIDO · EN PROCESO |
motivo | String | — | Motivo de diferimiento |
tiempo_rechazo | String | — | Fecha de diferimiento |
fecha_termino | Date | — | Fecha en que termina el periodo de diferimiento |
2. BancoSangreSocios — Expediente del Receptor (CENSUR)
models/bancoDeSangre/modelBancoSangreTercero.js
| Campo | Tipo | Referencia | Descripción |
|---|---|---|---|
paciente | ObjectId | Paciente | Paciente receptor |
receptor | ObjectId | DocumentosBS | Documentos del receptor |
pedido | ObjectId | pedidosSedesBanco | Orden de pedido de hemocomponentes |
tiparycruzar | [ObjectId] | LaboratorioBS | Estudios de tipo y cruce |
proceso_censur | ObjectId | BancoSangreSociosProcesos | Seguimiento de procesos (4 etapas) |
ventaCensur | [ObjectId] | carritoCensur | Venta/cobro de productos |
tipo_producto | String | — | Tipo de producto solicitado |
estatus | String | — | RECEPTOR · REACCIONES TRANSFUCIONALES |
huboReaccionAdversa | String | — | SI / NO |
SignosVitalesBS
modelSignosVitales.js| Campo | Tipo | Descripción |
|---|---|---|
talla | Number | Altura en cm |
peso | Number | Peso en kg |
imc | Number | Índice de masa corporal |
temp | Number | Temperatura |
sistolica | Number | Presión sistólica |
diastolica | Number | Presión diastólica |
huellasMultiples | String | Huellas venopunción múltiples |
huellasRecientes | String | Huellas venopunción recientes |
FlebotomiaBS
modelFlebotomia.js| Campo | Descripción |
|---|---|
bancodesangre | Ref a BancoSangre |
disponente | Ref a DocumentosBS |
tipo_de_sangreado | Tipo de extracción |
tipo_de_donador | Altruista, reposición, etc. |
volumen | Volumen extraído |
tiempo | Tiempo de extracción |
LaboratorioBS
modelLaboratorio.js · polimórfico| Uso | Campo ref |
|---|---|
| Biometría Hemática | laboratorio → BancoSangre |
| Grupo y RH | laboratorio → BancoSangre |
| Serología | laboratorio → BancoSangre |
| Tipo y Cruce | tiparycruzar → BancoSangreSocios |
hojaEvolucionBS
modelHojaEvolucion.js| Campo | Descripción |
|---|---|
piel, mucosas, torax | Hallazgos por aparato |
abdomen, higado, bazo | Hallazgos por aparato |
ganglios | Hallazgos ganglionares |
candidato_donacion | Aprobación médica |
cie10 | Diagnóstico CIE-10 |
5. HistoriaClinicaBS
models/bancoDeSangre/modelHistoriaClinica.js
Más de 80 campos cubriendo todas las áreas clínicas relevantes para la donación de sangre:
| Área | Contenido |
|---|---|
| Infecciosos | Hepatitis, VIH, COVID, paludismo, Chagas, sífilis, brucelosis |
| Quirúrgicos / Médicos | Cirugías, transfusiones previas, enfermedades crónicas |
| Medicamentos | Anticoagulantes, retinoides, hormonas, antibióticos |
| Conductas de riesgo | Tatuajes recientes, perforaciones, uso de drogas |
| Ginecobstétricos | Embarazo, lactancia, menstruación, fecha última regla |
13. Modelos Auxiliares
| Modelo | Archivo | Descripción |
|---|---|---|
almacenProductos | models/warehouse/modelProductos.js | Catálogo admin de productos/materiales |
productosAlmacenStock | models/almacen/stock/modelProductosStock.js | Unidades individuales en stock (con QR) |
carritoCensur | models/almacen/stock/carritoCensur.js | Cobro/venta de productos a receptores |
DocumentosBS | models/bancoDeSangre/modelDocumentos.js | Archivos digitales del disponente/receptor |
EstudiosLabBS | models/bancoDeSangre/modelEstudios.js | Catálogo de estudios de laboratorio |
TipeyCruceBS | models/bancoDeSangre/modelTipeyCruce.js | Resultados de tipo y cruce |
proveedoresBS | models/almacen/proveedores/porveedorModel.js | Proveedores de insumos |
cSeguimiento | models/almacen/modelSeguimiento.js | Seguimientos interdepartamentales |
serviciosCensur | models/almacen/modelServicios.js | Catálogo de servicios de CENSUR |
Sección 03
APIs por Módulo
📁
bancosangre.js — Expediente Principal del Disponente
18 endpoints| Método | Endpoint | Descripción |
|---|---|---|
| POST | /bancodesangre | Crear nuevo expediente de banco de sangre para un paciente |
| PUT | /agregar/procesobancodesangre | Actualizar proceso, estatus, motivo y fecha_termino |
| GET | /getdisponente/:id | Obtener expediente completo por ID de banco de sangre |
| GET | /getdisponente/por/paciente/:id | Obtener expediente completo por ID de paciente |
| GET | /disponentes | Listar todos los disponentes con todos sus datos |
| POST | /diferir/disponente | Marcar disponente como DIFERIDO con motivo |
| GET | /orden/receptores | Listar órdenes con estatus RECEPTOR |
| GET | /orden/receptor/:id | Obtener una orden de receptor por ID |
| GET | /disponentes/contar | Conteo total de expedientes |
| POST | /disponente/visitas | Contar donaciones FINALIZADAS de un paciente |
| POST | /getdisponente/visitas | Contar todas las visitas de un paciente |
| POST | /disponentes/grupoyrh | Buscar disponentes por tipo de sangre, agrupados por hemocomponente |
| POST | /disponentes/diferidos | Listar diferidos de un paciente |
| GET | /historico/disponentes/diferidos | Histórico global de diferidos |
| POST | /historico/banco/disponente | Histórico de donaciones de un paciente con flebotomía |
| GET | /historico/disponente/bs/:id | Detalle de un expediente histórico |
| POST | /verificar/disponente | Verificar si un paciente tiene expedientes previos |
| GET | /bancos | Listar todos los expedientes (sin populate) |
| POST | /bancos/usuario/nodonacion | Verificar si el disponente tiene proceso FINALIZADO o es primera vez |
📁
receptor.js — Flujo del Receptor (CENSUR)
24 endpoints| Método | Endpoint | Descripción |
|---|---|---|
| POST | /censur | Crear expediente de receptor y proceso de seguimiento |
| POST | /receptor/documentos | Agregar documentos al expediente del receptor |
| PUT | /actualizar/receptor/documentos/:id | Actualizar documentos del receptor |
| POST | /documentos/censur | Guardar documentos y vincular a CENSUR |
| POST | /cargar/documentos/censur | Subir documentos a AWS S3 |
| POST | /ordenarpedido/censur | Crear orden de pedido de hemocomponentes a sede |
| GET | /productos/censur | Obtener stock de los 4 productos principales de BS |
| POST | /receptores | Listar receptores por sede |
| POST | /informacion/receptor/pedido | Detalle de productos en tipo y cruce |
| POST | /informacion/receptor | Información completa de un expediente CENSUR |
| POST | /ordenar/tipeycruce | Crear orden de tipo y cruce para receptor |
| POST | /procesos/orden/censur | Ver procesos de seguimiento de una orden |
| POST | /procesos/documentos/receptor | Ver proceso de documentos |
| POST | /procesos/tipar/cruzar | Ver proceso de tipar y cruzar |
| POST | /procesos/historico/documento | Ver proceso de histórico |
| POST | /procesos/entrega/productos | Ver proceso de entrega |
| GET | /productos/materiales/servicios/censur | Listar productos con laboratorio CENSUR |
| PUT | /actulizar/estado/pedido/censur/:id | Actualizar estatus de pedido |
| PUT | /actulizar/estado/recpetor/censur/:id | Actualizar estatus del receptor |
| GET | /ver/pedidos/detalle/:id | Ver detalle de un pedido y datos del paciente |
| GET | /reacciones/transfucionales | Listar receptores con reacciones transfusionales |
| PUT | /agregar/documentos/banco/sangres/socios/:id | Actualizar datos del expediente CENSUR |
| POST | /agregar/documentos/receptor | Guardar documentos de reacciones del receptor |
| GET | /ver/documentos/receptor/:idCensur | Obtener documentos de un receptor |
📁
almacen.js — Almacén de Productos y Materiales
21 endpoints| Método | Endpoint | Descripción |
|---|---|---|
| GET | /minialmacen | Listar productos activos |
| GET | /count/total/productos | Contar total de productos en catálogo |
| GET | /actualizar/status/etiqueta/:id | Marcar etiqueta como descargada |
| POST | /agregar/productos/almacen | Crear producto en catálogo admin |
| GET | /ver/todos/productos/almacen | Listar productos activos tipo PRODUCTO |
| GET | /ver/producto/almacen/por/id/:id | Obtener producto del catálogo por ID |
| PUT | /actualizar/productos/costo/:id | Actualizar costo de un proveedor en producto |
| PUT | /actualizar/productos/stock/almacen/:id | Actualizar unidad de stock por ID |
| GET | /ver/productos/almacen/por/id/:id | Obtener unidades en stock de un producto |
| GET | /ver/productos/salidas | Listar unidades marcadas para desecho |
| PUT | /actualizar/productos/almacen/:id | Actualizar datos de producto en catálogo |
| POST | /agregar/productos/almacen/stock | Ingresar N unidades al stock con QR automático |
| GET | /vender/producto/stock/:id | Marcar unidad como VENDIDA (vía QR) |
| POST | /vender/producto/stock/:id | Marcar unidad como VENDIDA (vía API) |
| GET | /obtener/todos/produtos/stock | Listar todo el stock ordenado por caducidad |
| GET | /desactivar/producto/almacen/:id | Desactivar producto del catálogo |
| POST | /agregar/nuevo/material/banco/sangre | Crear nuevo material en catálogo |
| GET | /ver/materiales/all | Listar todos los materiales |
| POST | /buscar/nombre/productos/materiales | Buscar por nombre en productos y materiales |
| GET | /buscar/materiales/banco/sangre/:id | Buscar material por ID |
| GET | /materiales/banco/sangre | Listar materiales activos |
| GET | /count/all/materiales/:token | Contar materiales activos |
📁
laboratorio.js — Estudios de Laboratorio
16 endpoints| Método | Endpoint | Descripción |
|---|---|---|
| POST | /nuevo/estudio/banco | Crear tipo de estudio en el catálogo |
| GET | /obtener/estudio/banco/:id | Obtener un tipo de estudio por ID |
| PUT | /actualizar/estudios | Actualizar valores de referencia de un estudio |
| PUT | /proceso/laboratorio | Cambiar estatus del proceso de laboratorio |
| GET | /todos/estudio | Listar todos los estudios del catálogo |
| POST | /analisis/estudios | Registrar biometría hemática y vincular al expediente |
| POST | /analisis/grupo | Registrar grupo y RH, actualizar tipo de sangre del paciente |
| POST | /analisis/serologia | Registrar serología y generar hemocomponentes en stock con QR |
| POST | /analisis/tipeycruce | Registrar tipo y cruce para un receptor (CENSUR) |
| POST | /pedido/laboratorio/:id | Obtener pedido de laboratorio por ID |
| GET | /obtener/banco/banco/:id | Obtener expediente bancario con datos del paciente |
| GET | /hoja/servicio/laboratorio/:id | Hoja de servicio con paciente, laboratorio y flebotomía |
| POST | /laboratorios/doctor | Listar laboratorios de un expediente con resultados |
| POST | /laboratorios/servicios/proceso | Obtener estatus de estudios de un expediente |
| PUT | /actualizar/analisis/estudios | Actualizar resultados de biometría por el médico |
| POST | /pedido/laboratorio | Listar laboratorios de un expediente |
| GET | /lab | Listar todos los expedientes bancarios |
📁
flebotomia.js
4 endpoints| Método | Endpoint | Descripción |
|---|---|---|
| GET | /flebotomia/:id | Obtener datos del expediente con signosvitales y laboratorio |
| GET | /flebotomia/prueba/algo | Job: actualizar disponentes cuyo diferimiento terminó |
| GET | /ver/lista/disponentes/disponibles | Listar disponentes con estatus DISPONIBLE |
| POST | /flebotomia | Registrar extracción de sangre y vincular al expediente |
📁
carritoCensur.js — Cobro a Receptores
5 endpoints| Método | Endpoint | Descripción |
|---|---|---|
| POST | /agergar/carrito/censur | Crear venta con métodos de pago mixtos y folio automático |
| GET | /ver/carritos/cesnur | Listar todas las ventas |
| GET | /carrito/censur/unico/:id | Obtener una venta por ID |
| DELETE | /eliminar/carrito/censur/:id | Eliminar una venta |
| PUT | /actualizar/carrito/products/:id | Actualizar datos de una venta |
📁
Módulos Complementarios
24 endpoints| Archivo | Método | Endpoint | Descripción |
|---|---|---|---|
autoexclusion.js | POST | /cuestionario/autoexclusion | Guardar 13 preguntas de autoexclusión |
signosvitales.js | POST | /agregar/signosvitales | Registrar talla, peso, IMC, T/A |
| PUT | /actualizar/religion | Actualizar religión del paciente | |
| PUT | /actualizar/tipoSangre/paciente | Actualizar tipo de sangre | |
historiaclinica.js | POST | /agregar/historiaclinica | Guardar historia clínica (80+ campos) |
hojaevolucion.js | POST | /agregar/hojadeevolucion | Registrar exploración física |
disponente.js | PUT | /agregar/lugardeorigen | Actualizar lugar de origen |
| PUT | /agregar/productodeorigen | Actualizar tipo de donante | |
| POST | /ordenar/laboratorios | Crear orden de laboratorio | |
reaccionesderivadas.js | POST | /agregar/reaccionesderivadas | Registrar reacciones durante la donación |
bitacoras.js | GET | /bitacora/enfermeria | Disponentes en proceso enfermería |
| GET | /bitacora/doctor | Disponentes en proceso médico | |
| GET | /bitacora/flebotomia | Disponentes en proceso flebotomía | |
| GET | /bitacora/laboratorio | Disponentes en proceso laboratorio | |
| GET | /bitacora/almacen | Todos los disponentes con hemocomponentes | |
proveedores.js | POST | /registro/proveedor | Registrar nuevo proveedor |
| GET | /ver/proveedores | Listar proveedores activos | |
| GET | /ver/proveedor/por/id/:id | Obtener proveedor por ID | |
| PUT | /actualizar/proveedor/:id | Actualizar datos de proveedor | |
| GET | /desactivar/proveedor/por/id/:id | Desactivar proveedor | |
sedes.js | POST | /crear/sede/bs | Registrar nueva sede |
| GET | /listado/sedes/banco/sangre/ | Listar todas las sedes | |
| GET | /detalle/sede/:id | Detalle de una sede | |
| GET | /ver/sede | Sedes ordenadas por responsable | |
| GET | /ver/sedes/:id | Pedidos de una sede | |
jefeabanco.js | GET | /gethistorico/:id | Histórico completo de donaciones |
routesSeguimientos.js | POST | /crear/nuevo/seguimiento | Crear seguimiento entre departamentos |
| GET | /ver/seguimientos/creados | Listar todos los seguimientos | |
| PUT | /actualizar/seguimiento/:id | Actualizar seguimiento | |
| DELETE | /eliminar/seguimiento/:id | Eliminar seguimiento | |
serviciosBS.js | POST | /agregar/servicio/censur | Crear servicio en catálogo CENSUR |
| GET | /ver/servicios/censur | Listar todos los servicios | |
| GET | /ver/folio/servicios | Obtener número de folio | |
| GET | /ver/servicio/banco/sangre/:id | Obtener servicio activo por ID |
Sección 04
Casos de Uso
CU-01
Registro y Proceso de Donación
👤 Enfermera · Médico · Flebotomista · Laboratorista
- 1 Paciente llega al banco de sangre
- 2 Enfermería crea el expediente
POST /bancodesangre - 3 Registra autoexclusión
POST /cuestionario/autoexclusion - 4 Toma signos vitales
POST /agregar/signosvitales - 5 Médico revisa historia clínica
POST /agregar/historiaclinica - 6 Médico realiza exploración física
POST /agregar/hojadeevolucion - 7 Médico aprueba candidato a donación
- 8 Técnico registra extracción
POST /flebotomia - 9 Laboratorio procesa biometría
POST /analisis/estudios - 10 Determina grupo y RH
POST /analisis/grupo - 11 Serología → genera hemocomponentes con QR
POST /analisis/serologia - 12 Proceso FINALIZADO, estatus DISPONIBLE
CU-02
Diferimiento de Disponente
👤 Médico
- 1 Médico evalúa al disponente
- 2 Decide diferir con motivo clínico
POST /diferir/disponente - 3 El disponente queda inactivo (DIFERIDO)
- 4 Se consulta histórico
GET /historico/disponentes/diferidos - 5 Job revisa fecha_termino y reactiva
GET /flebotomia/prueba/algo
CU-03
Búsqueda por Tipo de Sangre
👤 Laboratorista · Jefe de Banco
- 1 Solicitar sangre compatible
POST /disponentes/grupoyrh - 2 Sistema filtra pacientes con ese tipo de sangre
- 3 Clasifica hemocomponentes: CE · CP · PL · PT
- 4 Ordena por fecha de caducidad PEPS
- 5 Retorna el más próximo a caducar primero
CU-04
Solicitud de Sangre — Receptor CENSUR
👤 Personal CENSUR · Laboratorista
- 1 Crear expediente receptor
POST /censur - 2 Cargar documentos médicos
POST /receptor/documentos - 3 Ordenar tipo y cruce
POST /ordenar/tipeycruce - 4 Laboratorio registra tipo y cruce
POST /analisis/tipeycruce - 5 Generar pedido a sede
POST /ordenarpedido/censur - 6 Registrar cobro mixto
POST /agergar/carrito/censur - 7 Marcar unidades VENDIDAS
GET /vender/producto/stock/:id
CU-05
Gestión de Almacén
👤 Almacenista · Laboratorista
- 1 Serología genera unidades en stock con QR automático
- 2 Ver stock
GET /obtener/todos/produtos/stock - 3 Ordenado por fecha_caducidad ASC (PEPS)
- 4 Gestionar desechos
GET /ver/productos/salidas - 5 Ingresar materiales
POST /agregar/nuevo/material/banco/sangre
CU-06
Reacciones Adversas
👤 Técnico de Flebotomía · Médico
- 1 Reacción ocurre durante la extracción
- 2 Técnico registra: vasovagal/venopunción/citrato
POST /agregar/reaccionesderivadas - 3 Médico registra tratamiento
- 4 Para receptor: actualizar estatus REACCIONES TRANSFUCIONALES
- 5 Listar casos
GET /reacciones/transfucionales
CU-07
Gestión de Sedes Proveedoras
👤 Administrador
- 1 Registrar nueva sede
POST /crear/sede/bs - 2 Ver listado
GET /listado/sedes/banco/sangre/ - 3 Ver pedidos de una sede
GET /ver/sedes/:id - 4 Gestionar proveedores de insumos
POST /registro/proveedor
Sección 05
Diagramas de Flujo
Flujo Completo del Disponente
PACIENTE
│
▼
┌─────────────────────────────────────────────────────────┐
│ ENFERMERÍA │
│ ├── POST /bancodesangre ← Crear expediente│
│ ├── POST /cuestionario/autoexclusion ← 13 preguntas │
│ └── POST /agregar/signosvitales ← Talla, peso,T/A│
└─────────────────────────────────────────────────────────┘
│ (proceso: DOCTOR)
▼
┌─────────────────────────────────────────────────────────┐
│ MÉDICO │
│ ├── POST /agregar/historiaclinica ← 80+ campos │
│ ├── POST /agregar/hojadeevolucion ← Exploración │
│ └── Decisión: │
│ ├── APTO → PUT /agregar/procesobancodesangre │
│ └── NO APTO → POST /diferir/disponente │
└─────────────────────────────────────────────────────────┘
│ (proceso: FLEBOTOMIA)
▼
┌─────────────────────────────────────────────────────────┐
│ TÉCNICO DE FLEBOTOMÍA │
│ └── POST /flebotomia ← Registrar │
└─────────────────────────────────────────────────────────┘
│ (proceso: LABORATORIO)
▼
┌─────────────────────────────────────────────────────────┐
│ LABORATORISTA │
│ ├── POST /analisis/estudios ← Biometría │
│ ├── POST /analisis/grupo ← Grupo y RH │
│ └── POST /analisis/serologia ← Serología + QR │
└─────────────────────────────────────────────────────────┘
│ (estatus: DISPONIBLE)
▼
┌─────────────────────────────────────────────────────────┐
│ ALMACÉN — Hemocomponentes disponibles │
│ ┌────┐ ┌────┐ ┌────┐ ┌────┐ │
│ │ CE │ │ CP │ │ PL │ │ PT │ │
│ └────┘ └────┘ └────┘ └────┘ │
│ Eritrocitario Plaquetario Plasma Plaquetas │
└─────────────────────────────────────────────────────────┘
Flujo del Receptor (CENSUR)
RECEPTOR
│
▼
┌─────────────────────────────────────────────────────────┐
│ PERSONAL CENSUR │
│ ├── POST /censur ← Expediente + procesos │
│ ├── POST /receptor/documentos ← Documentos médicos │
│ └── POST /ordenar/tipeycruce ← Solicitar T y C │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ LABORATORIO │
│ └── POST /analisis/tipeycruce ← Procesar tipo y cruce │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ PERSONAL CENSUR │
│ └── POST /ordenarpedido/censur ← Pedido a sede │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ SEDE BANCO DE SANGRE │
│ └── Procesa y entrega hemocomponentes │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ CAJA / COBRO │
│ ├── POST /agergar/carrito/censur ← Cobro mixto │
│ └── GET /vender/producto/stock/:id ← VENDIDA (QR) │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ MONITOREO │
│ └── GET /reacciones/transfucionales ← Vigilancia │
└─────────────────────────────────────────────────────────┘
Bitácoras por Área
| Área | Endpoint | Filtra por |
|---|---|---|
| 🏥 Enfermería | GET /bitacora/enfermeria | proceso: 'enfermeria' |
| ⚕️ Médico | GET /bitacora/doctor | proceso: 'doctor' |
| 🩸 Flebotomía | GET /bitacora/flebotomia | proceso: 'FLEBOTOMIA' |
| 🔬 Laboratorio | GET /bitacora/laboratorio | proceso: 'DOCTOR' | 'SEROLOGIA' |
| 📦 Almacén | GET /bitacora/almacen | Todos (con almacen) |
Sección 06
Diagrama de Relaciones entre Modelos
┌──────────────────┐
│ Paciente │
│ (nuevoPaciente) │
└────────┬─────────┘
│ 1 : N
┌──────────────────┴──────────────────┐
│ │
▼ ▼
┌─────────────────┐ ┌──────────────────────┐
│ BancoSangre │ │ BancoSangreSocios │
│ (Disponente) │ │ (Receptor/CENSUR) │
└────────┬────────┘ └──────────┬───────────┘
│ │
┌──────────┴──────────────────┐ ┌─────────────┴────────────────────┐
│ │ │ │
▼ ▼ ▼ ▼
┌───────────────┐ ┌───────────────────────┐ ┌──────────────────────────┐
│ modelCuestio │ │ LaboratorioBS │ │ BancoSangreSociosProcesos│
│ Exclusion │ │ (polimórfico) │ │ (4 etapas seguimiento) │
│ (13 preguntas)│ │ │ └──────────────────────────┘
└───────────────┘ └────────────┬───────────┘ ┌──────────────────────────┐
┌───────────────┐ │ doble uso │ pedidosSedesBanco │
│ SignosVitalesBS│ ├──────────────── │ │
└───────────────┘ Disponente BS └──────────────────────────┘
┌───────────────┐ (via laboratorio field) ┌──────────────────────────┐
│HistoriaClinica│ │ carritoCensur │
│ BS │ Receptor BS │ (cobro / venta) │
└───────────────┘ (via tiparycruzar) └──────────────────────────┘
┌───────────────┐
│ hojaEvolucion │
│ BS │
└───────────────┘
┌───────────────┐ ┌────────────────────────┐
│ Reacciones │ │ almacenProductos │
│ DerivadasBS │ │ (Catálogo admin) │
└───────────────┘ └──────────┬─────────────┘
┌───────────────┐ │ 1 : N
│ FlebotomiaBS │ ▼
└───────────────┘ ┌────────────────────────┐
┌───────────────┐ │ productosAlmacenStock │
│ productos │ │ (Unidades en stock │
│ AlmacenStock │◄────────│ con código QR) │
│ (QR) │ └────────────────────────┘
└───────────────┘
Modelos de catálogo / soporte:
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ EstudiosLabBS │ │ Sedesbs │ │ proveedoresBS │
│ (tipos estudio) │ │ (sedes banco) │ │ (insumos) │
└──────────────────┘ └──────────────────┘ └──────────────────┘
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ DocumentosBS │ │ TipeyCruceBS │ │ cSeguimiento │
│ (archivos disp./ │ │ (tipo y cruce) │ │ (inter-dep.) │
│ receptor) │ │ │ │ │
└──────────────────┘ └──────────────────┘ └──────────────────┘
┌──────────────────┐
│ serviciosCensur │
│ (catálogo CENSUR)│
└──────────────────┘
Sección 07
Resumen de Endpoints por Módulo
Total de endpoints documentados
122
Sección 08
Notas Técnicas
📲 Generación de Código QR
Al ingresar productos al stock y al finalizar serología, el sistema genera automáticamente un código QR por unidad apuntando a GET /vender/producto/stock/:id. Librería: qrcode.
🔢 Lote Unitario Secuencial
Cada unidad de stock recibe un lote_unitario calculado contando cuántos documentos del mismo producto existen en la colección antes de guardar.
🩸 Clasificación de Hemocomponentes
Los hemocomponentes se identifican por patrón regex en lote_unitario:
/CE/i→ Concentrado Eritrocitario/CP/i→ Concentrado Plaquetario/PL/i→ Plasma/PT/i→ Plaquetas
💰 Precios Unificados
Al agregar nuevas unidades al stock, el sistema compara el precio con las unidades existentes del mismo producto y actualiza TODAS las unidades al precio más alto.
⏱️ Disponibilidad Automática
GET /flebotomia/prueba/algo actúa como job de revisión: compara fecha_termino con la fecha actual y regresa a DISPONIBLE a los disponentes diferidos cuyo tiempo expiró.
☁️ Almacenamiento en AWS S3
Los documentos del receptor se suben a AWS S3 mediante multer en el endpoint POST /cargar/documentos/censur. Las URLs resultantes se almacenan en el modelo DocumentosBS.
📐 Modelo Polimórfico LaboratorioBS
Un único modelo es usado para 4 contextos distintos. La diferenciación se hace por el campo de referencia presente: laboratorio para disponente, tiparycruzar para receptor.
📦 Ordenamiento PEPS
El stock de hemocomponentes se ordena por fecha_caducidad ASC garantizando que los productos más próximos a caducar se consuman primero (Primeras Entradas, Primeras Salidas).