# 医生列表接口优化

## 问题描述

在挂号预约页面中，获取医生列表时调用了 `adminapi/auth.admin/lists?role_id=1` 接口，该接口需要管理员权限，可能导致权限不足的问题。

## 解决方案

创建一个专门的接口 `adminapi/tcm.diagnosis/getDoctors` 用于获取医生列表，不需要额外的权限验证。

## 实现细节

### 1. 后端实现

#### 控制器方法
**文件：** `server/app/adminapi/controller/tcm/DiagnosisController.php`

```php
/**
 * @notes 获取医生列表
 * @return \think\response\Json
 */
public function getDoctors()
{
    $result = DiagnosisLogic::getDoctors();
    return $this->data($result);
}
```

#### 逻辑层方法
**文件：** `server/app/adminapi/logic/tcm/DiagnosisLogic.php`

```php
/**
 * @notes 获取医生列表
 * @return array
 */
public static function getDoctors()
{
    try {
        // 通过中间表查询角色ID为1的管理员（医生）
        $doctors = \app\common\model\auth\Admin::alias('a')
            ->join('admin_role ar', 'a.id = ar.admin_id')
            ->where('ar.role_id', 1)
            ->where('a.disable', 0)
            ->field(['a.id', 'a.name', 'a.account'])
            ->order('a.id', 'asc')
            ->select()
            ->toArray();
        
        return $doctors;
    } catch (\Exception $e) {
        \think\facade\Log::error('获取医生列表失败: ' . $e->getMessage());
        return [];
    }
}
```

### 2. 前端实现

#### API 方法
**文件：** `admin/src/api/tcm.ts`

```typescript
// 获取医生列表
export function getDoctors() {
    return request.get({ url: '/tcm.diagnosis/getDoctors' })
}
```

#### 组件更新
**文件：** `admin/src/views/tcm/diagnosis/appointment.vue`

```typescript
// 导入新的 API
import { getDoctors } from '@/api/tcm'

// 移除旧的导入
// import { adminLists } from '@/api/perms/admin'

// 更新加载医生列表的方法
const loadDoctors = async () => {
  try {
    loading.value = true
    const res = await getDoctors()
    doctorList.value = res || []
  } catch (error) {
    console.error('加载医生列表失败:', error)
    feedback.msgError('加载医生列表失败')
  } finally {
    loading.value = false
  }
}
```

## 数据库结构

### 表关系

```
zyt_admin (管理员表)
  ├─ id
  ├─ name
  ├─ account
  └─ disable

zyt_admin_role (管理员角色关联表)
  ├─ admin_id  → zyt_admin.id
  └─ role_id   → 1 (医生) / 2 (医助)
```

### SQL 查询

```sql
SELECT a.id, a.name, a.account
FROM zyt_admin a
INNER JOIN zyt_admin_role ar ON a.id = ar.admin_id
WHERE ar.role_id = 1
  AND a.disable = 0
ORDER BY a.id ASC
```

## 接口说明

### 请求

```
GET /adminapi/tcm.diagnosis/getDoctors
```

### 响应

```json
{
    "code": 1,
    "msg": "success",
    "data": [
        {
            "id": 1,
            "name": "张医生",
            "account": "doctor1"
        },
        {
            "id": 2,
            "name": "李医生",
            "account": "doctor2"
        }
    ]
}
```

### 返回字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 医生ID |
| name | string | 医生姓名 |
| account | string | 医生账号 |

## 优势

1. **权限独立**：不依赖管理员列表接口的权限
2. **数据精简**：只返回必要的字段（id、name、account）
3. **性能优化**：直接通过中间表查询医生角色
4. **易于维护**：专门的接口更容易理解和维护
5. **正确的关联**：使用中间表 `admin_role` 而不是直接查询 `role_id` 字段

## 查询条件

- 通过 `zyt_admin_role` 中间表关联
- `ar.role_id = 1`：只查询医生角色
- `a.disable = 0`：只查询启用状态的医生
- 按 `a.id` 升序排列

## 测试

### 测试步骤

1. 登录管理后台
2. 访问诊单管理页面
3. 点击某条诊单的"挂号"按钮
4. 查看医生下拉列表是否正常显示

### 预期结果

- ✅ 医生列表正常加载
- ✅ 下拉框显示所有启用的医生
- ✅ 不会出现权限不足的错误
- ✅ 可以正常选择医生和预约

### 测试 SQL

```sql
-- 检查医生数据
SELECT 
    a.id,
    a.name,
    a.account,
    ar.role_id,
    a.disable
FROM zyt_admin a
INNER JOIN zyt_admin_role ar ON a.id = ar.admin_id
WHERE ar.role_id = 1
ORDER BY a.id ASC;

-- 检查中间表数据
SELECT * FROM zyt_admin_role WHERE role_id = 1;
```

## 已修改的文件

- ✅ `server/app/adminapi/controller/tcm/DiagnosisController.php`
- ✅ `server/app/adminapi/logic/tcm/DiagnosisLogic.php`
- ✅ `admin/src/api/tcm.ts`
- ✅ `admin/src/views/tcm/diagnosis/appointment.vue`

## 相关接口

### 医助列表接口

同时也创建了医助列表接口，使用相同的逻辑：

```
GET /adminapi/tcm.diagnosis/getAssistants
```

查询条件：`ar.role_id = 2`（医助角色）

## 注意事项

1. **中间表关联**：必须通过 `zyt_admin_role` 中间表查询，不能直接查询 `role_id` 字段
2. **角色ID**：
   - 医生：`role_id = 1`
   - 医助：`role_id = 2`
3. **状态检查**：只返回 `disable = 0` 的用户
4. **字段精简**：只返回必要的字段，减少数据传输
5. **错误处理**：捕获异常并记录日志，返回空数组而不是抛出错误

## 数据库检查

### 检查医生数据

```sql
-- 查看所有医生
SELECT 
    a.id,
    a.name,
    a.account,
    ar.role_id,
    a.disable,
    a.create_time
FROM zyt_admin a
INNER JOIN zyt_admin_role ar ON a.id = ar.admin_id
WHERE ar.role_id = 1
ORDER BY a.id ASC;
```

### 添加测试医生

```sql
-- 1. 添加管理员
INSERT INTO zyt_admin (
    name, 
    account, 
    password, 
    disable, 
    create_time, 
    update_time
) VALUES (
    '测试医生',
    'test_doctor',
    'e10adc3949ba59abbe56e057f20f883e',  -- 密码：123456
    0,
    UNIX_TIMESTAMP(),
    UNIX_TIMESTAMP()
);

-- 2. 获取刚插入的ID
SET @admin_id = LAST_INSERT_ID();

-- 3. 添加角色关联
INSERT INTO zyt_admin_role (admin_id, role_id) 
VALUES (@admin_id, 1);
```

---

**修复日期：** 2024-03-04
**状态：** ✅ 完成