9.0 KiB
9.0 KiB
处方库功能 - 文档索引
📚 欢迎使用处方库管理系统
这是一个独立的中药处方模板管理系统，用于创建、管理和分享常用处方配方。
版本： v1.0.0
状态： ✅ 已完成并测试通过
日期： 2026-03-22
🚀 快速开始
第一次使用？从这里开始！
📖 完整文档
使用文档
| 文档名称 | 说明 | 适合人群 |
|---|---|---|
| 完整使用说明 | 详细的功能说明和使用指南 | 所有用户 |
| 功能演示 | 使用场景和示例 | 新用户 |
| 快速开始 | 5分钟快速上手 | 新用户 ⭐ |
技术文档
| 文档名称 | 说明 | 适合人群 |
|---|---|---|
| 开发总结 | 技术实现和开发总结 | 开发人员 |
| 文件清单 | 所有文件列表和说明 | 开发人员 |
| 交付文档 | 项目交付信息 | 项目经理 |
安装文档
| 文档名称 | 说明 | 适合人群 |
|---|---|---|
| 安装检查清单 | 详细的安装步骤和验证 | 运维人员 ⭐ |
| 测试SQL | 测试数据和查询语句 | 测试人员 |
🔧 安装文件
自动安装脚本
| 文件名 | 平台 | 使用方法 |
|---|---|---|
install_prescription_library.bat |
Windows | 双击运行 |
install_prescription_library.sh |
Linux/Mac | chmod +x install_prescription_library.sh && ./install_prescription_library.sh |
手动安装
如果自动安装脚本无法运行，请执行：
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接口（已更新）
🎯 核心功能
✅ 已实现功能
-
处方管理
- 创建处方（处方名称 + 药材配方）
- 编辑处方
- 删除处方
- 查看处方详情
-
药材管理
- 动态添加药材
- 设置药材名称和剂量（克）
- 支持小数剂量（精确到0.1克）
-
权限控制
- 是否公开设置（仅自己可见/所有人可见）
- 查看权限控制
- 编辑权限控制
- 删除权限控制（仅创建者）
-
搜索筛选
- 按处方名称搜索（模糊匹配）
- 按是否公开筛选
- 分页显示
🔮 未来扩展
- 处方分类功能
- 处方标签功能
- 使用统计功能
- 导入导出功能
- 处方评论功能
- 版本管理功能
🔌 API接口
接口列表
| 接口路径 | 方法 | 说明 |
|---|---|---|
/tcm.prescriptionLibrary/lists |
GET | 获取处方列表 |
/tcm.prescriptionLibrary/add |
POST | 添加处方 |
/tcm.prescriptionLibrary/edit |
POST | 编辑处方 |
/tcm.prescriptionLibrary/delete |
POST | 删除处方 |
/tcm.prescriptionLibrary/detail |
GET | 获取处方详情 |
详细说明请参阅：开发总结
💡 使用示例
示例1：六味地黄丸
{
"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：补中益气汤
{
"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
}
更多示例请参阅：功能演示
❓ 常见问题
Q1: 如何安装？
A: 运行安装脚本或手动执行SQL文件。详见：安装检查清单
Q2: 如何创建处方？
A: 点击"新增处方"按钮，填写信息后保存。详见：快速开始
Q3: 如何分享处方？
A: 创建处方时，将"是否公开"设置为"所有人可见"。
Q4: 如何删除处方？
A: 只有创建者才能删除处方，点击"删除"按钮即可。
Q5: 药材剂量可以是小数吗？
A: 可以，支持精确到0.1克，如：3.5克。
更多问题请参阅：完整使用说明
🧪 测试
快速测试
-
执行测试SQL插入测试数据：
mysql -u用户名 -p密码 数据库名 < TEST_PRESCRIPTION_LIBRARY.sql -
访问处方库页面，查看测试数据
-
测试各项功能
详细测试步骤请参阅：安装检查清单
📊 技术栈
后端
- 框架： ThinkPHP 6.x
- 语言： PHP 7.4+
- 数据库： MySQL 5.7+
前端
- 框架： Vue 3
- UI库： Element Plus
- 语言： TypeScript
🔐 权限说明
查看权限
- ✅ 可以查看自己创建的所有处方
- ✅ 可以查看其他人创建的公开处方
- ❌ 不能查看其他人创建的私有处方
编辑权限
- ✅ 可以编辑自己创建的处方
- ✅ 可以编辑其他人创建的公开处方
- ❌ 不能编辑其他人创建的私有处方
删除权限
- ✅ 只能删除自己创建的处方
- ❌ 不能删除其他人创建的处方
📝 更新日志
v1.0.0 (2026-03-22)
- ✅ 初始版本发布
- ✅ 实现核心功能
- ✅ 完成文档编写
- ✅ 通过测试验收
🆘 技术支持
获取帮助
-
查看文档
- 先查看相关文档
- 查找常见问题
-
问题反馈
- 提供错误信息截图
- 提供操作步骤描述
- 提供浏览器控制台日志
-
联系支持
- 联系技术支持团队
📄 文档导航
按角色查看
👨💼 管理员/使用者
👨💻 开发人员
🔧 运维人员
📋 项目经理
按任务查看
🚀 安装部署
📖 学习使用
🔧 开发维护
📦 项目交付
✅ 检查清单
安装前
- 已阅读快速开始指南
- 已备份数据库
- 已检查环境要求
安装中
- 已执行安装脚本
- 已配置菜单权限
- 已重启服务
安装后
- 已测试基本功能
- 已创建测试处方
- 已验证权限控制
🎉 开始使用
准备好了吗？让我们开始吧！
推荐路径：
- 阅读 快速开始指南
- 运行安装脚本
- 创建第一个处方
- 探索更多功能
祝使用愉快！ 🚀
版本： v1.0.0
最后更新： 2026-03-22
状态： ✅ 已完成