Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.3.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Báo cáo triển khai

Báo cáo triển khai — Implementation Reports

Trang này chuẩn hóa nội dung tối thiểu của một báo cáo triển khai cho VN Core FHIR IG. Mục tiêu là giúp cộng đồng rà soát triển khai thử nghiệm theo cùng một khung, tránh báo cáo cảm tính hoặc thiếu dữ liệu tuân thủ.

Trang này dành cho ai?

• Đơn vị đã triển khai hoặc đang thí điểm VN Core và muốn báo cáo lại một cách có cấu trúc.
• Nhóm duy trì IG cần thu thập bằng chứng thực tế trước khi nâng maturity.
• Reviewer cộng đồng cần so sánh các ca triển khai theo cùng một khung thông tin.

1. Khi nào cần báo cáo triển khai?

Báo cáo triển khai nên được tạo khi một bên triển khai:

• Dùng VN Core trong EMR/EHR nội bộ
• Triển khai lớp liên thông hồ sơ BHYT (BHYT Submission)
• Mở FHIR API cho hệ thống khác tích hợp
• Muốn đóng góp phản hồi cho STU1 hoặc chuẩn bị ballot

VN Core định hướng dùng implementation report như bằng chứng thực tế trước khi nâng mức độ trưởng thành cho các tài nguyên cốt lõi.

Trước khi viết implementation report đầy đủ, nên tự rà một vòng bằng Checklist sẵn sàng thí điểm theo vai trò để tránh báo cáo khi phạm vi vai trò triển khai, package hoặc bằng chứng kiểm tra vẫn chưa chốt.

2. Nội dung tối thiểu bắt buộc

Mỗi implementation report nên có tối thiểu các mục sau:

3. Khuyến nghị bổ sung

Các mục dưới đây chưa bắt buộc nhưng rất nên có:

• Số lượng resource thực tế đã trao đổi
• Độ bao phủ theo từng CapabilityStatement
• Danh mục thuật ngữ cục bộ đã phải mở rộng thêm
• Hành vi tìm kiếm đã công bố khác gì so với hướng dẫn mặc định của VN Core
• Bằng chứng về bảo mật: OAuth scopes, audit, lưu giữ dữ liệu, break-glass
• Bằng chứng về đối soát BHYT: MA_LK, SO_CCCD, yyyyMMddHHmm, chuyển đổi khứ hồi XML

4. Mẫu khung báo cáo

# Implementation Report — {Tên đơn vị}

## 1. General
- Implementer:
- Contact:
- Report date:
- Environment:

## 2. VN Core Version
- IG/package:
- Build date:
- Canonical:

## 3. Deployment Scope
- Scope:
- Actor role:
- FHIR server / gateway topology:

## 4. Implemented Artifacts
- Profiles:
- Extensions:
- SearchParameters:
- Operations:
- CapabilityStatement used as baseline:

## 5. Validation Evidence
- `./scripts/validate.sh --quick`:
- `./scripts/validate-tier2.sh`:
- `./scripts/validate-bhyt-roundtrip.sh`:
- External validator / QA findings:

## 6. Legal / Policy Context
- EMR:
- Personal data protection:
- BHYT / payer submission:
- Internal policies:

## 7. Known Gaps / Deviations
- Gap 1:
- Gap 2:

## 8. Feedback to VN Core
- What worked:
- What should change:
- Requested clarifications:

5. Nguyên tắc biên tập

• Ghi rõ cái gì là implemented, cái gì chỉ planned
• Không dùng số liệu marketing; chỉ ghi số liệu đã test hoặc vận hành thật
• Nếu có deviation khỏi profile hoặc CapabilityStatement, phải nêu lý do
• Với lớp BHYT Submission, phải nói rõ gateway layer đang dùng bundle nào, operation nào, và đã test round-trip đến bảng nào

6. Vai trò trong lộ trình ổn định

Implementation reports là đầu vào quan trọng cho:

• Quyết định tài nguyên nào đủ điều kiện nâng mức độ trưởng thành
• Xác định profile nào còn khó triển khai
• Ưu tiên sửa Must Support, search behavior, hoặc terminology
• Chuẩn bị rà soát cộng đồng và ballot

Trong giai đoạn thử nghiệm hiện tại, VN Core ưu tiên ít report nhưng đủ bằng chứng hơn là nhiều report mang tính mô tả chung chung.

English Summary

This page defines a minimum implementation-report template for VN Core FHIR IG. A report should identify the implementer, the package/version used, deployment scope (VN Core Base, BHYT Submission, or both), actor role, implemented profiles/search parameters/operations, validation evidence, legal context, known gaps, and concrete feedback. These reports are intended to provide structured evidence before raising maturity levels or moving toward ballot/publication.