TenantAtlas/specs/044-drift-mvp/quickstart.md
2026-01-15 00:12:55 +01:00

33 lines
987 B
Markdown

# Quickstart: Drift MVP (044)
## Run locally (Sail)
```bash
./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.