Me2diag - a decision support system for medical diagnoses

Reference research paper

https://doi.org/10.1007/s40815-023-01548-4

How to contribute?

Please read our CONTRIBUTING document.

Build

Use this directions if you want to build the source on your machine If you just want to run the system, see "Run the code"

Note: you should initiate .env file in order to build.

Setup backend:

Prerequisite: openjdk-11 and maven

# start MariaDB, Minio storage, Python Flask model.
docker-compose up -f docker-compose.local.yml

cd backend/
mvn spring-boot:run

Setup frontend:

Prerequisite: nodejs and npm installed.

1. Set up local developing environment (VSCode, ...)

cd frontend/

# install dependencies (run once)
# Note: should not try to resolve any vulnerabilities
npm i

In case you do not use docker, run this command to start frontend server (port 3000)
Then open http://localhost:3000 to view it in the browser. You should first register an account in database :D

# start frontend (in case you do not use docker)
npm run start

2. Set up docker enviroment for developing

cd frontend/

# start frontend server (port 3000)
docker-compose up

Run the code

# Init empty .env in backend classpath
touch backend/.env && touch backend/src/main/resources/.env

# Build with docker compose 
docker-compose -f docker-compose.prod.yml up --build

FAQ

How to run command inside Docker container

docker-compose -f docker-compose.[ENV].yml exec [COMMAND]

Enable Docker Buildkit on your machine

Some old versions of Docker may require setting enviroment variable DOCKER_BUILDKIT to 1.

DOCKER_BUILDKIT=1 docker-compose build