主题
02 商品推荐
版本：v3.0
所属端：前台商城
文档状态：已交付
1. 概述
1.1 背景与目标
商品推荐是首页流量分发的核心手段。通过品牌、新品、人气、专题四个维度的推荐内容，帮助用户在海量商品中快速发现感兴趣的目标，提升浏览深度和转化率。
本模块的设计目标：
- 提供多维度的推荐入口，覆盖不同用户的浏览偏好
- 推荐内容完全由后台运营人员配置，支持灵活调整排序和上下线
- 各推荐位独立管理，互不影响
1.2 目标用户
| 角色 | 使用场景 |
|---|---|
| 游客 | 浏览所有推荐内容，了解平台商品和品牌 |
| 会员 | 浏览推荐内容，点击后可直接加购或收藏 |
1.3 功能范围
| 功能模块 | 说明 | 优先级 |
|---|---|---|
| 品牌推荐 | 展示平台重点合作品牌 | P0 |
| 新品推荐 | 展示近期上新的精选商品 | P0 |
| 人气推荐 | 展示热销或高关注度商品 | P0 |
| 专题推荐 | 展示运营策划的主题内容集合 | P1 |
| 个性化推荐 | 基于用户行为的智能推荐 | 待启动 |
2. 功能详细设计
2.1 品牌推荐
页面结构
独立楼层，标题"品牌推荐"。以品牌卡片横向排列或网格展示，每张卡片包含品牌Logo和品牌名称。可选展示品牌专区大图。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-REC-01 | 仅展示后台标记为"推荐"状态的品牌 |
| BR-REC-02 | 按运营设定的排序值从高到低展示 |
| BR-REC-03 | 品牌信息（Logo、名称、品牌故事）取自品牌主体数据 |
交互说明
| 用户操作 | 系统反馈 |
|---|---|
| 点击品牌卡片 | 跳转品牌详情页，展示品牌故事、品牌大图及该品牌下的商品列表 |
| 推荐数量超出一屏 | 支持横向滚动浏览 |
2.2 新品推荐
页面结构
独立楼层，标题"新鲜好物"，附"查看更多"入口。商品卡片网格展示（每行3~5个），每张卡片包含：商品主图、商品名称（最多两行）、商品价格、新品标签。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-REC-10 | 仅展示后台标记为"推荐"状态的新品 |
| BR-REC-11 | 按运营设定的排序值从高到低展示 |
| BR-REC-12 | 仅展示处于上架状态的商品，已下架商品自动过滤 |
交互说明
| 用户操作 | 系统反馈 |
|---|---|
| 点击商品卡片 | 跳转商品详情页 |
| 点击"查看更多" | 跳转新品推荐完整列表页 |
2.3 人气推荐
页面结构
独立楼层，标题"人气推荐"，附"查看更多"入口。商品卡片展示：商品主图、商品名称、商品价格、销量标签。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-REC-20 | 仅展示后台标记为"推荐"状态的人气商品 |
| BR-REC-21 | 按运营设定的排序值从高到低展示 |
| BR-REC-22 | 仅展示处于上架状态的商品 |
交互说明
| 用户操作 | 系统反馈 |
|---|---|
| 点击商品卡片 | 跳转商品详情页 |
| 点击"查看更多" | 跳转人气推荐完整列表页 |
2.4 专题推荐
页面结构
独立楼层，标题"精选专题"。以专题卡片列表展示，每张卡片包含：专题封面图、专题标题、专题简述、阅读数/收藏数。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-REC-30 | 仅展示后台标记为"推荐"状态的专题 |
| BR-REC-31 | 按运营设定的排序值从高到低展示 |
| BR-REC-32 | 专题详情页展示该专题关联的商品集合 |
交互说明
| 用户操作 | 系统反馈 |
|---|---|
| 点击专题卡片 | 跳转专题详情页，查看专题描述及关联商品 |
3. 接口能力
本模块的推荐数据通过首页内容聚合能力统一获取（详见 01 首页门户），不单独提供接口。
各推荐位返回的信息：
| 推荐类型 | 返回内容 |
|---|---|
| 品牌推荐 | 品牌名称、Logo、排序 |
| 新品推荐 | 商品名称、主图、价格 |
| 人气推荐 | 商品名称、主图、价格 |
| 专题推荐 | 专题名称、封面图、简述 |
4. 核心数据实体
| 实体 | 业务含义 | 关键属性 |
|---|---|---|
| 品牌推荐位 | 记录哪些品牌被推荐到首页 | 关联品牌、推荐状态、排序 |
| 新品推荐位 | 记录哪些商品被推荐为新品 | 关联商品、推荐状态、排序 |
| 人气推荐位 | 记录哪些商品被推荐为人气 | 关联商品、推荐状态、排序 |
| 专题推荐位 | 记录哪些专题被推荐到首页 | 关联专题、推荐状态、排序 |
| 专题 | 运营策划的主题内容 | 标题、封面图、描述、阅读数、收藏数、关联商品集合 |
实体关系：各推荐位为「首页展示」与「业务主体」之间的桥梁，运营人员通过后台将品牌/商品/专题添加到对应推荐位并设定排序。
5. 验收标准
| 编号 | 验收条件 |
|---|---|
| AC-REC-01 | 品牌推荐楼层正确展示后台配置的品牌，点击可进入品牌详情 |
| AC-REC-02 | 新品推荐楼层正确展示后台配置的商品，点击可进入商品详情 |
| AC-REC-03 | 人气推荐楼层正确展示后台配置的商品 |
| AC-REC-04 | 专题推荐楼层正确展示后台配置的专题 |
| AC-REC-05 | 后台调整推荐状态或排序后，前台刷新即生效 |
| AC-REC-06 | 已下架商品不出现在任何推荐楼层 |
| AC-REC-07 | 无推荐数据时对应楼层自动隐藏 |
| AC-REC-08 | 图片加载失败时展示默认占位图 |