Install dependencies by running composer install.

1. Create a MySQL database then copy the contents of the file .env.example to a file named .env. Configure your DB settings there.
2. Run php artisan migrate to migrate the database.

Serve the app by running php -S localhost:8000 -t public in the project root.

1. To see the list of vehicles, make a GET request to /vehicles
2. To register a vehicle, make a POST request to /vehicles with the following JSON body:

{
  "name": "Car",
  "engine_displacement_value": 5.5,
  "engine_displacement_uom": "CC",
  "engine_power": 1.5
}

Where:

• name is a string not more that 255 characters
• engine_displacement_value is a number
• engine_displacement_uom is a string with preset valid values: L, CC, and CID
• engine_power is a number

1. IMPORTANT: Create a new database for testing. In the file phpunit.xml, update DB_DATABASE's value to the name of the database you just created.

   // phpunit.xml
   <env name="DB_DATABASE" value="your-testing-database-name"/>
   

2. Run composer test in the project root to run the tests.

Consider also electric vehicles. They do not have a combustion chamber, and also consequently no engine displacement. What would you do to support electric vehicles?

Make the engine_displacement_value and engine_displacement_uom fields nullable.

As very last evaluation point we have performance. Keep in mind that this is not the main goal of this application, since the users are our own employees, even if it takes 10 minutes to load the page, the business can still be successful.

Performance is not a problem with Lumen, since it is a micro-framework designed for fast micro-services and APIs.