TenantAtlas/specs/042-inventory-dependencies-graph/quickstart.md

Quickstart — Inventory Dependencies Graph (042)

Prerequisites

• Run the app via Sail.
• Ensure you have at least one tenant and inventory items.

Viewing Dependencies

1. Navigate to Inventory → select an Inventory Item.
2. In the Dependencies section use the querystring-backed filters:

• direction: all (default) | inbound | outbound
• relationship_type: all (default) | assigned_to | scoped_by | targets | depends_on

Example URLs:

• ...?direction=outbound&relationship_type=scoped_by

Running the Targeted Tests

• UI smoke tests:
  • ./vendor/bin/sail artisan test tests/Feature/InventoryItemDependenciesTest.php

MVP Notes

• Limit-only, no pagination.
• Shows <=50 edges per direction (<=100 total when showing both directions).
• Unknown/unsupported reference shapes are warning-only and should be visible via InventorySyncRun.error_context.warnings[].

Manual Performance Check (<2s)

1. Open an Inventory Item with ~50 inbound and/or ~50 outbound edges.
2. Use browser devtools Network tab to confirm the page request completes quickly.
3. Toggle direction and relationship_type filters and confirm responses remain fast.