Debugging

By Docker

1. Download Docker Desktop
2. Clone and go to the file path
3. build the image
   1. docker build -t "image_name:latest" .
4. run the image
   1. docker run -d -p 5000:5000 image_name

By local virtual machine

• start a virtual machine

python3 -m venv venv

• activate the virtual machine

source venv/bin/activate

• use pip to install pkgs

pip install -r requirements.txt

• run the program

flask run --debug

By Visual Studio Code

Servers

The test server can be accessed from MongoDB Atlas, please follow the MongoDB Atlas section in this guide.

The prod server is on BioHPC and we can access it through Postman, etc. Be careful when sending requests to the prod server.

Postman

Postman is useful for sending HTTP requests to the back-end APIs. 

1. Install Postman
2. Checkout Mobile APIs  for Backend Online APIs

Notes (mobile)

Samples are identified by their barcode ids. If submit two surveys with the same barcode, then the latest submitted survey will replace the old one. Even if different users use the same barcode, the sample will get replaced. So when testing, if you do not scan a barcode, the sample will always be stored as no barcode, and the database will always only store the latest survey.