文档(08-11-admin-manual-contract-attachment-boundary): 纠正合同附件能力口径

这个提交包含在:
2026-08-11 17:58:20 +08:00
父节点 001be8ddd9
当前提交 8e0222b872
共修改 5 个文件,包含 81 行新增和 1 行删除
@@ -0,0 +1 @@
{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
@@ -0,0 +1 @@
{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
@@ -0,0 +1,50 @@
# 管理员手册合同附件能力纠偏
## Goal
纠正 `docs/管理员手册.md:442` 把合同附件上传与下载审计写成当前可用能力的误导表述,使首个真实合同用户看到的手册与已上线产品一致:当前可录入合同台账字段、线下归档位置和资料索引,但尚无合同附件上传入口或下载审计能力。
## Background and Confirmed Facts
- 手册现句把“可录入合同台账字段”和“非涉密材料可上传并留下下载审计”并列,普通读者会理解为同批当前能力。
- 已归档 `08-05-contract-detail-workspace` 明确裁剪本轮范围:证据区只展示归档位置、离线档案号和涉密资料索引,不提供非涉密附件上传、预览、下载或附件审计。
- 附件能力是后续独立能力,不是永久禁止;因此手册既不能继续承诺当前可用,也不应写成永远不支持。
## Scope
- 仅修改 `docs/管理员手册.md:442` 的合同台账现状说明。
- 保留合同台账已纳入首批真实使用、可录入字段、线下归档和敏感资料边界。
- 将非涉密合同附件上传与下载留痕明确标为尚未提供的后续能力。
## Requirements
- 当前能力必须用肯定、可操作的口径描述:合同负责人可录入既有台账字段、线下归档位置或外部归档编号。
- 未上线能力必须明确写成“当前尚未提供”,不能只加含混的路线图括号让用户继续寻找入口。
- 不承诺交付日期,不新增附件功能设计,不改变涉密合同正文、报价、成本和客户敏感资料不得上传到在线 OA 的边界。
- 不改产品代码、测试、运行配置或其他业务文档。
## Acceptance Criteria
- [x] AC1:`docs/管理员手册.md:442` 不再声称非涉密盖章页、验收单、归档证明当前可以上传或已有下载审计。
- [x] AC2:修订后明确当前只提供合同台账字段、线下归档位置、外部归档编号和资料索引;附件上传与下载留痕为尚未提供的后续能力。
- [x] AC3:涉密合同正文、敏感报价、成本细节和客户敏感资料不进入在线 OA 的安全边界保持不变。
- [x] 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`
@@ -0,0 +1,28 @@
{
"id": "admin-manual-contract-attachment-boundary",
"name": "admin-manual-contract-attachment-boundary",
"title": "管理员手册合同附件能力纠偏",
"description": "纠正管理员手册对合同附件当前能力的误导表述,不改产品实现。",
"status": "in_progress",
"dev_type": null,
"scope": "仅修订 docs/管理员手册.md:442 的合同附件现状说明",
"package": null,
"priority": "P2",
"creator": "shunli",
"assignee": "shunli",
"createdAt": "2026-08-11",
"completedAt": null,
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [
"docs/管理员手册.md"
],
"notes": "",
"meta": {}
}
+1 -1
查看文件
@@ -439,7 +439,7 @@ bash scripts/qa/run-oa-real-use-daily.sh
| 出纳/财务 | 创建付款批次、线下银行付款、上传银行回单、标记已付款、导出 AP/报销/票据资料 | OA 只记录付款闭环和证据;不接真实支付接口,不写 ERP | | 出纳/财务 | 创建付款批次、线下银行付款、上传银行回单、标记已付款、导出 AP/报销/票据资料 | OA 只记录付款闭环和证据;不接真实支付接口,不写 ERP |
| 管理员 | 检查权限、审计日志、合同台账、项目关联和每日巡检报告 | 阻断当天建修复合同或暂停对应流程;非阻断体验问题进入反馈池 | | 管理员 | 检查权限、审计日志、合同台账、项目关联和每日巡检报告 | 阻断当天建修复合同或暂停对应流程;非阻断体验问题进入反馈池 |
合同台账纳入首批真实使用:合同负责人可录入合同编号、合同名称、主体、金额、负责人、项目、状态和线下归档位置;非涉密盖章页、验收单、归档证明等可按权限上传并留下下载审计。涉密合同正文、敏感报价、成本细节、客户敏感资料不进入公网 OA;只记录线下归档位置或外部归档编号。 合同台账纳入首批真实使用:合同负责人可录入合同编号、合同名称、主体、金额、负责人、项目、状态、线下归档位置和外部归档编号,并登记涉密资料索引。当前尚未提供非涉密盖章页、验收单、归档证明等附件的上传入口、预览下载和下载审计;这些属于后续能力。涉密合同正文、敏感报价、成本细节、客户敏感资料不进入公网 OA,只登记线下归档位置、外部归档编号或资料索引。
### 3.6 ASSET1 统一资产台账 ### 3.6 ASSET1 统一资产台账