ERE Primary System Desktop Client Application of the Gematik TI
The ere-ps-app is comprised of two main components.
- The ere-ps-app back-end which is a Java 11 Quarkus (https://quarkus.io/) application.
- The ere-ps-app front-end UI, which is a browser based HTML, CSS and JavaScript application.
The repository for the front-end UI can be found here
Open a terminal window and do the following:
-
Clone the ere-ps-app back-end repository by running:
-
The repository of the front-end is setup as a submodule in the ere-ps-app repository. After cloning the ere-ps-app repository or to reference the latest version of the frontend repository, run the following command:
git submodule update --init
The source files of the front-end UI will be located in the following directory location:
src/main/resources/META-INF/resources/frontend
At this point, you should now have access to the source files for both the backend and front-end of the application.
-
-
Download and install the latest version of the OpenJDK 11 SDK. You can use your preferred package manager software on your computer to handle this, or simply download an archive or installer from a publishing site such as AdoptOpenJDK (https://adoptopenjdk.net/). Make sure to choose OpenJDK 11 (LTS) and the HotSpot version of the JVM.
-
Download and install the latest version of Apache Maven (https://maven.apache.org/).
-
The latest Chrome Browser (https://www.google.com/chrome/).
-
-
Open a terminal window and change to the parent ere-ps-app directory of the back-end and then run the following commands:
In order to make sure you are working with the latest front-end UI, run the following first:
git submodule update --init
Then run:
mvn quarkus:dev
At this point, the application should be running as highlighted below.
__ ____ __ _____ ___ __ ____ ______ --/ __ \/ / / / _ | / _ \/ //_/ / / / __/ -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \ --\___\_\____/_/ |_/_/|_/_/|_|\____/___/ 2021-06-08 15:45:41,324 INFO [ca.uhn.fhi.uti.VersionUtil] (Quarkus Main Thread) HAPI FHIR version 5.3.0 - Rev 919c1dbddc 2021-06-08 15:45:41,325 INFO [ca.uhn.fhi.con.FhirContext] (Quarkus Main Thread) Creating new FHIR context for FHIR version [R4] 2021-06-08 15:45:41,571 INFO [io.und.websockets] (Quarkus Main Thread) UT026003: Adding annotated server endpoint class health.ere.ps.websocket.Websocket for path /websocket 2021-06-08 15:45:41,665 INFO [hea.ere.ps.ser.fs.DirectoryWatcher] (Quarkus Main Thread) Watching directory: /Users/douglas/my-indie-projects-work-area/ere-ps-app/watch-pdf 2021-06-08 15:45:41,758 INFO [io.quarkus] (Quarkus Main Thread) ere-ps-app 1.0.0-SNAPSHOT on JVM (powered by Quarkus 1.13.1.Final) started in 2.158s. Listening on: http://0.0.0.0:8080 2021-06-08 15:45:41,760 INFO [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated. 2021-06-08 15:45:41,761 INFO [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, rest-client, resteasy, resteasy-jsonb, scheduler, servlet, websockets]You can access the front-end UI of the application by making reference to the following URL in a Chrome browser only!
Very Important! The front-end UI can only be accessed in the Chrome browser.
To check that the ere-ps-app back-end is correctly referencing the front-end UI and its latest version, run the following command at a terminal window from the ere-ps-app parent directory:
git submodule status
You should see something similar to the following with the only difference being the preceding git revision number:
7887a70e4dbe35cede4d286dc57bc3bba608a48d src/main/resources/META-INF/resources/frontend (heads/main)
For dev mode purposes, the environment variables referenced in the application.properties file are located in a file named .env. This file should be located in the root project folder (ere-ps-app).
In regards to file and directory paths, configure the values for the environment variables in the .env file to reference paths on your local computer.
Important! Configure the .env file to be ignored and not checked into the source code repository.
An example of the layout of the contents in the .env file is shown below:
ERE_DIRECTORY_WATCHER_DIR=<YOUR_LOCAL_PATH>/watch-pdf
ERE_TITUS_CONNECTOR_TLS_CERT_TRUST_STORE_DIR=<YOUR_LOCAL_PATH>/ere-ps-app/src/test/resources/certs
ERE_TITUS_CONNECTOR_TLS_CERT_TRUST_STORE_PWD=<SECRET_VALUE_ON_YOUR_COMPUTER>