ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
a5b7300ca9
TenantAtlas/specs/387-review-publication-resolution-decision-ux-v1/checklists/requirements.md
ahmido aca0b10658 feat: add review publication resolution ux spec and tests (#458) 
Automated PR created by Codex via Gitea API.

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #458
2026-06-19 08:49:26 +00:00

4.2 KiB
Raw Blame History

Requirements Checklist: Spec 387 - Review Publication Resolution Decision UX v1

Purpose: Preparation-readiness checklist for Spec 387 artifacts only. Created: 2026-06-18 Feature: specs/387-review-publication-resolution-decision-ux-v1/spec.md

Candidate Selection And Scope

  • CHK001 The candidate source is the direct user-provided Spec 387 draft attachment.
  • CHK002 The active auto-prep queue in docs/product/spec-candidates.md is acknowledged as empty/no-safe-automatic-target, and this spec is treated as manual user-provided promotion.
  • CHK003 Completed Spec 386 is treated as implementation context only and is not rewritten or normalized.
  • CHK004 The original draft is narrowed to residual UX/copy/state/confirmation/readonly hardening already not fully covered by repo truth.
  • CHK005 Close alternatives are deferred instead of hidden inside the scope.

Constitution And Architecture Fit

  • CHK006 The spec forbids new persistence, migrations, route families, global search resources, navigation entries, workflow engines, adapter registries, and auto-publish behavior.
  • CHK007 The spec requires existing Spec 386 RBAC, audit, source-owned actions, failure redaction, and no-auto-publish guarantees to remain intact.
  • CHK008 The plan keeps OperationRun start/completion/link UX delegated to existing helpers and services.
  • CHK009 Provider-specific details remain behind existing proof/diagnostic boundaries.
  • CHK010 Proportionality review rejects a new generic presenter/framework by default.

UI/Productization Coverage

  • CHK011 UI Surface Impact is explicit and consistent with an existing page/copy/action-modal hardening pass without claiming a new modal/action or planned customer-facing surface change.
  • CHK012 UI/Productization Coverage reuses UI-101, UI-040, and UI-006 context without inventing a new route taxonomy.
  • CHK013 Decision-first surface role, audience-aware disclosure, UI classification, and operator surface contract are complete for the affected surfaces.
  • CHK014 Technical proof is required to stay collapsed/default-secondary.
  • CHK015 Customer-safe non-leakage is a required negative regression, not a new customer resolution feature.

Filament / Livewire / Actions

  • CHK016 Filament v5 / Livewire v4 compliance is stated.
  • CHK017 Laravel 12 panel provider location is stated as apps/platform/bootstrap/providers.php, with no provider change planned.
  • CHK018 No global-searchable Resource is added.
  • CHK019 Destructive/high-impact actions remain ->action(...) actions with ->requiresConfirmation(), server authorization, audit, and tests.
  • CHK020 Asset strategy is stated as no new registered Filament assets expected.

Tests And Validation

  • CHK021 Tasks include tests before implementation tasks.
  • CHK022 Tasks include focused Feature/Filament assertions for decision copy, internal term absence, confirmation copy, readonly execution denial, and no Publish action.
  • CHK023 Tasks include browser smoke/screenshot coverage for desktop, mobile, modal, proof disclosure, readonly, and customer no-leakage states.
  • CHK024 Validation commands use Sail-first paths and include focused Spec 387, Spec 386 regression, browser, Pint, and git diff --check.
  • CHK025 No full-suite success is implied by the preparation artifacts.

Analyze Outcome

  • CHK026 Preparation artifacts are consistent on scope: residual UX hardening only.
  • CHK027 No requirement in tasks.md expands beyond spec.md or plan.md.
  • CHK028 Open questions are non-blocking.
  • CHK029 Candidate Selection Gate passes with scope reduction.
  • CHK030 Spec Readiness Gate passes for a later implementation loop.

Review Outcome

  • CHK031 Review outcome class: acceptable-special-case.
  • CHK032 Workflow outcome: keep.
  • CHK033 Final note location: active feature PR close-out entry Smoke Coverage / UX Hardening / No New Workflow Mechanics.

Notes

  • This checklist validates preparation readiness only.
  • No application implementation, runtime tests, browser smoke execution, or application code changes have been performed in this preparation step.