# 诊单查看记录功能

## 功能概述
记录用户查看和确认诊单的行为，包括查看次数、查看时间、确认状态等信息。

## 数据库表结构

### la_diagnosis_view_records 表
```sql
CREATE TABLE `la_diagnosis_view_records` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `user_id` int(11) NOT NULL DEFAULT '0' COMMENT '查看用户ID',
  `diagnosis_id` int(11) NOT NULL DEFAULT '0' COMMENT '诊单ID',
  `patient_id` int(11) NOT NULL DEFAULT '0' COMMENT '患者ID',
  `share_user_id` int(11) NOT NULL DEFAULT '0' COMMENT '分享用户ID',
  `view_count` int(11) NOT NULL DEFAULT '1' COMMENT '查看次数',
  `first_view_time` int(11) NOT NULL DEFAULT '0' COMMENT '首次查看时间',
  `last_view_time` int(11) NOT NULL DEFAULT '0' COMMENT '最后查看时间',
  `is_confirmed` tinyint(1) NOT NULL DEFAULT '0' COMMENT '是否已确认 0-未确认 1-已确认',
  `confirmed_time` int(11) NOT NULL DEFAULT '0' COMMENT '确认时间',
  `create_time` int(11) NOT NULL DEFAULT '0' COMMENT '创建时间',
  `update_time` int(11) NOT NULL DEFAULT '0' COMMENT '更新时间',
  `delete_time` int(11) DEFAULT NULL COMMENT '删除时间',
  PRIMARY KEY (`id`),
  KEY `idx_user_diagnosis` (`user_id`, `diagnosis_id`),
  KEY `idx_diagnosis` (`diagnosis_id`),
  KEY `idx_patient` (`patient_id`),
  KEY `idx_share_user` (`share_user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='诊单查看记录表';
```

## 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| user_id | int | 查看用户ID（当前登录用户） |
| diagnosis_id | int | 诊单ID |
| patient_id | int | 患者ID（从诊单获取） |
| share_user_id | int | 分享用户ID（生成二维码的用户） |
| view_count | int | 查看次数（每次打开页面+1） |
| first_view_time | int | 首次查看时间戳 |
| last_view_time | int | 最后查看时间戳 |
| is_confirmed | tinyint | 是否已确认（0-未确认 1-已确认） |
| confirmed_time | int | 确认时间戳 |

## 后端实现

### 1. 模型文件
`server/app/common/model/DiagnosisViewRecord.php`

### 2. 控制器方法
`server/app/api/controller/TcmController.php`

#### diagnosisDetail - 获取诊单详情
```php
GET /api/tcm/diagnosisDetail
参数:
- id: 诊单ID（必填）
- user_id: 查看用户ID（选填，默认0）
- share_user_id: 分享用户ID（选填，默认0）

功能:
1. 获取诊单详情
2. 自动记录查看行为
3. 如果是首次查看，创建新记录
4. 如果已有记录，更新查看次数和最后查看时间
```

#### confirmDiagnosis - 确认诊单
```php
POST /api/tcm/confirmDiagnosis
参数:
- id: 诊单ID（必填）
- user_id: 查看用户ID（选填，默认0）
- share_user: 分享用户ID（选填，默认0）

功能:
1. 更新查看记录的确认状态
2. 记录确认时间
3. 如果没有查看记录，创建一条已确认的记录
```

### 3. 逻辑层方法
`server/app/adminapi/logic/tcm/DiagnosisLogic.php`

#### diagnosisDetailWithRecord
- 获取诊单详情并记录查看行为
- 调用 `recordDiagnosisView` 记录查看

#### recordDiagnosisView
- 查找是否已有记录
- 首次查看：创建新记录
- 再次查看：更新查看次数和最后查看时间

#### confirmDiagnosisRecord
- 更新确认状态
- 记录确认时间

## 前端实现

### 小程序页面
`TUICallKit-Vue3/pages/order/monad/monad.vue`

#### 参数解析
```javascript
const parsePageParams = (options) => {
    // 解析scene参数（扫码进入）
    // 解析普通参数（跳转进入）
    // 获取当前登录用户ID
    return params;
};
```

#### 加载诊单详情
```javascript
const res = await proxy.apiUrl({
    url: '/api/tcm/diagnosisDetail',
    method: 'GET',
    data: {
        id: diagnosisId,
        user_id: params.user_id || 0,
        share_user_id: params.share_user || 0
    }
});
```

#### 确认诊单
```javascript
const res = await proxy.apiUrl({
    url: '/api/tcm/confirmDiagnosis',
    method: 'POST',
    data: {
        id: params.id,
        user_id: params.user_id || 0,
        share_user: params.share_user || 0
    }
});
```

## 使用流程

### 1. 生成二维码
管理员在后台点击"小程序二维码"按钮
- 传递参数：`diagnosis_id`, `patient_id`, `share_user_id`
- 生成scene: `id=4&share_user=1`

### 2. 用户扫码
用户使用微信扫描二维码
- 小程序接收参数：`scene: "id%3D4%26share_user%3D1"`
- 解析参数：`{ id: "4", share_user: "1" }`

### 3. 查看诊单
小程序加载诊单详情
- 调用 `/api/tcm/diagnosisDetail`
- 传递：`id`, `user_id`, `share_user_id`
- 后端自动记录查看行为

### 4. 确认诊单
用户点击"确认诊单"按钮
- 调用 `/api/tcm/confirmDiagnosis`
- 传递：`id`, `user_id`, `share_user`
- 后端更新确认状态

## 数据统计

### 可统计的数据
1. 每个诊单的查看次数
2. 每个用户查看了哪些诊单
3. 诊单的确认率
4. 分享效果（通过share_user_id统计）
5. 首次查看到确认的时间间隔

### 查询示例

#### 查询某个诊单的查看记录
```php
$records = DiagnosisViewRecord::where('diagnosis_id', $diagnosisId)
    ->with(['user', 'shareUser'])
    ->select();
```

#### 查询某个用户的查看记录
```php
$records = DiagnosisViewRecord::where('user_id', $userId)
    ->with(['diagnosis'])
    ->select();
```

#### 统计诊单查看次数
```php
$viewCount = DiagnosisViewRecord::where('diagnosis_id', $diagnosisId)
    ->sum('view_count');
```

#### 统计确认率
```php
$total = DiagnosisViewRecord::where('diagnosis_id', $diagnosisId)->count();
$confirmed = DiagnosisViewRecord::where('diagnosis_id', $diagnosisId)
    ->where('is_confirmed', 1)
    ->count();
$rate = $total > 0 ? ($confirmed / $total * 100) : 0;
```

## 注意事项

1. **用户ID获取**: 需要在小程序中实现用户登录，获取当前用户ID
2. **匿名访问**: 如果允许匿名访问，user_id可以为0
3. **数据清理**: 建议定期清理过期的查看记录
4. **性能优化**: 查看记录表可能增长较快，注意添加索引
5. **隐私保护**: 查看记录涉及用户行为，注意数据安全

## TODO

- [ ] 在小程序中实现用户登录功能
- [ ] 在 `parsePageParams` 中添加获取用户ID的逻辑
- [ ] 添加查看记录的管理界面
- [ ] 添加数据统计报表
- [ ] 实现查看记录的导出功能