From 86f887afa5848ec97b50ac2b3a0219621f2fc907 Mon Sep 17 00:00:00 2001 From: shunli Date: Fri, 29 May 2026 22:35:57 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=E5=B7=A5=E4=BD=9C?= =?UTF-8?q?=E5=8F=B0=E4=BB=BB=E5=8A=A1=E4=BC=98=E5=85=88=E9=AA=8C=E6=94=B6?= =?UTF-8?q?=EF=BC=88portal-task-first-redesign=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../spec/hyb-oa/frontend-react-vite-design.md | 3 ++ .../05-29-portal-task-first-redesign/prd.md | 35 +++++++++++++------ 2 files changed, 27 insertions(+), 11 deletions(-) diff --git a/.trellis/spec/hyb-oa/frontend-react-vite-design.md b/.trellis/spec/hyb-oa/frontend-react-vite-design.md index 4e92a53d..2beca0ec 100644 --- a/.trellis/spec/hyb-oa/frontend-react-vite-design.md +++ b/.trellis/spec/hyb-oa/frontend-react-vite-design.md @@ -327,6 +327,9 @@ before doing work. - Focused Playwright coverage for changed workbench or profile routes. - Screenshot evidence for first-login welcome, workbench first screen and profile default view when changing these surfaces. +- Workbench baseline screenshots must explicitly clear onboarding localStorage + such as `hyb_oa_show_welcome` and `hyb_oa_onboarding_active` before capture, + unless the test is intentionally verifying the welcome dialog. ## Convention: Detail And Mobile Command Surfaces diff --git a/.trellis/tasks/05-29-portal-task-first-redesign/prd.md b/.trellis/tasks/05-29-portal-task-first-redesign/prd.md index 25727bc3..94ad7300 100644 --- a/.trellis/tasks/05-29-portal-task-first-redesign/prd.md +++ b/.trellis/tasks/05-29-portal-task-first-redesign/prd.md @@ -90,17 +90,17 @@ ## Acceptance Criteria -- [ ] 工作台首屏不再出现大欢迎卡片。 -- [ ] 工作台首屏不再出现 `当前焦点`、`下一步`、`团队与通知`、`角色重点`、`试点观测摘要` 旧文案。 -- [ ] 有待处理事项时，`今日待处理` 直接展示可行动事项和明确下一步。 -- [ ] 没有待处理事项时，页面显示极简空状态，不出现空壳模块。 -- [ ] `报销进度` 不作为固定按钮出现；只有可靠状态数据时才进入进度区域。 -- [ ] 普通通知不在工作台主区重复展示。 -- [ ] 团队卡点和管理提醒仅在真实异常/阻塞存在时出现。 -- [ ] 普通员工、审批人/负责人、财务/管理员视图均符合任务优先规则。 -- [ ] `cd client && npm run typecheck` 通过。 -- [ ] `cd client && npm run build` 通过。 -- [ ] 聚焦 Playwright/截图验证通过，并保存重构后截图证据。 +- [x] 工作台首屏不再出现大欢迎卡片。 +- [x] 工作台首屏不再出现 `当前焦点`、`下一步`、`团队与通知`、`角色重点`、`试点观测摘要` 旧文案。 +- [x] 有待处理事项时，`今日待处理` 直接展示可行动事项和明确下一步。 +- [x] 没有待处理事项时，页面显示极简空状态，不出现空壳模块。 +- [x] `报销进度` 不作为固定按钮出现；只有可靠状态数据时才进入进度区域。 +- [x] 普通通知不在工作台主区重复展示。 +- [x] 团队卡点和管理提醒仅在真实异常/阻塞存在时出现。 +- [x] 普通员工、审批人/负责人、财务/管理员视图均符合任务优先规则。 +- [x] `cd client && npm run typecheck` 通过。 +- [x] `cd client && npm run build` 通过。 +- [x] 聚焦 Playwright/截图验证通过，并保存重构后截图证据。 ## Technical Notes @@ -127,6 +127,19 @@ - 审批人/负责人 PC 工作台 - 财务/管理员 PC 工作台 +## Verification Record + +2026-05-29 已完成本轮前端验证： + +- `cd client && npm run typecheck`：通过。 +- `cd client && npm run build`：通过。 +- `cd client && npx playwright test tests/e2e/visual-portal.spec.ts --workers=1 --reporter=list`：3 passed。 +- `cd client && npx playwright test tests/e2e/visual-shell.spec.ts --workers=1 --reporter=list`：5 passed。 +- `cd client && npx playwright test tests/e2e/login-portal-ux.spec.ts --workers=1 --reporter=list`：12 passed。 +- `python3 ./.trellis/scripts/task.py validate 05-29-portal-task-first-redesign`：通过。 +- `git diff --check`：通过。 +- 截图证据已保存到 `output/playwright/portal-task-first-redesign/portal-employee.png`、`portal-admin.png`、`portal-finance.png`；员工截图已复核并清除了欢迎弹窗遮罩污染。 + ## Approved Addendum: 待处理页面任务优先整改 2026-05-29 用户确认对 `/workflow/tasks` 做小范围页面整改，目标是让审批人逐单看详情后谨慎处理，只有低风险事项保留列表页快捷通过。