# 处方库功能 - 文档索引

## 📚 欢迎使用处方库管理系统

这是一个独立的中药处方模板管理系统，用于创建、管理和分享常用处方配方。

**版本：** v1.0.0  
**状态：** ✅ 已完成并测试通过  
**日期：** 2026-03-22

---

## 🚀 快速开始

### 第一次使用？从这里开始！

1. **[快速开始指南](QUICK_START_PRESCRIPTION_LIBRARY.md)** ⭐ 推荐
   - 5分钟快速上手
   - 创建第一个处方
   - 常用操作说明

2. **[安装检查清单](INSTALLATION_CHECKLIST.md)**
   - 详细的安装步骤
   - 环境检查
   - 问题排查

---

## 📖 完整文档

### 使用文档

| 文档名称 | 说明 | 适合人群 |
|---------|------|---------|
| [完整使用说明](PRESCRIPTION_LIBRARY_README.md) | 详细的功能说明和使用指南 | 所有用户 |
| [功能演示](PRESCRIPTION_LIBRARY_DEMO.md) | 使用场景和示例 | 新用户 |
| [快速开始](QUICK_START_PRESCRIPTION_LIBRARY.md) | 5分钟快速上手 | 新用户 ⭐ |

### 技术文档

| 文档名称 | 说明 | 适合人群 |
|---------|------|---------|
| [开发总结](PRESCRIPTION_LIBRARY_SUMMARY.md) | 技术实现和开发总结 | 开发人员 |
| [文件清单](PRESCRIPTION_LIBRARY_FILES.md) | 所有文件列表和说明 | 开发人员 |
| [交付文档](DELIVERY_PACKAGE.md) | 项目交付信息 | 项目经理 |

### 安装文档

| 文档名称 | 说明 | 适合人群 |
|---------|------|---------|
| [安装检查清单](INSTALLATION_CHECKLIST.md) | 详细的安装步骤和验证 | 运维人员 ⭐ |
| [测试SQL](TEST_PRESCRIPTION_LIBRARY.sql) | 测试数据和查询语句 | 测试人员 |

---

## 🔧 安装文件

### 自动安装脚本

| 文件名 | 平台 | 使用方法 |
|--------|------|---------|
| `install_prescription_library.bat` | Windows | 双击运行 |
| `install_prescription_library.sh` | Linux/Mac | `chmod +x install_prescription_library.sh && ./install_prescription_library.sh` |

### 手动安装

如果自动安装脚本无法运行，请执行：
```sql
server/database/migrations/create_prescription_library.sql
```

---

## 📂 文件结构

### 后端文件（PHP）
```
server/
├── database/migrations/
│   └── create_prescription_library.sql          # 数据库表结构
├── app/common/model/tcm/
│   └── PrescriptionLibrary.php                  # 数据模型
└── app/adminapi/
    ├── controller/tcm/
    │   └── PrescriptionLibraryController.php    # 控制器
    ├── logic/tcm/
    │   └── PrescriptionLibraryLogic.php         # 业务逻辑
    ├── lists/tcm/
    │   └── PrescriptionLibraryLists.php         # 列表逻辑
    └── validate/tcm/
        └── PrescriptionLibraryValidate.php      # 数据验证
```

### 前端文件（Vue）
```
admin/
└── src/
    ├── views/consumer/prescription/
    │   └── list.vue                             # 处方库页面
    └── api/
        └── tcm.ts                               # API接口（已更新）
```

---

## 🎯 核心功能

### ✅ 已实现功能

1. **处方管理**
   - 创建处方（处方名称 + 药材配方）
   - 编辑处方
   - 删除处方
   - 查看处方详情

2. **药材管理**
   - 动态添加药材
   - 设置药材名称和剂量（克）
   - 支持小数剂量（精确到0.1克）

3. **权限控制**
   - 是否公开设置（仅自己可见/所有人可见）
   - 查看权限控制
   - 编辑权限控制
   - 删除权限控制（仅创建者）

4. **搜索筛选**
   - 按处方名称搜索（模糊匹配）
   - 按是否公开筛选
   - 分页显示

### 🔮 未来扩展

1. 处方分类功能
2. 处方标签功能
3. 使用统计功能
4. 导入导出功能
5. 处方评论功能
6. 版本管理功能

---

## 🔌 API接口

### 接口列表

| 接口路径 | 方法 | 说明 |
|---------|------|------|
| `/tcm.prescriptionLibrary/lists` | GET | 获取处方列表 |
| `/tcm.prescriptionLibrary/add` | POST | 添加处方 |
| `/tcm.prescriptionLibrary/edit` | POST | 编辑处方 |
| `/tcm.prescriptionLibrary/delete` | POST | 删除处方 |
| `/tcm.prescriptionLibrary/detail` | GET | 获取处方详情 |

详细说明请参阅：[开发总结](PRESCRIPTION_LIBRARY_SUMMARY.md)

---

## 💡 使用示例

### 示例1：六味地黄丸

```json
{
  "prescription_name": "六味地黄丸",
  "herbs": [
    {"name": "熟地黄", "dosage": 24},
    {"name": "山茱萸", "dosage": 12},
    {"name": "山药", "dosage": 12},
    {"name": "泽泻", "dosage": 9},
    {"name": "牡丹皮", "dosage": 9},
    {"name": "茯苓", "dosage": 9}
  ],
  "is_public": 1
}
```

### 示例2：补中益气汤

```json
{
  "prescription_name": "补中益气汤",
  "herbs": [
    {"name": "黄芪", "dosage": 15},
    {"name": "党参", "dosage": 10},
    {"name": "白术", "dosage": 10},
    {"name": "当归", "dosage": 10},
    {"name": "陈皮", "dosage": 6},
    {"name": "升麻", "dosage": 6},
    {"name": "柴胡", "dosage": 6},
    {"name": "甘草", "dosage": 5}
  ],
  "is_public": 1
}
```

更多示例请参阅：[功能演示](PRESCRIPTION_LIBRARY_DEMO.md)

---

## ❓ 常见问题

### Q1: 如何安装？
A: 运行安装脚本或手动执行SQL文件。详见：[安装检查清单](INSTALLATION_CHECKLIST.md)

### Q2: 如何创建处方？
A: 点击"新增处方"按钮，填写信息后保存。详见：[快速开始](QUICK_START_PRESCRIPTION_LIBRARY.md)

### Q3: 如何分享处方？
A: 创建处方时，将"是否公开"设置为"所有人可见"。

### Q4: 如何删除处方？
A: 只有创建者才能删除处方，点击"删除"按钮即可。

### Q5: 药材剂量可以是小数吗？
A: 可以，支持精确到0.1克，如：3.5克。

更多问题请参阅：[完整使用说明](PRESCRIPTION_LIBRARY_README.md)

---

## 🧪 测试

### 快速测试

1. 执行测试SQL插入测试数据：
   ```bash
   mysql -u用户名 -p密码 数据库名 < TEST_PRESCRIPTION_LIBRARY.sql
   ```

2. 访问处方库页面，查看测试数据

3. 测试各项功能

详细测试步骤请参阅：[安装检查清单](INSTALLATION_CHECKLIST.md)

---

## 📊 技术栈

### 后端
- **框架：** ThinkPHP 6.x
- **语言：** PHP 7.4+
- **数据库：** MySQL 5.7+

### 前端
- **框架：** Vue 3
- **UI库：** Element Plus
- **语言：** TypeScript

---

## 🔐 权限说明

### 查看权限
- ✅ 可以查看自己创建的所有处方
- ✅ 可以查看其他人创建的公开处方
- ❌ 不能查看其他人创建的私有处方

### 编辑权限
- ✅ 可以编辑自己创建的处方
- ✅ 可以编辑其他人创建的公开处方
- ❌ 不能编辑其他人创建的私有处方

### 删除权限
- ✅ 只能删除自己创建的处方
- ❌ 不能删除其他人创建的处方

---

## 📝 更新日志

### v1.0.0 (2026-03-22)
- ✅ 初始版本发布
- ✅ 实现核心功能
- ✅ 完成文档编写
- ✅ 通过测试验收

---

## 🆘 技术支持

### 获取帮助

1. **查看文档**
   - 先查看相关文档
   - 查找常见问题

2. **问题反馈**
   - 提供错误信息截图
   - 提供操作步骤描述
   - 提供浏览器控制台日志

3. **联系支持**
   - 联系技术支持团队

---

## 📄 文档导航

### 按角色查看

#### 👨‍💼 管理员/使用者
1. [快速开始指南](QUICK_START_PRESCRIPTION_LIBRARY.md) ⭐
2. [完整使用说明](PRESCRIPTION_LIBRARY_README.md)
3. [功能演示](PRESCRIPTION_LIBRARY_DEMO.md)

#### 👨‍💻 开发人员
1. [开发总结](PRESCRIPTION_LIBRARY_SUMMARY.md) ⭐
2. [文件清单](PRESCRIPTION_LIBRARY_FILES.md)
3. [交付文档](DELIVERY_PACKAGE.md)

#### 🔧 运维人员
1. [安装检查清单](INSTALLATION_CHECKLIST.md) ⭐
2. [测试SQL](TEST_PRESCRIPTION_LIBRARY.sql)

#### 📋 项目经理
1. [交付文档](DELIVERY_PACKAGE.md) ⭐
2. [开发总结](PRESCRIPTION_LIBRARY_SUMMARY.md)

### 按任务查看

#### 🚀 安装部署
1. [安装检查清单](INSTALLATION_CHECKLIST.md)
2. [快速开始指南](QUICK_START_PRESCRIPTION_LIBRARY.md)

#### 📖 学习使用
1. [快速开始指南](QUICK_START_PRESCRIPTION_LIBRARY.md)
2. [功能演示](PRESCRIPTION_LIBRARY_DEMO.md)
3. [完整使用说明](PRESCRIPTION_LIBRARY_README.md)

#### 🔧 开发维护
1. [开发总结](PRESCRIPTION_LIBRARY_SUMMARY.md)
2. [文件清单](PRESCRIPTION_LIBRARY_FILES.md)

#### 📦 项目交付
1. [交付文档](DELIVERY_PACKAGE.md)
2. [文件清单](PRESCRIPTION_LIBRARY_FILES.md)

---

## ✅ 检查清单

### 安装前
- [ ] 已阅读快速开始指南
- [ ] 已备份数据库
- [ ] 已检查环境要求

### 安装中
- [ ] 已执行安装脚本
- [ ] 已配置菜单权限
- [ ] 已重启服务

### 安装后
- [ ] 已测试基本功能
- [ ] 已创建测试处方
- [ ] 已验证权限控制

---

## 🎉 开始使用

准备好了吗？让我们开始吧！

**推荐路径：**
1. 阅读 [快速开始指南](QUICK_START_PRESCRIPTION_LIBRARY.md)
2. 运行安装脚本
3. 创建第一个处方
4. 探索更多功能

**祝使用愉快！** 🚀

---

**版本：** v1.0.0  
**最后更新：** 2026-03-22  
**状态：** ✅ 已完成