TenantAtlas/specs/113-platform-ops-runbooks/quickstart.md

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.