客户管理 PRD
| 项 | 内容 |
|---|---|
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 04-客户管理 |
| 涉及功能 | 客户管理 |
| 编制日期 | 2026-10-19(2026-10-21 按会议清单 v2 回写;2026-10-22 按闭环问题清单回写) |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据) |
| 关联文档 | 本目录 spec.yaml、mocks/;版本 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 的签约主体与币种都显示「-」,列表、编辑页都不出现「某某主体」原文。
- 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 的标红;公司名称后没有「(点击查看详情)」。
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 把公司名称改为「星海网络科技有限公司」点确定。期望:①③⑤公司名称下方提示「公司名称已存在」,不保存、不提交;②添加成功(区分大小写);④保存成功。
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 天。
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 的同名不算重复,提交成功,确认框文案为「变更付款主体需进行审批,是否提交审批单?」;再打开时顶部提示条「该客户已有审批中的付款主体变更(审批单号 {本单单号},申请人 {姓名}),请等审批结束或撤回后再操作」,显示原来两条,输入框禁用,没有 +、−、提交审批;客户详情的付款主体仍是原来两条。
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 的销售、也不是其名下账户的优化师;周婷两个客户管理权限点都没有。操作:三人分别打开这张审批详情链接。期望:孙磊能看到审批信息和审批内容,没有任何操作按钮;吴迪、周婷看到「无权限查看」。
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 的基础信息不变、编辑页解锁,刘佳的已提交审批里这张单不再是审批中、没有撤回按钮。
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 除账户名称外都显示「-」。
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。
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 按闭环问题清单新增。