# 医养商城 模块规划

---

## 1. 模块定位

医养商城是整个智慧医养平台中**与 mall 契合度最高（A级）的模块**，面向老人、家属及机构提供医疗养老相关商品和服务的 B2C/B2B 电商平台，涵盖商品销售（医疗器械/保健品/辅具/适老化用品）、服务类商品（上门护理/到家就诊）、IoT 设备租赁、直播带货等 420+ 功能细项。

mall 的核心电商能力（商品管理/订单/支付/物流/营销/商家入驻）可以直接在此场景复用，但需识别出"写在医养商城章节但本质属于其他系统（HIS/IoT/EMR）的功能"，这些功能须独立建设，不可堆入 mall。

---

## 2. 建设目标

1. 基于 mall 平台快速构建医养垂直电商能力，覆盖实物商品和服务商品
2. 接入多品类服务商（医疗器械/保健品/适老化/康复辅具），实现多商家入驻
3. 提供 IoT 设备租赁/分期购买能力（呼叫器/血压仪/防跌倒手环等）
4. 落地直播带货能力（老人适用的直播形式）
5. 实现私域流量体系（家庭群/社区群/老人圈互动转化）
6. 打通与其他模块的数据（健康档案→智能推荐，服务评估→服务类商品推荐）

---

## 3. 核心功能范围

### 3.1 一级模块

- 商品管理
- 用户交互
- 订单管理
- 物流配送
- 数据分析
- 营销推广
- 客服售后
- 商家入驻
- 生态商家对接
- 私域营销
- 直播带货

### 3.2 二级模块

- **商品管理**：商品CRUD、SPU/SKU、分类（医疗器械/保健品/适老化/康复辅具/服务类）、审核、下架、批量导入
- **用户交互**：搜索/筛选/评价、老年友好界面（大字体/高对比色/语音搜索）
- **订单管理**：下单/付款/发货/收货/退款/客服全链路，含服务类订单（预约制）
- **IoT设备租赁**：设备租期管理、押金、到期续租、设备归还、维修工单
- **物流配送**：接入快递（快递100聚合）+ mall骑手配送（本地即时配送）
- **营销推广**：优惠券/满减/积分/会员/拼团/闪购/推荐奖励
- **客服售后**：在线客服（IM）+ 工单 + 退款仲裁
- **商家入驻**：资质审核（医疗器械经营许可）+ 商品审核 + 结算分账
- **生态商家对接**：外部健康服务平台API接入（⚠️ 待确认合作商家）
- **私域营销**：家庭群裂变、家属端分享给子女、社区话题种草
- **直播带货**：商品链接挂载、直播间下单、直播数据分析

### 3.3 核心功能说明

**区分关键：mall能力可复用 vs 须独立建设**

| 功能类型 | 功能                               | 归属                    | 建设方式            |
| -------- | ---------------------------------- | ----------------------- | ------------------- |
| 真正电商 | 商品管理/SKU/购物车/下单/支付/退款 | mall核心                | **直接复用/小改造** |
| 真正电商 | 商家入驻/结算分账/物流             | mall能力                | **直接复用**        |
| 真正电商 | 优惠券/积分/会员/拼团              | mall营销                | **直接复用**        |
| 真正电商 | 在线客服/工单                      | mall能力                | **直接复用**        |
| 垂直扩展 | 医疗器械分类/资质审核（经营许可）  | 医养扩展                | mall基础+扩展字段   |
| 垂直扩展 | 服务类商品（预约制订单）           | 医养扩展                | mall订单+服务化改造 |
| 垂直扩展 | 老年友好UI/语音搜索                | 前端改造                | uni-app改造         |
| 须独立   | IoT设备租赁管理（租期/押金/归还）  | IoT管理（16）+ 商城联动 | 独立租赁服务        |
| 须独立   | 健康档案驱动的智能推荐             | AI服务（22）提供        | 独立AI推荐服务      |
| 须独立   | 直播带货                           | 22或独立直播服务        | 独立流媒体服务      |
| 须独立   | 处方流转/药品销售（需资质）        | 中心药房（21）          | 独立药房系统        |

---

## 4. 与现有 mall 的关系

**契合度：A（高契合，核心电商功能直接复用）**

mall 作为本模块的技术底座，可以直接提供以下能力：

| 能力域     | 可复用内容                       | 复用程度                             |
| ---------- | -------------------------------- | ------------------------------------ |
| 商品体系   | SPU/SKU/分类/属性/图片/价格/库存 | **A - 直接使用，扩展医养分类字段**   |
| 订单全链路 | 下单→支付→发货/预约→完成→退款    | **A - 实物商品直接用，服务类需适配** |
| 支付体系   | 微信支付/支付宝/钱包/积分抵扣    | **A - 直接使用**                     |
| 物流       | 快递聚合API + 骑手即时配送       | **A - 直接使用**                     |
| 营销       | 优惠券/积分/活动/拼团/闪购       | **A - 直接使用**                     |
| 商家入口   | 商家入驻审核/商品管理/账单       | **A - 扩展医疗器械资质字段**         |
| 客服       | IM客服/工单/退款                 | **A - 直接使用**                     |
| 推荐       | 基础推荐算法                     | B - 需扩展健康数据维度               |

**补充说明**：mall 中已有直播带货的代码框架，但根据需求文档描述该功能尚未完善，需进一步开发完善。

---

## 5. 规划判断

**mall 内扩展（A级，优先P0推进）**

- 在 mall 现有代码基础上扩展医养商城
- 新增：医养商品分类体系、医疗器械资质字段、服务类订单适配、老年友好UI
- 独立建设：IoT设备租赁服务（对接16号模块）、直播带货服务、AI推荐服务
- **WARNING**：不要将 HIS/EMR/IoT 功能硬塞进 mall 代码，这些在需求文档中写在"医养商城"章节内，但本质上是独立系统

---

## 6. 需新增业务能力

1. **医养商品分类体系**：医疗器械（一/二/三类）/保健品/适老化用品/康复辅具/服务的分类体系
2. **商家资质扩展**：医疗器械经营许可证号、药品经营许可证（与中心药房21联动）
3. **服务类订单适配**：无库存的预约制服务（上门护理/到家就诊），时间段选择
4. **老年友好UI**：大字体模式、简化导航、语音搜索（无障碍设计）
5. **IoT设备租赁**：租期（月/季/年）、押金管理、到期提醒、归还处理
6. **完善直播带货**：商品链接挂载、实时弹幕购物车、回放

---

## 7. 需新增数据模型（在 mall 基础上扩展）

| 模型/字段扩展                | 说明                                   |
| ---------------------------- | -------------------------------------- |
| `product.medical_license_no` | 医疗器械注册证号                       |
| `merchant.device_license_no` | 医疗器械经营许可证                     |
| `product_category`（扩展）   | 新增医养分类树（医疗器械/辅具/服务等） |
| `service_product_schedule`   | 服务类商品的可预约时间段配置           |
| `iot_rental_order`           | 租赁订单：设备ID/租期/押金/状态        |
| `live_stream_room`           | 直播间配置、关联商品、观看数、下单数   |

---

## 8. 需新增技术栈 / 第三方能力 / 中间件

| 类别     | 技术选型                     | 用途             |
| -------- | ---------------------------- | ---------------- |
| 直播     | 腾讯云直播（CSS）+ 播放器SDK | 商品直播带货     |
| 语音搜索 | 科大讯飞语音识别             | 老年用户语音输入 |
| 无障碍   | uni-app无障碍API             | 老年友好UI       |
| 推荐引擎 | 依托22号AI服务模块           | 健康档案驱动推荐 |

---

## 9. 外部系统对接关系

| 对接方           | 内容                           | 方式          |
| ---------------- | ------------------------------ | ------------- |
| IoT管理（16）    | 设备租赁关联设备台账           | 内部API       |
| 居家养老（10）   | 服务类商品预约对接居家服务订单 | 内部API       |
| 运营管理（24）   | 商城运营数据汇聚               | 内部数据API   |
| AI服务（22）     | 健康档案驱动个性化推荐         | 内部AI推荐API |
| 中心药房（21）   | 处方药品销售（处方流转）       | 内部API       |
| 数据库系统（02） | 老人身份验证、健康档案关联     | 内部API       |

---

## 10. 风险与边界

| 风险              | 说明                                              | 应对                                           |
| ----------------- | ------------------------------------------------- | ---------------------------------------------- |
| 医疗器械经营合规  | 销售二/三类医疗器械需特定资质                     | 平台需获取医疗器械经营许可，或仅作信息撮合平台 |
| 处方药销售合规    | 处方药需处方流转合规                              | 对接中心药房（21）的处方流转系统               |
| IoT租赁设备归还   | 设备归还、押金退还、设备检验复杂                  | 建立标准化退租流程，与IoT管理联动              |
| 直播内容合规      | 医疗器械直播有严格广告法约束                      | 建立商品直播审核机制                           |
| 边界：不含HIS系统 | 商城中的诊疗建议/健康评估功能须对接独立的专业系统 | 严格区分电商功能与医疗功能                     |

---

## 11. 实施优先级与分期建议

**优先级：P0（最优先推进，mall核心能力直接可用）**

| 分期     | 内容                                                  | 说明                          |
| -------- | ----------------------------------------------------- | ----------------------------- |
| P0第一期 | 医养商品分类 + 商家入驻（医疗器械资质）+ 实物商品销售 | 基于mall直接扩展，2-4周可上线 |
| P0第二期 | 服务类商品预约 + 营销工具 + 客服                      | —                             |
| P1配合   | IoT设备租赁 + 老年友好UI                              | IoT管理（16）就绪             |
| P1-P2    | 直播带货 + AI推荐 + 私域营销                          | 直播技术验证后                |

---

## 12. 结论

医养商城是全平台中与 mall **契合度最高的模块（A级）**，mall 的商品管理、订单全链路、支付、物流、营销、商家入驻等核心能力可直接复用，**预计在 mall 基础上2-4周内可完成医养商城MVP版本上线**。

关键注意事项：需求文档中"医养商城"章节内包含的部分功能（IoT设备租赁管理、健康档案驱动推荐、直播带货、处方流转）本质上属于其他独立系统，**不应堆入 mall 代码**，而应通过 API 对接方式实现协作。

建议立即将医养商城列为P0优先启动项目，以此验证 mall 平台的医养化改造路径，为后续模块建设积累经验。
