SPEC_USERSTORIES.md 18 KB
Enagic 本希甄选 - 用户故事与用例
本文档从用户视角描述各功能模块的用户故事和用例，包括角色、场景、预期结果和优先级。
一、用户角色定义
| 角色 | 英文 | 说明 | 典型用户 |
|---|---|---|---|
| 普通用户 | User | 未注册或注册后未消费 | 访客、潜在客户 |
| 消费商 | Consumer | 注册并消费的用户 | 购买过的客户 |
| 健康布施者 | Health Advisor | 平台推广员，负责邀请客户 | 推广员、分销商 |
| VIP会员 | VIP Member | 付费 VIP 用户 | 高价值客户 |
| 商家 | Seller | Lilishop 商家 | 平台商家 |
| 平台管理员 | Admin | 平台运营管理 | 运营人员 |
| 销售人员 | Sales | 平台销售，负责推广素材 | 销售团队 |
零、核心交易流程（P0 - 最高优先级）
用户故事 0.1：商品浏览与下单
角色： 普通用户 / 消费商
场景：
作为小程序用户，我想浏览商品并下单购买，完成交易。
详细流程：
- 用户进入小程序首页/分类页
- 浏览商品列表，查看商品详情
- 选择规格、数量，加入购物车
- 进入购物车，提交订单
- 选择支付方式，完成支付
- 订单创建成功，返回订单详情
验收标准：
- 用户能浏览商品列表
- 用户能查看商品详情
- 用户能加入购物车
- 用户能提交订单
- 订单支付成功后状态正确更新
优先级： P0（核心交易）
依赖： 复用 Lilishop 原有订单模块
用户故事 0.2：订单支付与抵扣金使用
角色： 消费商
场景：
作为有抵扣金的用户，我想在订单支付时使用抵扣金抵扣部分金额。
详细流程：
- 用户进入订单结算页面
- 系统计算可用抵扣金
- 用户选择使用抵扣金（可调整金额）
- 订单提交成功，抵扣金冻结
- 订单完成后，抵扣金实际扣除
验收标准：
- 结算页面显示可用抵扣金
- 选择使用后金额正确计算
- 订单完成后余额正确扣减
优先级： P0（核心交易）
用户故事 0.3：订单发货与运维计划
角色： 消费商
场景：
作为购买客户，订单发货后我想收到服务提醒，了解产品使用信息。
详细流程：
- 商家发货，订单状态变为"已发货"
- 系统自动创建运维计划
- 到达节点时间（如第 3 天）
- 系统发送服务提醒（微信通知/短信）
- 客户收到提醒消息
验收标准：
- 订单发货后自动创建运维计划
- 到达节点时间自动发送提醒
优先级： P0（核心交易）
用户故事 0.4：礼品赠送
角色： 消费商
场景：
作为消费者，下单后我想知道是否有礼品赠送，了解赠送规则。
详细流程：
- 用户下单并完成支付
- 系统根据订单金额匹配赠送规则
- 订单详情页显示赠送内容
- 赠送商品随主商品一起发出
赠送规则：
- 消费满 X 元 → 赠送 Y 商品
- 消费满 A 元 → 赠送 B 商品
- 规则由后台配置
验收标准：
- 订单支付后显示赠送信息
- 赠送规则可配置
- 赠送内容正确展示
优先级： P0（核心交易）
用户故事 0.5：推荐人指定赠送（P2）
角色： 健康布施者（推荐人）
场景：
作为推荐人（健康布施者），我想为被推荐的客户指定赠送的商品。
详细流程：
- 客户下单
- 系统检测到推荐关系
- 推荐人进入"指定赠送"页面
- 选择赠送商品（从可赠送列表中选择）
- 确认指定
- 订单备注更新赠送信息
验收标准：
- 推荐人可查看被推荐客户的订单
- 推荐人可选择赠送商品
- 指定的赠送内容更新到订单
优先级： P2（可后续实现）
零.1、销售素材模块（P0）
用户故事 0.6：销售素材分享
角色： 销售人员 / 健康布施者
场景：
作为销售人员，我想获取推广素材（图片、视频、文案），方便分享给客户。
详细流程：
- 销售人员进入素材中心
- 浏览素材分类（产品介绍、活动海报、健康知识等）
- 点击素材，生成带参数的分享链接/二维码
- 分享给潜在客户
素材类型：
- 图片（商品海报、活动图）
- 视频（产品演示、使用教程）
- 文案（推广话术）
- 链接（小程序页面）
验收标准：
- 素材库有分类展示
- 可生成分享链接/二维码
- 链接带追踪参数（来源销售ID）
优先级： P0
用户故事 0.7：素材追踪与统计
角色： 销售人员
场景：
作为销售人员，我想知道分享的素材带来了多少浏览和转化。
详细流程：
- 销售人员分享素材
- 客户扫码/点击链接访问
- 系统记录访问来源（销售ID）
- 销售人员查看素材效果统计
- 统计：浏览次数、访问人数、转化订单
验收标准：
- 素材访问带销售追踪参数
- 销售可查看素材效果数据
优先级： P0
用户故事 0.8：素材权限控制
角色： 普通用户 / 消费商
场景：
作为不同角色的用户，我想看到不同级别的素材内容。
详细流程：
- 商家上传素材时设置可见角色
- 用户访问素材时检查权限
- 消费商可看全部素材
- 普通用户只看公开素材
验收标准：
- 商家可设置素材可见角色
- 普通用户只能看到允许的素材
优先级： P0
二、AI 数字人模块
用户故事 1：智能咨询
角色： 普通用户 / 消费商
场景：
作为小程序用户，我想通过 AI 健康顾问咨询产品相关信息，以便快速获取答案。
详细流程：
- 用户进入小程序，点击"AI 健康顾问"入口
- 页面加载，展示对话历史（如有）
- 用户输入问题："这个产品怎么使用？"
- 系统进行敏感词检查 → 知识库检索 → AI 回答
- 回答展示在对话区域，包含知识库相关内容
- 对话记录自动保存到后台
验收标准：
- 用户能进入 AI 对话页面
- 发送问题后 5 秒内收到回答
- 回答包含相关产品知识
- 对话历史在刷新后仍可见
优先级： P0（必须实现）
用户故事 2：快捷问题
角色： 普通用户
场景：
作为首次使用 AI 的用户，我想通过快捷问题快速了解功能，减少输入成本。
详细流程：
- 用户进入 AI 对话页面
- 页面底部显示热门问题标签："如何使用"、"产品功效"、"健康建议"
- 用户点击"如何使用"标签
- 问题自动填入输入框
- 用户点击发送
验收标准：
- 页面显示至少 3 个热门问题
- 点击问题自动填入输入框
优先级： P1（重要）
三、健康布施者模块
用户故事 3：申请成为健康布施者
角色： 消费商
场景：
作为消费商，我想申请成为健康布施者，以便邀请更多客户获得奖励。
详细流程：
- 消费商进入个人中心，点击"成为健康布施者"
- 填写实名信息：真实姓名、身份证号
- 提交申请
- 系统审核（自动通过）
- 跳转至健康布施者中心页面
验收标准：
- 消费商可提交申请
- 申请提交后状态变为 ACTIVE
- 申请成功后可进入布施者中心
优先级： P0（必须实现）
用户故事 4：邀请客户
角色： 健康布施者
场景：
作为健康布施者，我想生成邀请二维码，让客户扫码注册并绑定关系。
详细流程：
- 健康布施者进入布施者中心
- 点击"邀请二维码"
- 系统生成带参数的小程序码
- 布施者分享二维码给潜在客户
- 客户扫码 → 跳转小程序 → 自动携带邀请参数
- 客户注册时自动绑定关系
验收标准：
- 布施者能生成邀请二维码
- 二维码包含布施者 ID
- 客户扫码后能成功建立邀请关系
优先级： P0（必须实现）
用户故事 5：查看客户列表
角色： 健康布施者
场景：
作为健康布施者，我想查看我邀请的客户列表，了解客户情况。
详细流程：
- 健康布施者进入布施者中心
- 点击"我的客户"
- 页面展示客户列表：头像、昵称、注册时间、累计消费
- 支持搜索客户名称
验收标准：
- 能查看已邀请的客户列表
- 列表显示客户基本信息
- 支持分页加载
优先级： P0（必须实现）
用户故事 6：获取勋章
角色： 健康布施者
场景：
作为健康布施者，我想通过邀请客户获得勋章，提升荣誉等级。
详细流程：
- 健康布施者成功邀请第 1 位客户
- 系统自动检查：totalInvites >= 1
- 发放一星勋章，更新 medalLevel
- 继续邀请达到 5 人 → 二星勋章
- 达到 20 人 → 三星勋章
- 达到 50 人 → 宗师勋章
验收标准：
- 达到邀请人数自动发放对应勋章
- 勋章显示在布施者中心
- 勋章等级正确显示
优先级： P1（重要）
用户故事 7：手动转移客户（管理端）
角色： 平台管理员
场景：
作为管理员，我想手动将客户从一个健康布施者转移到另一个。
详细流程：
- 管理员进入客户移交管理页面
- 选择要转移的会员
- 选择原布施者、新布施者
- 输入转移原因
- 提交转移申请
- 系统创建转移记录，更新客户绑定关系
验收标准：
- 管理员可选择会员和布施者
- 转移后关系正确更新
- 转移记录可查询
优先级： P1（重要）
四、VIP 会员模块
用户故事 8：开通 VIP
角色： 消费商
场景：
作为消费商，我想开通 VIP 会员，享受专属权益。
详细流程：
- 用户进入 VIP 页面
- 浏览 VIP 套餐选项
- 选择想要的套餐（银卡/金卡/钻石）
- 点击"立即开通"
- 完成支付
- 跳转至"我的 VIP"页面，显示 VIP 权益
验收标准：
- 用户能看到 VIP 套餐列表
- 支付完成后 VIP 状态生效
- "我的 VIP"页面正确显示 VIP 信息
优先级： P0（必须实现）
用户故事 9：VIP 感恩提醒
角色： VIP 会员
场景：
作为 VIP 会员，我想定期收到分享激励提醒，参与平台活动。
详细流程：
- VIP 会员开通 VIP（永久）
- 连续 30 天无分享行为
- 定时任务检测到，发送感恩提醒消息
- 消息内容："亲爱的 VIP，您已 X 天没有分享好物了..."
验收标准：
- 长期未分享的 VIP 收到提醒消息
- 提醒消息正确发送
优先级： P2（优化）
五、抵扣金模块
用户故事 10：查看抵扣金
角色： 消费商
场景：
作为消费商，我想查看我的抵扣金账户余额和明细。
详细流程：
- 消费商进入抵扣金页面
- 显示可用余额、冻结金额
- 点击"明细"查看流水记录
- 流水显示：类型、金额、时间、订单号
验收标准：
- 页面显示可用余额和冻结金额
- 明细显示完整流水记录
- 支持分页查看
优先级： P0（必须实现）
用户故事 11：使用抵扣金
角色： 消费商
场景：
作为有抵扣金的用户，我想在订单支付时使用抵扣金抵扣部分金额。
详细流程：
- 用户下单，进入结算页面
- 系统计算可用抵扣金
- 用户选择使用抵扣金（可调整金额）
- 订单提交成功
- 抵扣金冻结
- 订单完成后，抵扣金实际扣除
验收标准：
- 结算页面显示可用抵扣金
- 选择使用后金额正确计算
- 订单完成后余额正确扣减
优先级： P0（必须实现）
六、客户运维模块
用户故事 12：查看运维计划
角色： 消费商
场景：
作为已购客户，我想查看我的运维计划进度，了解服务节点。
详细流程：
- 客户进入"我的运维计划"页面
- 页面展示进行中的运维计划
- 显示：流程名称、当前节点、下次提醒时间
- 点击计划查看详细记录
验收标准：
- 客户能看到自己的运维计划
- 显示当前节点和进度
优先级： P0（必须实现）
用户故事 13：运维提醒
角色： 消费商
场景：
作为已购客户，我想在运维节点收到服务提醒，了解产品使用信息。
详细流程：
- 订单发货后，系统创建运维计划
- 到达节点时间（如第 3 天）
- 系统发送微信通知/AI 提醒
- 客户收到提醒消息
验收标准：
- 订单发货后自动创建运维计划
- 到达节点时间自动发送提醒
优先级： P0（必须实现）
用户故事 14：手动提醒（管理端）
角色： 平台管理员
场景：
作为管理员，我想手动触发运维提醒，主动关怀客户。
详细流程：
- 管理员进入运维计划管理页面
- 找到目标计划
- 点击"提醒"按钮
- 系统立即发送提醒消息
验收标准：
- 管理员可手动触发提醒
- 触发后消息正确发送
优先级： P1（重要）
用户故事 15：创建运维流程（管理端）
角色： 平台管理员
场景：
作为管理员，我想自定义运维流程模板，配置服务节点。
详细流程：
- 管理员进入运维流程管理页面
- 点击"新增流程"
- 填写：流程名称、描述、节点配置（JSON）
- 保存流程
- 流程创建成功，可在计划中使用
验收标准：
- 管理员可创建运维流程
- 节点配置正确保存
- 流程可被运维计划引用
优先级： P0（必须实现）
七、素材二维码模块
用户故事 16：生成素材二维码
角色： 消费商
场景：
作为消费商，我想生成分享素材的二维码，方便分享给朋友。
详细流程：
- 用户打开素材详情页
- 点击"分享"按钮
- 系统生成带参数的二维码
- 二维码包含：素材 ID、分享者 ID、有效期
- 用户保存或直接分享
验收标准：
- 用户可生成素材二维码
- 二维码包含正确的追踪参数
优先级： P1（重要）
用户故事 17：扫码绑定关系
角色： 普通用户
场景：
作为普通用户，我通过朋友分享的二维码扫码访问，自动建立邀请关系。
详细流程：
- 用户扫描带参数的二维码
- 小程序读取 URL 参数：articleId、inviter、expire
- 用户注册/登录
- 系统自动将用户绑定到 inviter 对应的健康布施者
验收标准：
- 扫码后成功建立邀请关系
- 关系正确记录到数据库
优先级： P0（必须实现）
八、用例汇总表
| # | 用例名称 | 角色 | 优先级 | 阶段 |
|---|---|---|---|---|
| 核心交易 | ||||
| 0.1 | 商品浏览与下单 | 用户 | P0 | Phase 1 |
| 0.2 | 订单支付与抵扣金使用 | 消费商 | P0 | Phase 2 |
| 0.3 | 订单发货与运维计划 | 消费商 | P0 | Phase 1 |
| 0.4 | 礼品赠送（自动配置） | 消费商 | P0 | Phase 1 |
| 0.5 | 推荐人指定赠送（P2） | 健康布施者 | P2 | Phase 2 |
| 销售素材 | ||||
| 0.6 | 销售素材分享 | 销售/布施者 | P0 | Phase 1 |
| 0.7 | 素材追踪与统计 | 销售人员 | P0 | Phase 1 |
| 0.8 | 素材权限控制 | 用户 | P0 | Phase 1 |
| 健康布施者 | ||||
| 3 | 申请成为健康布施者 | 消费商 | P0 | Phase 2 |
| 4 | 邀请客户 | 健康布施者 | P0 | Phase 2 |
| 5 | 查看客户列表 | 健康布施者 | P0 | Phase 2 |
| 6 | 获取勋章 | 健康布施者 | P2 | Phase 2 |
| 7 | 手动转移客户 | 管理员 | P2 | Phase 2 |
| VIP/抵扣金 | ||||
| 8 | 开通 VIP | 消费商 | P0 | Phase 2 |
| 9 | VIP 感恩提醒 | VIP | P2 | Phase 3 |
| 10 | 查看抵扣金 | 消费商 | P0 | Phase 2 |
| 11 | 使用抵扣金 | 消费商 | P0 | Phase 2 |
| 运维 | ||||
| 12 | 查看运维计划 | 消费商 | P0 | Phase 3 |
| 13 | 运维提醒 | 消费商 | P0 | Phase 3 |
| 14 | 手动提醒 | 管理员 | P2 | Phase 3 |
| 15 | 创建运维流程 | 管理员 | P0 | Phase 3 |
| 17 | 扫码绑定关系 | 用户 | P0 | Phase 5 |
| AI（P2） | ||||
| 1 | AI 智能咨询 | 用户 | P2 | Phase 4 |
| 2 | 快捷问题入口 | 用户 | P2 | Phase 4 |
九、P0 优先级清单（重新整理）
Phase 1（P0 - 核心交易与素材）
| # | 用例名称 | 角色 | 说明 |
|---|---|---|---|
| 0.1 | 商品浏览与下单 | 用户 | 复用 Lilishop 订单模块 |
| 0.3 | 订单发货与运维计划 | 消费商 | 订单发货触发运维计划 |
| 0.4 | 礼品赠送 | 消费商 | 根据消费金额自动配置赠送 |
| 0.6 | 销售素材分享 | 销售/布施者 | 素材中心，生成分享 |
| 0.7 | 素材追踪与统计 | 销售人员 | 访问来源追踪 |
| 0.8 | 素材权限控制 | 用户 | 素材可见性控制 |
Phase 2（P0 - 业务扩展）
| # | 用例名称 | 角色 | 说明 |
|---|---|---|---|
| 0.2 | 订单支付与抵扣金使用 | 消费商 | 抵扣金冻结/扣减 |
| 3 | 申请成为健康布施者 | 消费商 | 申请入口 |
| 4 | 邀请客户 | 健康布施者 | 邀请二维码 |
| 5 | 查看客户列表 | 健康布施者 | 客户管理 |
| 8 | 开通 VIP | 消费商 | VIP 开通 |
| 10 | 查看抵扣金 | 消费商 | 账户查询 |
| 11 | 使用抵扣金 | 消费商 | 订单使用 |
Phase 3（P0 - 运维）
| # | 用例名称 | 角色 | 说明 |
|---|---|---|---|
| 12 | 查看运维计划 | 消费商 | 客户查看进度 |
| 13 | 运维提醒 | 消费商 | 自动节点提醒 |
| 15 | 创建运维流程 | 管理员 | 流程模板配置 |
Phase 5（P0）
| # | 用例名称 | 角色 | 说明 |
|---|---|---|---|
| 17 | 扫码绑定关系 | 用户 | 邀请关系绑定 |
文档版本：V1.1 更新日期：2026-05-08