# Development Demo Dataset v44.1

This bundle creates an idempotent local dataset so developers can exercise the system
outside PHPUnit's temporary test database.

## Safety

The `demo:seed-retail` command runs only in `local` or `testing` by default.
`--force` is required elsewhere.

The fixed demo tenant uses:

- slug: `retail-demo`
- company: Demo Retail Company
- branch: Demo Zagazig Branch
- warehouse: Demo Main Warehouse
- register: Demo POS 1

Demo login:

- email: `demo@retail.local`
- password: `Demo123!`

This credential is for local development only.

## Business data

The seeder creates:
- tenant, membership, company, branch, warehouse and register
- CRM customer
- product family + variant
- opening inventory with weighted-average cost
- four completed sales across 2026-09-01 through 2026-09-04
- captured cash payments
- one posted/restocked return and completed cash refund
- inventory sale issue / sale reversal ledger movements
- cash account / balance / closed shift with variance
- purchasing / supplier invoice / payable sample where the installed supplier schema is compatible
- reporting projections for the four-day period

Purchasing demo data is intentionally optional so development seeding does not fail if a
future supplier schema adds a required field. Core retail/reporting demo data remains
authoritative for this bundle.

## Commands

From `apps/api`:

`php artisan demo:seed-retail`

The command prints the real internal tenant ID and an exact `reporting:refresh` command.

The seeder is idempotent: rerunning it reuses the same demo tenant and business references.
