归档员工报销指南同步任务（08-30-reimbursement-employee-guide-b2-sync）

2026-08-30 15:19:57 +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,63 @@
+# 同步员工报销填报指南与 B2 规则
+
+## Goal
+
+让员工侧主手册准确反映已经全局生效的票据—明细门禁和人工填报粒度要求，避免员工按旧文案误以为“金额超票面后写说明即可提交”，同时允许住宿、月度通讯费、服务期费用等连续跨天或跨期支出作为同一笔业务支出填一条明细。
+
+## Background
+
+- `docs/员工快速上手.md:41-68` 是当前员工使用说明；第 6 节已有 PDF-only、图片走附件、支付截图、补助和差旅专项规则，不应重复另建“报销填报说明”。
+- `docs/员工快速上手.md:65` 仍写“原则上不得超过有效发票金额，差异必须说明”。B2 全局生效后，需要发票的明细金额高于关联发票票面合计会被硬阻断，仅写说明不能提交。
+- B2 只校验发票是否关联、需票明细是否有金额有效的关联发票、明细金额是否高于关联票面合计；它不校验费用类型、发生日期或业务支出粒度。明细拆分属于员工填报要求和财务人工复核事项，不得宣称系统会自动提醒或阻断。
+- 发生日期是实际费用发生或消费日期，不是报销提交日期，也不能一律由发票日期替代；与发票日期不一致时应说明原因。
+- 连续跨天或跨期的同一笔业务支出（如多晚住宿、月度通讯费、按服务期计费）可以作为一条明细，并在说明中写清起止日期。
+- 只改员工手册会产生事实源冲突：`docs/报销发票附件规则.md:151` 仍保留“原则上不得超过、差异说明”，`:155` 仍把“一条明细”绝对限定为同一发生日期；`:156` 又已经记录 B2 超票面硬阻断。
+
+## Scope
+
+- 员工侧主手册中的通用报销填报规则与差旅指南第 8 条。
+- 报销发票附件事实源中与金额硬门禁、连续跨期粒度直接冲突的两条现行口径。
+- Trellis task 元数据与文档一致性验证。
+
+## Requirements
+
+### R1 员工手册增加最小通用规则
+
+- 在 `docs/员工快速上手.md` 第 6 节、现有“差旅报销一页指南”之前增加“通用报销填报规则”。
+- 只补现有差旅段落没有覆盖的内容：同一费用类型和同一笔业务支出的明细粒度、连续跨期例外、实际发生日期口径、逐票关联、需票明细的金额硬门禁，以及退回后“先移除发票—再改明细—最后重新添加并选择明细”的顺序。
+- 图片、截图和拍照材料不得从正式发票入口上传；属于支付证明、订单或情况说明时，通过“上传附件”提交。不得写成图片材料一律无效。
+- 明确粒度要求由员工遵守、财务复核，B2 不自动比对日期或判断拆分是否正确。
+
+### R2 纠正差旅指南第 8 条
+
+- 把 `docs/员工快速上手.md:65` 改为：需要发票的实报实销明细金额不得高于关联发票票面合计，超出时系统阻止提交；优惠券、多人合并开票、部分自费等申报金额低于票面的情况仍需说明。
+- 保留已退款、公司直接支付、他人承担金额不得重复报销，以及缺支付截图时由财务决定是否接受其他证据、不得补造凭证的现有口径。
+
+### R3 最小同步主事实源
+
+- `docs/报销发票附件规则.md` 是产品/财务事实源而非员工手册，不复制员工操作说明。
+- 其 `:151/:155` 与本任务已确认的新口径冲突；同一 task 内只做两处最小事实纠偏，避免员工手册与主事实源互相矛盾：金额规则改为需票明细超关联票面硬阻断，粒度规则补充连续跨天/跨期同一业务支出的例外及起止日期说明。
+- 不修改 `docs/trialrun/R7用户手册与FAQ.md`；该文档仍是草案，不是当前员工主说明。
+
+## Acceptance Criteria
+
+- [x] 不新建说明文档；员工通用规则落在现有 `docs/员工快速上手.md` 第 6 节且不重复现有差旅指南。
+- [x] 通用规则正确区分实际发生日期、发票日期和报销提交日期，并明确连续跨天/跨期的同一业务支出可以一条明细记录起止日期。
+- [x] 文档明确 B2 的三项系统门禁及其日期/粒度非目标；员工不会被告知“系统会自动检查拆分是否正确”。
+- [x] 需要发票的明细金额高于关联票面合计被表述为硬阻断；说明仅用于允许提交的票面高于申报金额等差异场景。
+- [x] 退回修改顺序、正式 PDF 入口和图片附件路径表述准确。
+- [x] `docs/员工快速上手.md` 与 `docs/报销发票附件规则.md` 不保留互相矛盾的生效规则。
+- [x] `node scripts/qa/audit-docs.mjs --check-registry`、`node scripts/qa/check-trellis-governance.mjs` 和 `git diff --check` 全部通过。
+
+## Out of Scope
+
+- 不修改应用代码、自动化测试或运行配置，不执行线上写入或发布。
+- 不新建报销说明文档，不改 `docs/trialrun/R7用户手册与FAQ.md`。
+- 不处理费用类型命名、会计科目映射、固定资产政策或四张真人报销的退回操作。
+
+## Test Plan
+
+- 逐条对照 B2 已生效合同，检查员工手册与报销事实源的金额、关联、免票和粒度边界不存在矛盾。
+- 运行 `node scripts/qa/audit-docs.mjs --check-registry`。
+- 运行 `node scripts/qa/check-trellis-governance.mjs`。
+- 运行 `git diff --check`。
@@ -0,0 +1,29 @@
+{
+  "id": "reimbursement-employee-guide-b2-sync",
+  "name": "reimbursement-employee-guide-b2-sync",
+  "title": "同步员工报销填报指南与 B2 规则",
+  "description": "同步员工快速上手中的通用报销填报规则与已全局生效的 B2 门禁，纠正差旅金额旧口径，并处理连续跨期支出的明细粒度表达。",
+  "status": "completed",
+  "dev_type": null,
+  "scope": "employee reimbursement guide; reimbursement documentation consistency",
+  "package": "docs",
+  "priority": "P1",
+  "creator": "shunli",
+  "assignee": "shunli",
+  "createdAt": "2026-08-30",
+  "completedAt": "2026-08-30",
+  "branch": null,
+  "base_branch": "main",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [],
+  "parent": "08-29-reimbursement-expense-policy-invoice-guard",
+  "relatedFiles": [
+    "docs/员工快速上手.md",
+    "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."}