The team develops an app to manage testdrivers. The app has the following main features:
- Android App
- Java-based server backend
- Secure chat between clients
- Problem reports via app
We use PostgreSQL as our database. To run the web service on your machine, a PostgreSQL instance must be installed and configured first. For running locally on your local machine, using a docker image is recommended. To do that, run the script setup-docker.sh inside the database directory with root privileges. This will install the PostgreSQL docker image, start a container on default port 5432, and handle database configuration. cleanup-docker.sh will stop the database container and delete it.
For running the web service locally, it is recommended to build and run the web service docker container. Execute the script run-docker.sh inside the webservice directory with root privileges (call stop-docker.sh to revert). You can also run the web service as a user process with mvn exec:java. JUnit tests can be executed by running mvn test inside the webservice directory.
The environment variable ASEPART_POSTGRES_HOST can be set to change the default hostname of the database the web service tries to connect to. Default is localhost. If JDBC_DATABASE_URL is set, the web service will use that and ignore all other configuration options.
For the file upload feature, we use a Minio server, which is an Open Source S3-compatible file storage server. The environment variables ASEPART_MINIO_URL, ASEPART_MINIO_BUCKET, MINIO_ACCESS_KEY and MINIO_SECRET_KEY must be set to enable this feature.
The admin web application can be build and executed by:
$ cd admin-web-app
$ npm install
$ npm start
Your browser will be opened displaying the web app.
To build the app you have to change the directory to user-app and run
$ npm install
$ npm start
The console outputs an QR code which can be scanned using the "Expo" app which must be installed from the Play Store/App Store.
Download the .apk file from the "Releases" section and copy it to your phone. You may need to allow the installation of unknown apps in your system settings.