Open Hospital - UI

This is the UI component of Open Hospital: it contains a web user interface that consists of a React SPA (single page application). This project depends on the API component that exposes business logic APIs implemented in the Core component.
This project is still in early stages. For a more mature user interface of Open Hospital, check out the GUI project.

App architecture

How to install

This project is based on React. To learn React, check out the React documentation.
To install the project dependencies, issue:

- npm i

It has to be done before any of the following activities

How to configure

Please use .env.local file to override .env.* configuration.

Examples:

you want to develop using real api instead of mocked: use this .env.local file
```
# .env.local
REACT_APP_USE_MOCK_API=
```
- then: npm start
you want to connect your local dev environment to docker api:
```
# .env.local
REACT_APP_USE_MOCK_API=
REACT_APP_BASE_PATH=http://localhost:8080/oh-api
```
- then: docker-compose up && npm start

Run local development environment

- npm start

Run full stack environment locally

You can run a full OH2 stack locally using Docker (required) using this command: ( - docker-compose up

Then you can access to:

OH2 react app: localhost:3030
Swagger api spec: localhost:8080/oh-api/swagger-ui.html
Phpmyadmin, for looking inside database: localhost:9000

How to publish on Github Pages

- npm run build:gh-pages
- git commit

then

- git subtree push --prefix build intesys-oh gh-pages

or

- git subtree split --prefix build develop
- git push intesys-oh GIT_ID:gh-pages --force

How to launch the application

You can run a development build of the application by issuing:

- npm start

How to run unit tests

To run unit tests, issue:

- npm test

How to launch the e2e tests

Run:

- npm run e2e

it launches application in development mode and starts cypress, in a single process.

If you want more control over Cypress e2e tests, use two different processes: one for serving the app (process #1) and one for running the Cypress Test Runner (process #2). You can launch it by issuing the following commands in two different intances of your terminal:

//process #1
- npm start

//process #2
- npm run cypress:open

Once the app is compiled and served, and the Cypress Test Runner is launched, click on Run all specs

How to contribute

You can find the contribution guidelines in the Open Hospital wiki.
A list of open issues is available on Jira.

Community

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

AnPham100/informatici-openhospital-ui