我的店铺关注 — 功能需求说明（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 在业务链中的位置
【用户链】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 与「关注」写入的关系
用户在店铺主页点击「关注」（已登录）
→ 写入关注关系
→ 进入「我的店铺关注」列表（刷新/重进）可见该店
用户在本列表或店主页「取消关注」
→ 移除关系
→ 列表刷新后该店 **消失**
4. 访问控制与前置条件
对齐草稿 §1。
4.1 统一前置
| 编号 |
规则 |
| SF0 |
使用本模块 须 已通过 C 端会员登录 且 Token 有效 |
| SF1 |
列表数据范围 仅限当前登录会员；不可 指定他人 memberId |
| SF2 |
访客 不可查看列表；引导登录/注册 |
4.2 会员启用状态
平台禁用会员
→ 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 加载流程
进入 A. 列表页
→ 校验登录态（§4）
→ 加载「当前会员 · 有效店铺」关注列表
→ 成功且有数据 → 按关注时间倒序展示
→ 成功且无数据 → §6.1 空态
→ 失败 → §6.2 错误态
6. 异常与空态
草稿 §5「code、msg、data」不在本文定义；仅描述 用户可见 行为。
6.1 空数据
| 情形 |
行为 |
| 从未关注任何店 |
展示 「暂无关注的店铺」（或等价文案）；可 提供「去逛逛」引导至 商城首页/搜索（以前台为准） |
| 曾关注但均已取消 |
同 空列表 |
6.2 加载失败
| 情形 |
行为 |
| 列表加载失败 |
错误提示 + 重试；不 整页白屏 |
| 取消关注失败 |
Toast/弹窗提示原因；不改变 列表项关注态（仍展示该店） |
6.3 店铺不可访问与列表关系
| 情形 |
列表行为 |
用户操作 |
| 店铺 已逻辑删除 |
不展示 该条（关注关系可在后台保留，对用户不可见） |
— |
| 列表加载后店被删 |
用户 刷新 后该条 消失 |
— |
| 店铺 停业 |
仍展示；可进店 |
进店后 不可下单（详情/结算拦截） |
| 商户 冻结/注销 |
不自动 从列表移除（与店主页 §8.2 一致）；若运营要求隐藏，另版本 定策略 |
|
6.4 登录态失效
| 情形 |
行为 |
| Token 过期 / 未登录 |
拦截，引导 重新登录 |
7. 页面流程总览
【入口】个人中心 → 我的店铺关注（须登录）
→ 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 · 草稿保持不变。
