boardx / boardx/workspacex

[F16] 全站终验收官:机械门控全绿 + 十维评分重算并附证据

Open
#1,878 0 comments 0 reactions 0 assignees View on GitHub
area:governance sprint:12-01
Dominant language
TypeScript
Stars
0
Forks
0
Avg merge
1h 7m
Merged PRs (30d)
969

Description

## 交付契约(user_visible_behavior)

全量跑通 lint-design.sh(含新增 U9 第三方组件规则、扩展后 U7a 图片规则)、check-token-contrast.mjs 对比度门控、axe-core 全站扫描(chat/profile/org-admin/canvas)、F05/F06 的键盘走查自动化用例,均无回归;./init.sh 基础验证与 pnpm harness doctor 三条检查通过;对照《十分制评估》十维评分逐维重算并贴证据;未闭合缺口如实记录为下一阶段待办,不虚报达标。

## Story

[requirements/10-final-verification-sweep.md](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/requirements/10-final-verification-sweep.md) — 章节 `R3`

## 验证(完成的唯一标准:每条命令退出码 0)

- [ ] `pnpm --filter web run lint:design`
- [ ] `pnpm --filter web run contrast`
- [ ] `pnpm --filter web exec playwright test -c playwright.config.ts -g 'axe full-site'`
- [ ] `pnpm --filter web exec playwright test -c playwright.config.ts -g 'keyboard'`

证据落盘:`phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F16.verify.log`

## 实现指引(notes)

依据等级:[Backlog](IT-10;本阶段收官治理性 feature)。R8:本身不产出新可见 UI(除验证中发现的小修复),一般不需新签核,但需确认阶段级 design-coherence.md(一致性复核)已完成。R2:依赖前 9 个需求(F01-F15)全部 passing 后触发。R7:终验分数必须有可复现证据链,不凭印象打分;R4-E2 分数未达 10 分如实报告差距而非调整标准凑分。verification 覆盖 lint-design/contrast/axe/键盘走查四类机械门控;init.sh 与 harness doctor 由收尾流程另行执行并写入 evidence。

## 设计参照

(无 UI 或沿用现有界面)

## 前置依赖

- `F01` — 已就绪
- `F02` — 已就绪
- `F03` — 已就绪
- `F04` — 已就绪
- `F05` — 已就绪
- `F06` — 已就绪
- `F07` — 已就绪
- `F08` — 已就绪
- `F09` — 已就绪
- `F10` — 已就绪
- `F11` — 已就绪
- `F12` — 已就绪
- `F13` — 已就绪
- `F14` — ⚠ 未就绪(not_started),就绪前不要开工
- `F15` — 已就绪

## 元数据

| phase | sprint | 能力平面 | 优先级 | wave | area |
|---|---|---|---|---|---|
| 12 | 01 | - | Pundefined | - | governance |

## 开工流程(agent 必读)

> 本 issue 是仓库的**只读投影**;权威是 [`phases/phase-12-uiux-foundation/feature_list.json`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/feature_list.json)。若两者不一致,以仓库为准。

1. 环境:`./init.sh`(验证失败先修基础状态,别在坏地基上开工)。
2. 认领:`pnpm harness claim --phase 12 --feature F16 --owner <你的-agent-id>`(同一 owner 同时最多一个 in_progress)。
3. 读上下文:[`requirements/`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/requirements)(原始需求)、[`contracts/`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/contracts)(本 feature 所属契约束:`ui.md` 给组件落点与 data-testid,`usecases.md` 给失败模式,`design-signoff.md` 给签核状态)、[`sprints/sprint-01/session-handoff.md`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/sprints/sprint-01/session-handoff.md)(上一轮交接)。
4. 实现:只做本 feature 的最小实现,不顺手重构无关区域;不碰 `active-features.json`(脚本派生只读)。
5. 验证:逐条跑上方 verification,输出留到 `phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F16.verify.log`;然后 `pnpm harness verify --sprint 12/01 --feature F16` 门控转 passing——**不允许手改 status**。
6. 提交:分支 `worker/-12-f16-`,PR 关联本 issue(`Closes #<本 issue 号>`),收尾更新 progress.md 与 session-handoff.md。

完整硬约束见 [`AGENTS.md`](https://github.com/boardx/workspacex/blob/main/AGENTS.md);多 agent 协作规则见 [`.harness/instructions/multi-agent-coordination.md`](https://github.com/boardx/workspacex/blob/main/.harness/instructions/multi-agent-coordination.md)。

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by running ./init.sh and checking F14 status, then read requirements/10-final-verification-sweep.md, the phase contracts, and sprint-01/session-handoff.md. Run the four listed pnpm verification commands and record results in phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F16.verify.log. Done means every command exits 0, scoring evidence is reproducible, and harness verification passes without overstating gaps.

Written by the indexing model from the issue text.

Assessment

Tech stack
playwright, typescript
Domain
accessibility, testing
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.