api: teste: ferramentas: web: webapp:
OpenMRS é um sistema de registros médicos baseado em pacientes com foco em fornecer aos provedores um sistema de registros médicos eletrônicos (EMR) personalizável e gratuito.
A missão do OpenMRS é melhorar a prestação de cuidados de saúde em ambientes com recursos limitados, coordenando uma comunidade global que cria uma plataforma de sistema de registros médicos de código aberto, robusta, escalonável e orientada ao usuário.
OpenMRS é um aplicativo Java e é por isso que você precisa instalar um Java JDK.
Se você deseja construir o branch master você precisará de um Java JDK de versão mínima 8.
Instale a ferramenta de construção Maven.
Você precisa garantir que o Maven use o Java JDK necessário para o branch que deseja construir.
Para fazer isso execute
mvn -version
que lhe dirá qual versão o Maven está usando. Consulte a documentação do Maven se precisar configurar o Maven.
Instale a ferramenta de controle de versão git e clone este repositório com
git clone https://github.com/openmrs/openmrs-core.git
Depois de cuidar dos pré-requisitos
Execute o seguinte
cd openmrs-core
mvn clean package
Isso irá gerar o aplicativo OpenMRS em webapp/target/openmrs.war
que você terá que implantar em um servidor de aplicativos como, por exemplo, Tomcat ou Jetty.
Para fins de desenvolvimento, você pode simplesmente implantar o openmrs.war
no cais do servidor de aplicativos via
cd openmrs-core/webapp
mvn jetty:run
Se tudo correr bem (verifique a saída do console), você poderá acessar o aplicativo OpenMRS em localhost:8080/openmrs
.
Consulte Introdução como desenvolvedor - Maven para obter mais informações sobre comandos úteis do Maven e opções de construção.
As compilações do Docker ainda estão em andamento. Agradecemos qualquer feedback e melhorias no processo.
O único pré-requisito necessário é o Docker.
Para construir uma versão de desenvolvimento, execute:
docker-compose build
Ele chama mvn install
por padrão. Se você quiser personalizar os argumentos de construção do mvn, poderá fazê-lo executando:
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
Também é possível usar a imagem de desenvolvimento construída para executar o jetty:
docker-compose up
Para construir uma versão de produção, execute:
docker-compose -f docker-compose.yml build
Primeiro ele constrói a imagem dev e depois uma imagem com Tomcat e openmrs.war. Não tem dependências de desenvolvimento.
A versão de produção pode ser executada com:
docker-compose -f docker-compose.yml up
Se quiser depurar, você precisa executar uma versão de desenvolvimento e conectar seu depurador à porta 8000, que é exposta por padrão.
Infelizmente, neste ponto, qualquer alteração no código requer reinicialização completa e reconstrução do contêiner do docker. Para agilizar o processo, use:
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
docker-compose up
Estamos trabalhando para fornecer suporte ao recurso de recarga automática do Spring Boot, que será documentado aqui assim que estiver pronto.
Também é possível implantar uma imagem construída pelo nosso CI, que está publicada em https://hub.docker.com/r/openmrs/openmrs-core
Você pode executar qualquer tag disponível com:
TAG=nightly docker-compose -f docker-compose.yml up
Também é possível executar uma versão de desenvolvimento de uma imagem com:
TAG=dev docker-compose up
Todas as versões de desenvolvimento contêm o sufixo dev. O sufixo de cache deve ser usado pelo nosso CI.
A árvore do projeto está configurada da seguinte forma:
API/ | Arquivos Java e de recursos para construir o arquivo jar da API java. |
ferramentas/ | Metacódigo usado durante a compilação e teste. Não entra em nenhum binário lançado (como doclets). |
rede/ | Arquivos Java e de recursos que são usados no arquivo webapp/war. |
webapp/ | arquivos usados na construção do arquivo war (contém arquivos JSP em versões mais antigas). |
pom.xml | O principal arquivo maven usado para construir e empacotar o OpenMRS. |
Para um rápido desenvolvimento de módulos e do código da plataforma OpenMRS, confira o incrível SDK em
https://wiki.openmrs.org/display/docs/OpenMRS+SDK
OpenMRS possui uma arquitetura modular que permite aos desenvolvedores estender a funcionalidade principal do OpenMRS criando módulos que podem ser facilmente adicionados ou removidos para atender às necessidades de uma implementação específica.
Antes de criar seu próprio módulo, acesse o Repositório de Módulos OpenMRS e veja se já existe um módulo para seu caso de uso específico. Se sim, implante e experimente e se faltar alguma funcionalidade, junte-se aos desenvolvedores do módulo para adicionar um recurso.
Se você não encontrou o que procurava, consulte o Módulo - wiki para saber como criar um novo módulo.
Se você quiser contribuir, consulte estes recursos
Se você está procurando guias detalhados sobre como instalar, configurar, contribuir e estender o OpenMRS, visite
http://wiki.openmrs.org
Se você estiver procurando mais informações sobre o OpenMRS como uma organização, verifique
http://openmrs.org
Contribuições são muito bem-vindas, definitivamente precisamos da sua ajuda!
O OpenMRS organiza os privilégios de seus contribuidores em estágios de desenvolvimento documentados aqui.
Leia as seções a seguir para descobrir onde você pode ajudar.
Confira nossas diretrizes de contribuição e leia os guias do desenvolvedor.
Depois de ler? pegue uma edição introdutória que é Ready For Work
.
Você pode não ter tempo para se desenvolver, mas tem experiência suficiente com OpenMRS e/ou revisão de código, sua ajuda nas revisões de código será muito apreciada!
Ler
https://wiki.openmrs.org/display/docs/Code+Review
e comece com re-:eyes: pull requests!
Nós usamos
https://www.transifex.com/openmrs/OpenMRS/
para gerenciar nossas traduções.
O arquivo messages.properties
neste repositório é nossa única fonte de verdade. Ele contém pares de chave e valor para o idioma inglês, que é o padrão.
O Transifex busca atualizações para este arquivo todas as noites, que podem ser traduzidas por você e por mim no próprio site do transifex. A qualquer momento podemos trazer novas traduções do transifex de volta para este repositório. Outros idiomas como por ex. O espanhol estará então no arquivo messages_es.properties
.
Se você gostaria de saber como ajudar com traduções, veja
http://openmrs.org/join-the-community/translate/
Se você quiser ajuda para corrigir problemas existentes ou encontrou um bug e quiser nos contar, vá para
https://issues.openmrs.org
Fale conosco no OpenMRS Talk
MPL 2.0 com HD © OpenMRS Inc.