PRD-小程序-V1.0.md 15 KB
智价云（药店版）微信小程序 — 产品需求文档 V1.0
定稿日期：2026-06-27 · 状态：已定稿
基于 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：
- 主色
#002FA7、正红#E60012、医药绿#00A870 - 合规页脚：「数据来源于您本人绑定的 B2B 平台账号，智价云不提供药品交易服务。」
7. 数据同步方案
- 登录态：JWT，小程序
wx.storage持久化 - 服务端为唯一数据源：任一端写入（注册、执照、绑平台、查询、跳转）→ 各端读取
- 刷新：列表下拉刷新；详情进入时拉最新；支付后轮询会员状态（MVP）
8. 门禁与权限
原则：与主 PRD §3.4 一致，不在小程序侧独立设计门禁；执照审核按主 PRD 影响各端查价等能力，不限制小程序内历史/采购可见性。
| 状态 | 小程序行为 |
|---|---|
| 未注册 | 引导完成完整注册：邀请码 → 药店信息 → 执照 → 绑平台 |
| 已注册，执照未提交 / 审核中 / 驳回 | 提供执照提交或状态查询入口；历史/采购正常可见 |
| 已注册，执照通过，未绑平台 | 引导 mp-onboard-bind 完成绑定；历史/采购正常可见 |
| 已登录 | 历史、采购、会员、邀请、体验券全功能（除查价） |
桌面端「不可查价」门禁（执照未通过、未绑平台）在小程序以状态展示 + 引导完成资料呈现，不阻断历史/采购浏览。
9. 关键产品决策（§13 定稿）
| # | 决策项 | 定稿结论 |
|---|---|---|
| 1 | 历史记录权益 | 与客户端保持一致，不单独设计；无条数/时间裁剪 |
| 2 | 执照审核 | 仅影响各端会员级能力（与主 PRD 一致，如桌面查价门禁）；小程序增加资料提交 + 状态查询；审核中可见历史/采购 |
| 3 | 注册路径 | 未注册用户可在小程序完成完整注册（邀请码 + 执照 + 绑平台）；小程序是多端入口之一，信息各端同步 |
| 4 | Android APP | 暂缓，当前文档不定义与 Android 关系 |
| 5 | 官网联动 | 是，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 |
| API 接口设计 | api/API-小程序.md |
| Stitch 出图 Prompt | stitch-prompts/batch-6-miniprogram-全量.md |
| 微信接入清单 | docs/微信小程序接入清单.md |
| 演示链路 | prototype-flows/小程序-链路.md |