初始化

2026-07-08 15:04:42 +08:00
commit 70264153e5
129 changed files with 13797 additions and 0 deletions
--- a/docs/projects/xk-client-wx/architecture.md
+++ b/docs/projects/xk-client-wx/architecture.md
@@ -0,0 +1,50 @@
+# xk-client-wx 基类架构
+
+## 页面结构
+
+```mermaid
+graph TB
+    subgraph 主包 pages/
+        HOME[首页<br/>pages/home]
+        CATE[健康资讯<br/>pages/cate]
+        MSG[消息<br/>pages/index]
+        MINE[我的<br/>pages/mine]
+        LOGIN[登录<br/>pages/login]
+    end
+
+    subgraph 分包 subPackages/
+        DOC[doctor/<br/>医生详情/问诊]
+        PROD[product/<br/>商品浏览]
+        FU[follow-up/<br/>复诊续方]
+        SP[special-prescription/<br/>特色处方]
+        MY[my/<br/>我的记录/订单]
+        REG[register/<br/>挂号预约]
+        SHOP[shop/<br/>商城订单]
+        SET[setup/<br/>设置/协议]
+        CHAT[chat/<br/>在线问诊]
+        TRANS[transfer/<br/>转诊咨询]
+    end
+
+    HOME --> DOC
+    HOME --> PROD
+    HOME --> SP
+    MINE --> MY
+    MINE --> SET
+    DOC --> CHAT
+    DOC --> REG
+    PROD --> SHOP
+```
+
+## 请求模块
+
+`request/` 目录封装了 HTTP 请求：
+- 统一请求拦截器
+- Token 注入
+- 错误处理
+- 基础 URL 配置
+
+## 状态管理
+
+使用 Vuex + Pinia 双状态管理：
+- Vuex: 旧模块状态
+- Pinia: 新模块状态
--- a/docs/projects/xk-client-wx/components.md
+++ b/docs/projects/xk-client-wx/components.md
@@ -0,0 +1,29 @@
+# xk-client-wx 通用组件
+
+## 页面组件
+
+| 组件 | 说明 |
+|------|------|
+| 医生卡片 | 医生信息展示（头像、姓名、职称、擅长） |
+| 药品卡片 | 药品信息展示（图片、名称、规格、价格） |
+| 处方卡片 | 处方信息展示（处方内容、状态） |
+| 订单卡片 | 订单信息展示（商品、金额、状态） |
+| 地址选择 | 收货地址选择组件 |
+
+## 功能组件
+
+| 组件 | 说明 |
+|------|------|
+| 登录弹窗 | 微信授权登录 |
+| 加载更多 | 列表分页加载 |
+| 空状态 | 空数据提示 |
+| 价格显示 | 价格格式化显示 |
+| 状态标签 | 订单/处方状态标签 |
+
+## 工具函数
+
+| 工具 | 说明 |
+|------|------|
+| `request/` | HTTP 请求封装 |
+| `utils/` | 工具函数 |
+| `common/` | 公共方法 |
--- a/docs/projects/xk-client-wx/design.md
+++ b/docs/projects/xk-client-wx/design.md
@@ -0,0 +1,44 @@
+# xk-client-wx 设计思路
+
+## 架构决策
+
+### uni-app 跨平台
+
+选择 uni-app 作为小程序框架：
+- 一套代码多端运行（微信小程序、H5、App）
+- Vue 3 Composition API 支持
+- 丰富的插件生态
+
+### 分包加载
+
+使用分包（subPackages）优化首屏加载：
+- 主包：核心页面（首页、消息、我的）
+- 分包：业务页面（问诊、购药、挂号等）
+- 按需加载，减少初始包体积
+
+### 状态管理
+
+Vuex + Pinia 双状态管理：
+- Vuex: 旧模块状态（兼容性）
+- Pinia: 新模块状态（推荐）
+- 逐步迁移到 Pinia
+
+## 用户体验
+
+### 首页设计
+- 顶部：门店信息、搜索
+- 中部：医生推荐、药品推荐
+- 底部：特色处方、健康资讯
+
+### 问诊流程
+1. 选择医生 → 查看详情
+2. 发起问诊 → 选择就诊人
+3. 发送症状描述 → 等待医生回复
+4. 医生开具处方 → 查看处方
+5. 确认购药 → 下单支付
+
+### 购药流程
+1. 浏览药品 → 加入购物车
+2. 选择收货地址
+3. 确认订单 → 支付
+4. 等待发货 → 查看物流
--- a/docs/projects/xk-client-wx/modules/consultation.md
+++ b/docs/projects/xk-client-wx/modules/consultation.md
@@ -0,0 +1,41 @@
+# 问诊模块
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 医生列表 | `pages/Inquiries/` | 按科室、擅长筛选医生 |
+| 医生详情 | `subPackages/doctor/` | 医生信息、评价、开诊时间 |
+| 图文问诊 | `subPackages/doctor/` | 发起图文问诊 |
+| 在线问诊聊天 | `subPackages/chat/` | 实时聊天界面 |
+
+## 问诊流程
+
+```mermaid
+graph TB
+    A[选择医生] --> B[查看医生详情]
+    B --> C[发起问诊]
+    C --> D[选择就诊人]
+    D --> E[发送症状描述]
+    E --> F[等待医生回复]
+    F --> G[医生回复]
+    G --> H{是否需要开方}
+    H -->|是| I[医生开具处方]
+    H -->|否| J[继续问诊]
+    I --> K[查看处方]
+    K --> L{是否购药}
+    L -->|是| M[确认购药]
+    L -->|否| N[结束问诊]
+```
+
+## 聊天消息类型
+
+| 类型 | 说明 |
+|------|------|
+| 文字 | 文本消息 |
+| 图片 | 图片消息 |
+| 语音 | 语音消息 |
+| 处方 | 处方卡片 |
+| 病历 | 病历文件 |
+| 视频通话 | 视频通话 |
+| 结束问诊 | 结束问诊 |
--- a/docs/projects/xk-client-wx/modules/home.md
+++ b/docs/projects/xk-client-wx/modules/home.md
@@ -0,0 +1,26 @@
+# 首页模块
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 首页 | `pages/home/` | 门店信息、医生列表、药品推荐、特色处方入口 |
+
+## 功能
+
+- 门店信息展示
+- 医生推荐列表
+- 药品推荐列表
+- 特色处方入口
+- 健康资讯入口
+
+## 页面结构
+
+```mermaid
+graph TB
+    HOME[首页] --> STORE[门店信息]
+    HOME --> DOC[医生推荐]
+    HOME --> DRUG[药品推荐]
+    HOME --> SP[特色处方]
+    HOME --> NEWS[健康资讯]
+```
--- a/docs/projects/xk-client-wx/modules/index.md
+++ b/docs/projects/xk-client-wx/modules/index.md
@@ -0,0 +1,13 @@
+# xk-client-wx 功能模块
+
+## 模块清单
+
+| 模块 | 说明 | 页面 |
+|------|------|------|
+| 首页模块 | 门店信息、医生推荐、药品推荐 | [首页模块](./home.md) |
+| 问诊模块 | 医生浏览、图文问诊、在线聊天 | [问诊模块](./consultation.md) |
+| 购药模块 | 商品浏览、购物车、下单支付 | [购药模块](./product.md) |
+| 挂号模块 | 挂号预约、挂号记录 | [挂号模块](./register.md) |
+| 处方模块 | 处方查看、特色处方、复诊续方 | [处方模块](./prescription.md) |
+| 转诊模块 | 转诊咨询 | [转诊模块](./transfer.md) |
+| 个人中心 | 我的、就诊人、设置 | [个人中心](./mine.md) |
--- a/docs/projects/xk-client-wx/modules/mine.md
+++ b/docs/projects/xk-client-wx/modules/mine.md
@@ -0,0 +1,38 @@
+# 个人中心
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 我的 | `pages/mine/` | 个人信息、快捷入口 |
+| 就诊人管理 | `subPackages/my/` | 就诊人添加、编辑 |
+| 健康档案 | `subPackages/my/` | 健康信息 |
+| 设置 | `subPackages/setup/` | 个人设置 |
+| 协议 | `subPackages/setup/` | 服务协议、隐私政策 |
+
+## 功能
+
+- 个人信息查看/编辑
+- 就诊人管理（添加/编辑/删除）
+- 健康档案查看
+- 我的订单
+- 我的挂号
+- 我的处方
+- 设置
+- 协议查看
+- 客服联系
+
+## 页面结构
+
+```mermaid
+graph TB
+    MINE[我的] --> INFO[个人信息]
+    MINE --> PATIENT[就诊人管理]
+    MINE --> HEALTH[健康档案]
+    MINE --> ORDER[我的订单]
+    MINE --> REG[我的挂号]
+    MINE --> PRESC[我的处方]
+    MINE --> SET[设置]
+    MINE --> AGREEMENT[协议]
+    MINE --> SERVICE[客服]
+```
--- a/docs/projects/xk-client-wx/modules/prescription.md
+++ b/docs/projects/xk-client-wx/modules/prescription.md
@@ -0,0 +1,38 @@
+# 处方模块
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 处方查看 | `subPackages/doctor/` | 查看处方详情 |
+| 特色处方 | `subPackages/special-prescription/` | 特色药方浏览、购买 |
+| 复诊续方 | `subPackages/follow-up/` | 复诊续方 |
+
+## 处方类型
+
+| 类型 | 值 | 说明 |
+|------|-----|------|
+| 中药 | 1 | 中药饮片处方 |
+| 西药 | 2 | 西药处方 |
+| 颗粒 | 3 | 配方颗粒处方 |
+| 中成药 | 4 | 中成药处方 |
+| 服务包 | 5 | 服务包处方 |
+
+## 处方状态
+
+| 状态 | 值 | 说明 |
+|------|-----|------|
+| 待审核 | 0 | 医生已开方 |
+| 通过 | 1 | 审核通过 |
+| 未通过 | 2 | 审核拒绝 |
+| 无需审核 | 3 | 免审处方 |
+
+## 特色处方购买流程
+
+```mermaid
+graph TB
+    A[浏览特色处方] --> B[选择剂量]
+    B --> C[确认购买]
+    C --> D[支付]
+    D --> E[处方生效]
+```
--- a/docs/projects/xk-client-wx/modules/product.md
+++ b/docs/projects/xk-client-wx/modules/product.md
@@ -0,0 +1,37 @@
+# 购药模块
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 商品浏览 | `subPackages/product/` | 药品列表、搜索、分类 |
+| 商品详情 | `subPackages/product/` | 药品详情、价格、库存 |
+| 购物车 | `subPackages/shop/` | 购物车管理 |
+| 下单 | `subPackages/shop/` | 确认订单、选择地址 |
+| 订单列表 | `subPackages/my/` | 我的订单 |
+| 订单详情 | `subPackages/my/` | 订单状态、物流 |
+
+## 购药流程
+
+```mermaid
+graph TB
+    A[浏览药品] --> B[加入购物车]
+    B --> C[选择收货地址]
+    C --> D[确认订单]
+    D --> E[支付]
+    E --> F[等待发货]
+    F --> G[查看物流]
+    G --> H[确认收货]
+```
+
+## 订单状态
+
+| 状态 | 说明 |
+|------|------|
+| 待支付 | 订单已创建 |
+| 待发货 | 已支付，等待发货 |
+| 待收货 | 已发货，等待收货 |
+| 已收货 | 已确认收货 |
+| 已取消 | 订单已取消 |
+| 退款中 | 退款处理中 |
+| 已退款 | 退款完成 |
--- a/docs/projects/xk-client-wx/modules/register.md
+++ b/docs/projects/xk-client-wx/modules/register.md
@@ -0,0 +1,28 @@
+# 挂号模块
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 挂号预约 | `subPackages/register/` | 选择科室、医生、时间 |
+| 挂号记录 | `subPackages/my/` | 我的挂号记录 |
+
+## 挂号流程
+
+```mermaid
+graph TB
+    A[选择科室] --> B[选择医生]
+    B --> C[选择时间]
+    C --> D[选择就诊人]
+    D --> E[确认挂号]
+    E --> F[支付]
+    F --> G[挂号成功]
+```
+
+## 挂号类型
+
+| 类型 | 值 | 说明 |
+|------|-----|------|
+| 线下 | 0 | 线下挂号 |
+| 线上 | 1 | 线上挂号 |
+| 线上复诊 | 2 | 线上复诊挂号 |
--- a/docs/projects/xk-client-wx/modules/transfer.md
+++ b/docs/projects/xk-client-wx/modules/transfer.md
@@ -0,0 +1,37 @@
+# 转诊模块
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 转诊咨询 | `subPackages/transfer/` | 转诊咨询流程 |
+
+## 转诊流程
+
+```mermaid
+graph TB
+    A[发起转诊] --> B[选择转诊门店]
+    B --> C[填写患者信息]
+    C --> D[提交转诊]
+    D --> E[等待接收方确认]
+    E --> F{是否确认}
+    F -->|是| G[导入为挂号]
+    F -->|否| H[转诊取消]
+    G --> I[接收方接诊]
+    I --> J[开具处方]
+    J --> K[患者购药]
+```
+
+## 转诊类型
+
+| 类型 | 说明 |
+|------|------|
+| 转诊方 | 发起转诊的门店 |
+| 接收方 | 接收转诊的门店 |
+
+## 转诊分账
+
+::: warning 关键逻辑
+- 转诊方（发起方）获得 **100%** 利润
+- 接收方（被转方）获得 **0%** 利润
+:::
--- a/docs/projects/xk-client-wx/overview.md
+++ b/docs/projects/xk-client-wx/overview.md
@@ -0,0 +1,68 @@
+# xk-client-wx 概览
+
+xk-client-wx 是 XK 系统的患者端微信小程序，基于 uni-app 构建。
+
+## 基本信息
+
+| 项 | 值 |
+|----|-----|
+| 框架 | uni-app (Vue 3 Composition API) |
+| UI 库 | uview-ui 1.8.8 |
+| 状态管理 | Vuex 3.6.2 + Pinia 2.0.14 |
+| 构建工具 | HBuilderX |
+| 其他 | js-base64, vue-demi |
+
+## 目录结构
+
+```
+xk-client-wx/
+├── App.vue             # 应用入口
+├── main.js             # 主入口
+├── manifest.json       # uni-app 配置
+├── pages.json          # 页面路由
+├── common/             # 公共工具
+├── components/         # 共享组件
+├── pages/              # 主包页面
+│   ├── home/           # 首页
+│   ├── cate/           # 健康资讯
+│   ├── index/          # 消息
+│   ├── login/          # 登录
+│   ├── mine/           # 我的
+│   └── Inquiries/      # 医生列表
+├── subPackages/        # 分包（懒加载）
+│   ├── doctor/         # 医生详情、问诊
+│   ├── product/        # 商品浏览
+│   ├── follow-up/      # 复诊续方
+│   ├── special-prescription/ # 特色处方
+│   ├── my/             # 我的记录、订单、就诊人
+│   ├── register/       # 挂号预约
+│   ├── shop/           # 商城订单
+│   ├── setup/          # 设置、协议
+│   ├── chat/           # 在线问诊聊天
+│   └── transfer/       # 转诊咨询
+├── request/            # HTTP 请求模块
+├── static/             # 静态资源
+├── store/              # Vuex/Pinia Store
+└── utils/              # 工具函数
+```
+
+## Tab Bar 页面
+
+| Tab | 页面 | 说明 |
+|-----|------|------|
+| 首页 | `pages/home` | 首页展示 |
+| 健康资讯 | `pages/cate` | 健康文章浏览 |
+| 消息 | `pages/index` | 消息通知 |
+| 我的 | `pages/mine` | 个人中心 |
+
+## 主要功能
+
+- 医生浏览和问诊（图文问诊）
+- 商品浏览和购药
+- 挂号预约
+- 处方查看
+- 特色药方
+- 在线问诊聊天
+- 转诊咨询
+- 商城订单、购物车、物流
+- 设置、协议、客服