TenantAtlas/specs/273-tenant-dashboard-active-operations-summary-card/checklists/requirements.md
ahmido 2952e5ad3e feat: polish tenant dashboard operations attention UX (#338)
## Summary
- rename the tenant dashboard operations KPI to attention-first wording and keep the primary header CTA derived from the highest-priority recommended action
- restyle the `Operations requiring attention` card to match the existing neutral dashboard card language while keeping only a subtle per-item attention accent
- replace technical operation identifiers on the dashboard with calmer timing/copy, including provider-consent follow-up messaging for blocked permission posture checks
- refresh the local Spec Kit artifacts for spec 273 so the branch documentation matches the implemented attention-only dashboard scope

## Validation
- `export PATH="/bin:/usr/bin:/usr/local/bin:$PATH" && cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/Dashboard/TenantDashboardProductizationSummaryTest.php tests/Feature/Dashboard/TenantDashboardProductizationActionsTest.php tests/Feature/Dashboard/TenantDashboardProductizationAuthorizationTest.php tests/Feature/Filament/DashboardKpisWidgetTest.php tests/Feature/Filament/TenantDashboardDbOnlyTest.php tests/Browser/Dashboard/TenantDashboardProductizationSmokeTest.php`
- `export PATH="/bin:/usr/bin:/usr/local/bin:$PATH" && cd apps/platform && ./vendor/bin/sail bin pint --dirty --format agent`

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #338
2026-05-07 16:55:17 +00:00

5.6 KiB

Specification Quality Checklist: Tenant Dashboard Active Operations Summary Card

Purpose: Validate specification completeness, boundedness, and readiness before implementation
Created: 2026-05-07
Feature: spec.md

Content Quality

  • The package stays on one compact Tenant Dashboard active-operations summary card over existing OperationRun truth instead of widening into a full shell banner, dashboard-native operations console, or new widget framework.
  • The spec remains product- and behavior-oriented rather than reading like a low-level implementation diff.
  • The package explicitly names the repo-real anchors it builds on: TenantDashboardSummaryBuilder, TenantDashboardOverview, ActiveRuns, OperationRunLinks, OperationUxPresenter, existing OperationRun dashboard scopes, and the current dashboard Feature and browser proof owners.
  • Mandatory repo sections for scope, shared-pattern reuse, Ops-UX, testing, proportionality, and manual-promotion rationale are completed.

Requirement Completeness

  • No unresolved clarification markers remain.
  • Requirements stay testable and bounded to the no-active hidden state, queued or running visible state, stale or follow-up-needed priority, canonical links, visibility or capability gating, and tenant or workspace isolation.
  • The package explicitly preserves one dominant View operation action plus the neutral canonical Show all operations action.
  • The package explicitly forbids a full dashboard shell banner, new persistence, new lifecycle ownership, a new widget family, a route or panel family change, provider or asset changes, and raw diagnostics expansion.
  • Planned validation commands now match across spec.md, plan.md, and tasks.md.

Candidate Selection Gate

  • The selected candidate exists in docs/product/spec-candidates.md and is a deliberate manual promotion that stays directionally consistent with the roadmap's dashboard/core-surface guidance after Specs 268 through 272, even though it is not called out as an explicitly ranked roadmap item.
  • The automatic next-best-prep queue is intentionally empty, so this package records itself as a deliberate manual promotion rather than an automatic queue pick.
  • Repo verification confirms the current Tenant Dashboard already has the Active operations KPI and Recent operations history surface but still lacks the dedicated compact active-operations summary card this package defines.
  • The chosen slice is smaller and safer than deferred alternatives such as a dashboard shell-banner rollout, a new dashboard operations console, or broader progress redesign work.

Feature Readiness

  • The package reuses current OperationRun truth and current dashboard summary composition instead of introducing a second lifecycle, a persisted projection, or a dashboard-only query family.
  • The package explicitly keeps tenant or workspace isolation and 404 or suppression behavior intact for non-members and actors without OperationRun visibility.
  • The package forbids new panel, provider, global-search, asset-registration, queue-family, notification-policy, and raw-diagnostics changes.
  • The tasks artifact names the likely implementation and proof files already identified in plan.md.
  • The review artifact, workflow outcome, and test-governance outcome are carried into the active prep package.

Test Governance

  • Planned proof stays bounded to focused Feature coverage plus one named dashboard Browser smoke.
  • No new heavy-governance family or broad browser family is introduced by default.
  • Fixture growth remains bounded to current tenant dashboard helpers, OperationRun factories, tenant context setup, and the existing dashboard browser scaffolding.
  • The proving commands stay file-scoped, run through Sail, and keep DB-only visibility or isolation proof explicit instead of widening into unrelated lanes.

Notes

  • Reviewed against specs/273-tenant-dashboard-active-operations-summary-card/spec.md, specs/273-tenant-dashboard-active-operations-summary-card/plan.md, specs/273-tenant-dashboard-active-operations-summary-card/tasks.md, docs/product/spec-candidates.md, docs/product/roadmap.md, .specify/memory/constitution.md, docs/ui/tenantpilot-enterprise-ui-standards.md, apps/platform/app/Support/TenantDashboard/TenantDashboardSummaryBuilder.php, apps/platform/resources/views/filament/widgets/dashboard/tenant-dashboard-overview.blade.php, apps/platform/tests/Feature/Dashboard/TenantDashboardProductizationSummaryTest.php, apps/platform/tests/Feature/Dashboard/TenantDashboardProductizationActionsTest.php, apps/platform/tests/Feature/Filament/TenantDashboardDbOnlyTest.php, and apps/platform/tests/Browser/Dashboard/TenantDashboardProductizationSmokeTest.php on 2026-05-07.
  • This checklist is the prep-time outcome record. If implementation widens into a full shell banner, a new widget family, new progress semantics, new persistence, route or panel changes, or raw-diagnostics expansion, the workflow outcome must change before merge.
  • No application implementation was performed while preparing this package.

Review Outcome

  • Outcome class: acceptable-special-case
  • Workflow outcome: keep
  • Test-governance outcome: keep
  • Reason: the automatic queue is intentionally empty, but repo truth still shows one bounded unspecced dashboard seam after Specs 268 through 272: the Tenant Dashboard already has aggregate and recent-history signals, yet still lacks the compact active-operations summary card this package defines.
  • Workflow result: Ready for implementation.