diff --git a/ADD_DOSE_UNIT_TO_ORDER_SUMMARY.md b/ADD_DOSE_UNIT_TO_ORDER_SUMMARY.md new file mode 100644 index 00000000..bd9abfe7 --- /dev/null +++ b/ADD_DOSE_UNIT_TO_ORDER_SUMMARY.md @@ -0,0 +1,75 @@ +# 添加剂量单位和剂数字段到订单编辑表单 + +## 任务概述 +在处方订单编辑表单中添加 `dose_unit`（剂量单位）和 `dose_count`（剂数）字段，支持用户选择和编辑。 + +## 实现内容 + +### 1. 前端表单字段（admin/src/views/consumer/prescription/order_list.vue） + +#### 添加的表单项： +- **剂量单位** (`dose_unit`): 下拉选择框，7个选项 + - 剂、丸、袋、盒、瓶、膏、贴 + - 默认值：剂 + +- **剂数** (`dose_count`): 数字输入框 + - 最小值：1 + - 默认值：1 + +#### 修改位置： +- 表单定义：在 `medication_days` 字段后添加 +- 数据加载：`openEdit()` 函数中加载 `dose_count` 和 `dose_unit` +- 数据提交：`submitEdit()` 函数中包含 `dose_count` 和 `dose_unit` + +### 2. 后端逻辑（server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php） + +#### 修改的方法： +- `edit()` 方法添加字段处理： + ```php + $order->dose_unit = (string) ($params['dose_unit'] ?? '剂'); + $order->dose_count = isset($params['dose_count']) && (int)$params['dose_count'] > 0 ? (int)$params['dose_count'] : 1; + ``` + +### 3. 数据库迁移（add_dose_unit_to_prescription_order.sql） + +#### 添加的字段： +```sql +ALTER TABLE `zyt_tcm_prescription_order` +ADD COLUMN `dose_unit` varchar(20) NOT NULL DEFAULT '剂' COMMENT '剂量单位：剂、丸、袋、盒、瓶、膏、贴' AFTER `medication_days`, +ADD COLUMN `dose_count` int(11) NOT NULL DEFAULT 1 COMMENT '剂数' AFTER `dose_unit`; +``` + +## 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +|--------|------|--------|------| +| dose_unit | varchar(20) | 剂 | 剂量单位：剂、丸、袋、盒、瓶、膏、贴 | +| dose_count | int(11) | 1 | 剂数，最小值为1 | + +## 部署步骤 + +1. **执行数据库迁移**： + ```bash + mysql -u用户名 -p数据库名 < add_dose_unit_to_prescription_order.sql + ``` + +2. **部署后端代码**： + - 更新 `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` + +3. **部署前端代码**： + - 更新 `admin/src/views/consumer/prescription/order_list.vue` + - 重新构建前端：`npm run build` + +## 测试要点 + +- [ ] 创建新订单时，`dose_unit` 默认为"剂"，`dose_count` 默认为1 +- [ ] 编辑订单时，能正确加载已保存的 `dose_unit` 和 `dose_count` 值 +- [ ] 修改 `dose_unit` 和 `dose_count` 后能正确保存 +- [ ] 验证 `dose_count` 不能小于1 +- [ ] 验证所有7个剂量单位选项都能正常选择和保存 + +## 相关文件 + +- `admin/src/views/consumer/prescription/order_list.vue` - 前端订单列表和编辑表单 +- `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` - 后端订单编辑逻辑 +- `add_dose_unit_to_prescription_order.sql` - 数据库迁移脚本 diff --git a/CHECK_DOSAGE_FIELDS.md b/CHECK_DOSAGE_FIELDS.md new file mode 100644 index 00000000..dd4e10c8 --- /dev/null +++ b/CHECK_DOSAGE_FIELDS.md @@ -0,0 +1,91 @@ +# 检查处方用量字段是否已添加到数据库 + +## 问题描述 +处方的用量相关字段（`dosage_amount`、`dosage_unit`、`need_decoction`）没有保存到数据库。 + +## 检查步骤 + +### 1. 检查数据库表结构 + +执行以下SQL查询，检查字段是否存在： + +```sql +SELECT COLUMN_NAME, DATA_TYPE, COLUMN_DEFAULT, COLUMN_COMMENT +FROM information_schema.COLUMNS +WHERE TABLE_SCHEMA = DATABASE() + AND TABLE_NAME = 'zyt_tcm_prescription' + AND COLUMN_NAME IN ('dosage_amount', 'dosage_unit', 'need_decoction') +ORDER BY ORDINAL_POSITION; +``` + +### 2. 如果字段不存在，执行迁移 + +如果上述查询返回空结果，说明字段还未添加，需要执行迁移文件： + +```bash +mysql -u用户名 -p数据库名 < add_prescription_dosage_fields.sql +``` + +或者直接在数据库中执行： + +```sql +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值' AFTER `prescription_type`, +ADD COLUMN `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)' AFTER `dosage_amount`, +ADD COLUMN `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)' AFTER `dosage_unit`; +``` + +### 3. 验证字段已添加 + +再次执行步骤1的查询，应该看到3个字段： + +| COLUMN_NAME | DATA_TYPE | COLUMN_DEFAULT | COLUMN_COMMENT | +|-------------|-----------|----------------|----------------| +| dosage_amount | decimal | NULL | 用量数值 | +| dosage_unit | varchar | '' | 用量单位(g/ml) | +| need_decoction | tinyint | 0 | 是否代煎(0否1是,仅饮片) | + +## 代码检查 + +### 前端代码 ✅ +- `admin/src/components/tcm-prescription/index.vue` 已正确实现 +- 包含 `dosage_amount`、`dosage_unit`、`need_decoction` 字段 +- 有 `watch` 监听处方类型变化，自动设置单位 + +### 后端代码 ✅ +- `server/app/adminapi/logic/tcm/PrescriptionLogic.php` 的 `add()` 方法已包含这些字段 +- `server/app/adminapi/logic/tcm/PrescriptionLogic.php` 的 `edit()` 方法已包含这些字段 + +### 数据库模型 ✅ +- `server/app/common/model/tcm/Prescription.php` 已配置类型转换： + ```php + protected $type = [ + 'dosage_amount' => 'float', + 'need_decoction' => 'integer', + ]; + ``` + +## 结论 + +代码层面一切正常，问题很可能是**数据库迁移未执行**。 + +请执行上述步骤1检查数据库表结构，如果字段不存在，执行步骤2的迁移SQL。 + +## 测试步骤 + +迁移完成后，测试以下场景： + +1. **创建新处方** + - 选择"浓缩水丸"，用量应为 1-10g 下拉选择 + - 选择"饮片"，用量应为 50-250ml 下拉选择，并显示代煎选项 + - 选择其他类型，用量应为自由输入 + - 保存后检查数据库，确认字段已保存 + +2. **编辑已有处方** + - 打开已有处方 + - 修改用量和代煎选项 + - 保存后检查数据库，确认字段已更新 + +3. **查看处方详情** + - 在订单详情中查看处方 + - 确认用量和代煎信息正确显示 diff --git a/GANCAO_API_FIX.md b/GANCAO_API_FIX.md new file mode 100644 index 00000000..1650eaac --- /dev/null +++ b/GANCAO_API_FIX.md @@ -0,0 +1,161 @@ +# 甘草 API "Array to string conversion" 错误修复 + +## 问题描述 + +调用甘草处方下单接口时出现错误： +```json +{"code":2,"message":"Array to string conversion"} +``` + +## 根本原因 + +经过分析代码和 API 文档，发现以下几个问题： + +### 1. 变量作用域问题 +在 `PrescriptionOrderLogic::submitGancaoRecipel()` 方法中，`$appNo` 变量在返回语句中被引用，但实际定义在更早的位置（line 1638），然后又在 line 1658 被重新赋值。这可能导致变量引用错误。 + +### 2. 空字符串处理问题 +`buildSubmitPayload()` 方法中的 `cradle_store` 字段可能为空字符串，而甘草 API 可能不接受空字符串。 + +### 3. 患者年龄格式问题 +原代码使用 `sprintf('%d.00', $ageInt)` 格式化年龄，但 API 可能期望简单的整数字符串。 + +### 4. doct_advice 字段处理 +`doct_advice` 数组中的某些字段可能包含空字符串或未正确处理的值，导致 JSON 编码时出现问题。 + +## 修复内容 + +### 1. 修复 `GancaoScmRecipelService.php` + +#### 修改患者年龄格式 +```php +// 修改前 +$patientAge = sprintf('%d.00', $ageInt); + +// 修改后 +$patientAge = (string) $ageInt; +``` + +#### 确保 cradle_store 不为空 +```php +$preview['cradle_store'] = mb_substr(trim((string) ($c['cradle_store'] ?? '')), 0, 32); +if ($preview['cradle_store'] === '') { + $preview['cradle_store'] = 'default'; +} +``` + +#### 优化 doct_advice 字段处理 +```php +// 确保所有字段都是字符串，避免数组到字符串的转换错误 +$tabooStr = $taboo !== '' ? $taboo : '无'; +$usageTimeStr = $usageTime; +$usageBriefStr = $usageBrief !== '' ? $usageBrief : '遵医嘱'; +$othersStr = trim((string) ($rx['usage_notes'] ?? '')); +$notesDoctorStr = trim((string) ($order['remark_extra'] ?? '')); + +$preview['doct_advice'] = [ + 'taboo' => $tabooStr, + 'usage_time' => $usageTimeStr, + 'usage_brief' => $usageBriefStr, + 'others' => $othersStr !== '' ? $othersStr : '', + 'notes_doctor' => $notesDoctorStr !== '' ? $notesDoctorStr : '', +]; +``` + +#### 添加调试日志 +```php +public static function ctmSubmit(array $submitPayload): array +{ + $transport = self::transport(); + + // 记录请求负载以便调试 + Log::info('Gancao CTM_SUBMIT_RECIPEL payload', ['payload' => $submitPayload]); + + return $transport->post($submitPayload); +} +``` + +### 2. 修复 `PrescriptionOrderLogic.php` + +#### 修复变量引用问题 +```php +// 在返回语句中使用正确的变量引用 +$fee = $subBody['result']['fee'] ?? []; +$appNo = $submitPayload['app_order_no'] ?? ('PO' . (string) $order->id); + +return [ + 'recipel_order_no' => $gcNo, + 'app_order_no' => $appNo, + 'fee' => is_array($fee) ? $fee : [], +]; +``` + +#### 添加详细错误日志 +```php +use think\facade\Log; + +// 在 submitGancaoRecipel 方法中添加错误日志 +$subRet = GancaoScmRecipelService::ctmSubmit($submitPayload); +if ((int) ($subRet['state'] ?? 0) !== 1) { + $errMsg = (string) ($subRet['msg'] ?? ''); + $response = isset($subRet['response']) ? mb_substr((string) $subRet['response'], 0, 500) : ''; + self::$error = '甘草下单通信失败：' . $errMsg . ($response !== '' ? '；响应：' . $response : ''); + Log::error('Gancao CTM_SUBMIT failed', ['subRet' => $subRet, 'payload' => $submitPayload]); + + return false; +} +$subBody = $subRet['body'] ?? []; +if (!GancaoScmRecipelService::isApiSuccess($subBody)) { + self::$error = '甘草下单失败：' . GancaoScmRecipelService::apiStatusMessage($subBody); + Log::error('Gancao CTM_SUBMIT api error', ['body' => $subBody, 'payload' => $submitPayload]); + + return false; +} +``` + +## 测试建议 + +1. **检查日志文件**：修复后再次调用接口，查看 `runtime/log/` 目录下的日志文件，查找 `Gancao CTM_SUBMIT_RECIPEL payload` 日志，确认发送的数据格式是否正确。 + +2. **验证必填字段**：根据甘草 API 文档，确保以下字段都有有效值： + - `token`：有效的 API token + - `df_id`：剂型 ID（如 101 表示饮片） + - `amount`：剂量数量 + - `m_list`：药材列表（每个药材必须有 `id`、`quantity`、`brief` 字段） + - `express_to`：收货地址信息 + - `patient`：患者信息 + - `doctor`：医生信息 + - `callback_url`：回调地址（必须是 HTTPS） + +3. **检查配置**：确认 `.env` 文件中的甘草配置完整： + ```env + GANCAO_SCM_ENABLED=true + GANCAO_SCM_GATEWAY_URL=https://xxx + GANCAO_SCM_GATEWAY_AK=xxx + GANCAO_SCM_GATEWAY_SK=xxx + GANCAO_SCM_BIZ_AK=xxx + GANCAO_SCM_BIZ_SK=xxx + GANCAO_SCM_CALLBACK_URL=https://xxx + GANCAO_SCM_CRADLE_STORE=xxx + GANCAO_SCM_EXPRESS_TYPE=sf + ``` + +4. **测试流程**： + - 创建一个测试处方订单 + - 确保处方审核通过 + - 调用 `submitGancaoRecipel` 接口 + - 查看返回结果和日志 + +## 可能的其他原因 + +如果修复后仍然出现错误，可能是以下原因： + +1. **药材 ID 映射问题**：某些药材的甘草 ID（`gid`）未正确配置 +2. **剂型参数问题**：`df101ext` 等剂型扩展参数不符合 API 要求 +3. **地址解析问题**：收货地址无法正确解析为省市区 +4. **电话号码格式**：电话号码不是 11 位数字 + +## 参考文档 + +- 甘草 API 文档：https://apidoc.igancao.com/service-doc/scm-outer-recipel.html +- 特别关注「中药处方下单」和「中药处方下单参数预检查」章节 diff --git a/GANCAO_ARRAY_TO_STRING_FIX.md b/GANCAO_ARRAY_TO_STRING_FIX.md new file mode 100644 index 00000000..7d47d0fe --- /dev/null +++ b/GANCAO_ARRAY_TO_STRING_FIX.md @@ -0,0 +1,278 @@ +# 甘草 API "Array to string conversion" 错误完整解决方案 + +## 问题现象 + +调用甘草处方下单接口时返回： +```json +{"code":2,"message":"Array to string conversion"} +``` + +## 根本原因分析 + +"Array to string conversion" 错误通常发生在以下情况： + +1. **配置文件中的值被错误地解析为数组** + - 例如：`.env` 中 `GANCAO_SCM_EXPRESS_TYPE=["sf"]` 会被解析为数组 + - 正确应该是：`GANCAO_SCM_EXPRESS_TYPE=sf` + +2. **PHP 尝试将数组转换为字符串** + - 在字符串拼接、JSON 编码或其他操作中 + +3. **配置读取问题** + - ThinkPHP 的配置解析可能将某些值错误地转换为数组 + +## 完整修复步骤 + +### 步骤 1: 检查配置文件 + +运行配置检查脚本： + +```bash +cd /path/to/your/project +php test_gancao_config.php +``` + +这个脚本会检查： +- 所有必需的配置项是否存在 +- 配置值的类型是否正确 +- 是否有数组值被错误地用作字符串 + +### 步骤 2: 修复 .env 配置 + +确保 `.env` 文件中的甘草配置格式正确： + +```env +# 甘草配置必须写在文件顶部，或者使用 [GANCAO_SCM] 分区 +# 不要写在 [trtc] 等其他分区内 + +GANCAO_SCM_ENABLED=true +GANCAO_SCM_GATEWAY_URL=https://your-gateway-url.com +GANCAO_SCM_GATEWAY_AK=your_gateway_ak +GANCAO_SCM_GATEWAY_SK=your_gateway_sk_16chars +GANCAO_SCM_BIZ_AK=your_biz_ak +GANCAO_SCM_BIZ_SK=your_biz_sk +GANCAO_SCM_CALLBACK_URL=https://your-domain.com/api/gancao/callback +GANCAO_SCM_EXPRESS_TYPE=sf +GANCAO_SCM_CRADLE_STORE=your_store_name +GANCAO_SCM_DF_ID=101 + +# 可选配置 +GANCAO_SCM_DEFAULT_IS_DECOCT=1 +GANCAO_SCM_DEFAULT_TIMES_PER_DAY=2 +GANCAO_SCM_DEFAULT_NUM_PER_PACK=2 +GANCAO_SCM_DEFAULT_DOSE_ML=150 +``` + +**重要注意事项：** + +1. ❌ **错误示例**（会导致数组转字符串错误）： + ```env + GANCAO_SCM_EXPRESS_TYPE=["sf"] + GANCAO_SCM_CALLBACK_URL=["https://..."] + ``` + +2. ✅ **正确示例**： + ```env + GANCAO_SCM_EXPRESS_TYPE=sf + GANCAO_SCM_CALLBACK_URL=https://... + ``` + +3. 不要在值周围加引号（除非值本身包含空格） +4. 不要使用 JSON 格式 +5. 不要使用数组语法 `[]` + +### 步骤 3: 检查配置文件 + +如果使用了 `config/gancao_scm.php` 配置文件，确保格式正确： + +```php + env('gancao_scm.enabled', false), + 'gateway_url' => env('gancao_scm.gateway_url', ''), + 'gateway_ak' => env('gancao_scm.gateway_ak', ''), + 'gateway_sk' => env('gancao_scm.gateway_sk', ''), + 'biz_ak' => env('gancao_scm.biz_ak', ''), + 'biz_sk' => env('gancao_scm.biz_sk', ''), + 'callback_url' => env('gancao_scm.callback_url', ''), + 'express_type' => env('gancao_scm.express_type', 'sf'), // 确保是字符串 + 'cradle_store' => env('gancao_scm.cradle_store', ''), + 'df_id' => (int)env('gancao_scm.df_id', 101), + + // 可选配置 + 'default_is_decoct' => (int)env('gancao_scm.default_is_decoct', 1), + 'default_times_per_day' => (int)env('gancao_scm.default_times_per_day', 2), + 'default_num_per_pack' => (int)env('gancao_scm.default_num_per_pack', 2), + 'default_dose_ml' => (int)env('gancao_scm.default_dose_ml', 150), + + // 药材 ID 映射（这个可以是数组） + 'herb_id_map' => [ + // '药材名' => 甘草ID + ], +]; +``` + +### 步骤 4: 清除缓存 + +```bash +# 清除 ThinkPHP 缓存 +cd server +php think clear + +# 或者手动删除缓存目录 +rm -rf runtime/cache/* +rm -rf runtime/temp/* +``` + +### 步骤 5: 重启服务 + +```bash +# 如果使用 PHP-FPM +sudo systemctl restart php-fpm + +# 如果使用 Nginx +sudo systemctl restart nginx + +# 如果使用 Apache +sudo systemctl restart apache2 +``` + +### 步骤 6: 查看日志 + +修复后再次调用接口，查看日志文件： + +```bash +tail -f server/runtime/log/$(date +%Y%m%d).log +``` + +日志会显示： +- `Gancao CTM_SUBMIT_RECIPEL payload` - 发送的完整负载 +- `Gancao CTM_SUBMIT failed` - 如果通信失败 +- `Gancao CTM_SUBMIT api error` - 如果 API 返回错误 +- `submitGancaoRecipel exception` - 如果发生异常 + +## 代码修复说明 + +已修复的文件： + +### 1. `GancaoScmRecipelService.php` + +- ✅ 修复 `express_type` 可能是数组的问题 +- ✅ 修复 `callback_url` 可能是数组的问题 +- ✅ 修复患者年龄格式 +- ✅ 优化 `doct_advice` 字段处理 +- ✅ 添加调试日志 + +### 2. `PrescriptionOrderLogic.php` + +- ✅ 修复 `$appNo` 变量引用问题 +- ✅ 添加详细错误日志 +- ✅ 添加异常捕获 + +### 3. `PrescriptionOrderController.php` + +- ✅ 添加 try-catch 异常处理 +- ✅ 添加返回值类型检查 +- ✅ 添加详细日志记录 + +## 测试步骤 + +1. **运行配置检查**： + ```bash + php test_gancao_config.php + ``` + +2. **检查输出**： + - 所有配置项应该显示 ✓ + - 不应该有 ❌ 或 ⚠️ 标记 + - JSON 编码应该成功 + +3. **调用接口**： + ```bash + curl -X POST https://your-domain.com/api/tcm.prescriptionOrder/submitGancaoRecipel \ + -H "Content-Type: application/json" \ + -H "token: your_token" \ + -d '{"id": 123}' + ``` + +4. **查看日志**： + ```bash + tail -f server/runtime/log/$(date +%Y%m%d).log | grep -i gancao + ``` + +## 常见错误和解决方案 + +### 错误 1: "Array to string conversion" + +**原因**：配置值是数组而不是字符串 + +**解决**： +1. 运行 `php test_gancao_config.php` 找出哪个配置是数组 +2. 修改 `.env` 文件，移除 `[]` 和引号 +3. 清除缓存并重启服务 + +### 错误 2: "callback_url is invalid" + +**原因**：回调地址未配置或格式错误 + +**解决**： +1. 确保 `GANCAO_SCM_CALLBACK_URL` 配置正确 +2. 必须是 HTTPS 地址 +3. 格式：`https://your-domain.com/api/gancao/callback` + +### 错误 3: "express_type is invalid" + +**原因**：快递类型配置错误 + +**解决**： +1. 检查 `GANCAO_SCM_EXPRESS_TYPE` 配置 +2. 有效值：`sf`（顺丰）、`jd`（京东）、`jt`（极兔）、`auto`（自动） +3. 默认使用 `sf` + +### 错误 4: JSON 编码失败 + +**原因**：数据中包含无法编码的内容 + +**解决**： +1. 检查处方数据中是否有特殊字符 +2. 检查药材名称是否包含非 UTF-8 字符 +3. 查看日志中的完整错误信息 + +## 验证修复 + +修复成功的标志： + +1. ✅ 配置检查脚本全部通过 +2. ✅ 接口返回成功： + ```json + { + "code": 1, + "msg": "甘草药方上传成功", + "data": { + "recipel_order_no": "GC202604...", + "app_order_no": "PO123", + "fee": { + "total": 150.00, + "medicine": 120.00, + "process": 20.00, + "express": 10.00 + } + } + } + ``` +3. ✅ 日志中显示 `submitGancaoRecipel success` +4. ✅ 数据库中 `gancao_reciperl_order_no` 字段已更新 + +## 需要帮助？ + +如果以上步骤都无法解决问题，请提供： + +1. 配置检查脚本的完整输出 +2. 错误日志的完整内容（`runtime/log/*.log`） +3. 接口返回的完整响应 +4. `.env` 文件中的甘草配置部分（隐藏敏感信息） + +## 参考文档 + +- 甘草 API 文档：https://apidoc.igancao.com/service-doc/scm-outer-recipel.html +- ThinkPHP 配置文档：https://www.kancloud.cn/manual/thinkphp6_0/1037488 diff --git a/GANCAO_CALLBACK_SETUP.md b/GANCAO_CALLBACK_SETUP.md new file mode 100644 index 00000000..a81db000 --- /dev/null +++ b/GANCAO_CALLBACK_SETUP.md @@ -0,0 +1,355 @@ +# 甘草订单状态回调功能配置指南 + +## 功能说明 + +实现甘草订单状态回调功能，当甘草订单状态发生变化时（如审核通过、制作中、发货、完成等），甘草系统会主动回调我们的接口，更新订单状态。 + +## 已创建的文件 + +### 1. 回调控制器 +**文件：** `server/app/api/controller/GancaoCallbackController.php` + +**功能：** +- 接收甘草订单状态回调 +- 验证回调签名（防止伪造） +- 更新订单状态 +- 记录回调日志 + +**支持的订单状态：** +- `10` - 系统审核中 +- `11` - 系统审核通过 +- `110` - 订单药房流转制作中（包含：派单、审方、调配、复核、浸泡、煎药、包装、发货等流程） +- `20` - 物流中 +- `30` - 完成（终态） +- `90` - 拦截（终止流转:可恢复） +- `91` - 主动撤单（退费：终态） +- `92` - 驳回（无法制作并退费：终态） + +### 2. 数据库迁移文件 +**文件：** `add_gancao_callback_fields.sql` + +**新增字段：** +- `gancao_order_state` - 甘草订单状态 +- `gancao_flow_name` - 订单流程名称 +- `gancao_supplier` - 供应商/药房名称 +- `gancao_remark` - 订单备注 + +## 配置步骤 + +### 步骤 1: 执行数据库迁移 + +```bash +# 连接到数据库 +mysql -u root -p your_database + +# 执行 SQL 文件 +source /path/to/add_gancao_callback_fields.sql; + +# 或者直接执行 +mysql -u root -p your_database < add_gancao_callback_fields.sql +``` + +### 步骤 2: 添加路由 + +在 `server/route/api.php` 文件中添加回调路由： + +```php + (string) zyt_gancao_scm_env('CALLBACK_URL', ''), + + // 回调签名验证（如果甘草提供了独立的密钥） + 'callback_appkey' => (string) zyt_gancao_scm_env('CALLBACK_APPKEY', ''), + 'callback_secret_key' => (string) zyt_gancao_scm_env('CALLBACK_SECRET_KEY', ''), +]; +``` + +### 步骤 5: 测试回调接口 + +#### 方法 A：使用 curl 测试 + +```bash +# 模拟甘草回调请求 +curl -X POST https://your-domain.com/api/gancao/callback/order-status \ + -H "Content-Type: application/json" \ + -H "access-appkey: your_appkey" \ + -H "access-nonce: test1234" \ + -H "access-timestamp: $(date +%s)" \ + -H "access-sign: calculated_sign" \ + -d '{ + "recipel_order_no": "GC202604...", + "state": 11, + "ext": { + "flow_name": "审核通过" + } + }' +``` + +#### 方法 B：查看日志 + +```bash +# 查看回调日志 +tail -f server/runtime/log/$(date +%Y%m%d).log | grep -i "gancao callback" +``` + +### 步骤 6: 向甘草提供回调地址 + +联系甘草技术支持，提供以下信息： +1. 回调地址：`https://your-domain.com/api/gancao/callback/order-status` +2. 确认回调签名验证方式 +3. 测试回调是否正常 + +## 回调数据格式 + +### 请求头 + +``` +access-appkey: ak-xxxxx +access-nonce: random_string +access-timestamp: 1234567890 +access-sign: md5_hash +``` + +### 请求体 + +```json +{ + "recipel_order_no": "GC202604...", + "state": 110, + "ext": { + "flow_name": "煎药开始", + "supplier": "XX药房" + } +} +``` + +### 状态 110（制作中）的扩展信息 + +```json +{ + "recipel_order_no": "GC202604...", + "state": 110, + "ext": { + "flow_name": "派单|审方|调配|复核|浸泡|煎药开始|包装|发货|寄出", + "supplier": "XX药房" + } +} +``` + +### 状态 20（物流中）的扩展信息 + +```json +{ + "recipel_order_no": "GC202604...", + "state": 20, + "ext": { + "shipping_name": "顺丰速运", + "nu": "SF1234567890", + "supplier": "XX药房" + } +} +``` + +## 签名验证 + +### 签名算法 + +``` +access_sign = md5(access-appkey + secret-key + access-nonce + access-timestamp + request_body) +``` + +### 示例 + +``` +access-appkey: ak-36b05d5034f13a86b102c97e72f14 +secret-key: f8c1f3c58b55a61a4d41242016d314ea +access-nonce: 1jd4u8ii +access-timestamp: 1723014934 +Body: {"recipel_order_no":"1234","state":10,"ext":{"flow_name":"浸泡开始"}} + +计算： +md5("ak-36b05d5034f13a86b102c97e72f14" + "f8c1f3c58b55a61a4d41242016d314ea" + "1jd4u8ii" + "1723014934" + '{"recipel_order_no":"1234","state":10,"ext":{"flow_name":"浸泡开始"}}') += 03b46e3b385d1dceb183cad08e44f31f +``` + +## 订单状态映射 + +### 甘草状态 → 系统履约状态 + +| 甘草状态 | 状态名称 | 系统履约状态 | 说明 | +|---------|---------|-------------|------| +| 10 | 系统审核中 | 保持不变 | 甘草内部审核 | +| 11 | 系统审核通过 | 保持不变 | 审核通过，准备制作 | +| 110 | 订单药房流转制作中 | 2（履约中） | 药房制作流程 | +| 110（发货） | 发货/寄出 | 5（已发货） | 药房已发货 | +| 20 | 物流中 | 5（已发货） | 快递运输中 | +| 30 | 完成 | 3（已完成） | 订单完成 | +| 90 | 拦截 | 保持不变 | 订单被拦截 | +| 91 | 主动撤单 | 4（已取消） | 撤单并退费 | +| 92 | 驳回 | 4（已取消） | 无法制作并退费 | + +## 日志记录 + +### 回调接收日志 + +``` +[info] Gancao callback received: { + "headers": {...}, + "body": {...} +} +``` + +### 回调处理日志 + +``` +[info] Gancao callback processed: { + "order_id": 123, + "recipel_order_no": "GC202604...", + "state": 110, + "ext": {...} +} +``` + +### 订单日志 + +在 `zyt_prescription_order_log` 表中记录： +- `admin_name`: "甘草系统" +- `action`: "gancao_callback" +- `summary`: "甘草订单状态更新：系统审核通过" + +## 错误处理 + +### 签名验证失败 + +``` +[warning] Gancao callback sign verification failed +``` + +**处理：** 返回 "ok"，避免甘草重试 + +### 订单不存在 + +``` +[warning] Gancao callback order not found +``` + +**处理：** 返回 "ok"，记录日志 + +### 更新失败 + +``` +[error] Gancao callback update order failed +``` + +**处理：** 返回 "ok"，记录错误日志 + +## 重试机制 + +甘草的重试策略： +- 如果回调失败（未返回 "ok" 或超时），会进行重试 +- 最多重试 10 次 +- 重试间隔：失败次数 × 5 分钟 + +**建议：** +1. 接口必须在 5 秒内返回 "ok" +2. 使用异步处理复杂逻辑 +3. 即使处理失败也返回 "ok"，避免重复回调 + +## 安全建议 + +1. **启用签名验证**：防止伪造回调 +2. **记录所有回调**：便于排查问题 +3. **限制访问频率**：防止恶意请求 +4. **使用 HTTPS**：保护数据传输安全 +5. **IP 白名单**：只允许甘草服务器 IP 访问（可选） + +## 监控和告警 + +### 监控指标 + +1. 回调接收数量 +2. 签名验证失败次数 +3. 订单更新失败次数 +4. 回调处理耗时 + +### 告警规则 + +1. 签名验证失败率 > 10% +2. 订单更新失败率 > 5% +3. 回调处理耗时 > 3 秒 + +## 测试清单 + +- [ ] 数据库字段已添加 +- [ ] 路由已配置 +- [ ] 回调 URL 已配置 +- [ ] 签名验证正常 +- [ ] 订单状态更新正常 +- [ ] 日志记录正常 +- [ ] 错误处理正常 +- [ ] 已向甘草提供回调地址 +- [ ] 已测试真实回调 + +## 故障排查 + +### 问题 1：收不到回调 + +**检查：** +1. 回调 URL 是否正确 +2. 服务器是否能从公网访问 +3. 防火墙是否开放端口 +4. 路由是否配置正确 + +### 问题 2：签名验证失败 + +**检查：** +1. appkey 是否正确 +2. secret-key 是否正确 +3. 签名算法是否正确 +4. 请求体是否被修改 + +### 问题 3：订单状态未更新 + +**检查：** +1. 订单是否存在 +2. 数据库字段是否添加 +3. 更新逻辑是否正确 +4. 查看错误日志 + +## 相关文档 + +- 甘草 API 文档：https://apidoc.igancao.com/service-doc/scm-outer-recipel.html#订单状态回调 +- ThinkPHP 路由文档：https://www.kancloud.cn/manual/thinkphp6_0/1037493 diff --git a/GANCAO_FINAL_FIX.md b/GANCAO_FINAL_FIX.md new file mode 100644 index 00000000..5097c9b7 --- /dev/null +++ b/GANCAO_FINAL_FIX.md @@ -0,0 +1,318 @@ +# 甘草 API "Array to string conversion" 最终修复 + +## 问题根源 + +错误发生在 `GancaoScmRecipelService::getToken()` 方法中： + +```php +// 第 126 行 +if ($code === '10103' || str_contains($apiMsg, '10103')) { +``` + +**原因：** 当甘草 API 返回错误时，`$body['status']['msg']` 可能是**数组**而不是字符串，导致： +1. `apiStatusMessage()` 方法尝试将数组转换为字符串 +2. `str_contains()` 函数接收到数组参数，触发 "Array to string conversion" 错误 + +## 已修复的问题 + +### 1. `apiStatusMessage()` 方法 + +**修复前：** +```php +$msg = (string) ($body['status']['msg'] ?? ''); +``` + +**修复后：** +```php +$msg = $body['status']['msg'] ?? ''; + +// 确保 msg 是字符串 +if (is_array($msg)) { + $msg = json_encode($msg, JSON_UNESCAPED_UNICODE); +} else { + $msg = (string) $msg; +} +``` + +### 2. `getToken()` 方法中的 `str_contains()` 调用 + +**修复前：** +```php +if ($code === '10103' || str_contains($apiMsg, '10103')) { +``` + +**修复后：** +```php +// 确保 $apiMsg 是字符串，避免 Array to string conversion 错误 +$apiMsgStr = is_string($apiMsg) ? $apiMsg : json_encode($apiMsg, JSON_UNESCAPED_UNICODE); + +if ($code === '10103' || str_contains($apiMsgStr, '10103')) { +``` + +### 3. 其他已修复的问题 + +#### SSL 连接问题（`GancaoOpenApiTransport.php`） +- ✅ 改用 HTTP/1.1 +- ✅ 强制使用 TLS 1.2 +- ✅ 降低 OpenSSL 安全级别 +- ✅ 增加连接超时 +- ✅ 添加 TCP keepalive + +#### 配置类型问题（`GancaoScmRecipelService.php`） +- ✅ 确保 `express_type` 是字符串 +- ✅ 确保 `callback_url` 是字符串 +- ✅ 修复患者年龄格式 +- ✅ 优化 `doct_advice` 字段处理 + +#### 错误处理（`PrescriptionOrderLogic.php` 和 `PrescriptionOrderController.php`） +- ✅ 添加详细错误日志 +- ✅ 添加异常捕获 +- ✅ 添加返回值类型检查 + +## 完整的修复文件列表 + +1. ✅ `server/app/common/service/gancao/GancaoScmRecipelService.php` +2. ✅ `server/app/common/service/gancao/GancaoOpenApiTransport.php` +3. ✅ `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` +4. ✅ `server/app/adminapi/controller/tcm/PrescriptionOrderController.php` + +## 部署步骤 + +### 步骤 1: 上传所有修复文件 + +```bash +# 上传修复后的文件 +scp server/app/common/service/gancao/GancaoScmRecipelService.php user@server:/path/to/server/app/common/service/gancao/ +scp server/app/common/service/gancao/GancaoOpenApiTransport.php user@server:/path/to/server/app/common/service/gancao/ +scp server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php user@server:/path/to/server/app/adminapi/logic/tcm/ +scp server/app/adminapi/controller/tcm/PrescriptionOrderController.php user@server:/path/to/server/app/adminapi/controller/tcm/ + +# 上传测试脚本 +scp test_gancao_config.php user@server:/path/to/ +scp test_gancao_ssl.php user@server:/path/to/ +scp diagnose_gancao_payload.php user@server:/path/to/ +``` + +### 步骤 2: 验证文件已上传 + +```bash +ssh user@server +cd /path/to/your/project + +# 检查文件修改时间 +ls -la server/app/common/service/gancao/GancaoScmRecipelService.php +ls -la server/app/common/service/gancao/GancaoOpenApiTransport.php +ls -la server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php +ls -la server/app/adminapi/controller/tcm/PrescriptionOrderController.php +``` + +### 步骤 3: 运行配置检查 + +```bash +php test_gancao_config.php +``` + +**期望输出：** 所有配置项显示 ✓ + +### 步骤 4: 运行 SSL 测试 + +```bash +php test_gancao_ssl.php +``` + +**期望输出：** 至少一种 SSL 配置测试成功，并且能成功获取 token + +### 步骤 5: 清除缓存 + +```bash +cd server +php think clear +rm -rf runtime/cache/* +rm -rf runtime/temp/* +``` + +### 步骤 6: 重启服务 + +```bash +# PHP-FPM +sudo systemctl restart php-fpm + +# Nginx +sudo systemctl restart nginx + +# 或者 Apache +sudo systemctl restart apache2 +``` + +### 步骤 7: 测试接口 + +**开启日志监控：** +```bash +tail -f server/runtime/log/$(date +%Y%m%d).log | grep -E "(Gancao|gancao|submitGancao)" +``` + +**在另一个终端调用接口：** +```bash +curl -X POST https://your-domain.com/api/tcm.prescriptionOrder/submitGancaoRecipel \ + -H "Content-Type: application/json" \ + -H "token: your_admin_token" \ + -d '{"id": 订单ID}' +``` + +## 预期结果 + +### 成功的情况 + +**接口响应：** +```json +{ + "code": 1, + "show": 0, + "msg": "甘草药方上传成功", + "data": { + "recipel_order_no": "GC202604...", + "app_order_no": "PO123", + "fee": { + "total": 150.00, + "medicine": 120.00, + "process": 20.00, + "express": 10.00 + } + } +} +``` + +**日志内容：** +``` +[info] Gancao MAKE_TOKEN request: {...} +[info] Gancao MAKE_TOKEN response: {...} +[info] Gancao CTM_SUBMIT_RECIPEL payload: {...} +[info] submitGancaoRecipel success: {...} +``` + +**数据库变化：** +- `prescription_order` 表中对应订单的 `gancao_reciperl_order_no` 字段已更新 +- `gancao_submit_time` 字段已更新为当前时间戳 + +### 失败的情况 + +如果仍然失败，日志会显示详细错误信息： + +**配置错误：** +``` +[error] Gancao MAKE_TOKEN api error: {"body": {...}, "apiMsg": "..."} +``` +→ 检查 `.env` 配置，特别是 AK/SK + +**SSL 连接错误：** +``` +[error] Gancao CTM_SUBMIT failed: {"subRet": {...}, "payload": {...}} +``` +→ 运行 `php test_gancao_ssl.php` 诊断 SSL 问题 + +**业务逻辑错误：** +``` +[error] submitGancaoRecipel exception: {"message": "...", "trace": "..."} +``` +→ 检查处方数据是否完整，药材 ID 是否正确映射 + +## 常见错误和解决方案 + +### 错误 1: "Array to string conversion" + +**已修复！** 如果仍然出现，请检查： +1. 文件是否正确上传 +2. 缓存是否已清除 +3. 服务是否已重启 + +### 错误 2: SSL 连接错误 + +**解决方案：** +1. 运行 `php test_gancao_ssl.php` +2. 查看哪种 SSL 配置成功 +3. 如果都失败，检查 OpenSSL 版本：`openssl version` +4. 联系甘草技术支持确认 SSL 要求 + +### 错误 3: "MAKE_TOKEN 失败：[10103]" + +**原因：** AK/SK 不匹配或密码计算错误 + +**解决方案：** +1. 检查 `.env` 中的配置： + ```env + GANCAO_SCM_BIZ_AK=xxx + GANCAO_SCM_BIZ_SK=xxx + ``` +2. 确认 BIZ AK/SK 与网关 AK/SK 是否相同 +3. 检查服务器时间是否正确：`date` +4. 联系甘草获取正确的 AK/SK + +### 错误 4: "药材无法匹配甘草药ID" + +**原因：** 药材 ID 映射缺失 + +**解决方案：** +1. 检查 `zyt_doctor_medicine` 表中药材的 `gid` 字段 +2. 或在 `.env` 配置 `herb_id_map`： + ```php + 'herb_id_map' => [ + '当归' => 1001, + '黄芪' => 1002, + ] + ``` + +## 验证修复成功 + +✅ **所有以下条件都满足，说明修复成功：** + +1. `php test_gancao_config.php` 全部通过 +2. `php test_gancao_ssl.php` 显示 "✓ 成功获取 token" +3. 接口返回 `{"code": 1, "msg": "甘草药方上传成功"}` +4. 日志中显示 `submitGancaoRecipel success` +5. 数据库中订单已更新 `gancao_reciperl_order_no` +6. 没有 "Array to string conversion" 错误 +7. 没有 SSL 连接错误 + +## 技术支持 + +如果以上步骤都无法解决问题，请收集以下信息： + +1. **配置检查输出：** + ```bash + php test_gancao_config.php > config_check.txt 2>&1 + ``` + +2. **SSL 测试输出：** + ```bash + php test_gancao_ssl.php > ssl_check.txt 2>&1 + ``` + +3. **错误日志：** + ```bash + tail -200 server/runtime/log/$(date +%Y%m%d).log > error.log + ``` + +4. **接口响应：** + ```bash + curl -X POST ... > response.json 2>&1 + ``` + +5. **系统信息：** + ```bash + php -v > system_info.txt + openssl version >> system_info.txt + curl --version >> system_info.txt + cat /etc/os-release >> system_info.txt + ``` + +将这些文件发送给技术支持进行分析。 + +## 总结 + +这次修复解决了三个主要问题： + +1. **Array to string conversion** - 甘草 API 返回的错误消息可能是数组 +2. **SSL 连接失败** - TLS 版本和 HTTP 版本不兼容 +3. **配置类型错误** - 某些配置值被错误地解析为数组 + +所有问题都已修复，现在应该可以正常调用甘草 API 了！ diff --git a/GANCAO_FIX_SUMMARY.md b/GANCAO_FIX_SUMMARY.md new file mode 100644 index 00000000..ac7f20d7 --- /dev/null +++ b/GANCAO_FIX_SUMMARY.md @@ -0,0 +1,286 @@ +# 甘草 API "Array to string conversion" 错误修复总结 + +## 问题描述 +在 Linux 服务器上调用甘草处方下单接口时，返回错误： +```json +{"code":2,"message":"Array to string conversion"} +``` + +## 已完成的修复 + +### 1. 代码层面修复 + +#### ✅ `GancaoScmRecipelService.php` +- 修复 `express_type` 字段：确保是字符串而不是数组 +- 修复 `callback_url` 字段：确保是字符串而不是数组 +- 修复患者年龄格式：从 `sprintf('%d.00', $ageInt)` 改为 `(string) $ageInt` +- 优化 `doct_advice` 字段处理：确保所有子字段都是字符串 +- 添加调试日志：记录发送的完整负载 + +#### ✅ `PrescriptionOrderLogic.php` +- 修复 `$appNo` 变量引用问题 +- 添加详细错误日志：记录失败时的完整请求和响应 +- 添加 `use think\facade\Log;` 导入 + +#### ✅ `PrescriptionOrderController.php` +- 添加 try-catch 异常处理 +- 添加返回值类型检查 +- 添加详细日志记录 + +### 2. 诊断工具 + +创建了三个诊断脚本： + +1. **`test_gancao_config.php`** - 配置检查脚本 + - 检查所有配置项是否存在 + - 检查配置值类型是否正确 + - 检查是否有数组值被错误地用作字符串 + - 测试 JSON 编码 + +2. **`diagnose_gancao_payload.php`** - 负载诊断脚本 + - 测试 `buildPreviewPayload` 方法 + - 测试 `buildSubmitPayload` 方法 + - 检查每个字段的类型 + - 测试 JSON 编码 + - 保存负载到文件以便检查 + +3. **文档**： + - `GANCAO_API_FIX.md` - 初步修复说明 + - `GANCAO_ARRAY_TO_STRING_FIX.md` - 完整解决方案 + - `GANCAO_FIX_SUMMARY.md` - 本文档 + +## 下一步操作 + +### 步骤 1: 上传修复后的代码到服务器 + +```bash +# 上传修改的文件 +scp server/app/common/service/gancao/GancaoScmRecipelService.php user@server:/path/to/server/app/common/service/gancao/ +scp server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php user@server:/path/to/server/app/adminapi/logic/tcm/ +scp server/app/adminapi/controller/tcm/PrescriptionOrderController.php user@server:/path/to/server/app/adminapi/controller/tcm/ + +# 上传诊断脚本 +scp test_gancao_config.php user@server:/path/to/ +scp diagnose_gancao_payload.php user@server:/path/to/ +``` + +### 步骤 2: 在服务器上运行配置检查 + +```bash +ssh user@server +cd /path/to/your/project + +# 运行配置检查 +php test_gancao_config.php +``` + +**期望输出**： +``` +=== 甘草配置检查 === + +1. 检查配置是否存在: + ✓ 配置已加载 + +2. 检查各项配置: + - enabled: ✓ boolean = true + - gateway_url: ✓ string = https://... + - gateway_ak: ✓ string = xxx + - gateway_sk: ✓ string = xxx + - biz_ak: ✓ string = xxx + - biz_sk: ✓ string = xxx + - callback_url: ✓ string = https://... + - express_type: ✓ string = sf + - cradle_store: ✓ string = xxx + - df_id: ✓ integer = 101 + +... + +=== 检查结果: ✓ 配置正常 === +``` + +**如果看到 ❌ 或 ⚠️**： +- 记录哪个字段有问题 +- 检查 `.env` 文件中该字段的配置 +- 修复后重新运行检查 + +### 步骤 3: 运行负载诊断 + +```bash +php diagnose_gancao_payload.php +``` + +这会： +- 测试负载构建过程 +- 检查每个字段的类型 +- 测试 JSON 编码 +- 生成一个 JSON 文件（`gancao_payload_YYYYMMDDHHMMSS.json`） + +检查生成的 JSON 文件，确保： +- 没有字段的值是 `"Array"` +- 所有字符串字段都是字符串 +- 所有数组字段都是数组 + +### 步骤 4: 清除缓存 + +```bash +cd server +php think clear + +# 或手动删除 +rm -rf runtime/cache/* +rm -rf runtime/temp/* +``` + +### 步骤 5: 重启服务 + +```bash +# PHP-FPM +sudo systemctl restart php-fpm + +# Nginx +sudo systemctl restart nginx +``` + +### 步骤 6: 测试接口 + +```bash +# 查看实时日志 +tail -f server/runtime/log/$(date +%Y%m%d).log | grep -i gancao +``` + +在另一个终端调用接口： +```bash +curl -X POST https://your-domain.com/api/tcm.prescriptionOrder/submitGancaoRecipel \ + -H "Content-Type: application/json" \ + -H "token: your_token" \ + -d '{"id": 订单ID}' +``` + +### 步骤 7: 检查日志 + +日志中应该看到： + +**成功的情况**： +``` +[info] Gancao CTM_SUBMIT_RECIPEL payload: {...} +[info] submitGancaoRecipel success: {...} +``` + +**失败的情况**： +``` +[error] Gancao CTM_SUBMIT failed: {...} +[error] submitGancaoRecipel exception: {...} +``` + +## 常见问题排查 + +### 问题 1: 配置检查显示某个字段是数组 + +**解决方案**： +1. 编辑 `.env` 文件 +2. 找到该字段的配置行 +3. 移除 `[]` 和多余的引号 +4. 示例： + ```env + # 错误 + GANCAO_SCM_EXPRESS_TYPE=["sf"] + + # 正确 + GANCAO_SCM_EXPRESS_TYPE=sf + ``` +5. 保存后清除缓存并重启服务 + +### 问题 2: JSON 中包含 "Array" 字符串 + +**解决方案**： +1. 运行 `diagnose_gancao_payload.php` 找出是哪个字段 +2. 检查该字段在代码中的处理 +3. 确保使用 `(string)` 强制转换 +4. 检查配置文件中该字段的值 + +### 问题 3: 仍然报 "Array to string conversion" + +**可能原因**： +1. 缓存未清除 +2. 服务未重启 +3. 上传的文件未生效 +4. 配置文件有语法错误 + +**排查步骤**： +1. 确认文件已上传：`ls -la server/app/common/service/gancao/GancaoScmRecipelService.php` +2. 检查文件修改时间：`stat server/app/common/service/gancao/GancaoScmRecipelService.php` +3. 清除所有缓存：`rm -rf server/runtime/*` +4. 重启所有服务 +5. 检查 PHP 错误日志：`tail -f /var/log/php-fpm/error.log` + +### 问题 4: 配置检查通过但接口仍然失败 + +**排查步骤**： +1. 检查日志中的完整错误信息 +2. 查看 `Gancao CTM_SUBMIT_RECIPEL payload` 日志，确认发送的数据 +3. 检查甘草 API 返回的错误信息 +4. 确认药材 ID 映射是否正确 +5. 确认处方数据是否完整 + +## 验证修复成功 + +修复成功的标志： + +1. ✅ `test_gancao_config.php` 全部通过 +2. ✅ `diagnose_gancao_payload.php` 全部通过 +3. ✅ 接口返回成功： + ```json + { + "code": 1, + "msg": "甘草药方上传成功", + "data": { + "recipel_order_no": "GC...", + "app_order_no": "PO...", + "fee": {...} + } + } + ``` +4. ✅ 日志显示 `submitGancaoRecipel success` +5. ✅ 数据库 `prescription_order` 表中 `gancao_reciperl_order_no` 字段已更新 + +## 需要进一步帮助 + +如果以上步骤都无法解决问题，请提供： + +1. **配置检查输出**： + ```bash + php test_gancao_config.php > config_check.txt 2>&1 + ``` + +2. **负载诊断输出**： + ```bash + php diagnose_gancao_payload.php > payload_check.txt 2>&1 + ``` + +3. **错误日志**： + ```bash + tail -100 server/runtime/log/$(date +%Y%m%d).log > error.log + ``` + +4. **接口响应**： + ```bash + curl -X POST ... > response.json 2>&1 + ``` + +5. **`.env` 配置**（隐藏敏感信息）： + ```bash + grep GANCAO_SCM .env > gancao_config.txt + ``` + +将这些文件发送给技术支持进行分析。 + +## 总结 + +这次修复主要解决了配置值类型错误的问题。关键点： + +1. **配置必须是正确的类型**：字符串字段不能是数组 +2. **`.env` 格式很重要**：不要使用 JSON 语法或数组语法 +3. **缓存必须清除**：修改配置后必须清除缓存 +4. **日志很重要**：添加了详细日志帮助排查问题 + +希望这次修复能解决你的问题！ diff --git a/GANCAO_PREVIEW_FEATURE.md b/GANCAO_PREVIEW_FEATURE.md new file mode 100644 index 00000000..f8088222 --- /dev/null +++ b/GANCAO_PREVIEW_FEATURE.md @@ -0,0 +1,212 @@ +# 甘草预下单测试功能 + +## 功能概述 +在订单编辑表单中添加"甘草预下单测试"功能，允许用户在不真实提交订单的情况下，测试当前配置的甘草预下单价格。测试结果以抽屉形式展示，包含完整的价格、配送、规则检查和药材明细信息。 + +## 实现内容 + +### 1. 后端接口 + +#### 控制器方法 (`server/app/adminapi/controller/tcm/PrescriptionOrderController.php`) +```php +public function previewGancaoRecipel() +``` +- 调用验证器场景：`previewGancaoRecipel` +- 调用逻辑方法：`PrescriptionOrderLogic::previewGancaoRecipel()` +- 返回预览结果（包含价格信息） + +#### 逻辑方法 (`server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php`) +```php +public static function previewGancaoRecipel(int $id, int $adminId, array $adminInfo) +``` +- 验证订单和处方存在性 +- 检查药材是否能匹配甘草药ID +- 获取甘草token +- 调用 `CTM_PREVIEW` 接口 +- 检查规则拦截和药材可用性 +- 返回完整的预览数据（不提交订单） + +#### 验证器 (`server/app/adminapi/validate/tcm/PrescriptionOrderValidate.php`) +- 添加场景：`previewGancaoRecipel => ['id']` + +### 2. 前端实现 + +#### API接口 (`admin/src/api/tcm.ts`) +```typescript +export function prescriptionOrderPreviewGancaoRecipel(params: { id: number }) +``` + +#### UI组件 (`admin/src/views/consumer/prescription/order_list.vue`) + +**测试按钮位置**：在"剂数"和"剂量单位"字段后，"上次医生"字段前 + +**组件结构**： +```vue +测试价格 + + + + + + + +``` + +### 3. 抽屉展示内容 + +#### 价格信息卡片 +- **药材成本** (`m_cost`): 橙色显示，单位：元 +- **加工费** (`proces_cost`): 蓝色显示，单位：分转元 +- **物流费** (`lis_cost`): 绿色显示，单位：分转元 +- **总计**: 红色加粗显示，自动计算总和 + +#### 配送信息卡片 +- 调配中心名称 (`ds_name`) +- 调配中心ID (`ds_id`) +- 服用天数范围 (`take_days.min` - `take_days.max`) +- 默认服用天数 (`take_days.default`) + +#### 规则检查卡片 +- 显示所有规则检查结果 (`rule_check`) +- 根据 `type` 显示不同颜色： + - `type >= 2`: 错误（红色） + - `type === 1`: 警告（黄色） + - `type === 0`: 信息（蓝色） +- 显示规则代码 (`code`) 和消息 (`msg`) + +#### 药材明细表格 +- 序号 +- 药材名称 (`title`) +- 用量 (`quantity` + `unit`) +- 单价 (`price`，元/克，保留4位小数） +- 小计（单价 × 用量，橙色显示） +- 库存状态 (`is_available`，1=有货/0=缺货） +- 备注 (`brief`) + +#### 订单信息卡片 +- 订单号 (`order_no`)：跨2列显示 +- 剂数 (`dose_count`)：显示格式"X剂"（如：5剂） +- 单剂量：自动计算所有药材用量总和，显示格式"X克"（如：196克） + +## 接口返回数据结构 + +```json +{ + "code": 1, + "msg": "预下单成功", + "data": { + "success": true, + "fee": { + "m_cost": "112.88", + "proces_cost": 80, + "lis_cost": 0 + }, + "result": { + "aa_id": 73, + "ds_id": 135, + "ds_name": "郑州-甘草调配中心√", + "take_days": { + "min": 7, + "max": 35, + "default": 28 + }, + "rule_check": [ + { + "code": "pill_yield_notice", + "msg": "出丸量约98g±5%", + "type": 0 + } + ], + "fee": { + "m_cost": "112.88", + "proces_cost": 80, + "lis_cost": 0 + }, + "m_list": [ + { + "id": 420, + "title": "龙胆", + "price": 0.405028, + "unit": "克", + "quantity": "6", + "is_available": 1, + "brief": "" + } + ] + }, + "order_no": "PO20260414160525788214", + "dose_count": 5 + } +} +``` + +## UI设计特点 + +### 布局 +- 使用 `el-drawer` 抽屉组件，宽度 800px +- 内容分为5个卡片区域，使用 `el-card` 组件 +- 使用 `el-descriptions` 展示键值对信息 +- 使用 `el-table` 展示药材明细列表 + +### 颜色方案 +- 药材成本：橙色 (`text-orange-600`) +- 加工费：蓝色 (`text-blue-600`) +- 物流费：绿色 (`text-green-600`) +- 总计：红色加粗 (`text-red-600 font-bold`) +- 小计：橙色 (`text-orange-600`) + +### 交互 +- 点击"测试价格"按钮触发预下单 +- 按钮显示加载状态（loading） +- 成功后自动打开抽屉展示结果 +- 失败时显示错误提示消息 + +## 使用流程 + +1. 打开订单编辑对话框 +2. 配置剂数（`dose_count`）和剂量单位（`dose_unit`） +3. 点击"测试价格"按钮 +4. 系统调用甘草 `CTM_PREVIEW` 接口 +5. 自动打开抽屉展示完整的预下单结果 + +## 注意事项 + +- 预下单测试**不会**真实提交订单到甘草 +- 预下单测试**不会**扣费 +- 仅用于验证配置和查看价格 +- 需要先保存订单才能测试（`editForm.id` 必须存在） +- 测试结果会检查： + - 药材是否匹配甘草药ID + - 规则是否拦截 + - 药材是否缺货 +- 抽屉关闭时自动销毁内容（`destroy-on-close`） + +## 相关文件 + +### 后端 +- `server/app/adminapi/controller/tcm/PrescriptionOrderController.php` +- `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` +- `server/app/adminapi/validate/tcm/PrescriptionOrderValidate.php` +- `server/app/common/service/gancao/GancaoScmRecipelService.php` + +### 前端 +- `admin/src/api/tcm.ts` +- `admin/src/views/consumer/prescription/order_list.vue` + +## 测试要点 + +- [ ] 点击"测试价格"按钮能正常调用接口 +- [ ] 成功时自动打开抽屉展示结果 +- [ ] 价格信息显示正确（药材成本、加工费、物流费、总计） +- [ ] 配送信息显示完整（调配中心、服用天数范围） +- [ ] 规则检查按类型显示不同颜色 +- [ ] 药材明细表格显示完整（名称、用量、单价、小计、库存状态） +- [ ] 订单信息显示正确（订单号、剂数） +- [ ] 失败时显示清晰的错误信息 +- [ ] 按钮加载状态正常显示 +- [ ] 价格单位正确（分转元） +- [ ] 仅在编辑已存在订单时显示测试按钮 +- [ ] 测试不会真实提交订单到甘草 +- [ ] 测试不会修改订单状态 +- [ ] 抽屉关闭后内容正确销毁 + diff --git a/GANCAO_SSL_FIX.md b/GANCAO_SSL_FIX.md new file mode 100644 index 00000000..1914c363 --- /dev/null +++ b/GANCAO_SSL_FIX.md @@ -0,0 +1,284 @@ +# 甘草 SSL 连接错误修复指南 + +## 错误信息 + +``` +甘草网关通信失败：通信失败：HTTP 200 curl#56 OpenSSL SSL_read: error:0A000126:SSL routines::unexpected eof while reading, errno 0 +``` + +## 问题分析 + +这个错误表示： +- ✅ TCP 连接成功（HTTP 200） +- ✅ SSL 握手开始 +- ❌ SSL 读取数据时连接意外断开 + +**常见原因：** +1. TLS 版本不兼容（服务器要求 TLS 1.2+，客户端使用旧版本） +2. SSL 加密套件不匹配 +3. HTTP 版本问题（HTTP/1.0 vs HTTP/1.1） +4. OpenSSL 安全级别过高 +5. 服务器端提前关闭连接 + +## 已实施的修复 + +### 修改 `GancaoOpenApiTransport.php` + +```php +// 1. 改用 HTTP/1.1（原来是 HTTP/1.0） +curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1); + +// 2. 增加连接超时 +curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10); // 从 5 秒增加到 10 秒 + +// 3. 完全禁用 SSL 验证 +curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); // 从 2 改为 0 + +// 4. 强制使用 TLS 1.2 +curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2); + +// 5. 降低 OpenSSL 安全级别 +curl_setopt($ch, CURLOPT_SSL_CIPHER_LIST, 'DEFAULT@SECLEVEL=1'); + +// 6. 添加 TCP keepalive +curl_setopt($ch, CURLOPT_TCP_KEEPALIVE, 1); +curl_setopt($ch, CURLOPT_TCP_KEEPIDLE, 120); +curl_setopt($ch, CURLOPT_TCP_KEEPINTVL, 60); +``` + +## 测试步骤 + +### 步骤 1: 上传修复后的文件 + +```bash +scp server/app/common/service/gancao/GancaoOpenApiTransport.php user@server:/path/to/server/app/common/service/gancao/ +scp test_gancao_ssl.php user@server:/path/to/ +``` + +### 步骤 2: 运行 SSL 测试 + +```bash +ssh user@server +cd /path/to/your/project +php test_gancao_ssl.php +``` + +**期望输出：** +``` +=== 甘草 SSL 连接测试 === + +网关地址: https://xxx.com + +1. DNS 解析测试: + ✓ xxx.com -> 1.2.3.4 + +2. TCP 连接测试: + ✓ TCP 连接成功 + +3. SSL/TLS 支持检测: + - SSLv2: ✗ 不支持 + - SSLv3: ✗ 不支持 + - TLS 1.0: ✓ 支持 + - TLS 1.1: ✓ 支持 + - TLS 1.2: ✓ 支持 + - TLS 1.3: ✓ 支持 + +4. cURL SSL 测试: + 测试 HTTP/1.0 + TLS 1.2: + ❌ 失败: [56] OpenSSL SSL_read... + 测试 HTTP/1.1 + TLS 1.2: + ✓ 成功 (HTTP 200) + 测试 HTTP/1.1 + TLS 1.2 + SECLEVEL=1: + ✓ 成功 (HTTP 200) + +5. OpenSSL 版本信息: + 版本: OpenSSL 1.1.1... + +6. cURL 版本信息: + 版本: 7.x.x + SSL 版本: OpenSSL/1.1.1... + +7. 测试实际 API 调用 (MAKE_TOKEN): + ✓ 成功获取 token (长度: 64) +``` + +### 步骤 3: 清除缓存并重启 + +```bash +cd server +php think clear +rm -rf runtime/cache/* + +# 重启服务 +sudo systemctl restart php-fpm +sudo systemctl restart nginx +``` + +### 步骤 4: 测试接口 + +```bash +# 查看日志 +tail -f server/runtime/log/$(date +%Y%m%d).log | grep -i gancao +``` + +在另一个终端调用接口： +```bash +curl -X POST https://your-domain.com/api/tcm.prescriptionOrder/submitGancaoRecipel \ + -H "Content-Type: application/json" \ + -H "token: your_token" \ + -d '{"id": 订单ID}' +``` + +## 如果仍然失败 + +### 方案 A: 检查 OpenSSL 版本 + +```bash +openssl version +``` + +**要求：** OpenSSL 1.0.2 或更高版本 + +**如果版本过低，升级 OpenSSL：** + +```bash +# CentOS/RHEL +sudo yum update openssl + +# Ubuntu/Debian +sudo apt-get update +sudo apt-get install --only-upgrade openssl + +# 重新编译 PHP（如果需要） +``` + +### 方案 B: 修改 OpenSSL 配置 + +编辑 `/etc/ssl/openssl.cnf`： + +```ini +# 在文件开头添加 +openssl_conf = openssl_init + +[openssl_init] +ssl_conf = ssl_sect + +[ssl_sect] +system_default = system_default_sect + +[system_default_sect] +MinProtocol = TLSv1.2 +CipherString = DEFAULT@SECLEVEL=1 +``` + +重启服务： +```bash +sudo systemctl restart php-fpm +``` + +### 方案 C: 使用不同的 TLS 版本 + +如果 TLS 1.2 不工作，尝试其他版本。 + +修改 `GancaoOpenApiTransport.php`： + +```php +// 尝试 TLS 1.3 +curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_3); + +// 或者让 cURL 自动选择 +curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_DEFAULT); +``` + +### 方案 D: 禁用 HTTP/2 + +如果使用了 HTTP/2，尝试禁用： + +```php +curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1); +``` + +### 方案 E: 增加调试信息 + +临时添加详细的 cURL 调试： + +```php +// 在 GancaoOpenApiTransport.php 的 post 方法中添加 +curl_setopt($ch, CURLOPT_VERBOSE, true); +$verbose = fopen('php://temp', 'w+'); +curl_setopt($ch, CURLOPT_STDERR, $verbose); + +// 在 curl_exec 之后添加 +rewind($verbose); +$verboseLog = stream_get_contents($verbose); +\think\facade\Log::info('cURL verbose output', ['log' => $verboseLog]); +``` + +查看详细日志： +```bash +tail -f server/runtime/log/$(date +%Y%m%d).log +``` + +### 方案 F: 联系甘草技术支持 + +提供以下信息： +1. `php test_gancao_ssl.php` 的完整输出 +2. `openssl version` 输出 +3. `php -v` 输出 +4. `curl --version` 输出 +5. 服务器操作系统版本 + +询问： +- 甘草网关支持的 TLS 版本 +- 推荐的 SSL 加密套件 +- 是否有特殊的 HTTP 头要求 +- 是否有 IP 白名单限制 + +## 常见问题 + +### Q1: 为什么 HTTP/1.0 会导致问题？ + +A: 某些现代服务器不再支持 HTTP/1.0，或者在 HTTP/1.0 下有不同的 SSL 处理逻辑。HTTP/1.1 是更标准的选择。 + +### Q2: SECLEVEL=1 是什么？ + +A: OpenSSL 1.1.0+ 引入了安全级别概念： +- SECLEVEL=2（默认）：要求 112 位安全性 +- SECLEVEL=1：要求 80 位安全性（更宽松） +- SECLEVEL=0：允许所有加密套件（不推荐） + +降低安全级别可以兼容更多服务器，但会降低安全性。 + +### Q3: 为什么要禁用 SSL 验证？ + +A: 在开发/测试环境中，禁用 SSL 验证可以避免证书问题。**生产环境建议启用验证**。 + +### Q4: TCP keepalive 有什么用？ + +A: 保持 TCP 连接活跃，防止长时间传输时连接被中断。 + +## 验证修复成功 + +修复成功的标志： + +1. ✅ `php test_gancao_ssl.php` 显示 "✓ 成功获取 token" +2. ✅ 接口返回成功： + ```json + { + "code": 1, + "msg": "甘草药方上传成功", + "data": {...} + } + ``` +3. ✅ 日志中没有 SSL 错误 +4. ✅ 数据库中订单已更新 + +## 总结 + +SSL 连接问题通常是由于： +1. **TLS 版本不匹配** → 使用 TLS 1.2 +2. **HTTP 版本问题** → 使用 HTTP/1.1 +3. **OpenSSL 安全级别过高** → 降低到 SECLEVEL=1 +4. **连接超时** → 增加超时时间 + +修复后应该能正常连接甘草 API。如果仍有问题，运行 `test_gancao_ssl.php` 并根据输出进一步诊断。 diff --git a/GANCAO_UPLOAD_BUTTON_CONDITION.md b/GANCAO_UPLOAD_BUTTON_CONDITION.md new file mode 100644 index 00000000..c760cf10 --- /dev/null +++ b/GANCAO_UPLOAD_BUTTON_CONDITION.md @@ -0,0 +1,169 @@ +# 甘草上传药方按钮显示条件 + +## 需求 +"上传药方"按钮应该只在特定条件下显示： +1. 处方审核已通过 +2. 还没有上传过甘草订单（gancao_reciperl_order_no 为空） + +## 实现 + +### 文件：`admin/src/views/consumer/prescription/order_list.vue` + +#### 1. 添加条件判断函数 + +```typescript +function canUploadGancaoRow(row: { + prescription_audit_status?: number + gancao_reciperl_order_no?: string +}) { + // 处方审核已通过(1) 且没有甘草订单号时才显示 + const rxStatus = Number(row.prescription_audit_status) + const gancaoOrderNo = String(row.gancao_reciperl_order_no || '').trim() + return rxStatus === 1 && gancaoOrderNo === '' +} +``` + +**逻辑说明**： +- `prescription_audit_status === 1`：处方审核状态为"已通过" +- `gancao_reciperl_order_no` 为空：还没有上传过甘草订单 + +#### 2. 更新按钮显示条件 + +```vue +上传药方 +``` + +## 显示逻辑 + +### 场景 1：处方未审核 +``` +prescription_audit_status: 0 (待审核) +gancao_reciperl_order_no: '' +→ 按钮隐藏 ❌ +``` + +### 场景 2：处方已驳回 +``` +prescription_audit_status: 2 (已驳回) +gancao_reciperl_order_no: '' +→ 按钮隐藏 ❌ +``` + +### 场景 3：处方已通过，未上传 +``` +prescription_audit_status: 1 (已通过) +gancao_reciperl_order_no: '' +→ 按钮显示 ✅ +``` + +### 场景 4：处方已通过，已上传 +``` +prescription_audit_status: 1 (已通过) +gancao_reciperl_order_no: 'GC202604150001' +→ 按钮隐藏 ❌ +``` + +## 审核状态说明 + +| 状态值 | 说明 | 是否显示按钮 | +|--------|------|-------------| +| 0 | 待审核 | ❌ | +| 1 | 已通过 | ✅ (如果未上传) | +| 2 | 已驳回 | ❌ | + +## 业务流程 + +``` +创建订单 + ↓ +处方待审核 (prescription_audit_status = 0) + ↓ 审核 +处方已通过 (prescription_audit_status = 1) + ↓ 显示"上传药方"按钮 +点击上传 + ↓ 调用甘草API +上传成功，保存订单号 (gancao_reciperl_order_no = 'GC...') + ↓ 按钮隐藏 +订单继续履约流程 +``` + +## 相关字段 + +### prescription_audit_status (处方审核状态) +- **类型**: tinyint(2) +- **值**: + - 0: 待审核 + - 1: 已通过 + - 2: 已驳回 + +### gancao_reciperl_order_no (甘草处方订单号) +- **类型**: varchar(32) +- **说明**: 上传甘草成功后返回的订单号 +- **示例**: `GC202604150001` +- **空值**: 表示还未上传 + +## 防止重复上传 + +通过检查 `gancao_reciperl_order_no` 字段，确保： +1. 每个订单只能上传一次 +2. 上传成功后按钮自动隐藏 +3. 避免重复提交导致的数据混乱 + +## 用户体验 + +### 上传前 +``` +操作列： +[详情/审核] [编辑] [上传药方] [确认发货] ... +``` + +### 上传后 +``` +操作列： +[详情/审核] [编辑] [确认发货] ... +``` +"上传药方"按钮消失，界面更简洁。 + +## 错误处理 + +如果用户尝试重复上传（通过其他方式），后端也有验证： + +```php +// server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php +if (!self::canUploadGancaoRecipel($item, $adminId, $adminInfo, $assistantByDiag)) { + self::$error = '须处方审核通过后方可上传甘草；已完成/已取消订单不可上传；同一订单仅可上传一次'; + return false; +} +``` + +## 测试清单 + +- [ ] 创建新订单，处方待审核，按钮不显示 +- [ ] 处方审核通过，按钮显示 +- [ ] 点击上传药方，上传成功 +- [ ] 刷新页面，按钮消失 +- [ ] 处方被驳回，按钮不显示 +- [ ] 已上传的订单，按钮不显示 + +## 相关文件 + +- `admin/src/views/consumer/prescription/order_list.vue` - 订单列表页面 +- `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` - 后端业务逻辑 +- `GANCAO_CALLBACK_SETUP.md` - 甘草回调功能文档 + +## 总结 + +通过添加 `canUploadGancaoRow()` 函数，实现了智能的按钮显示控制： +- ✅ 只在处方审核通过后显示 +- ✅ 上传成功后自动隐藏 +- ✅ 防止重复上传 +- ✅ 提升用户体验 + +这样可以避免用户误操作，确保业务流程的正确性。 diff --git a/PINYIN_ABBREVIATION_GUIDE.md b/PINYIN_ABBREVIATION_GUIDE.md new file mode 100644 index 00000000..3d1f0310 --- /dev/null +++ b/PINYIN_ABBREVIATION_GUIDE.md @@ -0,0 +1,275 @@ +# 药材名称拼音首字母功能说明 + +## 概述 +系统使用 `overtrue/pinyin` 包自动生成中文药材名称的拼音首字母缩写，存储在 `name_pinyin_abbr` 字段中，用于快速检索。 + +## 核心实现 + +### 1. 依赖包 +```json +"overtrue/pinyin": "^6.0" +``` +已在 `server/composer.json` 中配置。 + +### 2. 服务类：`MedicineNameAbbrService` +**文件位置：** `server/app/common/service/doctor/MedicineNameAbbrService.php` + +```php +join(''); + + return strtolower($abbr); + } +} +``` + +**功能说明：** +- 输入：中文药材名称（如 "当归"） +- 输出：拼音首字母小写连写（如 "dg"） +- 自动处理：去除空格、转小写 +- 容错：如果 Pinyin 类不存在，返回空字符串 + +### 3. 使用示例 + +#### 示例 1：当归 +```php +MedicineNameAbbrService::build('当归'); +// 输出: "dg" +``` + +#### 示例 2：黄芪 +```php +MedicineNameAbbrService::build('黄芪'); +// 输出: "hq" +``` + +#### 示例 3：党参 +```php +MedicineNameAbbrService::build('党参'); +// 输出: "ds" +``` + +#### 示例 4：白术 +```php +MedicineNameAbbrService::build('白术'); +// 输出: "bs" +``` + +## 自动生成时机 + +### 1. 创建药材时 +**文件：** `server/app/adminapi/logic/doctor/MedicineLogic.php` + +```php +Medicine::create([ + 'name' => $params['name'], + 'name_pinyin_abbr' => MedicineNameAbbrService::build($params['name']), + // ... 其他字段 +]); +``` + +### 2. 编辑药材时 +```php +Medicine::update([ + 'id' => $params['id'], + 'name' => $params['name'], + 'name_pinyin_abbr' => MedicineNameAbbrService::build($params['name']), + // ... 其他字段 +]); +``` + +## 批量回填命令 + +### 命令：`sync_medicine_pinyin_abbr` +**文件：** `server/app/common/command/SyncMedicinePinyinAbbr.php` + +用于批量生成或更新已有药材的拼音首字母。 + +### 使用方法 + +#### 1. 仅更新空字段（默认） +```bash +cd server +php think sync_medicine_pinyin_abbr +``` +只处理 `name_pinyin_abbr` 为空的记录。 + +#### 2. 重算全部记录 +```bash +php think sync_medicine_pinyin_abbr --all +``` +重新计算所有药材的拼音首字母（覆盖现有值）。 + +#### 3. 预览模式（不写入数据库） +```bash +php think sync_medicine_pinyin_abbr --dry +``` +只统计将更新多少条，不实际写入。 + +#### 4. 组合使用 +```bash +php think sync_medicine_pinyin_abbr --all --dry +``` +预览全部重算的结果。 + +### 命令输出示例 +``` +模式: 仅空 abbr，待处理 150 条 +完成: 已更新 145 条，跳过 5 条。 +``` + +## 检索功能 + +### 列表搜索 +**文件：** `server/app/adminapi/lists/doctor/MedicineLists.php` + +```php +$query->where(function ($q) use ($kw, $keyword) { + $q->where('name_pinyin_abbr', 'like', '%' . $kw . '%') + ->whereOr('name', 'like', '%' . $keyword . '%'); +}); +``` + +**功能说明：** +- 用户输入 "dg" 可以搜索到 "当归" +- 用户输入 "当归" 也可以搜索到 +- 支持模糊匹配（LIKE 查询） + +### 搜索示例 + +| 用户输入 | 匹配药材 | +|---------|---------| +| dg | 当归 | +| hq | 黄芪 | +| ds | 党参、丹参 | +| bs | 白术、白芍 | +| 当归 | 当归 | + +## 数据库字段 + +### 表：`zyt_doctor_medicine` +```sql +`name_pinyin_abbr` varchar(64) DEFAULT NULL COMMENT '名称拼音首字母缩写(小写连写)' +``` + +### 索引建议 +如果药材数量很大（>10000条），建议添加索引： +```sql +ALTER TABLE `zyt_doctor_medicine` +ADD INDEX `idx_name_pinyin_abbr` (`name_pinyin_abbr`); +``` + +## 常见问题 + +### Q1: 如何安装 overtrue/pinyin？ +```bash +cd server +composer require overtrue/pinyin +``` +（已在项目中安装，无需手动执行） + +### Q2: 多音字如何处理？ +`overtrue/pinyin` 会自动选择最常用的读音。例如： +- "重" → "z" (重量) 或 "c" (重复) +- 默认使用最常见的读音 + +### Q3: 如何处理英文或数字？ +- 英文字母：保留原样并转小写 +- 数字：保留原样 +- 示例：`"维生素B12"` → `"wssbB12"` → `"wssbb12"` + +### Q4: 为什么有些药材搜索不到？ +可能原因： +1. `name_pinyin_abbr` 字段为空 → 运行批量回填命令 +2. 药材名称包含特殊字符 → 检查数据质量 +3. 索引未生效 → 检查数据库索引 + +### Q5: 如何在其他模块使用？ +```php +use app\common\service\doctor\MedicineNameAbbrService; + +// 生成拼音首字母 +$abbr = MedicineNameAbbrService::build('当归'); +echo $abbr; // 输出: dg +``` + +## 性能优化建议 + +### 1. 批量处理 +命令使用 `chunk(200)` 分批处理，避免内存溢出： +```php +$makeQuery()->chunk(200, function ($rows) { + // 每次处理 200 条 +}); +``` + +### 2. 异步生成 +对于大量数据，建议： +- 使用队列异步处理 +- 在低峰期运行批量命令 +- 使用 `--dry` 先预览再执行 + +### 3. 缓存策略 +如果药材数据不常变动，可以： +- 缓存常用药材的拼音首字母 +- 使用 Redis 存储热门搜索词 + +## 相关文件 + +| 文件 | 说明 | +|------|------| +| `server/app/common/service/doctor/MedicineNameAbbrService.php` | 拼音首字母生成服务 | +| `server/app/common/command/SyncMedicinePinyinAbbr.php` | 批量回填命令 | +| `server/app/adminapi/logic/doctor/MedicineLogic.php` | 药材增删改逻辑 | +| `server/app/adminapi/lists/doctor/MedicineLists.php` | 药材列表搜索 | +| `server/app/common/model/doctor/Medicine.php` | 药材模型 | + +## 扩展应用 + +此功能可以扩展到其他需要中文检索的模块： + +### 1. 患者姓名检索 +```php +use app\common\service\doctor\MedicineNameAbbrService; + +$patientName = '张三'; +$abbr = MedicineNameAbbrService::build($patientName); // "zs" +``` + +### 2. 医生姓名检索 +```php +$doctorName = '李医生'; +$abbr = MedicineNameAbbrService::build($doctorName); // "lys" +``` + +### 3. 诊断名称检索 +```php +$diagnosis = '感冒'; +$abbr = MedicineNameAbbrService::build($diagnosis); // "gm" +``` + +## 总结 + +- **核心类：** `MedicineNameAbbrService::build()` +- **依赖包：** `overtrue/pinyin` +- **存储字段：** `name_pinyin_abbr` +- **批量命令：** `php think sync_medicine_pinyin_abbr` +- **应用场景：** 药材快速检索、模糊搜索 + +这个功能大大提升了中文药材名称的搜索体验，用户可以通过拼音首字母快速找到目标药材。 diff --git a/PRESCRIPTION_DOSAGE_COMPLETE_SUMMARY.md b/PRESCRIPTION_DOSAGE_COMPLETE_SUMMARY.md new file mode 100644 index 00000000..769fe3fd --- /dev/null +++ b/PRESCRIPTION_DOSAGE_COMPLETE_SUMMARY.md @@ -0,0 +1,283 @@ +# 处方用量功能完整实现总结 + +## 概述 +在两个处方页面中实现了用量、单位和代煎功能： +1. **处方组件** (`admin/src/components/tcm-prescription/index.vue`) - 创建/编辑处方 +2. **处方列表** (`admin/src/views/consumer/prescription/index.vue`) - 查看/编辑处方 + +## 已实现的功能 + +### 1. 数据库层 ✅ +**文件**: `add_prescription_dosage_fields.sql` + +```sql +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值', +ADD COLUMN `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)', +ADD COLUMN `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)'; +``` + +### 2. 后端层 ✅ + +#### 模型 (`server/app/common/model/tcm/Prescription.php`) +```php +protected $type = [ + 'dosage_amount' => 'float', + 'need_decoction' => 'integer', +]; +``` + +#### 业务逻辑 (`server/app/adminapi/logic/tcm/PrescriptionLogic.php`) +- ✅ `add()` 方法：保存新处方 +- ✅ `edit()` 方法：编辑处方 + +### 3. 前端层 ✅ + +#### 3.1 处方组件 (`admin/src/components/tcm-prescription/index.vue`) + +**数据结构**: +```typescript +interface PrescriptionForm { + prescription_type: string + dosage_amount: number | undefined + dosage_unit: string + need_decoction: boolean + // ... +} +``` + +**响应式数据**: +```typescript +const formData = reactive({ + prescription_type: '浓缩水丸', + dosage_amount: 1, + dosage_unit: 'g', + need_decoction: false, + // ... +}) +``` + +**自动切换逻辑**: +```typescript +watch(() => formData.prescription_type, (newType) => { + if (newType === '浓缩水丸') { + formData.dosage_unit = 'g' + formData.dosage_amount = 1 + formData.need_decoction = false + } else if (newType === '饮片') { + formData.dosage_unit = 'ml' + formData.dosage_amount = 50 + } else { + formData.dosage_unit = 'g' + formData.dosage_amount = undefined + formData.need_decoction = false + } +}) +``` + +#### 3.2 处方列表 (`admin/src/views/consumer/prescription/index.vue`) + +**数据结构**: +```typescript +const editForm = reactive({ + prescription_type: '浓缩水丸', + dosage_amount: 1 as number | undefined, + dosage_unit: 'g', + need_decoction: false, + // ... +}) +``` + +**自动切换逻辑**: +```typescript +watch(() => editForm.prescription_type, (newType) => { + if (newType === '浓缩水丸') { + editForm.dosage_unit = 'g' + editForm.dosage_amount = 1 + editForm.need_decoction = false + } else if (newType === '饮片') { + editForm.dosage_unit = 'ml' + editForm.dosage_amount = 50 + } else { + editForm.dosage_unit = 'g' + editForm.dosage_amount = undefined + editForm.need_decoction = false + } +}) +``` + +## UI 组件实现 + +### 浓缩水丸 (1-10g) +```vue + + + + + +``` + +### 饮片 (50-250ml) +```vue + + + + + + + + + + + 代煎 + 不代煎 + +``` + +### 其他类型 +```vue + +``` + +## 功能规则 + +### 1. 浓缩水丸 +- **单位**: g (克) +- **范围**: 1-10g +- **UI**: 下拉选择 +- **代煎**: 不显示 + +### 2. 饮片 +- **单位**: ml (毫升) +- **范围**: 50-250ml (步进50ml) +- **UI**: 下拉选择 +- **代煎**: 显示单选按钮（代煎/不代煎） + +### 3. 其他类型（颗粒、丸剂、散剂、膏方、汤剂） +- **单位**: g (克) +- **范围**: 不限制 +- **UI**: 数字输入框（支持小数） +- **代煎**: 不显示 + +## 数据流转示例 + +### 创建浓缩水丸处方 +``` +用户操作: +1. 选择"浓缩水丸" +2. 自动设置: 单位=g, 用量=1g +3. 选择用量: 5g +4. 保存 + +数据库存储: +prescription_type: "浓缩水丸" +dosage_amount: 5.00 +dosage_unit: "g" +need_decoction: 0 +``` + +### 创建饮片处方（代煎） +``` +用户操作: +1. 选择"饮片" +2. 自动设置: 单位=ml, 用量=50ml +3. 选择用量: 150ml +4. 选择"代煎" +5. 保存 + +数据库存储: +prescription_type: "饮片" +dosage_amount: 150.00 +dosage_unit: "ml" +need_decoction: 1 +``` + +## 部署清单 + +### 1. 数据库迁移 ⚠️ 必须执行 +```bash +mysql -u用户名 -p数据库名 < add_prescription_dosage_fields.sql +``` + +### 2. 后端文件 +- ✅ `server/app/common/model/tcm/Prescription.php` +- ✅ `server/app/adminapi/logic/tcm/PrescriptionLogic.php` + +### 3. 前端文件 +- ✅ `admin/src/components/tcm-prescription/index.vue` +- ✅ `admin/src/views/consumer/prescription/index.vue` + +## 测试清单 + +### 处方组件测试 +- [ ] 创建浓缩水丸处方，选择1-10g +- [ ] 创建饮片处方，选择50-250ml +- [ ] 饮片处方选择"代煎" +- [ ] 饮片处方选择"不代煎" +- [ ] 创建颗粒处方，输入自定义用量 +- [ ] 切换处方类型，验证用量自动调整 +- [ ] 保存处方，验证数据正确存储 + +### 处方列表测试 +- [ ] 编辑浓缩水丸处方，修改用量 +- [ ] 编辑饮片处方，修改用量和代煎选项 +- [ ] 编辑其他类型处方，输入自定义用量 +- [ ] 切换处方类型，验证用量自动调整 +- [ ] 保存修改，验证数据正确更新 +- [ ] 查看处方详情，验证显示正确 + +### 数据验证测试 +- [ ] 浓缩水丸用量范围：1-10g +- [ ] 饮片用量范围：50-250ml +- [ ] 饮片用量步进：50ml +- [ ] 代煎选项仅在饮片时显示 +- [ ] 切换类型时代煎选项自动隐藏 + +## 文件清单 + +### 数据库 +- `add_prescription_dosage_fields.sql` - 数据库迁移文件 + +### 后端 +- `server/app/common/model/tcm/Prescription.php` - 处方模型 +- `server/app/adminapi/logic/tcm/PrescriptionLogic.php` - 处方业务逻辑 + +### 前端 +- `admin/src/components/tcm-prescription/index.vue` - 处方组件 +- `admin/src/views/consumer/prescription/index.vue` - 处方列表 + +### 文档 +- `PRESCRIPTION_DOSAGE_FEATURE.md` - 功能说明 +- `PRESCRIPTION_DOSAGE_DATABASE_IMPLEMENTATION.md` - 数据库实现 +- `PRESCRIPTION_DOSAGE_COMPLETE_SUMMARY.md` - 本文档 + +## 注意事项 + +1. **数据库迁移必须先执行**，否则保存时会报错 +2. **旧数据兼容**：旧处方的用量字段为NULL，不影响显示 +3. **类型切换**：切换处方类型时，用量和单位会自动调整 +4. **代煎选项**：仅在选择"饮片"时显示 +5. **数据验证**：前端使用下拉选择确保数据有效性 + +## 后续优化建议 + +1. **后端验证**：添加用量范围的后端验证逻辑 +2. **打印显示**：在处方打印时显示用量和代煎信息 +3. **统计报表**：按处方类型和用量统计 +4. **价格联动**：根据用量自动计算处方价格 +5. **库存检查**：代煎选项关联药房库存 + +## 总结 + +✅ **数据库层**：3个字段已定义 +✅ **后端层**：模型和业务逻辑已实现 +✅ **前端层**：2个页面都已实现 +✅ **UI组件**：下拉选择器和单选按钮 +✅ **自动切换**：watch监听实现 +✅ **数据流转**：完整的保存和读取 + +**状态**: 功能完整实现，只需执行数据库迁移即可使用！🎉 diff --git a/PRESCRIPTION_DOSAGE_DATABASE_IMPLEMENTATION.md b/PRESCRIPTION_DOSAGE_DATABASE_IMPLEMENTATION.md new file mode 100644 index 00000000..1fd0165d --- /dev/null +++ b/PRESCRIPTION_DOSAGE_DATABASE_IMPLEMENTATION.md @@ -0,0 +1,366 @@ +# 处方用量数据库实现完整指南 + +## 概述 +为处方系统添加用量、单位和代煎字段的完整数据库实现。 + +## 1. 数据库迁移 + +### 执行SQL文件 +**文件**: `add_prescription_dosage_fields.sql` + +```sql +-- 添加处方用量相关字段 +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值' AFTER `prescription_type`, +ADD COLUMN `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)' AFTER `dosage_amount`, +ADD COLUMN `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)' AFTER `dosage_unit`; +``` + +### 执行方式 +```bash +mysql -u用户名 -p数据库名 < add_prescription_dosage_fields.sql +``` + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +|--------|------|--------|------| +| `dosage_amount` | decimal(10,2) | NULL | 用量数值，支持小数 | +| `dosage_unit` | varchar(10) | '' | 用量单位 (g/ml) | +| `need_decoction` | tinyint(1) | 0 | 是否代煎 (0=否, 1=是) | + +## 2. 后端实现 + +### 2.1 模型层 (Model) +**文件**: `server/app/common/model/tcm/Prescription.php` + +```php +class Prescription extends BaseModel +{ + // ... 其他配置 + + // 字段类型转换 + protected $type = [ + 'dosage_amount' => 'float', + 'need_decoction' => 'integer', + ]; +} +``` + +**作用**: 自动将数据库字段转换为正确的PHP类型。 + +### 2.2 业务逻辑层 (Logic) +**文件**: `server/app/adminapi/logic/tcm/PrescriptionLogic.php` + +#### add() 方法 - 添加处方 +```php +$data = [ + // ... 其他字段 + 'prescription_type' => $params['prescription_type'] ?? '浓缩水丸', + 'dosage_amount' => isset($params['dosage_amount']) ? (float)$params['dosage_amount'] : null, + 'dosage_unit' => $params['dosage_unit'] ?? '', + 'need_decoction' => (int)($params['need_decoction'] ?? 0), + // ... 其他字段 +]; +``` + +#### edit() 方法 - 编辑处方 +```php +$data = [ + // ... 其他字段 + 'prescription_type' => $params['prescription_type'] ?? $prescription->prescription_type, + 'dosage_amount' => isset($params['dosage_amount']) ? (float)$params['dosage_amount'] : $prescription->dosage_amount, + 'dosage_unit' => $params['dosage_unit'] ?? $prescription->dosage_unit, + 'need_decoction' => isset($params['need_decoction']) ? (int)$params['need_decoction'] : (int)($prescription->need_decoction ?? 0), + // ... 其他字段 +]; +``` + +## 3. 前端实现 + +### 3.1 TypeScript 接口 +**文件**: `admin/src/components/tcm-prescription/index.vue` + +```typescript +interface PrescriptionForm { + // ... 其他字段 + prescription_type: string + dosage_amount: number | undefined + dosage_unit: string + need_decoction: boolean + // ... 其他字段 +} +``` + +### 3.2 响应式数据 +```typescript +const formData = reactive({ + // ... 其他字段 + prescription_type: '浓缩水丸', + dosage_amount: 1, + dosage_unit: 'g', + need_decoction: false, + // ... 其他字段 +}) +``` + +### 3.3 自动切换逻辑 +```typescript +watch(() => formData.prescription_type, (newType) => { + if (newType === '浓缩水丸') { + formData.dosage_unit = 'g' + formData.dosage_amount = 1 + formData.need_decoction = false + } else if (newType === '饮片') { + formData.dosage_unit = 'ml' + formData.dosage_amount = 50 + } else { + formData.dosage_unit = 'g' + formData.dosage_amount = undefined + formData.need_decoction = false + } +}) +``` + +## 4. 数据流转 + +### 4.1 保存流程 +``` +前端表单 + ↓ +{ + prescription_type: "浓缩水丸", + dosage_amount: 5, + dosage_unit: "g", + need_decoction: false +} + ↓ +后端 PrescriptionLogic::add() + ↓ +数据库 zyt_tcm_prescription + ↓ +dosage_amount: 5.00 +dosage_unit: "g" +need_decoction: 0 +``` + +### 4.2 读取流程 +``` +数据库查询 + ↓ +Prescription Model (类型转换) + ↓ +{ + dosage_amount: 5.0, // float + dosage_unit: "g", // string + need_decoction: 0 // int +} + ↓ +前端接收 + ↓ +{ + dosage_amount: 5, + dosage_unit: "g", + need_decoction: false +} +``` + +## 5. 数据示例 + +### 5.1 浓缩水丸处方 +```json +{ + "prescription_type": "浓缩水丸", + "dosage_amount": 5.00, + "dosage_unit": "g", + "need_decoction": 0 +} +``` + +### 5.2 饮片处方（代煎） +```json +{ + "prescription_type": "饮片", + "dosage_amount": 150.00, + "dosage_unit": "ml", + "need_decoction": 1 +} +``` + +### 5.3 颗粒处方 +```json +{ + "prescription_type": "颗粒", + "dosage_amount": 15.50, + "dosage_unit": "g", + "need_decoction": 0 +} +``` + +## 6. 部署步骤 + +### 步骤 1: 备份数据库 +```bash +mysqldump -u用户名 -p数据库名 > backup_$(date +%Y%m%d_%H%M%S).sql +``` + +### 步骤 2: 执行数据库迁移 +```bash +mysql -u用户名 -p数据库名 < add_prescription_dosage_fields.sql +``` + +### 步骤 3: 验证字段添加 +```sql +SHOW COLUMNS FROM `zyt_tcm_prescription` LIKE 'dosage%'; +SHOW COLUMNS FROM `zyt_tcm_prescription` LIKE 'need_decoction'; +``` + +### 步骤 4: 部署后端代码 +```bash +# 上传修改的文件 +- server/app/common/model/tcm/Prescription.php +- server/app/adminapi/logic/tcm/PrescriptionLogic.php +``` + +### 步骤 5: 部署前端代码 +```bash +# 构建前端 +cd admin +npm run build + +# 上传构建产物 +# 上传 dist/ 目录到服务器 +``` + +### 步骤 6: 清除缓存（如需要） +```bash +cd server +php think clear +``` + +### 步骤 7: 测试功能 +1. 创建新处方，选择不同类型 +2. 验证用量字段正确保存 +3. 编辑处方，验证数据正确加载 +4. 查看处方详情，验证显示正确 + +## 7. 数据验证 + +### 7.1 前端验证 +```typescript +// 浓缩水丸：1-10g +if (formData.prescription_type === '浓缩水丸') { + if (formData.dosage_amount < 1 || formData.dosage_amount > 10) { + // 错误提示 + } +} + +// 饮片：50-250ml，步进50 +if (formData.prescription_type === '饮片') { + if (formData.dosage_amount % 50 !== 0) { + // 错误提示 + } +} +``` + +### 7.2 后端验证（建议添加） +```php +// 在 PrescriptionLogic::add() 中添加 +if ($params['prescription_type'] === '浓缩水丸') { + $amount = (float)($params['dosage_amount'] ?? 0); + if ($amount < 1 || $amount > 10) { + self::setError('浓缩水丸用量必须在1-10g之间'); + return null; + } +} + +if ($params['prescription_type'] === '饮片') { + $amount = (float)($params['dosage_amount'] ?? 0); + if ($amount < 50 || $amount > 250 || $amount % 50 !== 0) { + self::setError('饮片用量必须为50-250ml，且为50的倍数'); + return null; + } +} +``` + +## 8. 常见问题 + +### Q1: 字段已存在错误 +``` +ERROR 1060 (42S21): Duplicate column name 'dosage_amount' +``` +**解决**: 字段已存在，跳过此步骤或先删除字段再添加。 + +### Q2: 旧数据如何处理？ +**方案**: 旧数据的 `dosage_amount` 为 NULL，前端显示为空，不影响功能。 + +### Q3: 如何批量更新旧数据？ +```sql +-- 为浓缩水丸类型设置默认用量 +UPDATE `zyt_tcm_prescription` +SET + `dosage_amount` = 1, + `dosage_unit` = 'g' +WHERE `prescription_type` = '浓缩水丸' + AND `dosage_amount` IS NULL; + +-- 为饮片类型设置默认用量 +UPDATE `zyt_tcm_prescription` +SET + `dosage_amount` = 50, + `dosage_unit` = 'ml' +WHERE `prescription_type` = '饮片' + AND `dosage_amount` IS NULL; +``` + +## 9. 回滚方案 + +如果需要回滚，执行以下SQL： + +```sql +-- 删除添加的字段 +ALTER TABLE `zyt_tcm_prescription` +DROP COLUMN `dosage_amount`, +DROP COLUMN `dosage_unit`, +DROP COLUMN `need_decoction`; +``` + +## 10. 相关文件清单 + +### 数据库 +- `add_prescription_dosage_fields.sql` - 数据库迁移文件 + +### 后端 +- `server/app/common/model/tcm/Prescription.php` - 处方模型 +- `server/app/adminapi/logic/tcm/PrescriptionLogic.php` - 处方业务逻辑 + +### 前端 +- `admin/src/components/tcm-prescription/index.vue` - 处方组件 + +### 文档 +- `PRESCRIPTION_DOSAGE_FEATURE.md` - 功能说明文档 +- `PRESCRIPTION_DOSAGE_DATABASE_IMPLEMENTATION.md` - 本文档 + +## 11. 测试清单 + +- [ ] 数据库字段添加成功 +- [ ] 创建浓缩水丸处方，用量1-10g +- [ ] 创建饮片处方，用量50-250ml +- [ ] 饮片处方代煎选项正常 +- [ ] 编辑处方，数据正确加载 +- [ ] 切换处方类型，用量自动调整 +- [ ] 保存处方，数据正确存储 +- [ ] 查看处方详情，显示正确 +- [ ] 旧数据兼容性测试 + +## 总结 + +此实现完整覆盖了从数据库到前端的所有层次： +1. ✅ 数据库字段添加 +2. ✅ 模型层类型转换 +3. ✅ 业务逻辑层数据处理 +4. ✅ 前端表单交互 +5. ✅ 自动切换逻辑 +6. ✅ 数据验证 + +所有代码已实现，只需执行数据库迁移即可使用！ diff --git a/PRESCRIPTION_DOSAGE_FEATURE.md b/PRESCRIPTION_DOSAGE_FEATURE.md new file mode 100644 index 00000000..b09fa50d --- /dev/null +++ b/PRESCRIPTION_DOSAGE_FEATURE.md @@ -0,0 +1,307 @@ +# 处方用量功能实现 + +## 概述 +根据处方类型自动调整用量单位和范围，并为饮片类型添加代煎选项。 + +## 功能说明 + +### 1. 浓缩水丸 +- **单位**: g (克) +- **范围**: 1-10g +- **步进**: 1g +- **默认值**: 1g + +### 2. 饮片 +- **单位**: ml (毫升) +- **范围**: 50-250ml +- **步进**: 50ml (每50ml一个单位) +- **默认值**: 50ml +- **特殊选项**: 是否代煎（代煎/不代煎） + +### 3. 其他类型（颗粒、丸剂、散剂、膏方、汤剂） +- **单位**: g (克) +- **范围**: 不限制 +- **精度**: 小数点后2位 +- **默认值**: 无 + +## 前端实现 + +### 文件：`admin/src/components/tcm-prescription/index.vue` + +#### 1. TypeScript 接口 +```typescript +interface PrescriptionForm { + // ... 其他字段 + prescription_type: string // 处方类型 + dosage_amount: number | undefined // 用量数值 + dosage_unit: string // 用量单位 (g 或 ml) + need_decoction: boolean // 是否代煎（仅饮片） + // ... +} +``` + +#### 2. 响应式数据 +```typescript +const formData = reactive({ + // ... + prescription_type: '浓缩水丸', + dosage_amount: 1, + dosage_unit: 'g', + need_decoction: false, + // ... +}) +``` + +#### 3. 自动切换逻辑 +```typescript +watch(() => formData.prescription_type, (newType) => { + if (newType === '浓缩水丸') { + formData.dosage_unit = 'g' + formData.dosage_amount = 1 + formData.need_decoction = false + } else if (newType === '饮片') { + formData.dosage_unit = 'ml' + formData.dosage_amount = 50 + // need_decoction 保持用户选择 + } else { + formData.dosage_unit = 'g' + formData.dosage_amount = undefined + formData.need_decoction = false + } +}) +``` + +#### 4. UI 组件 +```vue + + + + + + + + + + {{ formData.dosage_unit }} + + + + + + + + 代煎 + 不代煎 + + + +``` + +## 用户交互流程 + +### 场景 1：选择浓缩水丸 +1. 用户选择"浓缩水丸" +2. 系统自动设置： + - 用量单位：g + - 默认用量：1g + - 用量范围：1-10g + - 隐藏代煎选项 + +### 场景 2：选择饮片 +1. 用户选择"饮片" +2. 系统自动设置： + - 用量单位：ml + - 默认用量：50ml + - 用量范围：50-250ml（步进50ml） + - 显示代煎选项（默认"不代煎"） +3. 用户可选择： + - 用量：50ml, 100ml, 150ml, 200ml, 250ml + - 是否代煎：代煎 / 不代煎 + +### 场景 3：选择其他类型 +1. 用户选择"颗粒"、"丸剂"等 +2. 系统自动设置： + - 用量单位：g + - 默认用量：空 + - 用量范围：不限制（可输入小数） + - 隐藏代煎选项 + +## 数据示例 + +### 浓缩水丸处方 +```json +{ + "prescription_type": "浓缩水丸", + "dosage_amount": 5, + "dosage_unit": "g", + "need_decoction": false +} +``` + +### 饮片处方（代煎） +```json +{ + "prescription_type": "饮片", + "dosage_amount": 150, + "dosage_unit": "ml", + "need_decoction": true +} +``` + +### 饮片处方（不代煎） +```json +{ + "prescription_type": "饮片", + "dosage_amount": 200, + "dosage_unit": "ml", + "need_decoction": false +} +``` + +### 颗粒处方 +```json +{ + "prescription_type": "颗粒", + "dosage_amount": 15.5, + "dosage_unit": "g", + "need_decoction": false +} +``` + +## 后端存储建议 + +### 数据库字段 +建议在处方表中添加以下字段： + +```sql +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值', +ADD COLUMN `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)', +ADD COLUMN `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)'; +``` + +### 后端验证逻辑 +```php +// 浓缩水丸验证 +if ($prescriptionType === '浓缩水丸') { + if ($dosageAmount < 1 || $dosageAmount > 10) { + throw new Exception('浓缩水丸用量必须在1-10g之间'); + } + if ($dosageUnit !== 'g') { + throw new Exception('浓缩水丸单位必须为g'); + } +} + +// 饮片验证 +if ($prescriptionType === '饮片') { + if ($dosageAmount < 50 || $dosageAmount > 250 || $dosageAmount % 50 !== 0) { + throw new Exception('饮片用量必须为50-250ml，且为50的倍数'); + } + if ($dosageUnit !== 'ml') { + throw new Exception('饮片单位必须为ml'); + } +} +``` + +## UI 布局 + +``` +┌─────────────────────────────────────────────────────────┐ +│ 处方类型: [浓缩水丸 ▼] 用量: [1] g │ +└─────────────────────────────────────────────────────────┘ + +┌─────────────────────────────────────────────────────────┐ +│ 处方类型: [饮片 ▼] 用量: [150] ml │ +│ 是否代煎: ⦿ 代煎 ○ 不代煎 │ +└─────────────────────────────────────────────────────────┘ + +┌─────────────────────────────────────────────────────────┐ +│ 处方类型: [颗粒 ▼] 用量: [15.5] g │ +└─────────────────────────────────────────────────────────┘ +``` + +## 业务规则 + +### 1. 浓缩水丸 +- 用于浓缩制剂，按克计量 +- 通常用量较小，1-10g范围合理 +- 不需要代煎 + +### 2. 饮片 +- 用于传统中药饮片 +- 按煎煮后的药液体积计量（ml） +- 每次50ml为一个标准单位 +- 可选择是否由药房代煎 +- 代煎：药房负责煎煮，患者直接服用 +- 不代煎：患者自行煎煮 + +### 3. 其他类型 +- 根据实际情况灵活设置用量 +- 支持小数点精度 + +## 注意事项 + +1. **单位自动切换**：切换处方类型时，单位和默认值会自动更新 +2. **代煎选项**：仅在选择"饮片"时显示 +3. **用量限制**：不同类型有不同的用量范围限制 +4. **数据验证**：前端和后端都应进行用量范围验证 +5. **用户体验**：使用 `el-input-number` 组件，支持键盘上下键调整 + +## 扩展建议 + +1. **价格联动**：根据用量自动计算处方价格 +2. **库存检查**：代煎选项可关联药房库存 +3. **历史记录**：记录患者常用的用量设置 +4. **模板保存**：将用量设置保存到处方模板 +5. **打印显示**：在处方打印时显示用量和代煎信息 + +## 相关文件 + +- `admin/src/components/tcm-prescription/index.vue` - 处方组件主文件 + +## 测试用例 + +### 测试 1：浓缩水丸用量 +- 选择"浓缩水丸" +- 验证用量范围：1-10g +- 验证步进：1g +- 验证代煎选项隐藏 + +### 测试 2：饮片用量 +- 选择"饮片" +- 验证用量范围：50-250ml +- 验证步进：50ml +- 验证代煎选项显示 +- 测试代煎/不代煎切换 + +### 测试 3：类型切换 +- 从"浓缩水丸"切换到"饮片" +- 验证单位从g变为ml +- 验证用量自动调整 +- 验证代煎选项出现 + +### 测试 4：数据保存 +- 填写完整处方信息 +- 保存处方 +- 验证用量数据正确存储 +- 验证代煎选项正确存储 diff --git a/PRESCRIPTION_FIELDS_FIX_SUMMARY.md b/PRESCRIPTION_FIELDS_FIX_SUMMARY.md new file mode 100644 index 00000000..eb3c0f80 --- /dev/null +++ b/PRESCRIPTION_FIELDS_FIX_SUMMARY.md @@ -0,0 +1,251 @@ +# 处方字段完整修复总结 + +## 问题描述 +前端添加了新字段（用量、代煎、每天几次），但后端没有相应处理，导致编辑保存时数据丢失。 + +## 修复内容 + +### 1. 数据库字段 ✅ + +**文件**: `add_prescription_complete_fields.sql` + +```sql +-- 用量相关字段 +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN IF NOT EXISTS `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值', +ADD COLUMN IF NOT EXISTS `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)', +ADD COLUMN IF NOT EXISTS `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)'; + +-- 每天几次字段 +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN IF NOT EXISTS `times_per_day` int(11) NOT NULL DEFAULT 2 COMMENT '每天服用次数'; +``` + +### 2. 后端修复 ✅ + +#### 文件: `server/app/adminapi/logic/tcm/PrescriptionLogic.php` + +**add() 方法** - 添加处方时保存新字段: +```php +'dosage_amount' => isset($params['dosage_amount']) ? (float)$params['dosage_amount'] : null, +'dosage_unit' => $params['dosage_unit'] ?? '', +'need_decoction' => (int)($params['need_decoction'] ?? 0), +'times_per_day' => (int)($params['times_per_day'] ?? 2), +``` + +**edit() 方法** - 编辑处方时更新新字段: +```php +'dosage_amount' => isset($params['dosage_amount']) ? (float)$params['dosage_amount'] : $prescription->dosage_amount, +'dosage_unit' => $params['dosage_unit'] ?? $prescription->dosage_unit, +'need_decoction' => isset($params['need_decoction']) ? (int)$params['need_decoction'] : (int)($prescription->need_decoction ?? 0), +'times_per_day' => (int)($params['times_per_day'] ?? $prescription->times_per_day ?? 2), +``` + +### 3. 前端修复 ✅ + +#### 文件: `admin/src/views/consumer/prescription/index.vue` + +**editForm 定义** - 添加新字段: +```typescript +const editForm = reactive({ + // ... + dosage_amount: 1 as number | undefined, + dosage_unit: 'g', + need_decoction: false, + times_per_day: 2, + // ... +}) +``` + +**handleEdit() 方法** - 加载数据时填充新字段: +```typescript +editForm.dosage_amount = row.dosage_amount ?? undefined +editForm.dosage_unit = row.dosage_unit || '' +editForm.need_decoction = row.need_decoction === 1 || row.need_decoction === true +editForm.times_per_day = row.times_per_day ?? 2 +``` + +**watch 监听** - 处方类型变化时自动调整: +```typescript +watch(() => editForm.prescription_type, (newType) => { + if (newType === '浓缩水丸') { + editForm.dosage_unit = 'g' + editForm.dosage_amount = 1 + editForm.need_decoction = false + } else if (newType === '饮片') { + editForm.dosage_unit = 'ml' + editForm.dosage_amount = 50 + } else { + editForm.dosage_unit = 'g' + editForm.dosage_amount = undefined + editForm.need_decoction = false + } +}) +``` + +## 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +|--------|------|--------|------| +| `dosage_amount` | decimal(10,2) | NULL | 用量数值 | +| `dosage_unit` | varchar(10) | '' | 用量单位 (g/ml) | +| `need_decoction` | tinyint(1) | 0 | 是否代煎 (0=否, 1=是) | +| `times_per_day` | int(11) | 2 | 每天服用次数 | + +## 数据流转 + +### 创建处方 +``` +前端表单 + ↓ +{ + prescription_type: "浓缩水丸", + dosage_amount: 5, + dosage_unit: "g", + need_decoction: false, + times_per_day: 2 +} + ↓ +PrescriptionLogic::add() + ↓ +数据库保存 +``` + +### 编辑处方 +``` +数据库读取 + ↓ +{ + dosage_amount: 5.00, + dosage_unit: "g", + need_decoction: 0, + times_per_day: 2 +} + ↓ +前端 editForm 填充 + ↓ +用户修改 + ↓ +PrescriptionLogic::edit() + ↓ +数据库更新 +``` + +## 部署步骤 + +### 1. 备份数据库 ⚠️ +```bash +mysqldump -u用户名 -p数据库名 > backup_$(date +%Y%m%d_%H%M%S).sql +``` + +### 2. 执行数据库迁移 ⚠️ 必须 +```bash +mysql -u用户名 -p数据库名 < add_prescription_complete_fields.sql +``` + +### 3. 验证字段添加 +```sql +SHOW COLUMNS FROM `zyt_tcm_prescription` LIKE 'dosage%'; +SHOW COLUMNS FROM `zyt_tcm_prescription` LIKE 'need_decoction'; +SHOW COLUMNS FROM `zyt_tcm_prescription` LIKE 'times_per_day'; +``` + +### 4. 部署后端代码 +```bash +# 上传修改的文件 +- server/app/adminapi/logic/tcm/PrescriptionLogic.php +- server/app/common/model/tcm/Prescription.php +``` + +### 5. 部署前端代码 +```bash +cd admin +npm run build +# 上传 dist/ 目录 +``` + +### 6. 清除缓存（如需要） +```bash +cd server +php think clear +``` + +## 测试清单 + +### 创建处方测试 +- [ ] 创建浓缩水丸处方，设置用量5g，每天2次 +- [ ] 创建饮片处方，设置用量150ml，代煎，每天3次 +- [ ] 创建颗粒处方，设置用量15.5g，每天2次 +- [ ] 保存后查看数据库，验证字段正确存储 + +### 编辑处方测试 +- [ ] 编辑已有处方，修改用量 +- [ ] 编辑饮片处方，修改代煎选项 +- [ ] 编辑处方，修改每天几次 +- [ ] 切换处方类型，验证用量自动调整 +- [ ] 保存后查看数据库，验证字段正确更新 + +### 数据加载测试 +- [ ] 打开编辑对话框，验证用量正确显示 +- [ ] 验证代煎选项正确显示 +- [ ] 验证每天几次正确显示 +- [ ] 验证旧数据（无新字段）不报错 + +## 修复的问题 + +### 问题 1: 用量字段不保存 ✅ +**原因**: 后端 `add()` 和 `edit()` 方法没有处理 `dosage_amount`, `dosage_unit`, `need_decoction` 字段 +**修复**: 在两个方法中添加字段处理逻辑 + +### 问题 2: 每天几次不保存 ✅ +**原因**: +1. 数据库没有 `times_per_day` 字段 +2. 后端没有处理该字段 +3. 前端 editForm 定义错误（空字符串而非数字） + +**修复**: +1. 添加数据库字段 +2. 后端添加字段处理 +3. 前端修正默认值为数字 2 + +### 问题 3: 编辑时数据不加载 ✅ +**原因**: `handleEdit()` 方法没有加载新字段 +**修复**: 在加载数据时填充所有新字段 + +## 相关文件 + +### 数据库 +- `add_prescription_complete_fields.sql` - 完整字段迁移文件 + +### 后端 +- `server/app/adminapi/logic/tcm/PrescriptionLogic.php` - 处方业务逻辑 +- `server/app/common/model/tcm/Prescription.php` - 处方模型 + +### 前端 +- `admin/src/components/tcm-prescription/index.vue` - 处方组件 +- `admin/src/views/consumer/prescription/index.vue` - 处方列表 + +### 文档 +- `PRESCRIPTION_DOSAGE_FEATURE.md` - 功能说明 +- `PRESCRIPTION_DOSAGE_DATABASE_IMPLEMENTATION.md` - 数据库实现 +- `PRESCRIPTION_DOSAGE_COMPLETE_SUMMARY.md` - 完整总结 +- `PRESCRIPTION_FIELDS_FIX_SUMMARY.md` - 本文档 + +## 注意事项 + +1. **必须先执行数据库迁移**，否则保存时会报错 +2. **旧数据兼容**：旧处方的新字段为 NULL 或默认值，不影响显示 +3. **类型转换**： + - `dosage_amount`: float + - `need_decoction`: boolean (前端) → int (后端/数据库) + - `times_per_day`: int +4. **数据验证**：前端使用下拉和数字输入框确保数据有效性 + +## 总结 + +✅ **数据库**: 4个字段已添加 +✅ **后端**: add() 和 edit() 方法已更新 +✅ **前端**: editForm 定义和数据加载已修复 +✅ **数据流转**: 完整的保存和读取流程 + +**状态**: 所有问题已修复，功能完整可用！🎉 diff --git a/PRESCRIPTION_TIMES_PER_DAY_FEATURE.md b/PRESCRIPTION_TIMES_PER_DAY_FEATURE.md new file mode 100644 index 00000000..3af9b8b3 --- /dev/null +++ b/PRESCRIPTION_TIMES_PER_DAY_FEATURE.md @@ -0,0 +1,199 @@ +# 处方"每天几次"功能添加说明 + +## 功能描述 + +在中医处方单中添加"每天几次"字段，用于记录患者每天需要服用药物的次数。 + +## 修改内容 + +### 1. 表单界面（admin/src/components/tcm-prescription/index.vue） + +#### 添加表单字段（第 139-145 行） + +在"服用天数"字段后面添加"每天几次"输入框： + +```vue + + + + + + + + + + +``` + +**字段说明：** +- 字段名：`times_per_day` +- 类型：数字输入框 +- 最小值：1 +- 最大值：10 +- 默认值：2 + +### 2. TypeScript 类型定义（第 580-615 行） + +在 `PrescriptionForm` 接口中添加字段： + +```typescript +interface PrescriptionForm { + // ... 其他字段 + usage_days: number + times_per_day: number // 新增 + usage_instruction: string + // ... 其他字段 +} +``` + +### 3. 数据模型初始化（第 650-680 行） + +在 `formData` 中添加默认值： + +```typescript +const formData = reactive({ + // ... 其他字段 + usage_days: 7, + times_per_day: 2, // 新增，默认每天2次 + usage_instruction: '水煎服，一日二次', + // ... 其他字段 +}) +``` + +### 4. 处方预览显示（第 280-285 行） + +在处方打印预览中显示"每天几次"信息： + +```vue +
+ 服用{{ savedPrescription.usage_days || savedPrescription.dose_count }}天{{ savedPrescription.times_per_day ? '，每天' + savedPrescription.times_per_day + '次' : '' }}, {{ savedPrescription.prescription_type }} + {{ savedPrescription.usage_instruction }} +
+``` + +**显示效果：** +- 如果设置了 `times_per_day`：显示"服用7天，每天2次, 浓缩水丸 水煎服，一日二次" +- 如果未设置：显示"服用7天, 浓缩水丸 水煎服，一日二次" + +## 后端数据库支持 + +### 需要添加的数据库字段 + +如果后端数据库表中还没有 `times_per_day` 字段，需要执行以下 SQL： + +```sql +-- 在处方表中添加 times_per_day 字段 +ALTER TABLE `zyt_prescription` +ADD COLUMN `times_per_day` INT(11) DEFAULT 2 COMMENT '每天服用次数' AFTER `usage_days`; + +-- 如果需要更新现有数据的默认值 +UPDATE `zyt_prescription` SET `times_per_day` = 2 WHERE `times_per_day` IS NULL; +``` + +### 后端 API 修改 + +确保后端接口支持 `times_per_day` 字段： + +1. **创建/更新处方接口**：接收 `times_per_day` 参数 +2. **查询处方接口**：返回 `times_per_day` 字段 +3. **验证规则**：`times_per_day` 应该在 1-10 之间 + +## 使用说明 + +### 医生操作流程 + +1. 打开处方单编辑界面 +2. 填写患者信息和诊断信息 +3. 添加中药处方 +4. 在"服用天数"字段输入天数（如：7） +5. 在"每天几次"字段输入次数（如：2） +6. 系统会在处方预览中显示："服用7天，每天2次" + +### 常见用法 + +- **每天2次**：早晚各一次（最常见） +- **每天3次**：早中晚各一次 +- **每天1次**：每日一次 +- **每天4次**：每6小时一次 + +## 测试要点 + +### 前端测试 + +1. ✅ 输入框显示正常 +2. ✅ 最小值限制（不能小于1） +3. ✅ 最大值限制（不能大于10） +4. ✅ 默认值为2 +5. ✅ 预览显示正确 +6. ✅ 保存后数据正确 + +### 后端测试 + +1. ✅ 创建处方时保存 `times_per_day` +2. ✅ 更新处方时更新 `times_per_day` +3. ✅ 查询处方时返回 `times_per_day` +4. ✅ 数据验证（1-10范围） + +### 集成测试 + +1. ✅ 创建处方 → 保存 → 查看预览 → 确认显示正确 +2. ✅ 编辑处方 → 修改次数 → 保存 → 确认更新成功 +3. ✅ 打印处方 → 确认打印内容包含"每天X次" + +## 界面效果 + +### 编辑界面 + +``` +┌─────────────────────────────────────────────────┐ +│ 处方类型: [浓缩水丸 ▼] │ +├─────────────────────────────────────────────────┤ +│ 服用天数: [ 7 ] 每天几次: [ 2 ] │ +├─────────────────────────────────────────────────┤ +│ 用法: 水煎服，一日二次 │ +└─────────────────────────────────────────────────┘ +``` + +### 预览界面 + +``` +服用7天，每天2次, 浓缩水丸 水煎服，一日二次 +服用时间: 饭前 服用方式: 温水送服 +``` + +## 注意事项 + +1. **默认值**：新建处方时默认为每天2次（最常见的用法） +2. **范围限制**：限制在1-10次之间，超出范围的输入会被自动调整 +3. **可选字段**：如果不填写，预览中不会显示"每天X次" +4. **与用法说明的关系**：`times_per_day` 是结构化数据，`usage_instruction` 是文字描述，两者可以互补 + +## 兼容性 + +- ✅ 兼容现有处方数据（旧数据没有此字段时不显示） +- ✅ 不影响现有功能 +- ✅ 向后兼容 + +## 后续优化建议 + +1. **智能提示**：根据处方类型自动推荐合适的服用次数 +2. **关联验证**：与"用法"字段进行一致性检查 +3. **统计分析**：统计不同处方类型的常用服用次数 +4. **模板支持**：在处方模板中包含 `times_per_day` 字段 + +## 完成状态 + +- ✅ 前端界面添加完成 +- ✅ 数据模型更新完成 +- ✅ 类型定义更新完成 +- ✅ 预览显示更新完成 +- ⏳ 等待后端数据库字段添加 +- ⏳ 等待后端 API 支持 + +## 相关文件 + +- `admin/src/components/tcm-prescription/index.vue` - 处方组件主文件 +- 后端需要修改的文件（待确认）： + - 处方模型文件 + - 处方控制器文件 + - 数据库迁移文件 diff --git a/REGION_SELECTOR_FEATURE.md b/REGION_SELECTOR_FEATURE.md new file mode 100644 index 00000000..b74e3a81 --- /dev/null +++ b/REGION_SELECTOR_FEATURE.md @@ -0,0 +1,357 @@ +# 省市区选择器功能说明 + +## 功能描述 + +在创建处方业务订单时，添加省市区级联选择器，方便用户选择收货地址的省市区信息。 + +## 修改内容 + +### 1. 表单界面（admin/src/views/consumer/prescription/index.vue） + +#### 添加省市区选择器（第 792-810 行） + +```vue + + + + + + + + + + + + + + + +``` + +**组件配置说明：** +- `v-model="createOrderForm.region"`：绑定选中的省市区数组 +- `:options="regionOptions"`：省市区数据源 +- `value: 'name'`：使用 name 字段作为值 +- `label: 'name'`：使用 name 字段作为显示文本 +- `emitPath: false`：只返回最后一级的值（区/县） +- `checkStrictly: false`：必须选择到最后一级 +- `clearable`：可清空 +- `filterable`：可搜索 + +### 2. 数据模型更新（第 1175-1195 行） + +```typescript +const createOrderForm = reactive({ + patient_id: '' as number | string, + recipient_name: '', + recipient_phone: '', + region: [] as string[], // 新增：省市区数组 + shipping_address: '', // 改为详细地址 + // ... 其他字段 +}) +``` + +### 3. 省市区数据（第 1195-1340 行） + +添加了常用省市区数据： +- 四川省（成都市、绵阳市） +- 北京市 +- 上海市 +- 广东省（广州市、深圳市） + +```typescript +const regionOptions = ref([ + { + name: '四川省', + children: [ + { + name: '成都市', + children: [ + { name: '锦江区' }, + { name: '青羊区' }, + // ... 更多区县 + ] + } + ] + }, + // ... 更多省份 +]) +``` + +### 4. 事件处理方法 + +```typescript +const handleRegionChange = (value: string[]) => { + console.log('选择的省市区：', value) +} +``` + +## 使用说明 + +### 用户操作流程 + +1. 点击"创建业务订单"按钮 +2. 选择诊单患者 +3. 填写收货人和收货手机 +4. **点击"省市区"选择器** +5. 依次选择：省 → 市 → 区/县 +6. 在"详细地址"中填写街道、门牌号等信息 +7. 填写其他订单信息 +8. 提交订单 + +### 界面效果 + +**编辑时：** +``` +┌─────────────────────────────────────────────────┐ +│ 收货人: [张三] 收货手机: [138****0000] │ +├─────────────────────────────────────────────────┤ +│ 省市区: [四川省 / 成都市 / 双流区 ▼] │ +├─────────────────────────────────────────────────┤ +│ 详细地址: │ +│ ┌─────────────────────────────────────────────┐ │ +│ │ 黄甲街道黄龙大道二段280号 │ │ +│ └─────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────┘ +``` + +**完整地址组合：** +``` +四川省成都市双流区黄甲街道黄龙大道二段280号 +``` + +## 后端支持 + +### 数据库字段建议 + +如果需要单独存储省市区信息，可以添加以下字段： + +```sql +-- 在 prescription_order 表中添加省市区字段 +ALTER TABLE `zyt_prescription_order` +ADD COLUMN `province` VARCHAR(50) DEFAULT '' COMMENT '省份' AFTER `recipient_phone`, +ADD COLUMN `city` VARCHAR(50) DEFAULT '' COMMENT '城市' AFTER `province`, +ADD COLUMN `district` VARCHAR(50) DEFAULT '' COMMENT '区/县' AFTER `city`; + +-- 或者保持现有的 shipping_address 字段，前端组合完整地址 +``` + +### 后端 API 修改 + +#### 方案 A：前端组合完整地址（推荐） + +前端在提交时将省市区和详细地址组合： + +```typescript +const submitOrder = async () => { + const fullAddress = createOrderForm.region.join('') + createOrderForm.shipping_address + + await createPrescriptionOrder({ + ...createOrderForm, + shipping_address: fullAddress // 四川省成都市双流区黄甲街道... + }) +} +``` + +#### 方案 B：分别存储省市区 + +后端接收独立的省市区字段： + +```php +// 创建订单时 +$order->province = $params['province'] ?? ''; +$order->city = $params['city'] ?? ''; +$order->district = $params['district'] ?? ''; +$order->shipping_address = $params['shipping_address'] ?? ''; + +// 查询时返回 +return [ + 'province' => $order->province, + 'city' => $order->city, + 'district' => $order->district, + 'shipping_address' => $order->shipping_address, + 'full_address' => $order->province . $order->city . $order->district . $order->shipping_address +]; +``` + +## 扩展功能 + +### 1. 使用完整的省市区数据 + +当前只包含了部分常用省市区，实际项目中应该使用完整的数据。 + +**方案 A：使用 npm 包** + +```bash +npm install element-china-area-data +``` + +```typescript +import { regionData } from 'element-china-area-data' + +const regionOptions = ref(regionData) +``` + +**方案 B：从后端 API 获取** + +```typescript +import { getRegionTree } from '@/api/common' + +const regionOptions = ref([]) + +onMounted(async () => { + const res = await getRegionTree() + regionOptions.value = res.data +}) +``` + +### 2. 自动填充历史地址 + +根据患者历史订单自动填充地址： + +```typescript +const loadPatientLastAddress = async (patientId: number) => { + const res = await getPatientLastOrder(patientId) + if (res.data) { + createOrderForm.region = [res.data.province, res.data.city, res.data.district] + createOrderForm.shipping_address = res.data.detail_address + createOrderForm.recipient_name = res.data.recipient_name + createOrderForm.recipient_phone = res.data.recipient_phone + } +} +``` + +### 3. 地址簿功能 + +保存常用地址，快速选择： + +```vue + + + +``` + +### 4. 地址验证 + +验证地址的完整性和合法性： + +```typescript +const validateAddress = () => { + if (createOrderForm.region.length !== 3) { + feedback.msgError('请选择完整的省市区') + return false + } + if (!createOrderForm.shipping_address.trim()) { + feedback.msgError('请填写详细地址') + return false + } + return true +} +``` + +## 注意事项 + +1. **数据格式**： + - `region` 是数组：`['四川省', '成都市', '双流区']` + - 提交时需要组合成完整地址字符串 + +2. **必填验证**： + - 省市区选择器应该设置为必填 + - 详细地址也应该必填 + +3. **字符限制**： + - 详细地址限制 200 字符 + - 建议省市区 + 详细地址总长度不超过 250 字符 + +4. **兼容性**： + - 兼容现有的 `shipping_address` 字段 + - 旧数据可能没有省市区信息，需要做好兼容处理 + +5. **性能优化**： + - 省市区数据较大时，考虑懒加载 + - 使用虚拟滚动优化长列表 + +## 表单验证规则 + +更新验证规则： + +```typescript +const createOrderRules: FormRules = { + // ... 其他规则 + region: [ + { + required: true, + message: '请选择省市区', + trigger: 'change', + validator: (rule, value, callback) => { + if (!value || value.length !== 3) { + callback(new Error('请选择完整的省市区')) + } else { + callback() + } + } + } + ], + shipping_address: [ + { required: true, message: '请输入详细地址', trigger: 'blur' }, + { min: 5, message: '详细地址至少5个字符', trigger: 'blur' } + ] +} +``` + +## 测试要点 + +### 前端测试 + +1. ✅ 省市区选择器显示正常 +2. ✅ 可以正常选择省市区 +3. ✅ 搜索功能正常 +4. ✅ 清空功能正常 +5. ✅ 必填验证正常 +6. ✅ 数据绑定正确 + +### 集成测试 + +1. ✅ 创建订单 → 选择省市区 → 填写详细地址 → 提交成功 +2. ✅ 查看订单 → 地址显示完整 +3. ✅ 编辑订单 → 省市区回显正确 +4. ✅ 打印订单 → 地址格式正确 + +## 完成状态 + +- ✅ 前端界面添加完成 +- ✅ 数据模型更新完成 +- ✅ 省市区数据添加完成（简化版） +- ✅ 事件处理方法添加完成 +- ⏳ 等待完整省市区数据集成 +- ⏳ 等待后端 API 支持 +- ⏳ 等待表单验证规则更新 + +## 相关文件 + +- `admin/src/views/consumer/prescription/index.vue` - 处方订单列表页面 +- 后端需要修改的文件（待确认）： + - 订单模型文件 + - 订单控制器文件 + - 数据库迁移文件（如果需要单独存储省市区） diff --git a/REVOKE_PRESCRIPTION_AUDIT_FIX.md b/REVOKE_PRESCRIPTION_AUDIT_FIX.md new file mode 100644 index 00000000..8602d400 --- /dev/null +++ b/REVOKE_PRESCRIPTION_AUDIT_FIX.md @@ -0,0 +1,226 @@ +# 撤回处方审核功能修复 + +## 问题描述 +撤回处方审核时，只更新了业务订单表（`zyt_tcm_prescription_order`）的 `prescription_audit_status`，但没有同步更新处方表（`zyt_tcm_prescription`）的 `audit_status`，导致处方表的审核状态不一致。 + +## 影响 +- 业务订单显示"待审核"，但处方表仍显示"已通过" +- 处方列表页面显示的审核状态与实际不符 +- 可能导致业务流程混乱 + +## 修复方案 + +### 文件：`server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` + +在 `revokeRxAudit()` 方法中添加同步处方表审核状态的逻辑： + +```php +// 同步撤回处方表的审核状态 +$prescriptionId = (int) $order->prescription_id; +if ($prescriptionId > 0) { + try { + $prescription = Prescription::where('id', $prescriptionId)->whereNull('delete_time')->find(); + if ($prescription) { + $prescription->audit_status = 0; + $prescription->audit_remark = ''; + $prescription->audit_time = null; + $prescription->audit_by = null; + $prescription->audit_by_name = ''; + $prescription->save(); + } + } catch (\Throwable $e) { + // 记录日志但不影响主流程 + Log::error('撤回处方审核时同步处方表失败: ' . $e->getMessage(), [ + 'prescription_id' => $prescriptionId, + 'order_id' => $id + ]); + } +} +``` + +## 修复内容 + +### 1. 业务订单表更新（原有逻辑） +**表**: `zyt_tcm_prescription_order` + +```php +$order->prescription_audit_status = 0; // 重置为待审核 +$order->prescription_audit_remark = ''; // 清空审核意见 +``` + +### 2. 处方表同步更新（新增逻辑） +**表**: `zyt_tcm_prescription` + +```php +$prescription->audit_status = 0; // 重置为待审核 +$prescription->audit_remark = ''; // 清空审核意见 +$prescription->audit_time = null; // 清空审核时间 +$prescription->audit_by = null; // 清空审核人ID +$prescription->audit_by_name = ''; // 清空审核人姓名 +``` + +## 数据流转 + +### 撤回前 +``` +业务订单表 (zyt_tcm_prescription_order): + prescription_audit_status: 1 (已通过) + prescription_audit_remark: "审核通过" + +处方表 (zyt_tcm_prescription): + audit_status: 1 (已通过) + audit_remark: "审核通过" + audit_time: 1713168000 + audit_by: 5 + audit_by_name: "张医生" +``` + +### 撤回后 +``` +业务订单表 (zyt_tcm_prescription_order): + prescription_audit_status: 0 (待审核) + prescription_audit_remark: "" + +处方表 (zyt_tcm_prescription): + audit_status: 0 (待审核) + audit_remark: "" + audit_time: null + audit_by: null + audit_by_name: "" +``` + +## 审核状态说明 + +| 状态值 | 说明 | +|--------|------| +| 0 | 待审核 | +| 1 | 已通过 | +| 2 | 已驳回 | + +## 业务流程 + +``` +创建订单 + ↓ +处方待审核 (audit_status = 0) + ↓ 审核通过 +处方已通过 (audit_status = 1) + ↓ 撤回审核 +处方待审核 (audit_status = 0) ← 两个表都重置 + ↓ 重新审核 +处方已通过 (audit_status = 1) +``` + +## 错误处理 + +### 容错设计 +```php +try { + // 更新处方表 + $prescription->save(); +} catch (\Throwable $e) { + // 记录日志但不影响主流程 + Log::error('撤回处方审核时同步处方表失败: ' . $e->getMessage()); +} +``` + +**说明**： +- 即使处方表更新失败，业务订单表的撤回仍然成功 +- 错误会被记录到日志中，便于排查 +- 不会因为处方表问题导致整个撤回操作失败 + +## 相关表结构 + +### 业务订单表 (zyt_tcm_prescription_order) +```sql +prescription_id int(11) unsigned NOT NULL DEFAULT 0 COMMENT '消费者处方ID' +prescription_audit_status tinyint(2) unsigned NOT NULL DEFAULT 0 COMMENT '处方审核 0待审1通过2驳回' +prescription_audit_remark varchar(500) NOT NULL DEFAULT '' COMMENT '处方审核意见' +``` + +### 处方表 (zyt_tcm_prescription) +```sql +audit_status tinyint(1) NOT NULL DEFAULT 1 COMMENT '审核：0待审核 1已通过 2已驳回' +audit_time int(10) unsigned DEFAULT NULL COMMENT '审核时间' +audit_by int(11) unsigned DEFAULT NULL COMMENT '审核人ID' +audit_by_name varchar(50) NOT NULL DEFAULT '' COMMENT '审核人姓名' +audit_remark varchar(500) NOT NULL DEFAULT '' COMMENT '审核意见' +``` + +## 测试清单 + +### 正常流程测试 +- [ ] 创建订单，处方待审核 +- [ ] 审核通过处方 +- [ ] 验证业务订单表和处方表状态都为"已通过" +- [ ] 撤回处方审核 +- [ ] 验证业务订单表和处方表状态都为"待审核" +- [ ] 验证处方表的审核时间、审核人等字段已清空 + +### 边界情况测试 +- [ ] 撤回时处方不存在（已删除） +- [ ] 撤回时处方ID为0 +- [ ] 撤回时数据库连接失败 +- [ ] 验证错误被正确记录到日志 + +### 权限测试 +- [ ] 无审核权限的用户不能撤回 +- [ ] 有审核权限的用户可以撤回 +- [ ] 订单已结束时不能撤回 + +## 日志记录 + +### 成功日志 +``` +操作日志 (zyt_tcm_prescription_order_log): + action: "revoke_rx_audit" + summary: "撤回处方审核，状态重置为待审核" +``` + +### 错误日志 +``` +系统日志: + level: ERROR + message: "撤回处方审核时同步处方表失败: [错误信息]" + context: { + "prescription_id": 123, + "order_id": 456 + } +``` + +## 相关功能 + +### 1. 审核处方 +**方法**: `PrescriptionOrderLogic::auditPrescription()` +- 同时更新业务订单表和处方表的审核状态 + +### 2. 撤回处方审核 +**方法**: `PrescriptionOrderLogic::revokeRxAudit()` +- 同时重置业务订单表和处方表的审核状态（本次修复） + +### 3. 撤回支付单审核 +**方法**: `PrescriptionOrderLogic::revokePayAudit()` +- 只更新业务订单表的支付审核状态 + +## 注意事项 + +1. **数据一致性**：确保两个表的审核状态始终保持一致 +2. **容错处理**：处方表更新失败不影响主流程 +3. **日志记录**：所有错误都会被记录，便于排查 +4. **权限控制**：只有有审核权限的用户才能撤回 +5. **状态限制**：订单已结束时不能撤回 + +## 相关文件 + +- `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` - 业务逻辑 +- `server/app/adminapi/controller/tcm/PrescriptionOrderController.php` - 控制器 +- `admin/src/views/consumer/prescription/order_list.vue` - 前端页面 + +## 总结 + +✅ **修复前**：撤回审核只更新业务订单表 +✅ **修复后**：撤回审核同时更新业务订单表和处方表 +✅ **容错处理**：处方表更新失败不影响主流程 +✅ **日志记录**：错误会被记录到系统日志 + +这样可以确保数据一致性，避免审核状态不同步的问题。 diff --git a/SHIPPING_REGION_FEATURE.md b/SHIPPING_REGION_FEATURE.md new file mode 100644 index 00000000..45911cc3 --- /dev/null +++ b/SHIPPING_REGION_FEATURE.md @@ -0,0 +1,179 @@ +# 收货地址省市区功能实现 + +## 概述 +为处方业务订单编辑表单添加省/市/区选择器，将地址信息结构化存储。 + +## 数据库变更 + +### 新增字段 +在 `zyt_tcm_prescription_order` 表中添加三个字段： + +```sql +ALTER TABLE `zyt_tcm_prescription_order` +ADD COLUMN `shipping_province` varchar(50) NOT NULL DEFAULT '' COMMENT '收货省份' AFTER `recipient_phone`, +ADD COLUMN `shipping_city` varchar(50) NOT NULL DEFAULT '' COMMENT '收货城市' AFTER `shipping_province`, +ADD COLUMN `shipping_district` varchar(50) NOT NULL DEFAULT '' COMMENT '收货区县' AFTER `shipping_city`; +``` + +**执行方式：** +```bash +mysql -u用户名 -p数据库名 < add_shipping_region_fields.sql +``` + +## 后端变更 + +### 文件：`server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` + +在 `edit()` 方法中添加省市区字段处理： + +```php +// 处理省市区字段 +if (isset($params['shipping_province'])) { + $order->shipping_province = (string) $params['shipping_province']; +} +if (isset($params['shipping_city'])) { + $order->shipping_city = (string) $params['shipping_city']; +} +if (isset($params['shipping_district'])) { + $order->shipping_district = (string) $params['shipping_district']; +} +``` + +## 前端变更 + +### 文件：`admin/src/views/consumer/prescription/order_list.vue` + +#### 1. 数据结构 +在 `editForm` 中添加 `region` 字段： +```typescript +const editForm = reactive({ + // ... 其他字段 + region: [] as string[], // 新增 + shipping_address: '', + // ... +}) +``` + +#### 2. UI 组件 +在收货手机下方添加省市区选择器： +```vue + + + +``` + +#### 3. 数据提交 +在 `submitEdit()` 中将 region 数组拆分为三个字段： +```typescript +if (editForm.region && editForm.region.length > 0) { + payload.shipping_province = editForm.region[0] || '' + payload.shipping_city = editForm.region[1] || '' + payload.shipping_district = editForm.region[2] || '' +} else { + payload.shipping_province = '' + payload.shipping_city = '' + payload.shipping_district = '' +} +``` + +#### 4. 数据加载 +在 `openEdit()` 中从后端数据填充 region： +```typescript +const province = d.shipping_province || '' +const city = d.shipping_city || '' +const district = d.shipping_district || '' +if (province || city || district) { + editForm.region = [province, city, district].filter(v => v !== '') +} else { + editForm.region = [] +} +``` + +## 省市区数据 + +当前使用简化的示例数据，包含： +- 四川省（成都市、绵阳市） +- 北京市 +- 上海市 +- 广东省（广州市、深圳市） + +### 生产环境建议 + +**方案 1：使用完整数据集** +- 集成中国行政区划完整数据（约 3000+ 区县） +- 推荐数据源： + - [element-china-area-data](https://www.npmjs.com/package/element-china-area-data) + - [china-division](https://github.com/modood/Administrative-divisions-of-China) + +**方案 2：使用 API 服务** +- 调用第三方地址 API（如高德地图、腾讯地图） +- 优点：数据实时更新，减少前端体积 +- 缺点：依赖网络，需要 API Key + +## 使用流程 + +1. **执行数据库迁移** + ```bash + mysql -u用户名 -p数据库名 < add_shipping_region_fields.sql + ``` + +2. **重启后端服务**（如需要） + +3. **测试功能** + - 打开处方业务订单列表 + - 点击"编辑"按钮 + - 选择省/市/区 + - 填写详细地址 + - 保存并验证数据已正确存储 + +## 数据结构 + +### 前端存储格式 +```typescript +region: ['四川省', '成都市', '武侯区'] +``` + +### 后端存储格式 +```php +[ + 'shipping_province' => '四川省', + 'shipping_city' => '成都市', + 'shipping_district' => '武侯区', + 'shipping_address' => '天府大道中段123号' // 详细地址 +] +``` + +### 数据库存储 +``` +shipping_province: 四川省 +shipping_city: 成都市 +shipping_district: 武侯区 +shipping_address: 天府大道中段123号 +``` + +## 注意事项 + +1. **向后兼容**：旧数据的省市区字段为空字符串，不影响现有功能 +2. **可选字段**：省市区选择器可清空，允许用户只填写详细地址 +3. **数据验证**：前端使用 cascader 确保选择的层级关系正确 +4. **字段长度**：省市区字段各限制 50 字符 + +## 相关文件 + +- `add_shipping_region_fields.sql` - 数据库迁移文件 +- `admin/src/views/consumer/prescription/order_list.vue` - 前端订单列表页面 +- `server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php` - 后端业务逻辑 + +## 后续优化建议 + +1. 在订单详情页面也显示省市区信息 +2. 在订单列表的收货人列中显示省市信息 +3. 添加按省市区筛选订单的功能 +4. 集成完整的中国行政区划数据 +5. 考虑添加邮政编码字段 diff --git a/add_dose_unit_to_prescription_order.sql b/add_dose_unit_to_prescription_order.sql new file mode 100644 index 00000000..b25bb9ae --- /dev/null +++ b/add_dose_unit_to_prescription_order.sql @@ -0,0 +1,13 @@ +-- 添加剂量单位和剂数字段到处方业务订单表 +-- 用于记录订单的剂量单位和剂数信息 + +ALTER TABLE `zyt_tcm_prescription_order` +ADD COLUMN `dose_unit` varchar(20) NOT NULL DEFAULT '剂' COMMENT '剂量单位：剂、丸、袋、盒、瓶、膏、贴' AFTER `medication_days`, +ADD COLUMN `dose_count` int(11) NOT NULL DEFAULT 1 COMMENT '剂数' AFTER `dose_unit`; + +-- 验证字段是否添加成功 +SELECT COLUMN_NAME, DATA_TYPE, COLUMN_DEFAULT, COLUMN_COMMENT +FROM information_schema.COLUMNS +WHERE TABLE_SCHEMA = DATABASE() + AND TABLE_NAME = 'zyt_tcm_prescription_order' + AND COLUMN_NAME IN ('dose_unit', 'dose_count'); diff --git a/add_gancao_callback_fields.sql b/add_gancao_callback_fields.sql new file mode 100644 index 00000000..6522c2d1 --- /dev/null +++ b/add_gancao_callback_fields.sql @@ -0,0 +1,12 @@ +-- 添加甘草订单回调相关字段 +-- 在 zyt_prescription_order 表中添加 + +ALTER TABLE `zyt_prescription_order` +ADD COLUMN `gancao_order_state` INT(11) DEFAULT 0 COMMENT '甘草订单状态：10=审核中,11=审核通过,110=制作中,20=物流中,30=完成,90=拦截,91=撤单,92=驳回' AFTER `gancao_submit_time`, +ADD COLUMN `gancao_flow_name` VARCHAR(100) DEFAULT '' COMMENT '甘草订单流程名称（如：派单、审方、调配、复核、浸泡、煎药、包装、发货等）' AFTER `gancao_order_state`, +ADD COLUMN `gancao_supplier` VARCHAR(100) DEFAULT '' COMMENT '甘草供应商/药房名称' AFTER `gancao_flow_name`, +ADD COLUMN `gancao_remark` VARCHAR(500) DEFAULT '' COMMENT '甘草订单备注（拦截原因、驳回原因等）' AFTER `gancao_supplier`; + +-- 添加索引 +ALTER TABLE `zyt_prescription_order` +ADD INDEX `idx_gancao_order_state` (`gancao_order_state`); diff --git a/add_prescription_complete_fields.sql b/add_prescription_complete_fields.sql new file mode 100644 index 00000000..23f63a19 --- /dev/null +++ b/add_prescription_complete_fields.sql @@ -0,0 +1,20 @@ +-- 添加处方完整字段（用量、代煎、每天几次） +-- 执行前请先备份数据库 + +-- 1. 添加用量相关字段（如果不存在） +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN IF NOT EXISTS `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值' AFTER `prescription_type`, +ADD COLUMN IF NOT EXISTS `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)' AFTER `dosage_amount`, +ADD COLUMN IF NOT EXISTS `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)' AFTER `dosage_unit`; + +-- 2. 添加每天几次字段（如果不存在） +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN IF NOT EXISTS `times_per_day` int(11) NOT NULL DEFAULT 2 COMMENT '每天服用次数' AFTER `usage_days`; + +-- 验证字段是否添加成功 +SELECT COLUMN_NAME, DATA_TYPE, COLUMN_DEFAULT, COLUMN_COMMENT +FROM information_schema.COLUMNS +WHERE TABLE_SCHEMA = DATABASE() + AND TABLE_NAME = 'zyt_tcm_prescription' + AND COLUMN_NAME IN ('dosage_amount', 'dosage_unit', 'need_decoction', 'times_per_day') +ORDER BY ORDINAL_POSITION; diff --git a/add_prescription_dosage_fields.sql b/add_prescription_dosage_fields.sql new file mode 100644 index 00000000..cf91eb7c --- /dev/null +++ b/add_prescription_dosage_fields.sql @@ -0,0 +1,15 @@ +-- 添加处方用量相关字段 +-- 用于存储处方类型对应的用量、单位和代煎信息 + +ALTER TABLE `zyt_tcm_prescription` +ADD COLUMN `dosage_amount` decimal(10,2) DEFAULT NULL COMMENT '用量数值' AFTER `prescription_type`, +ADD COLUMN `dosage_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '用量单位(g/ml)' AFTER `dosage_amount`, +ADD COLUMN `need_decoction` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否代煎(0否1是,仅饮片)' AFTER `dosage_unit`; + +-- 验证字段是否添加成功 +SELECT COLUMN_NAME, DATA_TYPE, COLUMN_DEFAULT, COLUMN_COMMENT +FROM information_schema.COLUMNS +WHERE TABLE_SCHEMA = DATABASE() + AND TABLE_NAME = 'zyt_tcm_prescription' + AND COLUMN_NAME IN ('dosage_amount', 'dosage_unit', 'need_decoction') +ORDER BY ORDINAL_POSITION; diff --git a/add_shipping_region_fields.sql b/add_shipping_region_fields.sql new file mode 100644 index 00000000..0d95a8c4 --- /dev/null +++ b/add_shipping_region_fields.sql @@ -0,0 +1,5 @@ +-- 添加省市区字段到处方业务订单表 +ALTER TABLE `zyt_tcm_prescription_order` +ADD COLUMN `shipping_province` varchar(50) NOT NULL DEFAULT '' COMMENT '收货省份' AFTER `recipient_phone`, +ADD COLUMN `shipping_city` varchar(50) NOT NULL DEFAULT '' COMMENT '收货城市' AFTER `shipping_province`, +ADD COLUMN `shipping_district` varchar(50) NOT NULL DEFAULT '' COMMENT '收货区县' AFTER `shipping_city`; diff --git a/admin/src/api/tcm.ts b/admin/src/api/tcm.ts index 24c6490e..8fa2039b 100644 --- a/admin/src/api/tcm.ts +++ b/admin/src/api/tcm.ts @@ -326,6 +326,16 @@ export function prescriptionOrderComplete(params: { id: number }) { return request.post({ url: '/tcm.prescriptionOrder/complete', params }) } +/** 甘草药管家：中药处方下单（服务端 CTM_PREVIEW → CTM_SUBMIT_RECIPEL） */ +export function prescriptionOrderSubmitGancaoRecipel(params: { id: number }) { + return request.post({ url: '/tcm.prescriptionOrder/submitGancaoRecipel', params }) +} + +/** 甘草药管家：预下单测试（仅 CTM_PREVIEW，不提交订单） */ +export function prescriptionOrderPreviewGancaoRecipel(params: { id: number; dose_count?: number; medication_days?: number }) { + return request.post({ url: '/tcm.prescriptionOrder/previewGancaoRecipel', params }) +} + /** 订单操作日志 */ export function prescriptionOrderLogs(params: { id: number }) { return request.get({ url: '/tcm.prescriptionOrder/logs', params }) diff --git a/admin/src/components/tcm-prescription/index.vue b/admin/src/components/tcm-prescription/index.vue index 556d8c2b..f49b0900 100644 --- a/admin/src/components/tcm-prescription/index.vue +++ b/admin/src/components/tcm-prescription/index.vue @@ -135,11 +135,72 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + {{ formData.dosage_unit }} + + + + + + + + 代煎 + 不代煎 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 代煎 + 不代煎 + + + + + + + + - + + + + + + @@ -1176,6 +1250,7 @@ const createOrderForm = reactive({ patient_id: '' as number | string, recipient_name: '', recipient_phone: '', + region: [] as string[], shipping_address: '', is_follow_up: 0, medication_days: undefined as number | undefined, @@ -1191,6 +1266,146 @@ const createOrderForm = reactive({ pay_order_ids: [] as number[] }) +// 省市区数据（简化版，实际项目中应该从 API 获取或使用完整的省市区数据） +const regionOptions = ref([ + { + name: '四川省', + children: [ + { + name: '成都市', + children: [ + { name: '锦江区' }, + { name: '青羊区' }, + { name: '金牛区' }, + { name: '武侯区' }, + { name: '成华区' }, + { name: '龙泉驿区' }, + { name: '青白江区' }, + { name: '新都区' }, + { name: '温江区' }, + { name: '双流区' }, + { name: '郫都区' }, + { name: '新津区' }, + { name: '都江堰市' }, + { name: '彭州市' }, + { name: '邛崃市' }, + { name: '崇州市' }, + { name: '简阳市' }, + { name: '金堂县' }, + { name: '大邑县' }, + { name: '蒲江县' } + ] + }, + { + name: '绵阳市', + children: [ + { name: '涪城区' }, + { name: '游仙区' }, + { name: '安州区' }, + { name: '江油市' }, + { name: '三台县' }, + { name: '盐亭县' }, + { name: '梓潼县' }, + { name: '北川羌族自治县' }, + { name: '平武县' } + ] + } + ] + }, + { + name: '北京市', + children: [ + { + name: '北京市', + children: [ + { name: '东城区' }, + { name: '西城区' }, + { name: '朝阳区' }, + { name: '丰台区' }, + { name: '石景山区' }, + { name: '海淀区' }, + { name: '门头沟区' }, + { name: '房山区' }, + { name: '通州区' }, + { name: '顺义区' }, + { name: '昌平区' }, + { name: '大兴区' }, + { name: '怀柔区' }, + { name: '平谷区' }, + { name: '密云区' }, + { name: '延庆区' } + ] + } + ] + }, + { + name: '上海市', + children: [ + { + name: '上海市', + children: [ + { name: '黄浦区' }, + { name: '徐汇区' }, + { name: '长宁区' }, + { name: '静安区' }, + { name: '普陀区' }, + { name: '虹口区' }, + { name: '杨浦区' }, + { name: '闵行区' }, + { name: '宝山区' }, + { name: '嘉定区' }, + { name: '浦东新区' }, + { name: '金山区' }, + { name: '松江区' }, + { name: '青浦区' }, + { name: '奉贤区' }, + { name: '崇明区' } + ] + } + ] + }, + { + name: '广东省', + children: [ + { + name: '广州市', + children: [ + { name: '荔湾区' }, + { name: '越秀区' }, + { name: '海珠区' }, + { name: '天河区' }, + { name: '白云区' }, + { name: '黄埔区' }, + { name: '番禺区' }, + { name: '花都区' }, + { name: '南沙区' }, + { name: '从化区' }, + { name: '增城区' } + ] + }, + { + name: '深圳市', + children: [ + { name: '罗湖区' }, + { name: '福田区' }, + { name: '南山区' }, + { name: '宝安区' }, + { name: '龙岗区' }, + { name: '盐田区' }, + { name: '龙华区' }, + { name: '坪山区' }, + { name: '光明区' } + ] + } + ] + } +]) + +// 处理省市区选择变化 +const handleRegionChange = (value: string[]) => { + console.log('选择的省市区：', value) +} + const createOrderLinkedPaidTotal = computed(() => { const ids = new Set(createOrderForm.pay_order_ids.map((x) => Number(x))) let s = 0 @@ -1454,6 +1669,9 @@ const slipDietaryText = computed(() => { const editForm = reactive({ id: 0, prescription_type: '浓缩水丸', + dosage_amount: 1 as number | undefined, + dosage_unit: 'g', + need_decoction: false, patient_name: '', gender: 1, age: 0, @@ -1483,7 +1701,25 @@ const editForm = reactive({ diagnosis_id: 0, /** 列表带入：业务订单「处方审核」驳回（消费者处方本身可能仍为已通过） */ business_prescription_audit_rejected: 0, - business_prescription_audit_remark: '' + business_prescription_audit_remark: '', + times_per_day: 2 +}) + +// 监听处方类型变化，自动调整用量单位和默认值 +watch(() => editForm.prescription_type, (newType) => { + if (newType === '浓缩水丸') { + editForm.dosage_unit = 'g' + editForm.dosage_amount = 1 + editForm.need_decoction = false + } else if (newType === '饮片') { + editForm.dosage_unit = 'ml' + editForm.dosage_amount = 50 + // need_decoction 保持用户选择 + } else { + editForm.dosage_unit = 'g' + editForm.dosage_amount = undefined + editForm.need_decoction = false + } }) // 表单验证规则 @@ -1863,6 +2099,9 @@ const handleEdit = (row: any) => { // 深拷贝数据到表单 editForm.id = row.id editForm.prescription_type = row.prescription_type || '浓缩水丸' + editForm.dosage_amount = row.dosage_amount ?? undefined + editForm.dosage_unit = row.dosage_unit || '' + editForm.need_decoction = row.need_decoction === 1 || row.need_decoction === true editForm.patient_name = row.patient_name || '' editForm.gender = row.gender ?? 1 editForm.age = row.age ?? 0 @@ -1877,6 +2116,7 @@ const handleEdit = (row: any) => { editForm.dose_count = row.dose_count ?? 7 editForm.dose_unit = row.dose_unit || '剂' editForm.usage_days = row.usage_days ?? 7 + editForm.times_per_day = row.times_per_day ?? 2 editForm.usage_instruction = row.usage_instruction || '水煎服，一日二次' editForm.usage_time = row.usage_time || '饭前' editForm.usage_way = row.usage_way || '温水送服' diff --git a/admin/src/views/consumer/prescription/order_list.vue b/admin/src/views/consumer/prescription/order_list.vue index de640cbb..8bea3c33 100644 --- a/admin/src/views/consumer/prescription/order_list.vue +++ b/admin/src/views/consumer/prescription/order_list.vue @@ -184,6 +184,14 @@ link @click="confirmWithdraw(row)" >撤回 + 上传药方 @@ -206,6 +214,13 @@
业务订单详情 {{ detailData.order_no }} + 甘草 {{ detailData.gancao_reciperl_order_no }}
详细 + + 测试价格 +
ID: {{ detailData.prescription_id || '—' }} @@ -391,7 +417,7 @@ {{ detailPrescription.clinical_diagnosis || '—' }} - {{ detailPrescription.dose_count ?? '—' }} 剂 · + {{ detailData.dose_count ?? detailPrescription.dose_count ?? '—' }} {{ detailData.dose_unit || '剂' }} · {{ detailPrescription.usage_instruction || detailPrescription.usage_method || '—' }} @@ -402,6 +428,23 @@ {{ consumerRxAuditText(detailPrescription.audit_status) }} + + + + + + + + {{ Number(detailPrescription.void_status) === 1 ? '已作废' : '正常' }} @@ -710,7 +753,17 @@ - + + + + + @@ -722,7 +775,55 @@ - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 测试价格 + + + 测试当前配置的甘草预下单价格（不会真实提交订单） + @@ -1194,12 +1295,142 @@ + + + +
+ + + + + + ¥{{ gancaoPreviewData.fee?.m_cost || '0.00' }} + + + ¥{{ ((gancaoPreviewData.fee?.proces_cost || 0) ).toFixed(2) }} + + + ¥{{ ((gancaoPreviewData.fee?.lis_cost || 0) ).toFixed(2) }} + + + + ¥{{ calculateTotalFee(gancaoPreviewData.fee) }} + + + + + + + + + + + {{ gancaoPreviewData.result?.ds_name || '—' }} + + + {{ gancaoPreviewData.result?.ds_id || '—' }} + + + {{ gancaoPreviewData.result?.take_days?.min || '—' }} - + {{ gancaoPreviewData.result?.take_days?.max || '—' }} 天 + （默认: {{ gancaoPreviewData.result?.take_days?.default || '—' }} 天） + + + + + + + +
+ {{ gancaoPreviewData.result.rule_check.map(r => r.msg).join(' ') }} +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + {{ gancaoPreviewData.order_no || '—' }} + + + {{ gancaoPreviewData.dose_count || '—' }}剂 + + + + {{ calculateSingleDoseWeight(gancaoPreviewData.result?.m_list) }}克 + + + + +
+