xDev Asia

Các loại Visit (Inpatient, Outpatient, ER, Telehealth), cấu trúc VISIT_OCCURRENCE, VISIT_DETAIL cho chi tiết trong một lượt khám, admitted_from/discharged_to, và mối quan hệ Visit-Event trong mô hình OMOP.

Giới thiệu

VISIT_OCCURRENCE ghi nhận mỗi lần bệnh nhân tiếp xúc với hệ thống y tế — từ khám ngoại trú, nhập viện, cấp cứu, đến khám từ xa (telehealth). VISIT_DETAIL bổ sung chi tiết hơn: trong 1 lần nhập viện, BN có thể chuyển qua nhiều khoa.

Hai bảng này là cầu nối giữa PERSON và tất cả sự kiện lâm sàng.

1. VISIT_OCCURRENCE — Cấu trúc

1.1. Danh sách cột

Cột	Kiểu	Bắt buộc	Mô tả
`visit_occurrence_id`	INTEGER	✅ PK	ID duy nhất cho mỗi visit
`person_id`	INTEGER	✅ FK	Tham chiếu PERSON
`visit_concept_id`	INTEGER	✅	Loại visit (Standard Concept)
`visit_start_date`	DATE	✅	Ngày bắt đầu
`visit_start_datetime`	DATETIME		Ngày giờ bắt đầu
`visit_end_date`	DATE	✅	Ngày kết thúc
`visit_end_datetime`	DATETIME		Ngày giờ kết thúc
`visit_type_concept_id`	INTEGER	✅	Nguồn dữ liệu (EHR, Claim...)
`provider_id`	INTEGER	FK	Bác sĩ phụ trách
`care_site_id`	INTEGER	FK	Cơ sở y tế
`visit_source_value`	VARCHAR(50)		Mã visit gốc
`visit_source_concept_id`	INTEGER		Concept gốc
`admitted_from_concept_id`	INTEGER		Đến từ đâu (Home, ER...)
`admitted_from_source_value`	VARCHAR(50)		Giá trị gốc
`discharged_to_concept_id`	INTEGER		Ra viện về đâu
`discharged_to_source_value`	VARCHAR(50)		Giá trị gốc
`preceding_visit_occurrence_id`	INTEGER	FK	Visit trước đó

1.2. Các loại Visit quan trọng

visit_concept_id	Concept Name	Mô tả VN
9201	Inpatient Visit	Nhập viện nội trú
9202	Outpatient Visit	Khám ngoại trú
9203	Emergency Room Visit	Cấp cứu
262	Emergency Room and Inpatient Visit	Cấp cứu → Nhập viện
581477	Telehealth	Khám từ xa
32693	Pharmacy visit	Lấy thuốc tại nhà thuốc
581476	Home Visit	Khám tại nhà
38004515	Laboratory Visit	Chỉ đến xét nghiệm

2. Ví dụ: Bệnh nhân nhập viện

  Bệnh nhân 100001: Nhập viện 10 ngày tại BV Chợ Rẫy
  
  ┌──────────────── VISIT_OCCURRENCE ────────────────┐
  │ visit_occurrence_id = 50001                       │
  │ person_id = 100001                                │
  │ visit_concept_id = 9201 (Inpatient Visit)         │
  │ visit_start_date = 2024-06-10                     │
  │ visit_end_date = 2024-06-20                       │
  │ admitted_from_concept_id = 581476 (Home)           │
  │ discharged_to_concept_id = 581476 (Home)           │
  │ care_site_id = 2001 (BV Chợ Rẫy)                │
  └───────────────────────────────────────────────────┘
      │
      │  Trong visit này có các events:
      │
      ├── CONDITION: Tiểu đường type 2 (chẩn đoán chính)
      ├── CONDITION: Tăng huyết áp (chẩn đoán phụ)
      ├── DRUG: Metformin 500mg x 20 viên
      ├── DRUG: Amlodipine 5mg x 10 viên
      ├── MEASUREMENT: HbA1c = 8.2%
      ├── MEASUREMENT: Creatinine = 1.2 mg/dL
      ├── PROCEDURE: Siêu âm bụng
      └── OBSERVATION: Tiền sử hút thuốc

INSERT INTO visit_occurrence VALUES (
    50001,                -- visit_occurrence_id
    100001,               -- person_id
    9201,                 -- visit_concept_id (Inpatient)
    '2024-06-10',         -- visit_start_date
    '2024-06-10 08:30:00', -- visit_start_datetime
    '2024-06-20',         -- visit_end_date
    '2024-06-20 14:00:00', -- visit_end_datetime
    32817,                -- visit_type_concept_id (EHR)
    5001,                 -- provider_id
    2001,                 -- care_site_id
    'MNV-2024-50001',     -- visit_source_value
    0,                    -- visit_source_concept_id
    581476,               -- admitted_from_concept_id (Home)
    'Nhà',                -- admitted_from_source_value
    581476,               -- discharged_to_concept_id (Home)
    'Nhà',                -- discharged_to_source_value
    NULL                  -- preceding_visit_occurrence_id
);

3. VISIT_DETAIL — Chi tiết trong Visit

3.1. Khi nào cần VISIT_DETAIL?

VISIT_DETAIL ghi nhận chi tiết phụ trong một VISIT_OCCURRENCE. Đặc biệt hữu ích cho nhập viện nội trú khi BN chuyển qua nhiều khoa:

  VISIT_OCCURRENCE (Inpatient, 10 ngày):
  ═══════════════════════════════════════════════════
  
  VISIT_DETAIL (chi tiết):
  ├── Cấp cứu (10/06, 2 giờ)
  │   ═══
  ├── Khoa Nội tiết (10/06 → 15/06, 5 ngày)
  │   ═══════════════════
  ├── ICU (15/06 → 17/06, 2 ngày)
  │   ═══════
  └── Khoa Nội tiết (17/06 → 20/06, 3 ngày)
      ═══════════

3.2. Cấu trúc VISIT_DETAIL

Cột	Kiểu	Mô tả
`visit_detail_id`	INTEGER	PK
`person_id`	INTEGER	FK → PERSON
`visit_detail_concept_id`	INTEGER	Loại detail (Department, Ward...)
`visit_detail_start_date`	DATE	Ngày bắt đầu tại khoa
`visit_detail_end_date`	DATE	Ngày rời khoa
`visit_detail_type_concept_id`	INTEGER	Nguồn dữ liệu
`provider_id`	INTEGER	Bác sĩ phụ trách tại khoa
`care_site_id`	INTEGER	Khoa/phòng cụ thể
`visit_occurrence_id`	INTEGER	FK → VISIT_OCCURRENCE (parent)
`visit_detail_parent_id`	INTEGER	FK → VISIT_DETAIL (parent detail)
`admitted_from_concept_id`	INTEGER	Chuyển từ đâu
`discharged_to_concept_id`	INTEGER	Chuyển đến đâu
`visit_detail_source_value`	VARCHAR(50)	Giá trị gốc

3.3. Ví dụ

-- Visit Detail cho chuyển khoa
INSERT INTO visit_detail VALUES
    -- Cấp cứu (2 giờ)
    (1, 100001, 9203, '2024-06-10', '2024-06-10', 32817,
     5002, 2010, 50001, NULL, 581476, NULL, 'ED'),
    -- Khoa Nội tiết (5 ngày)
    (2, 100001, 9201, '2024-06-10', '2024-06-15', 32817,
     5003, 2020, 50001, 1, NULL, NULL, 'NOI_TIET'),
    -- ICU (2 ngày)
    (3, 100001, 32037, '2024-06-15', '2024-06-17', 32817,
     5004, 2030, 50001, 2, NULL, NULL, 'ICU'),
    -- Quay lại Nội tiết (3 ngày)
    (4, 100001, 9201, '2024-06-17', '2024-06-20', 32817,
     5003, 2020, 50001, 3, NULL, 581476, 'NOI_TIET');

4. Mối quan hệ Visit ↔ Clinical Events

Mọi bảng clinical event đều có cột visit_occurrence_id:

-- Tìm tất cả events trong 1 visit
SELECT 'Conditions' AS type, COUNT(*) AS count
FROM condition_occurrence WHERE visit_occurrence_id = 50001
UNION ALL
SELECT 'Drugs', COUNT(*)
FROM drug_exposure WHERE visit_occurrence_id = 50001
UNION ALL
SELECT 'Measurements', COUNT(*)
FROM measurement WHERE visit_occurrence_id = 50001
UNION ALL
SELECT 'Procedures', COUNT(*)
FROM procedure_occurrence WHERE visit_occurrence_id = 50001;

CDM 5.4 cũng thêm visit_detail_id vào nhiều bảng clinical — cho biết event xảy ra ở khoa nào trong visit:

-- Xét nghiệm nào thực hiện tại ICU?
SELECT m.*
FROM measurement m
JOIN visit_detail vd ON m.visit_detail_id = vd.visit_detail_id
WHERE vd.care_site_id = 2030;  -- ICU

5. preceding_visit_occurrence_id — Chuỗi visits

Cột preceding_visit_occurrence_id tạo linked list giữa các visits:

  Visit 1 (2024-01-15, Outpatient)
      │
      └──→ Visit 2 (2024-03-20, Outpatient)
               │    preceding_visit_occurrence_id = Visit 1
               └──→ Visit 3 (2024-06-10, Inpatient)
                        preceding_visit_occurrence_id = Visit 2

-- Timeline visits của 1 bệnh nhân
WITH RECURSIVE visit_chain AS (
    SELECT visit_occurrence_id, visit_start_date,
           visit_concept_id, preceding_visit_occurrence_id, 1 AS seq
    FROM visit_occurrence
    WHERE person_id = 100001 AND preceding_visit_occurrence_id IS NULL
    UNION ALL
    SELECT vo.visit_occurrence_id, vo.visit_start_date,
           vo.visit_concept_id, vo.preceding_visit_occurrence_id, vc.seq + 1
    FROM visit_occurrence vo
    JOIN visit_chain vc ON vo.preceding_visit_occurrence_id = vc.visit_occurrence_id
)
SELECT * FROM visit_chain ORDER BY seq;

6. ETL Conventions cho Visit

6.1. Quy tắc chung

Quy tắc	Chi tiết
1 encounter = 1 visit	Mỗi lần tiếp xúc = 1 VISIT_OCCURRENCE
Outpatient cùng ngày	Có thể gộp thành 1 visit nếu cùng ngày + cùng cơ sở
ER → Inpatient	Dùng concept 262 (ER and Inpatient Visit)
visit_end_date	Nếu outpatient: end_date = start_date
Nếu không có visit	Tạo "dummy visit" concept_id = 0

6.2. Ví dụ ETL cho BV Việt Nam

-- Mapping HIS VN → OMOP VISIT_OCCURRENCE
SELECT
    ROW_NUMBER() OVER() AS visit_occurrence_id,
    bn.person_id,
    CASE
        WHEN kc.loai_kham = 'NOI_TRU' THEN 9201   -- Inpatient
        WHEN kc.loai_kham = 'NGOAI_TRU' THEN 9202  -- Outpatient
        WHEN kc.loai_kham = 'CAP_CUU' THEN 9203    -- ER
        WHEN kc.loai_kham = 'KHAM_TU_XA' THEN 581477 -- Telehealth
        ELSE 0  -- Unknown
    END AS visit_concept_id,
    kc.ngay_vao AS visit_start_date,
    COALESCE(kc.ngay_ra, kc.ngay_vao) AS visit_end_date,
    32817 AS visit_type_concept_id,  -- EHR
    kc.ma_kham AS visit_source_value
FROM kcb_his kc
JOIN person_mapping bn ON kc.ma_bn = bn.source_id;

7. SQL phân tích thường dùng

-- Phân bố loại visit
SELECT
    c.concept_name AS visit_type,
    COUNT(*) AS count,
    ROUND(COUNT(*) * 100.0 / SUM(COUNT(*)) OVER(), 1) AS pct
FROM visit_occurrence vo
JOIN concept c ON vo.visit_concept_id = c.concept_id
GROUP BY c.concept_name
ORDER BY count DESC;

-- Thời gian nằm viện trung bình (Length of Stay)
SELECT
    ROUND(AVG(visit_end_date - visit_start_date), 1) AS avg_los_days
FROM visit_occurrence
WHERE visit_concept_id = 9201;  -- Inpatient only

-- Số visit trung bình mỗi bệnh nhân
SELECT
    ROUND(AVG(visit_count), 1) AS avg_visits_per_patient
FROM (
    SELECT person_id, COUNT(*) AS visit_count
    FROM visit_occurrence
    GROUP BY person_id
) sub;

Tổng kết

VISIT_OCCURRENCE ghi nhận mỗi lần BN tiếp xúc hệ thống y tế
Loại Visit: Inpatient (9201), Outpatient (9202), ER (9203), Telehealth (581477)
VISIT_DETAIL: chi tiết khoa/phòng trong 1 visit (đặc biệt nhập viện)
Mọi clinical events liên kết vào visit qua visit_occurrence_id
preceding_visit_occurrence_id: tạo chuỗi visits theo thời gian
admitted_from / discharged_to: tracking luồng BN vào-ra

Bài tiếp theo: Bắt đầu khám phá sự kiện lâm sàng đầu tiên — CONDITION_OCCURRENCE — chẩn đoán và bệnh lý.

Bài 6: VISIT_OCCURRENCE & VISIT_DETAIL — Lượt khám & Chi tiết