DOC.md

Open Hospital

OH - Open Hospital is a free and open-source Electronic Health Record (EHR) software application. Open Hospital is deployed as a desktop application that can be used in a standalone, single user mode (PORTABLE mode) or in a client / server network configuration (CLIENT mode), where multiple clients and users connect to the same database server.

OH is developed in Java and it is based on open-source tools and libraries; it runs on any computer, requires low resources and is designed to work without an internet connection.

Download

[ Download latest ] [ All releases ]

[ Download latest (mirror) ] [ All releases (mirror) ]

Documentation

OH Documentation is available at the following links:

• User and Admin manuals
• wiki
• FAQ

Development

Open Hospital is composed by the following components, hosted in separated repositories:

• OH Core, a library that contains the business logic and the data abstraction layer
• OH GUI, which provides a graphical user interface (GUI) made with Java Swing
• OH Doc, which contains the user and admin documentation in Asciidoc format
• OH UI, a web user interface that consists of a React SPA (single page application) [WIP]
• OH API, a web server that exposes REST APIs over the Core component, and it's used by the UI component [WIP].

This repository is used to assemble the portable (or all-in-one) packages of Open Hospital, which you can download here.

How to contribute

There are several ways to contribute to Open Hospital:

• try the desktop application or the early versions of the web UI
• request new features or report issues on JIRA (here's a list of good-first-issues)
• improve the documentation
• contribute code patches to one of the components

Community

You can reach out to the community of contributors by joining our Slack workspace or by subscribing to our mailing list.

How to create OH packages

👷 📦

To create the Open Hospital packages, make sure to have installed the following dependencies on a Linux machine: JDK 8+, Maven, asciidoctor-pdf, zip, GNU make.

Then follow these simple steps:

1. Clone this repository:

   git clone https://github.com/informatici/openhospital
   

2. Run the script that compiles the components of Open Hospital, and assembles the portable distributions:

   cd openhospital
   make
   

   You can also parallelize some make tasks by using the -j flag (e.g. make -j4) or use intermediate targets to build single parts of the distribution - use make help to see a list of available targets.