# Enagic 本希甄选 - 用户故事与用例

> 本文档从用户视角描述各功能模块的用户故事和用例，包括角色、场景、预期结果和优先级。

---

## 一、用户角色定义

| 角色 | 英文 | 说明 | 典型用户 |
|------|------|------|----------|
| 普通用户 | User | 未注册或注册后未消费 | 访客、潜在客户 |
| 消费商 | Consumer | 注册并消费的用户 | 购买过的客户 |
| 健康布施者 | Health Advisor | 平台推广员，负责邀请客户 | 推广员、分销商 |
| VIP会员 | VIP Member | 付费 VIP 用户 | 高价值客户 |
| 商家 | Seller | Lilishop 商家 | 平台商家 |
| 平台管理员 | Admin | 平台运营管理 | 运营人员 |
| 销售人员 | Sales | 平台销售，负责推广素材 | 销售团队 |

---

## 零、核心交易流程（P0 - 最高优先级）

### 用户故事 0.1：商品浏览与下单

**角色：** 普通用户 / 消费商

**场景：**
> 作为小程序用户，我想浏览商品并下单购买，完成交易。

**详细流程：**
1. 用户进入小程序首页/分类页
2. 浏览商品列表，查看商品详情
3. 选择规格、数量，加入购物车
4. 进入购物车，提交订单
5. 选择支付方式，完成支付
6. 订单创建成功，返回订单详情

**验收标准：**
- [ ] 用户能浏览商品列表
- [ ] 用户能查看商品详情
- [ ] 用户能加入购物车
- [ ] 用户能提交订单
- [ ] 订单支付成功后状态正确更新

**优先级：** P0（核心交易）

**依赖：** 复用 Lilishop 原有订单模块

---

### 用户故事 0.2：订单支付与抵扣金使用

**角色：** 消费商

**场景：**
> 作为有抵扣金的用户，我想在订单支付时使用抵扣金抵扣部分金额。

**详细流程：**
1. 用户进入订单结算页面
2. 系统计算可用抵扣金
3. 用户选择使用抵扣金（可调整金额）
4. 订单提交成功，抵扣金冻结
5. 订单完成后，抵扣金实际扣除

**验收标准：**
- [ ] 结算页面显示可用抵扣金
- [ ] 选择使用后金额正确计算
- [ ] 订单完成后余额正确扣减

**优先级：** P0（核心交易）

---

### 用户故事 0.3：订单发货与运维计划

**角色：** 消费商

**场景：**
> 作为购买客户，订单发货后我想收到服务提醒，了解产品使用信息。

**详细流程：**
1. 商家发货，订单状态变为"已发货"
2. 系统自动创建运维计划
3. 到达节点时间（如第 3 天）
4. 系统发送服务提醒（微信通知/短信）
5. 客户收到提醒消息

**验收标准：**
- [ ] 订单发货后自动创建运维计划
- [ ] 到达节点时间自动发送提醒

**优先级：** P0（核心交易）

---

### 用户故事 0.4：礼品赠送

**角色：** 消费商

**场景：**
> 作为消费者，下单后我想知道是否有礼品赠送，了解赠送规则。

**详细流程：**
1. 用户下单并完成支付
2. 系统根据订单金额匹配赠送规则
3. 订单详情页显示赠送内容
4. 赠送商品随主商品一起发出

**赠送规则：**
- 消费满 X 元 → 赠送 Y 商品
- 消费满 A 元 → 赠送 B 商品
- 规则由后台配置

**验收标准：**
- [ ] 订单支付后显示赠送信息
- [ ] 赠送规则可配置
- [ ] 赠送内容正确展示

**优先级：** P0（核心交易）

---

### 用户故事 0.5：推荐人指定赠送（P2）

**角色：** 健康布施者（推荐人）

**场景：**
> 作为推荐人（健康布施者），我想为被推荐的客户指定赠送的商品。

**详细流程：**
1. 客户下单
2. 系统检测到推荐关系
3. 推荐人进入"指定赠送"页面
4. 选择赠送商品（从可赠送列表中选择）
5. 确认指定
6. 订单备注更新赠送信息

**验收标准：**
- [ ] 推荐人可查看被推荐客户的订单
- [ ] 推荐人可选择赠送商品
- [ ] 指定的赠送内容更新到订单

**优先级：** P2（可后续实现）

---

## 零.1、销售素材模块（P0）

### 用户故事 0.6：销售素材分享

**角色：** 销售人员 / 健康布施者

**场景：**
> 作为销售人员，我想获取推广素材（图片、视频、文案），方便分享给客户。

**详细流程：**
1. 销售人员进入素材中心
2. 浏览素材分类（产品介绍、活动海报、健康知识等）
3. 点击素材，生成带参数的分享链接/二维码
4. 分享给潜在客户

**素材类型：**
- 图片（商品海报、活动图）
- 视频（产品演示、使用教程）
- 文案（推广话术）
- 链接（小程序页面）

**验收标准：**
- [ ] 素材库有分类展示
- [ ] 可生成分享链接/二维码
- [ ] 链接带追踪参数（来源销售ID）

**优先级：** P0

---

### 用户故事 0.7：素材追踪与统计

**角色：** 销售人员

**场景：**
> 作为销售人员，我想知道分享的素材带来了多少浏览和转化。

**详细流程：**
1. 销售人员分享素材
2. 客户扫码/点击链接访问
3. 系统记录访问来源（销售ID）
4. 销售人员查看素材效果统计
5. 统计：浏览次数、访问人数、转化订单

**验收标准：**
- [ ] 素材访问带销售追踪参数
- [ ] 销售可查看素材效果数据

**优先级：** P0

---

### 用户故事 0.8：素材权限控制

**角色：** 普通用户 / 消费商

**场景：**
> 作为不同角色的用户，我想看到不同级别的素材内容。

**详细流程：**
1. 商家上传素材时设置可见角色
2. 用户访问素材时检查权限
3. 消费商可看全部素材
4. 普通用户只看公开素材

**验收标准：**
- [ ] 商家可设置素材可见角色
- [ ] 普通用户只能看到允许的素材

**优先级：** P0

---

## 二、AI 数字人模块

### 用户故事 1：智能咨询

**角色：** 普通用户 / 消费商

**场景：**
> 作为小程序用户，我想通过 AI 健康顾问咨询产品相关信息，以便快速获取答案。

**详细流程：**
1. 用户进入小程序，点击"AI 健康顾问"入口
2. 页面加载，展示对话历史（如有）
3. 用户输入问题："这个产品怎么使用？"
4. 系统进行敏感词检查 → 知识库检索 → AI 回答
5. 回答展示在对话区域，包含知识库相关内容
6. 对话记录自动保存到后台

**验收标准：**
- [ ] 用户能进入 AI 对话页面
- [ ] 发送问题后 5 秒内收到回答
- [ ] 回答包含相关产品知识
- [ ] 对话历史在刷新后仍可见

**优先级：** P0（必须实现）

---

### 用户故事 2：快捷问题

**角色：** 普通用户

**场景：**
> 作为首次使用 AI 的用户，我想通过快捷问题快速了解功能，减少输入成本。

**详细流程：**
1. 用户进入 AI 对话页面
2. 页面底部显示热门问题标签："如何使用"、"产品功效"、"健康建议"
3. 用户点击"如何使用"标签
4. 问题自动填入输入框
5. 用户点击发送

**验收标准：**
- [ ] 页面显示至少 3 个热门问题
- [ ] 点击问题自动填入输入框

**优先级：** P1（重要）

---

## 三、健康布施者模块

### 用户故事 3：申请成为健康布施者

**角色：** 消费商

**场景：**
> 作为消费商，我想申请成为健康布施者，以便邀请更多客户获得奖励。

**详细流程：**
1. 消费商进入个人中心，点击"成为健康布施者"
2. 填写实名信息：真实姓名、身份证号
3. 提交申请
4. 系统审核（自动通过）
5. 跳转至健康布施者中心页面

**验收标准：**
- [ ] 消费商可提交申请
- [ ] 申请提交后状态变为 ACTIVE
- [ ] 申请成功后可进入布施者中心

**优先级：** P0（必须实现）

---

### 用户故事 4：邀请客户

**角色：** 健康布施者

**场景：**
> 作为健康布施者，我想生成邀请二维码，让客户扫码注册并绑定关系。

**详细流程：**
1. 健康布施者进入布施者中心
2. 点击"邀请二维码"
3. 系统生成带参数的小程序码
4. 布施者分享二维码给潜在客户
5. 客户扫码 → 跳转小程序 → 自动携带邀请参数
6. 客户注册时自动绑定关系

**验收标准：**
- [ ] 布施者能生成邀请二维码
- [ ] 二维码包含布施者 ID
- [ ] 客户扫码后能成功建立邀请关系

**优先级：** P0（必须实现）

---

### 用户故事 5：查看客户列表

**角色：** 健康布施者

**场景：**
> 作为健康布施者，我想查看我邀请的客户列表，了解客户情况。

**详细流程：**
1. 健康布施者进入布施者中心
2. 点击"我的客户"
3. 页面展示客户列表：头像、昵称、注册时间、累计消费
4. 支持搜索客户名称

**验收标准：**
- [ ] 能查看已邀请的客户列表
- [ ] 列表显示客户基本信息
- [ ] 支持分页加载

**优先级：** P0（必须实现）

---

### 用户故事 6：获取勋章

**角色：** 健康布施者

**场景：**
> 作为健康布施者，我想通过邀请客户获得勋章，提升荣誉等级。

**详细流程：**
1. 健康布施者成功邀请第 1 位客户
2. 系统自动检查：totalInvites >= 1
3. 发放一星勋章，更新 medalLevel
4. 继续邀请达到 5 人 → 二星勋章
5. 达到 20 人 → 三星勋章
6. 达到 50 人 → 宗师勋章

**验收标准：**
- [ ] 达到邀请人数自动发放对应勋章
- [ ] 勋章显示在布施者中心
- [ ] 勋章等级正确显示

**优先级：** P1（重要）

---

### 用户故事 7：手动转移客户（管理端）

**角色：** 平台管理员

**场景：**
> 作为管理员，我想手动将客户从一个健康布施者转移到另一个。

**详细流程：**
1. 管理员进入客户移交管理页面
2. 选择要转移的会员
3. 选择原布施者、新布施者
4. 输入转移原因
5. 提交转移申请
6. 系统创建转移记录，更新客户绑定关系

**验收标准：**
- [ ] 管理员可选择会员和布施者
- [ ] 转移后关系正确更新
- [ ] 转移记录可查询

**优先级：** P1（重要）

---

## 四、VIP 会员模块

### 用户故事 8：开通 VIP

**角色：** 消费商

**场景：**
> 作为消费商，我想开通 VIP 会员，享受专属权益。

**详细流程：**
1. 用户进入 VIP 页面
2. 浏览 VIP 套餐选项
3. 选择想要的套餐（银卡/金卡/钻石）
4. 点击"立即开通"
5. 完成支付
6. 跳转至"我的 VIP"页面，显示 VIP 权益

**验收标准：**
- [ ] 用户能看到 VIP 套餐列表
- [ ] 支付完成后 VIP 状态生效
- [ ] "我的 VIP"页面正确显示 VIP 信息

**优先级：** P0（必须实现）

---

### 用户故事 9：VIP 感恩提醒

**角色：** VIP 会员

**场景：**
> 作为 VIP 会员，我想定期收到分享激励提醒，参与平台活动。

**详细流程：**
1. VIP 会员开通 VIP（永久）
2. 连续 30 天无分享行为
3. 定时任务检测到，发送感恩提醒消息
4. 消息内容："亲爱的 VIP，您已 X 天没有分享好物了..."

**验收标准：**
- [ ] 长期未分享的 VIP 收到提醒消息
- [ ] 提醒消息正确发送

**优先级：** P2（优化）

---

## 五、抵扣金模块

### 用户故事 10：查看抵扣金

**角色：** 消费商

**场景：**
> 作为消费商，我想查看我的抵扣金账户余额和明细。

**详细流程：**
1. 消费商进入抵扣金页面
2. 显示可用余额、冻结金额
3. 点击"明细"查看流水记录
4. 流水显示：类型、金额、时间、订单号

**验收标准：**
- [ ] 页面显示可用余额和冻结金额
- [ ] 明细显示完整流水记录
- [ ] 支持分页查看

**优先级：** P0（必须实现）

---

### 用户故事 11：使用抵扣金

**角色：** 消费商

**场景：**
> 作为有抵扣金的用户，我想在订单支付时使用抵扣金抵扣部分金额。

**详细流程：**
1. 用户下单，进入结算页面
2. 系统计算可用抵扣金
3. 用户选择使用抵扣金（可调整金额）
4. 订单提交成功
5. 抵扣金冻结
6. 订单完成后，抵扣金实际扣除

**验收标准：**
- [ ] 结算页面显示可用抵扣金
- [ ] 选择使用后金额正确计算
- [ ] 订单完成后余额正确扣减

**优先级：** P0（必须实现）

---

## 六、客户运维模块

### 用户故事 12：查看运维计划

**角色：** 消费商

**场景：**
> 作为已购客户，我想查看我的运维计划进度，了解服务节点。

**详细流程：**
1. 客户进入"我的运维计划"页面
2. 页面展示进行中的运维计划
3. 显示：流程名称、当前节点、下次提醒时间
4. 点击计划查看详细记录

**验收标准：**
- [ ] 客户能看到自己的运维计划
- [ ] 显示当前节点和进度

**优先级：** P0（必须实现）

---

### 用户故事 13：运维提醒

**角色：** 消费商

**场景：**
> 作为已购客户，我想在运维节点收到服务提醒，了解产品使用信息。

**详细流程：**
1. 订单发货后，系统创建运维计划
2. 到达节点时间（如第 3 天）
3. 系统发送微信通知/AI 提醒
4. 客户收到提醒消息

**验收标准：**
- [ ] 订单发货后自动创建运维计划
- [ ] 到达节点时间自动发送提醒

**优先级：** P0（必须实现）

---

### 用户故事 14：手动提醒（管理端）

**角色：** 平台管理员

**场景：**
> 作为管理员，我想手动触发运维提醒，主动关怀客户。

**详细流程：**
1. 管理员进入运维计划管理页面
2. 找到目标计划
3. 点击"提醒"按钮
4. 系统立即发送提醒消息

**验收标准：**
- [ ] 管理员可手动触发提醒
- [ ] 触发后消息正确发送

**优先级：** P1（重要）

---

### 用户故事 15：创建运维流程（管理端）

**角色：** 平台管理员

**场景：**
> 作为管理员，我想自定义运维流程模板，配置服务节点。

**详细流程：**
1. 管理员进入运维流程管理页面
2. 点击"新增流程"
3. 填写：流程名称、描述、节点配置（JSON）
4. 保存流程
5. 流程创建成功，可在计划中使用

**验收标准：**
- [ ] 管理员可创建运维流程
- [ ] 节点配置正确保存
- [ ] 流程可被运维计划引用

**优先级：** P0（必须实现）

---

## 七、素材二维码模块

### 用户故事 16：生成素材二维码

**角色：** 消费商

**场景：**
> 作为消费商，我想生成分享素材的二维码，方便分享给朋友。

**详细流程：**
1. 用户打开素材详情页
2. 点击"分享"按钮
3. 系统生成带参数的二维码
4. 二维码包含：素材 ID、分享者 ID、有效期
5. 用户保存或直接分享

**验收标准：**
- [ ] 用户可生成素材二维码
- [ ] 二维码包含正确的追踪参数

**优先级：** P1（重要）

---

### 用户故事 17：扫码绑定关系

**角色：** 普通用户

**场景：**
> 作为普通用户，我通过朋友分享的二维码扫码访问，自动建立邀请关系。

**详细流程：**
1. 用户扫描带参数的二维码
2. 小程序读取 URL 参数：articleId、inviter、expire
3. 用户注册/登录
4. 系统自动将用户绑定到 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*