# Staging Readiness Runbook v6

## 1. Create fresh Laravel project
```bash
composer create-project laravel/laravel ojsto-staging
cd ojsto-staging
```

## 2. Copy this pack into the project
Copy `app`, `database`, `routes`, `resources`, `config`, `public/assets/ojsto`, and `tests` into the fresh Laravel project.

## 3. Configure environment
```bash
cp .env.example .env
php artisan key:generate
```
Set DB values in `.env`.

## 4. Install optional packages
For XLSX exports/imports later:
```bash
composer require maatwebsite/excel
```
For roles/permissions later:
```bash
composer require spatie/laravel-permission
```

## 5. Run migrations and seeders
```bash
php artisan migrate:fresh --seed
```

## 6. Run checks
```bash
php artisan route:list
php artisan test
```

## 7. Manual UAT path
1. Open `/admin`.
2. Add a customer.
3. Add a shipment.
4. Confirm pricing calculation.
5. Change shipment status.
6. Request pickup.
7. Assign courier.
8. Mark delivered.
9. Create COD settlement.
10. Create invoice.

## Release rule
Never use production data until the financial QA sheet passes.