Guía de OpenEHRGen v0.8

Transcripción

1 Guía de OpenEHRGen v0.8 Generador de Sistemas de Historia Clínica Electrónica openehr Autor: Ing. Pablo Pazos Gutiérrez Director en CaboLabs.com Traducción: Lic. Bárbara Cardozo v

2 Índice: 1. Sobre EHRGen 1.1. Código abierto 1.2. Licencia 1.3. Comunidad y soporte gratuito 1.4. Soporte comercial 1.5. Casos de éxito 2. Guía de EHRGen 2.1. Instalación y requerimientos Requerimientos Instalación y ejecución: Errores de falta de memoria 2.2. Arquitectura Modelo de seguridad Modelo de datos Dominios y flujos de trabajo Registros clínicos Plantillas y arquetipos Ciclo de vida de los registros clínicos Asiento en la HCE (commit) Gestión de órdenes (instrucciones y actividades) Iconos de entidades en EHRGen 2.4. Gestión de pacientes Admisión y gestión de pacientes 2.5. Integración y Extensión de EHRGen Integración Multilenguaje (internacionalización) Terminología Extensión Anexo A: Gestión de dominios, flujos de trabajo y definiciones de registros clínicos. A.1. Gestión de registros clínicos y flujos de trabajo A.2. Definiendo el registro clínico desde cero 2

3 1. Sobre OpenEHRGen OpenEHRGen, o simplemente EHRGen, es un marco de trabajo de código abierto que permite crear sistemas de Historia Clínica Electrónica orientados a la gestión del conocimiento. Con EHRGen puede crear sistemas completos de HCE sin tener que comenzar desde cero. Además es una herramienta altamente configurable y extensible, que implementa el estándar openehr y está diseñada para soportar otros estándares como HL7 y DICOM Código abierto EHRGen es una herramienta de código abierto, totalmente gratuita en su uso. Si desea extender, modificar o distribuir la herramienta, verifique que cumple con las condiciones de la licencia Licencia EHRGen puede utilizarse bajo la licencia Apache 2.0, que garantiza el copyright del código fuente a quién lo desarrolló, y la capacidad de copiarlo, modificarlo y distribuirlo, siempre y cuando se conserven las notas de copyright y licencia en el código distribuido, atribuyendo el trabajo original a los autores originales. Para esto, todos los cambios y agregados al código fuente original deben estar claramente marcados. Los contribuidores al proyecto conceden automáticamente una licencia sobre sus modificaciones a los autores originales. Por más información: Comunidad y soporte gratuito Ofrecemos soporte gratuito para EHRGen y otros proyectos de CaboLabs.com en nuestros foros: El soporte gratuito no garantiza un tiempo mínimos de respuesta y apunta a consultas generales de instalación, configuración, funcionamiento y uso. Si necesita un servicio de soporte con respuesta garantizada dentro de las 24hs y soporte específico para proyectos, puede optar por solicitar soporte comercial. 3

4 1.4. Soporte comercial CaboLabs.com ofrece soporte comercial de EHRGen para los siguientes servicios: Instalación y configuración de EHRGen. Creación de arquetipos, plantillas, configuración de dominios y flujos de trabajo. Integración de EHRGen con otros sistemas de información, por ejemplo con sistemas de gestión de pacientes existentes. Adaptación de EHRGen para satisfacer requerimientos a medida. Desarrollo de software sobre EHRGen para agregar nuevas funcionalidades. Capacitación en uso y administración. Consulte por soporte comercial en: info@cabolabs.com 1.5. Casos de éxito La Historia Médica Electrónica del Programa SOS Telemedicina para Venezuela está siendo desarrollada utilizando EHRGen como base. Más información sobre el programa:

5 2. Guía de EHRGen 2.1. Instalación y requerimientos EHRGen requiere cierto software de base para poder ser instalado y ejecutado correctamente. A continuación se lista el software de base, en orden de instalación, y se ofrecen links a los sitios oficiales donde encontrará guías y archivos de instalación. Si ud. ya cuenta con el software de base, no es necesario reinstalarlo. Los siguientes puntos se han creado bajo el supuesto de que el lector posee conocimientos mínimos sobre descargar archivos de internet, descompresión de archivos (ZIP, TAR.GZ), instalación de programas, y configuración de variables de entorno Requerimientos 1. JDK6: a. instalación página de Oracle (inglés) b. instalación paso a paso (inglés) c. Modificar variables de entorno en Windows: i. 2. Grails (no funciona en Grails 2.x) a. descarga b. instalacion 3. Base de datos: (una sola opción) a. MySQL: b. PostgreSQL: 4. Configurar conexión a la base de datos en:: a. ehrgen/grails-app/config/datasource.groovy b. Aquí encontrará más información sobre cómo configurar la conexión con la base de datos: c. Por defecto el framework viene configurado para utilizar MySQL con una base de datos llamada oehr_dev, NO OLVIDE modificar el nombre de usuario y clave de su base de datos previamente a ejecutar EHRGen. Más información: 5

6 Instalación y ejecución: La instalación y ejecución es análoga bajo sistemas operativos Windows o Linux. 1. Descomprimir el archivo ZIP descargado desde Google Code, por ejemplo en C:\grails Abrir una consola, situarse en el directorio donde se descomprimió EHRGen (1). 3. Ingresar grails run-app, si Grails está instalado correctamente, EHRGen será ejecutado. 4. Ingresar a en un navegador. 5. Debería ver el login (fig. 1). 6. Puede ingresar con alguno de los usuarios de prueba que se crean en Bootstrap.groovy a. Medico: user:'med', pass:'med' b. Administrativo: user:'adm', pass:'adm c. Enfermera: user:'enf', pass:'enf' d. Administrador del sistema: user:'admin', pass:'admin' Fig. 1: Ingreso a EHRGen Errores de falta de memoria Si al ejecutar recibe un mensaje de error por falta de memoria, vea cuánta memoria está asignada a la ejecución de EHRGen y verifique los picos de consumo que causaron el error utilizando VisualVM ( (ver fig. 2). Luego asigne una cantidad de memoria superior al consumo, editando el archivo startgrails.bat si está en Windows o startgrails para Linux, ambos ubicados en C:\grails-1.3.7\bin. Busque las líneas: 1. startgrails.bat: if "%JAVA_OPTS%" == "" set JAVA_OPTS=-Xss2m -Xmx640m -XX:MaxPermSize=128m 2. startgrails: GRAILS_OPTS="-server -Xmx512M -XX:MaxPermSize=192m -Dfile.encoding=UTF-8" 6

7 Aumente la memoria Xmx y MaxPermSize y vuelva a correr EHRGen utilizando Grails. Mantenga VisualVM abierto para controlar el uso de memoria, y verificar los nuevos parámetros de ejecución de Grails, tal como se muestra en la siguiente imagen: Fig. 2: Parámetros de ejecución de Grails 2.2. Arquitectura Si desea saber más sobre las funcionalidades básicas de EHRGen y su arquitectura, se recomienda leer el artículo presentado en el Congreso Argentino de Informática en Salud (CAIS) 2012: Modelo de seguridad EHRGen posee un modelo de seguridad para autenticación y autorización de usuarios. La autenticación se implementa mediante la asociación de un nombre de usuario y clave privada a cada usuario del sistema. Es posible definir otros esquemas de autenticación, por ejemplo utilizando PIN. La autorización se implementa mediante roles. Un usuario puede tener asignados varios roles. En las funcionalidades de registro clínico, los flujos de trabajo de cada dominio (ver sección 2.3) definen los roles que pueden ejecutar dichos flujos. Entonces, una enfermera no podría crear registros médicos y viceversa. Los flujos de trabajo son configurables y se pueden crear nuevos flujos para nuevos roles en cualquier momento. En las funcionalidades generales de EHRGen también se verifican los roles de usuario, así un usuario clínico no puede ejecutar funciones de administración del sistema, y un administrador no puede realizar registros clínicos. Elementos de seguridad y logging para considerar en un futuro: 7

8 Modelo de datos El siguiente diagrama muestra las principales entidades dentro de EHRGen, que pueden ser agrupadas en tres grupos: 1. Entidades de flujos de trabajo 2. Entidades de información clínica 3. Entidades de información demográfica y seguridad Diagrama conceptual de EHRGen Dominios y flujos de trabajo En EHRGen se tiene un modelo lógico de procesos asistenciales que cuenta con tres grandes entidades: Dominios, Flujos de Trabajo y Etapas. Conceptualmente los dominios representan entidades como: sectores o departamentos dentro de un hospital o también especialidades médicas. EHRGen es lo suficientemente flexible para que la creación de dominios y la asociación con estas entidades sea totalmente configurable. Los dominios están compuestos de un conjunto de Flujos de Trabajo que un usuario puede ejecutar en ese dominio. Un flujo de trabajo representa un proceso asistencial. Cada flujo consta de un conjunto de Etapas, las cuales representan las distintas etapas del proceso asistencial. Cada flujo de trabajo está 8

9 asociado a un conjunto de Roles de usuario, que habilita a los usuarios que tengan uno de esos roles a ejecutar el flujo. Esta característica es parte del modelo de seguridad mencionado en el punto anterior. Por ejemplo, el dominio de Atención de Urgencia, puede tener un flujo de trabajo definido para el rol Médico y otro para el rol Enfermería. El flujo médico, consta de las etapas: anamnesis, evaluación clínica, orden de estudios, indicaciones y resumen de la atención. Tanto los flujos de trabajo como sus etapas son totalmente configurables en EHRGen, pudiendo definir flujos simples o complejos, asociados a uno o más roles para cada dominio. En el Anexo A podrá encontrar la guía para gestionar dominios, flujos de trabajo y definiciones de registros clínicos Registros clínicos El modelo de registros clínicos cumple con el modelo de información del estándar openehr. La especificación completa se encuentra aquí: Este modelo se basa en una jerarquía de estructuras que sigue la estructura natural de los registros clínicos en papel: Composition: registro clínico. Section: sección dentro del registro clínico, a modo de encabezado con nombre. Entry: una declaración clínica única. Structure: estructura interna de una entrada. Item: estructura de campos de una entrada. DataValue: tipos de campos, por ejemplo fecha, texto codificado, proporción, etc Plantillas y arquetipos Todos los registros clínicos en EHRGen son definidos utilizando plantillas y arquetipos. Estos elementos son configurables, lo que da una gran flexibilidad sobre la definición de la estructura de cada registro clínico, sin tener un límite en cantidad de registros que se pueden definir. EHRGen permite agregar nuevos registros sin necesidad de modificar el código fuente de la herramienta. EHRGen utiliza plantillas para generar formularios para el registro de datos clínicos en pantalla. Las plantillas referencian a un conjunto de arquetipos openehr 1. Los arquetipos son utilizados para la definición de estructuras de registro, campos de registro, terminologías y restricciones sobre los datos. EHRGen utiliza las restricciones definidas en los arquetipos openehr para validar los datos ingresados por los usuarios en los formularios de registro, y con los datos crea estructuras de registro clínico que serán almacenadas en la base de datos. Las estructuras de registro de datos siguen el modelo de 1 9

10 información del estándar openehr 2, lo que garantiza que la información puede ser extraída, transformada y comunicada a cualquier sistema, utilizando cualquier formato de intercambio, por ejemplo HL Ciclo de vida de los registros clínicos En EHRGen, los registros pasan por tres grandes estados: Nuevo: registro creado pero que aún no contiene información. Incompleto: registro con información pero no cerrado aún. Cerrado: registro con información, con el paciente identificado, y firmado por el médico (u otro profesional) responsable. Mientras el registro se encuentre en estado incompleto, el usuario podrá registrar nueva información y editar la actualmente registrada. Cuando se firma el registro, éste se cierra. A un registro cerrado no se le puede registrar más información o editar la información que contiene Asiento en la HCE (commit) En futuras versiones de EHRGen, se podrán enviar registros clínicos a un servidor central utilizando el formato de comunicación de openehr basado en XML, sobre protocolos estándar como HTTP y SOAP. Esta característica permitirá compartir registros clínicos realizados dentro de una aplicación EHRGen con otras aplicaciones de registro clínico, creando un registro de salud global, independientemente de la tecnología o el proveedor de cada aplicación. Además cada institución puede implementar su propio servidor centralizado de registros clínicos, lo que permite un control total sobre el registro clínico compartido Gestión de órdenes (instrucciones y actividades) La próxima versión de EHRGen implementará características para gestión interna de órdenes, pedidos o indicaciones, para poder registrar su ejecución y realizar seguimiento

11 Entidades demográficas y seguridad EHRGen define un conjunto de entidades demográficas que está basado en el modelo de información de openehr. Las entidades más importantes son: Person: representa a una persona que puede tener múltiples roles. Role: representa un rol asignado a una persona, por ejemplo médico o paciente. Organization: representa una organización donde una persona cumple uno o más roles. También se definen entidades relacionadas con la seguridad del sistema: Authorization: representa las credenciales de seguridad que garantizan que el usuario es quien dice ser Iconos de entidades en EHRGen Existe un conjunto de iconos que representan las principales entidades dentro de EHRGen, para identificar fácilmente entidad en las áreas de administración de EHRGen. En el futuro se agregarán más. Dominio (Domain) Flujo de Trabajo (Work Flow) Etapa (Stage) Plantilla (Template) Arquetipo (Archetype) 11

12 2.4. Gestión de pacientes Admisión y gestión de pacientes En cuanto a la información de los pacientes, EHRGen tiene dos modos de funcionamiento: 1. Manteniendo la información localmente 2. Manteniendo la información en un sistema externo Manteniendo la información de los pacientes de forma local, EHRGen trabaja como un sistema autocontenido. Si la información de los pacientes se mantiene en un sistema externo, EHRGen se conecta al sistema externo y utiliza su información. Este segundo modo de funcionamiento permite integrar una Historia Clínica Electrónica EHRGen a un sistema de información existente, de modo de no duplicar datos, garantizando que éstos estén actualizados y sean correctos. EHRGen permite crear listas de admisión que contienen la información de los pacientes que un médico debe atender. Estas listas de admisión se gestionan de distintas formas según el modo de funcionamiento. Con información de pacientes local, un usuario administrativo debe crear las admisiones dentro de EHRGen. Con información de pacientes en sistemas externos, un sistema externo se encarga de la admisión y notifica a EHRGen cuando hay un paciente nuevo para atender. EHRGen agrega al paciente a la lista de admisión correspondiente. 12

13 2.5. Integración y Extensión de EHRGen Integración En la próxima versión de EHRGen se agregará un conjunto de interfaces para simplificar la integración con distintos servicios hospitalarios como imagenología, laboratorio y farmacia. Implementación de interfaces: Multilenguaje (internacionalización) EHRGen soporta múltiples idiomas y usos locales, tanto a nivel de interfaz de usuario como a nivel de datos clínicos. A nivel de datos clínicos, la internacionalización se soporta mediante los servicios terminológicos locales y las traducciones contenidas en los arquetipos que definen la estructura de los registros clínicos Terminología EHRGen cuenta con un servicio terminológico interno, capaz de ser extendido para consultar servicios externos. Este servicio resuelve los términos solicitados ya sea por nombre o por código, y soporta la solicitud de nombres o descripciones de conceptos en distintos idiomas Extensión EHRGen implementa un mecanismo de extensión de la funcionalidad del framework mediante la ejecución de eventos. Un desarrollador puede agregar eventos propios, por ejemplo para enviar notificaciones a sistemas externos. 13

14 Anexo A: Gestión de dominios, flujos de trabajo y definiciones de registros clínicos. A.1. Gestión de registros clínicos y flujos de trabajo Esta sección describe la gestión de dominios, flujos de trabajo, etapas, plantillas y arquetipos dentro de EHRGen. Al ingresar a EHRGen, la primer pantalla que se le presenta al usuario es el escritorio clínico, con el listado de dominios y admisiones (fig. A.1). Los dominios permiten representar departamentos, sectores hospitalarios, o especialidades médicas. Dentro de cada dominio es posible definir varios flujos de trabajo para distintos roles (médico, enfermería, técnico, etc.). Las admisiones muestran los pacientes que el usuario tiene para atender, es decir, sobre los cuales se provee un servicio de salud. Cada admisión está asociada a un único dominio. Cuando el usuario selecciona a un paciente de la lista de admisiones, se accede al listado de registros clínicos de ese paciente en ese dominio (fig A.2), con la posibilidad de ver los registros de ese paciente en cualquier dominio (fig. A.3), organizados cronológicamente. Fig. A.1: Escritorio clínico: listado de dominios y admisiones 14

15 Fig. A.2: Listado de registros, para el paciente seleccionado, en el dominio seleccionado Fig. A.3: Listado de registros, para el paciente seleccionado, en todos los dominios Desde el escritorio clínico (fig. A.1) es posible crear nuevos dominios. En la fig. A.4 se muestra la pantalla de creación de dominios, donde el único dato necesario es el nombre del dominio. 15

16 Fig. A.4: Creación de un nuevo dominio Desde el escritorio clínico (fig. A.1) se puede acceder a la sección de administración de arquetipos. La primer pantalla que se muestra es el listado de arquetipos cargados (fig. A.5). Desde esa pantalla es posible agregar nuevos arquetipos, tal como se muestra en la fig. A.6. Para los arquetipos de instrucciones, se solicita además seleccionar qué roles verán las órdenes, pedidos e instrucciones creados utilizando este arquetipo (ver fig. A.7). Esto es parte de la gestión de órdenes que será implementada en la próxima versión de EHRGen (ver sección ). Fig. A.5: Listado de arquetipos 16

17 Fig. A.6: Agregar un arquetipo desde un archivo ADL Fig. A.7: Selección de roles para ejecución de la instrucción definida por un arquetipo agregado 17

18 Desde el escritorio clínico (fig. A.1.) es posible crear nuevas definiciones de registros clínicos, es decir plantillas. Cada plantilla representa un formulario para ingreso de datos dentro de una etapa de un flujo de trabajo (ver sección 2.2.2). En la figura A.8 se muestra la pantalla de creación de plantillas donde se debe ingresar un identificador y un nombre para la nueva plantilla, y seleccionar un arquetipo que define la estructura interna del registro clínico. Una vez creada la plantilla puede ser agregada a un flujo de trabajo desde la edición de un dominio (figs. A.9 y A.10). Al crear una plantilla, EHRGen genera la interfaz de usuario para el ingreso, visualización y edición de datos, utilizando las definiciones de los arquetipos referenciados. En la fig. A.10 se muestra la pantalla de edición de un dominio, donde se pueden agregar flujos de trabajo, etapas a los flujos y asociar las etapas con plantillas. Cada entidad se identifica con su icono respectivo (ver sección ). Fig. A.8: Creación de una plantilla referenciando a múltiples arquetipos 18

19 Fig. A.9: Listado de dominios y admisiones, edición de dominios 19

20 Fig. A.10: Edición de un dominio, con flujos de trabajo y etapas 20

21 A.2. Definiendo el registro clínico desde cero Para definir registros clínicos desde cero, es deben seguir los siguientes pasos: 1. Crear un dominio a. ej. pediatría, emergencia general, internación domiciliaria, etc. 2. Agregar todos los arquetipos que definen las distintas partes del registro clínico a. ej. presión arterial, frecuencia cardiaca, diagnóstico, evaluación clínica, etc. 3. Crear todas las plantillas necesarias para definir los registros clínicos del dominio 4. Agregar los flujos de trabajo, de los distintos roles, dentro del dominio 5. Crear las etapas dentro de cada flujo de trabajo, referenciando a las plantillas correspondientes En estos cinco pasos se pueden crear todos los elementos necesarios para la definición de un registro clínico completo dentro de EHRGen. Luego, al ingresar a un dominio, podrá ver un flujo de trabajo distinto según el rol que tenga, y verá todas las etapas y registros clínicos para comenzar a ingresar datos. Fig. A.11: Registro clínico 21