openmrs core

api: prueba: herramientas: web: aplicación web:

OpenMRS es un sistema de registros médicos basado en pacientes que se centra en brindar a los proveedores un sistema de registros médicos electrónicos (EMR) personalizable y gratuito.

La misión de OpenMRS es mejorar la prestación de atención médica en entornos con recursos limitados mediante la coordinación de una comunidad global que crea una plataforma de sistema de registros médicos de código abierto, sólida, escalable e impulsada por el usuario.

Tabla de contenido

1. Construir
   1. Requisitos previos
   2. Comando de construcción
   3. Desplegar
2. Construcción de ventana acoplable
3. Navegando por el repositorio
4. Kit de desarrollo de software
5. Ampliación de OpenMRS con módulos
6. Documentación
   1. Guías para desarrolladores
   2. wiki
   3. Sitio web
7. Contribuyendo
   1. Código
   2. Revisiones de código
   3. Traducción
8. Asuntos
9. Comunidad
10. Apoyo
11. Licencia

Construir

Requisitos previos

Java

OpenMRS es una aplicación Java, por lo que necesita instalar un JDK de Java.

Si desea crear la rama maestra, necesitará un JDK de Java de versión 8 como mínimo.

experto

Instale la herramienta de compilación Maven.

Debe asegurarse de que Maven utilice el JDK de Java necesario para la rama que desea crear.

Para ello ejecute

mvn -version

que le dirá qué versión está usando Maven. Consulte los documentos de Maven si necesita configurar Maven.

git

Instale la herramienta de control de versiones git y clone este repositorio con

git clone https://github.com/openmrs/openmrs-core.git

Comando de construcción

Después de haber cumplido con los requisitos previos

Ejecute lo siguiente

 cd openmrs-core
mvn clean package

Esto generará la aplicación OpenMRS en webapp/target/openmrs.war que deberá implementar en un servidor de aplicaciones como, por ejemplo, Tomcat o Jetty.

Desplegar

Para fines de desarrollo, simplemente puede implementar openmrs.war en el embarcadero del servidor de aplicaciones a través de

 cd openmrs-core/webapp
mvn jetty:run

Si todo va bien (verifique la salida de la consola), puede acceder a la aplicación OpenMRS en localhost:8080/openmrs .

Consulte Introducción como desarrollador - Maven para obtener más información sobre comandos útiles de Maven y opciones de compilación.

Construcción de ventana acoplable

Las compilaciones de Docker aún están en progreso. Agradecemos cualquier comentario y mejora del proceso.

El único requisito previo necesario es Docker.

Para crear una versión de desarrollo, ejecute:

docker-compose build

Llama mvn install de forma predeterminada. Si desea personalizar los argumentos de compilación de mvn, puede hacerlo ejecutando:

docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '

También es posible utilizar la imagen de desarrollo creada para ejecutar Jetty:

docker-compose up

Para construir una versión de producción ejecute:

docker-compose -f docker-compose.yml build

Primero crea la imagen de desarrollo y luego una imagen con Tomcat y openmrs.war. No tiene dependencias de desarrollo.

La versión de producción se puede ejecutar con:

docker-compose -f docker-compose.yml up

Si desea depurar, debe ejecutar una versión de desarrollo y conectar su depurador al puerto 8000, que está expuesto de forma predeterminada.

Desafortunadamente, en este punto, cualquier cambio de código requiere un reinicio completo y una reconstrucción del contenedor acoplable. Para acelerar el proceso, utilice:

docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
docker-compose up

Estamos trabajando para brindar soporte para la función de recarga automática de Spring Boot, que se documentará aquí una vez que esté lista.

También es posible implementar una imagen creada por nuestro CI, que está publicada en https://hub.docker.com/r/openmrs/openmrs-core

Puede ejecutar cualquier etiqueta disponible con:

TAG=nightly docker-compose -f docker-compose.yml up

También es posible ejecutar una versión de desarrollo de una imagen con:

TAG=dev docker-compose up

Todas las versiones de desarrollo contienen el sufijo dev. El sufijo de caché es para uso de nuestro CI.

Navegando por el repositorio

El árbol del proyecto está configurado de la siguiente manera:

API/	Archivos Java y de recursos para crear el archivo jar api de Java.
herramientas/	Metacódigo utilizado durante la compilación y las pruebas. No entra en ningún binario publicado (como doclets).
web/	Archivos Java y de recursos que se utilizan en el archivo webapp/war.
aplicación web/	archivos utilizados en la creación del archivo war (contiene archivos JSP en versiones anteriores).
pom.xml	El archivo maven principal utilizado para compilar y empaquetar OpenMRS.

Kit de desarrollo de software

Para un desarrollo rápido de módulos y el código de la plataforma OpenMRS, consulte el increíble SDK en

https://wiki.openmrs.org/display/docs/OpenMRS+SDK

Ampliación de OpenMRS con módulos

OpenMRS tiene una arquitectura modular que permite a los desarrolladores ampliar la funcionalidad principal de OpenMRS mediante la creación de módulos que se pueden agregar o eliminar fácilmente para satisfacer las necesidades de una implementación específica.

Antes de crear su propio módulo, vaya al repositorio de módulos OpenMRS y vea si ya existe un módulo para su caso de uso específico. Si es así, impleméntelo y pruébelo y, si falta una funcionalidad, únase a los desarrolladores del módulo para agregar una característica.

Si no ha encontrado lo que buscaba, consulte el Módulo - wiki para saber cómo puede crear un nuevo módulo.

Documentación

Guías para desarrolladores

Si desea contribuir, consulte estos recursos.

• Comenzando como desarrollador
• Cómo configurar su IDE
• Cómo hacer una solicitud de extracción

wiki

Si está buscando guías detalladas sobre cómo instalar, configurar, contribuir y ampliar OpenMRS, visite

http://wiki.openmrs.org

Sitio web

Si buscas más información sobre OpenMRS como organización consulta

http://openmrs.org

Contribuyendo

Las contribuciones son bienvenidas, ¡definitivamente nos vendría bien tu ayuda!

OpenMRS organiza los privilegios de sus contribuyentes en etapas de desarrollador que se documentan aquí.

Lea las siguientes secciones para descubrir dónde podría ayudar.

Código

Consulte nuestras pautas de contribución y lea las guías para desarrolladores.

¿Después de haber leído? tome un número introductorio que esté Ready For Work .

Revisiones de código

Es posible que no tenga tiempo para desarrollarse, pero sí suficiente experiencia con OpenMRS y/o revisión de código. ¡Su ayuda en la revisión de código será muy apreciada!

Leer

https://wiki.openmrs.org/display/docs/Code+Review

y comience con re-:eyes: ¡solicitudes de extracción!

Traducción

Usamos

https://www.transifex.com/openmrs/OpenMRS/

para gestionar nuestras traducciones.

El archivo messages.properties de este repositorio es nuestra única fuente de información. Contiene pares clave y valor para el idioma inglés, que es el predeterminado.

Transifex obtiene actualizaciones de este archivo todas las noches, que luego usted y yo podemos traducir en el sitio web de transifex. En cualquier momento podemos recuperar nuevas traducciones de transifex a este repositorio. Otros idiomas como por ej. El español entonces estará en el archivo messages_es.properties .

Si desea saber cómo ayudar con las traducciones, consulte

http://openmrs.org/join-the-community/translate/

Asuntos

Si desea ayuda para solucionar problemas existentes o encontró un error y desea informarnos, vaya a

https://issues.openmrs.org

Comunidad

Apoyo

Hable con nosotros en OpenMRS Talk

Licencia

MPL 2.0 con HD © OpenMRS Inc.