更新

2026-03-11 14:33:49 +08:00
parent 38ad60f4bb
commit 08dd9cd307
57 changed files with 9547 additions and 379 deletions
@@ -0,0 +1,274 @@
+# 医生功能实现总结
+
+## 功能概述
+
+实现了小程序首页医生展示功能，包括：
+1. 古典卷轴风格幻灯片
+2. 动态医生列表展示（从后端API获取）
+3. 医生卡片点击跳转到挂号页面
+
+## 后端实现
+
+### 1. 医生逻辑层 (DoctorLogic)
+
+**文件**: `server/app/api/logic/DoctorLogic.php`
+
+**功能**:
+- `getDoctorList()` - 获取医生列表，支持分页和搜索
+- `getDoctorDetail()` - 获取单个医生详情
+- `getDoctorRoster()` - 获取医生排班信息
+
+**数据来源**: `zyt_admin` 表（role_id = 1 的医生）
+
+**返回字段**:
+```php
+[
+    'id' => 医生ID,
+    'name' => 医生名字,
+    'account' => 医生账号,
+    'avatar' => 医生头像URL,
+    'mobile' => 医生手机,
+    'email' => 医生邮箱,
+    'specialty' => 专科,
+    'title' => 职位,
+    'rating' => 评分
+]
+```
+
+### 2. 医生控制器 (DoctorController)
+
+**文件**: `server/app/api/controller/DoctorController.php`
+
+**API端点**:
+- `GET /api/doctor/lists` - 获取医生列表
+- `GET /api/doctor/detail` - 获取医生详情
+- `GET /api/doctor/roster` - 获取医生排班
+
+**无需登录的端点**: `lists`, `detail`
+
+## 前端实现
+
+### 1. API 服务层
+
+**文件**: `TUICallKit-Vue3/utils/api.js`
+
+**功能**:
+- 统一的API请求管理
+- 自动添加认证token
+- 错误处理
+
+**使用示例**:
+```javascript
+import { doctorApi } from '@/utils/api'
+
+// 获取医生列表
+const response = await doctorApi.getDoctorList({
+  page_no: 1,
+  page_size: 10
+})
+```
+
+### 2. 首页组件
+
+**文件**: `TUICallKit-Vue3/pages/index/index.vue`
+
+**功能**:
+- 古典卷轴风格幻灯片（自动轮播）
+- 医生列表展示（动态加载）
+- 医生卡片交互（点击跳转）
+
+**样式特点**:
+- 金色卷轴装饰（#d4af37）
+- 渐变背景效果
+- 响应式布局
+- 医生卡片网格展示（2列）
+
+## 数据库表结构
+
+### zyt_admin 表（医生数据来源）
+
+```sql
+CREATE TABLE `zyt_admin` (
+  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `name` varchar(50) NOT NULL COMMENT '管理员名称',
+  `account` varchar(50) NOT NULL COMMENT '管理员账号',
+  `avatar` varchar(255) DEFAULT NULL COMMENT '头像',
+  `mobile` varchar(20) DEFAULT NULL COMMENT '手机号',
+  `email` varchar(100) DEFAULT NULL COMMENT '邮箱',
+  `role_id` int(11) DEFAULT NULL COMMENT '角色ID（1=医生）',
+  `disable` tinyint(1) DEFAULT '0' COMMENT '是否禁用（0=否，1=是）',
+  `create_time` int(10) unsigned DEFAULT NULL COMMENT '创建时间',
+  `update_time` int(10) unsigned DEFAULT NULL COMMENT '更新时间',
+  `delete_time` int(10) unsigned DEFAULT NULL COMMENT '删除时间',
+  PRIMARY KEY (`id`),
+  KEY `idx_role_id` (`role_id`),
+  KEY `idx_disable` (`disable`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理员表';
+```
+
+### la_doctor_roster 表（医生排班）
+
+```sql
+CREATE TABLE `la_doctor_roster` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `doctor_id` int(11) NOT NULL COMMENT '医生ID',
+  `date` date NOT NULL COMMENT '日期',
+  `period` varchar(20) NOT NULL COMMENT '时段（morning/afternoon）',
+  `status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '状态（1-出诊 2-停诊 3-休息 4-请假）',
+  `quota` int(11) DEFAULT '0' COMMENT '号源数',
+  `max_patients` int(11) DEFAULT '0' COMMENT '最大接诊数',
+  `create_time` int(11) NOT NULL COMMENT '创建时间',
+  `update_time` int(11) NOT NULL COMMENT '更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_doctor_date_period` (`doctor_id`,`date`,`period`),
+  KEY `idx_date` (`date`),
+  KEY `idx_doctor` (`doctor_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='医生排班表';
+```
+
+## 配置说明
+
+### 后端配置
+
+1. 确保 `zyt_admin` 表中有医生记录（role_id = 1）
+2. 医生的 `disable` 字段应为 0
+3. 医生的 `avatar` 字段应包含完整的URL或相对路径
+
+### 前端配置
+
+1. 创建 `.env` 文件（参考 `.env.example`）：
+```
+VUE_APP_API_URL=http://your-api-domain/api
+```
+
+2. 或在 `utils/api.js` 中直接修改 `API_BASE_URL`
+
+## 使用流程
+
+### 1. 后端准备
+
+```bash
+# 确保医生数据已添加到 zyt_admin 表
+# 示例SQL：
+INSERT INTO zyt_admin (name, account, avatar, mobile, email, role_id, disable, create_time)
+VALUES ('张医生', 'doctor1', 'http://example.com/avatar.jpg', '13800138000', 'doctor@example.com', 1, 0, UNIX_TIMESTAMP());
+```
+
+### 2. 前端使用
+
+首页会自动：
+1. 加载医生列表
+2. 展示医生卡片
+3. 支持点击跳转到挂号页面
+
+## 测试
+
+### 运行测试脚本
+
+```bash
+php server/test_doctor_api.php
+```
+
+### 手动测试
+
+1. 获取医生列表：
+```
+GET http://localhost:8000/api/doctor/lists?page_no=1&page_size=10
+```
+
+2. 获取医生详情：
+```
+GET http://localhost:8000/api/doctor/detail?id=1
+```
+
+3. 获取医生排班：
+```
+GET http://localhost:8000/api/doctor/roster?doctor_id=1&date=2024-03-11
+```
+
+## 扩展功能
+
+### 1. 添加医生专科和职位
+
+修改 `DoctorLogic.php`：
+```php
+// 从科室表获取专科
+$doctor['specialty'] = Dept::find($doctor['dept_id'])->name ?? '医生';
+
+// 从职位表获取职位
+$doctor['title'] = Jobs::find($doctor['jobs_id'])->name ?? '医生';
+```
+
+### 2. 添加医生评分
+
+```php
+// 从评价表计算平均评分
+$doctor['rating'] = DoctorRating::where('doctor_id', $doctor['id'])
+    ->avg('rating') ?? '4.8';
+```
+
+### 3. 添加医生简介
+
+```php
+// 从医生表获取简介
+$doctor['introduction'] = DoctorInfo::where('doctor_id', $doctor['id'])
+    ->value('introduction') ?? '';
+```
+
+### 4. 添加在线状态
+
+```php
+// 检查医生是否在线
+$doctor['is_online'] = DoctorSession::where('doctor_id', $doctor['id'])
+    ->where('expire_time', '>', time())
+    ->exists();
+```
+
+## 常见问题
+
+### Q: 医生列表为空？
+A: 
+1. 检查 `zyt_admin` 表中是否有 `role_id = 1` 的记录
+2. 检查医生的 `disable` 字段是否为 0
+3. 检查API是否正确返回数据
+
+### Q: 头像无法显示？
+A:
+1. 确保 `avatar` 字段包含完整的URL
+2. 检查图片服务器是否可访问
+3. 检查CORS配置
+
+### Q: 如何修改医生信息？
+A:
+1. 在后台管理系统中编辑医生信息
+2. 或直接修改 `zyt_admin` 表
+
+### Q: 如何添加新医生？
+A:
+1. 在后台管理系统中创建新管理员
+2. 设置 `role_id = 1`（医生角色）
+3. 设置 `disable = 0`（启用）
+
+## 相关文件清单
+
+### 后端文件
+- `server/app/api/logic/DoctorLogic.php` - 医生逻辑层
+- `server/app/api/controller/DoctorController.php` - 医生控制器
+- `server/test_doctor_api.php` - API测试脚本
+
+### 前端文件
+- `TUICallKit-Vue3/utils/api.js` - API服务层
+- `TUICallKit-Vue3/pages/index/index.vue` - 首页组件
+- `TUICallKit-Vue3/.env.example` - 环境配置示例
+
+### 文档文件
+- `DOCTOR_API_GUIDE.md` - API接口文档
+- `DOCTOR_FEATURE_IMPLEMENTATION.md` - 本文件
+
+## 下一步
+
+1. 根据实际需求扩展医生信息字段
+2. 添加医生搜索和筛选功能
+3. 实现医生评价和评分系统
+4. 添加医生在线状态显示
+5. 实现医生排班查询功能