# Deployment Handover Guide

## Local XAMPP
1. Copy project to C:\xampp\htdocs\freight-tms.
2. Configure .env database settings.
3. Import SQL patches.
4. Run composer install.
5. Run npm install and npm run build.
6. Run php artisan optimize:clear.
7. Run php artisan storage:link.
8. Start php artisan serve --port=8007.

## cPanel
1. Upload project outside public_html where possible.
2. Point domain/subdomain document root to public folder.
3. Upload .env with production values.
4. Import database.
5. Set storage, bootstrap/cache permissions.
6. Run composer install --no-dev if SSH is available.
7. Set cron for schedule:run.
8. Configure mail and backup.

## VPS
1. Install PHP, MySQL, Composer, Node, Nginx/Apache.
2. Configure virtual host to public folder.
3. Configure .env.
4. Run migrations/import SQL.
5. Configure queue worker with Supervisor.
6. Configure cron.
7. Enable SSL.
8. Enable backups.

## Production Requirements
- APP_ENV=production
- APP_DEBUG=false
- Strong APP_KEY
- Valid mail provider
- Backup configured
- HTTPS enabled
- QA report clean
