mDOT pJITAI (Just-In-Time Adaptive Intervention) Web and REST API Interface

About mDOT

The mHealth Center for Discovery, Optimization & Translation of Temporally-Precise Interventions is supported by the National Institutes of Health's National Institute of Biomedical Imaging and Bioengineering through its Biomedical Technology Resource Centers Program.

Getting Started

We recommend using a native installation of Visual Studio Code to edit and debug this project. Additionally, you will need Docker and Docker Compose. If you are using the interactive capabilities of Visual Studio Code, you will need to install the Python requirements located in the requirements.txt file. Prior to installing these, you need to install a mysql-client and associated development files for the database library.

Configure your environment

Copy the .env.template file to a .env file. The defaults are appropriate for the standard docker-compose configuration.

Running the Docker Containers

docker-compose up

Building the containers

The app needs to be rebuilt after any code change and the container needs to be replaced within the running Docker Compose system.

Build the container

docker-compose build

Run the following if you want to build and redeploy the container in an already running system.

docker-compose up --build --no-deps rl-app

Interactive mode

If you want to debug the system, modify the .env file and change the following lines. This will allow you to run the system interactively outside of docker.

DB_HOST=localhost
DB_PORT=3307

You only need the mysql container once this is complete.

Start up the mysql container in the background

docker-compose up -d mysql

Once this is running, you can leave the container running and start/stop docker directly from your OS. This container will automatically start when docker is launched if it is running when docker is shutdown.

Once this is complete, go to the Run and Debug tab and select the Python: Run Server from the menu. This configuration has been preconfigured and will run the server. It will respond to normal debugging procudures such as breakpoints.

Import the HeartSteps example on the pJITAI web page

Run the docker and the Python server first, open a new terminal and then type this line in the new terminal

docker-compose exec mysql mysql -u root -ppass
use pJITAI;

Then go to the files, under the sql_data folder, find heartstep.sql document. Copy the third line of the heartstep.sql document and paste the third line in the new terminal.