# Ladill POS — deploy runbook

Standalone **in-store register** at `pos.ladill.com`. Charges via Ladill Pay (`source_service: pos`, `fee_tier: sales`).

## Platform wiring

1. OIDC client: `php artisan passport:client` on monolith — redirect `https://pos.ladill.com/sso/callback`
2. Env keys on monolith: `BILLING_API_KEY_POS`, `PAY_API_KEY_POS`, `IDENTITY_API_KEY_POS`
3. Env on POS app: matching consumer keys + `LADILL_SSO_CLIENT_*`
4. Database: `ladill_pos` (MySQL) — migrations via deploy script
5. Marketing: `php scripts/ensure-app-entry-routes.php` (includes `ladill-pos`)

## Deploy

Same release model as Mini/Merchant — see `deploy/deploy.sh`.

```bash
php artisan migrate --force
php artisan config:cache && php artisan route:cache && php artisan view:cache
```

## Commerce links

- **CRM** — `CRM_API_KEY_POS` on CRM + `CRM_API_URL` / `CRM_API_KEY_POS` on POS; timeline on paid sales; product import from CRM API
- **Invoice** — "Create invoice" on paid sale receipt (`kind: pos_sale` prefill)
- **Merchant** — `MERCHANT_DB_*` read-only connection; import storefront catalog into `pos_products`