Training Management System created by Daniel L. (1352906), Gustav K. (1262761) and others from Web Department at VATSIM Scandinavia. Running using Laravel 9 in a pre-built Docker container.
📝 The project is open source and contains some restirctions. Read the LICENSE for details.
👁️ Remember to watch this repository to get notified of our patches and updates!
- A Docker environment to deploy containers. We recommend Portainer.
- MySQL database to store data.
- Preferably a reverse proxy setup if you plan to host more than one website on the same server.
In the instructions where we use docker exec, we assume your container is named control-center. If you have named it differently, please replace this.
If you don't want to use Docker, you need:
- An environment that can host PHP websites, such as Apache, Ngnix or similar.
- MySQL database to store data.
- Comply with Laravel 9 Requirements
- Manually build the composer, npm and setting up cron jobs and clearing all caches on updates.
Upgrading from to v4.0 from v3.4? Read the UPGRADE.md in v4.0 documentation for details.
To setup your Docker instance simply follow these steps:
- Pull the
ghcr.io/vatsim-scandinavia/control-center:v4Docker image - Setup your MySQL database (not included in Docker image)
- Configure the environment variables as described in the CONFIGURE.md
- Start the container in the background.
- Setup the database.
docker exec -it --user www-data control-center php artisan migrate - To ensure that users will not need to log in after each time you re-deploy or upgrade the container, you need to create and store an application key in your environment and setup a shared volume.
Copy the key and set it as the
docker exec -it control-center php artisan key:get docker volume create controlcenter_sessionsAPP_KEYenvironment variable in your Docker configuration and bind the volume when creating the container withcontrolcenter_sessions:/app/storage/framework/sessions. - To keep uploaded files between deployments, you need to bind this to a host folder, such as
/YOUR/HOST/LOCATION:/app/storage/app/public/files, and set correct permissions of this folder.docker exec -it control-center chown -R www-data:www-data /app/storage/app/public/files - Setup a crontab outside the container to run
* * * * * docker exec --user www-data -i control-center php artisan schedule:run >/dev/nullevery minute. This patches into the container and runs the required cronjobs. - Bind the 8080 (HTTP) and/or 8443 (HTTPS) port to your reverse proxy or similar.
Updating only requires you to run migration and clear caches. Remember also running the theming command again if you have a custom theme.
docker exec -it --user www-data control-center php artisan migrate
docker exec -it --user www-data control-center php artisan optimize:clearTo have Control Center reflect your division correctly, you need to do some tweaks.
- Give your user admin access
docker exec -it control-center php artisan user:makeadmin - You can now access
Administration -> Settingsin the menu to tweak the most basic settings for your division. - You are also required to configure logic and datasets in the MySQL database as described in CONFIGURE.md with examples
Control Center has an API that you can use to fetch useful data from the database. Read more in the API documentation.
There's quite a few automations in Control Center that are running through the cron-jobs. They're as follows:
- All trainings with status In Queue or Pre-Training are given a continued interest request each month, and a reminder after a week. Failing to reply within two weeks closes the request automatically.
- ATC Active is flag given based on ATC activity. Refreshes daily with data from VATSIM Data API. It counts the hours from today's date and backwards according to the length of qualification period.
- Daily member cleanup, if a member leaves the division, their training will be automatically closed. Same for mentors. Does not apply to visitors.
- Other misc cleanups
Do you want to help us with improving Control Center? Curious about whether we use testing? Stylistic choices?
Read the CONTRIBUTE.md for details.