ahmido
3eff4d8579
## Summary - add the Spec 325 artifacts for screenshot-anchored strategic target images - update the UI/UX enterprise audit documents to capture strategic surfaces and grouped follow-up candidates - add supporting follow-up specs, target experience briefs, and target image assets for the audit workflow ## Testing - not run (documentation/spec artifact changes only) Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #385
67 lines
8.7 KiB
Markdown
67 lines
8.7 KiB
Markdown
# Strategic Target Image Shortlist
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| Spec | Spec 325 - Screenshot-Anchored Strategic Target Images & Experience Briefs |
|
|
| Selection date | 2026-05-17 |
|
|
| Branch | `325-screenshot-anchored-strategic-target-images` |
|
|
| Base commit inspected | `e35706b8` |
|
|
| Source baseline | Spec 323 audit artifacts and Spec 324 UI coverage guardrails |
|
|
| Runtime posture | Docs/image artifacts only |
|
|
| Premium visual reference | `../target-images/reference/spec-325-premium-reference/` |
|
|
|
|
## Selection Rationale
|
|
|
|
The shortlist selects 9 P0/P1 surfaces from the 44 strategic rows in `../strategic-surfaces.md`. This stays within the Spec 325 maximum of 10 surfaces while covering the highest-value product narratives: workspace entry, environment posture, operations truth, governance decisions, customer-safe review, audit proof, restore safety, provider readiness, and drift/baseline decisions.
|
|
|
|
All 44 strategic rows are not covered because many rows are detail variants, CRUD-adjacent pages, repeated domain lists, system-plane surfaces, or pages that require a separate seeded fixture or pattern-library pass. Spec 325 is a target-image direction wave, not an all-surface redesign.
|
|
|
|
## Premium Visual Reference Decision
|
|
|
|
The user accepted four premium visual references as final enough for the Tenantial target direction:
|
|
|
|
- `../target-images/reference/spec-325-premium-reference/platform-overview-premium-reference.png`
|
|
- `../target-images/reference/spec-325-premium-reference/governance-inbox-premium-reference.png`
|
|
- `../target-images/reference/spec-325-premium-reference/backup-restore-premium-reference.png`
|
|
- `../target-images/reference/spec-325-premium-reference/evidence-audit-premium-reference.png`
|
|
|
|
These references supersede the first generated Spec 325 PNGs as visual-quality calibration. The earlier generated images remain useful as IA/content scaffolds only. The accepted reference direction is dark, dense, calm, premium, enterprise-grade, sidebar/topbar anchored, and workbench-oriented.
|
|
|
|
Runtime implementation must not copy the reference images blindly. Concrete metrics, dates, entities, success states, dangerous-action affordances, and shown actions are conceptual until repo-verified.
|
|
|
|
## Selected Surfaces
|
|
|
|
| ID | Surface | Priority | Persona | Source screenshot | Source report | Target brief | Target images | Repo-truth notes |
|
|
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
|
| UI-001/UI-002 | Workspace Overview | P0 | Workspace owner / MSP operator | `../screenshots/desktop/ui-001-workspace-overview.png` | `../page-reports/ui-001-workspace-overview.md` | `workspace-overview.md` | `../target-images/target/workspace-overview-target-dark.png`, `../target-images/target/workspace-overview-target-light.png` | Repo-verified route and screenshot; target simplifies competing next actions. |
|
|
| UI-011 | Environment Dashboard | P0 | Environment operator | `../screenshots/desktop/ui-002-environment-dashboard.png` | `../page-reports/ui-002-environment-dashboard.md` | `environment-dashboard.md` | `../target-images/target/environment-dashboard-target-dark.png`, `../target-images/target/environment-dashboard-target-light.png` | Repo-verified route and screenshot; target separates posture, proof, and diagnostics. |
|
|
| UI-016 | Operations Hub | P0 | Operations responder | `../screenshots/desktop/ui-003-operations.png` | `../page-reports/ui-003-operations.md` | `operations-hub.md` | `../target-images/target/operations-hub-target-dark.png`, `../target-images/target/operations-hub-target-light.png` | Repo-verified route and screenshot; target keeps execution truth separate from governance health. |
|
|
| UI-028 | Governance Inbox | P0 | Governance operator | `../screenshots/desktop/ui-004-governance-inbox.png` | `../page-reports/ui-004-governance-inbox.md` | `governance-inbox.md` | `../target-images/target/governance-inbox-target-dark.png`, `../target-images/target/governance-inbox-target-light.png` | Repo-verified route and screenshot; target makes the human decision moment explicit. |
|
|
| UI-038 | Customer Review Workspace | P0 | Customer reviewer / auditor | `../screenshots/desktop/ui-006-customer-review-workspace.png` | `../page-reports/ui-006-customer-review-workspace.md` | `customer-review-workspace.md` | `../target-images/target/customer-review-workspace-target-dark.png`, `../target-images/target/customer-review-workspace-target-light.png` | Repo-verified route and screenshot; target is customer-safe and evidence-first. |
|
|
| UI-025 | Audit Log | P0 | Auditor / security reviewer | `../screenshots/desktop/ui-008-audit-log.png` | `../page-reports/ui-008-audit-log.md` | `audit-log.md` | `../target-images/target/audit-log-target-dark.png`, `../target-images/target/audit-log-target-light.png` | Repo-verified route and screenshot; target turns raw event history into audit proof. |
|
|
| UI-053/UI-054 | Restore Safety Workflow | P0 | Restore operator / approver | `../screenshots/desktop/ui-014-restore-runs.png` | `../page-reports/ui-014-restore-runs.md` | `restore-safety-workflow.md` | `../target-images/target/restore-safety-workflow-target-dark.png`, `../target-images/target/restore-safety-workflow-target-light.png` | Route repo-verified but browser blocked by capability/state; target is constrained to safety workflow guidance. |
|
|
| UI-072/UI-073 | Provider Readiness | P0 | Provider administrator | `../screenshots/desktop/ui-009-provider-connections.png` | `../page-reports/ui-009-provider-connections.md` | `provider-readiness.md` | `../target-images/target/provider-readiness-target-dark.png`, `../target-images/target/provider-readiness-target-light.png` | Repo-verified route and screenshot; target focuses on connection health and permission readiness. |
|
|
| UI-061 | Baseline Compare / Drift | P0 | Governance operator | `../screenshots/desktop/ui-015-baseline-compare-blocked-404.png` | `../page-reports/ui-015-baseline-compare.md` | `baseline-compare-drift.md` | `../target-images/target/baseline-compare-drift-target-dark.png`, `../target-images/target/baseline-compare-drift-target-light.png` | Route repo-verified but browser blocked; target stays bounded to compare/readiness hierarchy. |
|
|
|
|
## Deferred Strategic Surfaces
|
|
|
|
| Deferred set | Reason | Recommended later coverage |
|
|
| --- | --- | --- |
|
|
| Decision Register, Exception Detail, Finding Detail | Closely related to governance inbox but require detail-state records. | Governance implementation wave after inbox pattern is accepted. |
|
|
| Review Register, Review Pack Detail, Stored Report Detail, Evidence Overview | Customer/evidence family needs customer-safe review pattern, but Customer Review Workspace and Audit Log provide first anchors. | Evidence/Review Pack consumption productization. |
|
|
| Backup Schedules, Backup Sets, Backup Set Create/View | Restore Runs selected as the highest-risk restore anchor; backup set pages need capability-backed fixtures. | Backup/Restore safety workflow spec with seeded browser proof. |
|
|
| Baseline Profiles, Baseline Profile Detail/Edit, Baseline Compare Matrix, Policy Version Detail | Baseline Compare selected as drift decision anchor; library/detail pages can follow after pattern validation. | Drift/Baseline decision experience. |
|
|
| Environment Access Scopes, Manage Workspaces, Managed Environments | Important RBAC/admin surfaces, but less central to first target-image wave than workspace/environment dashboards. | Admin/settings and access-control pattern spec. |
|
|
| Alerts and alert delivery/config pages | Operations Hub selected as the monitoring anchor; alert subresources can reuse the operations status grammar later. | Operations and alerting domain pattern. |
|
|
| Provider Connection Detail/Edit, Environment Onboarding, Required Permissions | Provider Connections selected as readiness anchor; forms and wizard need a later provider onboarding pass. | Provider onboarding/readiness UX cleanup. |
|
|
| System-plane dashboard, operations, repair, access logs | Platform/internal P2 surfaces and different auth plane. | System-plane controls target spec after admin-plane patterns settle. |
|
|
| Inventory coverage and policy version detail | Strategic but better handled with drift/evidence patterns and seeded records. | Inventory coverage and snapshot proof pattern. |
|
|
|
|
## Rejected Mockup Handling
|
|
|
|
No previous rejected Spec 325 SVG mockup artifacts were present in the working tree. `docs/ui-ux-enterprise-audit/mockups/.DS_Store` is an operating-system metadata file, not a mockup artifact. The rejected target-image folder still contains a README so future rejected explorations have a documented landing place.
|
|
|
|
## Not Implementation Truth
|
|
|
|
The target images linked from this shortlist are visual direction artifacts only. Later implementation specs must verify route reality, data availability, authorization, workspace/environment isolation, OperationRun semantics, auditability, dangerous-action behavior, and customer-safe visibility before coding.
|