DriveFast API

This is the repository for the DriveFast API, which can be used as a learning project!

Structure

The API has the following structure:

- com/act/cars
    / application
        / dto
            / client
            / lease
            / vehicle
        / projections
        / service
    / domain
        / entities
        / exception
            / catchers
            / pojo
        / repository
    / web
        / controller
        / mapper

Endpoints

The main endpoints are:

• /clients
• /vehicles
• /leases

The subendpoints are all /{id}, but there are some specific ones:

• /clients/summary
  • Returns a summary of expenses from all clients
• /leases/client/{clientId}
  • Returns all leases from the specified client
• /vehicles/available
  • Returns all the available vehicles

Tech Stack

• Java - v21
• Spring Boot - v3.51
• Maven - v4.0
• MySQL - v?

How to run?

1. Clone this reposiory:

git clone https://github.com/gabrielEFagundes/drive-fast-api

2. Open the project and run it with Maven:

# linux/macos
cd ./drive-fast-api ; mvn spring-boot:run

# windows
cd ./drive-fast-api && mvn spring-boot:run

2.1. Optionally, you can run it as JAR:

# linux/macos
cd ./drive-fast-api ; java -jar target/CarsApplication.jar

# windows
cd ./drive-fast-api && java -jar target/CarsApplication.jar

Developer

gabrielEFagundes