# ASA v2.1.0 · 版本总纲

> 状态：需求梳理中，**未交付**。范围以 `../../html/版本记录.html` 列出的 28 项为准。
> 本文件由**需求总控**维护，页面会话只读。总控过程（需求盘点、任务卡、版本级开放问题 Q-00、跨页影响裁决）在同目录 `WORKLOG.md`；各页过程在各页目录的 `WORKLOG.md`（都不进 Git）。

## 1 版本目标与范围

- 目标：把客户登记 → 客户 → 账户开户的主链，以及费用、账单、返点、渠道对账、收付款、利润、提成的财务链，和审批、导航权限，一起做到研发可直接开发。
- 包含：版本记录 28 项，全部要梳理到可开发（D-00-01）。
- 不包含：工程实现细节（接口、表结构、实现方式），交技术负责人确认（D-00-02）；短信通知（D-12-11）；提成实际支付闭环（D-00-37）。

## 2 版本级决策

<!-- 已确认的 D-00。页面 PRD/spec 可直接引用这里的编号。「影响页面」写的是该口径要落到哪页；页面落 spec 时可引用本编号，不必另起 D-NN。未定的 Q-00 在 WORKLOG。 -->

### 2.1 范围、方法与分工

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-01 | 版本记录 28 项全部纳入，全部要达到可开发（不接受「UI 仅供参考、规则后续再说」） | 用户确认 | 全部 |
| D-00-02 | 先按产品需求写，工程细节（API、表结构、实现方式）留技术负责人确认 | 用户确认 | 全部 |
| D-00-03 | 一个页面 / 紧耦合流程包一套 PRD + spec + review + mock | 用户确认 | 全部 |
| D-00-04 | WORKLOG 是过程文档，不是结果；不进 Git | 用户确认（2026-10-16） | 全部 |
| D-00-46 | 审批详情拆法：各业务包只写本业务审批详情记录 / 展示的内容；审批详情通用格式在 12，业务包引用 | 用户确认（2026-10-16） | 03～08、12 |
| D-00-47 | 客户材料（#11）并入 04-客户管理，不单独成包 | 用户确认（2026-10-16） | 04 |
| D-00-48 | 利润中心、提成中心分开两个包 | 用户确认（2026-10-16） | 10、11 |
| D-00-49 | 按 prd-builder 两角色推进：总控维护本总纲、版本 WORKLOG 与任务卡，页面会话只写自己的页面目录；版本目录放在工作区 `versions/` 下 | 用户确认（2026-10-19） | 全部 |

### 2.2 通用口径

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-08 | 币种枚举：人民币、USD、USDT（原型写的「美元」是笔误） | 用户确认 | 04～11 |
| D-00-12 | 规则调整后，历史账单和已完成充值按发生时规则冻结，后续业务用新规则 | 用户确认 | 03、05～07 |
| D-00-13 | 金额精度：人民币 / USD / USDT 统一 2 位小数、四舍五入。舍入点按各页规则：06 按段 / 天、07 按段 / 天、10 按日折人民币，各自四舍五入到 2 位再相加；05 退款在账户内先加后舍（R-05-027）；中间值可存更高精度，但不能拿它直接加总来代替上述舍入点；阶梯落档用未舍入的原始消耗合计；前端只展示服务端返回的 2 位金额、不做二次舍入，合计用展示值相加（2026-10-21 补：原只有「统一 2 位小数、四舍五入」，会议清单 v2 D01-口径、D01-前端展示） | 用户确认；用户确认（2026-10-21，会议清单 v2 D01） | 03、05～11 |
| D-00-35 | 利润、提成统一折人民币：按业务发生日取日汇率（取数口径见 D-00-74），缺当天向前取最近一天；10 / 11 折算用全精度汇率，按日保留 2 位再汇总，详情里汇率显示 4 位并注「按完整汇率计算」。不加审计流程；各项金额的「业务发生日」由 10 细化（R-10-011：消耗、服务费、税费、服务费税费、客户返点、客情费用按日，渠道统计金额 / 渠道返点取结算期最后一天，手续费取收款完成日）（2026-10-21 改：原为「系统日均汇率」<!-- alias-ok -->，数据源 / 接口 / 存储由技术调研，会议清单 v2 D36、技术答复 T12） | 用户确认；用户确认（2026-10-21，会议清单 v2 D36） | 10、11 |
| D-00-43 | 会签是全局审批能力：同一节点全员通过才进入下一节点，任一人驳回整单驳回。备注：本期节点仍单选；D-00-76 后「绑定的运营」可能解析出多人，此时会签自然出现（2026-10-21 补，会议清单 v2 D118） | 审批详情-客户管理.html:2472 + 用户确认；用户确认（2026-10-21，会议清单 v2 D118） | 12（定义）、各业务包 |
| D-00-44 | 费用 / 账单 / 返点 / 渠道对账 4 个审批详情复用通用审批详情框架，内容区各自展示业务单据 | 用户确认 | 05～08、12 |
| D-00-45 | 权限只输出新增页面 / 动作的权限点清单，不预设角色分配，开发完用户手动配；上述动作都列独立权限点 | 用户确认 | 全部（13 汇总） |
| D-00-50 | 审批流动态选项「绑定的销售」只解析客户的「销售」字段（只取启用用户，已禁用按解析为空跳过）；「商务」字段即「销售」字段（承接 D-04-10、D-12-27）；「绑定的运营」见 D-00-76（2026-10-21 改：原为「审批流动态选项统一叫「绑定的销售」，解析客户的「销售」字段」；客户「运营」字段已去掉，「绑定的运营」改按 D-00-76，会议清单 v2 D29） | 用户确认（2026-10-19）；用户确认（2026-10-21，会议清单 v2 D29） | 02、04、12 |
| D-00-68 | 「结算币种」与「结算货币」是同一个东西，统一叫「结算币种」；「结算货币」进术语表禁用别名，06～09 改字（引用原型原文时加 alias-ok） | 用户确认（2026-10-20，原 Q-00-24） | 05～09 |
| D-00-70 | 客户登记表的内部动作（进入列表、新增、详情、编辑、复制外链、审核、删除，以及从列表进规则配置；按状态显示哪些按钮仍按 R-01-014）只用一个权限点「客户登记管理」控制，且只能处理**本人创建**的登记表（R-01-008）；没有该点时菜单不显示、直接访问显示「无权限访问」，服务端同样校验；权限被收回后本人的登记表不转移、不变状态，外链照常可填。规则配置入口与审批详情查看按 03 的口径（R-03-013、R-03-050，受 D-00-77 客户数据范围限制），不受本条限制（2026-10-21 改：原为「沿用 03 的放开口径（D-03-22、D-03-23）」，会议清单 v2 D21） | 用户确认（2026-10-20，原 Q-13-001～002） | 01、13、03 |
| D-00-71 | 有「收付款中心」权限点的人，可只读打开 8 种审批类型的审批详情：账户充值、充值退款、额度调整、余额分配、生成结算单、客户返点、客情费用、渠道付款（R-13-050）；只给审批详情查看资格，不给业务页面、收付款列表之外的访问权，不显示通过 / 驳回 / 撤回。12 的 R-12-043 映射与 05～08 的「能否查看」判断按此补（09 · X-5 原建议 6 类，用户在 13 会话定为 8 类）。注：额度调整、余额分配不产生收付款单，09 页面没有入口，靠转发或通知链接查看（2026-10-21 补，会议清单 v2 D30） | 用户确认（2026-10-20，13 会话；原 Q-09-01） | 05～09、12、13 |
| D-00-72 | 提成按业务日的历史归属算（D-11-01），所以系统要记下每个客户「销售」、每个账户「优化师」的变更生效时间：04 记客户销售的变更（新建客户 / 客户信息变更生效时）、02 记账户优化师的变更（编辑账户保存时）；变更当天（UTC0）起归新人。上线前没有历史，上线前的日子一律按上线时的值（11 只算上线月及以后，R-11-001）。补：上线前不回填历史；上线后客户销售变更以 04 直接保存时刻或审批通过时刻为准（2026-10-21 补，技术答复 T15：现有操作日志能取到大部分历史，用户定不回填） | 由我代定（承接 D-11-01 的必要条件，2026-10-20），评审确认；用户确认不回填（2026-10-21，会议清单 v2 技术答复 T15，Q-11-01 随之关闭） | 02、04、10、11 |
| D-00-74 | 日汇率 = 当天 UTC 00:17 从系统汇率源取的那一次价格（存 10 位小数），缺当天取之前最近一天，不补拉历史；PRD 中「日均汇率」<!-- alias-ok --> 一律改叫「日汇率」。05 / 06 / 07 / 08 结算类单据提交时锁定的汇率 = 日汇率四舍五入到 4 位，显示与计算一致；10 / 11 利润与提成折算用全精度，详情显示 4 位并注「按完整汇率计算」 | 用户确认（2026-10-21，会议清单 v2 D36、技术答复 T12；4 位误差能否接受待财务确认） | 05、06、07、08、10、11 |
| D-00-75 | 审批变更高亮的比对基准 = 提交那一刻该对象的生效值，随审批单快照保存（规则配置取新起始日期前一天适用的那条），审批中与结束后回看一致，由后端统一给出；标红格下方灰字「原：{原值}」；规则起始日期不参与标红，与已有记录同日时写「将覆盖 yyyy-mm-dd 起的规则」；审批中对象已被改动时内容区顶部提示 | 用户确认（2026-10-21，会议清单 v2 D27、D77） | 03、04、05、12 |
| D-00-76 | 运营 = 账户优化师（02 账户上的已有字段），客户上的「运营」字段去掉（04 列表、添加 / 编辑、详情、审批内容区不再有）；审批动态选项「绑定的运营」解析本单涉及账户的优化师（去重、只取启用用户），客户级单据（新建客户、客户信息变更、付款主体变更、提成规则）取客户名下全部账户的优化师，没有账户时解析为空、该节点跳过；解析出多人按 D-00-43 会签；03～08 提交审批时传本单涉及的账户 | 用户确认（2026-10-21，会议清单 v2 D29、技术答复 T02） | 02～08、12 |
| D-00-78 | 财务中心各菜单与审批中心取消「登录用户常显」，一律按页面查看权限点显示，没有查看权限就没有菜单、直接访问显示「无权限访问」。本期财务相关权限点共 19 个（13 原列 15 个 + 新增「费用管理（查看）」「账单管理（查看）」「返点管理（查看）」「审批中心（查看）」），清单以 13 为准；费用 / 账单 / 返点的数据仍按账户查看权限过滤。审批人候选只列持「审批中心（查看）」点的启用用户（外部账号不会被分配该点）；已配的审批人被收回该点后，仍可从通知链接打开审批详情并处理。上线配完角色后用户须重新登录才生效：菜单显示按登录时的权限，重新登录后刷新；涉及财务动作的接口按库里当前的角色权限校验，权限一收回立即生效。sys（拥有全部账户）只影响各页能看哪些数据，不授予 19 个权限点中的任何一个；上线未配点之前，所有人（含 sys）都看不到财务各菜单和审批中心（2026-10-22 补：接口按当前权限校验，闭环清单 A04；sys 不授予权限点，闭环清单 A05） | 用户确认（2026-10-21，会议清单 v2 D86、D31、技术答复 T10 / R7）；用户与技术确认（2026-10-22，闭环清单 A04、A05） | 05～13 |
| D-00-79 | 审批通用口径：①最后一个审批人通过时，业务执行失败一律回滚：审批单保持审批中，这次通过不记录，确认框显示业务原因，详情页记「最近一次通过未执行：原因（审批人 时间）」；哪些情形算执行失败由各业务包列明（07 后付抵扣通过时不复核、08 错误行跳过仍不算失败）。②撤回只校验申请人本人 + 单据审批中，不校验业务权限点。③持「审批配置」权限点的人可对任何审批中的单执行「作废」：二次确认、原因必填，效果同撤回，时间线记「{操作人} · 作废 · 时间 · 原因」，通知申请人和未处理的审批人 | 用户确认（2026-10-21，会议清单 v2 D26、D81、D28） | 01、03～08、12、13 |
| D-00-82 | 金额输入统一口径：金额输入框只接受数字和一个小数点，负号、字母输不进去，小数第 3 位按不下去；粘贴或自动填充的非法内容不写入、保留原值，并就地标红「请输入不小于 0、最多 2 位小数的金额」；任何情况下都不静默四舍五入或截断；其他校验（超过可用余额、反算无解等）一律就地标红 | 用户确认（2026-10-21，会议清单 v2 D34-输入，A 档默认采纳） | 05、06、07 |
| D-00-83 | 已禁用用户的显示与保留：已禁用用户在列表、详情、审批详情、下拉回显里显示「姓名（已禁用）」，不显示 userId；编辑保存时原值原样保留，不算一次变更（不写变更记录）；用户主动改选时候选只有启用用户，改掉以后不能再选回已禁用的人。适用于 04 销售，02 优化师 / 合作者 / 观察者；审批动态节点解析到已禁用用户按解析为空跳过（D-00-50、D-00-76） | 用户确认（2026-10-21，会议清单 v2 D41-显示与保存，A 档默认采纳） | 02、04、12 |

### 2.3 客户登记 / 客户 / 账户

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-05 | 登记表「审核」只核材料，不走审批流 | 客户登记表.html:2534 | 01 |
| D-00-06 | 登记表状态：审核通过 → 待关联；关联客户 → 待开户；关联账户 → 已开户 | 用户确认 | 01、02、04 |
| D-00-07 | 客户状态（待开户 / 待投放 / 投放中 / 停止投放）与登记表状态是两套。客户状态按消耗判定：任一账户某日（UTC0）消耗 > 0 → 投放中；名下全部账户连续 30 个完整自然日无消耗 → 停止投放；恢复消耗回到投放中；每日 UTC0 日结后判定；05 停投不直接改客户状态；存量按历史消耗推导一次（S-8）（2026-10-21 改：原为「停止投放沿用现有状态机，技术核实」，技术答复现有系统没有这个状态机，会议清单 v2 D22） | 客户管理.html:1899 + 用户确认；用户确认（2026-10-21，会议清单 v2 D22） | 04、02、05 |
| D-00-09 | 客户资料审批：审批中展示当前生效信息；只有审批中可撤回，撤回后原单作废、不能原单重提 | 客户管理.html:3040、3049 | 04、12 |
| D-00-77 | 客户数据范围保留现状隔离：非 sys 用户在客户管理及依赖客户可见性的页面，只能看、改自己是该客户「销售」、或是其名下任一账户「优化师」的客户；sys 看全部（改 D-12-26 前提「现有权限不隔离」）。离职人员名下客户由 sys 改销售 / 优化师后交接。例外：02 添加账户时「所属客户」下拉不受本条限制，列出全部客户（仍按账户系统过滤，R-02-004；添加账户通常由优化师操作，用户 2026-10-21 定维持现有可见全部客户的做法） | 用户确认（2026-10-21，会议清单 v2 D21） | 03、04、05、12 |

### 2.4 费用 / 账单 / 结算单

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-10 | 账单每月 2 日自动生成上月账单（UTC0 自然月）；结算单不是账单，是由人从账单手动生成的待付款单据 | 账单管理.html:3931 + 用户确认 | 06、09、10 |
| D-00-11 | 预付账单逐张判断结清：该结算期内全部消耗都已被分桶先进先出覆盖（锁定中的分桶不参与覆盖）即「已结算」，与其他月份、其他账户无关；出账时判一次，之后覆盖关系变化（到账、余额分配、返点抵扣、锁定释放、消耗修正）和每个 UTC0 日再判；未结清的副标「欠费 x {币种}，待充值」，并通知商务（2026-10-21 改：原为「预付客户：账期最后一天余额 ≥ 0 自动结算；< 0 保持待结算并通知商务」，会议清单 v2 D03） | 费用明细.html:3612 + 用户确认；用户确认（2026-10-21，会议清单 v2 D03） | 05、06 |
| D-00-14 | 充值流程：发起充值 → 审批 → 审批通过 → 提交同一收款单 → 确认收款 → 充值到账 → 写交易明细；同客户有审批中的充值单时禁止再提交；凭证最多 10 份、每份 ≤ 5MB；可分配实际金额合计必须为 0；充值余额 = 实际金额 /（1 + 税率 + 服务费率 + 服务费率 × 税率） | 费用管理.html:4856、4864 | 05、09 |
| D-00-51 | 充值的服务费率阶梯按**本次单笔充值余额**（到账净额，记为 B）落档；规则配置的「按月 / 按日统计」不作用于充值。B 落在该档 [下限, 上限) 内即用该档；按「应收金额」反算时从高档往低档试，两档都成立取高档（低费率）；哪一档都不成立时按 D-05-15 标红并提示可填范围甲、乙，不能提交。例（未计税）：0–10,000 收 5%、10,000 起收 1%，应收 10,400 → 两档都成立，取第二档，充值余额 ≈ 10,297.03。10-20 曾定的「按应付判档」作废（2026-10-21 改：原为「反算出的充值余额 ≥ 该档下限即落该档」，例子为「0–10000 收 5%、10001–100000 收 1%」，档位不连续，会议清单 v2 D04、技术答复 T16） | 费用管理.html:4856 + 用户确认（2026-10-19，原 Q-00-06）；用户确认（2026-10-21，会议清单 v2 D04） | 05、03 |
| D-00-52 | 充值退款：每个账户的「退款余额」须 > 0 且 ≤ 该账户可用余额（已刨除锁定余额）；超出时该输入框标红提示、不能提交。应退金额公式与分桶沿用原型（退款余额 ×(1 + 税率 + 服务费率 + 服务费率 × 税率)，公司承担服务费税费时不加最后一项，按充值时规则分桶） | 费用管理.html:4864 第六节 + 用户确认（2026-10-19，原 Q-00-07） | 05 |
| D-00-53 | 额度调整：额度 ≥ 0、最多 2 位小数、不设上限，填 0 = 取消额度；币种跟账户的币种走；额度有效期仅预付客户展示、可空，到期（UTC 有效期当日 23:59:59）自动清零；只有额度生效后才提交的充值单到账、且到账后该账户可用余额 > 0 时额度才清零（不是按到账金额递减），否则保留，直到之后有满足这两个条件的充值到账或有效期到期（2026-10-21 改：原为「该账户有任意一笔充值到账，额度直接清零」，会议清单 v2 D97） | 费用管理.html:4864 第七节 + 用户确认（2026-10-19，原 Q-00-07）；用户确认（2026-10-21，会议清单 v2 D97） | 05 |
| D-00-54 | 余额分配「充值余额账户列表」的列为 账户名称 / 账户余额 / 实际金额 / 税费 / 服务费 / 服务费税费 / 充值余额（原型重复的第一个「服务费」是「税费」的笔误）；取出余额须 > 0 且 ≤ 可用余额，可分配实际金额必须为 0，公式沿用原型 | 费用管理.html:4681/4689、4848–4856 + 用户确认（2026-10-19，原 Q-00-07） | 05 |
| D-00-57 | 没有适用规则按 0 算：账户没有规则配置（如存量账户还没导入、也没在页面补配规则），或某天早于该账户第一条规则的起始日期时，不沿用老字段，服务费率、税率、返点比例、客情比例一律按 0（充值写多少到账多少，即 1 + 各费率 = 1）。充值 / 退款 / 余额分配照常提交、出账与返点照常计算，不拦截、不标异常，页面不加提示（静默，见 D-05-38、D-06-08）。存量账户在 04 客户材料的历史上传文件行（一份附件只对应 1 个账户；无附件的账户由迁移补一行占位「上线迁移补建（无附件）」）提供「规则配置」入口，与 03 同页同审批；上线前仍批量导入固定比例规则（S-1，用户收集现有在跑账户的数据与规则交技术导入），阶梯 / 分段上线后在页面配，须在上线当月内提交，并在次月 2 日（UTC0）出账前审批通过，晚于这个时点的只对之后的月份生效（列入上线检查项）（已封账 / 已冻结的账单不因补配规则重算）（2026-10-22 改：原为「须在首个月末结算前配完」，闭环清单 A14）（2026-10-19 改：原为「不算钱、不按 0 算，充值拦截、出账标异常」，用户在 06 会话确认改按 0 计，并授权 06 会话直接改本条，见 D-06-08；同日用户在 05 会话定为静默不提示，06 会话据此去掉「界面标注」一句）（2026-10-21 改：原为「系统内不新增补录入口」，会议清单 v2 D20、技术答复 T03） | 03 · X-2 + 用户确认（2026-10-19，原 Q-00-22；同日 06 会话修订）；用户确认（2026-10-21，会议清单 v2 D20）；用户与技术确认（2026-10-22，闭环清单 A14） | 05、06、07、03、04 |
| D-00-58 | 服务费多行时间区间下，一笔充值按**提交当天**（UTC0）是该账户消耗首日后的第几天，落到对应那一行，再在该行阶梯里按 D-00-51 落档；账户还没有消耗首日时按第一行。提交时算出的适用规则、费率、税费、服务费、服务费税费、充值余额、结算币种汇率随审批单锁定，到账时不重算。例：1～30 天 5%、31 天起 3%，消耗首日 1/1，2/15 提交 → 第 46 天 → 用第二行（2026-10-19 改：原为「到账当天」，用户在 05 会话确认改按提交时锁定，并授权 05 会话直接改本条，见 D-05-14） | 03 · X-4 + 用户确认（2026-10-19，原 Q-00-23；同日 05 会话修订） | 05 |
| D-00-59 | 账单状态：未出账 → 待结算 → 待支付 → 已结算。后付款：每月 2 日出账进「待结算」；结算单审批通过（生成收款单，待完成）→「待支付」；收款单确认收款（已完成）→「已结算」；应付为 0.00 的结算单审批通过即「已结算」、不生成收款单（D-00-80）。预付款不经过「待支付」：按 D-00-11 逐张判断，结清即「已结算」，未结清留在「待结算」；预付改后付生效时仍待结算的预付账单按 D-00-73② 随承接它的后付账单一起变「已结算」。账单按该结算期的计费模式流转（D-00-73）（2026-10-21 改：预付半句原为「出账后余额够就自动「已结算」，不够留在「待结算」」，会议清单 v2 D03；补 0 元单与按结算期计费模式流转，会议清单 v2 D02、附录 Z72） | 账单管理.html:3923/3931 + 用户确认（2026-10-19，原 Q-00-08）；用户确认（2026-10-21，会议清单 v2 D03、D02） | 06、09 |
| D-00-60 | 结算单不单独设状态：审批阶段看 12 的审批单状态（审批中 / 已通过 / 已驳回 / 已撤回），审批通过后看收款单状态（待完成 / 已完成） | 用户确认（2026-10-19，原 Q-00-08） | 06、09、12 |
| D-00-61 | 一张账单同一时间最多 1 张在途结算单（审批中，或已通过但收款未完成），有在途时不显示「生成结算单」；结算单被驳回 / 撤回后账单留在「待结算」，可重新生成；不支持一张账单拆多张结算单 | 用户确认（2026-10-19，原 Q-00-08） | 06 |
| D-00-62 | 结算币种与账单币种不同时，取**提交当天**（UTC0）的日汇率（D-00-74，缺当天向前取最近一天），四舍五入到 4 位后随单锁定，显示与计算都用这 4 位，之后收款晚了也不重算；结算单与审批详情展示原币金额、所用汇率（写成「1 {原币} = x {结算币种}（yyyy-mm-dd）」，日期为实际取到的汇率日期）、换算后金额（2026-10-21 改：原为「生成结算单当天的系统日均汇率<!-- alias-ok -->」，会议清单 v2 D35-汇率变化、D36、附 2 G1-9） | 用户确认（2026-10-19，原 Q-00-12）；用户确认（2026-10-21，会议清单 v2 D36） | 05、06、07、08、09 |
| D-00-73 | 计费模式变更从确定时刻的次月 1 日（UTC0）生效（预付改后付以审批通过时刻、后付改预付以保存时刻为准），同一结算期只有一种计费模式，06 账单按该结算期的计费模式流转。预付改后付生效后：①剩余未锁定分桶保留、生效月起的消耗不再扣分桶；切换前最后一个预付月在出账判结清或冻结之前，分桶照常按先进先出覆盖它，包括期间补报的消耗、释放的锁定分桶、新到账的充值，欠费冻结之后的消耗不再被分桶覆盖；该客户后付账单生成结算单时按账户自动带出「余额抵扣」= min(该账户剩余应收, 该账户未锁定分桶按退款口径 R-05-027 折算的应退金额)，先扣返点抵扣、再扣余额抵扣；提交时锁定分桶，审批通过扣减余额并写交易明细「余额抵扣账单」，驳回 / 撤回释放；余额抵扣算客户已付款（计入到款），返点抵扣不计到款；抵不完的留到下期；改回预付后剩余分桶恢复先进先出。②切换前仍「待结算」的预付账单，生效时把欠费（未被分桶覆盖的消耗 + 按该月规则应结的服务费、税费、服务费税费）冻结，冻结时不属于任何分桶的那部分消耗从余额计算中剔除；冻结的欠费在该客户下一张后付账单生成时按账户作为「上期预付欠费（yyyy-mm）」挂上，挂上前原预付账单副标「欠费待转入下一张后付账单」，挂上后副标「欠费已转入 yyyy-mm 账单」，承接账单已结算时一起变已结算；挂上前客户又改回预付的，解除冻结，欠费退回余额，原账单重新按 R-06-022 判结清；切换前最后一个预付月份在生效时还没出账的，出账时按 R-06-021 判一次，没结清再冻结并转入；已冻结转入后付账单、或已结算冻结的切换前月份，之后的消耗修正不再进余额、也不再参与分桶覆盖，线下处理（§2.9）。③应收被抵扣到 0 的结算单审批通过即已结算（同 D-00-80）。④生效时仍在审批中的退款 / 余额分配照常走完，释放的分桶按①处理（2026-10-22 改：①原为「剩余未锁定分桶保留、不再被消耗扣」，闭环清单 A06；②原为「并入第一张后付账单…承接月份没有账单的顺延到下一张后付账单」，未写余额剔除、改回预付与冻结后消耗修正，闭环清单 A07） | 用户确认（2026-10-21，会议清单 v2 D02、技术答复 T01）；用户与技术确认（2026-10-22，闭环清单 A06、A07） | 03、04、05、06、07、09、10 |
| D-00-81 | 后付返点抵扣超出账单：生成结算单时可结算应收 < 0，应付固定 0.00、只读；超出部分（−可结算应收）在结算单审批通过时生成结转额，按原账单里可结算应收为负的账户行、按负数大小占比拆到账户，挂到该账户最早一张后付、待结算、未锁定的账单（没有就挂起，等下一张后付账单出账；目标月份已在审批中 / 已结算则顺延）；出账时客户已转预付则按 0 费率充进该账户余额并写交易明细；挂上后计入目标账单该账户行的「客户返点」，返点时间范围加一行「yyyy-mm 结转」；弹窗与审批内容区显示「本次抵扣 X，剩余 Y 结转至下期」；人工把正数应付改成 0 不产生结转（2026-10-22 改：拆分口径原为「应收为负的账户行占比」，闭环清单 A11） | 用户确认（2026-10-21，会议清单 v2 D09、技术答复 T04 / R5）；用户与技术确认（2026-10-22，闭环清单 A11） | 05、06、07 |

### 2.5 返点 / 客情

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-15 | 客户返点 =（规则有效期内消耗 − 同客户、同账户、同规则有效期内 MAX 类型广告系列消耗）× 返点比例；统一币种后扣减，基数不小于 0。补：MAX 按当天的出价策略识别（出价策略为 MAX_CONVERSIONS 的广告系列；一天内改过的按当天 UTC0 结束时的策略计整天），系统从上线起记录策略变更，上线前的日子按上线时的策略（S-23）（2026-10-21 补，会议清单 v2 附 1 B1、技术答复 T14） | 用户确认；用户确认（2026-10-21，会议清单 v2 附 1 B1） | 07、03 |
| D-00-16 | 返点每个自然月分别结算；比例按规则配置里的时间区间和规则生效日期取 | 用户确认 | 07、03 |
| D-00-17 | 返点兑现方式（余额抵扣 / 现金打款）只影响兑现形式，不改变应计金额；进单时返点、客情的实际金额允许人工调整，成本按实际金额计（D-07-04，2026-10-19 补） | 用户确认 | 07、10、11 |
| D-00-18 | 后付余额抵扣：选择「纳入扣减月份」，该月账单可结算应收须 ≥ 本次返点，否则不能选 / 提交；同一张账单同时只允许一张审批中的抵扣单（2026-10-21 改：原为「该月账单应付须 ≥ 本次返点」，评审合并清单附 A；补占用规则，会议清单 v2 D10） | 返点管理.html:3382–3420 + 用户确认；用户确认（2026-10-21，会议清单 v2 D10） | 07、06 |
| D-00-19 | 预付也可以余额抵扣：不挂账，审批通过后立即充值到账户余额，不选月份 | 用户确认 | 07、05 |
| D-00-20 | 客情费用 = 规则有效期内全部有效消耗 × 客情比例，不扣 MAX | 用户确认 | 07、03 |
| D-00-21 | 客情结算方式三选一：无客情 / 90 天 / 按自然月。90 天是计提有效期：从首日消耗起算、含第 90 天；账单仍每月出，只算当月与有效期重叠的日子（例：1/15 开始 → 1 月算 15–31 日，2、3 月整月，4 月算 1–15 日）；客情费逐月计提生成 | 规则配置.html:2248–2318 + 用户确认 | 03、07 |
| D-00-22 | 客情比例固定 / 阶梯；阶梯一律按自然月消耗落档 | 用户确认 | 03、07 |
| D-00-55 | 同一账户同一个月内规则切换（月中有新规则开始生效）或跨服务费时间区间时，按各自生效日期切成几段，每段只用落在段内的消耗分别落档、分别计算；服务费、返点、客情都一样。规则怎么切、某日用哪条，统一按 03 的 R-03-003、R-03-010。补：相邻两段某项条款完全相同（服务费看服务费规则与税率，返点看返点比例，客情看客情结算方式与比例）就合并成一段再落档；时间区间行本身月中切开仍分别落档（2026-10-21 补：原为按规则记录切段、各段分别落档，会议清单 v2 D93） | 用户确认（2026-10-19，原 Q-00-13；03 · D-03-10）；用户确认（2026-10-21，会议清单 v2 D93） | 03、06、07 |
| D-00-56 | 消耗首日 = 登记表绑定账户第一次有消耗那天（UTC0），该登记表所有规则共用、换规则不重算；所以返点、「首次消耗起 90 天」客情只覆盖账户首次消耗起第 1～90 天，过了第 90 天再改返点比例不再起作用；「按自然月每月返还」客情没有截止日，规则生效期间每天都算。补：消耗首日首次确定后冻结，补报更早的消耗不改首日；早于首日的日子服务费落第 1 行，返点与首次消耗起 90 天客情不计提；确需改首日由技术处理并留记录（2026-10-21 补，会议清单 v2 D95） | 用户确认（2026-10-19，03 · D-03-01、R-03-005～R-03-008）；用户确认（2026-10-21，会议清单 v2 D95） | 03、05、06、07 |

### 2.6 渠道对账

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-23 | 匹配键：orgid（账户 ID） | 用户确认 | 08 |
| D-00-24 | 来源互斥：系统能抓的渠道统计金额不开放上传；抓不到的才上传文件 | 用户确认 | 08 |
| D-00-25 | 标准上传模板（.xlsx）字段：账户系统、orgid、消耗金额、税费、渠道返点、总计金额；结算期在上传前的窗口里选，模板不带；平台、应用、币种不要；模板文件见 R-08-032（2026-10-19 改：列名「返点金额」改「渠道返点」，用户在 08 会话确认，见 D-08-12） | 用户确认 | 08 |
| D-00-26 | 模板「总计金额」直接作为系统的「渠道统计金额」，系统不用 消耗 + 税费 − 返点 反算 | 用户确认 | 08、10 |
| D-00-27 | 三份渠道样表只是参考，正式模板由我们统一归纳后出 | 用户确认 | 08 |
| D-00-28 | 上传 = 先审批、后处理：一次上传一个批次、一张审批单，整批通过或驳回；审批通过后才落数 | 用户确认 | 08、12 |
| D-00-29 | 提交审批前先解析校验，列出错误清单（原始行号 + 错误原因）并问是否继续，可以带错误行提交；审批通过时用当时的数据再校验一次，错误行跳过、只录入正确的行，不阻断其他行，也不自动分配（2026-10-19 改：原为「审批通过后才抛错误清单」，用户在 08 会话确认，见 D-08-09、R-08-037、R-08-051） | 用户确认 | 08 |
| D-00-30 | 修正文件重新审批通过后，整批替换同渠道（= 同账户系统，D-08-01）、同结算期的旧导入数据；旧版本留存追溯，不再参与当前计算 | 用户确认 | 08 |
| D-00-31 | 样表里的「激励金」= 渠道返点，按原值录；结算时允许用户自选结算币种 | 用户确认 | 08 |

### 2.7 收付款

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-32 | 收款只确认一次到账；记录实收，手续费 = 应收 − 实收（少收为正、多收为负）；确认后账单直接结清，不留未收余额；差额字段沿用「手续费」叫法，不另存真实银行手续费（2026-10-20 补，D-09-04，原 Q-00-09）。10 计毛利时的手续费另并入结算单改应付差额，见 D-00-34（2026-10-21 补，会议清单 v2 D16） | 用户确认 | 09、06、10 |
| D-00-33 | 付款单三态：待汇出 →（确认汇款：登记汇出金额 + 上传打款凭证）→ 待完成 →（确认到账：登记到账金额 + 上传到账凭证）→ 已完成；**到账才算完成**，来源单据回写与 10 / 11「算完」（D-00-65）都以「已完成」为准；汇出金额、到账金额与应付金额可以不同，只记录（2026-10-20 改：原为「确认汇出即完成，到账回执不作门槛、到账金额可选记录」，用户在 09 会话确认改为到账才算完成，并授权 09 会话直接改本条，见 D-09-01） | 用户确认（2026-10-20 09 会话修订） | 09、05、07、08、10、11 |
| D-00-69 | 本期收付款单不对用户提供作废、退回、撤销（sys 兜底撤回见下），生成后只能往前推进，后续版本再加（D-09-02）。各来源单据（05 充值 / 退款、06 结算单、07 现金打款的返点 / 客情、08 渠道付款）的「收付款单作废后回到什么状态」本期都不做。已知限制：客户一直不付时收款单一直待完成，06 账单一直「待支付」、不能重新生成结算单（D-00-61），10 / 11 一直「计算中」（R-09-075）。补：「撤回待到款充值」「撤回待汇出退款」两个入口不对前端暴露，只留 sys 兜底并记日志：充值收款单待完成时撤回 → 不到账、交易明细显示「已撤回」、额度不清零；退款付款单待汇出时撤回 → 把审批通过时已扣的退款余额按原分桶快照加回、交易明细显示「已撤回」；09 加只读状态「已撤回」。已知限制补错单（币种、金额、付款主体 / 收款主体发错）与退款被银行退回：线下结清，确需改数据由技术逐单出方案、用户确认后执行并留日志（2026-10-21 改：原为「本期收付款单不支持作废、退回、撤销」且无 sys 兜底，会议清单 v2 D32） | 用户确认（2026-10-20，09 会话）；用户确认（2026-10-21，会议清单 v2 D32） | 05～11 |
| D-00-80 | 0 元单口径：06 应付为 0.00 的结算单（返点抵满、D-00-81 结转、余额抵扣抵满、人工改为 0）审批通过即「已结算」，不生成收款单（与 07 一致）；09 实收、汇出、到账金额必须 > 0（应收为 0 的历史例外照旧，且到账凭证选填）；08 第一层总计 > 0 才能发起渠道付款，总计为 0.00（有值）的行在结算期结束后视为已完成、10 判渠道付完，总计 < 0 不能发起、线下处理（已知限制） | 用户确认（2026-10-21，会议清单 v2 附录 Z72、D33） | 06、07、08、09、10 |

### 2.8 利润 / 提成

| 编号 | 结论 | 依据 / 确认人 | 影响页面 |
| --- | --- | --- | --- |
| D-00-34 | 毛利润 = 消耗 + 服务费 + 税费 − 客情费用 − 客户返点 − 手续费 − 渠道统计金额 − 公司承担服务费税费（代理商口径）；手续费 = 改前应收 − 实收（结算单改应付的差额并入手续费，10 展示拆「手续费（09）」「改应付差额」两行）；「公司承担服务费税费」按 R-10-008 计算（待财务确认；自接苹果税费性质待财务答）（2026-10-21 改：原为「… − 手续费 − 渠道统计金额（代理商口径）」，手续费 = 应收 − 实收、改应付差额不另算，会议清单 v2 D16、D17）（2026-10-22 改：原为「= 公司承担的日子里当天服务费 × 当天税率」，只覆盖后付，闭环清单 D 组） | 用户确认；用户确认（2026-10-21，会议清单 v2 D16、D17；D17 前提财务确认）；用户与技术确认（2026-10-22，闭环清单 D 组） | 10、11 |
| D-00-36 | 利润页只展示人民币；原币和所用汇率只在详情里辅助展示 | 用户确认 | 10 |
| D-00-37 | 提成本期只做展示，不做实际支付闭环 | 用户确认 | 11 |
| D-00-38 | 提成规则在费用管理里配置，走审批，通过后生效；销售、优化师分别配置 | 费用管理.html:3642–3668、3838–3863 + 用户确认 | 05、11 |
| D-00-39 | 提成基数二选一：按毛利 / 按服务费（不含税）；两种都支持阶梯 | 用户确认 | 05、11 |
| D-00-40 | 存量阶梯：整笔 × 该档比例，不做累进拆档；区间左闭右开，最后一档无上限。规则身份 = 一个版本里的一条规则，跨版本不算同一条；同一人、同一角色、同一月、同一版本内同一条规则的基数合计落一档、按 R-05-073 封顶；月中换版本 = 两条规则各自落档、各自封顶（当月上限最多翻倍，用户接受）（2026-10-21 改：原为「角色当月名下账户基数合计落一档」，会议清单 v2 D18） | 用户确认；用户确认（2026-10-21，会议清单 v2 D18） | 05、11 |
| D-00-41 | 提成规则按日生效：从生效日期起切分新旧规则。生效日期由提交人选，最早只能选当月 1 号；审批通过后按所选日期生效，跨月才通过也按所选日期（例：10-30 提交、选 10-01、11-03 通过 → 10 月提成按新规则重算）；早于所选生效日期的日子不回算。11 已算完的人员月因规则通过或 10 数据变化而金额变化时，记变化记录（时间、原因、触发单据、前后金额），行上标「金额有变化」，不锁（2026-10-19 改：原为「不回算历史日期」，用户在 05 会话确认生效日期可选，见 D-05-08、R-05-075、R-05-108）（2026-10-21 改：原为「按 D-00-66 退回」，会议清单 v2 D19） | 用户确认；用户确认（2026-10-21，会议清单 v2 D19） | 05、11 |
| D-00-42 | 利润和提成一起看「算没算完」：当月渠道付完、客情和返点结算完、客户付款收完、汇率齐全，才算算完（状态与完成标志见 D-00-63～66；2026-10-21 补「汇率齐全」，会议清单 v2 D61；D111 维持毛利规则与服务费规则都要等算完） | 用户确认；用户确认（2026-10-21，会议清单 v2 D61、D111） | 10、11 |
| D-00-63 | 「算没算完」按**账户 × 自然月**判断，每个账户每月一个状态；客户级、全公司级汇总只显示「N 个账户中已算完 M 个」 | 用户确认（2026-10-19，原 Q-00-14） | 10、11 |
| D-00-64 | 状态只有 计算中 / 已算完，系统自动判断、无人工确认按钮；「计算中」的行显示还差哪几件（客户未收完 / 返点或客情未结完 / 渠道未付完 / 缺少汇率）（2026-10-21 补「缺少汇率」，会议清单 v2 D61） | 用户确认（2026-10-19，原 Q-00-14） | 10、11 |
| D-00-65 | 算完的完成标志：①客户收完 = 该账户当月账单「已结算」（D-00-59）；②返点 / 客情结完 = 当月返点单、客情单都已兑现（余额抵扣审批通过，或现金打款付款单已完成），当月无返点 / 无客情视为完成；③渠道付完 = 该账户当月渠道统计金额不是「-」且所属账户系统该结算期行已完成；付款后才有值或金额变化的账户同样算付完（差额由 08「金额有变化」提示、线下处理）；系统抓取类账户系统所属行已完成后，本期有消耗、无订单的账户视为付完、按 0 计（订单到了退回重算）；总计为 0.00 的行视为已完成（D-00-80）；④汇率齐全：该月用到的每一天都取得到汇率，缺时还差项为「缺少汇率」。只算出金额不算完成（2026-10-21 改：③原为「该账户当月渠道统计金额已有（抓取或导入入账）且对应渠道付款单已完成」，会议清单 v2 D12、D33；新增④，会议清单 v2 D61） | 用户确认（2026-10-19，原 Q-00-14）；用户确认（2026-10-21，会议清单 v2 D12、D61） | 10、11、06～09 |
| D-00-67 | 后付「余额抵扣」的客户返点单提交时校验「本次返点 ≤ 所选账单可结算应收」，且同一账单同时只允许一张审批中的抵扣单（D-00-18），最后一个审批人通过时不复核，照常生效；审批期间账单变小导致可结算应收为负的，按 D-00-81 结转；最终通过时业务执行失败的通用口径见 D-00-79①（本条不算执行失败）（2026-10-21 改：原为「只在提交时校验『本次返点 ≤ 所选账单可结算应收』…审批期间账单金额变小导致应收被扣成负数的，由生成结算单的人改应付处理（应付本可改，D-06-09）；12 审批引擎不加『最终通过时业务否决』」，会议清单 v2 D09、D10、D26） | 用户确认（2026-10-19，原 Q-07-04：用户认为这种情况很少见，要最简单的办法）；用户确认（2026-10-21，会议清单 v2 D09、D10、D26） | 06、07、12 |
| D-00-66 | 已算完的账户月份数据又变了（如渠道修正文件整批替换 D-00-30、补一笔返点），自动退回「计算中」，利润与提成按新数重算，重新满足完成标志后再回「已算完」；每次退回记日志（时间、原因、触发单据）。例外：账户月首次判为已算完时锁定所用汇率，之后补录 / 修订汇率不让已算完月份退回（2026-10-21 补，会议清单 v2 D110） | 用户确认（2026-10-19，原 Q-00-14）；用户确认（2026-10-21，会议清单 v2 D110） | 10、11 |

### 2.9 版本级已知限制

<!-- 本期接受、不做系统处理的情形；细节在各页已知限制里。 -->

- 收付款单本期不对用户作废 / 退回 / 撤销，客户一直不付、错单、银行退回按 D-00-69 处理。
- 后付返点结转额（D-00-81）在客户之后再没有后付账单（如停投）时一直挂起，不自动退回或打款（会议清单 v2 D09）。
- 08 第一层总计 < 0 的行不能发起渠道付款，行保持待完成，线下处理（D-00-80）。
- 08 导入选错结算期时，系统不能把该结算期清回「未上传」；正确文件到了后再导入整批替换，在此之前不要对该行发起渠道付款，付款审批人按审批内容核对（会议清单 v2 D14-作废分段）。
- 创建人账号已禁用的待审核登记表本期不处理，让客户重新填一张新表（会议清单 v2 D24；创建人已禁用、或创建人当前没有「客户管理-读写」的待关联登记表，持「客户管理-读写」的人可在 04 绑定下拉里选，闭环清单 B18）。
- 「客户登记管理」被收回后，创建人删不了自己的登记表（D-00-70，闭环清单 B18）。
- 渠道返点隔月单独打回、不在总计里冲抵的情形本期不记，导入时「总计金额」须填冲抵渠道返点后的实际应付（会议清单 v2 D107）。
- 预付账单已结算冻结后再有消耗修正，只改 05 的余额、不改账单，两边金额可能不一致（R-06-020，闭环清单 D 组）；预付改后付的切换前月份按下一条。
- 预付改后付时，已冻结转入后付账单、或已结算冻结的切换前月份，之后的消耗修正不再进余额、也不再参与分桶覆盖，线下处理（D-00-73②，闭环清单 A07）。
- 客户全月零消耗、只有苹果订单或 08 入账时，06 不生成账单，渠道金额在 08 / 10 查看（06 §2.1.5，闭环清单 B17）。

## 3 术语表

<!-- 一个东西一个叫法。validate.mjs 会在各页 PRD / spec / mocks 里扫「禁用别名」，命中即报错（带 alias-ok 的行除外）。 -->

| 标准叫法 | 含义 | 禁用别名 |
| --- | --- | --- |
| 人民币 | 币种枚举之一（D-00-08） | CNY |
| 销售 | 客户上的负责人字段（原「商务」字段，同一个字段，D-04-10）；账户列表、高级筛选里的账户销售实时取所属客户的销售（D-02-03）；提成按业务日的历史归属，不实时取（D-00-72） | — |
| 优化师 | 账户上的负责人字段（02）；「运营」与「优化师」是同一角色，客户上不再有「运营」字段（D-00-76） | — |
| 绑定的销售 | 审批流动态选项：解析审批单操作对象客户的「销售」（只取启用用户，D-00-50） | 绑定的商务 |
| 绑定的运营 | 审批流动态选项：解析本单涉及账户的「优化师」（去重、只取启用用户；客户级单据取客户名下全部账户；多人即会签，D-00-76） | — |
| 内部用户 | 公司内部员工账号，与外部 / 客户侧账号相对。本期财务菜单与审批中心按查看权限点控制（D-00-78），不另按用户标签判断 | — |
| 日汇率 | 当天 UTC 00:17 从系统汇率源取的那一次价格，缺当天取之前最近一天（D-00-74）；结算类单据锁 4 位（D-00-62），利润 / 提成按全精度（D-00-35） | 日均汇率 |
| 收款主体 | 我们付钱给对方时对方一方的主体：05 充值退款、07 客户返点 / 客情费用现金打款（选项取客户当前生效的付款主体）、08 渠道付款（选填，取该渠道填过的值）及对应审批内容区、09 付款单；客户付钱给我们的场景（05 充值、06 结算单、09 收款单）仍叫「付款主体」，下拉底部入口仍叫「+ 新增付款主体」（会议清单 v2 D37、D14） | — |
| 余额抵扣（后付） | 预付改后付后，该账户剩余未锁定分桶在后付结算单里按账户自动抵扣应收（D-00-73①），交易明细类型「余额抵扣账单」，计入客户到款；不是客户返点兑现方式里的「余额抵扣」（D-00-17～19，在结算单里记为返点抵扣、不计到款） | — |
| 上期预付欠费 | 预付改后付生效时冻结的、切换前仍待结算的预付账单欠费，在下一张后付账单生成时按账户挂上一行「上期预付欠费（yyyy-mm）」（D-00-73②） | — |
| 结转额 | 后付返点抵扣超出账单可结算应收的部分，结算单审批通过时生成，挂到该账户下一张可结算的后付账单、计入其「客户返点」（D-00-81） | — |
| USD | 币种之一（D-00-08） | 美元 |
| 审核 | 内部核对客户登记表材料，不走审批流（D-00-05） | — |
| 审批 | 走审批流（节点 / 会签）的流程，定义在 12 | — |
| 账单 | 每月 2 日自动生成的上月账单（D-00-10） | — |
| 结算单 | 由人从账单手动生成的待付款单据，不是账单（D-00-10） | — |
| 待支付 | 后付款账单的状态：结算单审批已通过、收款还没确认（D-00-59） | — |
| 渠道 | 上游账户系统；「同渠道、同结算期」= 同账户系统 × 同结算期（D-08-01） | — |
| 渠道统计金额 | 上游渠道应付金额；能抓取的用系统数据，抓不到的用上传模板「总计金额」（D-00-24、D-00-26） | — |
| 规则起始日期 | 一条规则配置从哪天（UTC0）开始用（R-03-033） | 规则起始时间 |
| 当前生效 | 规则配置里起始日期 ≤ 今天（UTC0）的记录中起始日期最大的那条（R-03-003） | — |
| 消耗首日 | 登记表绑定账户第一次有消耗那天，记为第 1 天；首次确定后冻结（R-03-005、D-00-56） | — |
| 首次消耗起 90 天 | 客情结算方式之一：从消耗首日起第 1～90 天计提客情，逐月出（D-00-21、D-03-11） | 90天一次性结清 |
| 客户返点 | 我们返给客户的返点，按 D-00-15 计算，07 主管；页面上单写「返点」时指它 | — |
| 渠道返点 | 上游渠道返给我们的返点，渠道样表里叫「激励金」，按原值录（D-00-31），模板列名也叫「渠道返点」（D-00-25），08 主管；只在渠道对账相关页面出现，和客户返点互不抵扣 | 激励金 |
| 账户余额 | 资金入账 − 资金出账 − 累计消耗，动态算，可为负（R-05-001） | — |
| 可用余额 | 账户余额减去审批中的退款、取出占住的锁定金额（R-05-008） | — |
| 授信额度 | 客户打款慢时我们给账户的兜底额度（R-05-010、D-00-53） | — |
| 剩余额度 | 授信额度还剩多少（R-05-013） | — |
| 账户消耗币种 | 账户在投放渠道里消耗的币种，余额、额度都用它（R-05-002） | — |
| 结算币种 | 客户实际打款 / 收退款、渠道付款实际付的币种；05 充值默认客户币种，与原币不同按 D-00-62 换算锁定（R-05-024）；原型字段名「结算货币」是同一个东西（D-00-68） | 结算货币 |
| 打款凭证 | 付款方打款的凭证：收款单上是客户的，付款单上是我们的（D-09-13） | — |
| 到账凭证 | 收款方确认到账的凭证（D-09-13、R-05-096） | 到款凭证 |

## 4 页面清单与分工

### 4.1 页面包

| 页号 | 页面 / 流程包 | 简介 | 主管实体 | 依赖 | 批次 | 负责人 | 状态 | 链接 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 01 | 01-客户登记 | 登记表列表（含已提交审批 tab）、限时外链填写、材料审核 | 客户登记表实体与状态机 | — | 1 | 独立会话 | 待评审 | [PRD](01-客户登记/PRD.md) · [评审版](01-客户登记/review.html) |
| 02 | 02-账户管理 | 添加账户页、编辑账户信息弹窗、登记表预览 | 账户（本版动到的字段） | 01、04 | 1 | 独立会话 | 待评审 | [PRD](02-账户管理/PRD.md) · [评审版](02-账户管理/review.html) |
| 03 | 03-规则配置 | 登记表的规则配置（服务费、税率、返点阶梯、客情）、规则生效判定与取用口径，及其审批记录内容 | 规则配置（规则记录、生效判定、消耗首日、阶梯 / 统计方式） | 01、12 | 2 | 独立会话 | 待评审 | [PRD](03-规则配置/PRD.md) · [评审版](03-规则配置/review.html) |
| 04 | 04-客户管理 | 客户列表 / 详情 / 添加 / 编辑、付款主体、客户材料、三类客户审批内容；流程包：客户材料并入（D-00-47） | 客户实体与客户状态机 | 01、12 | 1 | 独立会话 | 待评审 | [PRD](04-客户管理/PRD.md) · [评审版](04-客户管理/review.html) |
| 05 | 05-费用管理 | 费用管理、费用明细（充值 / 退款 / 额度调整 / 余额分配、提成规则配置）及审批记录内容 | 充值单、交易明细、账户余额、提成规则 | 03、04、12 | 2 | 独立会话 | 待评审（已登记） | [PRD](05-费用管理/PRD.md) · [评审版](05-费用管理/review.html) |
| 06 | 06-账单与结算单 | 月度账单、结算单及审批记录内容 | 账单、结算单 | 05 | 2 | 独立会话 | 待评审（已登记；待用户核对基本流程） | [PRD](06-账单与结算单/PRD.md) · [评审版](06-账单与结算单/review.html) |
| 07 | 07-返点管理 | 客户返点、客情费用计算与兑现及审批记录内容 | 返点单、客情费用单 | 03、05、06 | 2 | 独立会话 | 待评审（已登记；待用户核对总逻辑） | [PRD](07-返点管理/PRD.md) · [评审版](07-返点管理/review.html) |
| 08 | 08-渠道对账 | 渠道统计金额（抓取 / 上传批次）、渠道对账与渠道付款及审批记录内容 | 渠道导入批次、渠道统计金额、渠道付款单 | 02、06、12 | 2 | 独立会话 | 待评审（已登记；与 07 并行产出） | [PRD](08-渠道对账/PRD.md) · [评审版](08-渠道对账/review.html) |
| 09 | 09-收付款中心 | 收款单确认收款（手续费按账户分摊）、付款单确认汇款 → 确认到账；本期不作废（D-00-69） | 收款单、付款单 | 05～08 | 2 | 独立会话 | 待评审（已登记） | [PRD](09-收付款中心/PRD.md) · [评审版](09-收付款中心/review.html) |
| 10 | 10-利润中心 | 账户 × 月毛利润（逐日折人民币）、算没算完与变化记录、给 11 的日数据 | 利润记录、日汇率折算口径、算没算完判断 | 05～09 | 2 | 独立会话 | 待评审（已登记） | [PRD](10-利润中心/PRD.md) · [评审版](10-利润中心/review.html) |
| 11 | 11-提成中心 | 销售 / 优化师提成按日归属、按月落阶梯展示（只展示不支付） | 提成结果 | 02、04、05、10 | 2 | 独立会话 | 待评审（已登记） | [PRD](11-提成中心/PRD.md) · [评审版](11-提成中心/review.html) |
| 12 | 12-审批配置与审批中心 | 14 种审批类型、审批流配置、审批引擎、审批详情通用格式、审批中心 | 审批类型、审批单实体与状态机、审批流 | — | 1 | 独立会话 | 待评审 | [PRD](12-审批配置与审批中心/PRD.md) · [评审版](12-审批配置与审批中心/review.html) |
| 13 | 13-导航与权限 | 导航栏（客户登记表入口、财务中心、审批中心）、本版权限点清单汇总 | 权限点清单 | 全部 | 3 | 独立会话 | 待评审（已登记） | [PRD](13-导航与权限/PRD.md) · [评审版](13-导航与权限/review.html) |

批次说明：13 页全部已出（2026-10-20）：全部待评审（2026-10-20 用户定；06、07 待用户核对基本流程）；05→06→07→09→10→11 财务链彼此强耦合、按顺序做；08 只和 06（渠道统计金额读取）、09（渠道付款单）有接口，不依赖 07，可与 07 并行（2026-10-19）；13 最后汇总。任务卡见 `WORKLOG.md` §5。

### 4.2 需求项归属

| # | 版本记录项 | 页面包 |
|---:|---|---|
| 1 | 账户管理—编辑账户 | [02-账户管理](02-账户管理/PRD.md) |
| 2 | 账户管理—添加账户 | [02-账户管理](02-账户管理/PRD.md) |
| 3 | 客户登记表列表 | [01-客户登记](01-客户登记/PRD.md) |
| 4 | 规则配置 | [03-规则配置](03-规则配置/PRD.md) |
| 5 | 客户登记填写页 | [01-客户登记](01-客户登记/PRD.md) |
| 6 | 客户登记表审批详情（实为规则配置审批，D-01-02） | [03-规则配置](03-规则配置/PRD.md) §2.12（01「已提交审批」tab 只列单子） |
| 7–12 | 客户管理、客户详情、添加客户、编辑客户、客户材料、客户管理审批详情 | [04-客户管理](04-客户管理/PRD.md) |
| 13–15 | 费用管理、费用明细、费用管理审批详情 | [05-费用管理](05-费用管理/PRD.md) |
| 16–17 | 账单管理、账单审批详情 | [06-账单与结算单](06-账单与结算单/PRD.md) |
| 18–19 | 返点管理、返点审批详情 | [07-返点管理](07-返点管理/PRD.md) |
| 20–21 | 渠道对账中心、渠道对账审批详情 | [08-渠道对账](08-渠道对账/PRD.md) |
| 22 | 收付款中心 | [09-收付款中心](09-收付款中心/PRD.md) |
| 23 | 利润中心 | [10-利润中心](10-利润中心/PRD.md) |
| 24 | 提成中心 | [11-提成中心](11-提成中心/PRD.md) |
| 25–26 | 审批配置、审批中心 | [12-审批配置与审批中心](12-审批配置与审批中心/PRD.md) |
| 27–28 | 导航栏、权限管理 | [13-导航与权限](13-导航与权限/PRD.md) |

审批详情页（#6、#12、#15、#17、#19、#21）：业务包只写本业务记录的内容，通用格式在 12（D-00-46）。

## 5 跨页流程总览

| 步骤 | 操作者 | 动作 | 所在页面 |
| --- | --- | --- | --- |
| 1 | 内部用户 | 建登记表、发外链；客户免登录填写提交 | 01-客户登记 |
| 2 | 内部用户 | 审核材料（不走审批）→ 登记表【待关联】 | 01-客户登记 |
| 3 | 内部用户 | 添加客户（后付款走审批）；客户材料绑定登记表 → 登记表【待开户】 | 04-客户管理 |
| 4 | 内部用户 | 添加账户选登记表 → 登记表【已开户】、客户【待投放】 | 02-账户管理 |
| 5 | 内部用户 | 规则配置（走审批） | 03-规则配置 |
| 6 | 内部用户 | 充值等费用操作（走审批）→ 收款确认 → 到账 | 05-费用管理、09-收付款中心 |
| 7 | 系统 | 每月 2 日出上月账单；后付由人生成结算单 → 收款 | 06-账单与结算单、09-收付款中心 |
| 8 | 内部用户 | 返点 / 客情按月结算与兑现 | 07-返点管理 |
| 9 | 内部用户 | 渠道统计金额抓取或上传审批 → 渠道付款 | 08-渠道对账、09-收付款中心 |
| 10 | 系统 | 利润、提成按日汇率折人民币汇总展示 | 10-利润中心、11-提成中心 |

各类审批的配置、推进、撤回、通知统一在 12。

## 6 共用定义指路

| 实体 / 状态机 / 规则 | 定义位置 | 引用页面 |
| --- | --- | --- |
| 客户登记表实体与状态机 | [01-客户登记](01-客户登记/PRD.md) §2.2.4 | 02（待开户→已开户）、04（待关联→待开户）、03（入口） |
| 客户实体与客户状态机（待开户 / 待投放 / 投放中 / 停止投放） | [04-客户管理](04-客户管理/PRD.md) §2.1 | 02（待开户→待投放 R-04-007；销售字段 R-04-004）、12（绑定的销售解析客户的销售，D-00-50；客户上不再有「运营」字段，D-00-76）、03～05、12（客户数据范围，D-00-77）、05～11（币种；签约主体本期下游不读取） |
| 账户实体（本版动到的字段：登记表绑定、投放类型、系统生成字段、销售取客户；优化师即「运营」） | [02-账户管理](02-账户管理/PRD.md) §2.1–2.4 | 01（列表展示绑定账户）、11（销售 / 优化师归属）、12（绑定的运营解析本单账户的优化师，D-00-76） |
| 审批类型清单（14 种）、审批单实体与状态机、审批人解析与会签、撤回 / 作废、最终通过执行失败回滚（D-00-79）、变更高亮基准（D-00-75）、审批通知、审批详情通用格式 | [12-审批配置与审批中心](12-审批配置与审批中心/PRD.md) §2.1–2.6 | 01、03、04、05、06、07、08 |
| 规则配置（服务费、税率、返点、客情）；某日适用规则 / 当前生效（R-03-003）、消耗首日（R-03-005）、时间区间与阶梯落档、按月 / 按日统计（R-03-006～R-03-010）、规则展示格式（R-03-037） | [03-规则配置](03-规则配置/PRD.md) §2.1、§2.9 | 04（客户详情规则配置表取当前生效）、05（充值 / 余额分配取服务费率、税率、服务费税费）、06（账单服务费）、07（返点、客情） |
| 充值单、交易明细、账户余额、提成规则 | [05-费用管理](05-费用管理/PRD.md) §2 | 06、07、09、11 |
| 账单、结算单 | [06-账单与结算单](06-账单与结算单/PRD.md) §2.1–2.4 | 05（费用明细 tab）、07、09、10、11 |
| 返点 / 客情计提项、客户返点单、客情费用单（实际金额、完成口径 R-07-017、R-07-018） | [07-返点管理](07-返点管理/PRD.md) §2 | 06（后付抵扣 R-07-036、R-07-037）、09、10、11 |
| 渠道统计金额、渠道导入批次、渠道付款单 | [08-渠道对账](08-渠道对账/PRD.md) §2 | 06、09、10 |
| 收款单、付款单（生成 R-09-001～004、付款三态 R-09-042 / D-00-33、回写与对外接口 R-09-071～075） | [09-收付款中心](09-收付款中心/PRD.md) | 05、06、07、08、10 |
| 利润记录（账户 × 月）、算没算完判断与缺项（R-10-020～024）、给 11 的日数据（R-10-070） | [10-利润中心](10-利润中心/PRD.md) | 11 |
| 提成结果、销售 / 优化师按业务日归属（R-11-003、D-00-72） | [11-提成中心](11-提成中心/PRD.md) | — |
| 币种与金额精度、金额输入 | 本总纲 D-00-08、D-00-13、D-00-82 | 04～11 |
| 日汇率口径（取数 D-00-74；利润 / 提成全精度折算 D-00-35；结算类提交当天锁 4 位 D-00-62） | 本总纲 D-00-74、D-00-35、D-00-62；业务发生日 [10-利润中心](10-利润中心/PRD.md) R-10-010、R-10-011 | 05、06、07、08、09（结算汇率与利润折算用同一份日汇率）、10、11 |
| 权限点清单（R-13-040、R-13-041；本期财务相关 19 个，菜单一律按页面查看权限点显示、不设登录常显，D-00-78）、导航结构（R-13-001～004） | [13-导航与权限](13-导航与权限/PRD.md)；各页的权限点细则仍在各页 | 全部 |

## 7 存量数据处理汇总

<!-- 版本级唯一一份，总控维护。页面在规则里写细节、在 WORKLOG「跨页影响」上报，总控收到这里；新增或变化的项单独告诉需求负责人。「（暂）」= 页面提了建议、还没定。 -->

| # | 存量对象与范围 | 处理方式 | 用户可见变化 | 提供方 | 执行方 | 核对方 | 时机 | 怎么验证 | 定义在 | 状态 |
| ---: | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| S-1 | 存量在跑账户的规则配置（服务费、税率、返点、客情） | 上线前仍由技术批量导入固定比例规则（模板只支持固定比例），挂在该账户的历史上传文件登记表行上（一份附件只对应 1 个账户；无附件的账户由迁移补一行占位「上线迁移补建（无附件）」）；阶梯 / 分段规则上线后在 04 客户材料该行的「规则配置」入口配（与 03 同页同审批），必须在上线当月内提交，并在次月 2 日（UTC0）出账前审批通过，晚于这个时点的只对之后的月份生效（列入上线检查项），已封账 / 已冻结的账单不因补配重算；没导入也没配的日子服务费率、税率、返点比例、客情比例一律按 0 计，不提示（D-00-57）。存量账户的消耗首日取真实首次消耗日（UTC0，按历史报表），迁移时写入并冻结（D-00-56）；导入规则的起始日期 = 消耗首日所在月的 1 日，用户另给更早日期的以用户给的为准；导入范围包含已停止投放的账户；按账户逐条校验，失败的不导入并出清单，不整体回滚（2026-10-21 改：原为「初始化导入；系统内不加补录入口」，会议清单 v2 D20、技术答复 T03）（2026-10-22 补：起始日期、消耗首日、范围、逐条校验，闭环清单 A13；阶梯 / 分段截止点原为「首个月末结算前配完」，闭环清单 A14） | 未导入账户：充值写多少到账多少，出账时服务费、税费、服务费税费为 0，返点、客情为 0，页面不提示；客户详情规则表显示「-」；04 客户材料的历史上传文件行（含占位行）多出「规则配置」 | 用户收集 | 技术导入；阶梯 / 分段由用户上线后在页面配 | 用户（技术查询后导出给用户核对） | 上线前导入；阶梯 / 分段须在上线当月内提交、次月 2 日（UTC0）出账前审批通过 | 抽查已导入账户：充值服务费率与导入的规则一致、不为 0（05 §4）；未导入账户按 0 计（G-05-014）；用 06 账户行「无适用规则的日子」（R-06-009）核对还有哪些日子没导入；导入失败清单逐个处理 | D-00-57、D-00-56、R-05-017、R-05-049、R-06-009、R-04-051、R-04-060、R-04-073、R-03-053 | 已定（2026-10-22，闭环清单 A13、A14） |
| S-2 | 存量预付款账户的余额 | 导期初余额：基准日 = 上线月 1 日 00:00（UTC0），和 S-18 共用同一个上线月配置；期初余额 ≤ 0 的账户不建期初桶，余额从 0 起，负数部分出清单，交财务线下追收；期初桶的费率快照按 0；迁移核对完成前，停投开关保持关闭（2026-10-22 定：原为「只导期初余额还是导全部历史充值；费率快照待议」，闭环清单 C01） | 不处理会显示大额欠费并触发停投；期初 ≤ 0 的账户余额显示 0 | 财务 / 商务（暂） | 技术（暂） | 财务（暂） | 上线前（暂） | 抽查余额 = 财务台账；退款试算与手算一致；核对负数清单 | Q-05-01、R-05-001、R-05-005 | 已定（2026-10-22，闭环清单 C01） |
| S-3 | 账户上老「授信额度」有值的账户 | 老额度按上线时刻生效的长期额度导入，之后按 R-05-011 的条件清零（2026-10-22 定：原为「是否导成当前生效额度、预付款有效期怎么设」待定，闭环清单 C02） | 不导的话，靠额度兜底的预付账户可能停投 | 商务 / 财务（暂） | 技术（暂） | 商务（暂） | 上线前（暂） | 抽查授信额度 = 老值 | Q-05-01、R-05-010、R-05-011、D-05-24 | 已定（2026-10-22，闭环清单 C02） |
| S-4 | 旧系统的充值、退款记录 | 过渡期的旧资金记录不导入，交易明细从上线起记；要查旧记录看旧报表（2026-10-22 定：原为「是否导入交易明细」待定，闭环清单 C02） | 交易明细从上线起开始记 | — | — | — | — | — | Q-05-01 | 已定（2026-10-22，闭环清单 C02） |
| S-5 | 线下已有的提成规则 | 上线前逐客户导入（会议清单 v2 D18），规则身份按 D-00-40；上线前导入的提成规则不受 R-05-108「最早当月 1 号」的限制，生效日期 = 上线月 1 日，关联审批单号显示「上线导入」；数据由商务按客户提供两套规则清单（2026-10-22 定：原为「从哪天生效待定」，闭环清单 C03） | 导入前首次配置审批通过前没有提成；导入的规则关联审批单号显示「上线导入」 | 商务 | 技术或业务（暂） | 财务（暂） | 上线前 | 待定 | Q-05-01、R-05-075、R-05-108、D-00-40 | 已定（2026-10-22，闭环清单 C03） |
| S-6 | 账户上删掉的 11 个字段老值（销售、授信额度、苹果返点、客户返点、客情比例、订单号、联系人等） | 保留：库里不迁移、不清空，前端不显示不能改；下游改从 03 / 05 / 客户取 | 编辑弹窗看不到这些字段 | — | 技术（改下游读取来源） | 技术 | 待定 | G-02-016 | D-02-02、D-02-03、R-02-020、R-02-015 | 已定；下游在读清单已核实（技术答复 T20），改读新来源 |
| S-7 | 客户上删掉的 4 个字段（银行账号、所属银行、服务费率、税点） | 前端移除；库表 v67 已删这 4 列，历史值不可恢复，无计算依赖（R-04-001）（2026-10-22 定：原为「库表留不留、下游还读不读待核」，技术答复，闭环清单 E 组） | 不再显示 | — | 技术 | — | —（v67 已删） | — | R-04-001、T-04-001 | 已定（技术答复，闭环清单 E 组） |
| S-8 | 存量客户的客户状态 | 上线时用历史消耗按 D-00-07 的同一规则推导一次：名下任一账户近 30 个完整自然日（UTC0）内有消耗 → 投放中；有过消耗但已连续 30 个完整自然日无消耗 → 停止投放；有账户但从未消耗 → 待投放；没有账户 → 待开户（2026-10-21 改：原为按原「开启投放」字段映射，技术答复现有系统没有该状态机、原字段已删，会议清单 v2 D22） | 客户列表出现新状态 | — | 技术（迁移脚本） | 用户抽查 | 上线时 | G-04-003 | R-04-010、D-04-16、D-00-07 | 已定 |
| S-9 | 存量客户签约主体、币种（自由文本或为空）；后付款客户账期为空 | 签约主体、币种：能明确映射的映射为枚举（如「伙伴云科技」→ 伙伴云，「美元 / USD」→ USD，「RMB / 人民币」→ 人民币），映射不了的置空、原值另存备查（界面不展示）；技术先导出两列去重取值，用户逐项确认映射表。置空的与账期为空的一样：显示「-」，下次编辑必须补齐，补齐不走审批；签约主体本期下游不使用（见 ⑥）（2026-10-21 改：原为「不批量补」，会议清单 v2 D79） | 映射后显示枚举值；没映射的显示「-」、编辑时提示必填；所有页面不显示原自由文本 | 技术导出取值；用户确认映射表 | 技术（迁移脚本）；用户（下次编辑时补齐） | 用户 | 上线前完成清洗（列为上线检查项）；补齐在下次编辑时 | G-04-003、G-04-004、G-04-022 | R-04-011、D-04-07、R-12-030 | 已定；映射表待用户确认 |
| S-10 | 客户名下历史上传的登记表文件 | 保留：预览 / 编辑 / 删除照旧；以后只能绑定在线登记表 | 去掉文件类型、文件大小两列 | — | — | — | — | G-04-031 | R-04-055、R-04-056、D-04-03 | 已定（技术答复，闭环清单 E 组：预览、下载、替换上传、删除沿用现有实现；挂着规则的不能删，R-04-055） |
| S-11 | 老账户的登记表（历史上传文件或没有） | 保留：有文件显示文件名、沿用原预览；没有显示「-」；上线迁移补建的「上线迁移补建（无附件）」行在 02 视同没有登记表（显示「-」，列表不显示 icon），规则配置入口在 04（D-00-57） | 无 | — | — | — | — | G-02-019 | R-02-021、D-02-05 | 已定 |
| S-12 | 老账户投放类型为空 | 不补；下次编辑时必选 | 确认时提示「请选择投放类型」 | — | 用户（下次编辑时） | — | 下次编辑时 | — | R-02-019 | 已定 |
| S-13 | 账户的消耗币种 | 取账户所属账户系统的币种（账户系统币种没有修改入口）；同一客户只有一种消耗币种（D-05-11），同一账户系统同月只有一种币种；02 开户服务端补校验「客户账户系统与本次账户系统一致」（2026-10-21 定，技术答复 T07、T08，会议清单 v2 D88、D106） | 无 | — | 技术 | 技术 | 上线前在生产跑一次检查 | 生产查询：没有同一客户多币种、没有同账户系统同月多币种 | R-05-002、D-05-11、R-05-002 | 已定；生产检查待跑 |
| S-14 | 历史账单、已完成充值（规则改了以后） | 冻结：按发生时规则，不回算；充值计算结果随审批单锁定 | 无 | — | 系统 | — | — | G-03-026 | D-00-12、D-03-08、D-00-58 | 已定 |
| S-15 | 审批流配置（14 种审批类型） | 初始化配置：涉钱的 8 种必须配好（0 节点 = 免审）；存量「账户优化师」节点即「绑定的运营」（D-00-76），保留不清空；存量「账户销售」节点即「绑定的销售」，保留；存量「发起人」节点改为上线前核对，有残留就阻断上线，由管理员重配；迁移生成的规则 1 是 0 节点的，凡「规则 1 为 0 节点、规则 2 起又没覆盖全部角色」的审批类型，列入检查清单，由用户逐个确认；存量规则之间角色重叠的，归原排序最前的那条（2026-10-22 补：①～④，「发起人」原为「上线时清空选值、上线前重配」，闭环清单 B11）；上线前核对所有节点都有值；涉钱 8 类 + 新建客户 + 客户信息变更，只要有节点就至少要有一个指定用户节点（审批配置保存时校验）（2026-10-21 补，会议清单 v2 D29、D117）；已禁用的指定用户不算「指定用户节点」（R-12-012）；渠道对账、渠道付款两类存量配置里的动态节点须清掉重配（R-12-010） | 无 | — | 用户 / 运维 | 用户（看编辑时间不是「—」，并逐类核对没有空节点、涉钱类型不只配动态节点、没有残留「发起人」节点，检查清单里的类型逐个确认） | 上线前 | 同核对方 | D-12-07、D-00-76 | 已定 |
| S-16 | 上线前的历史账单；线下还没结清的后付账单 | 只从上线月出：06 出账单与 S-18 共用同一个上线月起算，上线月之前的月份不补出账单、不导入未结清金额；线下未结清的款见 S-19（2026-10-22 定：原为「补出 / 只从上线月出 / 导入未结清金额」待定，闭环清单 A01） | 上线前月份没有账单，线下欠款系统里看不到 | 用户 / 财务（定上线月，同 S-18） | 技术（上线时配置） | 财务（暂） | 上线前 | 06 没有上线月之前的账单 | Q-06-01、D-10-08 | 已定（2026-10-22，闭环清单 A01）；具体上线月同 S-18 |
| S-17 | 上线前月份的返点 / 客情 | 只从上线月起算：07 计提与 S-18 共用同一个上线月起算，导入的存量规则起始日期早于上线月时，上线月之前的月份也不计提（2026-10-22 定：原为「导入历史已结记录 / 标记线下已结 / 只从上线月起算」待定，闭环清单 A01） | 上线月之前的月份没有返点 / 客情计提 | 用户 / 财务（定上线月，同 S-18） | 技术（上线时配置） | 财务（暂） | 上线前 | 07 没有上线月之前的计提 | Q-07-01、R-07-001、R-07-013、D-10-08 | 已定（2026-10-22，闭环清单 A01）；具体上线月同 S-18 |
| S-18 | 上线前的历史结算期渠道数据 | 只从上线月起：08 第一层只出结算期 ≥ 上线月的行，导入结算期下限 = 上线月，上线月由 06 / 07 / 08 / 10 / 11 共用一个配置（D-10-08；06 出账单见 S-16、07 计提见 S-17，05 期初余额基准日见 S-2）；上线月 = 第一个在系统里付渠道款的结算期（不是系统上线那天所在的月），具体月份上线前定；之前的结算期线下付；兜底：结算期 ≥ 上线月、该账户该月有消耗却没有 06 账户行时，10 按「客户未收完」处理，不判已算完（2026-10-21 改：原为「补导历史 / 初始化为已完成 / 只从上线月起算」待定，会议清单 v2 D60）（2026-10-22 补：06 / 07 共用与兜底，闭环清单 A01） | 上线月之前的结算期在 08 不出行、不能导入、不能付款，10 / 11 也不出这些月份 | 用户 / 财务（定上线月） | 技术（上线时配置） | 财务 | 上线前 | 08 看不到上线月之前的行，导入弹窗选不到更早的结算期 | R-08-002、R-08-031、D-10-08 | 已定；具体上线月待定 |
| S-19 | 上线前线下还没收完 / 付完的款 | 要不要导成收付款单（09 本页实体上线时为空）待财务定；按本行导入的历史收付款单只作记录：确认后不回写来源单据，也不进 10；渠道付款不导入，上线月之前一律线下处理（2026-10-22 补，闭环清单 B09） | 不导：线下未结的款系统里看不到，06 / 07 / 08 历史月份也没有收付款单 | 财务（暂） | 技术（暂） | 财务（暂） | 上线前（暂） | 待定 | Q-09-03 | 导入口径已定（2026-10-22，闭环清单 B09）；是否导入待定 |
| S-20 | 客户销售、账户优化师的历史归属 | 不回填上线前历史（技术答复操作日志能取到大部分，用户定不回填），上线前的日子按上线时的值；上线后按变更生效时间记：客户销售以 04 直接保存时刻或审批通过时刻、账户优化师以 02 编辑保存时刻为准（D-00-72） | 无 | — | 技术（上线起记变更） | — | 上线时 | 月中改销售后，11 该月提成按日拆给前后两人（R-11-003） | D-00-72 | 已定（2026-10-21 用户定不回填，技术答复 T15） |
| S-21 | 存量账户的所属客户 | 账户所属客户唯一来源是账户上已有的所属客户字段；上线前用迁移检查导出取不到所属客户的账户清单，交用户逐个指定；服务端开户加所属客户必填校验（会议清单 v2 D113、技术答复 T05） | 无（补齐前这些账户不归属任何客户，不出现在客户相关页面） | 技术导出清单；用户指定 | 技术 | 用户 | 上线前 | 迁移后复核：没有所属客户为空的账户 | R-02-010、02 §2.4.5 | 已定；清单待生产导出 |
| S-22 | 销售对存量账户的数据授权 | 上线时按客户当前销售给其名下全部账户补授权一次；之后开户时、客户销售变更生效时按 02 规则同步（收回旧销售因销售身份获得的授权，同时是优化师 / 合作者 / 观察者的保留）（会议清单 v2 D23） | 销售能看到自己客户名下的全部账户（含 05 费用管理里的该客户） | — | 技术（上线脚本） | 用户抽查 | 上线时 | 抽查若干客户：当前销售能看到该客户名下全部账户 | R-02-027 | 已定 |
| S-23 | 广告系列的出价策略历史（MAX 识别） | 从上线起记录出价策略变更，上线时按当前策略初始化一版；某天按当天的策略识别 MAX（一天内改过的按当天 UTC0 结束时的策略计整天）；上线前的日子按上线时的策略（会议清单 v2 附 1 B1、技术答复 T14） | 无；上线前月份的 MAX 消耗按上线时的策略算 | — | 技术 | 技术 | 上线时 | 上线后改一个系列的策略：次日起按新策略计，之前的日子不变 | D-00-15、R-07-007 | 已定 |
| S-24 | 客户上的「运营」字段存量值 | 字段停用：04 列表、添加 / 编辑、详情、审批内容区不再显示；存量值不迁移；「绑定的运营」改按本单账户的优化师解析（D-00-76） | 客户管理里不再有「运营」 | — | 技术 | — | 上线时 | 04 各处不出现「运营」；审批「绑定的运营」解析到账户优化师 | D-00-76 | 已定 |
| S-25 | 存量里已经重名的客户（同租户公司名称相同） | 不强制改名；只有公司名称被修改时才按 R-04-068 校验全租户不重名（会议清单 v2 D26-名称占用） | 无 | — | — | — | 上线时 | 抽查：存量重名客户编辑其他字段可正常保存 | R-04-068 | 已定 |
| S-26 | 各渠道（账户系统）渠道付款的收款主体选项 | 上线迁移给每个账户系统预置一项收款主体 = 渠道名称；之后在 08 发起渠道付款时手填的新值自动追加（会议清单 v2 D14、技术答复 T06） | 08 发起渠道付款时收款主体下拉有默认一项 | — | 技术（迁移脚本） | — | 上线时 | 抽查每个账户系统的收款主体选项含渠道名称 | R-08-047 | 已定 |

**还没说清、要问你或技术的点**

① S-1 导入的规则挂在哪：已定（2026-10-21，会议清单 v2 D20、技术答复 T03）：不补建在线登记表，挂在该账户在 04 客户材料里的历史上传文件行；无附件的账户由迁移补一行占位「上线迁移补建（无附件）」；该行提供「规则配置」入口（D-00-57）。
② S-1 导入规则的起始日期、消耗首日：已定（2026-10-22，闭环清单 A13），见 S-1。
③ S-1 范围与失败处理：已定（2026-10-22，闭环清单 A13）：含已停止投放的账户，按账户逐条校验，失败的不导入并出清单，不整体回滚，见 S-1。
④ S-2～S-5、S-16、S-17：已定（2026-10-22，闭环清单 A01、C01～C03）：06 出账单、07 计提、08、10、11 从同一个上线月起算，共用 S-18 的上线月配置，具体月份上线前定；S-2 期初余额基准日 = 上线月 1 日、快照按 0；S-3～S-5 见各行；迁移核对完成前停投开关保持关闭（S-2）。S-19 是否导入仍待财务定。
⑤ S-6 / S-7 口径：已定（技术答复，闭环清单 E 组）：S-6 账户上的老字段保留、不迁移不清空，下游在读清单已核实、改读新来源；S-7 客户上的 4 列库表 v67 已删，历史值不可恢复，无计算依赖（R-04-001）。
⑥ S-9 空值下游：已定（2026-10-21，会议清单 v2 D115）：签约主体本期只做客户档案（列表、详情、审批内容），05～11 不读取，结算单、收款单不带我方抬头，为空不拦截任何财务操作。原「客户币种为空」一问已过时：06 账单币种取账户消耗币种、10 不读客户币种，05 结算币种无默认、必须手选（R-05-024、G-05-027）。

## 8 交付与修订记录

<!-- 只追加。交付时写一行；交付后在本版修订也写一行。 -->

| 日期 | 类型 | 对象 | 内容 | 涉及页面 |
| --- | --- | --- | --- | --- |
