客户登记

v2.1.0 01-客户登记 ASA 状态:待评审 2026-10-16 评审版 · 由 PRD.md 自动生成,勿手改

客户登记 PRD

项内容
所属产品ASA
版本v2.1.0
页面01-客户登记
涉及功能客户登记
编制日期2026-10-16
文档状态待评审
目标读者研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据)
关联文档本目录 spec.yaml、mocks/;版本 index.md;原型 html/客户登记表.html、html/客户登记表填写页面.html

0 前置说明

1 整体概述

1.1 背景与目标

现状:客户开户前的投放信息靠线下收集,商务没法统一跟进。目标:商务在系统里建一张登记表,把链接发给客户;客户免登录填写提交,商务审核后,在客户管理里关联客户、在账户管理里开户,登记表状态跟着走到「已开户」。商务在列表里随时能看到每张表卡在哪一步。

1.2 本页范围

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类型必填枚举/取值默认值规则说明
登记表名称namestring是长度沿用现有默认值(D-01-17)—不去重,见 R-01-001
链接有效期link_ttl_hoursenum是48 / 72(小时)48见 R-01-002
提交通知notify_channelenum是企业微信 / 邮箱 / 不通知企业微信见 R-01-003
通知邮箱notify_emailstring选「邮箱」时必填邮箱格式个人中心邮箱见 R-01-004

2.1.3 业务规则

2.1.5 异常与边界

场景现象系统行为用户看到
名称为空点创建不创建名称下方提示必填
选邮箱但邮箱格式错点创建不创建邮箱下方提示格式错误
选企业微信但未绑定关闭绑定弹窗后点创建不创建(R-01-006)再次弹出绑定企业微信弹窗
浏览器不允许写剪贴板创建成功、复制失败登记表照常创建(R-01-038)「复制失败,请手动复制」弹窗,内含链接全文和「复制」按钮;之后也可在详情顶部复制(R-01-010)
连点创建多次请求只创建 1 张,由技术沿用现有防重复方案一条成功提示

2.1.6 验收标准

示意 1新增客户登记表弹窗(默认态)mocks/2.1-新增弹窗/01-默认态.html

2.2 客户登记表列表

2.2.1 功能描述

导航「客户管理 → 客户登记表」进入(入口见 13-导航与权限)。页面顶部有「客户登记表 / 已提交审批」两个切换,默认在客户登记表;已提交审批见 2.4。本区块定义登记表状态机。

2.2.2 核心字段

列表展示字段:

字段名key类型必填枚举/取值默认值规则说明
登记表名称namestring是———
登记表IDregistration_idstring是系统生成,唯一—生成规则由技术定
关联客户customer_id → 客户名称关联对象否—「-」在 04 关联后展示;只能 1 个(D-01-15)
客户IDcustomer_id关联对象否—「-」同上
所属账户系统account_system关联对象否—「-」在 02 绑定后展示
绑定账户account_id → 账户名称关联对象否—「-」在 02 绑定后展示
绑定账户IDaccount_id关联对象否—「-」同上
状态statusenum是见 2.2.4待填写待填写时可点击复制链接(R-01-013)
创建时间created_atdatetime是北京时间,精确到秒系统生成列表只展示这个时间

只存、列表不展示的字段:

字段名key类型必填枚举/取值默认值规则说明
归属者owner_user_id关联对象是创建人系统生成隔离与通知用(R-01-008、R-01-032)
链接到期时间expires_atdatetime是存 UTC系统生成创建时间 + 有效期(R-01-002);列表不展示,待填写 / 已过期的详情顶部按北京时间展示(R-01-010)
提交时间submitted_atdatetime否北京时间,精确到秒—客户提交时写入
编辑时间edited_atdatetime否北京时间,精确到秒—内部编辑或审核保存时写入

2.2.3 业务规则

操作显示的状态
详情全部状态
编辑待填写(只改登记表名称,R-01-039)、待审核、待关联、待开户、已开户
审核待审核
删除待填写、待审核、待关联、已过期、未通过(R-01-017)
规则配置待关联、待开户、已开户(D-01-08)

2.2.4 状态与流转

本页定义「客户登记表」状态机。状态清单:待填写 / 待审核 / 待关联 / 待开户 / 已开户 / 已过期 / 未通过。初始状态:待填写。终止状态:已开户、已过期、未通过。

当前状态触发动作操作者目标状态前置条件
待填写提交客户(填写页)待审核未过期,且必填和格式校验通过(R-01-027)
待填写到期系统已过期当前时间 ≥ 到期时间(R-01-002)
待审核审核通过内部用户待关联R-01-015
待审核审核不通过内部用户未通过二次确认(R-01-016)
待关联关联客户内部用户(在 04-客户管理)待开户由 04 定义
待开户添加账户并选择本登记表内部用户(在 02-账户管理)已开户由 02 定义

逆向操作:

2.2.5 异常与边界

场景现象系统行为用户看到
当前账号没建过登记表列表为空—空态 + 「新增客户登记表」按钮
搜索 / 筛选无结果列表为空—空态「暂无数据」
列表加载失败请求失败不清空筛选条件失败提示,可重试
列表打开期间状态被改变(客户提交、到期、被别处关联)页面数据过时操作时以服务端最新状态为准操作不允许时提示「状态已变化,请刷新」,并刷新该行
没有「客户登记管理」权限点,或页面开着时权限被收回直接访问或继续操作服务端拒绝,不产生变更(R-01-037)「无权限访问」
点删除时这张表已在 04 被关联客户(变为待开户)确认删除不删除(R-01-017)「状态已变化,请刷新」,刷新该行
点删除时这张表有审批中的规则配置审批单确认删除不删除(R-01-017)「该登记表有审批中的规则配置,请先撤回」

2.2.6 验收标准

示意 2客户登记表列表(默认态,覆盖各状态行操作)mocks/2.2-列表/01-默认态.html

2.3 详情 / 编辑 / 审核弹窗、删除、规则配置入口

2.3.1 功能描述

三个弹窗共用一套登记内容(字段见 2.5.2),只是按钮和是否可编辑不同:

弹窗内容可编辑底部按钮
详情否无
编辑是:顶部登记表名称 + 登记内容;待填写只有登记表名称一项(R-01-039)保存
审核是:顶部登记表名称 + 登记内容保存 / 审核通过 / 审核不通过

2.3.3 业务规则

2.3.5 异常与边界

场景现象系统行为用户看到
编辑 / 审核保存时有必填为空或格式错点保存 / 审核通过不保存、不改状态对应字段下方提示
审核时这张表已被别人或别的标签页处理过点审核通过 / 不通过以服务端状态为准,不重复流转提示「状态已变化,请刷新」
编辑已开户的登记表改投放类型等字段只改登记表本身已绑定账户上的值不变(G-01-023)
审核时客户填的投放日期已过点审核通过不拦(R-01-018)审核通过
编辑 / 审核时登记表名称被清空点保存 / 审核通过不保存、不改状态名称下方提示必填
待填写改名时客户正在填写客户自动保存名称与登记内容分开保存,互不覆盖(R-01-039)—

2.3.6 验收标准

示意 3审核弹窗(默认态)mocks/2.3-审核弹窗/01-默认态.html

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 业务规则

2.4.5 异常与边界

场景现象系统行为用户看到
没提交过审批列表为空—空态「暂无数据」
点撤回时审批已经结束状态已不是审批中不撤回按 12 的统一提示,刷新该行

2.4.6 验收标准

示意 4已提交审批 tab(默认态)mocks/2.4-已提交审批/01-默认态.html

2.5 对外填写页

2.5.1 功能描述

客户凭链接免登录打开的外部页面,标题「ASA 投放产品信息登记」。客户在这里填写、保存、提交。内部的详情、编辑、审核弹窗用的也是这套字段。

2.5.2 核心字段(登记内容)

字段名key类型必填枚举/取值默认值规则说明
签约主体名称contract_entitystring是长度沿用现有默认值(D-01-17)—单行输入框,R-01-021;客户自由填写的文本,和 04 客户上的「伙伴云签约主体」(枚举)不是同一个字段,同名 key 由技术区分
投放产品product_app关联对象(应用名称 + 应用ID)是只能 1 个—R-01-022
参考竞品competitor_apps列表(应用名称 + 应用ID)否可多个,不重复—R-01-022
苹果账户邮箱apple_account_emailstring是邮箱格式—R-01-023
ASC关联邮箱asc_emailstring是邮箱格式—R-01-023
投放类型delivery_typeenum是代投 / 自投无单选;02 添加账户时回填
产品投放日期launch_datedate是填写页:今天及以后(客户浏览器本地日期);内部弹窗:任意日期—日期下限仅填写页校验(R-01-025、R-01-018)
产品投放地区regions列表是可多选、可搜索—地区清单沿用现有地区选择组件
日预算daily_budgetdecimal(2)是> 0,最多 2 位小数,不带币种—R-01-026
KPI要求kpitext是长度沿用现有默认值(D-01-17)—多行输入框
三方归因平台attribution_platformstring否——单行输入框
备注remarktext否长度沿用现有默认值(D-01-17)—多行输入框
最近保存时间draft_saved_atdatetime否存 UTC,按客户浏览器本地时间展示,精确到秒—R-01-024

2.5.3 业务规则

2.5.5 异常与边界

场景现象系统行为用户看到
链接过期 / 已删除 / 不存在打开链接—404(R-01-028)
有效期内、已提交打开链接不可编辑「提交成功,工作人员会尽快联系您」
填写中途到期,或登记表被商务删除点保存、提交,或自动保存触发保存 / 提交失败404(R-01-030、G-01-026、G-01-029)
有未保存的修改时关闭 / 刷新 / 离开浏览器离开事件弹浏览器默认离开确认(R-01-024)浏览器默认文案
自动保存失败(网络)请求失败保留页面上已填内容,下一分钟再试顶部仍显示上次成功的保存时间
提交时网络失败请求失败状态不变提示「网络异常,请重试」,已填内容保留
同一链接在两个窗口填写两边都保存以最后一次保存为准,由技术沿用现有方案—
连点提交多次请求只流转一次提交成功页

2.5.6 验收标准

示意 5填写页(填写中,已自动保存)mocks/2.5-填写页/01-填写中.html
示意 6填写页(提交校验失败)mocks/2.5-填写页/02-校验失败.html
示意 7填写页(提交成功 / 有效期内再次打开)mocks/2.5-填写页/03-提交成功.html

2.6 提交通知

2.6.1 功能描述

客户提交后,按登记表创建时选的提交通知方式通知归属者去审核。

2.6.3 业务规则

2.6.5 异常与边界

场景现象系统行为用户看到
归属者创建后解绑了企业微信企业微信发不出去不影响提交,不改发邮箱客户照常看到提交成功;归属者在列表里看到待审核置顶
邮件发送失败发不出去不影响提交,重试策略由技术沿用现有通知方案同上

2.6.6 验收标准

通知内容和送达按 G-01-014 验收。

3 变更影响面

被影响对象影响方式处理动作负责人
02-账户管理添加账户时选择登记表 → 登记表待开户 → 已开户;投放类型只在添加时回填一次(D-01-06);登记表名称取当前名(R-01-039);预览的只读格式按 R-01-01002 引用本页状态机与 R-01-01002 包
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)。

已知限制: