PRDv1.8 · 34

底部导航配置化 · PRD

作者 Luke 版本 v1.8 日期 2026-09-16 状态 进行中 平台 BRAND_A & BRAND_B 类 M

版本记录
版本 日期 变更说明
v1.8 2026-09-16 §2.1.5 明确客户端 H5 维持 17 项;代理后台 H5 另增 Team/团队 与 All Agents/所有直属代理,共 19 项;默认值仍为 Promo/活动列表页。
v1.7 2026-09-16 Sonnet 预审回修:§2.2 明确目标页面既有登录、权限与返回逻辑不变;§5.1 明确底层资料不得写死成固定槽位;中文/英文 PRD 统一引用对应语言的 v1.6 资讯图。
v1.6 2026-09-16 §2.1 补齐 17 个跳转页面、所有 radio/下拉枚举与默认值;后台名称及策略名称比照活动名称改为 1–60 字;BO 原型改为整页中英切换并收敛左侧菜单;中英文 PRD 分别引用对应语言资讯图。
v1.5 2026-09-16 §2.1 与 §3.1 明确系统编号只在建立后显示,新增/编辑表单不显示;项目新增页自行选择范围,编辑页范围 radio 禁用;原型每范围改为 6 笔范例以实际验证新增。
v1.4 2026-09-15 §1.4 流程图改为纵向;§2 补项目库搜索与禁用交互;§3 明确少量枚举平铺,移除未确认的引用明细与生效时点。
v1.3 2026-09-15 §1.4 明确「最多 10 个导航项目库 → 策略任意选择 3/5 项」;§3.3 加入复制策略,§2.2 与 §4.3 补引用影响及缓存语义。
v1.2 2026-09-15 §1.3 一期改为同范围多策略;同一品牌+使用端最多启用一套。
v1.1 2026-09-15 L0 精简正文并改用需求 27–32 原型外壳;旧资讯图与 BO 形制已撤回。
v1.0 2026-09-15 §1 初版:四个配置范围、导航项目库、H5 渲染与二期分配边界。
目录

[TOC]


L0 · 快速掌握

底部导航配置化一页式资讯图表

① 一句话需求

运营按 BRAND_A/BRAND_B × 客户端 H5/代理后台 H5 建立最多 10 个导航项目,再从项目库任意组合成 3 项或 5 项策略;同一范围可有多套策略,但最多启用一套。

② 核心模型

对象 定义
范围 用户渠道 × 使用端,共四种,资料完全隔离
导航项目库 每个范围最多 10 个项目;每项包含单一目标页面、一般图与中间图
策略 从同范围项目库选择恰好 3 项或 5 项,并保存项目 ID 与顺序
启用策略 当前范围唯一可被 H5 读取的策略;也允许没有启用策略

③ 本期与不做

本期 不做
项目库;多策略新增/复制/编辑/启用/禁用;两套 H5 读取;权限与管理员日志 原生 App;4 项布局;URL/外链/游戏/活动深链;目标页面登录/权限/返回逻辑;选中态;多语言素材;总代/代理分配

④ 全局红线表

不变量 验证
G1 策略只能有 3 项或 5 项 AC2
G2 中间位置只由最终顺序决定 AC3
G3 同策略不得重复项目或目标页面 AC4
G4 四个范围完全隔离 AC5
G5 同范围最多一套启用策略 AC8
G6 无完整启用策略即隐藏整条底栏 AC10
G7 旧版本提交不得覆盖新版本 AC14

1. 范围与资料关系

1.1 范围只有两个维度:用户渠道 BRAND_A/BRAND_B 与使用端 客户端 H5/代理后台 H5。查询、编辑、页面白名单、缓存与 H5 读取均不得跨范围。

1.2 导航项目与策略都有不可变系统编号。策略只保存导航项目 ID 与顺序,不复制项目内容;不同策略可重复引用同一项目。

1.3 每个范围最多 10 个未删除导航项目,可建立多套策略;同一范围最多一套启用,也允许零套启用。

1.4 配置流程

1.4.1 新增与复制共用同一编辑、校验及保存流程;复制只负责预填来源范围、组合与顺序。

flowchart TD
    scope([选择用户渠道与使用端]) --> library[维护导航项目库]
    library --> editor[新增或复制策略]
    editor --> choose[勾选同范围项目]
    choose --> count{恰为 3 项或 5 项}
    count -->|否| blocked[阻断保存]
    count -->|是| order[调整显示顺序]
    order --> preview[预览中间突起位置]
    preview --> save[保存为禁用]
    save --> activate{启用}
    activate -->|同范围已有启用| blockedEnable[提示先禁用原策略]
    activate -->|没有冲突| h5[H5 下次读取新版本]

2. 导航项目库

2.1 字段

字段 规则
系统编号 系统生成;创建后不变
用户渠道/使用端 必填;用户渠道值为 BRAND_A/BRAND_B,创建后不变
后台名称 必填,1–60 字;纯字符数,不分中英文宽度;只供运营辨识
跳转页面 从该使用端页面白名单单选
一般图标 必填;非中间位置使用;图片内含图标与文字
中间图标 必填;中间突起位置使用;图片内含图标与文字
状态 启用/禁用;新增默认启用

2.1.1 项目库列表提供用户渠道、使用端、状态与后台名称搜索;前三项都保留 All。项目库共用一个页面,不按客户端/代理后台拆成两套菜单。

2.1.2 新增导航项目时,在新增页以基础 radio button 选择用户渠道与使用端;编辑既有项目时,两组 radio button 维持可见但禁用,只可修改后台名称、跳转页面、一般图标与中间图标。系统编号由保存后自动产生,新增与编辑表单都不显示,只在项目库列表等建立后情境显示。

2.1.3 原型每个范围提供 6 笔范例资料,用来实际验证可继续新增至第 10 笔;范例数量与内容不代表上线预置值。

2.1.4 控件枚举与默认值

页面/控件 类型 枚举 默认值
项目库搜索-用户渠道 下拉选单 All、BRAND_A、BRAND_B BRAND_A
项目库搜索-使用端 下拉选单 All、客户端 H5、代理后台 H5 客户端 H5
项目库搜索-状态 下拉选单 All、启用、禁用 All
新增项目-用户渠道 radio button BRAND_A、BRAND_B 继承列表的明确筛选值;列表为 All 时取 BRAND_A
新增项目-使用端 radio button 客户端 H5、代理后台 H5 继承列表的明确筛选值;列表为 All 时取 客户端 H5
编辑项目-用户渠道/使用端 radio button(禁用) 同新增项目 显示该项目既有值,不可修改
新增项目-跳转页面 下拉选单 见 §2.1.5 Promo/活动列表页
项目库每页笔数 下拉选单 10/Page、20/Page 10/Page

2.1.5 跳转页面枚举

下拉选单依使用端提供固定白名单;英文值为系统枚举,中文为界面名称。客户端 H5 使用前 17 项;代理后台 H5 使用全部 19 项。Team 与 All Agents 仅适用于代理后台 H5,不得出现在客户端 H5。

英文枚举 中文界面名称 适用端
Promo 活动列表页 客户端 H5、代理后台 H5
Inbox 站内信 客户端 H5、代理后台 H5
Announcement 公告 客户端 H5、代理后台 H5
Deposit 充值 客户端 H5、代理后台 H5
Withdraw 提款 客户端 H5、代理后台 H5
Chat 客服 客户端 H5、代理后台 H5
Account 个人中心 客户端 H5、代理后台 H5
VIP VIP 客户端 H5、代理后台 H5
Download 下载 客户端 H5、代理后台 H5
Security Setting 安全中心 客户端 H5、代理后台 H5
Fund Accounts 绑定提款账户 客户端 H5、代理后台 H5
Balance Record 账变记录 客户端 H5、代理后台 H5
Deposit Record 充值记录 客户端 H5、代理后台 H5
Withdraw Record 提款记录 客户端 H5、代理后台 H5
Bet History 投注记录 客户端 H5、代理后台 H5
More 更多 客户端 H5、代理后台 H5
Logout 登出 客户端 H5、代理后台 H5
Team 团队 仅代理后台 H5
All Agents 所有直属代理 仅代理后台 H5

2.2 约束与影响

2.2.1 页面白名单不提供 URL;不收外链、单一游戏、特定活动或带业务对象的深层页面。目标页面既有的登录限制、权限检查与登录后返回逻辑维持不变,本需求只配置入口。图标没有选中态。

2.2.2 新增第 11 个项目时阻断。被任一未删除策略引用的项目不得禁用或删除,须先移出所有策略;无引用项目点击「禁用」时须二次确认,确认后列表状态改为红字「禁用」。

2.2.3 编辑项目备注必填。若新目标会让任一引用策略出现重复页面,整次保存阻断;本页不显示引用策略明细。


3. 策略管理

3.1 列表与字段

3.1.1 列表筛选的用户渠道、使用端与状态都保留 All;策略名称支持关键字查询。新增/编辑时必须指定单一范围。

字段 规则
策略编号 系统生成;创建后不变
策略名称 必填,1–60 字;纯字符数,不分中英文宽度;同范围不得重复
用户渠道/使用端 创建时选择;创建后不变
导航项目与顺序 从同范围启用项目任意选择;恰为 3 项或 5 项
状态 启用/禁用;新增与复制均默认禁用
备注 新增、复制、编辑、启用、禁用或删除时必填

3.1.2 状态只使用后台既有文字形制:启用 为一般文字,禁用 为红字,不使用徽章或胶囊。

3.1.3 策略编辑器的用户渠道、使用端与导航数量选项都少且固定,使用 radio button 平铺;列表搜索区因含 All,继续使用下拉选单。

3.1.4 策略编号由保存后自动产生;新增、复制与编辑表单都不显示策略编号,只在策略列表等建立后情境显示。

3.1.5 控件枚举与默认值

页面/控件 类型 枚举 默认值
策略列表搜索-用户渠道 下拉选单 All、BRAND_A、BRAND_B BRAND_A
策略列表搜索-使用端 下拉选单 All、客户端 H5、代理后台 H5 客户端 H5
策略列表搜索-状态 下拉选单 All、启用、禁用 All
新增策略-用户渠道 radio button BRAND_A、BRAND_B 继承列表的明确筛选值;列表为 All 时取 BRAND_A
新增策略-使用端 radio button 客户端 H5、代理后台 H5 继承列表的明确筛选值;列表为 All 时取 客户端 H5
新增策略-导航数量 radio button 5 项、3 项 5 项
编辑策略-用户渠道/使用端 radio button(禁用) 同新增策略 显示该策略既有值,不可修改
策略列表每页笔数 下拉选单 10/Page、20/Page 10/Page

策略名称/后台名称文字框默认空白;备注默认空白。复制策略仅例外预填「{原策略名称}-副本」。

3.2 选择、排序与预览

3.2.1 编辑器左侧列出同范围最多 10 个启用项目供勾选;右侧依选择顺序列出已选项目,可移除及上/下调整。实时显示 已选 n/3 或 已选 n/5,超过目标数时不得继续勾选。

3.2.2 选择 3 项时第 2 项使用中间图;选择 5 项时第 3 项使用中间图。运营不另选中间项目,顺序变化后预览自动重算。

3.2.3 保存时校验:项目数、范围、项目状态、项目 ID 不重复、目标页面不重复及配置版本。任一失败则整单不写入。

3.2.4 新增时若已选项目后切换用户渠道或使用端,须先确认;确认后清空选择。编辑既有策略时范围不可修改。

3.3 复制策略

3.3.1 列表的「复制」会开启新增策略编辑器,复制来源策略的范围、3/5 项模式、项目组合与顺序;策略编号重新生成,名称预填「{原策略名称}-副本」,状态固定为禁用。

3.3.2 复制不会直接保存,也不会复制启用状态、备注、建立人或更新时间。若来源项目已不可用,须标红并替换后才能保存;保存仍执行 §3.2.3 全部校验。

3.4 启用、禁用与删除

3.4.1 启用前显示名称与范围并要求备注。若同范围已有启用策略,本次阻断,必须由运营先禁用原策略,系统不得自动切换。

3.4.2 禁用前提示该范围可能隐藏底部导航并要求备注;确认后状态改为禁用。只有禁用策略可软删除。

3.5 并发

3.5.1 两人从同一版本编辑时,先提交者成功;后提交者整单拒绝并要求刷新,不得覆盖。


4. H5 读取与呈现

4.1 客户端 H5 与代理后台 H5 分别读取当前用户渠道+使用端唯一启用策略。没有启用策略、读取失败、不是 3/5 项或资料不足时,隐藏整条底栏并收起高度,不以旧固定导航补位。

4.2 3 项与 5 项都维持现有中间突起 UI。中间图失败时回退一般图,再失败使用系统占位图;点击只进入配置的单一页面。

4.3 客户端 Inbox 红点跟随「目标页面=Inbox」的项目,不跟固定位置;没有 Inbox 时不显示。原本不显示底栏的二级页面继续不显示。配置何时反映到 H5 由 OP-1 待开发确认,本版不承诺时间。


5. 二期、权限与日志

5.1 二期代理分配:总代/代理分配第二期开放。取值顺序为当前代理直接分配 → 最近一个已分配祖先 → 当前范围启用策略 → 隐藏底栏。本期不画分配 UI。底层资料继续保存导航项目、策略引用的项目 ID 与顺序;不得把导航资料写死成固定 3/5 个槽位,避免二期加入分配时重做一期结构。

5.2 权限:页面权限控制入口;操作权限控制新增、复制、编辑、启用、禁用与删除;用户渠道权限决定可查询与编辑的范围。

5.3 管理员日志:不在本功能页另画日志区。沿用既有管理员日志,记录操作人、时间、范围、对象编号与名称、动作、备注及字段/顺序变更前后值。


6. 提示语与开放项

6.1 后台提示语

场景 文案
第 11 个项目 最多只能建立 10 个导航项目。
数量错误 策略只能选择 3 个或 5 个导航项目。
页面重复 同一策略不可重复跳转到同一页面。
启用冲突 此范围已有启用策略「{策略名称}」,请先禁用后再启用。
禁用策略确认 禁用后,此范围将隐藏底部导航。是否确认禁用?
禁用项目确认 禁用后,此导航项目将不可加入新策略。是否确认禁用?
引用阻断 此导航项目仍被策略使用,请先从所有策略移除。
并发冲突 配置已被其他人更新,请刷新页面后再提交。
备注为空 请填写备注。

6.2 开放项

# 问题 决策者
OP-1 现行 H5 配置缓存 TTL 与刷新触发点 前端
OP-2 上线能否预置四个范围现有导航项目与策略 开发+运营
OP-4 两张图片的尺寸、格式与大小限制 UI+前端

附录与验收

附录 A:验收标准
# P 验收点
AC1 P0 每个范围第 11 个未删除项目建立失败;项目库可按四个条件搜索且前三项有 All;原型以 6 笔范例实际完成新增。
AC2 P0 (G1)策略可从 10 项任意勾选;不是恰好 3/5 项时保存阻断。
AC3 P0 (G2)调序后,3 项第 2 位或 5 项第 3 位自动改用中间图。
AC4 P0 (G3)同策略重复项目或重复目标页面时整单阻断。
AC5 P0 (G4)四个范围的项目、策略、白名单与 H5 读取不交叉。
AC6 P1 新增策略时切换范围先确认,确认后清空已选项目;编辑策略时范围不可改。新增项目可选范围;编辑项目显示禁用的范围 radio,且只开放名称、页面与两张图标。
AC7 P0 新增与复制策略均为禁用;复制保留组合与顺序但产生新编号。
AC8 P0 (G5)同范围已有启用策略时,另一策略启用失败且原策略不变。
AC9 P1 状态以文字显示,禁用为红字;启用/禁用均有确认、备注与列表结果。
AC10 P0 (G6)无完整启用策略时整条底栏隐藏且不留高度。
AC11 P0 被引用项目不可禁用/删除;无引用项目二次确认后变为红字「禁用」。
AC12 P0 项目编辑若造成任一引用策略目标重复则阻断;页面不显示引用策略明细。
AC13 P1 中间图依次回退一般图与明显的系统占位图;Inbox 红点跟随目标。
AC14 P0 (G7)并发后提交者失败,先提交结果保留。
AC15 P1 功能页没有独立日志区,变更可在既有管理员日志查到。
AC16 P1 新增/复制/编辑策略与新增/编辑项目表单均不显示系统编号;保存后列表显示系统自动产生的编号。
AC17 P1 PRD 与 BO 原型完整呈现所有 radio/下拉枚举及默认值;客户端 H5 下拉含 17 个固定值,代理后台 H5 含 19 个;Team 与 All Agents 只在代理后台 H5 出现,新增默认皆为 Promo。
AC18 P1 后台名称与策略名称允许 1–60 字,纯字符计数;第 61 字无法输入或保存时阻断。
AC19 P1 BO 中英切换覆盖主原型、互动结果与右侧说明;左侧只显示「网站管理 > 底部导航配置」。
AC20 P1 中文 PRD 只显示中文资讯图,英文 PRD 只显示英文资讯图;两图结构与业务规则一致。
附录 B:原型视觉清单

原型视觉清单

视觉 ID 载体 用途 证据
VIS-BO-001 BO 一般图标上传与预览 §2.1
VIS-BO-002 BO 中间图标上传与预览 §2.1
VIS-CLIENT-001 Client 一般位置导航图 §3.2
VIS-CLIENT-002 Client 中间突起导航图 §3.2

文档版本:v1.8 | 日期: 2026-09-16 | 作者: Luke | 文档状态:进行中