# 智价云小程序 — 微信接入清单

> 定稿日期：2026-06-27  
> 用于 P1 开发启动前的账号与资质准备  
> 关联 PRD：[PRD-小程序-V1.0.md](../prd/PRD-小程序-V1.0.md)

---

## 1. 准备事项总览

| 序号 | 事项 | 负责方 | 预计周期 | 状态 |
|------|------|--------|----------|------|
| 1 | 微信小程序注册 | 运营/法务 | 1–3 工作日 | ☐ |
| 2 | 小程序类目与资质 | 运营/法务 | 3–7 工作日 | ☐ |
| 3 | 微信认证（企业） | 运营/财务 | 1–5 工作日 | ☐ |
| 4 | 微信支付商户号 | 财务 | 5–10 工作日 | ☐ |
| 5 | 小程序与商户号绑定 | 技术 | 1 工作日 | ☐ |
| 6 | 服务器域名配置 | 技术 | 1 工作日 | ☐ |
| 7 | 隐私协议与用户协议 | 法务 | 3 工作日 | ☐ |
| 8 | 订阅消息模板申请 | 运营 | 1–3 工作日 | ☐ |

---

## 2. 微信小程序注册

### 2.1 注册入口

- 平台：[微信公众平台](https://mp.weixin.qq.com/)
- 类型：**小程序**（非订阅号/服务号）
- 主体：与智价云运营主体一致（建议与 `proprice.kailin.com.cn` 备案主体相同）

### 2.2 基本信息

| 项 | 建议值 |
|----|--------|
| 小程序名称 | 智价云 |
| 简介 | 药店 B2B 采购查价记录与会员服务 |
| 头像 | 沿用 ProPrice 品牌 Logo（克兰茵蓝 #002FA7） |
| 服务类目 | 见 §3 |

### 2.3 管理员

- 绑定管理员微信（需实名）
- 记录 AppID、AppSecret（仅后端使用，**不可写入小程序前端代码**）

---

## 3. 类目与资质

### 3.1 推荐类目（首选）

| 一级类目 | 二级类目 | 说明 |
|----------|----------|------|
| 工具 | 信息查询 | 查价记录查询、采购参考信息展示 |

### 3.2 备选类目

| 一级类目 | 二级类目 | 说明 |
|----------|----------|------|
| 商业服务 | 软件/建站/技术开发 | 若信息查询类目审核受限 |

### 3.3 需准备的资质材料

| 材料 | 用途 |
|------|------|
| 营业执照 | 主体认证 |
| ICP 备案号 | 关联 `proprice.kailin.com.cn` |
| 软件著作权或产品说明 | 部分类目可能要求 |
| 不涉及药品销售的声明函 | 审核补充说明 |

### 3.4 审核注意事项

**必须避免**的表述：
- 药品销售、在线购药、自营药品
- 「全网最低」「保证最低价」等绝对化用语
- 未授权爬取、破解登录等描述

**必须包含**的表述：
> 数据来源于您本人绑定的 B2B 平台账号，智价云不提供药品交易服务。

**功能描述建议**：
- 展示用户在桌面软件产生的**查价历史与采购参考记录**
- 会员开通与续费
- 邀请好友使用智价云桌面软件

---

## 4. 微信认证

| 项 | 说明 |
|----|------|
| 认证类型 | 企业认证 |
| 费用 | 300 元/年（以微信官方为准） |
| 收益 | 获取手机号组件、微信支付、更高 API 配额 |
| 对公账户 | 认证需对公打款或法人扫脸 |

**必须完成认证**，否则无法使用：
- `getPhoneNumber` 获取手机号
- `wx.requestPayment` 微信支付

---

## 5. 微信支付商户号

### 5.1 申请入口

- [微信支付商户平台](https://pay.weixin.qq.com/)
- 或使用小程序后台「微信支付」→「开通」引导

### 5.2 申请材料

| 材料 | 说明 |
|------|------|
| 营业执照 | 与小程序主体一致 |
| 法人身份证 | 正反面 |
| 对公银行账户 | 结算账户 |
| 经营场景说明 | B2B 采购信息查询工具会员服务 |
| 小程序 AppID | 与小程序绑定 |

### 5.3 费率与结算

- 默认费率约 0.6%（以签约为准）
- 结算周期 T+1（以商户协议为准）
- 商品名称建议：`智价云会员-年卡` / `智价云会员-月卡`

### 5.4 小程序绑定

1. 商户平台 → 产品中心 → AppID 账号管理 → 关联小程序 AppID
2. 小程序后台 → 微信支付 → 确认绑定
3. 后端配置：商户号 mchid、APIv3 密钥、商户证书

---

## 6. 服务器与域名配置

### 6.1 小程序后台 → 开发 → 开发管理 → 服务器域名

| 类型 | 域名示例 | 用途 |
|------|----------|------|
| request 合法域名 | `https://api.proprice.kailin.com.cn` | API 请求 |
| uploadFile | 同上 | **营业执照图片上传** |
| downloadFile | `https://proprice.kailin.com.cn` | 下载桌面安装包 |
| 业务域名 | `https://proprice.kailin.com.cn` | web-view 打开 H5 邀请页 |

### 6.2 SSL 证书

- 全站 HTTPS，TLS 1.2+
- 证书与 API 域名一致

### 6.3 后端环境变量

```
WECHAT_MP_APPID=
WECHAT_MP_SECRET=
WECHAT_MCH_ID=
WECHAT_MCH_API_V3_KEY=
WECHAT_MCH_CERT_PATH=
WECHAT_MCH_KEY_PATH=
WECHAT_NOTIFY_URL=https://api.proprice.kailin.com.cn/v1/payments/wechat/notify
```

### 6.4 营业执照上传配置

**app.json 权限声明**：

```json
{
  "permission": {
    "scope.camera": {
      "desc": "用于拍摄上传营业执照"
    }
  }
}
```

**接口**：使用 `wx.chooseMedia`（拍照/相册），上传至 `POST /licenses/upload`。

**存储**：执照图片存私有对象存储（OSS/COS），仅通过签名 URL 访问；不可公开 CDN。

---

## 7. 隐私与合规

### 7.1 必需协议页面

| 协议 | 路径建议 | 说明 |
|------|----------|------|
| 用户协议 | `/pages/agreement/user` 或 H5 | 注册/登录勾选 |
| 隐私政策 | `/pages/agreement/privacy` 或 H5 | 说明收集手机号、openid |
| 会员服务协议 | 会员中心链接 | 支付前勾选 |

### 7.2 隐私保护指引（小程序后台填写）

需声明收集的用户信息：

| 信息类型 | 用途 | 是否必需 |
|----------|------|----------|
| 手机号 | 账号匹配、登录 | 是 |
| 微信 openid | 登录态、支付 | 是 |
| 查价历史 | 展示用户数据 | 是（用户自有数据） |
| 相册/相机 | 营业执照拍照上传 | 是（注册与资质） |

### 7.3 用户隐私保护弹窗

- 首次打开需弹出《用户隐私保护指引》
- 使用官方 `__usePrivacyCheck__` 机制（基础库 2.32.3+）

---

## 8. 订阅消息（V1.2 预备）

### 8.1 建议申请的模板

| 场景 | 模板类型 | 触发条件 |
|------|----------|----------|
| 体验即将到期 | 到期提醒 | 体验剩余 3 天 |
| 会员即将到期 | 到期提醒 | 会员剩余 7 天 |
| 支付成功 | 支付结果 | 会员开通成功 |

### 8.2 申请路径

小程序后台 → 功能 → 订阅消息 → 选用公共模板或申请类目模板

### 8.3 用户授权

- 首次触发前调用 `wx.requestSubscribeMessage`
- 用户拒绝时不阻断主流程

---

## 9. 分享与引流

### 9.1 官网 proprice.kailin.com.cn（已定稿）

| 入口 | 实现 | 状态 |
|------|------|------|
| 打开小程序 | `<wx-open-launch-weapp>`（需服务号关联）或页面展示小程序码 | ☐ |
| 下载 Windows 版 | `/download/windows` 直链 | ☐ |
| 能力说明 | 查价用桌面；小程序负责注册/执照/绑平台/历史/会员 | ☐ |

### 9.2 分享给好友

```javascript
onShareAppMessage() {
  return {
    title: '智价云 — 药店采购查价好帮手',
    path: '/pages/invite/index?code=PX8K2M',
    imageUrl: '/assets/share-cover.png'
  }
}
```

### 9.3 官网联动（已定稿）

在 `proprice.kailin.com.cn` 增加「打开小程序」与「下载桌面版」双 CTA，与 PRD §10 一致。

### 9.4 小程序码

- 路径：`pages/index/index?from=official`
- 用于官网、宣传物料、客服话术

---

## 10. 开发调试

### 10.1 开发者工具

- [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
- 导入项目，填写 AppID

### 10.2 体验版与审核版

| 版本 | 用途 |
|------|------|
| 开发版 | 日常开发 |
| 体验版 | 内部测试，需添加体验成员 |
| 审核版 | 提交微信审核 |
| 正式版 | 全量发布 |

### 10.3 审核提交材料

| 材料 | 说明 |
|------|------|
| 测试账号 | 已注册手机号 + 说明登录步骤 |
| 功能说明 | 伴侣型，查价在桌面端完成 |
| 截图 | 历史、采购、会员、邀请 4 个核心页面 |
| 演示视频（可选） | 30 秒展示数据同步 |

---

## 11. 上线检查清单

### 11.1 功能

- [ ] 微信登录 + 手机号授权正常
- [ ] 小程序内完整注册（邀请码 + 执照 + 绑平台）与桌面数据一致
- [ ] 执照审核中仍可浏览历史/采购
- [ ] 平台绑定/解绑与桌面同步
- [ ] 查询历史列表/详情与桌面数据一致
- [ ] 采购记录列表/详情正常
- [ ] 微信支付全流程（下单 → 支付 → 回调 → 会员生效）
- [ ] 邀请码复制与分享
- [ ] 体验券核销
- [ ] 体验用户与付费会员历史/采购记录可见范围一致（无条数限制）
- [ ] 合规文案全页面可见

### 11.2 安全

- [ ] AppSecret、商户密钥仅在后端
- [ ] API 全 HTTPS
- [ ] Token 过期自动刷新
- [ ] 支付回调验签

### 11.3 合规

- [ ] 隐私政策已发布并在后台配置
- [ ] 用户协议已发布
- [ ] 不涉及药品销售描述
- [ ] 平台账号密码不在小程序出现

---

## 12. 联系人模板

| 角色 | 姓名 | 联系方式 | 职责 |
|------|------|----------|------|
| 小程序管理员 | | | 后台配置、审核提交 |
| 微信支付对接 | | | 商户号、结算 |
| 后端开发 | | | API、回调、域名 |
| 法务 | | | 协议、类目资质 |

---

## 13. 参考链接

- [微信小程序注册流程](https://developers.weixin.qq.com/miniprogram/product/registration.html)
- [小程序类目](https://developers.weixin.qq.com/miniprogram/product/material/)
- [获取手机号](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html)
- [微信支付开发文档](https://pay.weixin.qq.com/docs/merchant/products/mini-program-payment/development.html)
- [用户隐私保护指引](https://developers.weixin.qq.com/miniprogram/dev/framework/user-privacy/)