modulehandbook / studyplan

A MEVN-based Tool for HTW IMI students to plan their studies and choose optional modules.
GNU General Public License v3.0
5 stars 2 forks source link

Studyplan

A MEVN-based Tool for HTW IMI students to plan their studies and choose optional modules.

Developed as HTW IMI-Project (WiSe21/22).

Based on studplan by Julia Zamaitat.

Team:

Supervisor:

Set up development environment

WARNING: It is highly recommended to use a linux machine. Otherwise a lot of scripts may not run correctly. Also it is recommended to use docker-cli instead of docker-desktop.

1. Install docker and docker-compose

Further information on docker.com/get-docker and docker.com/compose/install.

2. Clone the repo

Clone this repository to your local machine.

3. Build docker container and seed the Database

Run the following command inside the project-root-directory.

sudo npm run init

Use the development environment

Start Docker-Desktop

Start the environment

sudo npm run start

Stop the environment

sudo npm run stop

See logs

sudo npm run logs

You can also specifie which logs you want to see. To do so just add ( vue-app / node-server / mongo-db )

For example:

sudo npm run logs vue-app

Seed the Database

run this command either to lint and format the vue-app / node-server code:

npm run lint-all

Run Server Tests (run in root)

npm run test

Clean reset the enviroment

If you have, for example, problems with not installed node packages run this command to completely rebuild the docker images:

npm run clean-docker-packages

If you want to completely reinstall the node packages on your local machine run this command to clean the vue-app-packages / node-server-packages:

npm run clean-packages-all

More information

You can find more detailed information on the github wiki page.