colab

A Digital Lab for the co-Design, co-Development and co-Evaluation of Digital Learning Games

setup

postgresql

Install

Install fresh postgresql in docker

docker ru-d -p 5432:5432 -e POSTGRES_DB=colab -e POSTGRES_USER=colab -e POSTGRES_PASSWORD=<YOUR_SECRET_PASSWORD> --name colab_postgres -d postgres:13-alpine

You may want to add --restart always to the docker run command.

Edit ./colab-webapp/src/main/resource/colab.properties to match

#
# coLAB properties
#######################

## Database
colab.database.user=colab
colab.database.password=<YOUR_SECRET_PASSWORD>
colab.database.name=colab

Setup a 2nd database for tests

Configure test database

echo "CREATE USER \"colab_test\" WITH PASSWORD '1234';
CREATE DATABASE \"colab_test\" OWNER \"colab_test\";" |  docker exec -it colab_postgres psql -U postgres

Compile

Tools & version to use

• java11 & maven
• node
• yarn

command line

Rebuid everything with :

mvn clean install

Rebuild everything but skip tests with :

mvn -DskipTests clean install

Maven Site

PMD and other tools may fails the build. You may want to consult human-readable reports.

Regenerate maven site:

mvn site ste:stage

And open ./target/staging/index.html

Run (development)

start server with

cd colab-webapp
./run

You way have a look on run options:

./run -h

Webpack dev server

Start a webpack dev server on localhost:3004

cd colab-webapp/src/main/webapp/app
yarn start