병원 검사 코드의 LOINC 매핑이 결과값과 맞는지 알려줍니다.

• 묶음 기준: verdict
• 한 행: 사유 라벨 · mapping_id + 한 줄 요약(근거 수치 포함)

화면·코드·면접에서 이 단어를 그대로 씁니다. 키는 출력 스키마의 enum 과 같습니다.

• 자가채점 — LOINC 정의로 먼저 붙인 판정과 같은 매핑 · 정답 300건 기준 수치는 본인이 러너를 돌려 나온 값을 넣습니다. 예측 화면에는 비워 둡니다 — 출처를 댈 수 없는 숫자를 화면에 두지 않기 위해서입니다.
• 출력 스키마 검증 항목을 통과 여부와 함께 상시 노출
• 검증 노트 — 자동 / 수동 / 정직 경계선

• 업로드 전에는 사이드바에 예시 병원 10곳이 걸려 있고, H11 크레아티닌 줄이 펼쳐진 채 열립니다.
• 매핑표에 없는 병원·검사 코드 조합의 결과는 사이드바 아래 '매핑 없는 결과' 칸에 병원별 건수로 모으고, 판정 표에는 섞지 않습니다.

{"type":"object","properties":{"mapping_id":{"type":"string"},"hospital_id":{"type":"string"},"local_code":{"type":"string"},"loinc_code":{"type":"string"},"verdict":{"type":"string","enum":["매핑 그대로 사용","결과 단위가 LOINC 와 안 맞음","검체가 LOINC 와 다름","다른 병원과 값 범위가 어긋남","폐기된 LOINC 코드에 매핑됨"]},"unit_mode":{"type":["string","null"],"description":"같은 hospital_id·local_code 의 lab_results.unit 을 대소문자 구분 없이 센 최빈값을 UCUM 표기로 적은 값입니다."},"expected_units":{"type":"array","items":{"type":"string"},"description":"매핑된 loinc_code 의 example_ucum_units 입니다. 용어표에 코드가 없으면 빈 배열입니다."},"specimen":{"type":["string","null"]},"loinc_system":{"type":["string","null"]},"loinc_status":{"type":["string","null"]},"hospital_median":{"type":["number","null"],"description":"같은 hospital_id·local_code 의 lab_results.value 중 null 을 뺀 값의 중앙값입니다."},"other_median":{"type":["number","null"],"description":"같은 loinc_code 로 매핑된 다른 hospital_id 마다 낸 중앙값들의 중앙값입니다. 폐기·검체·단위로 이미 걸린 매핑은 빼고, 남은 다른 병원이 없으면 null 입니다."},"median_ratio":{"type":["number","null"],"minimum":1,"description":"hospital_median 과 other_median 중 큰 값을 작은 값으로 나눈 배수(소수 둘째 자리)입니다. 한쪽이 null 이면 null 입니다."},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{}},"required":["field","value"]}},"summary":{"type":"string"},"hedge":{"type":["string","null"]}},"required":["mapping_id","hospital_id","local_code","loinc_code","verdict","unit_mode","expected_units","hospital_median","other_median","median_ratio","evidence","summary"]}

[
  {
    "mapping_id": "MAP-H04-0015",
    "hospital_id": "H04",
    "local_code": "CREA",
    "loinc_code": "2160-0",
    "verdict": "매핑 그대로 사용",
    "unit_mode": "mg/dL",
    "expected_units": [
      "mg/dL"
    ],
    "specimen": "혈청",
    "loinc_system": "Ser/Plas",
    "loinc_status": "ACTIVE",
    "hospital_median": 1.04,
    "other_median": 0.92,
    "median_ratio": 1.13,
    "evidence": [
      {
        "field": "unit",
        "value": "mg/dl"
      },
      {
        "field": "example_ucum_units",
        "value": [
          "mg/dL"
        ]
      },
      {
        "field": "value",
        "value": 1.04
      },
      {
        "field": "value",
        "value": 0.92
      },
      {
        "field": "value",
        "value": 0.85
      },
      {
        "field": "value",
        "value": 77
      },
      {
        "field": "value",
        "value": 81
      }
    ],
    "summary": "병원이 적은 mg/dl 은 대소문자만 다른 mg/dL 이라 2160-0 의 예시 단위와 같고, 중앙값 1.04 가 다른 병원 중앙값 0.92 와 비슷합니다.",
    "hedge": "다른 병원 중앙값은 H01 0.92, H02 0.85, H11 79 세 병원 중앙값의 중앙값이라 H11 한 곳이 크게 벗어나도 0.92 로 섭니다."
  },
  {
    "mapping_id": "MAP-H09-0006",
    "hospital_id": "H09",
    "local_code": "K",
    "loinc_code": "2823-3",
    "verdict": "매핑 그대로 사용",
    "unit_mode": "mmol/L",
    "expected_units": [
      "mmol/L"
    ],
    "specimen": null,
    "loinc_system": "Ser/Plas",
    "loinc_status": "ACTIVE",
    "hospital_median": 4.3,
    "other_median": null,
    "median_ratio": null,
    "evidence": [
      {
        "field": "specimen",
        "value": null
      },
      {
        "field": "unit",
        "value": "mmol/L"
      },
      {
        "field": "example_ucum_units",
        "value": [
          "mmol/L"
        ]
      },
      {
        "field": "value",
        "value": 4.3
      }
    ],
    "summary": "결과 단위 mmol/L 이 2823-3 의 예시 단위와 같아 매핑을 그대로 씁니다.",
    "hedge": "병원이 검체를 적지 않아 검체 비교를 건너뛰었고, 같은 LOINC 코드를 쓰는 다른 병원이 없어 값 범위도 견주지 못했습니다. 참여 병원 담당자에게 검체를 채워 달라고 요청할 매핑입니다."
  },
  {
    "mapping_id": "MAP-H08-0007",
    "hospital_id": "H08",
    "local_code": "U-PROT",
    "loinc_code": "2888-6",
    "verdict": "매핑 그대로 사용",
    "unit_mode": "mg/dL",
    "expected_units": [
      "mg/dL"
    ],
    "specimen": "소변",
    "loinc_system": "Urine",
    "loinc_status": "ACTIVE",
    "hospital_median": 55,
    "other_median": 15,
    "median_ratio": 3.67,
    "evidence": [
      {
        "field": "value",
        "value": 52
      },
      {
        "field": "value",
        "value": 58
      },
      {
        "field": "value",
        "value": 15
      },
      {
        "field": "unit",
        "value": "mg/dL"
      }
    ],
    "summary": "신장 전문 병원의 요단백 중앙값 55 가 같은 2888-6 을 쓰는 H01 중앙값 15 보다 3.67배 높지만 5배 기준 안쪽이라 매핑을 그대로 씁니다.",
    "hedge": "단백뇨 환자가 몰린 병원이라 값이 높은 것으로 봅니다. 기준을 3배로 낮추면 이 정상 매핑이 값 범위로 넘어갑니다."
  },
  {
    "mapping_id": "MAP-H07-0012",
    "hospital_id": "H07",
    "local_code": "LAB-GLU-01",
    "loinc_code": "2345-7",
    "verdict": "결과 단위가 LOINC 와 안 맞음",
    "unit_mode": "mmol/L",
    "expected_units": [
      "mg/dL"
    ],
    "specimen": "혈청",
    "loinc_system": "Ser/Plas",
    "loinc_status": "ACTIVE",
    "hospital_median": 5.85,
    "other_median": 98,
    "median_ratio": 16.75,
    "evidence": [
      {
        "field": "unit",
        "value": "mmol/L"
      },
      {
        "field": "unit",
        "agg": "count",
        "value": 2
      },
      {
        "field": "example_ucum_units",
        "value": [
          "mg/dL"
        ]
      },
      {
        "field": "value",
        "value": 5.6
      },
      {
        "field": "value",
        "value": 6.1
      },
      {
        "field": "result_id",
        "value": "LR-0202"
      },
      {
        "field": "value",
        "value": null
      }
    ],
    "summary": "결과 2건이 모두 mmol/L 인데 매핑된 2345-7 은 mg/dL 로 적는 질량 농도 코드입니다.",
    "hedge": "몰 농도 공복혈당은 14749-6 이 따로 있어 매핑 코드를 바꾸는 쪽일 가능성이 큽니다. 다른 병원 중앙값 98 은 H01 98, H02 104, H04 91 로 냈고, H02 의 LR-0202 는 값이 비어 있어 뺐습니다. 값으로도 16배 넘게 벌어지지만 단위가 먼저 판정됩니다."
  },
  {
    "mapping_id": "MAP-H03-0008",
    "hospital_id": "H03",
    "local_code": "UA-PRO",
    "loinc_code": "2885-2",
    "verdict": "검체가 LOINC 와 다름",
    "unit_mode": "mg/dL",
    "expected_units": [
      "g/dL"
    ],
    "specimen": "소변",
    "loinc_system": "Ser/Plas",
    "loinc_status": "ACTIVE",
    "hospital_median": 12,
    "other_median": null,
    "median_ratio": null,
    "evidence": [
      {
        "field": "specimen",
        "value": "소변"
      },
      {
        "field": "system",
        "value": "Ser/Plas"
      },
      {
        "field": "loinc_code",
        "value": "2885-2"
      }
    ],
    "summary": "병원은 소변 검체로 적었는데 매핑된 2885-2 는 혈청·혈장 단백 코드입니다.",
    "hedge": "결과 단위 mg/dL 도 2885-2 의 예시 단위 g/dL 와 다르지만 검체가 먼저 판정됩니다. 소변 단백은 2888-6 이 따로 있습니다."
  },
  {
    "mapping_id": "MAP-H11-0041",
    "hospital_id": "H11",
    "local_code": "CHEM-CR",
    "loinc_code": "2160-0",
    "verdict": "다른 병원과 값 범위가 어긋남",
    "unit_mode": "mg/dL",
    "expected_units": [
      "mg/dL"
    ],
    "specimen": "혈청",
    "loinc_system": "Ser/Plas",
    "loinc_status": "ACTIVE",
    "hospital_median": 79,
    "other_median": 0.92,
    "median_ratio": 85.87,
    "evidence": [
      {
        "field": "value",
        "value": 77
      },
      {
        "field": "value",
        "value": 81
      },
      {
        "field": "value",
        "value": 0.92
      },
      {
        "field": "value",
        "value": 0.85
      },
      {
        "field": "value",
        "value": 1.04
      },
      {
        "field": "unit",
        "value": "mg/dL"
      }
    ],
    "summary": "이 병원 크레아티닌 중앙값 79 가 같은 2160-0 을 쓰는 다른 병원 중앙값 0.92 와 85배 넘게 벌어졌습니다.",
    "hedge": "크레아티닌 79 umol/L 는 약 0.89 mg/dL 라서, 값은 umol/L 로 나오는데 단위 칸만 mg/dL 로 적힌 것으로 보입니다. 단위 칸만 보면 맞는 매핑이라 이름과 단위만 견주는 검토로는 드러나지 않습니다."
  },
  {
    "mapping_id": "MAP-H05-0020",
    "hospital_id": "H05",
    "local_code": "HBA1C-2",
    "loinc_code": "17855-8",
    "verdict": "폐기된 LOINC 코드에 매핑됨",
    "unit_mode": "%",
    "expected_units": [
      "%"
    ],
    "specimen": "전혈",
    "loinc_system": "Bld",
    "loinc_status": "DEPRECATED",
    "hospital_median": 6.4,
    "other_median": null,
    "median_ratio": null,
    "evidence": [
      {
        "field": "loinc_code",
        "value": "17855-8"
      },
      {
        "field": "status",
        "value": "DEPRECATED"
      }
    ],
    "summary": "매핑된 17855-8 의 상태가 DEPRECATED 입니다.",
    "hedge": "같은 병원의 HBA1C 는 4548-4 에 매핑돼 있어, 두 검사 코드가 같은 검사를 가리키는지 병원 담당자가 확인합니다. 상태 값은 더미 용어표 기준입니다."
  },
  {
    "mapping_id": "MAP-H14-0002",
    "hospital_id": "H14",
    "local_code": "NA",
    "loinc_code": "2951-8",
    "verdict": "폐기된 LOINC 코드에 매핑됨",
    "unit_mode": "mmol/L",
    "expected_units": [],
    "specimen": "혈청",
    "loinc_system": null,
    "loinc_status": null,
    "hospital_median": 139,
    "other_median": null,
    "median_ratio": null,
    "evidence": [
      {
        "field": "loinc_code",
        "value": "2951-8"
      },
      {
        "field": "loinc_code",
        "agg": "count",
        "value": 0
      }
    ],
    "summary": "매핑된 2951-8 을 LOINC 용어표에서 찾지 못했습니다.",
    "hedge": "나트륨 혈청 코드 2951-2 를 옮겨 적다 끝자리를 틀린 것으로 보입니다. 용어표에 없는 코드는 폐기 코드와 같이 다시 매핑할 대상으로 둡니다."
  }
]

[자동 검증 · 코드가 판정합니다] 1. verdict 가 매핑 그대로 사용·결과 단위가 LOINC 와 안 맞음·검체가 LOINC 와 다름·다른 병원과 값 범위가 어긋남·폐기된 LOINC 코드에 매핑됨 다섯 값 중 하나인지 확인합니다. 2. mapping_id·hospital_id·local_code·loinc_code·verdict·unit_mode·expected_units·hospital_median·other_median·median_ratio·evidence·summary 필드가 빠짐없이 존재하는지 확인합니다. 3. median_ratio 가 null 이 아니면 1 이상인지 확인합니다. 4. hospital_median 을 같은 hospital_id·local_code 의 lab_results.value 중 null 을 뺀 값의 중앙값으로, other_median 을 같은 loinc_code 로 매핑된 다른 hospital_id 마다 낸 중앙값들의 중앙값으로, median_ratio 를 두 값 중 큰 값을 작은 값으로 나눈 배수로 다시 계산합니다. other_median 을 낼 때는 폐기·검체·단위로 이미 걸린 매핑의 값을 뺍니다. 5. term_mappings.loinc_code 를 loinc_concepts 에서 못 찾거나 찾은 행의 status 가 DEPRECATED 이면 verdict 는 폐기된 LOINC 코드에 매핑됨입니다. 6. 앞 조건에 걸리지 않고 specimen 이 null 이 아니며 대응표(혈청→Ser·Ser/Plas, 혈장→Plas·Ser/Plas, 소변→Urine, 전혈→Bld)로 바꾼 값에 loinc_concepts.system 이 없으면 verdict 는 검체가 LOINC 와 다름입니다. 7. 앞 조건에 걸리지 않고 대소문자를 구분하지 않은 unit 최빈값이 example_ucum_units 에 없으면 verdict 는 결과 단위가 LOINC 와 안 맞음입니다. 8. 앞 조건에 걸리지 않고 median_ratio 가 5 를 넘으면 verdict 는 다른 병원과 값 범위가 어긋남이고, 어느 조건에도 걸리지 않으면 매핑 그대로 사용입니다. 9. evidence 의 field 이름이 세 데이터셋 중 하나에 있는 컬럼인지 대조합니다. 10. evidence 의 value 가 수록된 행의 원문 값과 같은지 확인합니다. 여러 행을 센 수는 agg 를 적습니다. 11. summary 가 존댓말로 끝나는지 확인합니다. [확정 카드 판정식과 다른 점] 카드는 다른 병원 값을 '같은 loinc_code 로 묶인 다른 hospital_id 들의 lab_results.value 중앙값' 으로 적었는데, 이 편은 다른 병원마다 중앙값을 먼저 내고 그 중앙값들의 중앙값을 쓰며 폐기·검체·단위로 이미 걸린 매핑은 뺍니다. 이유는 결과값을 한데 모으면 H11 의 77·81 두 값이 기준을 약 39 로 끌어올려, 정상인 H01·H02·H04 크레아티닌 매핑 셋이 다른 병원과 값 범위가 어긋남으로 뒤집히기 때문입니다. [판정 차례 · 규칙이 둘 이상 걸릴 때] 표준용어 담당자가 병원에 보낼 요청은 매핑마다 한 가지라, 아래 차례에서 처음 걸린 사유만 표에 띄웁니다. ① 폐기된 LOINC 코드에 매핑됨 → ② 검체가 LOINC 와 다름 → ③ 결과 단위가 LOINC 와 안 맞음 → ④ 다른 병원과 값 범위가 어긋남 → ⑤ 매핑 그대로 사용. 쓸 수 없는 코드는 나머지를 견줄 까닭이 없고, 검체가 다르면 단위가 맞아도 다른 검사입니다. 값 범위는 단위 칸이 맞아 보여도 숫자가 어긋난 매핑을 잡는 마지막 단계입니다. [하드 케이스 · 판정이 갈리는 이유] MAP-H07-0012 는 단위 mmol/L 로 먼저 걸려 값 범위 배수 16.75 가 있어도 단위 판정입니다. MAP-H03-0008 은 단위 mg/dL 도 2885-2 와 다르지만 검체가 앞이라 검체 판정입니다. MAP-H11-0041 은 단위 칸이 mg/dL 로 맞아 값 범위에서만 걸립니다. MAP-H04-0015 의 mg/dl 은 대소문자만 다른 같은 단위라 걸리지 않습니다. MAP-H08-0007 은 다른 병원 중앙값 15 와 3.67배 차이라 5배 기준 안쪽에서 그대로 사용이고, 기준을 3배로 잘못 잡으면 값 범위로 넘어갑니다. MAP-H09-0006 은 specimen 이 null 이라 검체 비교를 건너뛰고, 같은 코드를 쓰는 다른 병원이 없어 other_median 이 null 입니다. LR-0202 는 value 가 null 이라 H02 중앙값에서 빠집니다. MAP-H14-0002 의 2951-8 은 용어표에 없어 폐기 판정으로 갑니다. [평가 러너 · 2주차] 더미 매핑 300건에 LOINC 정의를 읽고 먼저 붙여 둔 판정과 자동 판정을 견줘 다른 매핑 수를 세고, 월별 재적재 뒤에도 같은 파일이면 판정이 바뀌지 않는지 봅니다. [수동 검증 · 사람이 봅니다] 1. 값 범위로 걸린 매핑이 단위 환산 누락인지 환자군 차이인지는 참여 병원 담당자가 값 분포를 보고 정합니다. 2. 3주차 후보 코드 가운데 어느 것으로 바꿀지는 표준용어 담당자가 고릅니다.