ZTL ARTCC Website

This is the main website for the vZTL ARTCC, part of the VATSIM Network.

Running Locally

Pre-requisites

• git
• Docker - Must be installed and running
• PHP v8.0.13
• Node v8.2.0
• Recommended on UNIX based platforms for managing PHP and Node versions asdf

💡 If you are not on a UNIX based platform (like MacOS or Linux), it is recommended to use a terminal that is compatible with UNIX style commands (git bash, WSL, etc.)

Setting up

1. Clone the repository

   git clone https://github.com/ZTL-ARTCC/Current_Website.git

2. Change directory into the repository

   cd Current_Website

3. Copy .env.example to .env

4. Generate the application key

   php artisan key:generate

5. Update the APP_STORAGE variable in .env to be correct.

6. Go to https://auth-dev.vatsim.net and log in with the username and password 10000002/10000002.

7. Click "Manage OAuth Organizations"

8. Next to "VATSIM Connect Demo", click "View"

9. Open the "OAuth clients" tab

10. Click "Add client"

11. Under "Redirect URL", enter http://127.0.0.1:8000/login

12. Scroll to the very bottom to see the new created client. The ID will be on the left, and the secret will be in the middle.

13. In .env, set VATSIM_OAUTH_CLIENT to the client ID.

14. In .env, set VATSIM_OAUTH_SECRET to the client secret.

15. Initialize the database: php artisan migrate php artisan db:seed

16. Start the website: php artisan serve

17. Finally, you can log in with the username and password 10000002 (it's the username and the password). You'll automatically have all permissions assigned to you.

Helpful Commands

Command	Action
composer format	Formats all PHP files
npm run format	Formats all JS files
php artisan serve	Start the local server
php artisan migrate	Run all new migrations
php artisan make:migration [migration name]	Create a new migration
php artisan make:controller [controller name]	Create a new controller
composer reset	Resets the DB