构建 AI 临床副驾驶：基于 Go 的电子病历智能助手与 HIS 对接

5.4 接口契约：/v1/cds/suggestions

请求 POST /v1/cds/suggestions

{
  "patientId": "p123",
  "chiefComplaint": "发热、咳嗽 3 天",
  "vitalSigns": {
    "temp": 38.5,
    "hr": 90
  }
}

在定义这个接口时，我们主要关注的是如何准确地将临床数据映射到系统内部模型。对于 Go 语言开发者来说，直接使用 encoding/json 配合结构体是最稳妥的方案。注意这里 vitalSigns 是一个嵌套对象，这意味着你的接收结构体需要相应地定义嵌套字段，或者使用 map[string]interface{} 来保持灵活性，具体取决于后续业务逻辑对类型安全的要求。

实际对接 HIS 系统时，这类请求往往伴随着严格的校验规则。比如体温超过 40 度可能需要触发紧急预警，这部分逻辑通常放在服务层处理，而不是直接在接口层硬编码。保持接口的纯净性，能让后续的 AI 模型接入更加平滑。