# 智价云（药店版）微信小程序 — 产品需求文档 V1.0

> 定稿日期：2026-06-27 · 状态：**已定稿**  
> 基于 [PRD-摘要.md](PRD-摘要.md) 延伸 · 伴侣型移动入口

---

## 1. 产品定位

### 1.1 一句话

智价云小程序是面向药店用户的**移动伴侣端**：在桌面软件完成重度比价采购的同时，用手机随时查看**查询历史与采购参考记录**，并完成**会员开通/续费、邀请拉新**等增长动作；数据与桌面端同一账号实时同步。

### 1.2 与现有端侧关系

| 端 | 角色 | 核心能力 |
|----|------|----------|
| Windows 桌面 | **主工作台** | 聚合比价、关注、跳转购买、产生历史数据 |
| **微信小程序** | **多端入口之一** | 完整注册、执照提交与状态、平台绑定、查历史/采购、会员/邀请 |
| Android APP | 完整移动版（P1，**暂缓**） | 当前版本不纳入范围 |

**小程序不做**：实时并行查价、扫码搜药、关注管理（查价与关注仍在桌面端完成）。

**多端原则**：小程序是注册与资料提交的**入口之一**，账号、执照、平台绑定、会员、历史数据**各端同步**，权益规则**统一沿用主 PRD**，不在小程序侧单独设计裁剪逻辑。

### 1.3 价值主张

- **随时复盘**：外出或离店时快速翻看「上次查过什么、当时各平台什么价、最终跳去哪买了」
- **支付便利**：微信生态内原生调起微信支付，比桌面扫码更顺畅
- **私域传播**：一键分享邀请码/链接到微信好友与群
- **账号一体**：同一手机号登录，桌面产生的数据小程序秒级可见
- **多端同权**：注册、执照、绑平台、会员、历史数据各端一致，小程序不单独设计权益

---

## 2. 目标用户与典型场景

| 角色 | 场景 | 小程序动作 |
|------|------|------------|
| 药店老板 | 晚上复盘今日采购决策 | 浏览今日查询历史 + 跳转购买记录 |
| 采购员 | 店内没开电脑，想确认上周某药查价结果 | 搜索历史关键词 → 打开查询快照 |
| 体验到期用户 | 收到到期提醒（订阅消息） | 打开小程序 → 会员中心 → 微信支付续费 |
| KOL/老用户 | 微信群里推荐智价云 | 分享邀请海报/链接 → 查看激活统计 |
| 新入驻药店 | 微信内收到邀请 | 小程序完成注册 → 上传执照 → 绑定平台 |
| 被驳回用户 | 执照照片不清晰 | 小程序查看驳回原因 → 重新拍摄上传 |

---

## 3. 功能范围

### 3.1 MVP 功能（首期上线）

| 模块 | 功能点 | 说明 |
|------|--------|------|
| **登录与账号** | 微信授权 + 手机号绑定 | 与桌面端同一 `User` 账号 |
| **新用户注册** | 邀请码 + 药店名称 + 省市区 | 未注册用户可在小程序完成，与桌面端共用账号 |
| **营业执照** | 拍照/相册上传、审核状态查询、驳回重传 | **资料提交入口 + 状态查询**；审核规则与主 PRD 一致 |
| **平台绑定** | 药师帮 / 药帮忙 / 1药城 账号绑定与管理 | 与桌面端共用 `PlatformBinding`，各端同步 |
| **首页概览** | 会员状态条、今日查询次数、快捷入口 | 只读展示配额，查询仍须桌面端 |
| **查询历史** | 列表 + 详情 + 再次查询引导 | 同步桌面 `QueryLog`；详情含**完整查询快照** |
| **采购参考** | 跳转购买记录 | 同步桌面/各端产生的 `PurchaseIntent` |
| **会员中心** | 权益对比、套餐选择、微信支付 | 复用 PRD 体验/付费两档权益 |
| **支付结果** | 成功/失败/待支付 | 支付回调更新 `member_expire_at` |
| **邀请中心** | 邀请码、复制、微信分享、激活统计 | 一级邀请，奖励会员延期 |
| **体验券核销** | 输入券码 | 与桌面端规则一致 |
| **我的** | 药店信息、执照状态、平台账号管理 | 执照与绑平台均为可管理入口，非只读 |
| **帮助与合规** | 固定文案 + 下载桌面端引导 + **官网入口** | 统一合规声明；链至 `proprice.kailin.com.cn` |

### 3.2 分期功能

| 版本 | 功能 | 优先级说明 |
|------|------|------------|
| **V1.1** | 手动采购台账 | 用户录入已下单/到货明细，与查询快照关联 |
| **V1.2** | 订阅消息 | 体验到期、会员到期、降价提醒 |
| **V2.0** | B2B 平台订单同步 | 从药师帮/药帮忙/1药城拉取真实订单，单独评估 |

### 3.3 明确不做

- 小程序内实时聚合查价、扫码搜药、关注管理（引导打开桌面软件）
- 药品交易、支付、开票
- 二级分销、现金返利
- 相对主 PRD / 桌面端的**独立权益或门禁规则**（小程序不单独设计）

### 3.4 营业执照（MVP）

小程序职责：**资料提交入口 + 审核状态查询**。审核流程、通过/驳回规则与主 PRD §3.2 及桌面端**完全一致**。

| 步骤 | 小程序行为 |
|------|------------|
| 上传 | `mp-license-upload`：拍照或相册选择，预览后提交 |
| 待审核 | `mp-license-pending`：展示状态与预计时效；**可正常浏览历史/采购** |
| 通过 | 状态各端同步；不影响小程序历史/采购可见性 |
| 驳回 | `mp-license-rejected`：展示驳回原因 + 重新上传 |
| 查看 | 「我的 → 营业执照」查看状态与已提交图片 |

> **审核对各端查价/会员的影响**与主 PRD 一致（执照通过 + 绑平台后方可桌面查价）；**不因审核状态在小程序侧单独限制历史/采购记录**。

运营审核仍在 Admin 操作台人工处理，与桌面端上传无差别。

### 3.5 平台绑定（MVP）

与主 PRD §3.3 一致，小程序提供完整绑定流程：

| 步骤 | 页面 |
|------|------|
| 引导 | `mp-onboard-bind`：三平台卡片，至少绑 1 个 |
| 列表 | `mp-platform-list`：已绑 / 未绑状态 |
| 表单 | `mp-platform-bind`：账号 + 密码，加密提交 |

注册完整路径：`mp-register` → `mp-license-upload` → `mp-onboard-bind` → `mp-platform-bind` → 进入主界面。

---

## 4. 采购信息定义

### 4.1 查询结果快照（MVP）

每次桌面端成功查询，后端保存完整快照，小程序只读展示。

| 字段 | 说明 |
|------|------|
| `query_id` | 唯一 ID |
| `keyword` | 搜索关键词 |
| `queried_at` | 查询时间 |
| `source_client` | `windows` / `android` / `mini_program`（只读来源） |
| `result_count` | 命中 SKU 数 |
| `snapshot` | JSON：各平台报价列表 |
| `lowest_platform` | 最低价平台 |
| `lowest_price` | 参考最低价 |

**小程序展示**：历史列表 → 详情页复现卡片式报价对比（只读）；若有关联跳转记录，显示「已在 XX 平台购买」标记。

### 4.2 跳转购买记录（MVP）

用户在任何端点击「去 [平台] 购买」时写入。

| 字段 | 说明 |
|------|------|
| `intent_id` | 唯一 ID |
| `query_id` | 关联查询（可空） |
| `drug_name` / `spec` / `manufacturer` | 药品信息 |
| `platform` | 药师帮 / 药帮忙 / 1药城 |
| `reference_price` | 跳转时参考价 |
| `clicked_at` | 跳转时间 |
| `source_client` | 产生端 |

### 4.3 手动采购台账（V1.1）

| 字段 | 说明 |
|------|------|
| `ledger_id` | 唯一 ID |
| `intent_id` / `query_id` | 可选关联 |
| `drug_name`, `spec`, `qty`, `unit_price`, `total` | 采购明细 |
| `platform`, `order_note` | 平台与备注 |
| `status` | 已下单 / 已到货 |
| `created_at` | 录入时间 |

### 4.4 平台订单同步（V2.0 预研）

- 依赖各 B2B 平台 API 或授权协议，**不纳入 MVP**
- 采购 Tab 预留「平台同步订单」入口位

---

## 5. 会员与权益

### 5.1 统一权益（沿用主 PRD，不单独设计）

小程序**不单独定义**历史、采购、会员等级规则，**与桌面客户端保持一致**：

| 能力 | 规则来源 |
|------|----------|
| 体验 / 付费会员、查询次数、关注配额 | 主 PRD §4 |
| 查询历史、采购参考记录 | 与桌面端**完全一致**，无条数/时间裁剪 |
| 执照审核对查价的影响 | 主 PRD §3.2、§3.4（通过 + 绑平台后可查价） |
| 执照审核对小程序历史/采购 | **不限制**；审核仅按主 PRD 影响各端查价等会员级能力 |

> 小程序首页可只读展示桌面端配额（如今日查询 x/20），本身不消耗查询次数。

### 5.2 小程序仅承担的差异能力

| 能力 | 说明 |
|------|------|
| 执照 | 资料提交 + 状态查询（见 §3.4） |
| 支付 | 微信支付开通/续费会员 |
| 邀请 / 体验券 | 与桌面端规则一致 |
| 手动采购台账（V1.1） | 仅付费会员（与前期设计一致，属增值功能非历史裁剪） |

### 5.3 套餐与支付

- 套餐：月 / 季 / 年（运营后台可配，MVP 占位 ¥99 / ¥269 / ¥899）
- 支付方式：**微信支付**（`wx.requestPayment`）
- 支付宝：小程序内不支持，引导桌面端扫码
- 支付成功后：`member_type` → 付费会员，`member_expire_at` 延长；桌面端实时刷新

### 5.4 邀请与体验券

- **邀请**：每人永久邀请码；激活 = 被邀请人执照通过 + 绑平台 ≥1；奖励邀请人会员 +7 天（可配）
- **体验券**：输入券码延长体验期
- **分享**：`onShareAppMessage` 携带邀请码 → H5 落地页或小程序注册引导页

---

## 6. 信息架构与页面清单

页面 ID 前缀 **`mp-`**，MVP 共 **20 屏**。

### 6.1 底部 Tab（3 Tab）

```
历史 | 采购 | 我的
```

### 6.2 完整页面列表

| ID | 页面名 | 入口 |
|----|--------|------|
| `mp-login` | 登录 | 首次打开 |
| `mp-register` | 新用户注册 | 未注册手机号 |
| `mp-license-upload` | 上传营业执照 | 注册后 / 我的 / 门禁拦截 |
| `mp-license-pending` | 审核中 | 提交执照后 |
| `mp-license-rejected` | 审核驳回 | 被驳回时 |
| `mp-onboard-bind` | 绑定平台引导 | 注册流程 / 我的 |
| `mp-platform-list` | 平台账号管理 | 我的 |
| `mp-platform-bind` | 绑定平台表单 | 平台列表 |
| `mp-home` | 首页概览 | 登录后（可选，默认进历史 Tab） |
| `mp-history-list` | 查询历史 | Tab |
| `mp-history-detail` | 查询快照详情 | 历史列表 |
| `mp-purchase-list` | 采购参考 | Tab |
| `mp-purchase-detail` | 采购记录详情 | 采购列表 |
| `mp-membership` | 会员中心 | 我的 |
| `mp-payment-result` | 支付结果 | 支付回调 |
| `mp-invite-center` | 邀请好友 | 我的 |
| `mp-coupon-redeem` | 体验券核销 | 我的 |
| `mp-profile` | 我的 | Tab |
| `mp-help` | 帮助与合规 | 我的 |

### 6.3 视觉规范

沿用 [design/DESIGN.md](../design/DESIGN.md)：
- 主色 `#002FA7`、正红 `#E60012`、医药绿 `#00A870`
- 合规页脚：「数据来源于您本人绑定的 B2B 平台账号，智价云不提供药品交易服务。」

---

## 7. 数据同步方案

- 登录态：JWT，小程序 `wx.storage` 持久化
- **服务端为唯一数据源**：任一端写入（注册、执照、绑平台、查询、跳转）→ 各端读取
- 刷新：列表下拉刷新；详情进入时拉最新；支付后轮询会员状态（MVP）

详见 [api/API-小程序.md](../api/API-小程序.md)

---

## 8. 门禁与权限

**原则**：与主 PRD §3.4 一致，**不在小程序侧独立设计门禁**；执照审核按主 PRD 影响各端**查价**等能力，**不限制**小程序内历史/采购可见性。

| 状态 | 小程序行为 |
|------|------------|
| 未注册 | 引导完成完整注册：邀请码 → 药店信息 → 执照 → 绑平台 |
| 已注册，执照未提交 / 审核中 / 驳回 | 提供执照**提交或状态查询**入口；**历史/采购正常可见** |
| 已注册，执照通过，未绑平台 | 引导 `mp-onboard-bind` 完成绑定；**历史/采购正常可见** |
| 已登录 | 历史、采购、会员、邀请、体验券全功能（除查价） |

> 桌面端「不可查价」门禁（执照未通过、未绑平台）在小程序以**状态展示 + 引导完成资料**呈现，不阻断历史/采购浏览。

---

## 9. 关键产品决策（§13 定稿）

| # | 决策项 | 定稿结论 |
|---|--------|----------|
| 1 | 历史记录权益 | **与客户端保持一致**，不单独设计；无条数/时间裁剪 |
| 2 | 执照审核 | **仅影响各端会员级能力**（与主 PRD 一致，如桌面查价门禁）；小程序增加**资料提交 + 状态查询**；**审核中可见**历史/采购 |
| 3 | 注册路径 | 未注册用户**可在小程序完成完整注册**（邀请码 + 执照 + 绑平台）；小程序是多端**入口之一**，信息各端同步 |
| 4 | Android APP | **暂缓**，当前文档不定义与 Android 关系 |
| 5 | 官网联动 | **是**，[proprice.kailin.com.cn](https://proprice.kailin.com.cn) 增加「打开小程序」+ 下载桌面引导 |

---

## 10. 官网联动（已定稿）

在 `proprice.kailin.com.cn` 增加：

| 入口 | 实现 |
|------|------|
| 打开小程序 | 微信内 `<wx-open-launch-weapp>` 或小程序码 |
| 下载桌面版 | Windows 安装包下载链接 |
| 帮助说明 | 小程序 vs 桌面版能力说明（查价在桌面，移动侧重历史/注册/会员） |

---

## 11. 非功能需求

| 项 | 要求 |
|----|------|
| 性能 | 历史列表首屏 ≤ 2s；分页 20 条/页 |
| 安全 | 平台绑定密码加密传输与存储；敏感接口 HTTPS + Token |
| 合规 | 全页合规提示；禁用「全网最低保证」等用语 |
| 微信审核 | 类目：工具 > 信息查询；不含药品销售表述 |
| 离线 | 不支持；无网络友好提示 |
| 图片上传 | 执照单张 ≤ 5MB；支持 JPG/PNG；`wx.chooseMedia` 拍照或相册 |

---

## 12. 成功指标（上线 30 天）

| 指标 | 目标 |
|----|------|
| 桌面活跃用户中绑定小程序比例 | ≥ 40% |
| 小程序 DAU / 桌面 DAU | ≥ 25% |
| 会员支付从小程序完成占比 | ≥ 30% |
| 历史详情页人均访问次数/周 | ≥ 3 |
| 邀请分享从小程序发起占比 | ≥ 50% |
| 小程序完整注册占比（含绑平台） | ≥ 30% |

---

## 13. 实施分期

| 阶段 | 交付 | 工期参考 |
|------|------|----------|
| **P0** | 后端 API（账号、执照上传、QueryLog 扩展、PurchaseIntent、会员支付） | 与桌面端后端统一建设 |
| **P1** | 小程序 MVP 20 屏 + 完整注册 + 执照 + 绑平台 + 微信支付 | 4–6 周 |
| **P2** | 手动采购台账 + 订阅消息 | 2–3 周 |
| **P3** | 平台订单同步预研 | 单独立项 |

---

## 14. 关联文档

| 文档 | 路径 |
|------|------|
| 主 PRD 摘要 | [PRD-摘要.md](PRD-摘要.md) |
| API 接口设计 | [api/API-小程序.md](../api/API-小程序.md) |
| Stitch 出图 Prompt | [stitch-prompts/batch-6-miniprogram-全量.md](../stitch-prompts/batch-6-miniprogram-全量.md) |
| 微信接入清单 | [docs/微信小程序接入清单.md](../docs/微信小程序接入清单.md) |
| 演示链路 | [prototype-flows/小程序-链路.md](../prototype-flows/小程序-链路.md) |