文件
hyb-oa/.trellis/tasks/archive/2026-08/08-30-reimbursement-employee-guide-b2-sync/prd.md
T

5.2 KiB

同步员工报销填报指南与 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

  • 不新建说明文档;员工通用规则落在现有 docs/员工快速上手.md 第 6 节且不重复现有差旅指南。
  • 通用规则正确区分实际发生日期、发票日期和报销提交日期,并明确连续跨天/跨期的同一业务支出可以一条明细记录起止日期。
  • 文档明确 B2 的三项系统门禁及其日期/粒度非目标;员工不会被告知“系统会自动检查拆分是否正确”。
  • 需要发票的明细金额高于关联票面合计被表述为硬阻断;说明仅用于允许提交的票面高于申报金额等差异场景。
  • 退回修改顺序、正式 PDF 入口和图片附件路径表述准确。
  • docs/员工快速上手.md 与 docs/报销发票附件规则.md 不保留互相矛盾的生效规则。
  • 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。