⚠ 2 项未定,先别开跑: 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:该接口及其导出仍读账户上的老授信额度、返点字段)"
账户管理 PRD
项 内容 所属产品 ASA 版本 v2.1.0 页面 02-账户管理 涉及功能 账户管理 编制日期 2026-10-19 文档状态 待评审 目标读者 研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据) 关联文档 本目录 spec.yaml、mocks/;版本 index.md ;原型 html/账户管理.html(V2.1.0 注释 9846、编辑弹窗 9277–9483、v2.0 说明 9822/9830)、html/添加账户.html
0 前置说明
本页覆盖版本记录第 1 项(「编辑账户」弹窗调整)和第 2 项(「添加账户」页面调整)。账户管理里其他没改的部分(数据概览、搜索、高级筛选、导出、表头编辑、授权弹窗、账户内部页)不在本页,沿用现状;授权弹窗里客户销售的只读显示见 R-02-027④。 「客户登记表」实体和状态机定义在 01-客户登记 §2.2.4。本页只触发 其中一条流转:添加账户时选中登记表 → 待开户 → 已开户,前置条件(guard)由本页 R-02-010 定义;登记内容只在添加时回填一次(D-01-06 );一张登记表只绑 1 个账户、本期没有解绑(D-01-15 、D-01-16 )。 「客户」实体、客户状态机、客户上的「销售」字段定义在 04-客户管理 。本页只触发 其中一条流转:添加账户成功、所属客户为待开户时,客户 待开户 → 待投放,和建账户同成同败(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 :和本页建账户同成同败;客户已是待投放 / 投放中 / 停止投放时不变
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 下以「海岸传媒」为所属客户调用添加账户;再不传所属客户调用一次。期望:两次都不创建账户,提示「所属客户与账户系统不匹配,请重新选择」;登记表状态不变。
示意 1 添加账户页(已选登记表,投放类型已回填)mocks/2.1-添加账户/01-已选登记表.html
PC 1440
移动 375
全宽长图
新窗口打开
示意 2 添加账户页(所选客户没有待开户登记表 + 必填校验)mocks/2.1-添加账户/02-无待开户登记表.html
PC 1440
移动 375
全宽长图
新窗口打开
示意 3 添加账户页(提交时 guard 不通过)mocks/2.1-添加账户/03-登记表已被使用.html
PC 1440
移动 375
全宽长图
新窗口打开
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 的编辑弹窗。操作:清空账户名称后点确认。期望:账户名称下提示必填,弹窗不关,不保存。
示意 4 编辑账户信息弹窗(默认态)mocks/2.2-编辑账户/01-默认态.html
PC 1440
移动 375
全宽长图
新窗口打开
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。
示意 5 登记表预览弹层(编辑弹窗与列表 icon 共用)mocks/2.3-登记表预览/01-预览弹层.html
PC 1440
移动 375
全宽长图
新窗口打开
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:该接口及其导出仍读账户上的老授信额度、返点字段) — —