ahmido
9a564d6bf2
Implemented the consolidated operator guidance panel for the environment dashboard. Updated EnvironmentDashboardSummaryBuilder to prioritize and select guidance based on the operator guidance contract. Added comprehensive unit, feature, and browser tests to verify the guidance selection logic and UI rendering. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #423
4.0 KiB
UI-002 Environment Dashboard
| Field | Value |
|---|---|
| Route | /admin/workspaces/{workspace}/environments/{environment} |
| Source | EnvironmentDashboard, managed-environment widgets |
| Area / scope | Environment dashboard / environment-bound |
| Archetype | Overview / Dashboard |
| Design depth | Strategic Surface |
| Repo truth | repo-verified |
| Screenshot | ../../../specs/352-environment-dashboard-operator-guidance-consolidation/artifacts/screenshots/spec352-environment-dashboard-provider-blocker.png |
| Browser status | Re-verified on 2026-06-04 with Spec 352 browser-smoke states for provider blocker, review-output follow-up, and no-urgent-action. |
First Five Seconds
The page now answers the first operator question immediately. The selected environment is visible, the dominant blocker or calm state is named explicitly, and the next safe navigation step is isolated into one primary action.
Productization Review
- Decision-first: strong.
- Evidence-first: good. Proof remains visible, but it no longer competes with the first decision.
- Context: workspace + environment route is explicit.
- Customer/auditor safety: operator-facing. Review-output language is reused from the customer-review guidance path without introducing dashboard-local mutation semantics.
- Diagnostics: verification and health details should stay progressive.
Information Inventory
Default content now starts with one derived operator-guidance case:
- status
- title
- reason
- impact
- one primary navigation CTA
- compact secondary links when repo-real
Secondary surfaces remain visible below and beside the decision card:
- readiness dimensions
- readiness proof
- recommended next actions
- supporting signals
- collapsed diagnostics
The existing dashboard cards and proof rails remain repo-real, but they are clearly subordinate to the top guidance block.
Dangerous Actions
The dashboard remains navigation-first in this slice. It does not execute publish, refresh, verification, restore, or provider mutations directly. Dangerous scope stays owned by the linked surfaces.
Scores
| IA | Density | User Clarity | Sellability | Disclosure | Hierarchy | DS Fit | A11y | Responsive | Components | UX Writing | Perf |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 4 | 4 | 5 | 5 | 4 | 5 | 4 | 4 | 4 | 4 | 5 | 4 |
Top Issues
- Calm states can still show secondary proof gaps such as review freshness or evidence absence; this is acceptable repo truth, but it requires disciplined copy so the page does not feel contradictory.
- Provider, review-output, and recovery guidance now share a common top slot, so future slices must keep the action-label language aligned.
- The recommended-actions section is now intentionally subordinate; future additions must keep it from reintroducing a second primary rail.
Guidance Hierarchy
Implemented in Spec 352:
- provider blocker / required permissions
- review-output resolution guidance
- operation attention
- findings / overdue findings
- risk exceptions
- recovery posture
- continue review
- calm no-urgent-action fallback
Review-output reuse is navigation-first and pulls from the existing ReviewPackOutputResolutionAdapter. Successor drafts no longer hide the published review-output state when the dashboard decides what should happen first.
Screenshot Set
../../../specs/352-environment-dashboard-operator-guidance-consolidation/artifacts/screenshots/spec352-environment-dashboard-provider-blocker.png../../../specs/352-environment-dashboard-operator-guidance-consolidation/artifacts/screenshots/spec352-environment-dashboard-review-output.png../../../specs/352-environment-dashboard-operator-guidance-consolidation/artifacts/screenshots/spec352-environment-dashboard-no-urgent-action.png
Target Direction
Implemented by Spec 352 as a bounded follow-up: the Environment Dashboard is now the environment command surface with one dominant operator recommendation, preserved proof rails, and no new dashboard-local mutation workflow.