Leasing Application for All Mobility Groups

End-User Utility to take vehicles on lease, respect such leasing contracts and returning the leased vehicles to the providers. For use by customers (vehicle users)

Technologies Used to Build the Application

• Angular
• Java 17
• Spring Boot 3.2.5
• MySQL 8.0.31 (containerized)
• JPA 3.1.0 (Jakarta Persistence API)
• Hibernate 6.4.4 for ORM
• Docker
• Gradle
• Flyway for database migration
• lombok for boilerplate code generation

Screenshots

Contract Manager

Customer Manager

Vehicle Manager

Home View

• 

• 

Business Scenario and Use Cases

Main Actors

• Customer, with properties: name, birthdate
• Vehicle, with properties: brand, model, year of manufacture, VIN, price
• Lease Contract, with essential properties: lease contract number, monthly rate (for billing)

Screens/Pages/Views for End Users

Viewing Contract Summary [under development]

The following details are shown at summary level:

• lease contract number
• customer name
• vehicle details (branc, model, year)
• VIN separately ("--" shown if VIN is not available)
• contract rate
• vehicle price
• anchor link to view more details

Indicative illustration is below:
|----------Contract Overview---------------------------------------------------------------------------------------------|
|Contract Nr. |Customer Name |Vehicle |VIN |Contract Rate (Monthly) |Vehicle Price More Details |
|134856 |Maximill Muster |Audi A20 (2023) |A65413 |654,20 |33465,80 |
|146349 |Angel Angle |Neo X4 (2024) |-- |453,00 |40321,00 |
|------------------------------------------------------------------------------------------------------------------------|

Customer Entry Form [under development]

It is a form with fields to enter customer name and birthdate, along with "Update" and "Cancel" buttons.

Vehicle Entry Form [under development]

It is a form with fields to enter all five properties (detail points) of vehicle to add or update, with "Update" and "Cancel" buttons.

Lease Contract Entry Form [under development]

A form to enter contract number, monthly rate of contract, related customer name and related vehicle details. Customer name and vehicle details may be picked out of database in order to select existing data about customer and vehicle, respectively.

Preconditions to Run the Application

This application requires the following software packages to run properly:

• a command line interpreter. Bash is preferred. CMD for Windows also works. The command in this readme run very well with Bash. For having Bash on a Windows box, you may install Git Bash.
• Docker
• a web browser. Chrome is preferred. Other web browsers may work for most functionalities.

Installation

The application can be set up and started in two distinct methods.

1. Local build and execution

• Using your favorite Terminal app for shell, clone the files (source code and configuration) from GitHub repository:

git clone https://github.com/rishiraj88/leasing.git

• In your file explorer, go to leasing/contract directory:

cd leasing/contract

• Build the project locally with gradle wrapper:

./gradlew build

2. Pulling the pre-built Docker image

• Run this command in Terminal app to pull and start the latest contract image published on Docker Hub for project backend:

docker run i50729/contract

In its current stage of development, the backend app runs well with locally available mysql container and the accompanying frontent leasingclient.

One important point to note here: All three (mysql, backend and frontend) must be in a common(=single,shared) network in order to work together. For non-tech-savvy users, it is not an easy feat. Currently work on this is going on.

How to Start the Application

• Now you may use the application by visiting this URL:

http://localhost:4200/home

• Freely navigate to and use the sections Customers, Vehicles and Leasing Contracts under Manage menu.

Reason of Chosen Solution

The chosen solution corresponds to the use the modern technologies available so as to model complex dynamic systems easily. Hence it enables the businesses to work on heavy-cash businesses more conveniently.

General Notes

Due to some constraints, I have built the MVP. For enhancing and fostering the solution, tech discussions on relevant parameters and methods are always cited and welcome.

Notes for Developers

The backend of the app was packaged and published with the following commands:

• In your file explorer, go to leasing/contract directory:

cd leasing/contract

• Build the project locally with gradle wrapper:

./gradlew build

• Build Docker image with:

docker build -t i50729/contract:latest .

• Push the Docker image for publishing with:

docker push i50729/contract:latest

Development on unified Docker image is underway:

• Build the Docker container network by running:

`docker-compose build

docker-compose up -d

• Go to leasingclient directory under leasing.

cd leasingclient

• Build and run the Angular-based frontend with these commands:

npm install

ng serve

For Feedback, Queries, Collaboration

• LinkedIn Profile: https://www.linkedin.com/in/rishirajopenminds
• Contact Card: https://bio.link/rishiraj49de
• X: https://twitter.com/RishiRajDevOps
• Other Repositories: https://github.com/rishiraj88?tab=repositories