底部导航配置化 · 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 | 文档状态:进行中