# 用药工具 — 查询药物（移动端）

## 1. 概述

| 项 | 说明 |
| --- | --- |
| Base Path | `/app/medication/drug` |
| 数据表 | `biz_withdrawal_period_standard`、`biz_drug_incompatibility_standard`、`biz_drug_incompatibility_companion` |
| 鉴权 | 需登录 |

## 2. 药物名称列表（下拉模糊）

`GET /app/medication/drug/names`

| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `keyword` | 否 | 对 `biz_withdrawal_period_standard.drug_name` 模糊匹配；不传则返回前 50 个名称（去重、按名称升序） |

**响应 `data`**：`string[]`，药物名称列表（`SELECT DISTINCT drug_name`）。

## 3. 查询药物

`GET /app/medication/drug/query`

| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `drugName` | 是 | 药物名称（精确匹配休药期标准 `drug_name`，1～20 字） |

**响应 `data` 字段**

| 字段 | 来源 | 说明 |
| --- | --- | --- |
| `drugName` | 休药期标准 | 药物名称 |
| `drugType` | 休药期标准 | `1` 抗生素 `2` 抗原虫 `3` 抗病毒 `4` 激素 |
| `drugTypeName` | 服务端映射 | 类型中文名 |
| `withdrawalDays` | 休药期标准 | 休药期（天） |
| `usageGuide` | 休药期标准 | 使用指南 |
| `drugEffect` | 休药期标准 | 药物作用 |
| `incompatibilityCompanions` | 禁配标准 | 配伍禁忌展示文案；按**配伍组**拼接：`组内药物（配伍结果）`，多组以 `；` 分隔；无禁配记录时不返回该字段 |

**示例**：同一主药两条标准 — 组1「链霉素,庆大霉素 + 禁止合用」、组2「维生素C + 降低疗效」→  
`链霉素,庆大霉素（禁止合用）；维生素C（降低疗效）`

**数据语义**：`biz_drug_incompatibility_standard` 一条记录 = 一个配伍组；同一 `main_drug_name` 可有多条记录，各自 `compat_result` 独立。

## 4. 错误示例

| 场景 | 提示 |
| --- | --- |
| 未选药物查询 | 请选择药物名称 |
| 休药期库无该药 | 未找到该药物标准信息 |
| 关键字过长 | 检索关键字不能超过20个字符 |
