openmrs core
1.0.0
api : test : outils : web : webapp :
OpenMRS est un système de dossier médical basé sur le patient qui vise à offrir aux prestataires un système de dossier médical électronique (DME) personnalisable et gratuit.
La mission d'OpenMRS est d'améliorer la prestation des soins de santé dans des environnements aux ressources limitées en coordonnant une communauté mondiale qui crée une plate-forme de système de dossiers médicaux open source robuste, évolutive et axée sur l'utilisateur.
OpenMRS est une application Java, c'est pourquoi vous devez installer un JDK Java.
Si vous souhaitez créer la branche master, vous aurez besoin d'un JDK Java de version 8 minimum.
Installez l'outil de build Maven.
Vous devez vous assurer que Maven utilise le JDK Java nécessaire pour la branche que vous souhaitez créer.
Pour ce faire, exécutez
mvn -versionqui vous dira quelle version Maven utilise. Reportez-vous à la documentation Maven si vous devez configurer Maven.
Installez l'outil de contrôle de version git et clonez ce référentiel avec
git clone https://github.com/openmrs/openmrs-core.gitAprès avoir pris soin des prérequis
Exécutez ce qui suit
cd openmrs-core
mvn clean package Cela générera l'application OpenMRS dans webapp/target/openmrs.war que vous devrez déployer sur un serveur d'applications comme par exemple Tomcat ou Jetty.
À des fins de développement, vous pouvez simplement déployer openmrs.war dans la jetée du serveur d'applications via
cd openmrs-core/webapp
mvn jetty:run Si tout se passe bien (vérifiez la sortie de la console), vous pouvez accéder à l'application OpenMRS à l' localhost:8080/openmrs .
Reportez-vous à Démarrer en tant que développeur - Maven pour plus d'informations sur les commandes Maven utiles et les options de construction.
Les versions de Docker sont toujours en cours. Nous apprécions tous les commentaires et améliorations du processus.
Le seul prérequis nécessaire est Docker.
Pour créer une version de développement, exécutez :
docker-compose build Il appelle mvn install par défaut. Si vous souhaitez personnaliser les arguments de build mvn, vous pouvez le faire en exécutant :
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests 'Il est également possible d'utiliser l'image de développement construite pour exécuter jetty :
docker-compose upPour créer une version de production, exécutez :
docker-compose -f docker-compose.yml buildIl construit d'abord l'image de développement, puis une image avec Tomcat et openmrs.war. Il n'a aucune dépendance de développement.
La version de production peut être exécutée avec :
docker-compose -f docker-compose.yml upSi vous souhaitez déboguer, vous devez exécuter une version de développement et connecter votre débogueur au port 8000, qui est exposé par défaut.
Malheureusement, à ce stade, toute modification du code nécessite un redémarrage complet et une reconstruction du conteneur Docker. Pour accélérer le processus, veuillez utiliser :
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
docker-compose upNous travaillons à fournir la prise en charge de la fonctionnalité de rechargement automatique de Spring Boot, qui sera documentée ici une fois prête.
Il est également possible de déployer une image construite par notre CI, qui est publiée sur https://hub.docker.com/r/openmrs/openmrs-core
Vous pouvez exécuter n'importe quelle balise disponible avec :
TAG=nightly docker-compose -f docker-compose.yml upIl est également possible d'exécuter une version de développement d'une image avec :
TAG=dev docker-compose upToutes les versions de développement contiennent le suffixe dev. Le suffixe de cache est destiné à être utilisé par notre CI.
L'arborescence du projet est structurée comme suit :
| API/ | Fichiers Java et de ressources pour créer le fichier jar de l'API Java. |
| outils/ | Métacode utilisé lors de la compilation et des tests. N'entre dans aucun binaire publié (comme les doclets). |
| Internet/ | Fichiers Java et de ressources utilisés dans le fichier webapp/war. |
| application Web/ | fichiers utilisés dans la construction du fichier war (contient des fichiers JSP sur les anciennes versions). |
| pom.xml | Le fichier maven principal utilisé pour créer et empaqueter OpenMRS. |
Pour un développement rapide des modules et du code de la plateforme OpenMRS, consultez l'impressionnant SDK sur
https://wiki.openmrs.org/display/docs/OpenMRS+SDK
OpenMRS possède une architecture modulaire qui permet aux développeurs d'étendre les fonctionnalités de base d'OpenMRS en créant des modules qui peuvent facilement être ajoutés ou supprimés pour répondre aux besoins d'une implémentation spécifique.
Avant de créer votre propre module, accédez au référentiel de modules OpenMRS et voyez s'il existe déjà un module pour votre cas d'utilisation spécifique. Si c'est le cas, déployez-le et essayez-le et si une fonctionnalité manque, rejoignez les développeurs du module pour ajouter une fonctionnalité.
Si vous n'avez pas trouvé ce que vous cherchiez, reportez-vous au Module - wiki pour savoir comment créer un nouveau module.
Si vous souhaitez contribuer, veuillez vous référer à ces ressources
Si vous recherchez des guides détaillés sur la façon d'installer, de configurer, de contribuer et d'étendre OpenMRS, visitez
http://wiki.openmrs.org
Si vous recherchez plus d'informations sur OpenMRS en tant qu'organisation, vérifiez
http://openmrs.org
Les contributions sont les bienvenues, nous pouvons certainement utiliser votre aide !
OpenMRS organise les privilèges de ses contributeurs en étapes de développement qui sont documentées ici.
Lisez les sections suivantes pour savoir où vous pourriez aider.
Consultez nos directives de contribution et lisez les guides du développeur.
Après avoir lu ? récupérez un numéro d'introduction qui est Ready For Work .
Vous n'avez peut-être pas le temps de vous développer mais suffisamment d'expérience avec OpenMRS et/ou la révision de code, votre aide sur les révisions de code sera très appréciée !
Lire
https://wiki.openmrs.org/display/docs/Code+Review
et lancez-vous avec re-:eyes: pull request !
Nous utilisons
https://www.transifex.com/openmrs/OpenMRS/
pour gérer nos traductions.
Le fichier messages.properties de ce référentiel est notre unique source de vérité. Il contient des paires clé-valeur pour la langue anglaise qui est la langue par défaut.
Transifex récupère chaque nuit les mises à jour de ce fichier qui peuvent ensuite être traduites par vous et moi sur le site Web de transifex lui-même. À tout moment, nous pouvons récupérer de nouvelles traductions de transifex dans ce référentiel. D'autres langues comme par ex. L'espagnol sera alors dans le fichier messages_es.properties .
Si vous souhaitez savoir comment aider avec les traductions, voir
http://openmrs.org/join-the-community/translate/
Si vous souhaitez obtenir de l'aide pour résoudre des problèmes existants ou si vous avez trouvé un bug et souhaitez nous le signaler, rendez-vous sur
https://issues.openmrs.org
Parlez-nous sur OpenMRS Talk
MPL 2.0 avec HD © OpenMRS Inc.
