归档(08-11-admin-manual-contract-attachment-boundary): 收口合同附件口径纠偏

2026-08-11 17:58:36 +08:00
@@ -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": "completed",
+  "dev_type": null,
+  "scope": "仅修订 docs/管理员手册.md:442 的合同附件现状说明",
+  "package": null,
+  "priority": "P2",
+  "creator": "shunli",
+  "assignee": "shunli",
+  "createdAt": "2026-08-11",
+  "completedAt": "2026-08-11",
+  "branch": null,
+  "base_branch": "main",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [],
+  "parent": null,
+  "relatedFiles": [
+    "docs/管理员手册.md"
+  ],
+  "notes": "",
+  "meta": {}
+}
				`@@ -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."}