TenantAtlas/specs/044-drift-mvp/quickstart.md

Quickstart: Drift MVP (044)

Run locally (Sail)

./vendor/bin/sail up -d
./vendor/bin/sail artisan queue:work --tries=1

Prepare data

1. Open the admin panel and select a tenant context.
2. Navigate to Inventory and run an Inventory Sync twice with the same selection (same selection_hash).

Use Drift

1. Navigate to the new Drift area.
2. On first open, Drift will queue background generation and record status in a persisted run record.
3. Generation produces findings for:
   • baseline = previous successful run for the same scope_key
   • current = latest successful run for the same scope_key
4. Refresh the page once generation finishes.

Triage

• Acknowledge a finding; it moves out of the default “new” view but remains visible/auditable.
• Use the status filter to include acknowledged findings.

Notes

• UI must remain DB-only for label resolution (no render-time Graph calls).
• Findings store minimal, sanitized evidence only.