TenantAtlas/specs/046-inventory-sync-button/quickstart.md
Ahmed Darrazi 68695cd024 feat(046): inventory sync policy type selection
- Use searchable multi-select with select all/clear\n- Track bulk progress per policy type\n- Update tests and spec tasks/quickstart
2026-01-09 16:17:00 +01:00

1.2 KiB

Quickstart: Inventory Sync Button (046)

Goal

Start an Inventory Sync for the currently selected tenant from the Filament UI, observe progress in:

  • Filament database notifications panel
  • Bottom-right progress widget (BulkOperationProgress)

Local prerequisites

  • Sail running
  • Queue worker running (required for the new queued sync job)

Run locally

  1. Start the stack:

    • ./vendor/bin/sail up -d
  2. Run a queue worker:

    • ./vendor/bin/sail artisan queue:work --tries=1
  3. Open the admin panel and pick a tenant:

    • Visit /admin and select a tenant context.
  4. Navigate to Inventory:

    • Use the left navigation “Inventory”.
  5. Click “Run Inventory Sync”:

    • Select which policy types to include (or click “Select all”).
    • You should see:
      • A database notification (started)
      • A bottom-right progress widget entry for Sync inventory
      • A new Inventory Sync Run record in the Inventory Sync Runs list

Notes

  • If the queue worker is not running, the progress widget will remain in “Queued…” and the run will not advance.
  • Concurrency/lock gating may skip the run; the UI should show a clear informational message and a run record will reflect the skip reason.