diff --git a/issues/2026-05-24_23-01-16-oa-frontend-design-audit-v1.csv b/issues/2026-05-24_23-01-16-oa-frontend-design-audit-v1.csv new file mode 100644 index 00000000..46ea8cc6 --- /dev/null +++ b/issues/2026-05-24_23-01-16-oa-frontend-design-audit-v1.csv @@ -0,0 +1,12 @@ +"ID","Title","Description","Acceptance","Test_Method","Tools","Dev_Status","Review1_Status","Regression_Status","Files","Dependencies","Notes" +"OAFRONT1-0","建立前端设计审计台账","按 MAGI 审视、执行、提升轮次,对照 docs/产品设计规则.md、Hyinda 官网视觉基线、DG9 页面分层和移动统一槽位,记录当前前端设计问题和建议;本合同只用于审查,不直接改代码、部署或写公网业务数据。","Issue CSV 校验通过;所有问题默认 TODO,等待用户 A/B/C 决策;明确自动视觉矩阵通过不等于设计成熟度完全闭合。","受影响流程:设计事实源 -> 自动视觉证据 -> 问题建议登记 -> 用户采纳决策;验证步骤:validate_issues_csv.py 本 CSV;check-process-contract general;git diff --check。","python3|node|git|manual","DONE","DONE","DONE","issues/2026-05-24_23-01-16-oa-frontend-design-audit-v1.csv","[]","本轮已读取 docs/产品设计规则.md 和 visual QA reference;已运行 check-ui-design-rules、页面结构统计和公网移动视觉矩阵;不修改前端业务代码,不写公网业务数据。回滚/清理:如不采纳本审计,只删除本 CSV 或在后续合同标记 superseded;不影响公网、数据库、部署或业务数据。" +"OAFRONT1-1","移动首页和我的页可读性偏弱观察项","公网移动视觉矩阵通过,但截图显示移动首页、我的页部分文字、卡片和快捷入口过浅,容易给人 disabled 或不可点的感觉;报销详情相对清楚,问题集中在工作台摘要和个人中心。","用户或真机确认后,移动首页和我的页主标题、卡片标题、快捷入口标签、按钮和状态文字具备清晰可读对比;不引入黑色大块背景,不破坏底部导航和移动槽位。","受影响流程:企业微信/手机进入 OA -> 首页看待处理/常用/财务/考勤 -> 我的页查看账号和入口;验证步骤:复跑 VISUAL_MATRIX_SCOPE=mobile bash scripts/qa/run-visual-matrix.sh live;截图重点比对 output/playwright/OAFRONT-DESIGN-AUDIT/mobile-matrix/w320-ios-wecom-home.png、w390-ios-wecom-home.png、w320-ios-wecom-me.png;必要时补 contrast 自动指标。","playwright|manual","TODO","TODO","TODO","client/src/pages/MobilePortalPage.tsx;client/src/pages/MobileMePage.tsx;client/src/styles/mobile-touch.css;client/src/index.css","[""OAFRONT1-0""]","优先级 P1,若真机反馈看不清则升级 P0。建议先调移动 token/文字颜色/卡片阴影,不重做信息架构;当前自动矩阵 7 个宽度通过。" +"OAFRONT1-2","DG9 页面骨架覆盖不均","页面统计显示 66 个顶层页面中约 17 个使用 ListWorkspace,42 个仍以 PageHeader 为主;A 类核心流程较统一,但不少 B/C 页面还保留旧的 PageHeader + card-std 结构,长期会造成筛选、表格、空态、操作区和说明文案不一致。","按 DG9 分类形成迁移清单:A 类保持样板;B 类业务运营逐步迁移到 ListWorkspace/WorkspaceHeader/FilterBar/PrimaryTable/WorkspaceSection;C 类管理配置允许高密度,但页头、筛选、表格和空态语义统一。","受影响流程:PC 列表页查看 -> 筛选 -> 批量/导出/管理操作;验证步骤:结构统计脚本复跑,ListWorkspace 覆盖率和旧结构页面清单可解释;涉及页面改动时跑 client typecheck/build 和相关 Playwright。","node|playwright|manual","TODO","TODO","TODO","client/src/pages;client/src/components/patterns/ListWorkspace.tsx","[""OAFRONT1-0""]","优先级 P1。建议先处理 B 类高频页:合同台账、预算/费用标准、人员/团队状态、通知通道;差旅等冻结模块只做入口边界和低风险清理。" +"OAFRONT1-3","大页面拆分不足导致设计和维护风险","静态统计显示多个页面超过 1000 行:ReimbursementDetail、PurchaseRequests、MobileApprovals、ApOperations、EmployeeProfile、MobileReimbursementDetail、AssetRegistry、PortalHome 等;这些页面同时承载数据查询、状态派生、表单、列表、详情、弹窗和动作,后续设计一致性和回归成本高。","采纳后按业务域拆分为可复用的 section/card/action/dialog 组件;拆分不改变 API、权限、状态机或路由;每次只处理一个高风险页面并保留视觉截图。","受影响流程:核心页面加载 -> 详情扫读 -> 操作确认 -> 回归维护;验证步骤:单页拆分后 client typecheck/build;相关 E2E 或视觉矩阵通过;git diff 限定在页面和子组件。","typescript|playwright","TODO","TODO","TODO","client/src/pages/ReimbursementDetailPage.tsx;client/src/pages/PurchaseRequestsPage.tsx;client/src/pages/MobileApprovalsPage.tsx;client/src/pages/ApOperationsPage.tsx;client/src/pages/EmployeeProfilePage.tsx;client/src/pages/MobileReimbursementDetailPage.tsx;client/src/pages/AssetRegistryPage.tsx;client/src/pages/PortalHomePage.tsx","[""OAFRONT1-0""]","优先级 P1/P2。建议先不在 OALAUNCH1 前做大拆分;上线稳定后按真实反馈选择 1-2 个页面。" +"OAFRONT1-4","PC 视觉装饰和圆角偏软偏营销化","设计规则要求 OA 像工作台而非宣传站;当前全局 body、workbench-hero、metric-card、section-panel 等使用多处 radial/linear gradient、装饰圆纹和 1.25rem panel 圆角,PC Portal 截图观感接近柔和营销卡片,和高密度办公台账存在轻微张力。","采纳后建立 PC 工作台视觉收敛规则:A/B 类业务页减少装饰性渐变和圆纹,PC 卡片圆角向更克制的工作台半径收敛;移动端保留 12px 左右卡片;Hyinda 品牌蓝继续用于主按钮和选中态。","受影响流程:PC 登录 -> 工作台 -> 列表/详情/财务/合同页面扫读;验证步骤:对比 output/playwright/r111-hyinda-design/home-desktop.png 和当前 PC Portal/Reimbursements 截图;改动时跑 project-wide visual 或代表性 PC 截图。","playwright|manual","TODO","TODO","TODO","client/src/index.css;client/src/design/theme.css;client/src/pages/PortalHomePage.tsx;client/src/components/patterns","[""OAFRONT1-0""]","优先级 P2,除非用户明确觉得当前 UI 过淡或过软。建议先做视觉 token 小步收敛,不重写页面。" +"OAFRONT1-5","用户侧说明文案仍偏密","抽样检索发现多处 subtitle/description 仍承担解释系统设计和规则的职责,例如小团队模式、统一治理、建议、帮助等;C 类后台可接受,但 A/B 类用户高频页应减少首屏解释,改为字段帮助、折叠提示或错误态说明。","采纳后形成文案清单:A/B 类页面首屏标题短、动作明确、空态说明现状和下一步;C 类页面保留必要审计和配置说明;不得出现竞品、设计治理元话语或过长流程说明。","受影响流程:员工/审批人/财务打开高频页面 -> 识别下一步动作;验证步骤:rg 文案清单;check-ui-design-rules 扩展或人工审查;相关截图首屏不被说明文案挤占。","rg|manual|playwright","TODO","TODO","TODO","client/src/pages;docs/产品设计规则.md","[""OAFRONT1-0""]","优先级 P1。建议先处理移动首页、报销、审批、付款/AP、合同台账、资产台账等真实使用路径。" +"OAFRONT1-6","测试账号和角色展示本地化观感不足","历史 PC 截图中出现 Employee、Finance Manager 等英文姓名或角色展示;这对自动测试无影响,但公网演示、培训和真实启用前验收会削弱国内 OA 的专业感。","采纳后 smoke 账号和演示账号在 UI 中使用中文姓名或职能名;真实员工继续展示真实姓名;不把角色码当普通用户主展示;管理员排障页例外。","受影响流程:登录工作台 -> 查看待办/团队/动态 -> 培训演示;验证步骤:公网 smoke 截图不再出现 Employee/Finance Manager 作为主要称呼;不改真实用户数据隐私边界。","manual|playwright","TODO","TODO","TODO","seed|server/scripts|client/src/pages/PortalHomePage.tsx","[""OAFRONT1-0""]","优先级 P2。可以等 OALAUNCH1 后做,也可作为 smoke 账号治理的小改;不得写真实员工隐私到仓库。" +"OAFRONT1-7","设计 QA 工具缺少对比度和样板覆盖指标","check-ui-design-rules 当前 129 个文件 0 finding,移动视觉矩阵也通过;但工具主要检查禁用文案、黑色移动主控件、原生上传、内部术语等,尚未自动量化文本对比度、PC 圆角/渐变、DG9 样板覆盖率、页面复杂度和移动截图可读性。","采纳后新增 QA-only 设计审计脚本或扩展现有脚本,输出:页面分层、ListWorkspace 覆盖率、大文件清单、移动截图对比度观察、禁用/过浅态风险、PC 装饰密度;默认只读。","受影响流程:设计审查 -> 自动证据 -> 用户决策 -> 后续 UI 修复;验证步骤:node scripts/qa/check-ui-design-rules.mjs --json;新增报告不含密码、token、真实票据、合同正文或完整账号。","node|playwright","TODO","TODO","TODO","scripts/qa/check-ui-design-rules.mjs;scripts/qa/run-visual-matrix.sh;artifacts/qa-flow","[""OAFRONT1-0""]","优先级 P1。建议优先做工具增强,因为它能避免以后每次靠人工看截图判断。" +"OAFRONT1-8","前端优化应绑定 7 天真实反馈而非主观重排","当前自动证据能证明移动/企微基础可用,但成熟设计要看真实员工、审批人、财务、管理员在 7 天稳定期的高频路径:报销、审批、付款/AP、合同、资产、通知回跳和搜索。","OALAUNCH1 稳定期内建立 UX 反馈池;每条反馈记录角色、页面、动作、影响、是否阻断、截图或复现步骤;非阻断优化不抢 P0 启用门禁。","受影响流程:真实使用 -> 反馈登记 -> 优先级排序 -> 设计修复合同;验证步骤:OAOPS1 每日收口记录 + 移动/PC 截图;Day 7 决策时只采纳高价值 UX 项。","manual|playwright","TODO","TODO","TODO","docs/trialrun/人工试运行报告.md;issues/2026-05-22_20-09-22-oa-real-use-stabilization-v1.csv","[""OAFRONT1-0""]","优先级 P0 作为机制,具体 UI 修复按 P1/P2 排序。不要因审美主观重排影响 OALAUNCH1 真实启用。" +"OAFRONT1-9","本轮自动证据和审计收口","完成本轮前端设计审计的自动证据收集、合同校验和停止点;后续必须由用户决定哪些建议采纳。","check-ui-design-rules 通过且无未抑制 finding;公网移动视觉矩阵 7 passed;页面结构统计和截图证据已记录;本 CSV 校验通过;未改前端业务代码。","受影响流程:审计 -> 证据 -> 建议台账 -> 用户验收;验证步骤:node scripts/qa/check-ui-design-rules.mjs --json;QA_ISSUE_ID=OAFRONT-DESIGN-AUDIT VISUAL_MATRIX_SCOPE=mobile bash scripts/qa/run-visual-matrix.sh live;validate_issues_csv.py 本 CSV;git diff --check。","node|bash|python3|git","DONE","DONE","DONE","artifacts/qa-flow/OAFRONT-DESIGN-AUDIT-visual-matrix-20260524-225129/summary.json;output/playwright/OAFRONT-DESIGN-AUDIT/mobile-matrix;issues/2026-05-24_23-01-16-oa-frontend-design-audit-v1.csv","[""OAFRONT1-0""]","自动证据:check-ui-design-rules findings=0、suppressed=1;公网移动视觉矩阵 PASS,覆盖 320/360/375/390/393/414/430;结构统计:66 顶层页面、12 移动页面、17 ListWorkspace、42 PageHeader、33 表格、18 个超过 700 行页面。" +"OAFRONT1-10","用户采纳问答门禁","用户验收本轮设计审计后,需要决定是否采纳建议:先做可读性和 QA 工具,还是等 7 天真实反馈后再排 UX 修复。","用户至少对三组给出 A/B/C:1) 移动可读性与文案;2) DG9/PC 视觉收敛和大页面拆分;3) QA 工具增强和真实反馈池。未采纳项不得进入开发。","受影响流程:用户审查 -> A/B/C 决策 -> 后续 Issue CSV -> 实施/暂缓/否决;验证步骤:人工回填用户选择并 validate CSV。","manual|python3","TODO","TODO","TODO","issues/2026-05-24_23-01-16-oa-frontend-design-audit-v1.csv","[""OAFRONT1-9""]","建议默认:组 1=A 但先只小步修移动可读性;组 2=B 等 7 天反馈;组 3=A 优先做 QA-only 工具增强。"