In this project I am showcasing a simple subscription api, allowing to perform typical tasks connected with operating a subscription based company ;).
I decided to use Laravel as the basis for the API, as it is the framework I am most familiar with at the moment and I did not want to be too time constrained due to too many new things - so far I have only read few articles about DDD. Modifying it to be more DDD like was probably the greatest challenge in this task - due to little practical knowledge of it. As I have found, there is no perfect way of combining Laravel with DDD, albeit even taking it into consideration, allows to make more conscious choices while constructing your application - and that is for me the immediate benefit of this task.
While working on the API I tried to use "KISS" and "YAGNI" as much as possible - as a result my controllers are not very SOLID ;) - I decided that with such a simple (from a business point of view) tasks using services or repositories would be an overkill. On the other hand if I were to continue working on this application - I would definitely move responsibilites connected with business logic to separate class.
Running application in docker environment requires docker and docker-compose installed on your system.
-
set permissions for project dir
sudo chown -R $USER:$USER <dir_name> -
cd into project directory.
-
copy env variables
cp .env.example .env -
create new sqlite db
touch database/database.sqlite -
start docker containers
docker-compose up -d -
install dependencies with composer
via docker temp container:
docker run --rm -v $(pwd):/app composer installvia docker running container:
docker exec app composer installor locally on your system
-
generate laravel app key
docker-compose exec app php artisan key:generate -
run migrations and seed db
docker-compose exec app php artisan migrate --seed -
application is now ready at "localhost:82"