# 客户管理 PRD

| 项 | 内容 |
| --- | --- |
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 04-客户管理 |
| 涉及功能 | [客户管理](../../../feature/客户管理/README.md) |
| 编制日期 | 2026-10-19（2026-10-21 按会议清单 v2 回写；2026-10-22 按闭环问题清单回写） |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手（本文件可直接整份投喂给 AI 作为实现依据） |
| 关联文档 | 本目录 spec.yaml、mocks/；版本 [index.md](../index.md)；原型 `html/客户管理.html`、`html/客户详情.html`、`html/添加客户.html`、`html/编辑客户.html`、`html/客户材料.html`、`html/审批详情-客户管理.html` |

## 0 前置说明

- 本页是流程包，覆盖版本记录第 7 项（客户管理）、第 8 项（客户详情）、第 9 项（添加客户）、第 10 项（编辑客户）、第 11 项（客户材料，版本级约定并入本包）、第 12 项（客户管理审批详情，只写「审批内容」区）。合并理由：六个页面共用同一个「客户」实体和三类客户审批，拆开会把状态和审批结果处理写散。
- 本页**主管「客户」实体和客户状态机**。02-账户管理只触发「待开户 → 待投放」，状态清单以本页 2.1 为准。
- 引用 01-客户登记：客户材料里的「绑定登记表」触发登记表「待关联 → 待开户」，guard 由本页 R-04-058 定义；绑定行的详情内容复用 R-01-010。
- 引用 12-审批配置与审批中心：审批单状态机、审批人解析与会签、撤回、作废、通知、审批详情通用框架全部按 12，本页只写三类客户审批的提交参数、审批内容区和结束后的客户数据处理。
- 版本级口径：计费模式次月生效（D-00-73）、客户状态按消耗判定（D-00-07）、「运营」= 账户优化师（D-00-76）、客户数据范围隔离（D-00-77）、审批变更高亮基准（D-00-75）、撤回与执行失败（D-00-79）、存量规则挂历史上传文件行（D-00-57）。本页只写这些口径在客户管理里的落法，不复述。
- 沿用不动：客户列表的搜索与搜索历史、「显示合同即将到期客户」、客户材料的「合同」标签、销售下拉组件。这些由技术按现有实现复用。
- 不做：客户列表行操作里的「规则配置」入口（原型残留，D-01-03）；规则配置入口放在客户材料的登记表行（R-04-060）。

## 1 整体概述

### 1.1 背景与目标

现状：客户只有一个「开启投放」字段（现有系统已无对应状态机），商务看不出客户卡在哪一步；后付款客户、付款主体改动没有任何审批；登记表只能以文件上传方式挂在客户下面，和在线登记表接不上。

目标：
- 客户状态分成 待开户 / 待投放 / 投放中 / 停止投放，投放中与停止投放按消耗自动判定，商务一眼能看出客户卡在哪一步。
- 新建后付款客户、预付改后付、付款主体变更都要走审批，审批通过前不生效；计费模式变更从次月 1 日起生效。
- 客户材料里直接绑定在线登记表，绑定后登记表自动进入「待开户」，后面在账户管理开户；存量账户在历史上传文件行配置规则。

可证伪的判定：建一个预付款客户 → 客户材料绑定一张待关联登记表（登记表变待开户）→ 账户管理用这张登记表开户（客户变待投放）→ 账户产生消耗后次日（UTC0）客户变投放中；把客户改成后付款提交审批，审批通过前列表仍显示预付款，通过后显示「预付款（次月 1 日起改为后付款）」，次月 1 日（UTC0）起才是后付款。

### 1.2 本页范围

- ✅ 包含：
  - 客户实体字段调整（含去掉「运营」字段）、客户状态机定义、存量兼容；客户「销售」变更记录（R-04-064，无展示界面）。
  - 客户列表、添加客户、编辑客户（独立页面）、付款主体弹窗；计费模式待生效的展示与编辑口径。
  - 三类客户审批（新建客户 / 客户信息变更 / 付款主体变更）的提交、审批内容区、结束后处理。
  - 「已提交审批」tab。
  - 客户详情页。
  - 客户材料的客户登记表标签（绑定在线登记表、历史文件兼容、绑定行与历史文件行的「规则配置」入口、迁移占位行）。
  - 两个现有权限点的功能边界与客户数据范围。
- ❌ 不包含：
  - 客户列表行操作里的「规则配置」入口（残留，D-01-03）；规则配置页本身与规则配置审批内容（归 03，本页只放客户材料里的入口）。
  - 审批通用能力（归 12）；添加账户动作本身、账户优化师字段与销售的账户数据授权规则（归 02）。
  - 计费模式切换后的余额抵扣、上期预付欠费（D-00-73，归 05、06）。
  - 解绑登记表 / 账户、客户状态回到待开户或待投放（本期没有，D-01-16、D-04-17）；删除客户（原型没有）。
  - 内部编辑登记表同步到客户（不同步，D-01-06）。
  - 客户材料「合同」标签（本期不改）。
  - 新增权限点、把权限点分配给角色（版本级约定：只出权限点，不预设角色）。

### 1.3 角色与权限

| 角色 | 能做什么 | 不能做什么 | 数据范围 | 权限来源 |
| --- | --- | --- | --- | --- |
| 持「客户管理-只读」的用户 | 看客户列表、客户详情、客户材料（列表、预览、下载、登记表详情）、已提交审批 tab；只读看三类客户审批详情；撤回自己提交的审批中单 | 添加、编辑、提交付款主体、客户材料增删改与规则配置 | R-04-061 | 现有权限点（R-04-062） |
| 持「客户管理-读写」的用户 | 只读能做的全部；添加客户、编辑客户、提交付款主体变更、客户材料增删改、规则配置入口 | 撤回他人的单 | R-04-061 | 现有权限点（R-04-063） |
| sys 账号 | 同其所持权限点 | 同上 | 全部客户 | D-00-77 |
| 审批人 | 在审批详情 / 审批中心审批 | — | 审批单快照 | 12（R-12-023） |
| 持「审批配置」的用户 | 作废审批中的单（12 定义） | — | — | D-00-79③ |

客户数据按客户范围隔离（D-00-77，R-04-061），不再沿用 D-12-26「现有权限不隔离」的前提；本页不新增权限点。撤回只看申请人本人与单据状态，不看本页权限点（D-00-79②）。

### 1.4 术语定义

| 术语 | 释义 |
| --- | --- |
| 当前生效值 | 客户此刻真正在用的数据。审批中的修改、待生效的计费模式都不算，生效后才变成生效值。 |
| 待生效计费模式 | 已确定、但要到次月 1 日（UTC0）才生效的计费模式变更（R-04-066）。 |
| 销售 | 客户上的负责人字段，原来叫「商务」，是同一个字段（D-04-10）。12 审批流的「绑定的销售」（D-00-50）解析的就是它。 |
| 运营 | 即账户上的「优化师」（02 字段），客户上不再有「运营」字段（D-00-76）。12 的「绑定的运营」解析本单涉及账户的优化师。 |
| 数据范围 | 非 sys 用户能看、能改的客户：自己是该客户的销售，或是其名下任一账户的优化师（D-00-77）。 |
| 绑定登记表 | 在客户材料里把一张 01 的在线登记表挂到客户下面。只能绑定，不能解绑。 |
| 历史上传文件 | v2.1 之前以文件上传方式挂在客户下的登记表，保留，照旧可以预览、编辑、删除；有对应账户的可配规则（D-00-57）。 |
| 迁移占位行 | 上线迁移给没有历史上传文件的存量账户补的一行「上线迁移补建（无附件）」，只用来挂规则（R-04-073）。 |

### 1.5 核心流程

| 步骤 | 操作者 | 系统行为 | 产物 / 状态 |
| --- | --- | --- | --- |
| 1a | 商务（读写） | 添加客户，预付款 → 点添加 | 客户【待开户】 |
| 1b | 商务（读写） | 添加客户，后付款 → 提交审批 | 新建客户审批单；通过后客户【待开户】，驳回 / 撤回不生成客户 |
| 2 | 商务（读写） | 客户材料 → 添加登记表，选可绑定的待关联登记表（R-04-057） | 登记表【待关联 → 待开户】（01） |
| 3 | 商务 | 在 02-账户管理添加账户，选该客户和登记表 | 登记表【已开户】（01）；客户【待开户 → 待投放】 |
| 4 | 系统 | 每天 UTC0 日结后按名下账户消耗判定（R-04-008） | 客户【投放中】/【停止投放】 |
| 支线 | 商务（读写） | 编辑客户：预付改后付 → 提交审批；其他改动直接保存 | 客户信息变更审批单；通过后其他字段立即生效，计费模式次月 1 日生效（R-04-066） |
| 支线 | 商务（读写） | 付款主体弹窗修改 → 提交审批 | 付款主体变更审批单；通过后整体替换 |

## 2 详细需求

### 2.1 客户实体与客户状态（定义）

#### 2.1.1 功能描述

定义客户字段的变化和客户状态机。02-账户管理、12-审批配置与审批中心引用这里的字段和状态，不另写。

#### 2.1.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 客户ID | customer_id | string | 是 | 系统生成 | — | 沿用现有；01 登记表列表的「客户ID」 |
| 计费模式 | billing_mode | enum | 是 | 预付款 / 后付款 | 沿用现有 | 切换规则见 R-04-021、R-04-023、R-04-024；变更次月生效 R-04-066 |
| 待生效计费模式 | pending_billing_mode | enum + date | 否 | 预付款 / 后付款 + 生效日 | — | **新增**，R-04-066、R-04-067 |
| 账期 | payment_term_days | int（天） | 后付款时是 | 正整数 | — | R-04-003 |
| 公司名称 | company_name | string | 是 | 长度沿用现有 | — | 重名规则 R-04-068 |
| 公司别名 | company_alias | string | 否 | 沿用现有 | — | — |
| 伙伴云签约主体 | our_contract_entity | enum | 是 | 伙伴云 / clic | 无 | **新增**，R-04-002；本期只做客户档案，05～11 不读取（R-04-011）；与 01 登记表的「签约主体名称」（自由文本）不是同一字段 |
| 币种 | currency | enum | 是 | 人民币 / USD / USDT | 无 | **新增**，R-04-002 |
| 销售 | sales_user_id | 关联用户 | 否 | 启用用户，下拉可搜索 | — | 原「商务」，R-04-004；已禁用的显示 R-04-069；变更记录 R-04-064 |
| 合同起始时间 | contract_start | date | 否 | — | — | 表单里叫「起始时间」，沿用现有 |
| 合同终止时间 | contract_end | date | 否 | — | — | 表单里叫「终止时间」，先后校验沿用现有 |
| 客户来源 | source | string | 否 | 不限格式 | — | **新增**，列表不展示 |
| 备注 | remark | text | 否 | 沿用现有 | — | — |
| 付款主体 | payers | 列表（string） | 否 | 保持录入顺序，顺序仅影响展示 | — | **新增**，只能走审批修改（2.5） |
| 客户状态 | status | enum | 是 | 待开户 / 待投放 / 投放中 / 停止投放 | 待开户 | **新增**，取代原「开启投放」，见 2.1.4 |
| 创建时间 | created_at | datetime（Asia/Shanghai，秒） | 是 | 系统生成 | — | 后付款新建客户为审批通过时刻 |

删除字段：银行账号、所属银行、服务费率、税点（库表 v67 已删这 4 列）；运营（D-00-76，R-04-001）。

#### 2.1.3 业务规则

- **R-04-001** 客户基础信息新增 伙伴云签约主体、币种、账期、客户来源 4 个字段；删除 银行账号、所属银行、服务费率、税点 4 个字段：添加、编辑、列表、详情、审批详情都不再展示，也不能录入（库表 v67 已删这 4 列，历史值不可恢复，无计算依赖）。新增「客户状态」，取代原「开启投放」字段。客户上的「运营」字段停用：列表、添加 / 编辑、详情、审批内容区都不再有，存量值不迁移（D-00-76，S-24）；运营即名下账户的优化师（02）。
- **R-04-002** 伙伴云签约主体为必填单选：伙伴云 / clic（D-04-08）；币种为必填单选：人民币 / USD / USDT（版本级约定）。两者都没有默认值。
- **R-04-003** 账期在计费模式为后付款（含待生效的后付款，R-04-066）时显示且必填，只能填正整数，单位「天」。表单里计费模式切到预付款时账期输入框隐藏；预付改后付的账期随审批通过立即保存，计费模式生效前客户仍为预付款、不使用账期（R-04-036、D-04-33）；后付改预付的变更生效时账期清空，生效前保留（D-04-15）。
- **R-04-004** 原「商务」字段统一改叫「销售」，是同一个字段：客户列表列名、添加 / 编辑表单、客户详情、审批详情都写「销售」（D-04-10）。12 审批流动态选项「绑定的销售」解析客户的销售字段（D-00-50）；「绑定的运营」解析本单涉及账户的优化师（D-00-76），本页传哪些账户见 R-04-034。
- **R-04-005** 客户状态只有 待开户 / 待投放 / 投放中 / 停止投放 四个，只由系统按 2.1.4 流转，所有页面都不能手动改。客户列表展示该字段，添加、编辑客户页面不展示。
- **R-04-006** 客户在两种情况下产生，初始状态都是待开户：预付款添加成功（R-04-019）；后付款「新建客户」审批已通过（R-04-035）。新建客户审批中的客户视为不存在：不出现在客户列表、不能在 02 添加账户里被选为所属客户、不能被绑定登记表（D-04-12）；但它的公司名称算占用（R-04-068）。
- **R-04-007** 02-账户管理添加账户成功、且所属客户状态为待开户时，客户状态变为待投放，与 02 的建账户动作同成同败。客户已是待投放 / 投放中 / 停止投放时再添加账户，状态不变。
- **R-04-008** 待投放 → 投放中、投放中 ⇄ 停止投放由系统按名下账户的消耗判定（D-00-07）：每天 UTC0 日结后判定一次，用判定时已同步的消耗数据，看最近 30 个完整自然日（UTC0，截至前一日）。窗口内名下任一账户有某日消耗 > 0 → 投放中（待投放、停止投放都转入，投放中保持）；当前为投放中、且窗口内名下全部账户每天消耗都为 0（即连续 30 个完整自然日无消耗）→ 停止投放；待投放且窗口内无消耗 → 保持待投放。05 余额不足停投（R-05-014）、账户暂停投放都不直接改客户状态，只按本条的消耗结果变化。
- **R-04-009** 本期客户状态不回到待开户或待投放：没有解绑账户的操作；名下账户增减、停投，都只按 R-04-008 的消耗判定，不另改状态（D-04-17）。
- **R-04-010** 上线时存量客户的客户状态按历史消耗推导一次，取代原「开启投放」映射（D-00-07，S-8）：名下没有账户 → 待开户；有账户、上线前最近 30 个完整自然日（UTC0）内有消耗 → 投放中；有账户、曾有过消耗但这 30 天都无消耗 → 停止投放；有账户、从没有过消耗 → 待投放。上线后按 R-04-008 每日判定（D-04-16）。
- **R-04-011** 存量客户的伙伴云签约主体、币种原为自由文本：上线前能明确映射成枚举的映射为枚举，映射不了的置空，原值另存备查、界面不展示（映射表由技术导出两列去重取值、用户逐项确认，S-9）。所有页面（列表、详情、编辑、审批详情）一律按枚举显示，没有枚举值显示「-」，不显示原文；清洗在上线前完成，不设过渡态。后付款存量客户的账期为空时同样显示「-」。下次编辑客户时，这些必填项为空的必须补齐才能保存或提交；只补齐这些字段、计费模式不是预付改后付时，直接保存生效、不走审批（D-04-07、D-04-30）。伙伴云签约主体本期只做客户档案，05～11 不读取，为空不拦截任何财务操作（D-04-30）。
- **R-04-064** 客户「销售」每次变化都记录一条：变更前的值、变更后的值、生效时间（销售改为空或从空改为有值也算变化）。生效时间取销售真正生效的时刻：①新建客户以客户生效时刻记初始值（变更前为空）：预付款为添加成功时刻（R-04-019），后付款为新建客户审批通过、客户创建的时刻（R-04-035）；②编辑客户直接保存（R-04-024）且改了销售的，以保存成功时刻为准；③客户信息变更审批（R-04-023）里改了销售的，以审批通过、新信息生效的时刻为准（R-04-036）。审批中的修改不算变更（D-00-09），审批被驳回 / 撤回、保存失败、销售没变（含已禁用销售原样保留，R-04-069）时都不记录。变更当天（UTC0）起归新销售；上线前不回填历史，上线前的日子一律按上线时的销售（D-00-72）。记录供 11 按业务日取当日销售（R-11-003），本页不新增展示界面；同一生效时刻按 R-04-072 / R-02-027 同步销售的账户数据授权。
- **R-04-069** 客户的销售是已禁用账号时，列表、详情、审批内容区、编辑页下拉回显都显示「姓名（已禁用）」，不显示用户 ID；编辑保存时原值原样保留，不算一次销售变更；用户主动改选时候选只有启用用户，改掉以后不能再选回这个已禁用的人（D-00-83、D-04-29）。「绑定的销售」解析到已禁用账号时按 12 解析为空、该节点跳过（R-12-016）；审批详情里的显示按 R-12-049。
- **R-04-072** 客户销售变更生效时（生效时刻同 R-04-064 ②③），同步销售对该客户名下账户的数据授权：新销售获得名下全部账户的数据权限，旧销售因「客户销售」身份获得的授权收回（他同时是这些账户的优化师 / 合作者 / 观察者的保留）。授权规则与上线补授权（S-22）按 R-02-027，本页只提供触发时点；授权失败不影响销售变更本身，由技术沿用现有重试方案补齐。

#### 2.1.4 状态与流转

本页**定义**「客户」状态机。状态清单：待开户 / 待投放 / 投放中 / 停止投放。初始状态：待开户。

| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
| --- | --- | --- | --- | --- |
| （新客户） | 预付款添加成功 | 内部用户（读写） | 待开户 | R-04-018、R-04-019 |
| （新客户） | 新建客户审批已通过 | 系统（12 结束回调） | 待开户 | R-04-035 |
| 待开户 | 添加账户，所属客户为本客户 | 内部用户（在 02-账户管理） | 待投放 | R-04-007：与 02 建账户同成同败 |
| 待投放 | 最近 30 个完整自然日内名下任一账户有消耗 > 0 | 系统（每日 UTC0 日结后判定） | 投放中 | R-04-008 |
| 投放中 | 名下全部账户连续 30 个完整自然日（UTC0）消耗都为 0 | 系统（每日 UTC0 日结后判定） | 停止投放 | R-04-008 |
| 停止投放 | 最近 30 个完整自然日内名下任一账户有消耗 > 0 | 系统（每日 UTC0 日结后判定） | 投放中 | R-04-008 |

逆向操作：本期没有解绑账户、没有回到待开户 / 待投放（R-04-009）；没有删除客户。

#### 2.1.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 02 建账户失败 | 账户没建成 | 客户状态不变（同成同败） | 02 的失败提示 |
| 已是投放中的客户再加账户 | — | 状态不变 | 仍为投放中 |
| 账户被 05 停投 | 当天之后没有消耗 | 不直接改客户状态；连续 30 天无消耗后按 R-04-008 变停止投放 | 停投后 30 天内仍为投放中 |
| 消耗数据晚到 | 判定时某日消耗还没同步 | 下一次判定按最新数据看同一个 30 天窗口 | 状态最多晚一天变化 |
| 存量客户必填字段为空 | 打开编辑 | 回显为空 | 保存时对应字段提示必填（R-04-011） |
| 存量签约主体 / 币种原值映射不了 | 上线清洗 | 置空，原值另存 | 显示「-」（R-04-011） |
| 销售账号已禁用 | 打开列表 / 编辑 | 保留原值 | 「姓名（已禁用）」（R-04-069） |

#### 2.1.6 验收标准

- **G-04-001** 前置：读写用户；客户「橙子出行科技有限公司」不存在。操作：添加客户，计费模式预付款、伙伴云签约主体 伙伴云、币种 人民币，销售选自己，点添加。期望：提示「添加成功」；列表出现该客户，客户状态待开户；列表没有账期、客户来源、运营列。
- **G-04-002** 前置：客户「橙子出行」待开户；登记表「橙子出行 开户登记」「橙子出行 二期登记」都已关联该客户、状态待开户。操作：在 02 添加账户，所属客户选「橙子出行」、登记表选第一张，添加成功；再用第二张登记表给它加第二个账户。期望：第一次后客户状态待投放；第二次后仍是待投放。
- **G-04-003** 前置：上线日 2026-11-01；存量客户 A 名下账户 2026-10-20（UTC0）有消耗，签约主体原值「伙伴云科技」、币种原值「美元」，映射表把两者分别映射为 伙伴云、USD；B 名下账户 2026-08 有过消耗、2026-10-02～2026-10-31 每天都为 0，签约主体原值「某某主体」不在映射表；C 有 1 个账户、从没有过消耗；D 没有账户，签约主体、币种原值为空。操作：上线后打开客户列表和 B 的编辑页。期望：A 投放中、B 停止投放、C 待投放、D 待开户；A 显示 伙伴云、USD；B 的签约主体、C 和 D 的签约主体与币种都显示「-」，列表、编辑页都不出现「某某主体」原文。 <!-- alias-ok -->
- **G-04-004** 前置：存量预付款客户 D 的伙伴云签约主体、币种为空。操作：编辑 D，只改备注点确定；再补选 clic、USD 点确定。期望：第一次伙伴云签约主体、币种下方提示必填，不保存；第二次直接保存，提示「保存成功」，不生成审批单。
- **G-04-034** 前置：上线后添加的预付款客户 A、B，销售都是张三；客户信息变更审批流 节点1 指定用户周婷。操作：①2026-10-12 编辑 A，计费模式改后付款、账期 30、销售改李四，提交审批并确定；2026-10-15（UTC0）审批通过。②2026-10-15（UTC0）编辑 B，计费模式不变、只把销售改为李四，点确定。期望：A 审批中期间查不到销售变更记录；通过后记一条：变更前张三、变更后李四、生效时间为审批通过、新信息生效的时刻；B 记一条张三 → 李四，生效时间为保存成功时刻（技术查库核验）；11-提成中心里 A、B 的 2026-10-14 及以前归张三、2026-10-15 起归李四（R-11-003）；李四能在 02 看到 A、B 名下全部账户，张三（不是这些账户的优化师 / 合作者 / 观察者）看不到（R-04-072）。
- **G-04-035** 前置：客户 E 投放中，名下账户 E1、E2 最后一次消耗都在 2026-09-10（UTC0）；E1 在 2026-09-11 因余额不足被 05 停投；2026-10-15 E2 又有消耗。操作：分别查看 2026-09-12、2026-10-10、2026-10-11、2026-10-16 各日 UTC0 日结判定后的客户状态。期望：2026-09-12、2026-10-10 仍为投放中（05 停投不改客户状态；10-10 的窗口 09-10～10-09 含 09-10 的消耗）；2026-10-11 变为停止投放（窗口 09-11～10-10 全为 0）；2026-10-16 回到投放中。
- **G-04-036** 前置：客户 F 待投放，名下 1 个账户从没有过消耗；该账户 2026-10-12（UTC0）首次消耗 120.00。操作：2026-10-12 白天、2026-10-13 日结判定后分别查看客户列表，并把鼠标放到「客户状态」列头。期望：2026-10-12 白天 F 仍是待投放；2026-10-13 判定后变投放中；列头悬浮提示「投放中：近 30 天有消耗；停止投放：已连续 30 天无消耗」。
- **G-04-039** 前置：客户 A 的销售张三账号已禁用。操作：打开列表与客户详情；编辑 A 只改备注点确定；再打开编辑页销售下拉；改选李四保存后再次打开下拉。期望：列表、详情、编辑页回显「张三（已禁用）」，不显示用户 ID；第一次保存后销售仍是张三，没有新增销售变更记录（技术查库）；下拉候选里没有张三；改为李四后记一条变更记录，下拉里仍选不到张三。

### 2.2 客户列表

#### 2.2.1 功能描述

导航「客户管理」进入，顶部「客户信息 / 已提交审批」两个切换（已提交审批见 2.8）。本次改的是列表字段、行操作和数据范围。

#### 2.2.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 公司名称 | company_name | string | 是 | 过长悬浮展示 | — | 旁边提醒 icon 见 R-04-015 |
| 伙伴云签约主体 | our_contract_entity | enum | 是 | 伙伴云 / clic | — | **新增列**，在所属账户系统左侧 |
| 所属账户系统 | — | 列表 | 否 | 沿用现有 | — | — |
| 币种 | currency | enum | 是 | 人民币 / USD / USDT | — | **新增列**，在所属账户系统右侧 |
| 计费模式 | billing_mode | enum | 是 | 预付款 / 后付款 | — | 有待生效变更时按 R-04-067 |
| 客户别名 | company_alias | string | 否 | — | — | 沿用 |
| 销售 | sales_user_id | 关联用户 | 否 | — | — | R-04-004、R-04-069 |
| 账户列表 | — | 列表 | 否 | 沿用现有 | — | — |
| 客户状态 | status | enum | 是 | 见 2.1.4 | — | **新增列**，取代原开启投放；列头提示 R-04-065 |
| 合同起始时间 / 合同终止时间 | contract_start / contract_end | date | 否 | yyyy-mm-dd | — | 标红规则 R-04-013 |
| 备注 | remark | text | 否 | — | — | 沿用 |

#### 2.2.3 业务规则

- **R-04-012** 客户管理页顶部有「客户信息 / 已提交审批」两个切换，默认客户信息。客户信息页的搜索框（含搜索历史）、「显示合同即将到期客户」勾选、「添加客户」按钮沿用现有。列表只列当前用户数据范围内的客户（R-04-061）。
- **R-04-013** 列表字段依次为：公司名称、伙伴云签约主体、所属账户系统、币种、计费模式、客户别名、销售、账户列表、客户状态、合同起始时间、合同终止时间、备注、操作（没有「运营」列，D-00-76）。公司名称列和操作列固定；账期、客户来源不在列表展示；空值显示「-」。合同终止时间只在命中「即将到期」（与「显示合同即将到期客户」勾选同一口径，天数沿用现有）或已过期时标红，其余正常显示；公司名称后不加「（点击查看详情）」，详情走行操作（D-04-32）。
- **R-04-014** 行操作为 详情、客户材料、编辑、付款主体，所有客户状态都显示：详情 = 新页打开客户详情（2.9）；客户材料 = 进入客户材料页（2.10），取代原来的「合同」「客户登记表」两个入口；编辑 = 编辑客户（2.4）；付款主体 = 打开付款主体弹窗（2.5）。客户列表不放「规则配置」入口（D-01-03），规则配置入口在客户材料的登记表行（R-04-060）。
- **R-04-015** 公司名称旁的提醒 icon 沿用 v2.0：没有任何合同时提示「未上传合同」；客户登记表数量（历史上传文件 + 绑定的在线登记表合计，迁移占位行不计，R-04-073）为 0 时提示「未上传客户登记表」。
- **R-04-016** 排序沿用现有；分页 10 / 50 / 100 / 300 条每页，展示总条数。
- **R-04-065** 「客户状态」列头带问号，悬浮提示「投放中：近 30 天有消耗；停止投放：已连续 30 天无消耗」（R-04-008）。

#### 2.2.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 没有客户 / 搜索无结果 | 列表为空 | — | 空态「暂无数据」 |
| 列表加载失败 | 请求失败 | 不清空搜索条件 | 失败提示，可重试 |
| 只读用户 | — | 写操作按钮不渲染 | 只有详情、客户材料（R-04-062） |
| 新建客户审批中 | — | 不进列表（R-04-006） | 在已提交审批里能看到这张单 |
| 客户不在本人数据范围 | — | 不进列表（R-04-061） | 看不到该客户 |

#### 2.2.6 验收标准

- **G-04-005** 前置：只读用户，是客户 A、B 的销售；A 有 1 个合同、0 个历史上传登记表、1 个绑定登记表，合同终止时间 2027-09-30（不在即将到期范围）；B 的合同终止时间 2026-02-28（已过期）。操作：打开客户列表。期望：列按 R-04-013 排列，没有运营列；行操作只有详情、客户材料；没有添加客户按钮；A 的公司名称旁既不提示「未上传客户登记表」，也不提示「未上传合同」；A 的合同终止时间正常显示，B 的标红；公司名称后没有「（点击查看详情）」。

<!-- mock: mocks/2.2-客户列表/01-默认态.html | 客户列表（默认态，新增列与行操作） -->

### 2.3 添加客户

#### 2.3.1 功能描述

列表「添加客户」进入独立页面，面包屑「客户管理/添加客户」（D-04-27）。预付款直接添加；后付款要先审批。

#### 2.3.2 核心字段

字段及类型同 2.1.2，表单顺序见 R-04-017。

#### 2.3.3 业务规则

- **R-04-017** 添加客户为独立页面，面包屑「客户管理/添加客户」；点「返回」回到客户列表，不保存已填内容，不弹离开确认（D-04-27）。字段顺序：计费模式、账期（仅后付款）、公司名称、公司别名、伙伴云签约主体、币种、销售、起始时间、终止时间、客户来源、备注；按钮 返回 / 添加（后付款时为「提交审批」）。
- **R-04-018** 点添加或提交审批时校验：计费模式、公司名称、伙伴云签约主体、币种必填；后付款时账期必填且为正整数（R-04-003）；公司名称不能重名（R-04-068）；其余字段的长度和格式沿用现有。不通过就不提交，在对应字段下方提示。
- **R-04-019** 计费模式为预付款时按钮为「添加」，校验通过后直接创建客户（状态待开户），弱提示「添加成功」，返回客户列表，新客户出现在列表里（不在本人数据范围的除外，R-04-061）。
- **R-04-020** 计费模式为后付款时按钮变为「提交审批」，校验通过后二次确认：「后付款客户需进行审批，是否提交审批单？」+ 备注（多行输入框，选填）+ 取消 / 确定。确定后提交「客户管理—新建客户」审批（R-04-033），按 12 返回的审批单状态弱提示（R-12-018：审批中为「已提交审批」，免审通过为「提交成功，无需审批，已生效」），返回客户列表；审批中不创建客户（R-04-006）。
- **R-04-021** 在添加页切换计费模式时，按钮文字在「添加」和「提交审批」之间实时切换，账期按 R-04-003 显隐。新客户的计费模式在客户创建时即生效，不适用 R-04-066 的次月生效。
- **R-04-068** 公司名称重名校验（D-04-25）：添加客户（添加、提交审批）和编辑客户（确定、提交审批）时，公司名称为新填或与当前生效值不同才校验；与同租户全部客户的公司名称、以及审批中的新建客户单里的公司名称按原文全等比较（区分大小写，不去掉空格），相同即重名，不提交，公司名称下方提示「公司名称已存在」；服务端同样校验。同一公司在不同账户系统开两个客户时，公司名称须加后缀区分。存量客户里已经重名的不强制改名，公司名称不改时照常保存。客户信息变更里改的公司名称在审批中不算占用，最后通过时若已重名按 R-04-071 处理。

#### 2.3.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 必填为空 / 账期格式错 | 点添加 / 提交审批 | 不提交 | 字段下方提示 |
| 公司名称重名（含审批中的新建客户） | 点添加 / 提交审批 | 不提交（R-04-068） | 「公司名称已存在」 |
| 二次确认点取消 | — | 不提交，留在添加页 | 已填内容保留 |
| 点返回 | — | 不保存，不弹确认 | 回到客户列表 |
| 连点添加或确定 | 多次请求 | 只生成 1 个客户 / 1 张审批单，由技术沿用现有防重复方案 | 一条成功提示 |
| 提交失败（网络 / 服务异常） | 接口报错 | 不生成客户、不生成审批单 | 「操作失败，请重试」，已填内容保留 |
| 销售没选本人、本人也不是 sys | 预付款添加成功 | 客户不在本人数据范围（新客户还没有账户） | 提示「添加成功」，列表里看不到该客户 |

#### 2.3.6 验收标准

- **G-04-006** 前置：读写用户打开添加客户。操作：选后付款不填账期点提交审批；账期分别填 0、1.5、30；再切回预付款；最后点返回。期望：页面面包屑为「客户管理/添加客户」；不填时提示必填；0、1.5 提示格式错误；30 通过；切回预付款后账期输入框消失，按钮文字变回「添加」；点返回直接回到客户列表、不弹确认、不生成客户。
- **G-04-007** 前置：新建客户审批流为 节点1 绑定的销售、节点2 指定用户周婷；读写用户。操作：添加客户选后付款、账期 30、销售选陈思远，点提交审批，确认框备注填「年框客户」并确定。期望：确认框文案为「后付款客户需进行审批，是否提交审批单？」；提示「已提交审批」；客户列表没有这个客户；已提交审批出现一条 新建客户·审批中；审批详情节点 1 为陈思远、节点 2 为周婷，发起记录备注「年框客户」。
- **G-04-008** 前置：①同 G-04-007，但销售不选；②新建客户审批流为 0 节点。操作：分别提交审批。期望：①节点 1 显示「已跳过（未找到审批人）」，审批从节点 2 周婷开始，提示「已提交审批」；②提交即通过，提示「提交成功，无需审批，已生效」，客户马上出现在列表（销售为本人时）、状态待开户，已提交审批里这张单为已通过。
- **G-04-010** 前置：新建客户「云帆教育」审批中。操作：在 02 添加账户的所属客户下拉里搜「云帆」。期望：搜不到。
- **G-04-038** 前置：已有客户「星海网络科技有限公司」「Starfish Media」；审批中的新建客户单公司名称「云帆教育科技（杭州）有限公司」；存量客户 X、Y 都叫「伙伴云」（不同账户系统）。操作：①添加预付款客户「星海网络科技有限公司」；②添加「starfish media」；③添加「云帆教育科技（杭州）有限公司」；④编辑 X 只改备注点确定；⑤编辑 X 把公司名称改为「星海网络科技有限公司」点确定。期望：①③⑤公司名称下方提示「公司名称已存在」，不保存、不提交；②添加成功（区分大小写）；④保存成功。

<!-- mock: mocks/2.3-添加客户/01-后付款提交审批.html | 添加客户（后付款，提交审批二次确认） -->

### 2.4 编辑客户

#### 2.4.1 功能描述

列表行操作「编辑」进入独立页面，面包屑「客户管理/编辑客户」（D-04-27）。只有「预付款 → 后付款」要审批，其他改动直接保存；计费模式变更次月 1 日（UTC0）生效。

#### 2.4.2 核心字段

字段及类型同 2.1.2，顺序同 R-04-017。

#### 2.4.3 业务规则

- **R-04-022** 编辑客户为独立页面，面包屑「客户管理/编辑客户」，返回规则同 R-04-017；字段和顺序同 R-04-017，打开时回显客户当前生效的值（计费模式有待生效变更时回显待生效的目标值，R-04-066）；按钮 返回 / 确定（预付改后付时为「提交审批」）；校验同 R-04-018。
- **R-04-023** 客户当前生效的计费模式为预付款、本次改为后付款时：按钮变为「提交审批」，计费模式旁提示「审批通过后的次月 1 日（UTC0）起生效」。点后二次确认「变更为后付款客户需进行审批，是否提交审批单？」+ 备注（选填）+ 取消 / 确定。确定后提交「客户管理—客户信息变更」审批，本次页面上的全部修改随单一起审，审批通过前都不生效；按 12 返回的审批单状态弱提示（R-12-018）并返回列表（D-04-02）。通过后的生效方式见 R-04-036。
- **R-04-024** 不属于 R-04-023 的保存（后付改预付、取消待生效变更、计费模式没改）：按钮为「确定」，校验通过后直接保存，不走审批，弱提示「保存成功」（D-04-02）。计费模式以外的字段保存即生效；后付改预付的计费模式按 R-04-066 次月生效，计费模式旁提示「保存后 {次月 1 日 yyyy-mm-dd}（UTC0）起生效」。币种、伙伴云签约主体修改后立即生效，本期不影响任何财务单据与计算。
- **R-04-025** 同一客户的基础信息同一时间最多只有 1 张审批中的「客户信息变更」单。有审批中单时打开编辑客户：页面顶部提示条按 R-12-047：「该客户已有审批中的客户信息变更（审批单号 {审批单号}，申请人 {姓名}），请等审批结束或撤回后再操作」，单号可点、新页打开审批详情（没有查看资格按 R-12-043 显示「无权限查看」）；展示当前生效值，所有输入框禁用，「确定 / 提交审批」按钮隐藏，只留返回。
- **R-04-026** 提交或保存时服务端再判一次：该客户已有审批中的同类单（基础信息看客户信息变更，付款主体看付款主体变更）时，拒绝本次保存或提交，不生成第二张单，弹提示框「该客户已有审批中的{客户信息变更 / 付款主体变更}（审批单号 {审批单号}，申请人 {姓名}），请等审批结束或撤回后再操作」，按钮「知道了」，单号可点（句式按 R-12-047，本页对象为「该客户」，审批类型取客户信息变更 / 付款主体变更）。
- **R-04-027** 基础信息（客户信息变更）和付款主体（付款主体变更）两类审批互不影响：一类有审批中单时，另一类照常可以编辑和提交（D-04-13）。
- **R-04-066** 计费模式变更从确定时刻的次月 1 日 00:00（UTC0）起生效（D-00-73）：预付改后付以审批通过时刻为准（例：2026-10-25 提交、2026-11-03 通过 → 2026-12-01 起后付款），后付改预付以保存成功时刻为准。生效前客户仍按原计费模式，同一结算期只有一种计费模式；到生效时刻由系统自动切换，账期按 R-04-003 处理；生效后的余额、欠费处理按 D-00-73（05、06 定义）。同一客户同时最多一条待生效的计费模式变更：编辑页计费模式回显待生效的目标值；本次保存的计费模式与回显值相同视为没改，待生效变更保留；改回当前生效值时直接保存并取消待生效变更（计费模式旁提示「保存后取消 {yyyy-mm-dd} 起改为{目标值}的变更」）；当前生效值为预付款、没有待生效变更、本次改为后付款时走 R-04-023（D-04-26）。
- **R-04-067** 有待生效计费模式时：客户列表计费模式列、客户详情显示「{当前生效值}（{yyyy-mm-dd} 起改为{目标值}）」；编辑页计费模式旁提示「{yyyy-mm-dd}（UTC0）起生效」；客户信息变更审批内容区的计费模式旁，审批中显示「审批通过后的次月 1 日（UTC0）起生效」，已通过显示「生效月：yyyy-mm」（按通过时刻算），已驳回 / 已撤回不显示。05、07 等其他页面怎么显示客户计费模式按各页规则。

#### 2.4.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 编辑期间别人提交了客户信息变更 | 我点确定 / 提交审批 | 拒绝（R-04-026） | 提示框，带审批单号、申请人 |
| 编辑期间别人直接保存了 | 我点确定 | 后保存的覆盖先保存的，由技术沿用现有方案 | 「保存成功」 |
| 改成后付款又改回预付款 | — | 按钮变回「确定」，提示文字消失 | 直接保存 |
| 已有待生效变更，只改备注 | 点确定 | 待生效变更保留（R-04-066） | 「保存成功」 |
| 生效时刻前后打开编辑 | 跨过次月 1 日 | 生效后回显新的生效值，不再有待生效提示 | — |
| 只读用户 / 客户不在数据范围 | — | 看不到编辑入口；直接访问显示「无权限访问」，调接口服务端拒绝 | 「无权限访问」/「无权限操作」 |

#### 2.4.6 验收标准

- **G-04-011** 前置：预付款客户 A，销售张三；客户信息变更审批流为 节点1 绑定的销售、节点2 指定用户周婷。操作：2026-10-12 编辑 A，计费模式改后付款、账期 45、销售改李四、公司别名改「橙子」，点提交审批并确定。期望：改计费模式时旁边出现「审批通过后的次月 1 日（UTC0）起生效」、按钮变「提交审批」；确认框文案「变更为后付款客户需进行审批，是否提交审批单？」；审批节点 1 是张三；客户列表里 A 仍显示预付款、销售张三、原别名。
- **G-04-012** 前置：G-04-011 的单审批中。操作：再次打开编辑 A，点提示条里的审批单号。期望：顶部提示条「该客户已有审批中的客户信息变更（审批单号 {G-04-011 的单号}，申请人 {申请人姓名}），请等审批结束或撤回后再操作」；显示预付款等旧值；所有输入框禁用；只有返回按钮；点单号新页打开这张单的审批详情。
- **G-04-015** 前置：后付款客户 B（账期 30）；另一后付款客户 C。操作：2026-10-20 编辑 B 改为预付款点确定；编辑 C 只改备注点确定。期望：B 计费模式旁提示「保存后 2026-11-01（UTC0）起生效」，提示「保存成功」，列表显示「后付款（2026-11-01 起改为预付款）」，账期 30 保留到生效前；2026-11-01（UTC0）起 B 显示预付款、账期清空；C 直接保存；都不生成审批单。
- **G-04-016** 前置：预付款客户 A 没有审批中单；同一用户开了两个标签页编辑 A。操作：两个标签页都改成后付款，先后点提交审批并确定。期望：第一次成功；第二次弹提示框「该客户已有审批中的客户信息变更（审批单号 {第一张单号}，申请人 {姓名}），请等审批结束或撤回后再操作」，按钮「知道了」；只生成 1 张客户信息变更单。
- **G-04-017** 前置：客户 A 有审批中的客户信息变更单。操作：打开 A 的付款主体弹窗修改并提交审批。期望：能正常编辑、提交，生成付款主体变更单。
- **G-04-037** 前置：G-04-015 之后，B 有待生效变更（2026-11-01 起改为预付款）；预付款客户 D 的客户信息变更审批流 节点1 指定用户周婷。操作：①2026-10-25 编辑 B，只改备注点确定；②再编辑 B，把计费模式改回后付款点确定；③2026-10-25 编辑 D 改为后付款、账期 15 提交审批，2026-11-03 周婷通过。期望：①编辑页计费模式回显预付款并提示「2026-11-01（UTC0）起生效」，保存后待生效变更不变；②按钮为「确定」、不走审批，提示「保存成功」，待生效变更取消，列表显示后付款，账期 30 保留；③审批中审批内容区计费模式旁显示「审批通过后的次月 1 日（UTC0）起生效」；通过后列表显示「预付款（2026-12-01 起改为后付款）」，审批内容区显示「生效月：2026-12」；2026-12-01（UTC0）起 D 显示后付款、账期 15 天。

<!-- mock: mocks/2.4-编辑客户/01-预付改后付.html | 编辑客户（预付款改后付款，按钮变提交审批） -->

<!-- mock: mocks/2.4-编辑客户/02-审批中锁定.html | 编辑客户（有审批中的客户信息变更，锁定） -->

### 2.5 付款主体弹窗

#### 2.5.1 功能描述

列表行操作「付款主体」打开。维护客户的付款主体列表，任何改动都要走「付款主体变更」审批。

#### 2.5.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 付款主体 | payers | 列表（string） | 是（至少 1 条） | 不限格式，长度沿用默认；顺序仅影响展示 | 当前生效值 | R-04-028～R-04-030 |
| 备注 | — | text | 否 | — | — | 二次确认框里填，作为审批发起备注 |

#### 2.5.3 业务规则

- **R-04-028** 付款主体弹窗回显客户当前生效的付款主体，每条一行输入框，按生效顺序排列；没有付款主体时显示一个空行。每行右侧「+」在这一行下方插入一个空行，「−」删除这一行，只剩一行时「−」不可用。输入不限格式，长度沿用默认。
- **R-04-029** 点「提交审批」时校验：去掉首尾空格后至少有 1 条非空；有空行时，该行提示「请输入付款主体名称」；去掉首尾空格后两条完全相同视为重复，提示「付款主体重复」。重复只在本客户内校验，不同客户之间不校验（D-04-14）。
- **R-04-030** 去掉首尾空格后，提交的付款主体集合和当前生效的相同（不看顺序）时不能提交，提示「付款主体未修改」；有增删改时，按提交顺序整体替换（R-04-037）（D-04-14）。
- **R-04-031** 校验通过后二次确认「变更付款主体需进行审批，是否提交审批单？」+ 备注（选填）+ 取消 / 确定。确定后提交「客户管理—付款主体变更」审批（R-04-033），内容为提交后的完整付款主体列表；按 12 返回的审批单状态弱提示（R-12-018），关闭弹窗。付款主体的任何改动都必须走审批，没有直接保存（D-04-02）。
- **R-04-032** 该客户有审批中的付款主体变更单时打开弹窗：顶部提示条按 R-12-047：「该客户已有审批中的付款主体变更（审批单号 {审批单号}，申请人 {姓名}），请等审批结束或撤回后再操作」，单号可点、新页打开审批详情（没有查看资格按 R-12-043 显示「无权限查看」）；输入框禁用，「+」「−」和「提交审批」隐藏。
- **R-04-070** 付款主体的删除、改名只影响之后新提交单据的选项；已提交和已完成的单据（05、06、07、09 等）按各自提交时的快照显示，不受影响。

#### 2.5.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 弹窗打开期间别人提交了付款主体变更 | 我点确定 | 拒绝（R-04-026） | 提示框，带审批单号、申请人 |
| 关闭弹窗没提交 | — | 丢弃修改 | 下次打开仍是生效值 |
| 只调顺序 | 点提交审批 | 不提交（R-04-030） | 「付款主体未修改」 |
| 只读用户 | — | 看不到付款主体入口 | — |

#### 2.5.6 验收标准

- **G-04-018** 前置：客户 A 当前生效付款主体 Starfish Ltd、星海网络科技有限公司。操作：①加第 3 行留空点提交审批；②第 3 行填「 Starfish Ltd 」点提交审批；③删掉第 3 行、不做其他修改点提交审批；④把两行顺序对调点提交审批。期望：①第 3 行提示「请输入付款主体名称」；②提示「付款主体重复」；③④提示「付款主体未修改」；四次都不弹确认框。
- **G-04-019** 前置：客户 A 付款主体为 Starfish Ltd、星海网络科技有限公司；客户 B 已有付款主体 Starfish Ltd。操作：把 A 第 2 行改为「Starfish HK Ltd」，点提交审批并确定，再打开 A 的付款主体弹窗。期望：B 的同名不算重复，提交成功，确认框文案为「变更付款主体需进行审批，是否提交审批单？」；再打开时顶部提示条「该客户已有审批中的付款主体变更（审批单号 {本单单号}，申请人 {姓名}），请等审批结束或撤回后再操作」，显示原来两条，输入框禁用，没有 +、−、提交审批；客户详情的付款主体仍是原来两条。

<!-- mock: mocks/2.5-付款主体/01-编辑校验失败.html | 付款主体弹窗（编辑中，重复校验失败） -->

<!-- mock: mocks/2.5-付款主体/02-审批中锁定.html | 付款主体弹窗（有审批中的付款主体变更，锁定） -->

### 2.6 审批提交与结果处理

#### 2.6.1 功能描述

三类客户审批怎么交给 12、审批结束后客户数据怎么变。审批单状态机、会签、撤回、作废、通知都按 12，这里不重写。本节没有独立页面。

| 审批类型（12 预置） | 从哪里提交 | 业务单据（提交内容） | 操作对象客户 | 本单涉及账户 |
| --- | --- | --- | --- | --- |
| 客户管理—新建客户 | 添加客户，后付款（R-04-020） | 全部基础信息 | 申请中的新客户，销售取表单（R-04-034） | 无 |
| 客户管理—客户信息变更 | 编辑客户，预付改后付（R-04-023） | 全部基础信息 | 本客户，取提交时生效的销售 | 提交时客户名下全部账户 |
| 客户管理—付款主体变更 | 付款主体弹窗（R-04-031） | 完整付款主体列表 | 本客户，取提交时生效的销售 | 提交时客户名下全部账户 |

#### 2.6.3 业务规则

- **R-04-033** 三类审批提交时传给 12：审批类型（客户管理—新建客户 / 客户信息变更 / 付款主体变更）、操作对象客户（R-04-034）、本单涉及账户（R-04-034）、业务单据 = 本次提交的完整内容快照（新建客户和客户信息变更为全部基础信息字段，付款主体变更为完整付款主体列表）、发起备注 = 二次确认框里填的备注。
- **R-04-034** 审批人解析参数：新建客户 = 申请中的这个新客户，「绑定的销售」按提交表单里选的销售解析，表单没选的，该动态节点按 R-12-017 跳过（D-04-05）；本单没有账户，「绑定的运营」解析为空、该节点跳过（D-00-76）。客户信息变更、付款主体变更 = 本客户，「绑定的销售」按提交那一刻客户当前生效的销售解析，即使这张单正在改销售，也由修改前的销售审批（D-04-22）；本单涉及账户 = 提交那一刻客户名下全部账户，「绑定的运营」解析这些账户的优化师（去重、只取启用用户，没有账户时为空跳过），解析出多人按 D-00-43 会签。新建客户时客户还没生效：提交时把表单里的销售作为审批解析参数，不建临时客户（闭环清单 B12）。
- **R-04-035** 新建客户审批结束（R-12-025）：已通过 → 按提交内容创建客户，状态待开户，出现在客户列表；已驳回 / 已撤回（含被作废，R-04-071）→ 不创建客户，提交内容只留在审批单里；要重新申请，需回添加客户重新填写，表单不预填（D-04-01）。命中 0 节点或全部节点被跳过时，提交即通过，客户立即创建（R-12-018）。
- **R-04-036** 客户信息变更审批结束：已通过 → 用提交内容整体覆盖客户当前生效的基础信息，计费模式按 R-04-066 以通过时刻的次月 1 日（UTC0）生效，账期与其余字段通过即生效（账期随审批通过立即保存，计费模式生效前客户仍为预付款、不使用账期，R-04-003、D-04-33），编辑页解除锁定；已驳回 / 已撤回（含被作废）→ 客户基础信息保持不变，编辑页解除锁定。原单不能修改重提，需要在编辑客户重新改完，再提交新单（D-04-01）。
- **R-04-037** 付款主体变更审批结束：已通过 → 用提交的完整列表整体替换当前生效的付款主体，弹窗解除锁定；已驳回 / 已撤回（含被作废）→ 付款主体保持不变，弹窗解除锁定。原单不能修改重提，需要重新编辑再提交新单（D-04-01）。
- **R-04-071** 最后一个审批人通过时按 R-04-035～R-04-037 执行；执行失败按 R-12-045 回滚（D-00-79①：审批单保持审批中、这次通过不记录、确认框显示原因）。本页算执行失败的情形只有一种：新建客户、或客户信息变更改了公司名称，通过那一刻公司名称已与其他客户重名（R-04-068），原因「公司名称「{名称}」已存在，请驳回后重新提交」。其余变化（审批期间名下账户、优化师、销售变化等）都不算失败，照常执行。持「审批配置」权限点的人作废本页审批中的单时（R-12-046），客户数据按「已撤回」处理（D-00-79③）。

#### 2.6.4 状态与流转

本节**引用** 12 的「审批单」状态机（审批中 / 已通过 / 已驳回 / 已撤回，作废效果同撤回），不抄状态清单；只定义结束后对客户的处理（R-04-035～R-04-037）。新建客户审批通过触发客户状态机「（新客户）→ 待开户」（2.1.4）。

#### 2.6.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 审批流 0 节点 / 全部跳过 | 提交即通过 | 立即按 R-04-035～R-04-037 生效（计费模式仍次月生效） | 「提交成功，无需审批，已生效」（R-12-018） |
| 最后通过时公司名称已重名 | 执行失败 | 回滚，审批单仍审批中（R-04-071、R-12-045） | 确认框显示原因；审批详情记「最近一次通过未执行」 |
| 结束回调处理失败（系统异常） | 审批单已通过但客户数据没变 | 由技术沿用现有重试方案，保证最终生效 | 短时间内编辑页仍锁定 |
| 驳回后想再提 | 原单已驳回 | 不提供原单重提 | 已提交审批里只有详情 |

#### 2.6.6 验收标准

- **G-04-009** 前置：G-04-007 的新建客户审批单。操作：陈思远、周婷依次通过；另一张同样提交的单被驳回。期望：通过的那张，客户出现在列表，状态待开户，字段和提交内容一致；驳回的那张，列表没有这个客户，重新打开添加客户表单是空的。
- **G-04-013** 前置：G-04-011 的单。操作：2026-10-15 张三、周婷依次通过。期望：A 的销售李四、别名「橙子」立即生效，账期 45 天随审批通过立即保存（2026-11-01 前 A 仍为预付款、不使用账期）；列表计费模式显示「预付款（2026-11-01 起改为后付款）」；2026-11-01（UTC0）起 A 显示后付款；编辑页解锁；02 里 A 名下账户的销售显示李四。
- **G-04-014** 前置：G-04-011 的单。操作：张三驳回（或申请人撤回）。期望：A 的基础信息不变；编辑页解锁；已提交审批里这张单为已驳回（已撤回），没有撤回、重新提交入口。
- **G-04-020** 前置：G-04-019 的单。操作：审批通过。期望：客户详情付款主体变为 Starfish Ltd、Starfish HK Ltd；弹窗解锁。
- **G-04-040** 前置：付款主体变更审批流 节点1 绑定的运营、节点2 指定用户周婷；新建客户审批流 节点1 绑定的运营、节点2 指定用户周婷；客户 A 名下账户 A1（优化师王敏）、A2（优化师赵磊）、A3（优化师王敏）。操作：提交 A 的付款主体变更；另添加一个后付款客户提交审批。期望：付款主体变更单节点 1 为会签，名单王敏、赵磊（去重），两人都通过才进入节点 2；新建客户单节点 1「已跳过（未找到审批人）」，从节点 2 周婷开始；添加、编辑客户页面、列表、详情、审批内容区都没有「运营」字段。
- **G-04-045** 前置：客户 A 的客户信息变更审批中，本单把公司名称改为「青柠科技有限公司」（提交时没有重名），最后一个节点是周婷；之后有人添加了预付款客户「青柠科技有限公司」并成功。操作：周婷点通过并确定。期望：确认框显示「公司名称「青柠科技有限公司」已存在，请驳回后重新提交」，审批单仍为审批中，周婷这次通过不记录；A 的基础信息不变、编辑页仍锁定；审批详情审批信息区出现「最近一次通过未执行」记录。

### 2.7 客户管理审批详情 · 审批内容区

#### 2.7.1 功能描述

审批详情页的标题、审批信息、审批流时间线、按钮按 12（R-12-026～R-12-031）。本节只定义三类客户审批「审批内容」区展示什么、哪些字段做差异高亮、谁能只读查看。

#### 2.7.2 核心字段

| 审批类型 | 展示字段 | 公司名称链接 | 差异高亮 |
| --- | --- | --- | --- |
| 新建客户 | 全部基础信息（R-04-038） | 否 | 不启用 |
| 客户信息变更 | 全部基础信息（R-04-038） | 是 | 启用，比对全部基础信息字段（R-04-041） |
| 付款主体变更 | 公司名称、付款主体（R-04-039） | 是 | 按条目比对（R-04-042） |

#### 2.7.3 业务规则

- **R-04-038** 新建客户、客户信息变更的审批内容区展示本单提交的全部基础信息，两列排布：公司名称、公司别名、伙伴云签约主体、币种、计费模式（客户信息变更旁另显示生效说明，R-04-067）、账期（后付款时显示，单位天）、销售、起始时间、终止时间、客户来源、备注；空值显示「-」；没有「运营」（D-00-76）。
- **R-04-039** 付款主体变更的审批内容区展示 公司名称、付款主体（按提交顺序每条一行）。
- **R-04-040** 客户信息变更、付款主体变更的「公司名称」是超链接，新页打开这个客户的客户详情（展示当前生效内容，R-04-050）；新建客户的公司名称是纯文本，不做链接。
- **R-04-041** 客户信息变更启用 12 的变更高亮，比对 R-04-038 列出的全部基础信息字段，基准 = 提交那一刻客户的生效值，随审批单快照保存、由后端统一给出（D-00-75）：与基准不同的字段值标红，标红格下方灰字「原：{原值}」；基准为空的不标红，也不显示「原」；审批中、审批结束后回看一致（D-04-23）。审批中客户的生效值已与基准不同时，内容区顶部按 D-00-75 提示。新建客户不启用高亮。
- **R-04-042** 付款主体变更按条目比对提交那一刻生效的付款主体（基准同 R-04-041）：提交列表里新增的条目标红；基准有、提交里没有的条目，在列表末尾以灰色删除线列出；没变的条目正常显示（D-04-11）。审批结束后回看照样（D-04-23）。
- **R-04-043** 三类客户审批详情的第②类只读查看范围（R-12-043）：有「客户管理-只读」或「客户管理-读写」任一权限点，且该客户在本人数据范围内（R-04-061）；新建客户单的客户还不存在，按本单提交内容里的销售是否为本人判断；sys 看全部。本页向 12 提供的「能否查看这张业务单据」判断只看这两条。

#### 2.7.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 存量客户原值为空 | 本单补了值 | 不标红（R-04-041） | 正常显示 |
| 审批已结束再回看 | 生效值已变 | 按提交时快照比对（D-00-75） | 标红、删除线、「原：」与审批中一致 |
| 公司名称链接对应的客户无权查看 | 点链接 | 按 R-04-052 | 「无权限访问」 |

#### 2.7.6 验收标准

- **G-04-021** 前置：客户 A 当前付款主体 Starfish Ltd、星海网络科技有限公司；审批中的付款主体变更提交为 Starfish Ltd、Starfish HK Ltd。操作：审批人打开审批详情。期望：审批内容区显示公司名称（链接）和付款主体：Starfish Ltd 正常、Starfish HK Ltd 标红、星海网络科技有限公司在末尾灰色删除线；点公司名称新页打开 A 的客户详情。
- **G-04-022** 前置：存量客户 D 币种为空（映射不了已置空）、预付款；提交了客户信息变更：币种 USD、计费模式后付款、账期 30。操作：审批人打开审批详情；审批通过后再打开。期望：计费模式「后付款」标红，下方灰字「原：预付款」，旁边显示「审批通过后的次月 1 日（UTC0）起生效」；账期「30」、币种「USD」不标红（原值为空），也没有「原：」；没改的字段正常显示；通过后回看，标红和「原：预付款」不变，计费模式旁改为「生效月：yyyy-mm」。
- **G-04-023** 前置：一张审批中的新建客户单。操作：打开审批详情。期望：审批内容区展示全部基础信息、没有运营；公司名称不是链接；没有任何标红。
- **G-04-024** 前置：孙磊、吴迪、周婷都不在某张客户 A 的客户信息变更单的审批流里；孙磊只有「客户管理-只读」且是 A 的销售；吴迪只有「客户管理-只读」，既不是 A 的销售、也不是其名下账户的优化师；周婷两个客户管理权限点都没有。操作：三人分别打开这张审批详情链接。期望：孙磊能看到审批信息和审批内容，没有任何操作按钮；吴迪、周婷看到「无权限查看」。

<!-- mock: mocks/2.7-审批内容/01-客户信息变更.html | 审批详情·客户信息变更（差异高亮） -->

<!-- mock: mocks/2.7-审批内容/02-付款主体变更.html | 审批详情·付款主体变更（新增标红、删除划线） -->

### 2.8 已提交审批 tab

#### 2.8.1 功能描述

客户管理页顶部切到「已提交审批」，列出当前账号提交的客户审批单。撤回按 12 §2.4。

#### 2.8.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 审批单号 | approval_no | string | 是 | 12 生成 | — | 搜索项 |
| 操作对象 | type | enum | 是 | 新建客户 / 客户信息变更 / 付款主体变更 | — | R-04-046 |
| 操作客户 | — | string | 是 | 本单提交内容里的公司名称 | — | 搜索项 |
| 所属账户系统 | — | 列表 | 否 | 客户当前的 | 「-」 | 新建客户为「-」 |
| 申请人 | applicant_id | 关联用户 | 是 | — | — | — |
| 申请时间 | submitted_at | datetime（Asia/Shanghai，秒） | 是 | yyyy-mm-dd hh:mm:ss | — | 排序依据 |
| 审批状态 | status | enum | 是 | 审批中 / 已通过 / 已驳回 / 已撤回 | — | 状态机见 12 |

#### 2.8.3 业务规则

- **R-04-044** 已提交审批只展示当前登录账号提交的三类客户审批单（新建客户、客户信息变更、付款主体变更），含免审直接通过的单（状态已通过）；不按客户数据范围过滤。
- **R-04-045** 搜索框按审批单号、客户名称包含匹配；状态筛选 全部 / 审批中 / 已通过 / 已驳回 / 已撤回，默认全部。
- **R-04-046** 列表字段：审批单号、操作对象、操作客户、所属账户系统、申请人、申请时间（yyyy-mm-dd hh:mm:ss）、审批状态、操作。操作对象显示审批类型名 新建客户 / 客户信息变更 / 付款主体变更（原型的「基础信息配置」「付款主体」「规则配置」不用，D-04-20）；操作客户显示本单提交内容里的公司名称；所属账户系统取客户当前的，新建客户显示「-」。
- **R-04-047** 排序：审批中置顶，其余按申请时间降序；分页 10 / 50 / 100 / 300 条每页。
- **R-04-048** 行操作：所有状态都有「详情」，新页打开这张单的审批详情（D-04-09）；审批中的单都有「撤回」，只校验申请人本人 + 单据审批中，不看客户管理权限点（D-00-79②、D-04-21）；撤回的确认文案、后果和通知按 12 §2.4（R-12-032～R-12-035），撤回后客户数据按 R-04-035～R-04-037 处理。

#### 2.8.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 没提交过审批 | 列表为空 | — | 空态「暂无数据」 |
| 点撤回时单子已结束 | 状态已不是审批中 | 不撤回（12） | 「该审批单状态已变化，请刷新」并刷新 |
| 申请人被降为只读 | 点撤回 | 照常撤回（R-04-048） | 「已撤回」 |
| 申请人两个客户管理权限点都没有 | 进不了本页 | — | 在审批详情页撤回（R-12-031） |

#### 2.8.6 验收标准

- **G-04-025** 前置：当前账号提交过 新建客户（已通过）、客户信息变更（审批中）、付款主体变更（已驳回）、免审直接通过的付款主体变更各一张；另一账号提交过一张。操作：切到已提交审批。期望：只有本账号的 4 张，免审那张为已通过；审批中那张排第一；操作对象依次显示类型名；只有审批中那张有撤回；都有详情，点详情新页打开审批详情；按客户名称搜索能筛出对应的单。
- **G-04-026** 前置：当前账号一张审批中的付款主体变更单。操作：点撤回并确定。期望：确认文案按 R-12-033；状态变为已撤回；这个客户的付款主体不变，弹窗解锁。
- **G-04-042** 前置：刘佳提交了客户 A 的付款主体变更（审批中）后被收回「客户管理-读写」，只剩「客户管理-只读」；刘佳另有一张客户 B 的客户信息变更单（审批中）。操作：①刘佳在已提交审批 tab 撤回 A 的单；②持「审批配置」的周婷在审批详情作废 B 的单（原因「重复提交」）。期望：①撤回按钮照常显示，撤回成功，A 的付款主体不变；②B 的基础信息不变、编辑页解锁，刘佳的已提交审批里这张单不再是审批中、没有撤回按钮。

<!-- mock: mocks/2.8-已提交审批/01-默认态.html | 已提交审批 tab（默认态） -->

### 2.9 客户详情

#### 2.9.1 功能描述

新增页面，只读展示客户当前生效的全部信息，含每个账户当前生效的规则配置。

#### 2.9.2 核心字段

规则配置表（每个账户一行）：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 账户名称 | — | string | 是 | 客户名下账户 | — | — |
| 规则起始日期 / 服务费规则 / 税率 / 服务费税费 / 返点规则 / 客情结算方式 / 客情费用比例 / 备注 | — | 引用 03 | 否 | 格式按 R-03-037 | 「-」 | R-04-051 |

基础信息、付款主体字段同 2.1.2。

#### 2.9.3 业务规则

- **R-04-049** 客户详情一律新页打开，入口：客户列表「详情」、客户审批详情里的公司名称链接。标题「客户管理/客户详情」；页面只读，没有操作按钮。
- **R-04-050** 客户详情只展示客户当前生效的内容，审批中的修改不展示；有待生效计费模式时按 R-04-067 显示。分三块：基础信息（字段同 R-04-038，另加客户状态）、规则配置（R-04-051）、付款主体（按生效顺序每条一行，没有就显示「-」）。
- **R-04-051** 规则配置表：客户名下每个账户一行，列为 账户名称、规则起始日期、服务费规则、税率、服务费税费、返点规则、客情结算方式、客情费用比例、备注。取值为这个账户对应登记表（绑定的在线登记表、对应该账户的历史上传文件行或迁移占位行，D-00-57）的**当前生效**规则，判定按 R-03-003（已通过、规则起始日期 ≤ 今天 UTC0 里起始日期最大的那条）；起始日期在未来的待生效规则、审批中的提交都不展示（D-04-06）；各列格式按 R-03-037。账户对应的登记表没有当前生效规则（含只有待生效记录）时，账户名称以外各列显示「-」；客户没有账户时表格显示「暂无账户」。
- **R-04-052** 打开的客户不存在（例如新建客户被驳回后没有客户）时显示「客户不存在」；没有任一客户管理权限点、或客户不在本人数据范围（R-04-061）时显示「无权限访问」。

#### 2.9.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 客户有审批中的修改 | — | 只展示生效值 | 不显示审批中的内容 |
| 账户很多 | 规则配置表很长 | 不分页，全部展示 | 表格纵向滚动 |
| 加载失败 | 请求失败 | — | 失败提示，可重试 |

#### 2.9.6 验收标准

- **G-04-027** 前置：今天 2026-10-19；客户 A 有 3 个账户：账户 1 绑定登记表 X，X 有三条已通过的规则（起始 2026-09-01、2026-10-01、2026-11-01）和一张审批中的规则配置单；账户 2 是老账户，对应的历史上传文件行挂着上线导入的一条规则（起始 2026-01-01）；账户 3 绑定登记表 Y，Y 只有一条已通过、起始 2026-12-01 的规则。A 有审批中的客户信息变更。操作：从列表点详情。期望：新页打开；基础信息是当前生效值（不含审批中的修改、没有运营）；规则配置 3 行：账户 1 显示起始 2026-10-01 那条（不显示 2026-11-01 的待生效规则，也不显示审批中的），列名为「返点规则」，各列格式按 R-03-037；账户 2 显示起始 2026-01-01 那条；账户 3 除账户名称外都显示「-」。

<!-- mock: mocks/2.9-客户详情/01-默认态.html | 客户详情（默认态） -->

### 2.10 客户材料

#### 2.10.1 功能描述

列表行操作「客户材料」进入。「合同」标签不变；「客户登记表」标签以后只能绑定在线登记表，历史上传的文件保留，有对应账户的历史文件行和迁移占位行可配规则。绑定动作触发 01 登记表「待关联 → 待开户」。

#### 2.10.2 核心字段

客户登记表标签列表：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 登记表名称 | — | string | 是 | 历史文件 = 原文件名；绑定 = 登记表当前名称；占位行 = 「上线迁移补建（无附件）」 | — | 原「文件名称」改名 |
| 创建时间 | — | datetime（Asia/Shanghai，秒） | 是 | 历史文件沿用；绑定取登记表创建时间；占位行取迁移时间 | — | R-04-059、R-04-073 |
| 上次修改时间 | — | datetime（Asia/Shanghai，秒） | 否 | 历史文件沿用；绑定取登记表编辑时间 | 「-」 | R-04-059 |
| 对应账户 | — | 关联对象 | 否 | 历史文件沿用；绑定取 02 绑定的账户；占位行为该账户 | 「-」 | R-04-059 |

添加登记表弹窗：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 绑定登记表 | registration_id | 关联登记表 | 是 | R-04-057 | — | R-04-057 |
| 对应合同 | — | 关联合同 | 否 | 沿用现有组件与范围 | — | — |

#### 2.10.3 业务规则

- **R-04-053** 客户材料页标题「客户管理/{公司名称}」，有「合同」「客户登记表」两个标签，默认合同；合同标签本期不改，沿用现有。
- **R-04-054** 客户登记表标签：搜索框按登记表名称包含匹配；列表字段 登记表名称、创建时间、上次修改时间、对应账户、操作；不再展示文件类型、文件大小；排序沿用现有；分页 10 / 50 / 100 / 300 条每页。
- **R-04-055** 历史上传的登记表文件保留：登记表名称显示原文件名（旁边的下载 icon 沿用），创建时间、上次修改时间、对应账户沿用原值，行操作 预览 / 编辑 / 删除 和原来一致，编辑可以重新上传替换文件、修改对应合同（D-04-03；现有实现沿用）；有对应账户的行另有「规则配置」（R-04-060）。挂着规则的行（有已通过的规则或审批中的规则配置单）不能删除：「删除」置灰，悬浮提示「该登记表已配置规则，不能删除」（D-04-28）。
- **R-04-056** 「添加登记表」改为绑定在线登记表，不再支持上传：弹窗字段 *绑定登记表（单选下拉，可搜索）、对应合同（选填，组件和可选范围沿用现有）；按钮 确定。
- **R-04-057** 绑定登记表下拉只列状态为待关联、还没关联客户的登记表，且满足其一：当前登录账号创建的（D-04-18）；创建人账号已禁用，或创建人当前没有「客户管理-读写」的（D-04-18 例外，会议清单 D24；2026-10-22 扩大，D-04-34）。选项显示「登记表名称（登记表ID）」，创建人已禁用的显示「登记表名称（登记表ID）· {创建人}（已禁用）」；可按名称或 ID 搜索。没有可选项时，下拉显示「暂无可绑定的登记表（仅本账号创建、或创建人已禁用 / 没有「客户管理-读写」的待关联登记表可绑定）」。
- **R-04-058** 点确定时服务端校验 guard：登记表仍为待关联、还没关联任何客户、创建人是当前账号，或创建人账号已禁用、或创建人当前没有「客户管理-读写」（D-04-34），当前账号有「客户管理-读写」，且本客户是已生效客户、在本人数据范围内。通过后以下动作同成同败：①在登记表上写入关联客户（customer_id）；②登记表状态 待关联 → 待开户（01 流转）；③本客户的登记表标签新增一行；弱提示「添加成功」并关闭弹窗。guard 不满足时不绑定，提示「该登记表状态已变化，请重新选择」并刷新下拉。
- **R-04-059** 绑定方式的行：登记表名称取这张登记表的当前名称（01 改名后跟着变），创建时间取自这张登记表；上次修改时间取登记表的编辑时间（= 01 的 edited_at，仅内部编辑 / 审核保存，不含客户在填写页的保存），从没编辑过显示「-」；对应账户为 02 添加账户时绑定的账户名称，没绑定显示「-」（D-04-19）。
- **R-04-060** 绑定方式的行操作为「详情」「编辑」「规则配置」，没有删除和解绑（D-04-04、D-01-16）。详情 = 只读弹窗，内容与展示格式同 01 登记表详情（R-01-010），能进本客户材料页的人都能看，不受登记表创建人隔离（R-01-008 只管 01 列表）。编辑 = 弹窗里登记表只读显示「登记表名称（登记表ID）」、不能换，只能改对应合同，点确定保存。规则配置 = 打开这张登记表的规则配置页，和 01 登记表列表的「规则配置」是同一个页面（R-01-019），页面内容、校验、提交审批全按 03（R-03-012），从本页进入时面包屑与菜单高亮也按 R-03-012（客户管理/{公司名称}/规则配置）。有对应账户的历史上传文件行、迁移占位行同样有「规则配置」，打开同一个页面、走同样的审批，规则挂在这一行上（D-00-57、R-03-053）；没有对应账户的历史上传文件行没有「规则配置」。显示条件：有「客户管理-读写」且客户在本人数据范围内，不要求是登记表创建人（R-03-013、D-04-24）。
- **R-04-073** 上线迁移时，没有历史上传文件的存量账户各补一行迁移占位行（D-00-57）：登记表名称「上线迁移补建（无附件）」，创建时间为迁移时间，上次修改时间「-」，对应账户为该账户；行操作只有「规则配置」（没有文件，不提供预览、编辑、删除）；不计入 R-04-015 的登记表数量。上线前批量导入的固定比例规则（S-1）挂在该账户的历史上传文件行或占位行上，阶梯 / 分段规则上线后从这里配，须在上线当月内提交，并在次月 2 日（UTC0）出账前审批通过；晚于此的只作用于之后的月份（D-00-57，闭环清单 A14）。

#### 2.10.4 状态与流转

本节**引用** 01 的「客户登记表」状态机，只触发一条：待关联 → 待开户（动作「关联客户」，guard = R-04-058）。

#### 2.10.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 没有可绑定的登记表 | 展开下拉 | — | R-04-057 的提示文案 |
| 两个标签页把同一张登记表绑给两个客户 | 后点确定的那次 | guard 不过（R-04-058） | 「该登记表状态已变化，请重新选择」 |
| 登记表在 01 被内部编辑 | — | 不同步到客户（D-01-06） | 绑定行上次修改时间更新，详情显示登记表最新内容 |
| 删除历史上传文件 | 二次确认 | 沿用现有（v2.0：标题「删除确认」，内容「删除操作行为不可逆，请确认。」） | 行消失；合计为 0 时列表出现提醒 icon（R-04-015） |
| 删除挂着规则的历史文件行 | — | 不允许（R-04-055） | 删除置灰，悬浮提示 |

#### 2.10.6 验收标准

- **G-04-028** 前置：当前账号创建的登记表 P（待关联）、Q（待开户）、R（待审核）；别的启用账号（持「客户管理-读写」）创建的 S（待关联）。操作：在客户 A 的客户材料 → 客户登记表点添加登记表，展开绑定登记表下拉。期望：只有 P；弹窗没有上传入口。
- **G-04-029** 前置：同 G-04-028。操作：选 P、对应合同选一份合同，点确定。期望：提示「添加成功」；列表新增一行 P，创建时间为 P 的创建时间、上次修改时间「-」、对应账户「-」，操作为详情、编辑、规则配置；01 登记表列表里 P 变为待开户，关联客户显示 A。
- **G-04-030** 前置：同一账号在两个标签页分别打开客户 A、客户 B 的添加登记表，都选了 P。操作：先在 A 点确定，再在 B 点确定。期望：A 绑定成功；B 提示「该登记表状态已变化，请重新选择」，下拉刷新后没有 P。
- **G-04-031** 前置：客户 A 的登记表标签有历史上传文件 F（对应账户 CZ-ASA-02，没有规则）和绑定登记表 P（P 由另一账号创建，状态已开户）。操作：用另一个读写账号（A 的销售）打开，分别看 F、P 的操作，点 P 的详情、编辑、规则配置。期望：F 有预览、编辑、删除、规则配置；P 有详情、编辑、规则配置；P 详情只读展示登记内容；P 的编辑弹窗里登记表不能换，只能改对应合同；点 P 的规则配置打开 P 的规则配置页（同 01 入口），面包屑「客户管理/{A 的公司名称}/规则配置」，能看到表单并提交审批；列表没有文件类型、文件大小列。
- **G-04-033** 前置：登记表 P 由已离职同事刘洋创建（账号已禁用），已关联客户 A、状态已开户；王浩有「客户管理-读写」，是 A 名下账户的优化师，没有「客户登记管理」。操作：王浩进客户 A 的客户材料 → 客户登记表，点 P 的「规则配置」，填好后提交审批并确定，再从通知链接或审批中心「全部审批」打开这张单。期望：打开 P 的规则配置页，提交成功，审批单申请人为王浩；王浩在审批详情页能看到这张单并可撤回；审批通过后客户 A 详情里该账户的规则配置变为新规则（R-04-051）。
- **G-04-043** 前置：客户 A：历史文件 F（对应账户 CZ-ASA-02，挂着上线导入的规则）、历史文件 H（没有对应账户）；账户 CZ-ASA-03 没有附件，迁移补了占位行；客户 B 名下只有一个迁移占位行；读写用户是 A、B 的销售。操作：看 A 的三行操作；点 F 的规则配置提交一条新规则；把鼠标放到 F 的删除上；看 B 在客户列表的提醒 icon。期望：F 有预览、编辑、规则配置，删除置灰并悬浮「该登记表已配置规则，不能删除」；H 有预览、编辑、删除，没有规则配置；占位行名称「上线迁移补建（无附件）」、对应账户 CZ-ASA-03，只有规则配置；F 的规则配置打开 03 同一页面并提交规则配置审批；B 的公司名称旁提示「未上传客户登记表」。
- **G-04-044** 前置：刘洋（账号已禁用）创建的待关联登记表 L；张敏（启用，持「客户管理-读写」）创建的待关联登记表 S；赵琳（启用，没有「客户管理-读写」）创建的待关联登记表 M；王浩有「客户管理-读写」，是客户 A 的销售。操作：王浩在 A 的添加登记表下拉里查看，选 L 点确定。期望：下拉里有「L 的名称（L 的 ID）· 刘洋（已禁用）」和「M 的名称（M 的 ID）」，没有 S；绑定成功，L 变为待开户、关联客户 A。

<!-- mock: mocks/2.10-客户材料/01-客户登记表标签.html | 客户材料·客户登记表标签（历史文件与绑定登记表并存） -->

<!-- mock: mocks/2.10-客户材料/02-添加登记表.html | 添加登记表弹窗（绑定在线登记表） -->

### 2.11 权限

#### 2.11.1 功能描述

客户管理沿用现有两个权限点，本页写它们管到哪些按钮和接口，以及客户数据范围。权限点汇总交 13-导航与权限。

#### 2.11.3 业务规则

- **R-04-061** 客户管理只用现有两个权限点「客户管理-只读」「客户管理-读写」，本页不新增权限点（版本级约定：只出权限点）。数据按客户范围隔离（D-00-77，D-04-31）：非 sys 用户在客户列表、客户详情、客户材料、编辑客户、付款主体、规则配置入口、客户审批详情第②类查看（R-04-043）里，只能看、改自己是该客户「销售」、或是其名下任一账户「优化师」的客户；sys 看全部。范围按当前的销售、优化师实时判断，变了随之变。两个权限点都没有的用户不能进入客户管理、客户详情、客户材料，直接访问显示「无权限访问」；有权限点但客户不在范围内时，列表不出现，直接打开该客户的客户详情、客户材料、编辑地址显示「无权限访问」，写接口服务端拒绝。离职人员名下的客户由 sys 改销售（本页编辑客户）或改账户优化师（02）后交接给新人。依赖客户可见性的其他页面（03、05、12）按各页规则引用本条；02 所属客户下拉不受客户数据范围限制（R-02-004，D-00-77 例外）。
- **R-04-062** 只有「客户管理-只读」时：可以看客户列表、客户详情、客户材料（列表、历史文件预览和下载、绑定登记表详情）、已提交审批 tab、三类客户审批详情（均在数据范围内）；不显示 添加客户、编辑、付款主体、添加登记表、客户材料里的编辑、删除与「规则配置」、合同的增删改按钮（D-04-21）。
- **R-04-063** 有「客户管理-读写」时：只读能做的全部，再加上 添加客户、编辑客户、付款主体提交、客户材料的添加 / 编辑 / 删除 / 规则配置、合同增删改（均在数据范围内）。以上写操作服务端同样按权限点和数据范围校验（规则配置页的服务端校验见 R-03-013、R-03-042）。撤回不看这两个权限点（R-04-048）。现状读接口比 R-04-062 宽的，随 19 个权限点一起按 R-04-062、R-04-063 收紧。

#### 2.11.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 只读用户直接调写接口 | — | 服务端拒绝 | 「无权限操作」 |
| 客户不在数据范围，直接打开客户页面地址 | — | 不返回数据 | 「无权限访问」 |
| 销售离职（账号已禁用），名下客户没人能维护 | — | sys 改销售 / 优化师后交接（R-04-061） | 改后新销售可见 |

#### 2.11.6 验收标准

- **G-04-032** 前置：用户只有「客户管理-只读」，是客户 A 的销售。操作：进客户 A 的客户材料；再直接调用添加登记表接口；再直接打开 P 的规则配置页地址。期望：看不到添加登记表、编辑、删除、规则配置按钮（含历史文件行），能预览 F、看 P 的详情；接口返回无权限；规则配置页显示「无权限访问」（R-03-013）。
- **G-04-041** 前置：非 sys 用户刘佳有「客户管理-读写」；客户 A 销售刘佳；客户 B 销售张三、名下账户 B1 优化师刘佳；客户 C 销售张三、名下账户优化师王敏；sys 账号有「客户管理-只读」。操作：刘佳打开客户列表；直接打开 C 的客户详情、客户材料地址；直接调用 C 的编辑接口；sys 打开客户列表；之后把 C 的账户优化师改为刘佳（02），刘佳刷新列表。期望：刘佳列表只有 A、B；C 的客户详情、客户材料显示「无权限访问」；编辑接口返回无权限；sys 看到 A、B、C；优化师改为刘佳后刘佳能看到 C。

## 3 变更影响面

| 被影响对象 | 影响方式 | 处理动作 | 负责人 |
| --- | --- | --- | --- |
| 02-账户管理 | 添加账户触发客户「待开户 → 待投放」（R-04-007）；新建审批中的客户不能被选为所属客户（R-04-006）；账户销售取客户的销售字段（R-04-004）；客户「运营」= 账户优化师（D-00-76），优化师变化影响客户数据范围（R-04-061）；所属客户下拉不受客户数据范围限制（R-02-004，D-00-77 例外）；销售变更时同步账户数据授权（R-04-072，规则归 02） | 02 补销售授权规则与 S-22；所属客户下拉按 R-02-004 | 02 包 |
| 01-客户登记 | 客户材料绑定登记表触发「待关联 → 待开户」并写 customer_id（R-04-058）；创建人已禁用的待关联表可被读写用户绑定（R-04-057）；绑定行详情复用 R-01-010，名称取当前名称 | 01 补 D24 相关规则后核对与 R-04-057 一致 | 01 包 |
| 12-审批配置与审批中心 | 三类审批的操作对象、本单涉及账户、审批内容、高亮基准、执行失败情形、结果处理按本页；「绑定的运营」按账户优化师解析（D-00-76）；第②类查看范围加数据范围（R-04-043） | 12 改 R-12-016、R-12-030、R-12-043 映射；本页引用 R-12-018（提交提示）、R-12-045（执行失败）、R-12-046（作废）、R-12-047（在途单提示）、R-12-049（已禁用显示） | 12 包 |
| 03-规则配置 | 客户详情规则配置表按 R-03-003 取当前生效规则、按 R-03-037 展示；规则配置入口扩到历史上传文件行和迁移占位行（D-00-57）；入口与配置页权限加客户数据范围（R-04-061）；从 04 进入的面包屑按 R-03-012 | 03 支持对历史文件行 / 占位行配置规则；R-03-013 加数据范围 | 03 包 |
| 05、06 | 计费模式次月 1 日生效、同一结算期一种模式（D-00-73）；切换后余额抵扣、上期预付欠费归 05 / 06 | 05 / 06 按 D-00-73 定义 | 05、06 包 |
| 13-导航与权限 | 沿用「客户管理-只读 / 读写」两个权限点，不新增；撤回不看权限点 | 汇总时照抄 R-04-061～R-04-063 | 13 包 |
| 财务链（05～11） | 客户新增币种、伙伴云签约主体；签约主体 05～11 不读取（R-04-011） | 各包用到币种时对空值兜底 | 各包 |
| 11-提成中心 | 本页记录客户销售的每次变更与生效时间（R-04-064） | 11 按业务日取当日销售（R-11-003、D-00-72） | 11 包 |
| 数据迁移 | 存量客户状态按历史消耗推导（R-04-010，S-8）；签约主体 / 币种映射（R-04-011，S-9）；迁移占位行与规则导入（R-04-073，S-1）；「运营」字段停用不迁移（S-24）；删除的 4 个字段（库表 v67 已删） | 技术出迁移脚本；映射表用户确认 | 技术 / 用户 |

## 4 非功能与留痕

- 权限：添加、编辑、付款主体提交、绑定登记表、客户材料删除都在服务端按 R-04-061～R-04-063（含数据范围）校验，前端隐藏按钮不算权限控制。
- 锁定（R-04-025、R-04-032）和重复审批单拦截（R-04-026）、公司名称重名（R-04-068）以服务端判断为准。
- 客户状态每日 UTC0 日结后由系统判定（R-04-008），计费模式在生效时刻由系统切换（R-04-066），都不需要人工操作。
- 留痕：直接保存的基础信息修改沿用现有操作日志；走审批的修改以 12 的审批记录为留痕；销售变更另记变更记录（R-04-064）。
- 通知：三类审批的待审批 / 通过 / 驳回 / 撤回 / 作废通知全部按 12，本页不新增通知。
- 量级：原型没给数据量，不设性能指标，由技术沿用现有列表方案。

## 5 开放问题与已知限制

本页暂无开放问题。

已关闭：原「开启投放取值与触发」问题（客户状态改按消耗判定，D-04-16）、原「公司名称重名规则」问题（D-04-25）。2026-10-22 按闭环问题清单 E 组关闭（技术答复，用户确认）：
- 原「删除 4 个字段的库表与下游」问题：v67 已删 6 列（含电话、邮箱），历史值不可恢复，无计算依赖（R-04-001）。
- 原「历史上传登记表文件现有实现能否沿用」问题：历史文件的预览、下载、替换上传、删除沿用现有实现；技术侧收紧：绑定行不能改名 / 换客户，挂着规则的不能删（R-04-055）。
- 原「新建客户审批『绑定的销售』怎么按表单解析」问题：见闭环清单 B12，提交时把表单里的销售作为审批解析参数，不建临时客户（R-04-034、R-04-043）。
- 原「两个客户管理权限点现有覆盖范围」问题：现状写接口 = 客户管理读写，读接口比 R-04-062 宽（X_PE03、X_PE10 也能读）；随 19 个权限点一起按本页收紧（R-04-063）。

已知限制：
- 销售离职后，名下客户要等 sys 改销售或改账户优化师，其他人才看得到、改得了（R-04-061）。
- 新建客户单没有账户，「绑定的运营」节点总是跳过（R-04-034）。
- 存量里已重名的客户不强制改名（R-04-068）。
- 账户在添加前已有、超过 30 天的消耗不会让待投放客户变投放中（R-04-008 只看最近 30 天）。
- 创建人被收回「客户登记管理」后，删不了自己创建的登记表（R-01-037、D-04-34）。

已定决策 D-04-01～D-04-34 见 spec.yaml decisions；D-04-25～D-04-32 为 2026-10-21 按会议清单 v2 新增，D-04-33、D-04-34 为 2026-10-22 按闭环问题清单新增。
