5.3 KiB
5.3 KiB
产品交互与页面操作一致性治理
Goal
以小团队中文工作台为目标,把用户跨页面反复使用的“进入详情、新建、返回、审批、错误恢复和移动主动作”收敛为可预测的操作模型,减少同一动作在不同模块中位置、文案、反馈和导航行为不一致造成的学习与误操作成本。
Background
- 当前产品事实源已固定六类页面模板、台账首屏纯列表、详情证据结构、状态矩阵动作语义和移动端底部主动作等边界。
- 当前实现仍并存
ListWorkspace、BusinessListTemplate、PageHeader等页面骨架,并存在独立路由、查询参数主从、列表内联编辑和 Dialog 等多种相互竞争的操作方式。 - 2026-08-05 的产品/人机交互审查提出三类工作:先治理低风险、跨页复用的操作规则;再迁移已有详情态的同构台账;合同详情作为新增能力独立规划。
- 当前仍有 58 个前端文件在普通用户路径拼接
CODE: 中文消息,共享resolveErrorMessage也保留该前缀;低风险子任务必须统一收敛。 - 历史已确认付款批次保持列表内显式选择后的详情形态,不新增独立详情路由;本任务不得推翻该业务决定。
Scope
- 父任务只管理三个子任务的边界、顺序、验收和最终集成复核。
- 低风险子任务负责跨页面文案、错误反馈、状态兜底、首页优先级、移动动作容器和差旅自动选中缺陷。
- 采购/资产子任务负责两个已有详情态台账的独立路由迁移与旧链接兼容。
- 合同子任务负责从零合同详情工作区、
terminated状态和事务审计设计/实施。 - 付款批次、请假和完整差旅不做详情路由化;非涉密合同附件能力按后续规约任务处理。
Requirements
- R1:本父任务作为需求源和跨子任务验收入口,不直接承接大批量业务页面实现。
- R2:子任务
08-05-interaction-pattern-unification处理不改变业务 URL、数据库、API、权限模型和状态机的低风险一致性问题。 - R3:子任务
08-05-business-detail-routing只处理采购、资产两个已有详情态台账的列表/详情路由边界、深链、返回和未保存保护。 - R4:子任务
08-05-contract-detail-workspace独立定义合同详情的信息结构、权限与高风险动作归位,不与采购/资产的路由搬迁混做。 - R5:视觉与交互分析优先遵循项目指定的
frontend-design;本会话该 skill 不可用时,只以ui-ux-pro-max、现有共享组件和产品事实源做保守补充,不创建新的视觉体系。 - R6:不得借一致性治理扩张业务模块、重做既有状态机、改变企业微信/OA 边界、放宽权限或触碰真实数据。
- R7:完整差旅属于冻结模块,不做详情路由化;仅在低风险子任务中删除自动选择第一条记录的缺陷,不恢复或扩展差旅能力。
- R8:三个子任务独立实施与批准;低风险统一先行,采购/资产路由化随后,合同详情在其独立规划获批后另行实施。
- R9:每个子任务独立完成本地验证、可访问性/交互回归和 Trellis 门禁;只有部署与公网关键路径检查通过后,才能告知用户线上可测。
Acceptance Criteria
- 三个子任务均具有独立、可观察且不互相重复的验收标准。
- 低风险统一先于详情路由化完成,路由化复用已经收敛的文案、反馈和动作组件。
- 当前仍存在的问题被纳入范围;错误码前缀按覆盖变量名的完整搜索结果治理,不因错误的窄模式搜索被误判为已修复。
- 付款批次继续使用现有显式选择详情形态,不新增独立详情路由。
- 完整差旅继续冻结;只删除首屏自动选中第一条记录的缺陷。
- 合同详情的信息结构和高风险动作边界在独立子任务中裁决,不作为采购/资产迁移的附带工作。
- 不改变 API、数据库、权限模型、审批/付款状态机、生产配置或真实业务数据。
- 前端 typecheck/build、聚焦 Playwright、Trellis governance、process contract、文档注册表和
git diff --check均通过。 - 每个子任务完成后有独立提交和回滚点,最终由父任务做跨子任务集成复核。
Out of Scope
- 模块冻结清单、一级导航产品组合和功能下线。
- 全站视觉换肤、品牌重做、暗色模式或新设计系统。
- 后端业务规则、权限、状态机、数据库 schema 或生产数据修改。
- 付款批次独立详情路由。
- 公网部署、生产配置或真实数据写入;如后续需要,必须另行获批。
Test Plan
- 每个子任务先运行自身聚焦测试、typecheck/build 和任务 validate,再运行父任务集成门禁。
- 父任务最终运行
node scripts/qa/check-process-contract.mjs --baseline --json、node scripts/qa/audit-docs.mjs --check-registry、node scripts/qa/check-trellis-governance.mjs和git diff --check。 - 路由子任务覆盖采购/资产深链、旧
?id=兼容、返回与未保存保护;合同子任务额外覆盖 Prisma 校验、迁移状态、状态不变量、事务审计失败回滚和只读 reviewer。
Open Questions
- 无;三个子任务的边界和合同终止持久化方案均已确认。