This is the project for the courses: Distributed Systems and Laboratory of Software Systems. The objective of this project is to create a new software, useful for Driving Schools, and all aspects of this domain.
In particular:
- Manage Practical Driving Lessons;
- Manage Practical and Theoretical Exam's Management and all constraints and sub-arguments;
- Manage and historicize all info's about Subscribers, Instructors and Vehicles.
The project is based on creating a distributed system that implements Microservices Architecture and follows DevOps Principles, like Build Automation and Continuous Integration.
Domain Driven Design, is the methodology that has been followed to develop the project, together with Acceptance Test Driven Development to test and validate Business Requirements.
To know more about this project, refers to:
- Final Project Report: https://denguzawr22.github.io/Driving-School-Distributed-Management-Software/
- OpenApi docs - latest version: https://app.swaggerhub.com/apis/DenGuzawr22/DSDMS/latest
You must be aware that the project represents only Server Side of the complete application. So executing it will only check if all given tests pass correctly.
Please follow next guidelines to correctly start the project on your pc:
- First executes Docker (Docker Desktop);
- There must be at least Java 16 installed on the Pc;
- Now you can proceed in executing the file named rerun
- rerun.sh for Unix like systems (MacOs or Linux);
- rerun.bat for Windows users.
The script executes the following commands:
- Gradle build of the entire project: includes tests of each microservice plus quality assurance controls;
- Docker compose build: builds an image for each component of the system (one for each microservice, one for MongoDB and one for testing client);
- Docker compose up: executes previously created images, following included dependencies (the flag serves the purpose to kill containers on exit after testing has finished);
- Docker compose down: deallocate all containers active on the system.
./gradlew build
docker-compose build
docker-compose up --abort-on-container-exit
docker-compose down --rmi localAttention: during first execution all tests could not pass because of database not having enough time to finish installation. In this case, simply rerun the script.