# v7 Sales Demo Runbook

## Goal

Make OJSTO easier to demonstrate and continue developing. This build adds practical screens, demo data and workflows on top of v6.

## Suggested staging steps

1. Create fresh Laravel 13 project.
2. Copy this package over it carefully.
3. Run `composer dump-autoload`.
4. Configure `.env` database.
5. Run `php artisan migrate`.
6. Run `php artisan db:seed --class=DemoSalesSeeder`.
7. Open `/admin`, `/customer`, `/courier`.

## Demo scenario

1. Open Admin Dashboard.
2. Create or open a customer.
3. Create a shipment.
4. Review pricing breakdown.
5. Open Customer Portal and view shipment.
6. Open Courier Portal and update shipment to Delivered.
7. Review Cash Ledger/COD workflow.
8. Export shipment report.

## Still required before real sale

- Real auth screens and password policies.
- Real user/customer/courier session scoping.
- XLSX import using Laravel Excel or PhpSpreadsheet.
- Full accounting UAT.
- Pixel matching against legacy UI.
- Production hardening.
