internships

Website for apprenticeship programme.

Documentation

https://blumilksoftware.github.io/internships/

Architecture

The project contains a modified default configuration and is structured as follows:

• backend stores configuration for Composer and Laravel application and other PHP related stuff;
• frontend is for Node.js npm, Vite, Vue.js and lint configuration - it also contains assets used in the webpage;

Setup and Run

1. Run setup script:

sh setup.sh

Or you can do provided steps in the file manually. Remember to add VITE_MAPLIBRE_TOKEN and API_GEOCODE_TOKEN keys in .env.

2. Run development environment:

To develop the application in a local environment:

docker-compose exec node npm run dev

The application should be available under localhost:80 or another port if you changed EXTERNAL_WEBSERVER_PORT value in the .env file.

3. Admin account:

To be able to login to an admin account and use its features, create it with the artisan command with the desired email, password, name and surname:

docker-compose exec php php artisan make:admin email@example.com password123 name surname

You should now be able to login to an account using these credentials on the website.

Development

1. Codestyle

Before committing changes, it is recommended to run code style and lint checkers:

docker-compose exec php composer run csf
docker-compose exec node npm run lintf

You can remove f at the end of these commands if you don't want to fix issues:

docker-compose exec php composer run cs
docker-compose exec node npm run lint