Vehicle Operator Licence (VOL) application

This is a dummy application to demonstrate a potential upgrade path for the VOL application from a legacy PHP application to a modern TypeScript application.

Below are DOCs for the legacy PHP application, to view how to run the TS application, see the README in the proxy directory.

Creation steps

This application is a default Laravel application created via:

curl -s "https://laravel.build/my-app" | bash

Installation

This application requires you have docker installed on your machine, see: https://docs.docker.com/get-started/.

If this is the first time you are running the application, you will need to run the following command to seed the database:

./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate --seed

To install dependencies for the web application:

./vendor/bin/sail pnpm install
./vendor/bin/sail pnpm run dev

Running the application

Once you have docker installed, simply run the image through the vendor directory:

./vendor/bin/sail up -d

Testing

Add new tests to the tests folder.

Run tests via:

docker compose exec laravel.test php artisan test