TenantAtlas/specs/131-cross-resource-navigation/quickstart.md

Quickstart: Cross-Resource Navigation & Drill-Down Cohesion

Feature: 131-cross-resource-navigation | Date: 2026-03-10

Scope

This feature standardizes operator navigation across related governance, monitoring, inventory, and backup resources by:

• defining one explicit navigation matrix for the highest-value resource relationships,
• routing all run-related drill-downs through canonical operations destinations,
• adding structured related-context sections to key detail pages,
• adding limited, high-value row-level drill-down actions on list pages,
• rendering missing or unauthorized relations as clear unavailable states.

Implementation order

1. Create the shared relation-navigation support layer and encode the initial navigation matrix.
2. Refactor in-scope run-related links to flow through the canonical OperationRunLinks helper consistently.
3. Add structured related-context sections to Finding, BaselineSnapshot, PolicyVersion, BackupSet, and canonical operation-run detail pages.
4. Add or normalize list-level related drill-down actions on findings, policy versions, backup sets, and operations-related surfaces.
5. Align explicit back-link and context-preservation behavior on canonical operations pages with the existing operate-hub shell patterns.
6. Add graceful unavailable-state rendering for missing, unresolved, and unauthorized relations.
7. Add focused Pest unit and feature coverage for the shared navigation layer, canonical routing, UI visibility, and authorization-aware degradation.
8. Run focused Sail-based tests.
9. Run Pint on dirty files.

Reference files

• app/Support/OperationRunLinks.php
• routes/web.php
• app/Filament/Pages/Monitoring/Operations.php
• app/Filament/Pages/Operations/TenantlessOperationRunViewer.php
• app/Filament/Resources/OperationRunResource.php
• app/Filament/Resources/FindingResource.php
• app/Filament/Resources/BaselineSnapshotResource.php
• app/Filament/Resources/BaselineProfileResource.php
• app/Filament/Resources/PolicyResource.php
• app/Filament/Resources/PolicyVersionResource.php
• app/Filament/Resources/BackupSetResource.php
• app/Filament/Resources/BackupSetResource/RelationManagers/BackupItemsRelationManager.php
• app/Policies/OperationRunPolicy.php
• app/Policies/FindingPolicy.php
• tests/Feature/Monitoring/OperationsCanonicalUrlsTest.php
• tests/Feature/Operations/TenantlessOperationRunViewerTest.php
• tests/Feature/Findings/FindingWorkflowViewActionsTest.php
• tests/Feature/Findings/FindingWorkflowRowActionsTest.php
• tests/Feature/Filament/BaselineSnapshotStructuredRenderingTest.php
• tests/Feature/Filament/PolicyVersionBaselineEvidenceVisibilityTest.php
• tests/Feature/Filament/BackupSetUiEnforcementTest.php

Suggested new tests

• tests/Feature/Findings/FindingRelatedNavigationTest.php
• tests/Feature/Filament/BaselineSnapshotRelatedContextTest.php
• tests/Feature/Filament/PolicyVersionRelatedNavigationTest.php
• tests/Feature/Filament/BackupSetRelatedNavigationTest.php
• tests/Feature/Monitoring/OperationsRelatedNavigationTest.php
• tests/Feature/Rbac/CrossResourceNavigationAuthorizationTest.php
• tests/Unit/Support/RelatedContextResolverTest.php
• tests/Unit/Support/CanonicalNavigationContextTest.php

Suggested validation commands

vendor/bin/sail artisan test --compact tests/Feature/Monitoring/OperationsCanonicalUrlsTest.php
vendor/bin/sail artisan test --compact tests/Feature/Operations/TenantlessOperationRunViewerTest.php
vendor/bin/sail artisan test --compact tests/Feature/Findings/FindingWorkflowViewActionsTest.php
vendor/bin/sail artisan test --compact tests/Feature/Findings/FindingWorkflowRowActionsTest.php
vendor/bin/sail artisan test --compact tests/Feature/Filament/BaselineSnapshotStructuredRenderingTest.php
vendor/bin/sail artisan test --compact tests/Feature/Filament/PolicyVersionBaselineEvidenceVisibilityTest.php
vendor/bin/sail artisan test --compact tests/Feature/Filament/BackupSetUiEnforcementTest.php
vendor/bin/sail artisan test --compact tests/Feature/Findings/FindingRelatedNavigationTest.php
vendor/bin/sail artisan test --compact tests/Feature/Filament/BaselineSnapshotRelatedContextTest.php
vendor/bin/sail artisan test --compact tests/Feature/Filament/PolicyVersionRelatedNavigationTest.php
vendor/bin/sail artisan test --compact tests/Feature/Filament/BackupSetRelatedNavigationTest.php
vendor/bin/sail artisan test --compact tests/Feature/Monitoring/OperationsRelatedNavigationTest.php
vendor/bin/sail artisan test --compact tests/Feature/Rbac/CrossResourceNavigationAuthorizationTest.php
vendor/bin/sail artisan test --compact tests/Unit/Support/RelatedContextResolverTest.php
vendor/bin/sail artisan test --compact tests/Unit/Support/CanonicalNavigationContextTest.php
vendor/bin/sail bin pint --dirty --format agent

Expected outcome

• Findings, snapshots, policy versions, backup sets, and operation runs stop behaving like isolated records.
• Canonical operations routes become the single authoritative destination for run-oriented drill-downs.
• Related records appear through structured context sections and limited high-value actions instead of raw IDs and ad hoc links.
• Missing or inaccessible relations degrade clearly without broken links or route leakage.
• The shared navigation pattern is reusable for future artifacts without rewriting every resource page manually.