3.1 KiB
3.1 KiB
管理员手册合同附件能力纠偏
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-boundarynode scripts/qa/check-process-contract.mjs --baseline --jsonnode scripts/qa/check-trellis-governance.mjs --jsonnode scripts/qa/check-sensitive-content.mjsnode scripts/qa/audit-docs.mjs --check-registrygit diff --check