# Governance cho Organization và Location - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Governance cho Organization và Location

# Quản trị Organization và Location — Organization and Location Governance

Ngữ nghĩa pháp lý của các thuộc tính `Organization` và `Location` trong VN Core: ranh giới giữa hai resource, extension phản ánh pháp lý hiện hành và extension chỉ giữ cho dữ liệu lịch sử.

-------

## Mô hình phân tách

VN Core tách dứt khoát 4 khái niệm:

| | | | |
| :--- | :--- | :--- | :--- |
| **Hạng pháp lý của cơ sở KCB** | [VNHospitalRankCS](CodeSystem-vn-hospital-rank-cs.md),[VNCoreExtOrgRank](StructureDefinition-vn-ext-org-rank.md) | TT 06/2024/TT-BYT | Bệnh viện, phòng khám, cơ sở KCB có xếp hạng |
| **Hạng pháp lý của đơn vị y tế không phải cơ sở KCB** | [VNHealthUnitRankCS](CodeSystem-vn-health-unit-rank-cs.md),[VNCoreExtHealthUnitRank](StructureDefinition-vn-ext-health-unit-rank.md) | TT 06/2024/TT-BYT | Y tế dự phòng, TTYT, kiểm nghiệm, kiểm định |
| **Cấp KCB hiện hành** | [VNFacilityCareLevelCS](CodeSystem-vn-facility-care-level-cs.md),[VNCoreExtFacilityCareLevel](StructureDefinition-vn-ext-facility-care-level.md) | Luật KCB 2023, NĐ 96/2023/NĐ-CP | Organization, Location |
| **Tuyến chuyên môn kỹ thuật lịch sử** | [VNLegacyTechnicalLineCS](CodeSystem-vn-legacy-technical-line-cs.md),[VNCoreExtLegacyTechnicalLine](StructureDefinition-vn-ext-legacy-technical-line.md) | TT 43/2013/TT-BYT, TT 23/2024/TT-BYT | Dữ liệu lịch sử / chuyển đổi |

[VNCoreExtOrgLevel](StructureDefinition-vn-ext-org-level.md) chỉ còn mang nghĩa **cấp quản lý hành chính y tế hiện hành**, không dùng thay cho tuyến kỹ thuật cũ.

-------

## Khoa/Phòng (OrganizationDepartment)

[VNCoreOrganizationDepartment](StructureDefinition-vn-core-organization-department.md) biểu diễn khoa/phòng nội bộ của một cơ sở y tế, ví dụ Khoa Nội Tim mạch, Khoa Chẩn đoán hình ảnh, Khoa Xét nghiệm hoặc Khoa Dược.

### Khi nào dùng

* Dùng cho **khoa/phòng chuyên môn nội bộ** thuộc một cơ sở KCB.
* Dùng khi cần biểu diễn `MA_KHOA` trong XML đầu ra KCB hoặc đối soát bảng kê chi phí.
* Dùng khi `Encounter`, `PractitionerRole`, `Claim.item` hoặc báo cáo cận lâm sàng cần chỉ rõ khoa thực hiện.

### Khi nào không dùng

* Không dùng cho cơ sở y tế chính như bệnh viện, phòng khám, TTYT; trường hợp này dùng [VNCoreOrganization](StructureDefinition-vn-core-organization.md).
* Không dùng cho vị trí vật lý như phòng khám, buồng bệnh, phòng chụp; trường hợp này dùng [VNCoreLocation](StructureDefinition-vn-core-location.md).

### Quy tắc chính

* Parent là FHIR `Organization` base, tách riêng và **không** extend [VNCoreOrganization](StructureDefinition-vn-core-organization.md), tương tự pattern tách department khỏi organization chính trong các IG quốc gia.
* `type` fixed `dept` từ `http://terminology.hl7.org/CodeSystem/organization-type`.
* Invariant `vn-org-dept-partof-required` có severity `error`: `partOf` phải tham chiếu cơ sở y tế chủ quản.
* `identifier` có slice `departmentCode` dùng [VNDepartmentCS](CodeSystem-vn-department-cs.md) cho mã `K01`-`K53`, `K99` theo **QĐ 2010/QĐ-BYT ngày 19/06/2025 Phụ lục 6**.
* `identifier` có slice `localCode` cho mã khoa/phòng cục bộ của bệnh viện, phục vụ mapping HIS/EMR nội bộ.

Căn cứ triển khai: **QĐ 2010/QĐ-BYT ngày 19/06/2025 Phụ lục 6** ban hành tạm thời danh mục mã khoa dùng chung; **QĐ 3176/QĐ-BYT ngày 29/10/2024** duy trì trường `MA_KHOA` trong dữ liệu đầu ra KCB.

-------

## Khi nào dùng từng extension

### VNCoreExtOrgRank

* Dùng khi cơ sở là **cơ sở khám bệnh, chữa bệnh** và đã có hạng pháp lý theo TT 06/2024/TT-BYT.
* Không dùng cho CDC, TTYT, đơn vị kiểm nghiệm/kiểm định.
* Không dùng để biểu diễn `chưa xếp hạng`.

### VNCoreExtHealthUnitRank

* Dùng cho **đơn vị sự nghiệp y tế không phải cơ sở KCB** theo Phụ lục II, III, IV của TT 06/2024/TT-BYT.
* Không dùng cho bệnh viện/phòng khám nếu đã có hạng KCB riêng.

### VNCoreExtOrgRankStatus

* Dùng khi cần phân biệt: 
* Đã xếp hạng
* Chưa xếp hạng
* Không áp dụng
 
* Extension này không thay thế hạng pháp lý.

### VNCoreExtFacilityCareLevel

* Dùng cho 3 cấp KCB hiện hành: `ban đầu`, `cơ bản`, `chuyên sâu`.
* Có thể đặt ở `Organization` hoặc `Location`.
* Không dùng để thay thế hạng pháp lý hoặc cấp quản lý hành chính.

### VNCoreExtLegacyTechnicalLine

* Chỉ dùng cho dữ liệu cũ hoặc bài toán chuyển đổi từ HIS lịch sử.
* Không dùng làm nguồn chính cho hệ thống mới.

-------

## Gợi ý theo loại hình tổ chức

| | | | | |
| :--- | :--- | :--- | :--- | :--- |
| Bệnh viện | Có thể có | Không | Nên có | Chỉ khi là dữ liệu lịch sử |
| Phòng khám | Có thể có hoặc chưa xếp hạng | Không | Nên có | Chỉ khi là dữ liệu lịch sử |
| Trạm y tế | Thường không áp dụng | Không | Nên có (`ban đầu`) | Chỉ khi là dữ liệu lịch sử |
| Trung tâm y tế | Không dùng rank KCB nếu đang mô hình như đơn vị sự nghiệp y tế | Có thể có | Có thể có | Có thể có |
| CDC / đơn vị dự phòng | Không | Có thể có | Thường không áp dụng | Không bắt buộc |

-------

## Ví dụ tham chiếu

* [BV Chợ Rẫy](Organization-ExampleOrganizationChoRay.md)
* [Phòng khám tư nhân chưa xếp hạng](Organization-ExampleOrganizationPrivateClinic.md)
* [Trạm Y tế](Organization-ExampleOrganizationTramYTe.md)
* [TTYT hạng IV](Organization-ExampleOrganizationTTYTHangIV.md)
* [CDC tỉnh](Organization-ExampleOrganizationPreventiveCenter.md)
* [Dữ liệu lịch sử tuyến huyện](Organization-ExampleOrganizationLegacyTechnicalLine.md)

-------

## Liên hệ với các trang khác

| | |
| :--- | :--- |
| Xem chi tiết hồ sơ Organization và Location | [Danh mục hồ sơ](profiles.md) |
| Tra cứu extension dùng cho hạng, cấp, tuyến của cơ sở | [Danh mục extension](extensions.md) |
| Hiểu cơ sở pháp lý cho hạng/cấp/tuyến (NĐ 188/2025, NQ 202/2025) | [Cơ sở pháp lý](legal-basis.md) |
| Tra cứu CodeSystem/ValueSet cho hạng, cấp, tuyến | [Danh mục thuật ngữ](terminology.md) |

## English Summary

VN Core separates legal rank, current care level, administrative oversight level, and historical technical line for healthcare organizations. `organizationRank` is reserved for legally ranked care-delivery organizations, `healthUnitRank` is used for non-care-delivery health institutions, `facilityCareLevel` represents the current 3-level care model, and `legacyTechnicalLine` is kept only for migration from historical data.

