# Quickstart — Spec 113 (Operator Runbooks)

## Prereqs
- Docker + Laravel Sail

## Boot the app
- `vendor/bin/sail up -d`
- `vendor/bin/sail composer install`
- `vendor/bin/sail artisan migrate`

## Seed a platform operator
- `vendor/bin/sail artisan db:seed --class=PlatformUserSeeder`

This creates:
- Workspace: `default`
- Tenant: `platform` (used for platform-plane audit context)
- PlatformUser: `operator@tenantpilot.io` / password `password`

## Open the System panel
- Visit `/system` and login as the platform operator.

## Run the findings lifecycle backfill
1. Go to `/system/ops/runbooks`
2. Select scope (All tenants or Single tenant)
3. Run preflight
4. Confirm and start
5. Use “View run” to monitor progress

## CLI (existing)
- Tenant-scoped backfill (existing behavior):
  - `vendor/bin/sail artisan tenantpilot:findings:backfill-lifecycle --tenant={tenant_id|external_id}`

## Notes
- In production-like environments, `/admin` must not expose maintenance/backfill actions.
- If UI changes don’t show up, run `vendor/bin/sail npm run dev`.
