Módulo Banco de Sangre

1. Visión general

El módulo vive en src/app/pages/BancoSangre/ y modela el flujo completo de un banco de sangre: desde el registro de un disponente (donador) hasta la liberación de productos sanguíneos y su entrega a un receptor (paciente que requiere transfusión), más la administración de sedes por la Jefatura de Banco de Sangre (JefeBS).

Todas las rutas son hijas planas de PageComponent (page.routes.ts, líneas 595-653, 801, 828-829, 875). El identificador :id que viaja en casi todas las rutas es el _id del registro de banco de sangre del paciente (referido en el código como idCensur / idbancosangre / idBanco), no el _id del paciente.

Hay 38 componentes repartidos en 7 carpetas por rol:

Servicios backend principales: BancoService (src/app/services/bancodeSangre/banco.service.ts, el más usado por mucho), LaboratorioService, FlebotomiaService, SedesService y PedidosSedesService (estos dos últimos casi no se usan dentro del módulo).

2. Tabla de componentes y rutas

🩸 Flujo del DISPONENTE (donador)

🏥 Flujo del RECEPTOR (transfusión)

🏢 Jefatura Banco de Sangre / Sedes

🧪 Otros / catálogo

3. Modelo de datos / entidades clave

Los PDFs (etiquetas QR "LIBERADO"/"NO LIBERADO", etiqueta de urgencia, declaratoria responsiva) se generan en el cliente con jspdf, no por el backend.

4. Diagrama de flujo — Disponente (donador)

flowchart TD
    A[bitacora/disponentes\nLista de pacientes] -->|AGREGAR| B[registro/disponentes\nAlta disponente]
    A -->|ver paciente| C[ver/disponente/:id\nSelecciona Donaciones + sede]
    C -->|validacionDonacion = NUEVO/DISPONIBLE| D[autoexclusion/:id\n12 preguntas]
    C -->|proceso = FINALIZADO| X1[("❌ NO APTO\n(fin)")]
    C -->|tiene donaciones previas| H[historico/disponente/bs/:id]

    D -->|alguna respuesta = riesgo| DIF1[("🚫 DIFERIDO\n(fin)")]
    D -->|todo OK → proceso=enfermeria| E[disponentes/bitacora\nEnfermería]

    E --> F[ficha/disponente/:id\nSignos vitales]
    F -->|fuera de rango| DIF2[("🚫 DIFERIDO")]
    F -->|OK → proceso=doctor\n+ pide laboratorios| G[bitacora/consulta/disponentes\nDoctor]

    G --> I[historia/clinica/doctor/:id\nHistoria clínica]
    I -->|sección riesgo| DIF3[("🚫 DIFERIDO")]
    I -->|OK| J[hoja/evolucion/disponente/:id\nExploración + diagnóstico]

    J -->|candidato_donacion = NO| DIF4[("🚫 DIFERIDO")]
    J -->|APTO → proceso=FLEBOTOMIA| K[bitacora/flebotomia]

    K --> L[documentos/flebotomia/:id\nDatos extracción + consentimiento]
    L -->|no firma| DIF5[("🚫 Autoexclusión")]
    L -->|firma → proceso=serologia\nimprime NO LIBERADO| M[bitacora/laboratorios/disponentes]

    M --> N[hoja/servicios/laboratorio/disponentes/:id\nHub estudios]
    N --> O[grupo/rh/biometria/hematica/completa/:id\nBiometría + Grupo/RH]
    N --> P[serologia/laboratorio/disponente/:id\nSerología]

    P -->|alguna prueba REACTIVA| DIF6[("🚫 DIFERIDO 100 años\n(producto se desecha)")]
    P -->|7/7 NO REACTIVO\nproceso=FINALIZADO| Q[("✅ LIBERADO\nimprime etiqueta QR\n→ inventario")]

    Q -.-> R[bitacora/salidas/almacen\nAlmacén: salida/desecho de productos]
        

5. Diagrama de flujo — Receptor (transfusión)

flowchart TD
    A[receptores\nLista de pedidos] --> B[hojaservicios/receptor/:id\nHub del pedido]

    B --> C[documentos/receptor\nDocumentos médicos]
    B --> D["tiparcruza (Lab)\nTipar y Cruzar vs disponentes compatibles"]
    B --> E[productos/receptor\nCatálogo → carrito]
    B --> F[historico/...\nHistórico]

    E --> G[orden/productos\nPago - app-pagos-censur]
    G -->|carrito.total = 0\ncambioEstadoCensur → 'reacciones transfucionales'| H[agregar/docuemtos/recpetor/firmados\nSube consentimientos firmados]
    H --> I[("✅ Fin del proceso\n→ /")]

    J[entrega/productos/sanguineos\nEtiqueta urgencia + Declaratoria PDF] -.standalone, sin id.-> J
        

6. Diagrama de flujo — Jefatura Banco de Sangre (sedes)

flowchart TD
    A[listado/sedes/banco/sangre\nSedesbsComponent ✅] -->|tarjeta sede| B[detalle/sede/:id\nDetalleSedeComponent ⚠️]
    A -->|AGREGAR SEDE| C[agregar/sede/bs\nAgregarSedeComponent ⚠️ guardado deshabilitado]
    C -.iría a.-> A

    D[ficha/identificacion/sede ⚠️ vacío]
    E[bitacora/no-aptos ⚠️ placeholder]
    F[hoja/servicio/receptor (BS) ⚠️ placeholder]
    G[orden/servicio/receptores ⚠️ placeholder]
        

7. Casos de uso

8. Flujo end-to-end (resumen narrativo)

1. Recepción registra al disponente (registro/disponentes) → aparece en bitacora/disponentes.
2. Se abre su ficha (ver/disponente/:id), se elige el servicio "Donaciones" y una sede de origen → si es válido, pasa a autoexclusion/:id.
3. El disponente responde el cuestionario de 12 preguntas. Si hay riesgo → DIFERIDO (fin). Si no → proceso = 'enfermeria' y aparece en disponentes/bitacora.
4. Enfermería toma signos vitales (ficha/disponente/:id). Si están fuera de rango → DIFERIDO. Si no → se solicitan laboratorios (Grupo y RH, BHC, Serología), se imprimen etiquetas, proceso = 'doctor'.
5. Doctor llena la historia clínica (historia/clinica/doctor/:id, por secciones con distintos umbrales de riesgo) → si pasa, continúa a hoja/evolucion/disponente/:id (exploración física + diagnóstico). Si el diagnóstico indica candidato_donacion = 'NO' → DIFERIDO; si es 'SI' → proceso = 'FLEBOTOMIA'.
6. Flebotomía captura datos de la extracción y sube el consentimiento firmado (documentos/flebotomia/:id). Si firma → proceso = 'serologia', se imprime etiqueta "NO LIBERADO". Si no firma → autoexclusión/diferido.
7. Laboratorio revisa el hub de estudios (hoja/servicios/laboratorio/disponentes/:id) → captura Biometría + Grupo y RH (grupo/rh/biometria/hematica/completa/:id) y Serología (serologia/laboratorio/disponente/:id).
8. Si las 7 pruebas serológicas son NO REACTIVO → producto LIBERADO, se genera etiqueta QR, proceso = 'FINALIZADO', y el disponente queda automáticamente diferido 3 meses (regla estándar post-donación). Si alguna es REACTIVA → DIFERIDO permanente (100 años) y el producto se marca para desecho.
9. En paralelo, el receptor (paciente que necesita transfusión) sigue su propio flujo desde receptores → hub hojaservicios/receptor/:id → documentos, tipar/cruzar (busca disponentes/productos compatibles vía /disponentes/grupoyrh), carrito de productos, pago y documentos firmados.
10. Almacén controla la salida/desecho de los productos liberados (bitacora/salidas/almacen).
11. Jefatura BS administra las sedes afiliadas (listado/sedes/banco/sangre, detalle/sede/:id, agregar/sede/bs).

9. Hallazgos importantes (calidad / pendientes)