ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
94d5eab217
TenantAtlas/specs/078-operations-tenantless-canonical/quickstart.md
Ahmed Darrazi e57157016c plan: add implementation plan and design artifacts for 078 
- plan.md: 5 implementation phases (A-E), constitution check, risk assessment, test strategy
- research.md: 5 findings (R-001 through R-005) on Filament v5 schema reuse
- data-model.md: entity documentation, routing changes, file deletion/modification map
- contracts/routes.md: canonical vs decommissioned route contracts
- quickstart.md: verification steps for implementors
- Updated copilot agent context with plan technologies
2026-02-07 00:11:20 +01:00

2.5 KiB
Raw Blame History

Quickstart: Operations Tenantless Canonical Migration

Feature: 078-operations-tenantless-canonical
Branch: 078-operations-tenantless-canonical

Prerequisites

  • Laravel Sail running (vendor/bin/sail up -d)
  • Database migrated (vendor/bin/sail artisan migrate)
  • At least one workspace with a user member
  • At least one OperationRun record (with and without tenant_id)

Verification Steps

1. Canonical detail renders

# Visit as authenticated workspace member
# URL: /admin/operations/{run_id}
# Expected: Full infolist renders (summary, target scope, verification report, counts, context JSON)

2. Auto-generated tenant routes are gone

vendor/bin/sail artisan route:list --name=filament.admin.resources.operations
# Expected: No routes listed (empty output)

3. Canonical list still works

# Visit: /admin/operations
# Expected: Workspace-scoped table with status tabs, filters

4. Run tests

# Run the focused test pack for this spec:
vendor/bin/sail artisan test --compact \
  tests/Feature/Operations/TenantlessOperationRunViewerTest.php \
  tests/Feature/Monitoring/OperationsCanonicalUrlsTest.php \
  tests/Feature/Monitoring/OperationsTenantScopeTest.php \
  tests/Feature/Verification/VerificationAuthorizationTest.php \
  tests/Feature/OpsUx/FailureSanitizationTest.php \
  tests/Feature/OpsUx/CanonicalViewRunLinksTest.php \
  tests/Feature/Verification/VerificationDbOnlyTest.php \
  tests/Feature/Verification/VerificationReportRenderingTest.php

# Expected: All pass

5. Pint formatting

vendor/bin/sail bin pint --dirty

Key Files to Inspect

File What to check
app/Filament/Resources/OperationRunResource.php getPages() returns []
app/Filament/Pages/Operations/TenantlessOperationRunViewer.php Uses schema-based infolist, has related links header
app/Filament/Widgets/Operations/OperationsKpiHeader.php Returns empty stats when no tenant context
app/Filament/Pages/Monitoring/Operations.php Unchanged — still reuses OperationRunResource::table()

What Was Deleted

File Why
app/Filament/Resources/OperationRunResource/Pages/ViewOperationRun.php Replaced by TenantlessOperationRunViewer
app/Filament/Resources/OperationRunResource/Pages/ListOperationRuns.php Replaced by Operations.php
app/Livewire/Monitoring/OperationsDetail.php Dead code
resources/views/livewire/monitoring/operations-detail.blade.php Dead code