# 处方管理功能说明

## 功能概述

医生处方管理功能，支持创建、编辑、查看和删除处方，并支持处方共享功能。

## 主要功能

### 1. 处方列表
- 查看所有处方（包括自己创建的和共享的）
- 按处方名称、患者姓名搜索
- 按是否共享筛选
- 显示处方基本信息：编号、名称、患者信息、药材数量、剂数、共享状态等

### 2. 新增处方
- 处方名称：必填，用于标识处方
- 患者信息：姓名、性别、年龄
- 处方日期：默认当天
- 临床诊断：必填，描述病情
- 药材配方：
  - 支持添加多味药材
  - 每味药材包含：名称、剂量（克）
  - 可动态增删药材
- 剂数和单位：默认7剂，支持多种单位（剂、丸、袋、盒等）
- 服用天数：默认7天，可自定义
- 用法说明：默认"水煎服，一日二次"
- 服用说明：详细的服用注意事项，如饭前/饭后服用、忌口等
- 医师姓名：必填
- 是否共享：
  - 不勾选（默认）：仅自己可见
  - 勾选：所有医生都可以查看和使用

### 3. 编辑处方
- 可编辑处方的所有信息
- 权限控制：
  - 创建者可以编辑自己的处方
  - 共享的处方所有人都可以编辑

### 4. 查看处方
- 查看处方的详细信息
- 只读模式，不可编辑

### 5. 删除处方
- 删除不需要的处方
- 需要确认操作

## 共享功能说明

### 共享规则
1. **不共享（默认）**：
   - 只有创建者自己可以看到
   - 其他医生无法查看和使用
   - 适用于个人专用处方

2. **共享**：
   - 所有医生都可以查看
   - 所有医生都可以编辑
   - 适用于常用处方模板、标准处方等

### 使用场景
- **个人处方**：医生为特定患者开具的处方，不需要共享
- **处方模板**：常用的标准处方，可以共享给所有医生使用
- **经验处方**：经过验证的有效处方，共享给团队学习和使用

## 安装步骤

### 1. 执行数据库迁移

**Windows系统：**
```bash
install_prescription_shared.bat
```

**Linux/Mac系统：**
```bash
chmod +x install_prescription_shared.sh
./install_prescription_shared.sh
```

### 2. 访问功能
登录管理后台，进入"消费者管理" -> "处方管理"

## 技术实现

### 前端
- 文件位置：`admin/src/views/consumer/prescription/index.vue`
- 使用 Vue 3 + Element Plus
- 支持表格展示、表单编辑、弹窗操作

### 后端
- 控制器：`server/app/adminapi/controller/tcm/PrescriptionController.php`
- 逻辑层：`server/app/adminapi/logic/tcm/PrescriptionLogic.php`
- 列表类：`server/app/adminapi/lists/tcm/PrescriptionLists.php`
- 验证器：`server/app/adminapi/validate/tcm/PrescriptionValidate.php`
- 模型：`server/app/common/model/tcm/Prescription.php`

### API接口
- `GET /tcm.prescription/lists` - 处方列表
- `POST /tcm.prescription/add` - 添加处方
- `POST /tcm.prescription/edit` - 编辑处方
- `POST /tcm.prescription/delete` - 删除处方
- `GET /tcm.prescription/detail` - 处方详情

### 数据库字段
新增字段：
- `prescription_name` - 处方名称（varchar 100）
- `is_shared` - 是否共享（tinyint 1，0-不共享，1-共享）
- `usage_days` - 服用天数（int 11，默认7天）
- `usage_method` - 服用说明（varchar 200）

## 注意事项

1. 处方名称和临床诊断为必填项
2. 至少需要添加一味药材
3. 药材剂量必须大于0
4. 共享的处方所有人都可以编辑，请谨慎操作
5. 删除操作不可恢复，请确认后再删除

## 后续优化建议

1. 添加处方模板功能，快速创建常用处方
2. 支持处方打印和导出
3. 添加处方审核流程
4. 支持处方版本管理
5. 添加处方使用统计
6. 支持处方收藏功能