客户登记 PRD
项 内容 所属产品 ASA 版本 v2.1.0 页面 01-客户登记 涉及功能 客户登记 编制日期 2026-10-16 文档状态 待评审 目标读者 研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据) 关联文档 本目录 spec.yaml、mocks/;版本 index.md ;原型 html/客户登记表.html、html/客户登记表填写页面.html
0 前置说明
本页覆盖版本记录第 3 项(客户登记表列表)和第 5 项(客户登记填写页)。 本页主管「客户登记表」实体和状态机 。02-账户管理、04-客户管理只触发其中的流转,状态清单以本页为准。 规则配置页的内容,以及登记表规则配置审批详情里记录的内容,归 03-规则配置(D-01-02)。审批详情页的通用框架、撤回、会签归 12-审批配置与审批中心(版本级约定,见版本 index「共用定义指路」)。本页只放「规则配置」入口和「已提交审批」列表。 提交通知里「绑定企业微信」弹窗沿用个人中心现有弹窗,交互和广告管理里「添加监控」一致;应用搜索、地区选择组件沿用现有组件。这几项由技术按现有实现复用。
1 整体概述
1.1 背景与目标
现状:客户开户前的投放信息靠线下收集,商务没法统一跟进。目标:商务在系统里建一张登记表,把链接发给客户;客户免登录填写提交,商务审核后,在客户管理里关联客户、在账户管理里开户,登记表状态跟着走到「已开户」。商务在列表里随时能看到每张表卡在哪一步。
1.2 本页范围
✅ 包含:新增登记表弹窗;登记表列表(搜索、筛选、排序、分页、行操作);详情、编辑、审核弹窗;删除;「规则配置」入口;「已提交审批」tab;对外填写页(免登录、自动保存、提交、中英文);提交通知;登记表实体与状态机定义。 ❌ 不包含: 规则配置页内容和审批记录内容(归 03,D-01-02);审批详情通用框架、撤回规则(归 12)。 关联客户动作本身(归 04)、添加账户时选登记表的动作本身(归 02)。 客户列表行操作里的「规则配置」入口:原型修改残留,不做(D-01-03);04 客户材料的绑定登记表行另有入口,打开同一个 03 页面(R-04-060 )。 新增弹窗里的「投放应用」组件:原型残留,不做(D-01-07)。 编辑登记表后同步到已关联的客户、账户(D-01-06)。 修改链接有效期、提交通知:创建后不能改,填错就删除重建(R-01-017、D-01-19)。 退回客户修改:未通过是终止状态,客户要重填就由商务新建一张登记表(D-01-01)。 存量账户的「历史上传文件」行(含上线迁移补建的无附件行)及其「规则配置」入口:在 04 客户材料(D-00-57 、R-04-060 ),不是在线登记表,不进本页列表。 填写页的移动端适配:本期不要求。
1.3 角色与权限
角色 能做什么 不能做什么 权限来源 内部用户(商务等) 新增登记表;查看、编辑(含改名称)、审核、删除自己创建的登记表(删除范围见 R-01-017);进入规则配置;查看和撤回自己提交的规则配置审批单(撤回不受权限点限制,R-01-037) 查看他人创建的登记表;删除待开户、已开户的登记表 权限点「客户登记管理」:一个点管全部内部动作,只能处理本人创建的登记表;没有该点时菜单不显示、直接访问显示「无权限访问」(R-01-037、D-00-70 、R-13-020 );不预设角色 客户 凭链接免登录填写、保存、提交 提交后再改;打开过期或已删除的链接 填写链接本身,没有账号
1.4 术语定义
术语 释义 归属者 创建这张登记表的内部账号。接收提交通知,列表数据也按它隔离。 填写链接 每张登记表一条独立的外部链接,客户凭它免登录填写。 有效期 从创建那一刻起算 48 或 72 小时。过期后链接 404;还没提交的登记表转为「已过期」。 审核 商务核对客户填的材料对不对,不是审批,不走审批流 (原型 客户登记表.html 注释第五节)。
1.5 核心流程
步骤 操作者 系统行为 产物 / 状态 1 商务 新增登记表:填名称、选有效期、选提交通知 → 创建并复制填写链接 登记表【待填写】 2 商务 把链接发给客户(线下) — 3 客户 免登录打开链接填写;系统每 1 分钟自动保存,也可以手动保存 草稿内容 4 客户 提交 → 二次确认 → 页面显示「提交成功,工作人员会尽快联系您」 【待审核】;通知归属者 5 商务 审核:可以改内容;点通过 / 不通过 通过 →【待关联】;不通过 →【未通过】(终止) 6 商务 在 04-客户管理把登记表关联到客户 【待开户】 7 商务 在 02-账户管理添加账户,选择这张登记表 【已开户】(终点) 支线 系统 创建满有效期还没提交 【已过期】,链接 404
2 详细需求
2.1 新增客户登记表弹窗
2.1.1 功能描述
点列表页的「新增客户登记表」打开。只填三项:登记表名称、链接有效期、提交通知。原型弹窗里的「投放应用」组件不做(D-01-07)。
2.1.2 核心字段
字段名 key 类型 必填 枚举/取值 默认值 规则说明 登记表名称 name string 是 长度沿用现有默认值(D-01-17) — 不去重,见 R-01-001 链接有效期 link_ttl_hours enum 是 48 / 72(小时) 48 见 R-01-002 提交通知 notify_channel enum 是 企业微信 / 邮箱 / 不通知 企业微信 见 R-01-003 通知邮箱 notify_email string 选「邮箱」时必填 邮箱格式 个人中心邮箱 见 R-01-004
2.1.3 业务规则
R-01-001 登记表名称必填,不做重名校验。R-01-002 链接有效期单选 48 小时 / 72 小时,默认 48 小时,从创建成功那一刻起算:到期时间 = 创建时间 + 有效期(D-01-05)。到了到期时间还是「待填写」的登记表,转为「已过期」;链接是否能打开见 R-01-028。R-01-003 提交通知单选企业微信 / 邮箱 / 不通知,默认企业微信。选企业微信时,当前账号已绑定企业微信就不展示任何输入框,也不展示绑定信息;未绑定时直接弹出个人中心的「绑定企业微信」弹窗,交互与广告管理里「添加监控」一致。R-01-004 选邮箱时展示邮箱输入框,自动回填个人中心里的邮箱,可以改。邮箱必填,并做简单邮箱格式校验。R-01-005 点「创建并复制填写链接」:创建登记表(状态待填写),把填写链接复制到剪贴板,关闭弹窗,弱提示「创建成功,已复制填写链接至剪贴板」。写剪贴板失败时按 R-01-038。R-01-006 选了企业微信,但绑定弹窗被关掉、仍未绑定时,不能创建,停留在新增弹窗。R-01-038 写剪贴板失败兜底(D-01-21):创建成功后(R-01-005)或在列表点「待填写」(R-01-013)时写剪贴板失败,弹出窗口显示「复制失败,请手动复制」、填写链接全文(可全选)和「复制」按钮,右上角 ✕ 关闭。创建场景下登记表照常创建,新增弹窗关闭,列表照常出现这一行。
2.1.5 异常与边界
场景 现象 系统行为 用户看到 名称为空 点创建 不创建 名称下方提示必填 选邮箱但邮箱格式错 点创建 不创建 邮箱下方提示格式错误 选企业微信但未绑定 关闭绑定弹窗后点创建 不创建(R-01-006) 再次弹出绑定企业微信弹窗 浏览器不允许写剪贴板 创建成功、复制失败 登记表照常创建(R-01-038) 「复制失败,请手动复制」弹窗,内含链接全文和「复制」按钮;之后也可在详情顶部复制(R-01-010) 连点创建 多次请求 只创建 1 张,由技术沿用现有防重复方案 一条成功提示
2.1.6 验收标准
G-01-001 前置:当前账号已绑定企业微信。操作:新增登记表,名称填「测试A」、有效期 48 小时、通知选企业微信,点创建并复制填写链接。期望:弹窗关闭,提示「创建成功,已复制填写链接至剪贴板」;剪贴板里是填写链接;列表顶部出现「测试A」,状态待填写。G-01-002 前置:当前账号未绑定企业微信。操作:新增弹窗选企业微信。期望:弹出个人中心的绑定企业微信弹窗;关掉绑定弹窗、不绑定再点创建,不生成登记表。G-01-003 前置:个人中心邮箱为 a@x.com。操作:新增弹窗选邮箱。期望:出现邮箱输入框并回填 a@x.com;改成「abc」点创建,提示邮箱格式错误、不创建。G-01-004 前置:已有一张名称为「测试A」的登记表。操作:再新增一张同名的。期望:创建成功,列表里有两张同名登记表,ID 不同。G-01-033 (验证 R-01-038、R-01-010)前置:技术模拟浏览器禁止写剪贴板;另有一张到期时间为 2026-10-18 10:00:00(北京时间)的已过期登记表 P。操作:①新增登记表「测试B」,点创建并复制填写链接;②在列表点「测试B」的状态「待填写」;③打开「测试B」的详情;④打开 P 的详情。期望:①「测试B」创建成功、出现在列表,并弹出「复制失败,请手动复制」窗口,内含完整填写链接(可全选)和「复制」按钮;②弹出同样的窗口;③详情顶部显示填写链接文本、「复制」按钮和链接到期时间(yyyy-mm-dd hh:mm:ss);④详情顶部显示「已于 2026-10-18 10:00:00 过期」,没有链接。
示意 1 新增客户登记表弹窗(默认态)mocks/2.1-新增弹窗/01-默认态.html
PC 1440
移动 375
全宽长图
新窗口打开
2.2 客户登记表列表
2.2.1 功能描述
导航「客户管理 → 客户登记表」进入(入口见 13-导航与权限)。页面顶部有「客户登记表 / 已提交审批」两个切换,默认在客户登记表;已提交审批见 2.4。本区块定义登记表状态机。
2.2.2 核心字段
列表展示字段:
字段名 key 类型 必填 枚举/取值 默认值 规则说明 登记表名称 name string 是 — — — 登记表ID registration_id string 是 系统生成,唯一 — 生成规则由技术定 关联客户 customer_id → 客户名称 关联对象 否 — 「-」 在 04 关联后展示;只能 1 个(D-01-15) 客户ID customer_id 关联对象 否 — 「-」 同上 所属账户系统 account_system 关联对象 否 — 「-」 在 02 绑定后展示 绑定账户 account_id → 账户名称 关联对象 否 — 「-」 在 02 绑定后展示 绑定账户ID account_id 关联对象 否 — 「-」 同上 状态 status enum 是 见 2.2.4 待填写 待填写时可点击复制链接(R-01-013) 创建时间 created_at datetime 是 北京时间,精确到秒 系统生成 列表只展示这个时间
只存、列表不展示的字段:
字段名 key 类型 必填 枚举/取值 默认值 规则说明 归属者 owner_user_id 关联对象 是 创建人 系统生成 隔离与通知用(R-01-008、R-01-032) 链接到期时间 expires_at datetime 是 存 UTC 系统生成 创建时间 + 有效期(R-01-002);列表不展示,待填写 / 已过期的详情顶部按北京时间展示(R-01-010) 提交时间 submitted_at datetime 否 北京时间,精确到秒 — 客户提交时写入 编辑时间 edited_at datetime 否 北京时间,精确到秒 — 内部编辑或审核保存时写入
2.2.3 业务规则
R-01-007 搜索框按登记表名称、登记表ID 包含匹配。R-01-008 列表只展示当前登录账号创建的登记表,账号之间互相看不到。R-01-009 状态筛选:全部 / 待填写 / 待审核 / 待关联 / 待开户 / 已开户 / 已过期 / 未通过,默认全部(D-01-01 新增未通过)。R-01-011 排序:待审核置顶;同组内按创建时间降序。R-01-012 列表字段:登记表名称、登记表ID、关联客户、客户ID、所属账户系统、绑定账户、绑定账户ID、状态、创建时间、操作。关联客户、客户ID 在 04 关联后展示;所属账户系统、绑定账户、绑定账户ID 在 02 绑定后展示;没关联时显示「-」。分页 10 / 50 / 100 / 300 条每页,展示总条数。R-01-013 状态为待填写时,状态文字可点击,点击复制填写链接,弱提示「已复制填写链接至剪贴板」;写剪贴板失败按 R-01-038。R-01-014 行操作按状态显示,不可操作的按钮直接隐藏:
操作 显示的状态 详情 全部状态 编辑 待填写(只改登记表名称,R-01-039)、待审核、待关联、待开户、已开户 审核 待审核 删除 待填写、待审核、待关联、已过期、未通过(R-01-017) 规则配置 待关联、待开户、已开户(D-01-08)
R-01-037 客户登记表的内部动作(进入列表、新增、详情、编辑、复制填写链接、审核、删除,以及从列表点「规则配置」)只用一个权限点「客户登记管理」控制(D-00-70 、R-13-020 )。有该点的人只能处理本人创建的登记表(R-01-008),各状态显示哪些按钮仍按 R-01-014。没有该点时:导航不显示「客户登记表」菜单;直接访问列表或登记表地址显示「无权限访问」;服务端对上述动作的请求同样校验并拒绝,不产生任何变更。权限被收回后,本人已创建的登记表不转移归属、不改状态,填写链接照常可填(按 R-01-028);创建人也删不了这些登记表(已知限制,见 §5,D-01-22)。规则配置页本身的访问与规则配置审批详情的查看沿用 03 的放开口径(D-03-22 、D-03-23 ),不受本条限制。撤回本人提交的规则配置审批单也不受本条限制:只校验申请人本人且单据审批中(D-00-79 ②、R-12-032 ),权限被收回后仍可在审批详情页撤回。
2.2.4 状态与流转
本页定义 「客户登记表」状态机。状态清单:待填写 / 待审核 / 待关联 / 待开户 / 已开户 / 已过期 / 未通过。初始状态:待填写。终止状态:已开户、已过期、未通过。
当前状态 触发动作 操作者 目标状态 前置条件 待填写 提交 客户(填写页) 待审核 未过期,且必填和格式校验通过(R-01-027) 待填写 到期 系统 已过期 当前时间 ≥ 到期时间(R-01-002) 待审核 审核通过 内部用户 待关联 R-01-015 待审核 审核不通过 内部用户 未通过 二次确认(R-01-016) 待关联 关联客户 内部用户(在 04-客户管理) 待开户 由 04 定义 待开户 添加账户并选择本登记表 内部用户(在 02-账户管理) 已开户 由 02 定义
逆向操作:
删除:还没关联客户的登记表(待填写、待审核、待关联、已过期、未通过)可以由创建人删除;有审批中的规则配置审批单时不能删;待开户、已开户不能删(等同解绑,D-01-16)。删除后列表不再展示,填写链接 404(R-01-017、D-01-18)。 退回客户修改:不支持。客户要重填,由商务新建登记表(D-01-01)。 创建人账号已禁用(离职):他的登记表别人在本页看不到(R-01-008)。待填写到期自动转已过期;待关联可由持「客户管理-读写」的人在 04 绑定下拉里选到并绑定(04 定义,R-04-057 );已知限制 :待审核的本期没有人能处理,客户需重新填写一张新登记表(D-01-18)。 解除客户、账户关联:本期没有解绑操作,不涉及状态回退(D-01-16)。 链接过期只影响客户能不能打开,已提交的登记表状态不变(R-01-028)。
2.2.5 异常与边界
场景 现象 系统行为 用户看到 当前账号没建过登记表 列表为空 — 空态 + 「新增客户登记表」按钮 搜索 / 筛选无结果 列表为空 — 空态「暂无数据」 列表加载失败 请求失败 不清空筛选条件 失败提示,可重试 列表打开期间状态被改变(客户提交、到期、被别处关联) 页面数据过时 操作时以服务端最新状态为准 操作不允许时提示「状态已变化,请刷新」,并刷新该行 没有「客户登记管理」权限点,或页面开着时权限被收回 直接访问或继续操作 服务端拒绝,不产生变更(R-01-037) 「无权限访问」 点删除时这张表已在 04 被关联客户(变为待开户) 确认删除 不删除(R-01-017) 「状态已变化,请刷新」,刷新该行 点删除时这张表有审批中的规则配置审批单 确认删除 不删除(R-01-017) 「该登记表有审批中的规则配置,请先撤回」
2.2.6 验收标准
G-01-005 前置:2026-10-16 10:00:00 创建、有效期 48 小时的待填写登记表。操作:2026-10-18 10:00:00 之后打开填写链接。期望:返回 404;列表里这张登记表状态为已过期,行操作只有详情、删除。G-01-006 前置:账号 A 创建了登记表 X。操作:账号 B 登录,打开客户登记表列表并搜索 X 的 ID。期望:搜不到 X。G-01-007 前置:列表里有 1 张待审核(最早创建)和 2 张待填写。操作:打开列表。期望:待审核那张排第一,其余按创建时间从新到旧。G-01-008 前置:每种状态的登记表各一张。操作:看行操作。期望:按 R-01-014 显示:待填写有详情、编辑、删除;待审核有详情、编辑、审核、删除;待关联有详情、编辑、删除、规则配置;待开户、已开户有详情、编辑、规则配置;已过期、未通过有详情、删除。G-01-009 前置:一张待填写的登记表。操作:点状态文字「待填写」。期望:填写链接复制到剪贴板,提示「已复制填写链接至剪贴板」。G-01-028 (验证 R-01-037)前置:甲有「客户登记管理」,乙没有;甲创建了待填写登记表 X(有效期内)和待审核登记表 Y。操作:①乙登录看「客户管理」导航,再直接打开客户登记表列表地址和 X 的详情地址;②甲登录打开列表;③收回甲的该权限点后,甲刷新页面并直接访问列表地址,客户用 X 的填写链接填写提交。期望:①乙看不到「客户登记表」菜单,两个地址都显示「无权限访问」;②甲只看到自己创建的 X、Y,行操作按 R-01-014 显示;③甲看不到菜单、直接访问显示「无权限访问」;X、Y 归属仍是甲、状态不变,客户提交成功后 X 变为待审核。
示意 2 客户登记表列表(默认态,覆盖各状态行操作)mocks/2.2-列表/01-默认态.html
PC 1440
移动 375
全宽长图
新窗口打开
2.3 详情 / 编辑 / 审核弹窗、删除、规则配置入口
2.3.1 功能描述
三个弹窗共用一套登记内容(字段见 2.5.2),只是按钮和是否可编辑不同:
弹窗 内容可编辑 底部按钮 详情 否 无 编辑 是:顶部登记表名称 + 登记内容;待填写只有登记表名称一项(R-01-039) 保存 审核 是:顶部登记表名称 + 登记内容 保存 / 审核通过 / 审核不通过
2.3.3 业务规则
R-01-010 详情、编辑、审核弹窗里的登记内容和填写页字段一致。详情只读,不展示底部按钮;编辑只有「保存」按钮。待填写状态打开详情,展示客户最近一次保存的内容,没保存过就是空的。详情顶部按状态多显示一行(D-01-21):待填写 → 填写链接文本 + 「复制」按钮(复制失败按 R-01-038)+ 链接到期时间(北京时间 yyyy-mm-dd hh:mm:ss);已过期 → 「已于 {到期时间} 过期」(同一格式);其他状态不显示。登记内容的只读展示格式(本页详情,以及引用本条的 02 预览 R-02-022 、04 客户材料绑定行详情 R-04-060 都按此):日预算千分位 + 2 位小数(如 5,000.00);KPI要求、备注等多行文本完整展示、保留换行,不截断。编辑、审核弹窗的输入框里日预算不加千分位。R-01-015 审核弹窗顶部是登记表名称(R-01-039),下面是登记内容,都可以编辑;按钮为保存 / 审核通过 / 审核不通过。点保存只保存,不关闭弹窗。点审核通过时,先保存当前内容(按 R-01-018 校验),再把状态改为待关联,关闭弹窗。R-01-016 点审核不通过要二次确认,确认后状态改为未通过(终止)。不需要填原因,也不通知客户(D-01-01、D-01-13)。R-01-017 删除(D-01-18):创建人可以删除还没关联客户的登记表,即待填写、待审核、待关联、已过期、未通过;待开户、已开户不能删(等同解绑,D-01-16)。删除前二次确认:待填写的确认文案为「删除后客户将无法再打开填写链接,已填写的内容一并删除,确认删除吗?」,其他状态沿用现有删除确认。服务端在确认后按最新数据校验:状态仍在可删范围、创建人是当前账号、这张表没有审批中的规则配置审批单。有审批中的规则配置审批单 → 不删,提示「该登记表有审批中的规则配置,请先撤回」;状态已变为待开户 / 已开户 → 不删,提示「状态已变化,请刷新」并刷新该行。删除成功后这张登记表从列表消失,填写链接 404(R-01-028);客户正开着填写页的,下一次保存(含自动保存)或提交失败,页面转为 404(R-01-030)。这张表已结束的规则配置审批单仍保留在「已提交审批」和审批中心,可照常打开详情:登记表名称取删除时的名称,并标「(已删除)」;审批内容区的公司、所属账户系统、关联账户显示「暂未关联」(R-03-048 );查看范围里的创建人按删除时判断(R-03-050 )(D-01-22)。R-01-018 内部编辑、审核弹窗保存时不改变状态,也不同步到已关联的客户、账户(D-01-06)。保存和审核通过时校验(D-01-14):登记表名称必填(R-01-001);R-01-027 列出的必填项;格式 R-01-023、R-01-026。不校验 R-01-025 的日期下限 :产品投放日期可以是任意日期,日期选择器不禁用过去的日子(D-01-20)。服务端按同一口径校验。待填写的编辑弹窗只校验登记表名称必填(R-01-039)。R-01-019 点「规则配置」打开这张登记表的规则配置页;页面内容、提交审批规则由 03-规则配置定义。R-01-039 改名称(D-01-19):登记表名称在待填写、待审核、待关联、待开户、已开户都可以改。待填写点「编辑」打开的弹窗只有「登记表名称」一项(登记内容由客户在填,内部不改,避免和客户的自动保存互相覆盖);其他状态的编辑、审核弹窗顶部是「登记表名称」输入框。名称必填、不做重名校验(R-01-001)。改名不改状态、不改有效期。本页列表与「已提交审批」、02 添加账户的登记表下拉与编辑弹窗、04 客户材料等显示登记表名称的地方,一律取当前名称;登记表已删除的,审批单上按 R-01-017 取删除时的名称并标「(已删除)」。
2.3.5 异常与边界
场景 现象 系统行为 用户看到 编辑 / 审核保存时有必填为空或格式错 点保存 / 审核通过 不保存、不改状态 对应字段下方提示 审核时这张表已被别人或别的标签页处理过 点审核通过 / 不通过 以服务端状态为准,不重复流转 提示「状态已变化,请刷新」 编辑已开户的登记表 改投放类型等字段 只改登记表本身 已绑定账户上的值不变(G-01-023) 审核时客户填的投放日期已过 点审核通过 不拦(R-01-018) 审核通过 编辑 / 审核时登记表名称被清空 点保存 / 审核通过 不保存、不改状态 名称下方提示必填 待填写改名时客户正在填写 客户自动保存 名称与登记内容分开保存,互不覆盖(R-01-039) —
2.3.6 验收标准
G-01-019 前置:一张待审核的登记表。操作:打开审核弹窗,改 KPI 要求后点保存。期望:弹窗不关闭,内容已保存,状态仍是待审核。G-01-020 前置:一张待审核的登记表。操作:点审核通过。期望:状态变为待关联,弹窗关闭;行操作出现规则配置。G-01-021 前置:一张待审核的登记表。操作:点审核不通过并确认。期望:状态变为未通过;行操作只剩详情、删除;有效期内客户再打开链接,看到「提交成功,工作人员会尽快联系您」。G-01-022 前置:一张已过期的登记表。操作:点删除并确认。期望:列表不再显示这张登记表;它的填写链接 404。G-01-029 (验证 R-01-017)前置:当前账号创建了待填写登记表 A(有效期内,客户已保存过部分内容、填写页还开着)、待审核 B、待关联 C(没有审批中的规则配置审批单)。操作:①对 A 点删除;②确认;③客户在开着的填写页点保存;④对 B、C 分别点删除并确认。期望:①确认框文案为「删除后客户将无法再打开填写链接,已填写的内容一并删除,确认删除吗?」;②A 从列表消失;③保存失败,页面转为 404,重新打开 A 的链接也是 404;④B、C 从列表消失,链接 404。G-01-030 (验证 R-01-017)前置:当前账号创建的待关联登记表 E 有一张审批中的规则配置审批单;另一张待关联登记表 H 在本页打开期间被 04 关联到客户(变为待开户)。操作:①对 E 点删除并确认;②撤回 E 的审批单后再删除 E;③对 H 点删除并确认。期望:①不删除,提示「该登记表有审批中的规则配置,请先撤回」,E 仍在列表;②删除成功;③不删除,提示「状态已变化,请刷新」,H 刷新为待开户、没有删除按钮。G-01-031 (验证 R-01-039)前置:待填写登记表 A,名称「测试A」;已开户登记表 F,名称「F-旧」,绑定账户 Acc1、关联客户 K,有一张已通过的规则配置审批单。操作:①对 A 点编辑,改名为「测试A-改」保存;②对 F 点编辑,把顶部登记表名称改为「F-新」保存。期望:①编辑弹窗只有登记表名称一项;保存后列表显示「测试A-改」,状态仍为待填写;②F 仍为已开户;本页「已提交审批」里 F 的审批单、02 账户 Acc1 编辑弹窗的登记表一栏、04 客户 K 客户材料的登记表行都显示「F-新」。G-01-032 (验证 R-01-015、R-01-018)前置:今天为 2026-10-21;待审核登记表 M,客户填的产品投放日期为 2026-10-18;待关联登记表 N。操作:①打开 M 的审核弹窗,不改日期直接点审核通过;②打开 N 的编辑弹窗,在日期选择器里选 2026-10-10 后保存。期望:①审核通过,M 变为待关联,不提示日期错误;②2026-10-10 可选,保存成功,不提示日期错误。G-01-035 (验证 R-01-010)前置:登记表 X 日预算为 5000,KPI要求为 3 行文本,已绑定账户 Acc1。操作:①本页打开 X 的详情;②在 02 预览 Acc1 的登记表;③本页打开 X 的编辑弹窗。期望:①②日预算显示 5,000.00,KPI要求 3 行完整显示、保留换行;③日预算输入框里不带千分位分隔符。G-01-023 前置:一张已开户的登记表,已绑定账户的投放类型为代投。操作:内部编辑登记表,把投放类型改成自投并保存。期望:登记表状态仍是已开户;账户的投放类型仍是代投。G-01-024 前置:一张待填写的登记表,客户保存过签约主体名称。操作:内部点详情。期望:只读展示客户保存的内容,没有底部按钮。
示意 3 审核弹窗(默认态)mocks/2.3-审核弹窗/01-默认态.html
PC 1440
移动 375
全宽长图
新窗口打开
2.4 已提交审批 tab
2.4.1 功能描述
列出当前账号提交过的客户登记表规则配置审批单。审批单从 03-规则配置提交;审批详情页的通用框架和撤回规则归 12-审批配置与审批中心,审批记录内容归 03。行为和客户管理的「已提交审批」保持一致(D-01-11)。
2.4.2 核心字段
字段名 key 类型 必填 枚举/取值 默认值 规则说明 审批单号 — string 是 审批单号 — 由 12 生成 客户登记表 — string 是 登记表名称 — — 操作对象 — enum 是 规则配置 规则配置 本期固定 申请人 — 关联对象 是 — — — 申请时间 — datetime 是 北京时间,精确到秒 — — 审批状态 — enum 是 审批中 / 已通过 / 已驳回 / 已撤回 — 状态机由 12 定义
2.4.3 业务规则
R-01-033 列表页顶部有「客户登记表 / 已提交审批」两个切换;已提交审批只展示当前账号提交的客户登记表规则配置审批单,含免审单(0 节点或节点全部跳过、提交即已通过的单,状态显示已通过,R-12-018 )。只含在线登记表的规则配置单;04 历史上传文件 / 迁移占位行的规则单不在此(R-03-053 )。R-01-034 搜索按审批单号、登记表名称;状态筛选全部 / 审批中 / 已通过 / 已驳回 / 已撤回,默认全部。R-01-035 列表字段:审批单号、客户登记表(名称;登记表已删除的取删除时的名称并标「(已删除)」,R-01-017)、操作对象(固定「规则配置」)、申请人、申请时间、审批状态、操作。排序:审批中置顶,其余按申请时间降序。R-01-036 行操作:所有状态都有「详情」,新页打开这张审批单的审批详情(通用框架见 12,记录内容见 03);只有审批中有「撤回」;撤回只校验申请人本人且单据审批中,不校验「客户登记管理」等业务权限点(D-00-79 ②、R-12-032 );撤回的确认文案和后果按 12-审批配置与审批中心的统一定义,与客户管理的已提交审批一致(D-01-11)。
2.4.5 异常与边界
场景 现象 系统行为 用户看到 没提交过审批 列表为空 — 空态「暂无数据」 点撤回时审批已经结束 状态已不是审批中 不撤回 按 12 的统一提示,刷新该行
2.4.6 验收标准
G-01-025 前置:当前账号提交过 3 张规则配置审批单(审批中、已通过、已驳回各一张)。操作:切换到已提交审批。期望:审批中那张排第一,其余按申请时间降序;操作对象列都显示「规则配置」;只有审批中那张有撤回;三张都有详情。
示意 4 已提交审批 tab(默认态)mocks/2.4-已提交审批/01-默认态.html
PC 1440
移动 375
全宽长图
新窗口打开
2.5 对外填写页
2.5.1 功能描述
客户凭链接免登录打开的外部页面,标题「ASA 投放产品信息登记」。客户在这里填写、保存、提交。内部的详情、编辑、审核弹窗用的也是这套字段。
2.5.2 核心字段(登记内容)
字段名 key 类型 必填 枚举/取值 默认值 规则说明 签约主体名称 contract_entity string 是 长度沿用现有默认值(D-01-17) — 单行输入框,R-01-021;客户自由填写的文本,和 04 客户上的「伙伴云签约主体」(枚举)不是同一个字段,同名 key 由技术区分 投放产品 product_app 关联对象(应用名称 + 应用ID) 是 只能 1 个 — R-01-022 参考竞品 competitor_apps 列表(应用名称 + 应用ID) 否 可多个,不重复 — R-01-022 苹果账户邮箱 apple_account_email string 是 邮箱格式 — R-01-023 ASC关联邮箱 asc_email string 是 邮箱格式 — R-01-023 投放类型 delivery_type enum 是 代投 / 自投 无 单选;02 添加账户时回填 产品投放日期 launch_date date 是 填写页:今天及以后(客户浏览器本地日期);内部弹窗:任意日期 — 日期下限仅填写页校验(R-01-025、R-01-018) 产品投放地区 regions 列表 是 可多选、可搜索 — 地区清单沿用现有地区选择组件 日预算 daily_budget decimal(2) 是 > 0,最多 2 位小数,不带币种 — R-01-026 KPI要求 kpi text 是 长度沿用现有默认值(D-01-17) — 多行输入框 三方归因平台 attribution_platform string 否 — — 单行输入框 备注 remark text 否 长度沿用现有默认值(D-01-17) — 多行输入框 最近保存时间 draft_saved_at datetime 否 存 UTC,按客户浏览器本地时间展示,精确到秒 — R-01-024
2.5.3 业务规则
R-01-020 每张登记表有独立的填写链接,免登录访问;链接不能被猜到,具体生成方式由技术定。R-01-028 链接只在有效期内能访问,过了到期时间一律 404,和登记表状态无关。有效期内:待填写 → 进填写页;已提交过(待审核 / 待关联 / 待开户 / 已开户 / 未通过)→ 展示「提交成功,工作人员会尽快联系您」,不能编辑;已删除或链接不存在 → 404(D-01-04、D-01-09)。链接过期只影响访问,已提交的登记表状态不变。R-01-021 签约主体名称为单行输入框。R-01-022 投放产品和参考竞品都用应用搜索选择(应用名称 + 应用ID,搜索数据源沿用现有应用搜索)。投放产品只能 1 个,再选会替换。参考竞品可多选,选中后弱提示「选择成功」,并在输入框下方追加这个应用;同一应用不重复添加,已添加的可以移除。另有三条(D-01-21):①应用搜索的商店地区默认值按浏览器语言:zh 开头默认中国大陆,其他默认美国,可以手动切换;商店地区只影响搜索结果,不保存,和「产品投放地区」无关。②搜索结果下拉里的按钮文案和字段名一致:投放产品为「设为投放产品」,参考竞品为「添加为参考竞品」;英文版按 R-01-031 翻成同一套词。③同一应用不能既是投放产品又是参考竞品:已选为一方的应用,在另一方的搜索结果里按钮置灰,提示「已选为投放产品」/「已添加为参考竞品」。内部编辑、审核弹窗用同一个组件,规则相同。R-01-023 苹果账户邮箱、ASC关联邮箱做简单邮箱格式校验(含 @ 和域名后缀)。R-01-025 产品投放日期选单日,今天之前的日期不能选(「今天」按客户浏览器本地日期);选择器下方提示「建议提前预留 2-3 天」。本条只在客户填写页生效;内部编辑、审核弹窗不校验日期下限(R-01-018)。R-01-026 日预算只填数字,必须大于 0,最多 2 位小数,不带币种(D-01-10)。R-01-024 「保存」和每 1 分钟一次的自动保存,只保存当前内容,不提交,也不校验必填和格式(D-01-14)。保存成功后页面顶部显示「yyyy-mm-dd hh:mm:ss 已保存」(客户浏览器本地时间)。再次打开链接时,回显最近一次保存的内容。有未保存的修改(最近一次修改晚于最近一次成功保存)时,关闭、刷新、离开页面由浏览器弹出默认的离开确认(文案由浏览器决定,不自定义);没有未保存的修改、提交成功后、页面已转为 404 时不弹(D-01-21)。R-01-027 提交时校验全部必填项(签约主体名称、投放产品、苹果账户邮箱、ASC关联邮箱、投放类型、产品投放日期、产品投放地区、日预算、KPI要求)和格式(R-01-023、R-01-025、R-01-026)。不通过就不发起提交,在对应字段下方提示。R-01-029 校验通过后二次确认「请确认是否提交?」。确认后状态改为待审核、写入提交时间,页面展示「提交成功,工作人员会尽快联系您」。R-01-030 提交或保存时登记表已经过期或已被删除(R-01-017):提交 / 保存失败,页面转为 404。R-01-031 页面语言跟随客户浏览器:浏览器语言以 zh 开头时显示简体中文,其他一律英文;不提供手动切换。影响范围包括字段名、输入框提示、地区名、提示语、确认框和提交成功文案。
2.5.5 异常与边界
场景 现象 系统行为 用户看到 链接过期 / 已删除 / 不存在 打开链接 — 404(R-01-028) 有效期内、已提交 打开链接 不可编辑 「提交成功,工作人员会尽快联系您」 填写中途到期,或登记表被商务删除 点保存、提交,或自动保存触发 保存 / 提交失败 404(R-01-030、G-01-026、G-01-029) 有未保存的修改时关闭 / 刷新 / 离开 浏览器离开事件 弹浏览器默认离开确认(R-01-024) 浏览器默认文案 自动保存失败(网络) 请求失败 保留页面上已填内容,下一分钟再试 顶部仍显示上次成功的保存时间 提交时网络失败 请求失败 状态不变 提示「网络异常,请重试」,已填内容保留 同一链接在两个窗口填写 两边都保存 以最后一次保存为准,由技术沿用现有方案 — 连点提交 多次请求 只流转一次 提交成功页
2.5.6 验收标准
G-01-010 前置:客户打开有效链接,填了签约主体名称后停留 1 分钟以上不操作。操作:关掉页面,再打开同一链接。期望:签约主体名称回显;页面顶部显示最近保存时间;登记表仍为待填写。G-01-011 前置:客户打开有效链接,只填签约主体名称。操作:点保存。期望:保存成功并显示保存时间,不提示必填缺失。G-01-012 前置:客户打开有效链接,除日预算外的必填都已填。操作:点提交。期望:不弹二次确认,日预算下方提示必填。G-01-013 前置:客户打开有效链接。操作:日预算分别填 0、-1、10.123、100.5。期望:0、-1、10.123 提交时提示格式错误;100.5 校验通过。G-01-014 前置:客户打开有效链接,所有必填项都合法。操作:点提交,在二次确认中点确定。期望:页面显示「提交成功,工作人员会尽快联系您」;列表里这张登记表变为待审核并置顶;归属者按通知方式收到「您创建的{客户登记表名称}客户已提交,请前往审核。」G-01-015 前置:登记表已提交(待审核)且在有效期内。操作:客户再打开填写链接。期望:显示「提交成功,工作人员会尽快联系您」,没有任何可编辑项。G-01-016 前置:客户浏览器语言为 en-US。操作:打开有效链接。期望:字段名、输入框提示、地区名、按钮、确认框、提交成功文案都是英文;浏览器语言为 zh-CN 时都是简体中文。G-01-017 前置:客户打开有效链接。操作:在产品投放日期选择器里点昨天。期望:昨天及之前的日期不可选。G-01-018 前置:客户打开有效链接。操作:投放产品先选应用 A 再选应用 B;参考竞品选 C、D,再选 C。期望:投放产品只剩 B;参考竞品为 C、D,C 不重复;每次选中竞品都提示「选择成功」。接着:在参考竞品里搜 B、在投放产品里搜 C,B、C 的按钮置灰,分别提示「已选为投放产品」「已添加为参考竞品」;按钮文案分别为「添加为参考竞品」「设为投放产品」;浏览器语言 zh-CN 时商店地区默认中国大陆,en-US 时默认美国,切换后不影响「产品投放地区」的已填值。G-01-026 前置:客户打开有效链接,填完所有必填,这时刚好过了有效期。操作:点提交并确认。期望:提交失败,页面变为 404;登记表状态为已过期。G-01-027 前置:2026-10-16 10:00:00 创建、有效期 48 小时,客户当天已提交(待审核)。操作:2026-10-18 10:00:00 之后客户再打开填写链接。期望:返回 404;列表里这张登记表状态仍为待审核。G-01-034 (验证 R-01-024)前置:客户打开有效链接。操作:①改了 KPI 要求,未到自动保存、也没点保存,就关闭标签页;②再打开,改动后点保存成功,再关闭;③填完提交成功后关闭。期望:①浏览器弹出默认离开确认;②③不弹。
示意 5 填写页(填写中,已自动保存)mocks/2.5-填写页/01-填写中.html
PC 1440
移动 375
全宽长图
新窗口打开
示意 6 填写页(提交校验失败)mocks/2.5-填写页/02-校验失败.html
PC 1440
移动 375
全宽长图
新窗口打开
示意 7 填写页(提交成功 / 有效期内再次打开)mocks/2.5-填写页/03-提交成功.html
PC 1440
移动 375
全宽长图
新窗口打开
2.6 提交通知
2.6.1 功能描述
客户提交后,按登记表创建时选的提交通知方式通知归属者去审核。
2.6.3 业务规则
R-01-032 客户提交成功后,按这张登记表的提交通知方式通知归属者:企业微信发到归属者绑定的企业微信,邮箱发到创建时填的邮箱,选了不通知就不发。内容:「您创建的{客户登记表名称}客户已提交,请前往审核。」通知发送失败不影响提交结果。
2.6.5 异常与边界
场景 现象 系统行为 用户看到 归属者创建后解绑了企业微信 企业微信发不出去 不影响提交,不改发邮箱 客户照常看到提交成功;归属者在列表里看到待审核置顶 邮件发送失败 发不出去 不影响提交,重试策略由技术沿用现有通知方案 同上
2.6.6 验收标准
通知内容和送达按 G-01-014 验收。
3 变更影响面
被影响对象 影响方式 处理动作 负责人 02-账户管理 添加账户时选择登记表 → 登记表待开户 → 已开户;投放类型只在添加时回填一次(D-01-06);登记表名称取当前名(R-01-039);预览的只读格式按 R-01-010 02 引用本页状态机与 R-01-010 02 包 04-客户管理 关联登记表 → 登记表待关联 → 待开户;去掉客户列表行上的「规则配置」入口(D-01-03);客户材料登记表行新增入口(R-04-060 );绑定行详情格式按 R-01-010、名称取当前名(R-01-039);创建人账号已禁用的待关联登记表由「客户管理-读写」的人在绑定下拉里选到(D-01-18,04 R-04-057 / R-04-058 写例外) 04 引用本页状态机 04 包 03-规则配置 入口从本页行操作进入;审批单在本页「已提交审批」列出;有审批中规则配置单的登记表不能删除(R-01-017) 03 定义页面和审批记录内容 03 包 12-审批配置与审批中心 本页审批单的详情框架、撤回(只校验申请人本人 + 审批中,D-00-79 ②);免审单照常出现在「已提交审批」(R-12-018 ) 12 统一定义 12 包 13-导航与权限 客户管理下新增「客户登记表」入口;已定:本页全部内部动作只用一个权限点「客户登记管理」,只能处理本人创建的登记表(D-00-70 、R-01-037) 13 按 R-13-020 汇总 13 包
4 决策记录
完整字段以 spec.yaml decisions 为准。
编号 结论 状态 D-01-01 审核不通过进入未通过(终止),可删除;重填由商务新建登记表 已定 D-01-02 规则配置页与审批记录内容归 03;本页只有入口和「已提交审批」列表 已定 D-01-03 客户列表行上的规则配置入口不做;入口在本页列表和 04 客户材料绑定行 已定 D-01-04 链接找不到直接 404 已定 D-01-05 有效期从创建时起算 已定 D-01-06 编辑登记表不同步客户 / 账户、不改状态 已定 D-01-07 新增弹窗的投放应用组件不做 已定 D-01-08 规则配置按钮在待关联、待开户、已开户显示 已定 D-01-09 有效期内已提交(含未通过)显示提交成功只读页;过期一律 404(2026-10-21 会议清单附 1 B5 维持) 已定 D-01-10 日预算只填数字、> 0、最多 2 位小数、不带币种 已定 D-01-11 已提交审批只看本账号提交的;全状态有详情;仅审批中可撤回 已定 D-01-12 有效期默认 48 小时、通知默认企业微信 已定 D-01-13 审核不通过、删除需二次确认;不通过不填原因、不通知客户 已定 D-01-14 保存与自动保存不校验;提交、内部编辑 / 审核保存时校验(日期下限见 D-01-20) 已定 D-01-15 一张登记表只关联 1 个客户、绑定 1 个账户 已定 D-01-16 本期没有解绑,不涉及状态回退 已定 D-01-17 文本长度沿用现有默认值 已定 D-01-18 未关联客户的登记表(待填写 / 待审核 / 待关联 / 已过期 / 未通过)创建人可删,有审批中规则配置单不能删;创建人已禁用的待关联表由 04 读写用户绑定;创建人已禁用的待审核表列为已知限制(R-01-017) 已定 D-01-19 登记表名称待填写~已开户可改,各处取当前名;有效期、通知方式不能改(R-01-039) 已定 D-01-20 内部编辑 / 审核不校验投放日期下限,只在填写页校验(R-01-018、R-01-025) 已定 D-01-21 复制失败兜底与详情显示链接 / 到期时间(R-01-038、R-01-010);只读展示格式(R-01-010);应用搜索三条(R-01-022);填写页离开确认(R-01-024) 已定 D-01-22 已删除登记表的审批单:名称取删除时的名称并标「(已删除)」,公司 / 账户系统 / 关联账户显示「暂未关联」,查看范围的创建人按删除时判断(R-01-017、R-01-035);收回「客户登记管理」后创建人删不了自己的登记表,列为已知限制(2026-10-22 用户与技术确认,闭环清单 B19、B18) 已定
5 开放问题与已知限制
暂无开放问题。一张登记表只对应 1 个客户、1 个账户(D-01-15);本期没有解绑(D-01-16);文本长度沿用现有默认值(D-01-17)。
已知限制:
创建人账号已禁用的待审核登记表,本期没有人能处理,客户需重新填写一张新登记表(D-01-18)。 收回「客户登记管理」后,创建人删不了自己的登记表(R-01-037,D-01-22)。