# 客户登记 PRD

| 项 | 内容 |
| --- | --- |
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 01-客户登记 |
| 涉及功能 | [客户登记](../../../feature/客户登记/README.md) |
| 编制日期 | 2026-10-16 |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手（本文件可直接整份投喂给 AI 作为实现依据） |
| 关联文档 | 本目录 spec.yaml、mocks/；版本 [index.md](../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 过期」，没有链接。

<!-- mock: mocks/2.1-新增弹窗/01-默认态.html | 新增客户登记表弹窗（默认态） -->

### 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 变为待审核。

<!-- mock: mocks/2.2-列表/01-默认态.html | 客户登记表列表（默认态，覆盖各状态行操作） -->

### 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** 前置：一张待填写的登记表，客户保存过签约主体名称。操作：内部点详情。期望：只读展示客户保存的内容，没有底部按钮。

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

- **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 张规则配置审批单（审批中、已通过、已驳回各一张）。操作：切换到已提交审批。期望：审批中那张排第一，其余按申请时间降序；操作对象列都显示「规则配置」；只有审批中那张有撤回；三张都有详情。

<!-- mock: mocks/2.4-已提交审批/01-默认态.html | 已提交审批 tab（默认态） -->

### 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 要求，未到自动保存、也没点保存，就关闭标签页；②再打开，改动后点保存成功，再关闭；③填完提交成功后关闭。期望：①浏览器弹出默认离开确认；②③不弹。

<!-- mock: mocks/2.5-填写页/01-填写中.html | 填写页（填写中，已自动保存） -->

<!-- mock: mocks/2.5-填写页/02-校验失败.html | 填写页（提交校验失败） -->

<!-- mock: mocks/2.5-填写页/03-提交成功.html | 填写页（提交成功 / 有效期内再次打开） -->

### 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）。
