Domain Settings
域名设置 PRD，覆盖合作伙伴域名列表、Brand/Status 筛选、Add Domain 表单、编辑删除、分页和异常处理。
Domain Settings 用于为合作伙伴购买的域名配置推广转发。页面的核心任务是维护 Domain Name -> Promotional Domain 的映射关系，并按品牌和状态快速查询现有设置。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 域名转发配置管理页，包含新增、编辑、删除和查询 |
| 核心动作 | 按 Brand / Status 查询域名配置，新增合作伙伴域名，编辑或删除已有配置 |
| 数据范围 | 当前账号有权限管理的品牌、合作伙伴域名和系统推广域名 |
| 当前状态 | 查询、新增、编辑、删除和分页规则已定义；导航归属、品牌一致性和 Domain Name 输入口径仍待确认 |
需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Domain Settings 维护合作伙伴域名到 Promotional Domain 的转发关系；新增、编辑、删除必须校验权限、域名格式、重复域名和二次确认。 |
Inferred from Figma | Domain Name 视觉上带 https:// 前缀，但当前规则按“用户只输入 host name”处理；分组标题和行内 Brand 必须保持一致。 |
Open Question | 左侧导航高亮、默认截图品牌不一致、Domain Name 输入前缀和批量复选框用途仍待确认，见 开放问题。 |
1. Figma 原型
页面状态 Figma 截图
Domain Settings
展示 Set up a Partner Domain 默认列表：Brand / Status 筛选、Search / Reset / Add Domain、按品牌分组的域名表格、Edit / Delete 和分页。
Brand 下拉包含 All、IKEA、W365、Oh my God、The King+；Status 下拉包含 All、Active、Inactive、Waiting。
Add Domain 使用居中弹窗和遮罩，包含 Select Brand、Domain Name、Promotional Domain、Remarks、Confirm、Cancel 和关闭入口。
Select Brand 获得焦点后显示紫色描边，并展开 IKEA、W365、Oh my god、The King+ 品牌选项。
2. 全局依赖
| 全局模块 | 说明 |
|---|---|
| Top | 顶部会员汇总、优惠券余额、提现余额、提现入口、消息入口和 Profile 由 Top 统一提供，Domain Settings 不重复定义。 |
| Global One Line Notice | 红色维护公告属于全局公告模块；页面查询、弹窗和分页不改变公告展示。 |
| 共享规则 | 语言、权限、表单校验、查询反馈、分页和异常处理必须遵守共享规则。 |
| 侧边栏导航 | 当前页面应高亮 Domain Settings。如果 Figma 截图中高亮项不是 Domain Settings，以本 PRD 为准。 |
3. 页面组成
页面组成只描述 UI 结构。具体点击行为、数据口径、校验和异常处理统一写在对应功能说明中。
| 区域 | UI 表现 | 对应功能说明 |
|---|---|---|
| 页面上下文 | 面包屑 Home > Domain Settings、标题 Set up a Partner Domain、说明文案 | 页面上下文 |
| 筛选区 | Brand 下拉、Status 下拉、Search、Reset、Add Domain | 筛选与查询 |
| 域名分组列表 | 按品牌分组，每组展示品牌名、域名数量、表头和域名行 | 域名分组列表 |
| 表格行 | 复选框、Brand 标签、Domain Name、Promotional Domain、Setting Date、Actions | 域名分组列表 |
| 行操作 | Edit、Delete | 编辑与删除 |
| Add Domain 弹窗 | Select Brand、Domain Name、Promotional Domain、Remarks、Confirm、Cancel | Add Domain |
| 分页区 | Showing 1-10 of 1000、页码、上一页、下一页 | 分页 |
4. 功能说明
4.1 页面上下文
Domain Settings 是合作伙伴域名转发配置页，不是域名点击数据报表，也不是系统域名健康检查页。
| 项目 | 说明 |
|---|---|
| 面包屑 | 固定展示 Home > Domain Settings，用于提示当前层级。 |
| 页面标题 | 固定展示 Set up a Partner Domain。 |
| 页面说明 | 固定展示 You can set up forwarding for domains purchased by partners as promotional domains. |
| 页面边界 | 本页只维护合作伙伴购买域名与系统推广域名的转发关系；点击统计在 Data Report 查看。 |
4.2 筛选与查询
筛选区用于按品牌和域名状态缩小列表范围。选择下拉项只修改当前筛选草稿，点击 Search 后才刷新列表。
| 控件 | 规则 |
|---|---|
Brand | 默认 All。下拉展示当前账号有权限管理的品牌，Figma 示例为 IKEA、W365、Oh my God、The King+。 |
Status | 默认 All。下拉展示 Active、Inactive、Waiting。状态名称必须与系统内域名生命周期一致。 |
Search | 按当前 Brand + Status 条件刷新列表，并回到第 1 页。 |
Reset | 清空筛选条件为 All / All，刷新默认列表，并回到第 1 页。 |
| 下拉关闭 | 选择选项、再次点击选择器、点击空白区域或按 Esc 关闭下拉。 |
| 无可选品牌 | 保留 All 占位并禁用品牌下拉，不能展示无权限品牌。 |
Brand 与 Status 之间按 AND 处理；选择 All 表示该维度不限制。筛选条件必须影响分组标题、组内行数、分页总数和 Showing 结果范围。
4.3 域名分组列表
列表按品牌分组展示域名转发配置，帮助用户快速核对同一品牌下的合作伙伴域名和推广域名。
| 元素 | 说明 |
|---|---|
| 分组标题 | 展示标签图标、品牌名和域名数量，例如 Oh My God (3 domains)。数量必须等于当前筛选条件下该组可见行数。 |
| 表头 | 每个品牌分组下重复展示 Brand、Domain Name、Promotional Domain、Setting Date、Actions。 |
| 复选框 | Figma 显示行首复选框，但当前截图未展示批量操作。若保留复选框，只表示行选择，不触发业务动作。 |
Brand | 使用彩色标签展示所属品牌。标签文案、颜色和品牌配置保持一致。 |
Domain Name | 合作伙伴购买的域名，展示域名主机名，不展示协议、路径、查询参数或端口。 |
Promotional Domain | 系统分配或生成的推广域名。该字段是转发目标，展示时可加粗以便核对。 |
Setting Date | 该转发配置的创建或最近生效日期，使用统一日期格式，例如 5 May 2025。 |
Actions | 展示 Edit 和 Delete，具体规则见 编辑与删除。 |
分组标题、组内行的 Brand 标签和域名数量必须一致。若 Figma 截图中分组标题与行内品牌不一致，以本 PRD 的一致性规则为准。
4.4 Add Domain
点击 Add Domain 打开居中弹窗，背景页面进入遮罩态。弹窗用于新增一条合作伙伴域名转发配置。
| 字段 / 控件 | 规则 |
|---|---|
| 弹窗标题 | 固定展示 Add Domain。 |
| 关闭入口 | 点击右上角 X 或 Cancel 关闭弹窗，不保存未提交内容；提交中状态下禁止重复关闭和重复提交。 |
Select Brand | 必填。下拉只展示当前账号可管理品牌，Figma 示例为 IKEA、W365、Oh my god、The King+。 |
Domain Name | 必填。输入合作伙伴购买的域名主机名。左侧 https:// 仅为视觉前缀，不作为用户输入或提交值。 |
| Domain Name 校验 | 允许 www.example.com、example.com；不允许协议、路径、查询参数、端口、空格或非法字符。 |
Promotional Domain | 系统自动提供。用户不能手动改写；选择品牌或填写域名后，系统按规则生成或返回该值。 |
| Promotional Domain 异常 | 如果系统无法生成推广域名，阻止 Confirm，并展示可重试或联系管理员的说明。 |
Remarks | 可选。用于记录运营备注，不影响转发规则。 |
Confirm | 校验通过后创建配置；成功后关闭弹窗并刷新列表。新建域名默认进入 Waiting，直到系统确认转发生效。 |
Cancel | 关闭弹窗，不创建配置。 |
新增成功后，如果当前筛选条件包含新记录，则列表展示该记录；如果当前筛选条件不包含新记录，页面只展示成功提示，不强制改写用户当前筛选。
4.5 编辑与删除
行内操作用于维护已有域名配置。
| 操作 | 规则 |
|---|---|
Edit | 打开编辑表单，预填 Brand、Domain Name、Promotional Domain 和 Remarks。Brand 是否允许修改由权限和业务规则决定；如果修改 Brand 会重新生成 Promotional Domain，必须明确提示。 |
| 编辑保存 | 校验规则与 Add Domain 一致。保存成功后刷新当前列表并保留分页上下文；如当前筛选不再命中该记录，则记录从当前列表移除。 |
Delete | 删除是高风险动作，必须弹出二次确认，确认文案需要包含 Domain Name 和 Promotional Domain。 |
| 删除成功 | 从当前列表移除该记录，并更新分组数量和分页总数。 |
| 删除失败 | 保留原记录，展示失败原因并允许重试。 |
如果业务上需要保留历史记录，Delete 可以映射为停用或归档，但列表文案仍需让用户清楚知道该域名不会继续作为有效转发配置。
4.6 分页
分页用于浏览大量域名配置。
| 控件 | 规则 |
|---|---|
| 结果范围 | 展示 Showing 1-10 of 1000 形式的范围说明。数字必须来自当前筛选后的结果集。 |
| 页码 | 点击页码刷新对应页，保留当前筛选条件。 |
| 上一页 / 下一页 | 第一页禁用上一页，最后一页禁用下一页。 |
| 筛选联动 | 点击 Search 或 Reset 后回到第 1 页。 |
| 删除联动 | 删除当前页最后一条记录后，如当前页无数据，应自动回退到上一页或展示当前筛选空态。 |
5. 业务流程
用户进入 Domain Settings，系统按当前账号权限展示可管理品牌下的域名转发配置。
用户可直接浏览默认列表，也可选择 Brand、Status 后点击
Search 查询。用户点击
Add Domain，选择品牌，输入合作伙伴购买的域名，系统自动提供 Promotional Domain。用户填写可选 Remarks 并点击
Confirm。系统完成校验和创建，关闭弹窗，刷新列表；新记录进入
Waiting 或系统返回的当前状态。用户可对已有记录执行
Edit 或 Delete，页面同步更新分组数量和分页总数。6. 业务规则
- Domain Settings 只展示当前账号有权限管理的品牌和域名配置。
- 同一品牌下
Domain Name不允许重复；如果系统要求全局唯一，也必须在新增和编辑时拦截重复。 Promotional Domain必须由系统分配或生成，用户不能手动输入覆盖。Domain Name提交值只包含域名主机名，不包含http://、https://、路径、查询参数或端口。- 新增域名默认状态为
Waiting，转发生效后变为Active；停用或删除后的有效状态按系统生命周期进入Inactive或移出列表。 Brand、Status筛选只影响本页列表和分页，不影响 Top、One Line Notice 或其他页面。Edit和Delete都必须校验当前账号是否仍拥有该品牌权限，不能只依赖页面初次加载时的权限。- 日期、品牌名、域名大小写、状态名称在列表、筛选、弹窗和提示中必须保持一致。
7. 异常与空态
| 场景 | 处理 |
|---|---|
| 默认列表无数据 | 保留页面标题、筛选区和 Add Domain，列表区展示空态说明。 |
| 筛选无结果 | 保留当前筛选条件，展示无结果空态，并允许 Reset 回到默认列表。 |
| 品牌选项加载失败 | 禁用 Brand 下拉，保留 Status、Search、Reset，并提示用户重试。 |
| 域名格式错误 | 阻止 Confirm，在 Domain Name 附近展示格式错误，保留用户输入。 |
| 域名重复 | 阻止保存，提示重复所属品牌和重复域名。 |
| Promotional Domain 生成失败 | 阻止 Confirm，提示系统暂时无法提供推广域名，并允许重试。 |
| 新增 / 编辑失败 | 弹窗保持打开，保留已填内容，展示失败原因。 |
| 删除失败 | 保留原列表记录，展示失败原因，不提前减少分组数量。 |
| 权限变化 | 当前账号失去品牌权限时，相关品牌和记录从列表移除；正在编辑时提示无权限并关闭或禁用提交。 |
| 网络异常 | 保留当前筛选、分页和表单草稿，允许用户重试。 |
8. 开放问题
Domain Settings Figma 需补充 / 确认项
- 截图左侧导航高亮为 Record Inquiry，但面包屑和内容为 Domain Settings；实现应高亮 Domain Settings，除非产品确认该页面属于 Record Inquiry 子入口。
- 默认态截图中第二个分组标题为 Oh My God，但组内 Brand 标签为 W365；分组标题、组内 Brand 和数量必须在最终设计中保持一致。
- Status 筛选已出现 Active / Inactive / Waiting，但表格没有 Status 列或状态标签；当前 PRD 将状态定义为筛选维度。如用户需要逐行核对状态，需要补充状态列或状态展示方式。
- Add Domain 的 Domain Name 字段显示
https://视觉前缀，但 helper 示例要求输入www.example.com/example.com；当前 PRD 认定用户只输入域名主机名，需设计确认。 - 列表行首有复选框，但截图没有批量操作按钮；当前 PRD 不定义批量业务动作。如需要批量删除或批量停用，需要补充 Figma 和业务规则。