Merge pull request 'docs: add promotion center PRD' (#365) from worktree-prd-user-promotion-center-inline-uiux into main

Reviewed-on: CYL/wordpress-theme-aksrt#365
2026-08-03 13:13:40 +08:00
parent f95e83c976 aa958c7d01
commit cdd355761b
1 changed files with 98 additions and 0 deletions
@@ -0,0 +1,98 @@
+# PRD: 用户中心内链推广中心与 UI/UX 重设计
+
+> 来源：用户指令（2026-08-03）。
+
+## 背景与问题
+
+当前邀请好友功能位于用户中心“账号设置”页的一个区块中。它与密码、邮箱、手机号等账户安全操作混排，造成以下问题：
+
+1. 推广/邀请是可持续查看数据、复制链接、追踪成果的独立用户任务，却没有独立、可直达的用户中心入口。
+2. “邀请好友”区域与账户安全职责不一致，降低账户设置页面的信息层级与可扫描性。
+3. 当前邀请展示偏功能拼接，缺少清晰的推广成果概览、操作引导和移动端优先的交互路径。
+4. 现有邀请奖励、邀请码、邀请链接、统计数据和邀请记录已具备后端能力，但其前端组织方式无法体现“推广中心”的完整体验。
+
+## 目标
+
+将推广能力作为用户中心内的独立“推广中心”标签页，而不是独立页面；把账户安全/账号设置中的“邀请好友”区域完整迁移到该中心，并对推广中心完成统一的 UI 与 UX 重设计。
+
+用户可在同一条用户中心路径中完成：了解奖励规则、复制并分享推广链接、查看推广成果和邀请记录；账户安全页只保留密码、邮箱、手机号等安全相关操作。
+
+## 用户故事
+
+- **US1（已登录用户）**：我可以从用户中心侧边栏或移动端标签直接进入“推广中心”，URL 可深链至对应标签，而无需进入独立推广页面。
+- **US2（已登录用户）**：我可以在推广中心清楚地了解当前推广奖励规则、我的邀请码和推广链接，并一键复制链接。
+- **US3（已登录用户）**：我可以通过醒目的数据概览查看已注册、已验证和已获得奖励的推广成果，并在同一页面查看邀请记录。
+- **US4（已登录用户）**：我在账号设置中只会看到安全设置及账号资料相关功能，不再看到“邀请好友”区域。
+- **US5（移动端用户）**：我可以在窄屏下顺畅访问、复制和查看推广中心内容，信息层级、触控区域和记录列表均适配移动端。
+- **US6（站点管理员）**：当积分、邀请奖励或邀请注册功能未启用时，推广中心入口和内容遵循现有功能开关，不暴露不可用的推广功能。
+- **US7（开发者）**：现有邀请码、邀请链接、邀请统计、记录 REST 接口和奖励结算逻辑保持单一业务通路；此次调整仅重组用户中心导航、渲染与前端交互，不复制或重建邀请业务规则。
+
+## 需求
+
+### 1. 用户中心信息架构
+
+- 在私有用户中心新增独立的“推广中心”标签页（内部键和 URL 参数以现有用户中心 tab 机制为准）。
+- “推广中心”必须使用用户中心已有的页面壳、权限校验、侧边栏、移动端导航和 tab URL 生成机制，不创建新的前台独立路由/页面模板。
+- 推广入口仅在现有邀请能力的必要功能开关均启用时出现：积分、邀请奖励、邀请注册。
+- 旧的邀请深链若当前由用户中心 tab 规范解析，应直接归一到新的推广中心标签，不保留双页面或双渲染路径。
+
+### 2. 推广中心内容与交互
+
+推广中心承接现有“邀请好友”区域的全部能力，并重新组织为清晰的任务流：
+
+1. **成果概览**：优先展示已注册、已验证、已获得奖励三个统计指标；加载中、空数据及请求失败需有明确、非误导性的状态反馈。
+2. **推广行动区**：展示邀请码、可复制的推广链接和主要复制按钮；复制成功/失败提供即时可感知反馈，并确保键盘可操作。
+3. **奖励说明区**：展示站点配置的邀请奖励说明，让用户在分享前理解奖励条件。
+4. **邀请记录区**：展示已有记录列表，保留当前 REST 数据源和分页/展示上限的既有能力；无记录时呈现引导性的空状态。
+
+不得在推广中心新增改变邀请码生成、邀请 cookie、邀请归因、注册绑定、邮箱验证奖励或积分结算的业务规则。
+
+### 3. 账户安全页清理
+
+- 从“账号设置”渲染链路中移除邀请好友区域及其仅为该区域服务的结构。
+- 账号设置保留个人资料、密码、邮箱、手机号等原有安全/资料职责；不得影响现有安全 AJAX、nonce、验证码或短信链路。
+- 推广中心成为邀请 UI 的唯一前台渲染位置，避免同一邀请卡在多个用户中心标签同时存在。
+
+### 4. UI/UX 重设计
+
+- 视觉应与现有用户中心设计语言一致，同时让“推广成果 → 分享操作 → 奖励规则 → 邀请记录”的优先级一目了然。
+- 桌面端应提供可快速扫读的成果概览和明确主操作；移动端应按任务优先级单列排布，不要求横向滚动，复制按钮易触达。
+- 使用语义化结构、可见焦点、适当对比度、键盘可操作按钮和不只依赖颜色的状态反馈，保证基础可访问性。
+- 复用现有用户中心 CSS/JS 模块和设计 token；新增样式/脚本保持模块化，不引入独立 UI 框架或重复的邀请请求逻辑。
+
+### 5. 数据、接口与安全边界
+
+- 继续使用已存在的、仅允许登录用户访问的邀请 REST 端点获取邀请码、链接、统计数据和记录。
+- 前端不得暴露直接可编辑的邀请归因、奖励结算或其他服务端敏感逻辑。
+- 保持现有 REST 权限校验、输出转义和前端错误处理边界。
+
+## 验收标准
+
+- 已登录且邀请功能启用的用户访问用户中心时，可从桌面侧边栏和移动端导航进入“推广中心”，且推广中心 URL 可以直接打开并激活正确标签。
+- 推广中心可完整展示邀请码、推广链接、复制操作、奖励说明、三项统计和邀请记录；数据来自当前邀请接口。
+- 链接复制在成功与失败场景都有可见反馈，并可通过键盘完成操作。
+- 邀请记录为空、接口加载中或请求失败时，推广中心不会呈现误导性的空白或错误统计。
+- 账号设置页面不再渲染邀请好友/邀请记录区块，且密码、改邮箱、绑定手机功能可继续使用。
+- 邀请开关关闭时，不出现不可用的推广中心入口或内容。
+- 桌面和移动端布局均无横向溢出，统计、分享操作和记录在窄屏下可读、可点击。
+- 现有邀请奖励归因、注册记录及积分结算逻辑不因本改动产生第二套实现。
+
+## 非功能要求
+
+- 遵循项目的 `AKSRT_Settings` 设置访问规范，不在新代码中直接读取 option。
+- 遵循项目用户中心 tab 注册与模板拆分模式；新增/调整的源文件尽量控制在 700 行以内，任何文件不得超过 1000 行。
+- 不新增向后兼容、双读 option、双路模板或数据迁移层；以当前用户中心结构为唯一实现。
+- 使用现有文本域 `aksrt`，对新增可翻译文案进行国际化处理。
+
+## 范围外
+
+- 新增独立的公开推广落地页、推广门户或第二套前台路由。
+- 修改邀请码生成规则、推广 cookie 时长、邀请归因规则、邮箱验证条件、奖励额度或积分结算模型。
+- 新增社交平台 SDK、自动化分享到第三方平台，或站外推广统计系统。
+- 对管理员后台邀请码运营界面、推广/返利支付规则进行功能重构。
+- 增加任何向后兼容、数据迁移或旧新两套邀请 UI 并存的实现。
+
+## 开放问题
+
+- “推广中心”的最终中文名称是否固定为“推广中心”，还是应使用“邀请推广”/“邀请好友”等已有产品术语？默认采用“推广中心”。
+- 推广中心在用户中心侧边栏中的最终排序位置需在实现时根据现有 tabs 的产品优先级确定；默认放在积分/资产相关入口附近。