文件
hyb-oa/.trellis/tasks/08-05-product-interaction-consistency/prd.md
T

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

  • 无;三个子任务的边界和合同终止持久化方案均已确认。