# OJSTO v15 - Ultimate Working Build

v15 is the strongest build in the current sequence. It is not just a sales demo. It is an actual working foundation with stronger operational modules, security controls, and accounting safety rules.

## Main purpose

Make the project closer to a real courier company system:

1. Admin manages users, roles, customers, shipments, pickups, warehouse, manifests, settlements, invoices, claims, exceptions, reports, settings, and audit logs.
2. Customer portal is isolated to the authenticated customer's own shipments.
3. Courier portal is isolated to assigned shipments only.
4. Accounting is protected by locks, settlement rules, invoice rules, and non-destructive adjustments.
5. Excel/CSV import uses centralized validation and shipment creation.

## Still required before live production

- Install inside a fresh Laravel app and run migrations.
- Run UAT scenarios from the QA pack.
- Confirm tax rule, status 301 meaning, and all Excel templates with operations/accounting.
- Replace demo credentials.
- Configure backups, queue worker, mail, and storage permissions.

## Recommended staging flow

```bash
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve
```

Use staging URL first. Do not run real customer money on the first install without UAT.