PCDESIGN1 完成 PC 全页面设计审查

这个提交包含在:
2026-05-25 21:45:09 +08:00
父节点 c6f403742b
当前提交 7c65d418f3
共修改 5 个文件,包含 51 行新增和 3 行删除
@@ -0,0 +1,10 @@
"ID","Title","Description","Acceptance","Test_Method","Tools","Dev_Status","Review1_Status","Regression_Status","Files","Dependencies","Notes"
"PCDESIGN1-0","PCDESIGN1 审查范围与边界","建立 PC 全页面设计审查台账;以项目经理和设计总监视角覆盖 PC 路由、业务流程、页面设计、交互、内容组织和 KISS 建议;本轮只审查和规划,不改业务代码。","Issue CSV 校验通过;明确只读自动化、静态审查和人工观察边界;不创建业务数据、不付款、不写企微、不改变公网配置。","受影响流程:PC 页面审查启动 -> 读取产品设计规则 -> 读取路由和现有视觉证据 -> 明确 MAGI 审查节奏;验证步骤:validate_issues_csv;check-process-contract general;git diff --check。","python3|node|rg|manual","DONE","DONE","DONE","issues/2026-05-25_21-27-56-oa-pc-page-design-review-v1.csv;docs/产品设计规则.md;client/src/router/index.tsx","[]","已建 PCDESIGN1 合同并通过 validate_issues_csv/check-process-contract;MAGI 用作审查结构,不替代 OALAUNCH1,不代表批准改版。回滚路径:后续用新版 PCDESIGN CSV supersede;不影响运行。"
"PCDESIGN1-1","PC 路由与页面覆盖盘点","从 router、navigation schema、pages 目录和现有视觉矩阵中盘点 PC 页面;区分 A 核心流程、B 业务运营、C 管理配置、认证/错误页和移动页排除项。","形成 PC 页面覆盖表;标记哪些已由 Playwright 截图覆盖、哪些只能静态审查、哪些需要后续补自动化路线或人工样本。","受影响流程:路由解析 -> 页面分层 -> 角色权限 -> 覆盖缺口;验证步骤:rg router/schema/pages;读取 oafront3-pc-readonly summary;必要时只读复跑视觉矩阵。","rg|node|playwright|manual","DONE","DONE","DONE","client/src/router/index.tsx;client/src/features/navigation/schema.ts;client/tests/e2e/oafront3-pc-readonly-visual.spec.ts;artifacts/qa-flow/oafront3-pc-readonly-visual-*","[""PCDESIGN1-0""]","盘点静态 PC 路由 45 条,A/B/C 分层为 7/17/21;现有关键矩阵覆盖 32 条,新增一次性全静态扫描覆盖 45 条;动态详情页 5 条仍需真实样本 ID 补证。"
"PCDESIGN1-2","PC 只读自动化证据复核","复用或复跑公网 PC 只读视觉矩阵,覆盖多角色关键 PC 页面;结合 OAOPS1 日巡检和权限矩阵确认页面可达、无 UUID 主展示、无横向溢出、无加载失败。","生成或引用 summary.json;结论为 PASS 或可解释 finding;报告不含密码、token、Secret、完整账号、票据原图、合同正文、银行流水或原始 payload。","受影响流程:多角色登录 -> PC 路由访问 -> 截图/指标 -> finding 汇总;验证步骤:LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-oafront3-pc-readonly-visual.sh;读取 OAOPS1/权限矩阵。","bash|playwright|node","DONE","DONE","DONE","scripts/qa/run-oafront3-pc-readonly-visual.sh;artifacts/qa-flow/oafront3-pc-readonly-visual-*;artifacts/qa-flow/oa-real-use-daily-*","[""PCDESIGN1-1""]","公网复跑 artifacts/qa-flow/pcdesign1-pc-readonly-visual-20260525-2128/summary.json 为 PASS_PC_READONLY_VISUAL_READY,7 角色 32 关键路由 finding=0;全静态扫描 artifacts/qa-flow/pcdesign1-all-pc-static-20260525-2133/summary.json 为 PASS_PC_STATIC_ROUTE_SCAN_READY,45/45 PASS。"
"PCDESIGN1-3","A 类核心 PC 流程审查","审查工作台、报销列表/详情、审批待办/详情、通知、个人设置等高频页面;关注首屏任务、状态语义、下一步动作、详情事实源和审批进度可理解性。","形成 A 类页面问题与建议;优先级区分启用前 P0、稳定期 P1 和后置 P2;不得提出重型 ERP 化方案。","受影响流程:员工工作台 -> 报销 -> 审批/进度 -> 通知 -> 个人设置;验证步骤:现有截图/只读页面指标;必要时人工步骤说明。","playwright|rg|manual","DONE","DONE","DONE","client/src/pages/PortalHomePage.tsx;client/src/pages/ReimbursementsPage.tsx;client/src/pages/ReimbursementDetailPage.tsx;client/src/pages/WorkflowTasksPage.tsx;client/src/pages/WorkflowTaskDetailPage.tsx;client/src/pages/NotificationsPage.tsx;client/src/pages/ProfilePage.tsx","[""PCDESIGN1-2""]","A 类 7 条静态路由均 PASS;建议保留当前工作台/报销/审批主路径,后续优先补动态详情页样本证据,并把 Portal 二级信息继续按真实反馈收敛。"
"PCDESIGN1-4","B 类业务运营 PC 页面审查","审查票据池、采购/费用、合同台账、项目、付款批次、AP、资产、企微归档、考勤镜像、盘点、差旅/预算等 B 类页面;关注表格密度、筛选、默认视图和冻结项表达。","形成 B 类页面问题与建议;明确哪些进入 V1 小步优化,哪些继续冻结或只做入口降噪。","受影响流程:票据复核 -> 采购/合同/项目关联 -> 付款/AP -> 资产台账 -> HR/考勤镜像;验证步骤:PC 视觉矩阵、OAOPS1 只读探针、静态代码审查。","playwright|rg|manual","DONE","DONE","DONE","client/src/pages/InvoicePoolPage.tsx;client/src/pages/PurchaseRequestsPage.tsx;client/src/pages/ContractsRegistryPage.tsx;client/src/pages/ProjectsPage.tsx;client/src/pages/PaymentBatchesPage.tsx;client/src/pages/ApOperationsPage.tsx;client/src/pages/AssetRegistryPage.tsx;client/src/pages/WecomApprovalArchivePage.tsx;client/src/pages/AttendancePage.tsx;client/src/pages/InventoryChecksPage.tsx;client/src/pages/TravelRequestsPage.tsx;client/src/pages/BudgetsPage.tsx","[""PCDESIGN1-2""]","B 类 17 条静态路由均 PASS;主要设计建议是 HR/考勤相关 OA 提交入口与企微主办边界需收敛,资产/AP/合同/考勤等高密度页面需默认隐藏次要配置和测试噪声,预算/差旅继续标记后置或隐藏。"
"PCDESIGN1-5","C 类管理配置 PC 页面审查","审查人员、组织、部门、主数据、审批规则、流程定义、工作区、系统设置、功能开关、审计、切换、通知渠道和 ERP 集成等管理页;关注高密度信息是否可理解、危险操作是否收敛。","形成 C 类管理页问题与建议;允许内部编号和审计字段,但必须控制危险配置入口和文案。","受影响流程:管理员配置 -> 权限/审批/流程 -> 开关/审计 -> 集成/切换;验证步骤:PC 视觉矩阵、权限矩阵、静态代码审查;不保存配置。","playwright|rg|manual","DONE","DONE","DONE","client/src/pages/PeoplePage.tsx;client/src/pages/UserManagementPage.tsx;client/src/pages/OrganizationPage.tsx;client/src/pages/DepartmentsPage.tsx;client/src/pages/MasterDataPage.tsx;client/src/pages/ApprovalRulesPage.tsx;client/src/pages/WorkflowDefinitionsPage.tsx;client/src/pages/WorkspaceSetupPage.tsx;client/src/pages/SystemSettingsPage.tsx;client/src/pages/FeatureFlagsPage.tsx;client/src/pages/AuditLogsPage.tsx;client/src/pages/CutoverConsolePage.tsx;client/src/pages/NotificationChannelsPage.tsx;client/src/pages/ErpIntegrationPage.tsx","[""PCDESIGN1-2""]","C 类 21 条静态路由均 PASS;通知渠道、功能开关、ERP 集成等页面可保留工程术语但建议拆成安全摘要/高级配置,避免小团队日常管理员误操作。"
"PCDESIGN1-6","跨页面交互与内容一致性审查","审查全局导航、搜索、表格、筛选、空状态、错误页、确认弹窗、长编号、状态文案、按钮语义和测试数据显示策略。","输出跨页面共性问题;每个建议说明适用页面、收益、风险和是否需要后续代码合同。","受影响流程:导航 -> 搜索 -> 列表筛选 -> 详情 -> 操作确认 -> 空/错状态;验证步骤:读取共享组件和页面代码;PC 截图抽样;rg banned/internal terms。","rg|playwright|manual","DONE","DONE","DONE","client/src/components;client/src/layouts;client/src/features/navigation;client/src/pages","[""PCDESIGN1-3"",""PCDESIGN1-4"",""PCDESIGN1-5""]","跨页面硬指标无横向溢出/UUID/英文主词 finding;共性设计问题是说明文字偏多、C 类技术术语直接暴露、高密度页面默认视图不够任务化、冻结模块缺少统一降噪策略。"
"PCDESIGN1-7","PM/设计总监 KISS 建议包","基于证据把问题归类为保留、简化、隐藏/折叠、后置和人工 SOP;明确不应立刻做的大改版。","形成可审查建议清单;每条建议有页面范围、业务影响、优先级、自动证据、人工验证方法和采纳选项。","受影响流程:证据汇总 -> 问题排序 -> KISS 建议 -> 用户采纳/暂缓/拒绝;验证步骤:rg PCDESIGN1;人工复核建议表。","rg|manual","DONE","DONE","DONE","docs/trialrun/人工试运行报告.md;docs/文档索引.md;docs/文档事实源状态矩阵.md;.agents/skills/hyb-oa-delivery/SKILL.md","[""PCDESIGN1-6""]","已在人工试运行报告写入 PCDESIGN1 证据、页面覆盖、核心问题和 P0/P1/P2 建议;本行只产出建议,不直接进入实现;采纳后必须另建前端实施 Issue CSV。"
"PCDESIGN1-8","事实源回写与门禁","将 PCDESIGN1 审查结论登记到现有事实源;运行 Issue、文档和 skill 门禁。","validate_issues_csv、check-process-contract、audit-docs、quick_validate、git diff --check 通过或 warning 可解释;git status 最终可追踪。","受影响流程:文档回写 -> 门禁 -> 提交;验证步骤:validate_issues_csv;check-process-contract general;audit-docs --check-registry;quick_validate;git diff --check。","python3|node|git|manual","DONE","DONE","DONE","issues/2026-05-25_21-27-56-oa-pc-page-design-review-v1.csv;docs/trialrun/人工试运行报告.md;docs/文档索引.md;docs/文档事实源状态矩阵.md;.agents/skills/hyb-oa-delivery/SKILL.md","[""PCDESIGN1-7""]","本轮不部署、无业务代码改动;门禁通过后提交。后续若采纳实现,再按新实施合同进入开发、测试、部署。"
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
2 PCDESIGN1-0 PCDESIGN1 审查范围与边界 建立 PC 全页面设计审查台账;以项目经理和设计总监视角覆盖 PC 路由、业务流程、页面设计、交互、内容组织和 KISS 建议;本轮只审查和规划,不改业务代码。 Issue CSV 校验通过;明确只读自动化、静态审查和人工观察边界;不创建业务数据、不付款、不写企微、不改变公网配置。 受影响流程:PC 页面审查启动 -> 读取产品设计规则 -> 读取路由和现有视觉证据 -> 明确 MAGI 审查节奏;验证步骤:validate_issues_csv;check-process-contract general;git diff --check。 python3|node|rg|manual DONE DONE DONE issues/2026-05-25_21-27-56-oa-pc-page-design-review-v1.csv;docs/产品设计规则.md;client/src/router/index.tsx [] 已建 PCDESIGN1 合同并通过 validate_issues_csv/check-process-contract;MAGI 用作审查结构,不替代 OALAUNCH1,不代表批准改版。回滚路径:后续用新版 PCDESIGN CSV supersede;不影响运行。
3 PCDESIGN1-1 PC 路由与页面覆盖盘点 从 router、navigation schema、pages 目录和现有视觉矩阵中盘点 PC 页面;区分 A 核心流程、B 业务运营、C 管理配置、认证/错误页和移动页排除项。 形成 PC 页面覆盖表;标记哪些已由 Playwright 截图覆盖、哪些只能静态审查、哪些需要后续补自动化路线或人工样本。 受影响流程:路由解析 -> 页面分层 -> 角色权限 -> 覆盖缺口;验证步骤:rg router/schema/pages;读取 oafront3-pc-readonly summary;必要时只读复跑视觉矩阵。 rg|node|playwright|manual DONE DONE DONE client/src/router/index.tsx;client/src/features/navigation/schema.ts;client/tests/e2e/oafront3-pc-readonly-visual.spec.ts;artifacts/qa-flow/oafront3-pc-readonly-visual-* ["PCDESIGN1-0"] 盘点静态 PC 路由 45 条,A/B/C 分层为 7/17/21;现有关键矩阵覆盖 32 条,新增一次性全静态扫描覆盖 45 条;动态详情页 5 条仍需真实样本 ID 补证。
4 PCDESIGN1-2 PC 只读自动化证据复核 复用或复跑公网 PC 只读视觉矩阵,覆盖多角色关键 PC 页面;结合 OAOPS1 日巡检和权限矩阵确认页面可达、无 UUID 主展示、无横向溢出、无加载失败。 生成或引用 summary.json;结论为 PASS 或可解释 finding;报告不含密码、token、Secret、完整账号、票据原图、合同正文、银行流水或原始 payload。 受影响流程:多角色登录 -> PC 路由访问 -> 截图/指标 -> finding 汇总;验证步骤:LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-oafront3-pc-readonly-visual.sh;读取 OAOPS1/权限矩阵。 bash|playwright|node DONE DONE DONE scripts/qa/run-oafront3-pc-readonly-visual.sh;artifacts/qa-flow/oafront3-pc-readonly-visual-*;artifacts/qa-flow/oa-real-use-daily-* ["PCDESIGN1-1"] 公网复跑 artifacts/qa-flow/pcdesign1-pc-readonly-visual-20260525-2128/summary.json 为 PASS_PC_READONLY_VISUAL_READY,7 角色 32 关键路由 finding=0;全静态扫描 artifacts/qa-flow/pcdesign1-all-pc-static-20260525-2133/summary.json 为 PASS_PC_STATIC_ROUTE_SCAN_READY,45/45 PASS。
5 PCDESIGN1-3 A 类核心 PC 流程审查 审查工作台、报销列表/详情、审批待办/详情、通知、个人设置等高频页面;关注首屏任务、状态语义、下一步动作、详情事实源和审批进度可理解性。 形成 A 类页面问题与建议;优先级区分启用前 P0、稳定期 P1 和后置 P2;不得提出重型 ERP 化方案。 受影响流程:员工工作台 -> 报销 -> 审批/进度 -> 通知 -> 个人设置;验证步骤:现有截图/只读页面指标;必要时人工步骤说明。 playwright|rg|manual DONE DONE DONE client/src/pages/PortalHomePage.tsx;client/src/pages/ReimbursementsPage.tsx;client/src/pages/ReimbursementDetailPage.tsx;client/src/pages/WorkflowTasksPage.tsx;client/src/pages/WorkflowTaskDetailPage.tsx;client/src/pages/NotificationsPage.tsx;client/src/pages/ProfilePage.tsx ["PCDESIGN1-2"] A 类 7 条静态路由均 PASS;建议保留当前工作台/报销/审批主路径,后续优先补动态详情页样本证据,并把 Portal 二级信息继续按真实反馈收敛。
6 PCDESIGN1-4 B 类业务运营 PC 页面审查 审查票据池、采购/费用、合同台账、项目、付款批次、AP、资产、企微归档、考勤镜像、盘点、差旅/预算等 B 类页面;关注表格密度、筛选、默认视图和冻结项表达。 形成 B 类页面问题与建议;明确哪些进入 V1 小步优化,哪些继续冻结或只做入口降噪。 受影响流程:票据复核 -> 采购/合同/项目关联 -> 付款/AP -> 资产台账 -> HR/考勤镜像;验证步骤:PC 视觉矩阵、OAOPS1 只读探针、静态代码审查。 playwright|rg|manual DONE DONE DONE client/src/pages/InvoicePoolPage.tsx;client/src/pages/PurchaseRequestsPage.tsx;client/src/pages/ContractsRegistryPage.tsx;client/src/pages/ProjectsPage.tsx;client/src/pages/PaymentBatchesPage.tsx;client/src/pages/ApOperationsPage.tsx;client/src/pages/AssetRegistryPage.tsx;client/src/pages/WecomApprovalArchivePage.tsx;client/src/pages/AttendancePage.tsx;client/src/pages/InventoryChecksPage.tsx;client/src/pages/TravelRequestsPage.tsx;client/src/pages/BudgetsPage.tsx ["PCDESIGN1-2"] B 类 17 条静态路由均 PASS;主要设计建议是 HR/考勤相关 OA 提交入口与企微主办边界需收敛,资产/AP/合同/考勤等高密度页面需默认隐藏次要配置和测试噪声,预算/差旅继续标记后置或隐藏。
7 PCDESIGN1-5 C 类管理配置 PC 页面审查 审查人员、组织、部门、主数据、审批规则、流程定义、工作区、系统设置、功能开关、审计、切换、通知渠道和 ERP 集成等管理页;关注高密度信息是否可理解、危险操作是否收敛。 形成 C 类管理页问题与建议;允许内部编号和审计字段,但必须控制危险配置入口和文案。 受影响流程:管理员配置 -> 权限/审批/流程 -> 开关/审计 -> 集成/切换;验证步骤:PC 视觉矩阵、权限矩阵、静态代码审查;不保存配置。 playwright|rg|manual DONE DONE DONE client/src/pages/PeoplePage.tsx;client/src/pages/UserManagementPage.tsx;client/src/pages/OrganizationPage.tsx;client/src/pages/DepartmentsPage.tsx;client/src/pages/MasterDataPage.tsx;client/src/pages/ApprovalRulesPage.tsx;client/src/pages/WorkflowDefinitionsPage.tsx;client/src/pages/WorkspaceSetupPage.tsx;client/src/pages/SystemSettingsPage.tsx;client/src/pages/FeatureFlagsPage.tsx;client/src/pages/AuditLogsPage.tsx;client/src/pages/CutoverConsolePage.tsx;client/src/pages/NotificationChannelsPage.tsx;client/src/pages/ErpIntegrationPage.tsx ["PCDESIGN1-2"] C 类 21 条静态路由均 PASS;通知渠道、功能开关、ERP 集成等页面可保留工程术语但建议拆成安全摘要/高级配置,避免小团队日常管理员误操作。
8 PCDESIGN1-6 跨页面交互与内容一致性审查 审查全局导航、搜索、表格、筛选、空状态、错误页、确认弹窗、长编号、状态文案、按钮语义和测试数据显示策略。 输出跨页面共性问题;每个建议说明适用页面、收益、风险和是否需要后续代码合同。 受影响流程:导航 -> 搜索 -> 列表筛选 -> 详情 -> 操作确认 -> 空/错状态;验证步骤:读取共享组件和页面代码;PC 截图抽样;rg banned/internal terms。 rg|playwright|manual DONE DONE DONE client/src/components;client/src/layouts;client/src/features/navigation;client/src/pages ["PCDESIGN1-3","PCDESIGN1-4","PCDESIGN1-5"] 跨页面硬指标无横向溢出/UUID/英文主词 finding;共性设计问题是说明文字偏多、C 类技术术语直接暴露、高密度页面默认视图不够任务化、冻结模块缺少统一降噪策略。
9 PCDESIGN1-7 PM/设计总监 KISS 建议包 基于证据把问题归类为保留、简化、隐藏/折叠、后置和人工 SOP;明确不应立刻做的大改版。 形成可审查建议清单;每条建议有页面范围、业务影响、优先级、自动证据、人工验证方法和采纳选项。 受影响流程:证据汇总 -> 问题排序 -> KISS 建议 -> 用户采纳/暂缓/拒绝;验证步骤:rg PCDESIGN1;人工复核建议表。 rg|manual DONE DONE DONE docs/trialrun/人工试运行报告.md;docs/文档索引.md;docs/文档事实源状态矩阵.md;.agents/skills/hyb-oa-delivery/SKILL.md ["PCDESIGN1-6"] 已在人工试运行报告写入 PCDESIGN1 证据、页面覆盖、核心问题和 P0/P1/P2 建议;本行只产出建议,不直接进入实现;采纳后必须另建前端实施 Issue CSV。
10 PCDESIGN1-8 事实源回写与门禁 将 PCDESIGN1 审查结论登记到现有事实源;运行 Issue、文档和 skill 门禁。 validate_issues_csv、check-process-contract、audit-docs、quick_validate、git diff --check 通过或 warning 可解释;git status 最终可追踪。 受影响流程:文档回写 -> 门禁 -> 提交;验证步骤:validate_issues_csv;check-process-contract general;audit-docs --check-registry;quick_validate;git diff --check。 python3|node|git|manual DONE DONE DONE issues/2026-05-25_21-27-56-oa-pc-page-design-review-v1.csv;docs/trialrun/人工试运行报告.md;docs/文档索引.md;docs/文档事实源状态矩阵.md;.agents/skills/hyb-oa-delivery/SKILL.md ["PCDESIGN1-7"] 本轮不部署、无业务代码改动;门禁通过后提交。后续若采纳实现,再按新实施合同进入开发、测试、部署。