36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# 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`.
|