账户管理

v2.1.0 02-账户管理 ASA 状态:待评审 2026-10-19 评审版 · 由 PRD.md 自动生成,勿手改

账户管理 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 整体概述

1.1 背景与目标

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

目标:

1.2 本页范围

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_typeenum是代投 / 自投不选;选登记表后回填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_namestring是登记表投放产品的应用名称—R-02-012
订单号order_nostring是「hby」+ 投放产品应用ID;不要求唯一—R-02-012
主要联系人姓名primary_contact_namestring是固定值hbyR-02-012
主要联系人邮箱primary_contact_emailstring是固定值asa@hbyaso.comR-02-012
结算联系人邮箱billing_contact_emailstring是固定值asabill@hbyaso.comR-02-012

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

2.1.3 业务规则

2.1.4 状态与流转

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

「客户登记表」状态机(定义见 01 §2.2.4):

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

「客户」状态机(定义见 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 验收标准

示意 1添加账户页(已选登记表,投放类型已回填)mocks/2.1-添加账户/01-已选登记表.html
示意 2添加账户页(所选客户没有待开户登记表 + 必填校验)mocks/2.1-添加账户/02-无待开户登记表.html
示意 3添加账户页(提交时 guard 不通过)mocks/2.1-添加账户/03-登记表已被使用.html

2.2 编辑账户信息弹窗

2.2.1 功能描述

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

2.2.2 核心字段

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

2.2.3 业务规则

2.2.5 异常与边界

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

2.2.6 验收标准

示意 4编辑账户信息弹窗(默认态)mocks/2.2-编辑账户/01-默认态.html

2.3 登记表预览

2.3.1 功能描述

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

2.3.3 业务规则

2.3.5 异常与边界

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

2.3.6 验收标准

示意 5登记表预览弹层(编辑弹窗与列表 icon 共用)mocks/2.3-登记表预览/01-预览弹层.html

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

2.4.1 功能描述

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

2.4.3 业务规则

2.4.5 异常与边界

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

2.4.6 验收标准

2.5 权限

2.5.3 业务规则

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

2.6.1 功能描述

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

2.6.3 业务规则

2.6.6 验收标准

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

2.7.3 业务规则

2.7.6 验收标准

3 变更影响面

被影响对象影响方式处理动作负责人
01-客户登记本页触发登记表 待开户 → 已开户,并写入 account_system、account_id;回填只取一次;预览格式与登记表名称按 01(R-01-010、R-01-039)已在 01 状态机预留本条流转(「由 02 定义」),guard 见 R-02-01002 包
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-02705 R-05-035 引用 R-02-02705 包
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:该接口及其导出仍读账户上的老授信额度、返点字段)——