CAALIN FUEL STATION - ONLINE INSTALLATION
==========================================

Requirements (server / hosting)
- PHP 8.3 or newer with: pdo_mysql, mbstring, gd, zip, intl, fileinfo, bcmath, sodium, openssl
- MySQL 8 or MariaDB 10.6+ (utf8mb4)
- Apache (with .htaccess) or Nginx

1. Upload all the files of this folder to the server, e.g. /home/user/caalin
   Point the domain's document root to the  public/  folder.
   (If the host cannot change the document root, put the contents of public/
    in public_html and edit public_html/index.php so the two paths point to
    the folder with vendor/ and bootstrap/.)

2. Create an empty MySQL database + user (utf8mb4).

3. Copy .env.example to .env and fill in:
   APP_URL, DB_DATABASE, DB_USERNAME, DB_PASSWORD

4. In a terminal / SSH, inside the project folder:
   php artisan key:generate --force
   php artisan migrate --force
   php artisan db:seed --class=CaalinSeeder --force
   php artisan storage:link

   The Administrator sign-in (admin@caalin.local + a random password) is written to
   storage/app/caalin-admin-login.txt. Sign in, change the password from the menu
   ("Change Password"), then delete that file.
   (Or set CAALAMI_ADMIN_EMAIL / CAALAMI_ADMIN_PASSWORD in .env before seeding.)

5. Optional speed-up (run again after every update):
   php artisan route:cache
   php artisan view:cache

6. Cron job (every minute) for alerts, reminders and automatic backups:
   * * * * * cd /home/user/caalin && php artisan schedule:run >> /dev/null 2>&1

7. Folder permissions: storage/ and bootstrap/cache/ must be writable by the web server.

Never set APP_DEBUG=true on a live server.
