llemr-conspiracy / llemr

A lightweight medical records system for free clinics.

LLEMR

LLEMR is a Lightweight Electronic Medical Record.

A free, open-source EHR for free clinics.

License

GPLv3

Getting Started

• First, build the docker images with:

  $ docker-compose -f local.yml build

• To run the test server, then run:

  $ docker-compose -f local.yml up

For more info, have a look at the django-cookiecutter instructions for running locally with Docker.

Initial Setup

Before LLEMR is usable, you first need to add some basic data to the database.

• To create necessary tables, run:

  $ docker compose -f local.yml run --rm django python manage.py migrate

• To load basic data, run:

  $ docker compose -f local.yml run --rm django python manage.py loaddata core workup permissions inventory labs followup vaccine

• Now, follow the steps below to create a superuser account.

Basic Commands

Setting Up Your Users

• To create a normal user account, just go to Sign Up and fill out the form. Once you submit it, you'll see a "Verify Your E-mail Address" page. Go to your console to see a simulated email verification message. Copy the link into your browser. Now the user's email should be verified and ready to go.

• To create a superuser account, use this command:

  $ docker compose -f local.yml run --rm django python manage.py createsuperuser

For convenience, you can keep your normal user logged in on Chrome and your superuser logged in on Firefox (or similar), so that you can see how the site behaves for both kinds of users.

Running tests with pytest

Once you have a working build of the docker containers:

$ docker compose -f local-test-live.yml run --rm django pytest

The above command will create a Selenium container and run the entire test suite. If you don't want to create a Selenium container, you can instead run:

$ docker compose -f local.yml run --rm django pytest

However, any live tests using Selenium will fail.

Test coverage

To run the tests, check your test coverage, and generate an HTML coverage report:

$ docker compose -f local.yml run --rm django coverage run -m pytest
$ docker compose -f local.yml run --rm django coverage html
$ open htmlcov/index.html

Building Documentation

Documentation can be built with:

$ docker compose -f docs.yml up

Which serves documentation at http://0.0.0.0:7000

Deployment

See detailed cookiecutter-django Docker documentation.