# 智价云药店 - 产品文档

> **⚠️ MVP阶段说明**  
> 本项目为**全新项目，尚未上线**，当前处于 **MVP（最小可行产品）阶段**。  
> **核心业务**：面向终端药店的B2B采购**聚合比价工具**，用户绑定自有B2B平台账号，智价云并行查询同款报价。  
> **产品形态**：**多端交付策略** - MVP首选Windows独立桌面应用（.exe），后续扩展微信小程序、APP、公众号等多渠道。  
> **目标用户**：药店采购人员、药师，目标日活20万+。
>
> 📅 版本：v1.0-MVP | 📆 更新日期：2026-06-16 | ✅ 状态：开发中

---

## 📋 目录

- [1. 产品概述](#1-产品概述)
- [2. 功能模块](#2-功能模块)
- [3. 核心业务流程](#3-核心业务流程)
- [4. 多端交付策略](#4-多端交付策略)
- [5. 灵活配置策略](#5-灵活配置策略)
- [6. 非功能性需求](#6-非功能性需求)
- [7. MVP范围与规划](#7-mvp范围与规划)
- [8. 业务指标](#8-业务指标)

---

## 1. 产品概述

### 1.1 产品定位

智价云是一款面向**终端药店**的**B2B采购聚合比价工具**，核心价值：

| 价值点 | 说明 | 收益 |
|--------|------|------|
| 💰 降低采购成本 | 聚合查询已绑平台报价 | 平均节省10%-30% |
| 🔒 安全可控 | Windows独立桌面应用，自建安全策略 | 不依赖系统浏览器 |
| ⚡ 高效便捷 | 一键启动，并行查询多平台 | 提升采购效率50%+ |
| 🎯 精准比价 | 基于用户自有账号查询 | 价格真实可靠 |
| 👥 裂变增长 | 邀请其他药店注册获得额外配额 | 快速扩大用户规模 |

**🎯 MVP目标**：验证核心业务流程（注册→绑定账号→聚合查询→跳转购买），快速上线获取种子药店用户，收集真实使用反馈。

### 1.2 目标用户

| 角色 | 说明 | 核心需求 |
|------|------|----------|
| 药店采购员 | 负责药店日常药品采购 | 快速找到最低价格，生成采购链接 |
| 执业药师 | 审核药品质量和供应商资质 | 查看药品详细信息、供应商信誉 |
| 药店老板 | 控制采购成本，优化供应链 | 采购数据分析、成本控制报表 |
| 运营人员 | 管理邀请配置、发放优惠券 | 提高用户注册率和活跃度 |
| 管理员 | 系统全局管理 | 用户管理、数据统计、风控监控 |

### 1.3 关键特点

- **多端覆盖**：Windows桌面应用起步，逐步扩展移动端和社交渠道
- **自建安全策略**：Windows客户端内置WebView2，Cookie管理、Session隔离、加密存储均由应用自行管理
- **用户绑定账号**：用户输入自己在药师帮/药帮忙/1药城的账号密码（AES-256加密存储）
- **聚合查询**：并行查询已绑平台，展示比价结果
- **跳转原平台**：点击"去购买"跳转到原平台完成交易，智价云不提供交易服务
- **用户粘性**：通过多渠道触达，提高用户使用频次和留存率

---

## 2. 功能模块

### 2.1 用户认证模块

| 功能 | 说明 |
|------|------|
| 短信验证码登录 | 手机号 + 6位验证码，新用户自动注册 |
| 微信扫码登录 | 微信开放平台扫码，首次登录需绑定手机号 |
| Token 管理 | Access Token（24h）+ Refresh Token（7d） |
| 用户信息 | 昵称、头像、手机号、等级信息、药店名称 |

### 2.2 用户等级体系

| 等级 | 每日配额 | 每月配额 | 并发数 | 适用场景 |
|------|----------|----------|--------|----------|
| 普通用户 (NORMAL) | 5次 | 100次 | 1 | 小型药店试用 |
| VIP会员 (VIP) | 20次 | 500次 | 3 | 中型药店日常采购 |
| SVIP会员 (SVIP) | 100次 | 3000次 | 5 | 大型连锁药店批量采购 |

**版本化管理**：支持运营动态调整等级规则，新用户自动使用最新版本，老用户由运营决定迁移到哪个版本。

### 2.3 爬虫配额体系

用户总配额 = **等级基础配额** + **额外配额**

额外配额来源：

| 来源 | 类型标识 | 过期策略 | 说明 |
|------|----------|----------|------|
| 邀请奖励 | INVITE | 永不过期 | 每成功邀请1家药店注册，获得配置次数 |
| 购买会员 | PURCHASE | 可配置 | 购买/升级会员时发放 |
| 运营发放 | ADMIN | 可配置 | 运营手动为指定用户发放 |

**消耗优先级**：优惠券 > 额外配额（快过期优先）> 等级基础配额

### 2.4 药品比价核心功能（Windows桌面应用）

#### 业务流程

```
输入药品名称 → 选择比价平台（药师帮/药帮忙/1药城） 
→ 并行查询已绑平台账号 
→ 展示比价结果（按价格从低到高排序）
→ 点击"去XX平台购买"跳转到原平台完成交易
```

#### 支持的医药平台（MVP首期3个核心平台）

**B2B批发平台（3个 - MVP启用）：**
- ✅ 药师帮 - 国内领先医药B2B平台
- ✅ 药帮忙 - 医药B2B采购平台
- ✅ 1药城 - B2B医药批发平台

**后续扩展平台（通过运营配置动态启用）：**
- Phase 2：药京采、健之佳、1药网等7个B2B平台
- Phase 3：珍诚医药、药易通等6个区域B2B平台
- Phase 4-6：B2C零售、电商医药频道、垂直医疗平台等24个

**说明**：代码支持34个平台，但MVP首期仅启用3个核心平台，后续通过运营配置逐步开放。

#### Windows桌面应用特点

| 特性 | 说明 |
|------|------|
| **独立浏览器引擎** | 内置WebView2（Microsoft Edge Chromium内核），不依赖系统浏览器 |
| **自建安全策略** | Cookie管理、Session隔离、AES-256加密存储均由应用自行管理 |
| **窗口布局** | 左侧导航栏220px + 顶栏56px + 主内容区 |
| **多标签支持** | 可同时打开多个查询结果和原平台页面 |
| **离线缓存** | 查询历史本地缓存（SQLite），提升二次查询速度 |
| **托盘通知** | 降价提醒、审核结果等通过系统托盘通知 |

#### 比价结果展示

| 字段 | 说明 |
|------|------|
| 平台名称 | 药师帮、药帮忙、1药城（带彩色Badge） |
| 供应商 | 药品批发公司名称 |
| 规格 | 药品规格（如：0.25g×24片） |
| 价格 | 单价（元），最低价红色标注 |
| 最小起订量 | 最少购买数量 |
| 库存状态 | 有货/缺货 |
| 效期 | 药品有效期，近效期橙色标注 |
| 操作 | 「去XX平台购买」按钮 → WebView跳转原平台 |

### 2.5 邀请裂变系统

#### 用户侧流程

```
药店A获取邀请链接 → 分享给其他药店B 
→ B打开落地页（显示A的药店名称和奖励说明）
→ B下载客户端并注册（自动填入邀请码）
→ A获得爬虫次数奖励（用于更多比价）
```

#### 支持渠道

| 渠道 | channel | 打开方式 | 说明 |
|------|---------|----------|------|
| Windows App | app | download | 直接下载客户端 |
| 微信公众号 | wechat | redirect | 跳转公众号/H5 |
| 小程序 | miniapp | miniapp | 打开小程序 |
| 钉钉 | dingtalk | deeplink | 应用内深度链接 |
| 飞书 | feishu | deeplink | 应用内深度链接 |

#### 分享文案示例

```
邀请你加入智价云药店
高效药品采购比价工具
邀请码：ABC123
点击链接下载：
https://app.zhijiayun.com/invite/ABC123
```

#### 邀请统计

- 摘要文本：`已邀请5家药店，3家注册 +21次`
- 每条记录显示：被邀请药店名称、注册状态（已注册/待注册）、奖励次数

### 2.6 营业执照上传（可选）

**设计原则**：
- ✅ 用户可以自愿上传营业执照
- ✅ 不上传不影响基本使用（注册、查询、购买）
- ✅ 上传后运营审核，通过后显示"已认证"标识
- ✅ 认证标识增强用户信任度

**审核流程**：
```
用户上传营业执照 → 提交审核申请 → 运营后台查看待审队列 
→ 运营审核（通过/驳回）→ 通过后显示"已认证"标识
```

### 2.7 优惠券系统

| 功能 | 说明 |
|------|------|
| 优惠券模板 | 运营创建，设置面值、总量、有效期、等级门槛 |
| 发放 | 运营批量发放给指定药店 |
| 使用 | 爬虫消耗时优先使用优惠券 |
| 类型 | CRAWLER（爬虫次数券） |

### 2.8 运营管理后台

| 功能 | 接口 |
|------|------|
| 邀请配置管理 | GET/PUT /api/admin/invite/config |
| 手动发放爬虫次数 | POST /api/admin/crawler/grant |
| 查看发放记录 | GET /api/admin/crawler/grants |
| 查看邀请记录 | GET /api/admin/invite/rewards |
| 用户等级调整 | PUT /api/level/user/{userId} |
| 优惠券发放 | POST /api/coupon/issue |
| 平台分布统计 | GET /api/admin/crawler/user-detail |
| 营业执照审核 | GET/POST /api/admin/license/review |
| 等级配置版本管理 | POST/GET /api/admin/user-level-config/* |
| 操作审计日志 | GET /api/admin/audit-log/* |

---

## 3. 核心业务流程

### 3.1 用户注册登录流程

```
药店采购员打开App → 选择登录方式
├── 短信登录：输入手机号 → 获取验证码 → 输入验证码 → 登录/注册
│   └── 如有邀请码，自动建立邀请关系
└── 微信登录：扫码 → 授权 → 绑定手机号 → 登录
```

### 3.2 药品比价流程

```
输入药品名称（如：阿莫西林）
→ 选择比价平台（可多选：药师帮、药帮忙、1药城）
→ 点击"开始比价"
→ 系统逐个平台爬取价格（消耗配额）
→ 展示比价结果表格（按价格从低到高排序）
→ 点击"去采购"跳转到对应平台购买页面
```

### 3.3 爬虫消耗流程

```
用户发起比价请求
→ 校验日/月配额（等级基础 + 额外配额）
→ 配额充足 → 扣减额外配额（快过期优先）→ 记录日志（含平台信息）
→ 配额不足 → 尝试使用优惠券补充 → 仍不足则拒绝
```

### 3.4 邀请裂变流程

```
药店A获取邀请链接 → 复制链接分享到微信群/朋友圈
→ 药店B浏览器打开 → 展示落地页（A的药店名称 + 奖励说明 + 下载链接）
→ B下载注册 → 携带邀请码 → 建立邀请关系 → 发放奖励给A
→ A查看统计："已邀请X家药店，Y家注册 +Z次"
```

---

## 4. 多端交付策略

### 4.1 核心策略："Windows优先，多渠道扩展"

智价云采用**渐进式多端交付策略**：

1. **MVP阶段**：聚焦Windows桌面应用，验证核心业务流程
2. **Phase 2**：扩展移动端（小程序 + Android APP），提高用户便利性
3. **Phase 3**：完善社交渠道（公众号 + iOS APP），增强用户粘性
4. **Phase 4+**：企业集成（钉钉/飞书）+ 生态建设，构建行业壁垒

**目标**：通过多渠道触达，实现日活20万+的目标。

### 4.2 各端详细规划

#### Windows桌面应用（MVP核心 - P0）

- **角色**：专业采购工具，功能最完整
- **场景**：药店办公室日常采购、深度比价、批量查询
- **用户占比目标**：60%
- **技术特点**：WebView2浏览器引擎、自建安全策略、离线缓存

#### 微信小程序（Phase 2 - P1）

- **角色**：轻量级查询工具，快速比价
- **场景**：外出采购、临时查询、分享比价结果
- **用户占比目标**：25%
- **核心功能**：快速查询、关注列表、分享结果、扫码查询

#### Android APP（Phase 2 - P1）

- **角色**：移动端完整功能
- **场景**：移动办公、仓库盘点、现场比价
- **用户占比目标**：8%
- **核心功能**：完整比价、扫码查询、拍照识别、Push通知

#### 微信公众号（Phase 3 - P2）

- **角色**：消息推送和服务入口
- **场景**：降价提醒、审核结果通知、活动推送
- **用户占比目标**：5%
- **核心功能**：模板消息推送、菜单入口、H5页面嵌入

#### iOS APP（Phase 3 - P2）

- **角色**：覆盖iOS用户群体
- **用户占比目标**：2%

#### 钉钉/飞书集成（Phase 4 - P3）

- **角色**：企业内部协同工具
- **场景**：连锁药店内部采购协同、审批流程
- **用户占比目标**：< 1%

### 4.3 数据同步机制

所有端共享同一套账号体系，云端同步数据：

| 数据类型 | 同步方式 | 更新频率 |
|---------|---------|---------|
| 用户基本信息 | REST API | 实时 |
| 会员权益 | REST API | 实时 |
| 查询历史 | REST API + 本地缓存 | 实时上传，按需下载 |
| 关注列表 | REST API | 实时 |
| 平台账号绑定 | REST API（加密传输） | 实时 |
| 邀请关系 | REST API | 实时 |

---

## 5. 灵活配置策略

### 5.1 核心设计理念

智价云采用**"代码预留扩展 + 运营动态配置"**的设计策略：

1. **平台扩展性**：代码支持34个平台，MVP首期启用3个，后续通过运营配置逐步开放
2. **营业执照可选**：用户可以自愿上传，非强制要求，审核后显示认证标识
3. **体验配额可配**：运营可以动态调整体验天数、查询次数等参数
4. **会员体系迭代**：当前简化实现，后续根据运营需求迭代优化

### 5.2 平台配置策略

#### MVP首期（Phase 0）- 3个核心平台

| 平台 | 代码 | Badge颜色 | 状态 |
|------|------|----------|------|
| 药师帮 | yaoshibang | #FF6B00 | ✅ 已启用 |
| 药帮忙 | yaobangmang | #1890FF | ✅ 已启用 |
| 1药城 | yiyaocheng | #52C41A | ✅ 已启用 |

#### 后续扩展计划

- **Phase 2**：7个扩展B2B平台（药京采、健之佳、1药网等）
- **Phase 3**：6个区域B2B平台（珍诚医药、药易通等）
- **Phase 4**：8个B2C零售平台（叮当快药、老百姓大药房等）
- **Phase 5**：7个综合电商医药频道（京东健康、天猫医药等）
- **Phase 6**：4个垂直医药平台（微医、平安好医生等）

### 5.3 体验配额配置策略

运营可以动态调整以下参数：

| 参数 | 默认值 | 说明 |
|------|--------|------|
| 体验天数 | 15天 | 新用户免费体验时长 |
| 每日查询次数 | 20次 | 体验期每日可查询次数 |
| 每月关注品种数 | 199种 | 体验期每月可关注品种数 |

**配置类型**：
- **默认配置**：适用于所有新注册用户
- **体验券配置**：运营批量生成体验券，用户输入券码核销
- **活动配置**：特定活动期间自动应用

### 5.4 等级配置版本管理

**版本化管理能力**：
- 运营可以创建新的等级配置版本（草稿）
- 激活新版本后，新用户自动使用最新版本
- 老用户由运营决定迁移到哪个版本
- 支持灰度发布和A/B测试

---

## 6. 非功能性需求

| 维度 | MVP要求 | 生产环境目标 |
|------|---------|-------------|
| 性能 | 接口响应 < 500ms（P95），单次比价 < 3s | 接口响应 < 200ms（P95），单次比价 < 1s |
| 安全 | JWT 认证、参数校验、AES-256加密 | 增加接口限流、SQL注入防护、慢请求告警 |
| 可用性 | 单体部署，HikariCP 连接池 | Redis 缓存、集群部署、负载均衡 |
| 扩展性 | Maven 多模块架构 | 微服务拆分、事件驱动架构 |
| 兼容性 | JDK 17+，MySQL 8.0+，Windows 10/11 | 容器化部署、云原生支持 |
| 数据准确性 | 价格误差 < 5% | 价格误差 < 1%，实时同步 |
| 目标日活 | 1万+ | 20万+ |

---

## 7. MVP范围与规划

### 7.1 MVP 已实现功能 ✅

**核心功能**：
- [x] **Windows独立桌面应用**（.exe格式，内置WebView2浏览器引擎）
- [x] 用户认证（短信验证码登录、微信扫码登录）
- [x] 营业执照上传（可选，审核后显示认证标识）
- [x] B2B平台账号绑定（药师帮/药帮忙/1药城，密码AES-256加密存储）
- [x] 聚合比价功能（并行查询已绑平台，价格升序展示）
- [x] 跳转原平台购买（WebView内嵌跳转，不依赖系统浏览器）
- [x] 邀请裂变系统（多渠道落地页、URL Scheme自动填入邀请码）
- [x] 体验配额管理（运营可配置天数、查询次数、关注品种数）
- [x] 运营管理后台（配置管理、执照审核、数据统计）
- [x] 平台配置管理（34个平台预留，MVP启用3个，运营动态配置）
- [x] 用户等级配置版本管理（支持版本化、灰度发布）
- [x] 操作审计日志系统（记录所有关键操作，支持追溯）

**多端扩展准备**：
- [x] 统一账号体系设计（支持多端登录）
- [x] API接口标准化（RESTful，便于多端调用）
- [x] 数据同步机制设计（查询历史、关注列表云端同步）
- [ ] 微信小程序开发（Phase 2）
- [ ] Android APP开发（Phase 2）
- [ ] 微信公众号接入（Phase 3）
- [ ] iOS APP开发（Phase 3）

### 7.2 后续迭代规划 🚀

#### Phase 2：性能优化与多端扩展（上线后1-3个月）

**技术优化**：
- [ ] 接入真实Redis缓存（当前为Mock）
- [ ] 接口限流（Redis + Sentinel）
- [ ] 慢请求监控与告警
- [ ] 数据库读写分离

**多端扩展**：
- [ ] **微信小程序开发**（轻量级查询工具）
- [ ] **Android APP开发**（移动端完整功能）
- [ ] 数据同步服务（查询历史、关注列表云端同步）
- [ ] 统一消息推送服务

#### Phase 3：功能增强与渠道完善（上线后3-6个月）

**功能增强**：
- [ ] 支付系统集成（购买会员）
- [ ] 国家集采数据爬取（增强权威性）
- [ ] 价格趋势图表（近30天价格走势）
- [ ] 供应商评分系统
- [ ] 邀请排行榜与阶梯奖励
- [ ] 海报生成与分享

**渠道完善**：
- [ ] **微信公众号接入**（服务号消息推送）
- [ ] **iOS APP开发**（覆盖iOS用户）
- [ ] 小程序/APP扫码查询功能
- [ ] 拍照识别药品功能

#### Phase 4：智能推荐与企业集成（上线后6-9个月）

**智能功能**：
- [ ] AI价格预测（基于历史数据预测价格波动）
- [ ] 智能供应商推荐（综合价格、信誉、配送速度）
- [ ] 采购清单优化（批量采购最优组合）
- [ ] 个性化推荐（根据药店历史采购习惯）

**企业集成**：
- [ ] **钉钉工作台集成**（企业内部协同）
- [ ] **飞书工作台集成**（企业内部协同）
- [ ] 企业账号管理（多员工统一管理）
- [ ] 采购审批流程

#### Phase 5：架构升级与生态建设（上线后9-12个月）

**架构升级**：
- [ ] 微服务拆分（用户服务、配额服务、邀请服务、爬虫服务独立部署）
- [ ] 消息队列（异步处理爬虫任务和邀请奖励发放）
- [ ] 容器化部署（Docker + K8s）
- [ ] CI/CD自动化流水线
- [ ] 多地域部署（降低延迟）

**生态建设**：
- [ ] 开放API平台（第三方开发者接入）
- [ ] 插件市场（自定义功能扩展）
- [ ] 数据 marketplace（脱敏数据交易）
- [ ] 行业解决方案（连锁药店、单体药店差异化方案）

---

## 8. 业务指标

### 8.1 MVP阶段目标（上线后3个月）

| 指标 | 目标值 | 说明 |
|------|--------|------|
| 注册用户数 | 1万+ | 药店采购人员 |
| 日活跃用户（DAU） | 1000+ | 日均使用比价的药店数 |
| 日均比价次数 | 5000+ | 所有用户的比价操作总和 |
| 邀请转化率 | 15%+ | 被邀请人注册比例 |
| 用户留存率（7日） | 40%+ | 注册后7天内再次使用 |

### 8.2 长期目标（1年内）

| 指标 | 目标值 | 说明 |
|------|--------|------|
| 注册用户数 | 50万+ | 覆盖全国主要药店 |
| 日活跃用户（DAU） | 20万+ | **核心目标** |
| 日均比价次数 | 100万+ | 高频使用场景 |
| 付费转化率 | 10%+ | 升级为VIP/SVIP的比例 |
| 平均采购成本降低 | 15%+ | 相比单平台采购 |

---

**📝 说明**：本文档会随着项目迭代持续更新，请以最新版本为准。