PA1417 Testing system
This system implements a simple task list, in which YouTube videos can be associated to todo lists in order to keep track of educational material. Please keep the following in mind:
- The system contains intended flaws, which are to be identified applying test techniques.
- The system is a work-in-progress, meaning that some functionalities are not yet implemented. Focus on the functionalities that already exist, everything else can be disregarded for now.
Setup
There are two ways to get the system running: either you start all components (database, backend, frontend) locally, or you use the dockerized version.
Local
Prerequisites
In order to successfully run the system, the following needs to be available on your machine:
Installing
The following steps need to be performed before running the system for the first time:
- In the root folder of this repository, create the folders data\db
- In the folder backend/, run the following command to install all relevant python packages:
pip install -r requirements.pip
- in the folder frontend/, run the following command to install all relevant node packages:
npm install
Running
The following steps need to be performed in order to start the system:
- Navigate a shell to the root folder of this repository and run the following command (you might need admin rights for this):
mongod --port 27017 --dbpath data\db
- Navigate a different shell to the folder backend/ and run
python ./main.py
- Navigate a third shell into the folder frontend/ and run
npm start
Now a browser window should open and display the frontend of the system.
Dockerized
Prerequisites
Your system must have Docker enabled.
Installing and Running
The following steps need to be performed in order to start the system:
- In backend/.env, change the value of the MONGO_URL variable from
mongodb://localhost:27017
tomongodb://dockerUser:dockerPass@mongodb:27017/edutaskDb
, such that the variable looks as follows:
MONGO_URL=mongodb://dockerUser:dockerPass@mongodb:27017/edutaskDb
- Navigate a console (most likely with admin rights) to the root folder of the repository and run
docker-compose up
This should create an image and build three separate containers, one for each component.
Interaction
You can interact with the system in different ways. Here are a few to explore the different components of the system:
- To interact with the database directly, you can use the MongoDB Compass: while the database is running, connect to it via the compass interface using the connection string mongodb://localhost:27017. You can now see and manipulate all data in the database manually. Alternatively, you can use the MongoDB Shell.
- To interact with the server directly, you can use a service like Postman: while the database and server are running, create a new collection in the Postman GUI and "add requests". Select a HTTP method and an URL, for example GET http://localhost:5000/users/all. You can find all available API endpoints in the backend/src/blueprints/ folder or by inspecting the console of your server, where all API endpoints are printed when starting the server. Try for example PST http://localhost:5000/populate to populate the database with an initial user and some tasks. Alternatively to Postman, you can use any browser to interact with the API of the server.
- To interact with the frontend directly, simply use the browser which is opened when running npm start. The frontend can be accessed at http://localhost:3000
Troubleshooting
The following issues are known and may require attention:
- The system was built using nodejs 17, which has a known compatability issue due to its upgrade to OpenSSL3. Check the version of node that you are using and adapt accordingly:
- v17.0.0 and beyond: in frontend/package.json, the "start" script needs to contain the flag --openssl-legacy-provider
- before v17.0.0: remove the --openssl-legacy-provider flag from the "start" script
- When starting the MongoDB with
mongod
, make sure to use the path separators appropriate on your operating system. - When using Fedora as your Linux distribution and encountering issues installing mongoDB (student solution):
- From https://www.mongodb.com/try/download/community, select RedHat / CentOS 8.0 as platform and download the .rpm file
- Go to downloads and execute
sudo dnf install <rpm file>
- Execute
sudo systemctl enable mongod
, thensudo systemctl start mongod
- Delete the file in /tmp which causes errors when tryng to start a new mongodb instance in a dir with
sudo rm /tmp/mongodb-27017.sock
in the terminal - Then you can finally start up the database in the data/db directory