# Final Install Guide — Phase 10

This is the clean consolidated release overlay.

## Recommended installation

### 1. Create the Laravel application
Create a new Laravel 13 project on a server with:
- PHP 8.3+
- Composer
- MySQL/MariaDB

### 2. Apply the overlay
Copy everything inside `laravel-overlay/` into the Laravel project root,
preserving directories.

### 3. Merge Composer requirements
Use `composer.vtu.json` as the dependency reference and make sure the real project
includes Laravel Sanctum.

Then run:

```bash
composer install
php artisan optimize:clear
php artisan migrate
php artisan db:seed
php artisan route:list
php artisan test
```

### 4. Validate syntax and structure

```bash
./scripts/php_syntax_check.sh
python3 scripts/validate_release.py
```

### 5. Use installer for a fresh deployment
For a clean packaged commercial deployment, visit:

`https://yourdomain.com/install`

The installer:
- checks requirements
- tests DB credentials
- writes `.env`
- generates APP_KEY
- migrates
- seeds
- creates Super Admin
- locks itself

### 6. Infrastructure
Configure:
- HTTPS
- queue worker
- cron scheduler
- Redis if desired
- Reverb/Ably/Pusher if realtime is desired
- email provider
- SMS provider
- push provider

### 7. External integrations
Add VTU/payment providers only using their official sandbox documentation first.

Do not enable live money until sandbox tests and reconciliation tests pass.