# 账户管理 PRD

| 项 | 内容 |
| --- | --- |
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 02-账户管理 |
| 涉及功能 | [账户管理](../../../feature/账户管理/README.md) |
| 编制日期 | 2026-10-19 |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手（本文件可直接整份投喂给 AI 作为实现依据） |
| 关联文档 | 本目录 spec.yaml、mocks/；版本 [index.md](../index.md)；原型 `html/账户管理.html`（V2.1.0 注释 9846、编辑弹窗 9277–9483、v2.0 说明 9822/9830）、`html/添加账户.html` |

## 0 前置说明

- 本页覆盖版本记录第 1 项（「编辑账户」弹窗调整）和第 2 项（「添加账户」页面调整）。账户管理里其他没改的部分（数据概览、搜索、高级筛选、导出、表头编辑、授权弹窗、账户内部页）不在本页，沿用现状；授权弹窗里客户销售的只读显示见 R-02-027④。
- 「客户登记表」实体和状态机定义在 [01-客户登记](../01-客户登记/PRD.md) §2.2.4。本页只**触发**其中一条流转：添加账户时选中登记表 → 待开户 → 已开户，前置条件（guard）由本页 R-02-010 定义；登记内容只在添加时回填一次（D-01-06）；一张登记表只绑 1 个账户、本期没有解绑（D-01-15、D-01-16）。
- 「客户」实体、客户状态机、客户上的「销售」字段定义在 [04-客户管理](../04-客户管理/PRD.md)。本页只**触发**其中一条流转：添加账户成功、所属客户为待开户时，客户 待开户 → 待投放，和建账户同成同败（R-04-007）；新建客户审批中的客户不能被选为所属客户（R-04-006、D-04-12）；账户的销售取客户的销售字段（R-04-004）。
- 账户的「优化师」就是业务上的「运营」（D-00-76）：审批动态选项「绑定的运营」按本单涉及账户的优化师解析（12 定义）；非 sys 用户能看哪些客户，也看自己是不是该客户的销售或其名下任一账户的优化师（D-00-77）。本页只维护优化师字段，解析和可见范围不在本页定义；添加账户的「所属客户」下拉是 D-00-77 的例外，不受客户数据范围限制（R-02-004）。
- 本页不涉及审批：编辑账户（包括改投放类型）不走审批（D-02-01）。

## 1 整体概述

### 1.1 背景与目标

现状：开户时，销售、授信额度、返点、客情比例、联系人这些都靠手工在账户上填，跟客户登记表、规则配置、费用管理各记一份，容易对不上。v2.1.0 起客户信息从在线登记表来，返点和客情走规则配置，额度走费用管理。

目标：
- 添加账户必须选一张该客户「待开户」的登记表；选中后投放类型自动带出；添加成功后，这张登记表自动变成「已开户」，并在 01 列表上显示绑定的账户。
- 账户上不再手填那 11 个字段：其中 5 个由系统生成，销售改为跟随客户，其余的老值保留但不再展示。
- 编辑账户只留真正需要维护的字段。

### 1.2 本页范围

- ✅ 包含：
  - 添加账户页：字段调整、所属客户 → 登记表级联、投放类型回填、提交校验与 guard、系统生成字段、触发登记表「待开户 → 已开户」。
  - 编辑账户信息弹窗：字段调整、只读项、投放类型可改。
  - 登记表预览：编辑弹窗和账户列表的文件 icon 共用一套（D-02-06）。
  - 账户「销售」的取值来源（D-02-03），以及销售对账户的数据权限（R-02-027）。
  - 已禁用用户在优化师 / 合作者 / 观察者上的显示与保留（R-02-028）。
  - 账户「优化师」变更记录（R-02-026，供 11 按业务日取值，无展示界面）。
  - 下线旧「账户金额」接口及其导出（D-02-16）。
- ❌ 不包含：
  - 账户管理列表的其他部分、授权弹窗（客户销售的只读显示除外，R-02-027④）、账户内部页：没改，沿用。
  - 登记表实体和状态机（归 01）；客户实体、客户状态机、客户的销售字段（归 04，本页只引用）。
  - 被删字段老值的迁移或清空：保留不动（D-02-02）；还在读老值的下游改从新来源取（R-02-015，技术已核实）。
  - 解绑或更换账户的登记表：本期没有（D-01-16）。
  - 编辑账户走审批：不走（D-02-01）。
  - 更换账户的所属客户、账户系统：本期不能改（R-02-017）；技术后台改数据按数据修复处理。

### 1.3 角色与权限

| 角色 | 能做什么 | 不能做什么 | 权限来源 |
| --- | --- | --- | --- |
| 有添加账户权限的内部用户 | 打开添加账户页；选所属客户名下任一张待开户登记表（不限创建人）；添加账户 | 选择非待开户、或已绑过账户的登记表 | 沿用现有「添加账户」权限点，本页不新增（R-02-025） |
| 有编辑账户权限的内部用户 | 打开编辑账户信息弹窗；改账户名称、产品分类、投放类型、优化师；预览登记表 | 改账户ID、所属客户、登记表；改被删字段 | 沿用现有「编辑账户」权限点，本页不新增（R-02-025） |
| 能看到该账户的内部用户 | 在账户列表点文件 icon 预览登记表 | 在预览里编辑登记表 | 跟随账户的现有查看权限（D-02-05） |

### 1.4 术语定义

| 术语 | 释义 |
| --- | --- |
| 登记表（在线） | 01-客户登记里的客户登记表，客户在线填写。v2.1.0 起新添加的账户都绑这种。 |
| 历史上传文件 | v2.0 时登记表是客户名下上传的文件。老账户可能绑的是这种，保留原样（客户材料.html:3973）。 |
| 被删字段 | 账户上不再展示、不再维护的 11 个字段：销售、授信额度、苹果返点、客户返点、新品截止日期、客情比例、公司/产品名称、订单号、主要联系人姓名、主要联系人邮箱、结算联系人邮箱（账户管理.html:9846）。 |
| 系统生成字段 | 被删字段里改由系统在添加账户时自动写入的 5 个：公司/产品名称、订单号、主要联系人姓名、主要联系人邮箱、结算联系人邮箱（R-02-012）。 |

### 1.5 核心流程

| 步骤 | 操作者 | 系统行为 | 产物 / 状态 |
| --- | --- | --- | --- |
| 前置 | 商务 | 在 01 建登记表 → 客户填写 → 审核通过；在 04 把登记表关联到客户 | 登记表【待开户】 |
| 1 | 内部用户 | 账户管理点「添加账户」，进入添加账户页 | — |
| 2 | 内部用户 | 选账户系统（默认当前）、所属客户 → 登记表下拉只列该客户名下待开户的登记表 → 选一张 | 投放类型自动带出，可改 |
| 3 | 内部用户 | 选账户、产品分类、优化师，可选合作者、观察者 → 点添加 → 二次确认 | — |
| 4 | 系统 | 校验登记表仍可用（R-02-010）→ 创建账户、写系统生成字段、登记表变已开户、回写绑定信息、客户变待投放，同成同败 | 账户；登记表【已开户】；客户【待开户】→【待投放】（R-04-007） |
| 5 | 系统 | 提示「操作成功」，跳进新账户内部 | — |
| 之后 | 内部用户 | 在编辑弹窗维护账户名称、产品分类、投放类型、优化师；随时可预览登记表 | 改动不回写登记表 |

## 2 详细需求

### 2.1 添加账户页

#### 2.1.1 功能描述

账户管理列表点「添加账户」进入的独立页面，面包屑「账户管理/添加账户」，底部按钮 返回 / 添加。和 v2.0 相比：去掉 11 个被删字段；登记表从选上传文件改为选 01 的在线登记表；投放类型按登记表自动带出。

#### 2.1.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 账户系统 | account_system | 关联对象 | 是 | 现有账户系统 | 当前正在操作的账户系统 | R-02-003 |
| 所属客户 | customer_id | 关联对象 | 是 | 账户系统等于本页所选账户系统或为空的全部客户（不受客户数据范围限制）；不含新建审批中的客户 | — | 可搜索；R-02-004 |
| 登记表 | registration_id | 关联对象 | 是 | 所选客户名下、待开户、未绑账户的登记表 | — | 显示「名称（ID）」；R-02-005、R-02-006 |
| 账户选择 | account_id | 关联对象 | 是 | 沿用现有查询结果 | — | R-02-003 |
| 产品分类 | product_category | 关联对象 | 是 | 现有产品分类 | — | 可搜索 |
| 投放类型 | delivery_type | enum | 是 | 代投 / 自投 | 不选；选登记表后回填 | R-02-007 |
| 优化师 | optimizer | 关联对象 | 是 | 启用用户（R-02-028） | — | 可搜索；R-02-014、R-02-026 |
| 合作者 | collaborators | 列表 | 否 | 启用用户，可多选（R-02-028） | — | R-02-014 |
| 观察者 | observers | 列表 | 否 | 启用用户，可多选（R-02-028） | — | R-02-014 |

系统生成、页面不展示的字段：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 公司/产品名称 | company_product_name | string | 是 | 登记表投放产品的应用名称 | — | R-02-012 |
| 订单号 | order_no | string | 是 | 「hby」+ 投放产品应用ID；不要求唯一 | — | R-02-012 |
| 主要联系人姓名 | primary_contact_name | string | 是 | 固定值 | hby | R-02-012 |
| 主要联系人邮箱 | primary_contact_email | string | 是 | 固定值 | asa@hbyaso.com | R-02-012 |
| 结算联系人邮箱 | billing_contact_email | string | 是 | 固定值 | asabill@hbyaso.com | R-02-012 |

key 是文档里的叫法，落库沿用现有字段，由技术对应。

#### 2.1.3 业务规则

- **R-02-001** 账户管理列表点「添加账户」打开添加账户页（独立页面，面包屑「账户管理/添加账户」，底部按钮 返回 / 添加）。点「返回」回到账户管理列表，不保存已填内容。
- **R-02-002** 字段按顺序为：账户系统*、所属客户*、登记表*、账户选择*、产品分类*、投放类型*、优化师*、合作者、观察者；下拉都可搜索。以下字段不再展示：销售、授信额度、苹果返点、客户返点、新品截止日期、客情比例、公司/产品名称、订单号、主要联系人姓名、主要联系人邮箱、结算联系人邮箱（账户管理.html:9846）。
- **R-02-003** 账户系统默认填当前正在操作的账户系统。「账户选择」的可选账户在打开页面时和切换账户系统时重新查询，可选范围沿用现有实现（账户管理.html:9822）。在本页切换账户系统只在本页生效（D-02-10）：重新查询「账户选择」并清空已选账户；按 R-02-004 重新加载所属客户下拉，已选客户仍在新范围内就保留（登记表、投放类型随之保留），不在就清空所属客户和登记表、投放类型回到未选；产品分类、优化师、合作者、观察者保留。不改变全局账户系统；点「返回」回到列表时全局账户系统仍是进入前的那个。只有添加成功后才按 R-02-013 切换。
- **R-02-004** 所属客户下拉的可选范围（D-02-09）：客户的账户系统等于本页所选账户系统，或客户还没有账户系统（新客户）。客户的账户系统取自它名下第一个账户：该客户第一个账户添加成功时写入（R-02-011 第⑥步），之后不再变。不受客户数据范围限制：有添加账户权限的用户（sys 与非 sys 一样）都列出全部满足上述账户系统条件的客户（D-00-77 例外；添加账户通常由优化师操作，2026-10-21 用户确认维持现状）。新建客户审批中的客户不在可选项里（R-04-006）。选项只显示客户名称，不带图标（现状里表示「客户尚未绑定账户系统」的「无用户」图标去掉）。切换所属客户时，清空已选的登记表，投放类型回到未选。
- **R-02-005** 登记表和所属客户级联。没选所属客户时，登记表下拉禁用，占位提示「请先选择所属客户」。选了客户后，只列同时满足三个条件的登记表：关联客户 = 所选客户、状态 = 待开户、还没绑定账户；不限创建人（D-02-04）。选项显示「登记表名称（登记表ID）」（01 允许重名，靠 ID 区分），可以按名称或 ID 搜索。
- **R-02-006** 所选客户名下没有符合 R-02-005 的登记表时，下拉展开显示「该客户暂无待开户的登记表」，没有可选项。登记表是必填，所以这种情况下添加不了。
- **R-02-007** 投放类型：没选登记表时，两个选项都不选中。选中登记表后，自动选中这张登记表的投放类型（代投 / 自投），用户可以手动改（D-02-01）。换选另一张登记表时，按新登记表重新回填，覆盖手动改过的值。
- **R-02-008** 点「添加」先校验必填（账户系统、所属客户、登记表、账户选择、产品分类、投放类型、优化师）。有缺失时，在对应字段下提示「请选择{字段名}」，不弹二次确认。
- **R-02-009** 校验通过后二次确认「请确认信息是否正确？」（取消 / 确认）。点确认才提交；请求处理中，「添加」按钮显示加载，不能再点（账户管理.html:9822、9830）。
- **R-02-010** 提交 guard，也就是 01 登记表「待开户 → 已开户」的前置条件，按服务端最新数据判断：所选登记表状态仍是待开户、还没绑定任何账户、关联客户等于所选的所属客户。任一条不满足：不创建账户，登记表不变，提示「该登记表已被使用或状态已变化，请重新选择」，清空已选登记表并重新加载登记表下拉。服务端另校验（防止绕过页面直接调接口）：所属客户必填；所属客户的账户系统等于本次账户系统或为空（R-02-004；不按客户数据范围校验）。不满足时不创建账户，提示「所属客户与账户系统不匹配，请重新选择」，清空所属客户、登记表并重新加载所属客户下拉。
- **R-02-011** guard 通过后，下面八步同成同败：①创建账户（页面所填字段）；②写入系统生成字段（R-02-012）；③登记表状态 待开户 → 已开户；④在登记表上写入所属账户系统（account_system）、绑定账户ID（account_id）；⑤所属客户为待开户时，客户状态 待开户 → 待投放（流转与规则由 04 定义，见 R-04-007；客户已是其他状态则不变）；⑥所属客户还没有账户系统时，写入本次账户系统（R-02-004）；⑦记录优化师初始值（R-02-026）；⑧按所属客户当前销售授予该账户的数据权限（R-02-027）。任一步失败，八步都不生效，提示「操作失败」，页面保留已填内容。
- **R-02-012** 系统生成字段（前端不展示、不能改）：公司/产品名称 = 所选登记表「投放产品」的应用名称；订单号 = 「hby」+ 投放产品的应用ID（如应用ID 1234567890 → hby1234567890）；主要联系人姓名 = hby；主要联系人邮箱 = asa@hbyaso.com；结算联系人邮箱 = asabill@hbyaso.com。只在添加时写一次，之后改登记表不同步（D-01-06）。订单号不要求唯一（D-02-13）：同一投放产品开多个账户时订单号相同，允许重复；订单号用作广告系列预算订单的默认值、08 苹果订单按订单号归集到账户（一个订单号对应多个账户时按消耗拆分，08 定义），都不依赖唯一。其余 4 个字段（公司/产品名称与 3 个联系人字段）存发票信息表（invoice），用途是新建 / 编辑广告系列时作为苹果 LOC 发票信息的默认值，沿用现有（Q-02-03 已关闭）。
- **R-02-013** 添加成功后弱提醒「操作成功」。如果新账户的账户系统和当前不同，先切换过去，再跳进这个账户内部（账户管理.html:9822 第 3.5.3 条）。
- **R-02-014** 优化师、合作者、观察者三者互斥（D-02-11）：同一用户在其中一处被选中，就从另外两处移除（后选覆盖）。合作者、观察者是可搜索的复选下拉，优化师是可搜索的单选下拉；在合作者或观察者里选了当前优化师，优化师被清空，点添加时按 R-02-008 提示「请选择优化师」。优化师本身就能看到账户，互斥不减少任何人的可见范围。

#### 2.1.4 状态与流转

本页**引用**两套别页定义的状态机，各触发一条，不抄状态清单。

「客户登记表」状态机（定义见 01 §2.2.4）：

| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
| --- | --- | --- | --- | --- |
| 待开户 | 添加账户并选择本登记表，提交成功 | 内部用户（本页） | 已开户 | R-02-010 |

- 同一步在登记表上写入 account_system、account_id（R-02-011），01 列表的「所属账户系统 / 绑定账户 / 绑定账户ID」随之有值。
- 逆向：本期没有解绑，已开户不会回退（D-01-16）。

「客户」状态机（定义见 04-客户管理 flows）：

| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
| --- | --- | --- | --- | --- |
| 待开户 | 添加账户且所属客户为本客户，提交成功 | 内部用户（本页） | 待投放 | R-04-007：和本页建账户同成同败；客户已是待投放 / 投放中 / 停止投放时不变 |

- 逆向：本期客户状态不回退（见 04 R-04-009）。

#### 2.1.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 没选客户就点登记表 | 下拉禁用 | — | 「请先选择所属客户」 |
| 客户名下没有待开户登记表 | 下拉为空 | 不能添加（R-02-006） | 「该客户暂无待开户的登记表」 |
| 必填缺失 | 点添加 | 不弹二次确认（R-02-008） | 对应字段下「请选择{字段名}」 |
| 两人同时用同一张登记表 | 后提交的那位 guard 不过 | 不建账户（R-02-010） | 「该登记表已被使用或状态已变化，请重新选择」，下拉刷新 |
| 停留期间登记表被别处改了状态或客户 | 同上 | 同上 | 同上 |
| R-02-011 中任一步失败 | 提交失败 | 全部不生效（R-02-011） | 「操作失败」，已填内容保留 |
| 绕过页面提交了账户系统不匹配的客户，或没有所属客户 | 服务端校验不过 | 不建账户（R-02-010） | 「所属客户与账户系统不匹配，请重新选择」 |
| 在本页切换账户系统 | 已选客户不在新范围 | 清空所属客户、登记表（R-02-003） | 所属客户、登记表回到未选；全局账户系统不变 |
| 连点「添加」/「确认」 | 多次请求 | 按钮加载中不能再点，只建 1 个账户（R-02-009） | 一条结果提示 |
| 账户选择查询失败或为空 | 列表无数据 | 沿用现有 | 沿用现有 |

#### 2.1.6 验收标准

- **G-02-001** 前置：有添加账户权限的用户在账户管理列表。操作：点「添加账户」。期望：打开添加账户页，面包屑「账户管理/添加账户」；字段依次为账户系统、所属客户、登记表、账户选择、产品分类、投放类型、优化师、合作者、观察者，前 7 个带必填星号；没有销售、授信额度、苹果返点、客户返点、新品截止日期、客情比例、公司/产品名称、订单号、主要联系人姓名/邮箱、结算联系人邮箱；投放类型两个选项都没选中。
- **G-02-002** 前置：客户「星河互娱」名下有登记表 X（待开户，商务甲创建）、Y（待关联）、Z（已开户）；客户「云帆科技」名下有登记表 W（待开户）；当前登录的是优化师乙（非 sys）。操作：所属客户选「星河互娱」，展开登记表下拉。期望：只看到 X，显示为「X 的名称（X 的登记表ID）」；看不到 Y、Z、W。
- **G-02-003** 前置：添加账户页，还没选所属客户。操作：点登记表下拉；再选客户「星河互娱」、选登记表 X，然后把客户改成「云帆科技」。期望：没选客户时登记表下拉禁用，提示「请先选择所属客户」；改客户后登记表被清空，投放类型回到未选。
- **G-02-004** 前置：客户「云帆科技」名下没有待开户的登记表。操作：选这个客户，展开登记表下拉。期望：下拉显示「该客户暂无待开户的登记表」，没有可选项；点添加提示「请选择登记表」，不弹二次确认。
- **G-02-005** 前置：客户「星河互娱」名下有待开户登记表 X（投放类型自投）、X2（投放类型代投）。操作：选 X → 把投放类型手动改成代投 → 换选 X2 → 再换回 X。期望：选 X 后自投被选中；手改后为代投；换 X2 后为代投；换回 X 后为自投。
- **G-02-006** 前置：添加账户页，除优化师外的必填项都填了。操作：点「添加」。期望：不弹二次确认，优化师下方提示「请选择优化师」。
- **G-02-007** 前置：所有必填项都填了，登记表选 X（待开户）。操作：点「添加」→ 二次确认点「确认」。期望：提示「操作成功」并跳进新账户内部；回到账户管理能看到这个账户；01 客户登记表列表里 X 的状态为已开户，所属账户系统、绑定账户、绑定账户ID 显示为这个账户；所属客户原为待开户的，客户管理里变为待投放（再加第二个账户的情形见 G-04-002）。
- **G-02-008** 前置：登记表 X 的投放产品为「星河消除 · 应用ID 1234567890」。操作：选 X 添加账户成功。期望：新账户的公司/产品名称 = 星河消除，订单号 = hby1234567890，主要联系人姓名 = hby，主要联系人邮箱 = asa@hbyaso.com，结算联系人邮箱 = asabill@hbyaso.com（技术查库或接口核验）；添加页和编辑弹窗都看不到这 5 个字段。
- **G-02-009** 前置：用户甲、乙同时打开添加账户页，都选了登记表 X。操作：甲先添加成功，乙随后点添加并确认。期望：乙看到「该登记表已被使用或状态已变化，请重新选择」，不创建账户；乙的登记表被清空，下拉里不再有 X；X 只绑定甲的账户。
- **G-02-010** 前置：所有必填项都填了，登记表选 X；技术模拟创建账户那一步失败。操作：点添加并确认。期望：提示「操作失败」，页面保留已填内容；没有新账户；X 仍为待开户、没绑账户；所属客户状态仍为待开户。
- **G-02-011** 前置：已用登记表 X（投放产品星河消除）添加了账户 A。操作：在 01 编辑 X，把投放产品改成另一个应用、投放类型改成代投，保存。期望：账户 A 的公司/产品名称、订单号、投放类型都不变。
- **G-02-012** 前置：添加页合作者已选用户丙。操作：在观察者里也选丙。期望：丙出现在观察者里，并从合作者里移除。接着把优化师选为丁，再在合作者里选丁：丁出现在合作者里，优化师被清空；把优化师重新选为丙：丙从观察者里移除。
- **G-02-022**（验证 R-02-003）前置：全局账户系统为 A；客户「星河互娱」账户系统为 A，新客户「晨曦文旅」还没有账户系统，客户「海岸传媒」账户系统为 B。操作：进入添加账户页，选客户「星河互娱」、登记表 X、优化师乙；把账户系统切到 B；再点「返回」。期望：切到 B 后「账户选择」重新加载且为空选，所属客户与登记表被清空，优化师乙保留；所属客户下拉里有「海岸传媒」「晨曦文旅」，没有「星河互娱」；返回列表后全局账户系统仍为 A。
- **G-02-023**（验证 R-02-004、R-02-011）前置：同 G-02-022 的三个客户；另有客户「远山科技」账户系统为 A，当前用户（非 sys）既不是它的销售、也不是它名下任何账户的优化师。操作：在账户系统 A 下展开所属客户下拉；选「晨曦文旅」和它的待开户登记表添加账户成功；再把账户系统切到 B 展开下拉。期望：A 下可选「星河互娱」「晨曦文旅」「远山科技」（远山科技不在当前用户的客户数据范围内也照常列出，D-00-77 例外），没有「海岸传媒」，选项不带图标；添加成功后「晨曦文旅」的账户系统为 A，切到 B 时下拉里不再有「晨曦文旅」。
- **G-02-027**（验证 R-02-010）前置：客户「海岸传媒」账户系统为 B。操作：技术绕过页面，在账户系统 A 下以「海岸传媒」为所属客户调用添加账户；再不传所属客户调用一次。期望：两次都不创建账户，提示「所属客户与账户系统不匹配，请重新选择」；登记表状态不变。

<!-- mock: mocks/2.1-添加账户/01-已选登记表.html | 添加账户页（已选登记表，投放类型已回填） -->

<!-- mock: mocks/2.1-添加账户/02-无待开户登记表.html | 添加账户页（所选客户没有待开户登记表 + 必填校验） -->

<!-- mock: mocks/2.1-添加账户/03-登记表已被使用.html | 添加账户页（提交时 guard 不通过） -->

### 2.2 编辑账户信息弹窗

#### 2.2.1 功能描述

账户列表行操作「编辑」打开。和 v2.0 相比：去掉销售等被删字段；登记表改为只读显示 + 预览（见 2.3）；投放类型保留为可改的单选。合作者、观察者仍在「授权」弹窗里改（沿用）。

#### 2.2.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 账户ID | account_id | string | 是 | — | 当前值 | 只读 |
| 账户名称 | account_name | string | 是 | 长度沿用现有 | 当前值 | 可改 |
| 所属客户 | customer_id | 关联对象 | 是 | — | 当前值 | 只读 |
| 登记表 | registration_id | 关联对象 | 否 | 在线登记表 / 历史上传文件 / 无 | 当前值 | 只读；R-02-021 |
| 产品分类 | product_category | 关联对象 | 是 | 现有产品分类 | 当前值 | 可改 |
| 投放类型 | delivery_type | enum | 是 | 代投 / 自投 | 当前值 | 可改；R-02-018 |
| 优化师 | optimizer | 关联对象 | 是 | 启用用户；原值已禁用时回显「姓名（已禁用）」（R-02-028） | 当前值 | 可改 |

#### 2.2.3 业务规则

- **R-02-016** 账户列表行操作「编辑」打开「编辑账户信息」弹窗，按钮 关闭 / 确认（入口沿用）。
- **R-02-017** 弹窗字段：账户ID（只读）、账户名称*（可改）、所属客户（只读）、登记表（只读，见 R-02-021）、产品分类*、投放类型*（代投 / 自投）、优化师*；打开时回显账户当前值。不展示 R-02-002 列出的被删字段，也不展示合作者、观察者（在「授权」弹窗里改，沿用）。所属客户、账户系统添加后不能改，本期没有更换入口。
- **R-02-018** 投放类型可以改，点确认保存后直接生效：不走审批，不回写登记表。登记表后来改了投放类型，也不同步到账户（D-02-01、D-01-06）。
- **R-02-019** 点「确认」校验必填（账户名称、产品分类、投放类型、优化师），缺失时在字段下提示，不保存。保存成功关闭弹窗，弱提醒「操作成功」；失败提示「操作失败」，弹窗不关，保留输入。请求中「确认」按钮显示加载，不能再点。账户名称改了以后的其他现有联动，沿用。
- **R-02-020** 被删字段（销售、授信额度、苹果返点、客户返点、新品截止日期、客情比例、公司/产品名称、订单号、主要联系人姓名、主要联系人邮箱、结算联系人邮箱）在库里的现有值，编辑保存时不修改、不清空（D-02-02）。

#### 2.2.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 必填被清空 | 点确认 | 不保存 | 字段下提示必填 |
| 老账户没有登记表 | 打开弹窗 | — | 登记表一栏「-」（R-02-021） |
| 老账户投放类型为空 | 打开弹窗 | 两个选项都不选中 | 点确认时提示「请选择投放类型」 |
| 优化师已禁用 | 打开弹窗、只改其他字段后确认 | 原值原样保留，不记变更（R-02-028） | 优化师显示「姓名（已禁用）」，保存成功 |
| 保存失败 | 请求失败 | 不关弹窗 | 「操作失败」，输入保留 |
| 连点确认 | 多次请求 | 按钮加载中不能再点 | 一条结果提示 |

#### 2.2.6 验收标准

- **G-02-014** 前置：账户 A（已绑登记表 X）。操作：点行操作「编辑」。期望：弹窗显示账户ID（灰显不可改）、账户名称、所属客户（灰显不可改）、登记表「X 的名称 + 预览」、产品分类、投放类型、优化师，都回显当前值；没有被删字段，也没有合作者、观察者。
- **G-02-015** 前置：账户 A 投放类型为自投，登记表 X 投放类型为自投。操作：在编辑弹窗把投放类型改成代投，点确认。期望：提示「操作成功」，弹窗关闭，账户 A 投放类型为代投；没有生成任何审批单；X 的投放类型仍为自投。
- **G-02-016** 前置：老账户 B 库里授信额度 = 10,000.00、客户返点 = 3.00%。操作：在编辑弹窗只改优化师，点确认。期望：保存成功；弹窗里看不到授信额度、客户返点；库里这两个值仍为 10,000.00、3.00%（技术核验）。
- **G-02-017** 前置：账户 A 的编辑弹窗。操作：清空账户名称后点确认。期望：账户名称下提示必填，弹窗不关，不保存。

<!-- mock: mocks/2.2-编辑账户/01-默认态.html | 编辑账户信息弹窗（默认态） -->

### 2.3 登记表预览

#### 2.3.1 功能描述

编辑弹窗里「登记表」一栏的「预览」，和账户列表账户名称左侧的文件 icon，打开的是同一个只读预览（D-02-06）。新登记表看登记内容；老账户绑的历史上传文件沿用原来的文件预览。

#### 2.3.3 业务规则

- **R-02-021** 编辑弹窗「登记表」一栏：绑的是 01 在线登记表 → 显示登记表名称 + 「预览」；绑的是历史上传文件 → 显示文件名 + 「预览」，预览沿用原文件预览；没有登记表 → 显示「-」，没有预览（D-02-05）。上线迁移给没有附件的存量账户补建的「上线迁移补建（无附件）」行（D-00-57，用于在 04 配规则）在本页视同没有登记表：显示「-」、没有预览，列表不显示文件 icon（D-02-14）。
- **R-02-022** 预览在线登记表：弹层只读展示这张登记表的登记内容，字段和展示格式和 01 的详情一致（R-01-010：日预算千分位 + 2 位小数，多行文本保留换行、不截断），取登记表当前的内容，登记表名称取当前名（R-01-039）；没有编辑、保存按钮，只能关闭。
- **R-02-023** 能打开编辑弹窗、或能在列表看到该账户的人，都可以预览，不受 01「只看自己创建的登记表」的限制（D-02-05）。
- **R-02-024** 账户列表账户名称左侧的文件 icon，复用 R-02-021～R-02-023 的预览（D-02-06）；账户没有登记表时不显示 icon；列表其余部分不变。

#### 2.3.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 预览内容加载失败 | 请求失败 | 不影响编辑弹窗 | 弹层内失败提示，可关闭重试 |
| 历史上传文件已在客户材料里被删除 | 文件不存在 | 沿用现有文件预览的处理 | 沿用现有 |
| 登记表在开户后被 01 内部编辑过 | 内容与开户时不同 | 预览展示当前内容；账户上的回填值不变（D-01-06） | 登记表最新内容 |

#### 2.3.6 验收标准

- **G-02-018** 前置：账户 A 绑定登记表 X（商务甲创建）；优化师乙有编辑账户权限。操作：乙打开 A 的编辑弹窗，点「预览」。期望：弹层只读展示 X 的登记内容（签约主体名称、投放产品、参考竞品、苹果账户邮箱、ASC关联邮箱、投放类型、产品投放日期、产品投放地区、日预算、KPI要求、三方归因平台、备注），没有编辑、保存按钮。
- **G-02-019** 前置：老账户 B 绑的是历史上传文件「星河互娱登记表.pdf」；老账户 C 没有登记表。操作：分别打开 B、C 的编辑弹窗。期望：B 显示「星河互娱登记表.pdf」+ 预览，点预览按原来的方式打开文件；C 的登记表一栏显示「-」，没有预览。
- **G-02-020** 前置：账户 A 绑定登记表 X；账户 C 没有登记表。操作：在账户管理列表看 A、C 的账户名称，点 A 左侧的文件 icon。期望：A 有文件 icon，点开和编辑弹窗里的预览内容一致；C 没有文件 icon。

<!-- mock: mocks/2.3-登记表预览/01-预览弹层.html | 登记表预览弹层（编辑弹窗与列表 icon 共用） -->

### 2.4 账户「销售」的取值与数据权限

#### 2.4.1 功能描述

销售从账户上删掉了，但账户列表的销售列、高级筛选的销售、审批「绑定的销售」、销售的账户数据权限都还要用。v2.1.0 起账户列表与筛选里的销售实时跟随所属客户（D-02-03），提成按业务日的历史归属（D-00-72）；销售对账户的数据权限按 R-02-027 同步。

#### 2.4.3 业务规则

- **R-02-015** 账户不再维护「销售」：添加页、编辑弹窗都不展示。账户列表的销售列、高级筛选的销售、导出里的销售实时取账户所属客户的销售（D-02-03）；客户换了销售，这些地方跟着变。提成统计不实时取，按业务日的历史归属（R-11-003、D-00-72）。审批「绑定的销售」解析客户的销售（R-12-016），销售对账户的数据权限按 R-02-027。账户上的旧销售值保留不用（D-02-02），上述地方都不再读它。客户上的销售字段由 04 定义（R-04-004，原「商务」就是这个字段）。
- **R-02-027** 销售对账户的数据权限（D-02-08）：①添加账户成功时，按所属客户当前销售授予该账户的数据权限（R-02-011 第⑧步；客户没有销售时不授予）。②客户销售变更生效时（04 直接保存成功、或客户信息变更审批通过，时点同 R-04-064），给新销售授予该客户名下全部账户的数据权限，同时收回旧销售因「客户销售」身份获得的授权；旧销售同时是某账户的优化师、合作者或观察者的，该账户的授权保留；销售改为空时只收回、不授予。③上线时按客户当前销售，给其名下全部账户补授权一次（S-22）。授权变化不改账户上的任何字段，也不影响在途审批单（R-12-015）。④授权弹窗里，客户当前的销售按「销售」只读显示、不能移除（同优化师）；可以再把他设为合作者或观察者，之后换销售时这个身份保留（按②保留授权）；移除合作者 / 观察者时，此人如果仍是客户销售，销售授权保留（D-02-15）。

#### 2.4.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 客户没填销售 | 取不到 | 账户销售为空 | 列表显示「-」 |
| 老账户库里有旧销售值，和客户的销售不同 | 两边不一致 | 以客户的销售为准；旧值保留不用（D-02-02） | 显示客户的销售 |
| 存量账户取不到所属客户 | 上线前迁移检查 | 由技术导出清单、用户指定所属客户后写入（S-21）；上线后账户都有所属客户 | 无 |
| 新销售同时已是某账户的合作者 | 客户换销售 | 照常授予，权限不重复叠加（R-02-027） | — |

#### 2.4.6 验收标准

- **G-02-013** 前置：客户「星河互娱」的销售为李明，名下有账户 A。操作：在客户管理把这个客户的销售改成王芳，再看账户管理列表。期望：账户 A 的销售显示王芳；添加页、编辑弹窗都没有销售字段。
- **G-02-024**（验证 R-02-027、R-02-011）前置：客户「星河互娱」销售为李明，名下有账户 A（优化师王五，李明因销售身份已获授权）、B（合作者含李明）。操作：①以「星河互娱」添加账户 C 成功，李明登录看账户列表；②在客户管理把销售改为王芳并保存成功；③李明、王芳分别登录看账户列表。期望：①李明能看到 A、B、C；③王芳能看到 A、B、C；李明只能看到 B（作为合作者保留），看不到 A、C。

### 2.5 权限

#### 2.5.3 业务规则

- **R-02-025** 本页不新增权限点：添加账户、编辑账户沿用现有权限点；登记表预览跟随账户的查看权限。13-导航与权限汇总时记「02 无新增」（版本级约定：只出权限点、不预设角色；D-02-07）。

### 2.6 账户「优化师」变更记录

#### 2.6.1 功能描述

提成按业务日的历史归属算（D-00-72），11-提成中心要按业务日取账户当日的优化师（R-11-003）。本页负责把账户优化师的每次变化记下来；本页不新增展示界面。

#### 2.6.3 业务规则

- **R-02-026** 账户「优化师」每次变化都记录一条：变更前的值、变更后的值、生效时间。添加账户成功时记初始值（变更前为空），生效时间为添加成功时刻，和 R-02-011 同成同败；编辑账户信息弹窗保存成功（R-02-019）且优化师和原值不同时记一次变更，生效时间为保存成功时刻。保存失败、或优化师没变（只改了其他字段）时不记录。变更当天（UTC0）起归新优化师；上线时存量账户没有变更历史，上线前的日子一律按上线时的优化师（D-00-72）。账户添加成功前已经有消耗的日子，06 账单、10 利润照常计入（R-06-005）；提成归属按添加成功时记下的初始优化师、当日所属客户的销售（R-04-064）。优化师变化同时影响审批「绑定的运营」的解析（只影响之后提交的单，R-12-015）和客户可见范围（D-00-76、D-00-77）。记录供 11 按业务日取当日优化师（R-11-003），本页不新增展示界面。

#### 2.6.6 验收标准

- **G-02-021** 前置：账户 A 的优化师为王五（上线后添加账户时设定）。操作：2026-10-15（UTC0）在编辑弹窗把 A 的优化师改为赵六，点确认保存成功；再只改 A 的账户名称并保存。期望：系统能查到 A 的优化师变更记录：变更前王五、变更后赵六、生效时间为第一次保存成功的时刻（技术查库核验）；第二次保存没有新增变更记录；11-提成中心里 A 的 2026-10-14 归王五、2026-10-15 起归赵六（R-11-003）。
- **G-02-026**（验证 R-02-026）前置：账户 D 在 2026-10-10 起已有消耗；2026-10-15（UTC0）添加进系统，初始优化师赵六，所属客户销售李明。操作：看 06 结算期 2026-10 的账单、10 利润与 11 提成。期望：06、10 的 D 包含 2026-10-10 起的消耗；11 中 D 的 2026-10-10～10-14 归优化师赵六、销售李明。

### 2.7 已禁用用户的显示与保留

#### 2.7.3 业务规则

- **R-02-028** 已禁用用户（D-00-83、D-02-12）：账户的优化师、合作者、观察者里已禁用的用户，在账户列表、编辑弹窗、授权弹窗回显为「姓名（已禁用）」，不显示用户ID。编辑保存时原值原样保留，不算一次变更（不写 R-02-026 变更记录），必填校验视为已填。主动改选时，候选只有启用用户；改掉以后不能再选回已禁用的人。
#### 2.7.6 验收标准

- **G-02-025**（验证 R-02-028）前置：账户 A 的优化师为王五，王五账号已禁用。操作：①打开 A 的编辑弹窗；②只改账户名称并确认；③再打开弹窗，展开优化师下拉，改选赵六并确认；④再展开优化师下拉。期望：①优化师显示「王五（已禁用）」；②保存成功，优化师仍为王五，没有新增优化师变更记录；③候选里没有王五，保存成功，记一条王五 → 赵六的变更；④候选里仍没有王五。

## 3 变更影响面

| 被影响对象 | 影响方式 | 处理动作 | 负责人 |
| --- | --- | --- | --- |
| 01-客户登记 | 本页触发登记表 待开户 → 已开户，并写入 account_system、account_id；回填只取一次；预览格式与登记表名称按 01（R-01-010、R-01-039） | 已在 01 状态机预留本条流转（「由 02 定义」），guard 见 R-02-010 | 02 包 |
| 04-客户管理 | 添加账户触发客户 待开户 → 待投放；账户的销售取客户的销售；客户的账户系统由第一个账户写入（R-02-004）；客户换销售时同步账户数据权限（R-02-027，时点同 R-04-064）；所属客户下拉不受客户数据范围限制（D-00-77 例外） | 04 定义客户状态机、销售字段与变更时点（R-04-007、R-04-004、R-04-064）；R-04-064 旁补「同时按 R-02-027 同步授权」 | 04 包 |
| 03-规则配置、05-费用管理 | 账户上不再有返点、客情比例、授信额度 | 已改从 03 规则配置、05 额度调整取（技术已核实计算不读老值）；老值保留不用（D-02-02） | 03、05 包 + 技术 |
| 05-费用管理 | 客户可见范围跟账户查看权限走，销售能否看到自己的客户取决于 R-02-027 | 05 R-05-035 引用 R-02-027 | 05 包 |
| 11-提成中心 | 销售按业务日历史归属（R-11-003、D-00-72）；本页记录账户优化师每次变更（R-02-026）；添加前已有消耗的日子按初始优化师 | 11 R-11-003 末尾补「添加前的日子按初始值」 | 11 包 |
| 12-审批配置与审批中心 | 「绑定的运营」按本单涉及账户的优化师解析（D-00-76）；「绑定的销售」读客户销售 | 12 定义解析；本页只维护优化师字段 | 12 包 |
| 账户列表 / 高级筛选 / 导出 | 销售列、销售筛选、导出取客户的销售；优化师等已禁用用户显示「姓名（已禁用）」；文件 icon 预览新登记表 | R-02-015、R-02-028、R-02-024；列表其余不动 | 技术 |
| 广告系列、08 苹果订单归集 | 订单号系统生成、可重复；其余 4 个系统生成字段作为新建 / 编辑广告系列时苹果 LOC 发票信息的默认值 | R-02-012（Q-02-03 已关闭） | 技术 |
| 旧「账户金额」接口及其导出 | 前端已无页面调用；仍读账户上的老授信额度、返点字段 | 本期下线（D-02-16，Q-02-04 已关闭） | 技术 |
| 13-导航与权限 | 本页无新增权限点 | 汇总时记「02 无新增」 | 13 包 |

## 5 开放问题

| 编号 | 问题 | 卡谁 | 期望结论时间 |
| --- | --- | --- | --- |
| Q-02-03 | 【已关闭 2026-10-22 → 技术答复确认：①账户选择范围沿用现有查询，不变（R-02-003）；②公司/产品名称与 3 个联系人字段存发票信息表（invoice），用途是新建 / 编辑广告系列时作为苹果 LOC 发票信息的默认值（R-02-012）；③账户名称修改的联动沿用（R-02-019）】原问题：账户选择的可选范围；公司/产品名称与 3 个联系人字段现在被谁用；账户名称修改的现有联动 | — | — |
| Q-02-04 | 【已关闭 2026-10-22 → D-02-16：前端已无任何页面调用旧「账户金额」接口及其导出，本期下线】原问题：旧「账户金额」页面 / 导出是否还有可达的菜单入口（技术答复 T20：该接口及其导出仍读账户上的老授信额度、返点字段） | — | — |
