# 我的店铺关注 — 功能需求说明（C 端）

> 本文档在《我的店铺关注功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《会员管理功能需求》** v1.1、《店铺管理功能需求》** v1.3.6、《商品管理功能需求》** v1.3.3 及 C 端兄弟模块 **《店铺主页功能需求》** v1.0、《我的服务功能需求》** v1.1、《商品详情内页功能需求》** v1.0、《搜索页功能需求》** v1.0 做边界与流程对齐。  
> 范围：**C 端（消费者 APP / 用户商城）· 我的店铺关注** 中 **已登录会员** 对 **已关注店铺** 的列表查看、进入店铺主页及 **取消关注**（若前台提供）；**不涉及** 数据库结构、接口定义及技术实现细节。  
> **说明：** 本模块 **只读消费** 当前会员的关注关系与店铺档案摘要；**不维护** 店铺/商品数据；**新增关注** 在 **店铺主页** 完成（SH-F6）。  
> **v1.0：** 首版定稿；对齐草稿 §1～§4；补全入口、店态、与店铺主页/会员/平台侧边界、列表异常与空态。

---

## 1. 模块定位

### 1.1 业务目标

为 **已登录的 C 端买家会员** 提供 **「我关注了哪些店」** 的集中查看与管理入口，使其能够：

- 查看 **当前账号** 下 **全部有效关注** 的店铺列表；
- 在列表中浏览每家店的 **头像、名称、评分、粉丝数**（与店铺主页口径一致）；
- 按 **关注时间从新到旧** 浏览；
- **点击店铺** 进入 **店铺主页**，继续浏览商品或 **取消关注**；
- 在列表页 **可选** 直接 **取消关注**（与店铺主页规则一致，以前台是否提供按钮为准）。

**不包含（本期或与它模块分工）：**

| 能力 | 说明 |
|------|------|
| **首次关注店铺** | 见 **《店铺主页功能需求》** §5；搜索页/详情「进店」后于店主页操作 |
| **店铺内浏览、店内搜索、加购下单** | 见 **店铺主页**、**商品详情**、**购物车/订单** |
| **全站店铺搜索** | 见 **《搜索页功能需求》** |
| **平台/商家维护店资料** | 见 **店铺管理**、商家端店铺设置 |
| **平台查看会员关注列表** | 平台 **会员管理** **不提供** 本能力（非买家自助范围） |
| **注册/登录** | 见 **会员注册登录**；本模块 **须先登录** |

### 1.2 在业务链中的位置

```text
【用户链】C 端登录（会员）
    ↓
【写入关注 · 其它模块】店铺主页 / 商品详情进店区 ── 关注 ──► 关注关系
    ↓
【本模块 · 读取与管理】我的店铺关注 · 列表
    ↓
店铺主页（带 shopId）──► 商品详情 ──► 加购/下单（四条件，见 §8）

【供给链】平台/商家维护 biz_shop 档案 ──► 列表展示字段随店资料更新（刷新后生效）
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **店铺主页** v1.0 | **下游 + 互写** | 店主页 **写入/取消** 关注（SH-F1～F5）；本模块 **展示** 列表并 **可** 取消（SH-F3） |
| **我的服务** v1.1 | **并列入口** | 同属 **个人中心/会员中心** 用户链能力；**不** 重复资料/地址/入驻 |
| **会员管理** v1.1 | **用户链** | 禁用会员 **不可** 使用本模块；平台 **不维护** 关注关系 |
| **店铺管理** v1.3.6 | **店铺档案源** | 店名/头像/状态变更后 **刷新列表** 即更新；**已删店** 见 §6.3 |
| **商品详情** v1.0 | **间接** | 详情进店区关注后，本列表 **刷新/重进** 后出现 |
| **搜索页** v1.0 | **间接** | 搜索店铺 Tab → 店主页 → 关注 → 本列表可见 |
| **关联需求分析** v1.6 §11 | **可购规则** | 本模块 **不交易**；进店后下单在详情/结算校验 |

### 1.3 与《关联需求分析》的对应

| 关联分析要点 | 本模块 |
|--------------|--------|
| 双业务链、账号不混用 | 仅 **买家会员** 查看 **自己的** 关注；**不是** 商家经营账号能力 |
| C 端浏览与下单分离 | 列表属 **浏览/管理层**；**不下单** |
| 店铺停业 S-P3 | **仍展示** 已关注且 **未删** 的停业店；可进店浏览；**下单** 在详情拦截 |
| 已逻辑删除店铺 | **不展示** 于列表（见 §6.3）；历史关注关系 **不阻塞** 列表加载 |
| 状态不级联 | 平台删店 **不自动** 帮用户「取消关注」文案；列表 **过滤不可访问店** |

### 1.4 使用端与角色

| 端 | 角色 | 能力 |
|----|------|------|
| **C 端** | **已登录且启用的会员** | 查看关注列表、进店、取消关注（若前台提供） |
| **C 端** | 访客 / 未登录 | **不可进入**；引导 **登录/注册** |
| **C 端** | **已禁用会员** | **不可登录**；无法使用本模块 |
| 平台/商家端 | 管理员/商家 | **不操作** 本页面；在 **店铺管理** 等维护店档案 |

---

## 2. 关联需求分析

### 2.1 与 C 端《店铺主页功能需求》

| 项 | 定稿 |
|----|------|
| 职责分工 | 店主页 **提供关注按钮**（SH-F6：列表在本模块）；本模块 **集中展示** 已关注店铺 |
| 关注规则 | 同一会员对同一店铺 **至多一条** 关系（SH-F4）；须 **启用** 会员（SH-F2） |
| 取消关注 | 取消后粉丝数 **减 1**（SH-F3）；在 **店主页** 或 **本列表** 操作 **二选一或并存**（以前台为准） |
| 列表字段 | **头像、名称、评分、粉丝数** 与店主页介绍区 **口径一致**（SH9） |
| 进店 | 点击列表项 → **店铺主页**（带 **shopId**），与搜索页 SRH12、详情 GD13 **同目标页** |
| 店态 | **开业/停业** 均可展示、可进店；**已删** 不可进店且 **不出现在本列表** |

### 2.2 与 C 端《我的服务功能需求》

| 项 | 定稿 |
|----|------|
| 入口位置 | **个人中心 / 我的服务** 下 **独立菜单**「我的店铺关注」（或等价文案）；**须登录** 后可见 |
| 与资料/地址/入驻 | **并列** 关系；**不** 合并为同一表单页 |
| 访问控制 | 对齐 **MS0**：须有效登录 Token；未登录 **拦截** |
| 禁用会员 | 对齐 **§5.2**：禁用后 **不可** 进入本模块 |

### 2.3 与平台《会员管理功能需求》

| 项 | 定稿 |
|----|------|
| 会员对象 | 列表范围 = **当前登录会员**；**不可** 查看他人关注 |
| 是否启用 | 平台禁用 → C 端 **无法登录** → 本模块不可用 |
| 平台侧能力 | 会员详情 **不展示** 关注店铺列表（**非本期** 运营需求） |
| 账号边界 | **店铺经营账号** 与 **买家会员** **不是** 同一登录体系 |

### 2.4 与平台《店铺管理功能需求》

| 项 | 定稿 |
|----|------|
| 展示字段 | **店铺名称、店铺头像** 读店档案；**实时** 或 **进入/刷新列表** 时更新 |
| 店铺状态 | **停业** 店 **仍可出现** 于列表；**可选** 展示「休息中」等标签（以前台为准） |
| 逻辑删除 | **已删** 店铺 **从列表剔除**；用户 **无** 可点击进店（§6.3） |
| 资料变更 | 改店名/头像 **不通知** 本模块；用户 **下拉刷新/重进** 即见最新 |

### 2.5 评分与粉丝（功能语义 · 对齐店铺主页 §2.6）

| 字段 | 说明 |
|------|------|
| **评分** | 店铺综合评分；**评价模块未建设** 时可 **隐藏、占位或 null**，与店主页、详情进店区 **一致** |
| **粉丝数** | 该店 **当前** 被关注会员总数；本会员取消关注后 **减 1**（全站计数，非列表内计算） |

> **边界：** 评分/粉丝 **非** 店铺管理表单字段；**不阻断** 列表展示。

---

## 3. 页面与入口

### 3.1 页面清单

| 页面 | 说明 |
|------|------|
| **A. 我的店铺关注列表** | 当前会员已关注且 **可访问** 的店铺列表 |

**本期仅一页**；无二级筛选 Tab、无搜索（草稿 **未要求**）。

### 3.2 入口（定稿）

| 入口 | 行为 |
|------|------|
| **个人中心 / 我的服务** | 「我的店铺关注」菜单 → **A. 列表页** |
| **其它链入** | 若产品配置快捷入口（消息、空态引导等），须 **带登录态** |

**未登录：** 任意入口 → **引导登录** → 成功后 **可回跳** 列表页（以前台为准）。

### 3.3 与「关注」写入的关系

```text
用户在店铺主页点击「关注」（已登录）
    → 写入关注关系
    → 进入「我的店铺关注」列表（刷新/重进）可见该店

用户在本列表或店主页「取消关注」
    → 移除关系
    → 列表刷新后该店 **消失**
```

---

## 4. 访问控制与前置条件

> 对齐草稿 §1。

### 4.1 统一前置

| 编号 | 规则 |
|------|------|
| **SF0** | 使用本模块 **须** 已通过 **C 端会员登录** 且 Token 有效 |
| **SF1** | 列表数据范围 **仅限当前登录会员**；**不可** 指定他人 memberId |
| **SF2** | **访客** 不可查看列表；**引导登录/注册** |

### 4.2 会员启用状态

```text
平台禁用会员
    → C 端无法登录（或会话失效）
    → 本模块不可用
```

| 编号 | 规则 |
|------|------|
| **SF3** | **已禁用** 会员 **不可** 加载列表、**不可** 取消关注 |

---

## 5. 关注店铺列表

> 对齐草稿 §2～§4。

### 5.1 列表范围

| 项 | 定稿 |
|----|------|
| 数据主体 | **当前登录会员** 的 **关注关系** |
| 店铺范围 | 关联店铺 **未逻辑删除**（`del_flag` 正常）；**已删店不展示** |
| 排序 | **关注时间倒序**（最近关注在前）（草稿 §2） |
| 分页 | 支持 **分页** 或 **上拉加载更多**（以前台 UX 为准） |

### 5.2 列表项展示

| 字段 | 说明 |
|------|------|
| 店铺头像 | 读 **店铺档案** |
| 店铺名称 | 读 **店铺档案** |
| 评分 | §2.5；未建设可隐藏 |
| 粉丝数 | §2.5 |
| 营业状态 | **可选** 停业时展示「休息中」等标签（**不** 因此隐藏条目） |
| 关注时间 | **可不展示** 于 UI（草稿未要求）；排序仍按关注时间 |

**不展示（本期）：** 店铺内商品预览、最近上新、优惠券等（草稿 **未要求**）。

### 5.3 交互

| 操作 | 行为 |
|------|------|
| **点击列表项（整卡）** | 进入 **店铺主页**（带 **shopId**）（草稿 §2） |
| **取消关注** | **可选** 列表项按钮/滑动操作；规则同店主页 **SH-F3**（确认可选 → 移除 → 列表刷新后消失） |
| **下拉刷新** | **建议支持**；重新拉取列表与店档案摘要 |

### 5.4 加载流程

```text
进入 A. 列表页
    → 校验登录态（§4）
    → 加载「当前会员 · 有效店铺」关注列表
        → 成功且有数据 → 按关注时间倒序展示
        → 成功且无数据 → §6.1 空态
        → 失败 → §6.2 错误态
```

---

## 6. 异常与空态

> 草稿 §5「code、msg、data」**不在本文定义**；仅描述 **用户可见** 行为。

### 6.1 空数据

| 情形 | 行为 |
|------|------|
| 从未关注任何店 | 展示 **「暂无关注的店铺」**（或等价文案）；**可** 提供「去逛逛」引导至 **商城首页/搜索**（以前台为准） |
| 曾关注但均已取消 | 同 **空列表** |

### 6.2 加载失败

| 情形 | 行为 |
|------|------|
| 列表加载失败 | **错误提示** + **重试**；**不** 整页白屏 |
| 取消关注失败 | Toast/弹窗提示原因；**不改变** 列表项关注态（仍展示该店） |

### 6.3 店铺不可访问与列表关系

| 情形 | 列表行为 | 用户操作 |
|------|----------|----------|
| 店铺 **已逻辑删除** | **不展示** 该条（关注关系可在后台保留，**对用户不可见**） | — |
| 列表加载后店被删 | 用户 **刷新** 后该条 **消失** | — |
| 店铺 **停业** | **仍展示**；可进店 | 进店后 **不可下单**（详情/结算拦截） |
| 商户 **冻结/注销** | **不自动** 从列表移除（与店主页 §8.2 一致）；若运营要求隐藏，**另版本** 定策略 |

### 6.4 登录态失效

| 情形 | 行为 |
|------|------|
| Token 过期 / 未登录 | **拦截**，引导 **重新登录** |

---

## 7. 页面流程总览

```text
【入口】个人中心 → 我的店铺关注（须登录）
    → A. 关注店铺列表（关注时间 ↓）
        ├── 点击店铺 → 店铺主页（shopId）
        │       └── 可浏览商品 / 店内取消关注
        ├── （可选）列表内取消关注 → 该项移除
        └── 空态 → 引导去首页/搜索

【并行写入路径】
    搜索页店铺 / 详情进店 → 店铺主页 → 关注
        → 本列表（刷新后）出现该店
```

---

## 8. 与下单、浏览的协作

本模块 **不提供** 加购、支付。用户从列表进入 **店铺主页** 再进 **商品详情** 后，须 **同时满足** **《关联需求分析》§11** 四条件方可加购/下单：

| # | 条件 | 不满足时提示方向 |
|---|------|------------------|
| 1 | 商品 = **出售中** | 商品已下架 / 不可购买 |
| 2 | 店铺 = **开业** | 店铺已停业 |
| 3 | 商品所属 **平台分类**（一级、二级）**均显示** | 商品不可购买 |
| 4 | **当前所选规格** 库存 **> 0** | 库存不足 / 缺货 |

| 场景 | 行为 |
|------|------|
| 列表页本身 | **不展示** 商品、**不** 加购 |
| 停业店在列表中 | **允许** 展示并进店浏览 |
| 会员禁用 | **不可** 进本模块；历史关注 **不要求** 平台代清理 |

---

## 9. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **SF1** | 仅 **当前登录会员** 可查列表 |
| **SF2** | 须 **登录且启用** |
| **SF3** | 排序：**关注时间倒序** |
| **SF4** | 列表项字段：**头像、名称、评分、粉丝数**（与店主页一致） |
| **SF5** | 点击 → **店铺主页**（shopId） |
| **SF6** | **新增关注** 在 **店铺主页** 完成，**不在** 本模块 |
| **SF7** | **已删店** **不出现在** 列表 |
| **SF8** | **取消关注** 后列表 **不再展示** 该店 |
| **SF9** | 平台 **不** 代管会员关注列表 UI |
| **SF10** | 本模块 **不** 提供全站店铺搜索 |

---

## 10. 非本期范围

| 项 | 说明 |
|----|------|
| 列表内 **搜索/筛选** 已关注店铺 | 草稿 **未要求** |
| **关注商品/品牌** | 仅 **店铺** 维度 |
| 平台端查看/导出会员关注明细 | 运营 **非本期** |
| 关注 **推送/上新提醒** | 草稿 **未要求** |
| 批量取消关注 | 草稿 **未要求** |
| 分享关注列表、关注排行榜 | 草稿 **未要求** |
| 站内消息「XX 店开业提醒」 | 可另册 |

---

## 11. 草稿对照与修订说明

| 草稿条目 | 本文档处理 |
|----------|------------|
| 首行「搜索页功能模块」 | **笔误**；本文档为 **我的店铺关注**，已纠正定位 |
| §1 已登录前置 | §4 |
| §2 列表、倒序、进店 | §5 |
| §3 头像、名称、评分、粉丝 | §5.2、§2.5 |
| §4 查当前会员关注列表 | §5.1、§4.1 SF1 |
| §5 异常 code/msg/data | §6 **不纳入** |
| §6 技术栈 RuoYi/MySQL | **不纳入** |
| 未写：入口、取消关注、删店、店态、与店主页分工 | §1、§2、§3、§5.3、§6.3 补充 |

---

## 12. 修订记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：关注店铺列表、进店、访问控制；关联店铺主页/我的服务/平台会员与店铺管理 |

---

*文档版本：v1.0（定稿）· 关联《我的店铺关注功能需求-草稿.md》、《关联需求分析.md》v1.6、《店铺主页功能需求.md》v1.0、《我的服务功能需求.md》v1.1、《会员管理功能需求.md》v1.1、《店铺管理功能需求.md》v1.3.6 · 草稿保持不变。*
