astracorp

AstraCorp

This project is a full-stack web application demonstrating the integration of modern web technologies through a Docker Compose setup.

It serves as both a proof of concept and a starter template for developers looking to work with this particular technology stack.

The backend is built with Symfony 7 and API Platform 4. The frontend uses Nuxt.js 3 with Vuetify components and TypeScript. The entire application is served through Caddy web server, offering automatic HTTPS. Enjoy!

Install

Choose a domain's name for your project (project default: 'snc-demo.net'), then add those lines to your hosts file :

127.0.0.1 local.api.astra-corp.net
127.0.0.1 local.app.astra-corp.net

Copy the .env file and edit it if needed :

cp .env.skeleton .env

Run from the project directory :

docker-compose build

Edit the following files to update the directives with you domain name

• docker/api/vhost.conf
• docker/caddy/Caddyfile
• api/.env
• app/.env

Run

Run from the project directory :

docker-compose up

Install the API server :

docker exec -it astracorp_api bash
composer install
php bin/console doctrine:database:create
php bin/console doctrine:schema:update --force

Start the nuxt server:

docker exec -it astracorp_app bash
yarn install
yarn dev

Warning: You will probably have to open a tab for both of the subdomains (local.api.astra-corp.net and

     `local.app.astra-corp.net`) in your browser to add a security exception for the self-signed SSL certificate.

Without it, the frontend's requests will be blocked as CORS errors.

At this point, the application should be served at https://local.app.astra-corp.fr/.

Accessing the OpenAPI Interface

The OpenAPI interface is available at:

https://local.api.astra-corp.net/api/docs

This interface provides documentation for all available API routes.