ahmido
2f7a521d5f
## Summary - add the full workspace/environment context browser verification audit for Spec 313 - include the surface matrix, query and clear-filter inventories, ownership map, and audit report - attach browser evidence artifacts and screenshots for the current workspace/environment context contract ## Testing - no automated tests run; this is an analysis-only spec and artifact package with no runtime changes Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #368
62 lines
3.9 KiB
Markdown
62 lines
3.9 KiB
Markdown
# Requirements Checklist: Full Workspace / Environment Context Browser Verification Audit
|
|
|
|
**Purpose**: Preparation-readiness checklist for Spec 313.
|
|
**Scope**: Spec Kit artifacts only. The audit itself runs later.
|
|
|
|
## Candidate Selection Gate
|
|
|
|
- [x] CHK001 The selected candidate was directly supplied by the user as Spec 313.
|
|
- [x] CHK002 The candidate is not an existing completed spec package.
|
|
- [x] CHK003 Related Specs 311 and 312 are treated as completed historical context, not rewritten.
|
|
- [x] CHK004 The candidate aligns with post-Spec-311 scope-risk follow-up needs and the user-provided audit finding.
|
|
- [x] CHK005 The scope is narrowed to analysis-only audit artifacts and browser verification evidence.
|
|
- [x] CHK006 Runtime fixes, refactors, migrations, tests, seeders, routes, resources, pages, views, config, and follow-up specs are explicitly out of scope.
|
|
- [x] CHK006A The product-roadmap note that had recommended Spec 313 for Decision-Based Governance Inbox v1 is documented as a numbering deviation, not edited in this preparation-only package.
|
|
|
|
## Spec Readiness
|
|
|
|
- [x] CHK007 `spec.md` exists.
|
|
- [x] CHK008 `plan.md` exists.
|
|
- [x] CHK009 `tasks.md` exists.
|
|
- [x] CHK010 Spec Candidate Check is completed.
|
|
- [x] CHK011 Functional requirements are behavior-oriented and testable.
|
|
- [x] CHK012 Acceptance criteria include surface discovery, browser verification, completeness, evidence, reporting, and safety.
|
|
- [x] CHK013 Allowed final statuses are fixed and match the user-provided completion gate.
|
|
- [x] CHK014 The spec forbids "likely OK" as a final status.
|
|
- [x] CHK015 Reports / Stored Reports and Support Requests are called out as must-classify surfaces.
|
|
- [x] CHK016 High-risk pages are named explicitly.
|
|
|
|
## Repo Alignment
|
|
|
|
- [x] CHK017 The plan identifies `AdminPanelProvider`, `WorkspaceSidebarNavigation`, admin routes, Filament pages/resources/clusters, views, workspace/environment dashboard builders, and link/context helpers as discovery sources.
|
|
- [x] CHK018 The plan reflects current repo seams observed during preparation: `WorkspaceContext`, `OperateHubShell`, `ManagedEnvironmentLinks`, `OperationRunLinks`, `ProviderConnectionResource`, `FindingExceptionsQueue`, `EvidenceOverview`, `ReviewRegister`, `CustomerReviewWorkspace`, `GovernanceInbox`, and `DecisionRegister`.
|
|
- [x] CHK019 Filament v5 / Livewire v4 compliance is stated.
|
|
- [x] CHK020 Provider registration location remains `apps/platform/bootstrap/providers.php`; no provider changes planned.
|
|
- [x] CHK021 Global search behavior is not modified.
|
|
- [x] CHK022 Destructive actions are not added or changed.
|
|
- [x] CHK023 Asset strategy is unchanged; no new `filament:assets` requirement.
|
|
|
|
## Audit Output Readiness
|
|
|
|
- [x] CHK024 Required report files are listed.
|
|
- [x] CHK025 Required screenshot directory is listed.
|
|
- [x] CHK026 Matrix schemas are defined for surface inventory, page matrix, query-param inventory, clear-filter inventory, and code ownership map.
|
|
- [x] CHK027 Browser origins are defined: workspace origin, environment sidebar origin, environment CTA origin, manual filter origin, reload, and back/forward.
|
|
- [x] CHK028 Data-scope proof rules forbid guessing without seeded rows or visible UI evidence.
|
|
- [x] CHK029 Missing seed data and browser/tooling limitations are explicit blocker categories.
|
|
|
|
## Safety
|
|
|
|
- [x] CHK030 The preparation package does not require application implementation.
|
|
- [x] CHK031 The tasks include no-runtime-change validation.
|
|
- [x] CHK032 The tasks forbid test, migration, seeder, route, resource, page, view, config, and runtime edits.
|
|
- [x] CHK033 The tasks require `git diff --name-only` and `git diff --check`.
|
|
- [x] CHK034 No follow-up spec 314+ is started inside Spec 313.
|
|
|
|
## Review Outcome
|
|
|
|
- [x] CHK035 Review outcome class: `acceptable-special-case`.
|
|
- [x] CHK036 Workflow outcome: `keep`.
|
|
- [x] CHK037 Candidate Selection Gate passes.
|
|
- [x] CHK038 Spec Readiness Gate passes for preparation.
|