extract-clinical-entities-to-fhir

把OpenMed抽取的临床实体映射为确定性的FHIR R4资源与Bundle。

把 OpenMed 从文本里抽出的临床实体翻成确定性的 FHIR R4 资源和一个 Bundle，方便一键上报到 EHR 或下游系统。适用于把本地或已脱敏的 NER 输出变成 Conditions、MedicationStatement、Observation 等标准资源时使用。输出可重复、结构化，不会凭空发明术语编码。

# Extract clinical entities to FHIR

Separate extraction from clinical coding. OpenMed finds spans and supplies the
mechanical FHIR builders; the application decides which resource type and
status are clinically appropriate.

## Procedure

1. Keep the source synthetic, or de-identify it inside the trusted boundary
   before extraction.
2. Run `openmed.analyze_text` with the task-appropriate clinical model.
3. Filter predictions by label and confidence; preserve offsets in a
   PHI-safe audit record.
4. Map each accepted span to the correct FHIR resource type.
5. Add terminology codes only from a user-approved mapping or terminology
   service. Never invent a code.
6. Assemble resources with