Guía de Implementación Core de Costa Rica
0.1.0 - ci-build Costa Rica bandera

Guía de Implementación Core de Costa Rica - Versión en desarrollo (v0.1.0): borrador de trabajo de la Iniciativa HL7® Costa Rica, que puede cambiar sin aviso.

Registro de cambios

Estado de las normas de la página: Informative

Versión 0.1.0 (en construcción)

  • Estructura inicial de la guía: navegación, páginas en español y configuración de compilación.
  • 11 modelos lógicos, que reúne la página Modelos lógicos: paciente, persona relacionada, profesional de salud, organización, relación entre organizaciones, ubicación, servicio de salud, rol del profesional, atención, documento clínico y observación. Se generan desde el repositorio de análisis (docs/modelos-logicos/core).
  • Perfil de la organización (cr-organization), con sus invariantes y 5 ejemplos: la CCSS, un hospital de la CCSS, un establecimiento privado, un consultorio y el Ministerio de Salud.
  • Perfil de tipo de dato de la dirección (cr-address): si el país es Costa Rica, valida que provincia, cantón y distrito existan en la División Territorial Administrativa y sean concordantes.
  • Perfil de la ubicación (cr-location), con sus invariantes y 3 ejemplos: la sede de un hospital privado, su servicio de radiología y una unidad móvil de la CCSS.
  • Perfil del profesional de salud (cr-practitioner), con sus colegiaturas y especialidades, sus invariantes y 3 ejemplos (médica general, radiólogo y microbióloga), más el Colegio de Médicos y Cirujanos como organización emisora.
  • Perfil del rol del profesional (cr-practitioner-role), con sus invariantes y 5 ejemplos: la médica general en un EBAIS de la CCSS, en su consultorio y en medicina mixta, el radiólogo en un hospital privado y la microbióloga en un laboratorio clínico. Los acompañan un área de salud, un EBAIS, un laboratorio y sus sedes.
  • Perfil del servicio de salud (cr-healthcare-service), con su tipo, especialidad, modalidad de imagen DICOM, requisitos de acceso y horario, sus invariantes y 5 ejemplos: cardiología de la CCSS, emergencias 24 horas y resonancia magnética de un hospital privado, laboratorio de un área de salud y vacunación en un EBAIS.
  • Perfil de la relación entre organizaciones (cr-organization-affiliation), con el rol de HL7 y el tipo de acuerdo CR, su invariante y 3 ejemplos: un área de salud administrada por una cooperativa, la compra de estudios de imágenes de la CCSS y un laboratorio en la red de proveedores del INS.
  • Perfil del sistema de información (cr-device-sistema), el registro de los sistemas conectados al HIE, con sus invariantes y 2 ejemplos: el sistema de un laboratorio privado y el motor de transformación del nodo nacional de PH4H.
  • Los demás perfiles, con las mismas simplificaciones: el identificador del profesional y de la organización se valida por su system, con type opcional y sin slices; telecom y contact usan sus elementos nativos, sin los slices de teléfono, correo y sitio web ni el del contacto general; descripciones y definiciones en español en todos los elementos que restringen.
  • Paciente y persona relacionada simplificados para la versión 1: el identificador se valida por su system, con type opcional y sin slices; telecom sin slices; el sexo asignado al nacer va solo en gender, sin la extensión individual-recordedSexOrGender; descripciones y definiciones en español. La dirección muestra los ValueSets de provincia, cantón y distrito con un binding preferred.
  • Perfil del paciente (cr-patient), con sus identificadores y sus combinaciones admitidas, el sexo asignado al nacer, la nacionalidad, las direcciones y los contactos, sus invariantes y 5 ejemplos: costarricense adulta, extranjero residente con DIMEX, turismo médico con pasaporte, persona naturalizada y recién nacido con expediente y luego cédula.
  • Profesional de salud: valida el formato de la cédula y del DIMEX (cr-cedula-nacional-value, cr-dimex-value).
  • Perfil de la persona relacionada (cr-related-person), para el tutor legal, el progenitor de una persona menor de edad o quien firma un consentimiento, con 2 ejemplos: la madre y tutora legal y el padre de un recién nacido.
  • Perfil de la atención (cr-encounter), el contexto de la información clínica, con sus invariantes y 3 ejemplos: una consulta en un EBAIS, una hospitalización con traslado de salón y egreso, y la resonancia magnética de la IG de imágenes médicas. Los acompañan un internista con su rol y dos salones del hospital privado.
  • Servicios del HIE: CapabilityStatement de requisitos del registro de pacientes, de establecimientos y de profesionales, y del repositorio de documentos y de auditoría, basados en IHE (PDQm, PIXm, PMIR, mCSD, MHD, BALP) y adaptados a R5; parámetros de búsqueda address-district y mothers-family; página Servicios del HIE.
  • Perfil del evento de auditoría (cr-auditevent), adaptado de IHE BALP, con sus invariantes y 2 ejemplos: un acceso de emergencia a un documento restringido y un acceso denegado. Los acompañan el repositorio de documentos del HIE y el expediente de un hospital como sistemas de información.
  • Perfil de la procedencia (cr-provenance), la historia firmada de los datos que se intercambian fuera de un documento y de las operaciones del HIE, con sus invariantes y 2 ejemplos: la unión de dos registros en el MPI Nacional y la transformación de un paciente para PH4H. Los acompaña el MPI Nacional como sistema de información.
  • Perfil de la observación (cr-observation), la base común de todo resultado, con sus invariantes y 2 ejemplos del estudio de resonancia magnética: la impresión diagnóstica y la medida de una lesión.
  • Perfiles de la referencia a documento (cr-documentreference), el índice del documento en el HIE, y del envío al HIE, adaptado de IHE MHD: el lote de envío (cr-list-lote-envio) y la transacción (cr-bundle-envio-documentos). 2 ejemplos: la referencia al informe de resonancia magnética y su envío.
  • Perfiles del documento clínico: el encabezado (cr-composition), con la confidencialidad y la sensibilidad en meta.security y las versiones, y el documento completo (cr-bundle-documento), con la firma digital JAdES. 3 ejemplos: el informe de una resonancia magnética, su corrección y el documento completo firmado.
  • Las invariantes comunes de los identificadores y de las personas pasan a input/fsh/invariants/; las del sexo, la fecha de nacimiento, la nacionalidad y la residencia se llaman cr-persona-*.
  • Teléfonos: todos los perfiles los validan en formato E.164, con +506 y 8 dígitos en Costa Rica (invariante común cr-telefono).
  • Nombre (cr-human-name): admite nombres de personas de cualquier país, con letras de cualquier alfabeto, apóstrofes, guiones y puntos, sin dígitos ni otros símbolos (cr-nombre-caracteres).
  • Ubicación: el código interno no admite espacios (cr-codigo-interno-value) ni se repite (cr-identificador-unico).
  • Perfil de tipo de dato del nombre (cr-human-name) y extensiones del primer y el segundo apellido (cr-primer-apellido, cr-segundo-apellido).
  • Los títulos de los artefactos ya no terminan en "CR" (por ejemplo, "Paciente" en lugar de "Paciente CR"); los identificadores cr-* no cambian.
  • Apellidos: cada extensión (cr-primer-apellido, cr-segundo-apellido) lleva el texto del apellido (valor) y, si se conoce, su origen (origen, ValueSet cr-origen-apellido). Reemplazan a las extensiones de HL7 humanname-mothers-family y humanname-fathers-family y a la invariante cr-nombre-origen; el parámetro mothers-family busca el apellido de origen MTH.
  • Cada perfil tiene una sección "Uso en el HIE": los servicios en que participa, con sus interacciones, operaciones y parámetros de búsqueda, generada desde los CapabilityStatement (scripts/uso-hie.py); los perfiles sin servicio propio dicen cómo viajan.
  • Cada perfil documenta sus consultas (lectura, búsqueda por cada parámetro con GET y POST, creación, actualización, historial, $match y envío de documentos), agrupadas por tipo: qué hace cada una y para qué sirve, su forma con marcadores, la solicitud con valores reales de los ejemplos de la guía y cada respuesta posible por separado (incluidos los errores 404, 412 y 422), con los cuerpos JSON plegables (scripts/consultas_hie.py).
  • Ejemplos nuevos de la referencia a documento: el PDF del informe de imágenes, relacionado con su versión FHIR (transforms), y un resultado de laboratorio en PDF sin atención, con el tipo de establecimiento y el servicio. Los pacientes de los ejemplos están activos en el MPI, y el servicio de resonancia magnética indica su especialidad.
  • Firma digital del documento clínico con GAUDÍ, el gestor de firma digital del BCCR: página Firma digital, con la preparación del Bundle, el sello electrónico de la organización, la firma digital de una persona, la verificación y los códigos de GAUDÍ. En cr-bundle-documento, signature.sigFormat pasa a application/jose+json (GAUDÍ emite la serialización JSON de JWS) y signature.targetFormat es application/fhir+json.
  • Procedencia (cr-provenance): la firma también la produce GAUDÍ y es detached: cubre la procedencia y las versiones de target a través de un Bundle de trabajo que el verificador reconstruye (página Firma digital). signature.sigFormat pasa a application/jose+json, signature.targetFormat es application/fhir+json, y la invariante nueva cr-procedencia-target-version exige la versión en las referencias literales de target.
  • La firma del documento clínico pasa a ir separada del documento (detached): el Bundle (cr-bundle-documento) se guarda sin signature y con id asignado por el emisor, y cada firma es una firma del documento (cr-provenance-firma-documento, perfil nuevo) que apunta a Bundle/<id>/_history/<versión>. El envío (cr-bundle-envio-documentos) lleva el documento con PUT y sus firmas con POST (invariante cr-envio-firma-documento), y el repositorio de documentos lee versiones del documento y busca firmas por target y patient. Ejemplos nuevos: la firma del radiólogo y el sello del hospital sobre el informe de resonancia magnética. La página Firma digital trae el paso a paso con GAUDÍ: el Bundle de trabajo, el sello, la firma, la procedencia, el envío, la búsqueda y la verificación.
  • Navegación: estilo de la plantilla estándar de HL7 con los colores de FHIR (menú rojo) y el logo de FHIR, menús desplegables Guía y Artefactos FHIR, páginas Perfiles y extensiones y Ejemplos, generadas desde los artefactos (scripts/paginas-artefactos.py), y un índice Ir a al comienzo de las consultas de cada perfil.
  • Licencia y aspectos legales: remite a la licencia nacional de SNOMED CT, documentada en la guía de terminología.
  • La página de inicio reconoce a los autores de la guía y su tipo de colaboración (sección «Autores y colaboración»).