文件
hyb-oa/.trellis/tasks/archive/2026-08/08-11-admin-manual-contract-attachment-boundary/prd.md
T

3.1 KiB
原始文件 Blame 文件历史

管理员手册合同附件能力纠偏

Goal

纠正 docs/管理员手册.md:442 把合同附件上传与下载审计写成当前可用能力的误导表述,使首个真实合同用户看到的手册与已上线产品一致:当前可录入合同台账字段、线下归档位置和资料索引,但尚无合同附件上传入口或下载审计能力。

Background and Confirmed Facts

  • 手册现句把“可录入合同台账字段”和“非涉密材料可上传并留下下载审计”并列,普通读者会理解为同批当前能力。
  • 已归档 08-05-contract-detail-workspace 明确裁剪本轮范围:证据区只展示归档位置、离线档案号和涉密资料索引,不提供非涉密附件上传、预览、下载或附件审计。
  • 附件能力是后续独立能力,不是永久禁止;因此手册既不能继续承诺当前可用,也不应写成永远不支持。

Scope

  • 仅修改 docs/管理员手册.md:442 的合同台账现状说明。
  • 保留合同台账已纳入首批真实使用、可录入字段、线下归档和敏感资料边界。
  • 将非涉密合同附件上传与下载留痕明确标为尚未提供的后续能力。

Requirements

  • 当前能力必须用肯定、可操作的口径描述:合同负责人可录入既有台账字段、线下归档位置或外部归档编号。
  • 未上线能力必须明确写成“当前尚未提供”,不能只加含混的路线图括号让用户继续寻找入口。
  • 不承诺交付日期,不新增附件功能设计,不改变涉密合同正文、报价、成本和客户敏感资料不得上传到在线 OA 的边界。
  • 不改产品代码、测试、运行配置或其他业务文档。

Acceptance Criteria

  • AC1:docs/管理员手册.md:442 不再声称非涉密盖章页、验收单、归档证明当前可以上传或已有下载审计。
  • AC2:修订后明确当前只提供合同台账字段、线下归档位置、外部归档编号和资料索引;附件上传与下载留痕为尚未提供的后续能力。
  • AC3:涉密合同正文、敏感报价、成本细节和客户敏感资料不进入在线 OA 的安全边界保持不变。
  • AC4:仅有当前 task 与管理员手册的预期文档改动;task validate、process contract、governance、sensitive scan 和 git diff --check 全部通过,docs registry audit 为 0 errors,仅保留既有 22 个未注册文件 warning。

Out of Scope

  • 实现合同附件上传、预览、下载、删除、访问控制或留痕。
  • 全面重写管理员手册中的通用附件治理、路线图或其他模块口径。
  • 修改既有登录态验收 task 的合同 UI 事件触发条件。

Open Questions

  • 无。仓库事实与用户判断已共同确认该句会被理解为当前能力,应按现状纠偏而不是只加模糊规划标记。

Test Plan

  • python3 ./.trellis/scripts/task.py validate 08-11-admin-manual-contract-attachment-boundary
  • node scripts/qa/check-process-contract.mjs --baseline --json
  • node scripts/qa/check-trellis-governance.mjs --json
  • node scripts/qa/check-sensitive-content.mjs
  • node scripts/qa/audit-docs.mjs --check-registry
  • git diff --check