# v13 Actual Working Hardening

This build moves the project another step away from demo-only behavior and toward operational usage.

## Added in v13

- Admin role management UI.
- Admin user management UI.
- Permission syncing from screen.
- Shipment CSV template download route.
- Realer COD settlement create/preview/store/show workflow.
- Invoice creation from COD settlement.
- Invoice print/PDF-ready HTML view.
- Accounting schema hardening migration with operational columns.
- Stronger model relationships/casts for COD settlements, invoices, invoice items, and cash movements.

## Important note

This is still an Actual Working Build, not a guaranteed production release. The next real steps are:

1. Install into a fresh Laravel app.
2. Run migrations and seeders.
3. Smoke test login, users, roles, shipments, COD settlement, invoice print.
4. Confirm financial rules with real customer pricing examples.
5. Replace CSV-only import with Laravel Excel XLSX if required.

## Demo / smoke flow

1. Login as `admin@ojsto.local`.
2. Create or edit roles under Admin > Roles.
3. Create users under Admin > Users.
4. Create customers and shipments.
5. Mark shipments delivered.
6. Create COD settlement for delivered shipments.
7. Approve settlement.
8. Create invoice from settlement.
9. Print invoice.

## Remaining production blockers

- Full XLSX import/export with exact legacy templates.
- Full old Admin feature parity.
- Full customer/courier UI pixel polish.
- Advanced cash ledger approval/reversal flows.
- Real accountant UAT.