TenantAtlas/specs/047-inventory-foundations-nodes/quickstart.md

Quickstart: Foundations in Inventory (047)

Goal

Verify that foundations are synced as InventoryItem records when include_foundations=true, and are not synced when include_foundations=false.

Preconditions

• Local dev via Sail is running.
• You have at least one tenant configured with valid Graph credentials.

Steps

1. Run an inventory sync with foundations enabled

   • Use the Inventory UI sync button (Spec 046) with include_foundations=true, or run the relevant flow in your preferred admin path.

2. Confirm foundation nodes exist

   • In Inventory Items, filter Category = Foundations.
   • Confirm you can find:
     • Scope tags (roleScopeTag)
     • Assignment filters (assignmentFilter)
     • Notification templates (notificationMessageTemplate)

3. Confirm coverage shows both matrices

   • Open Inventory → Coverage.
   • Confirm both headings are present: “Policies” and “Foundations”.

4. Confirm name resolution (Spec 042.2)

   • Open a policy that references scope tags or assignment filters.
   • In the Dependencies section, confirm targets render with resolved display names sourced from local inventory.

Troubleshooting

• If foundation types do not appear, confirm they exist in config('tenantpilot.foundation_types') and have Graph contracts in config/graph_contracts.php.
• If UI doesn’t reflect changes, rebuild assets if needed (npm run dev / composer run dev) and confirm cache is cleared.