1. 患者リソース — 医療データセンター
患者 は FHIR の最も重要なリソースです。ほぼすべての臨床データが患者に関連付けられています。これはレベルアップする最初のリソースでもあります 規範的 (安定、下位互換性)。
患者リソースの構造
| 要素 | 種類 | カーディナリティ | 説明 |
|---|---|---|---|
| 識別子 | 識別子[] | 0..* | 識別コード (CCCD、健康保険、MRN...) |
| アクティブな | ブール値 | 0..1 | 録音はアクティブですか? |
| 名前 | 人間名[] | 0..* | 患者さんのフルネーム |
| 電気通信 | 連絡先[] | 0..* | 電話番号、メールアドレス |
| 性別 | コード | 0..1 | 男性 |女性 |その他 |未知。不明 |
| 生年月日 | 日付。日付 | 0..1 | 生年月日 |
| 故人[x] | ブール値/日付時刻 | 0..1 | 紛失しましたか？ |
| 住所 | 住所[] | 0..* | 住所 |
| 婚姻状況 | コード可能なコンセプト | 0..1 | 婚姻状況 |
| 複数の誕生[x] | ブール値/整数 | 0..1 | 双子/三つ子? |
| 写真。写真 | 添付ファイル[] | 0..* | 代表写真 |
| 連絡先。連絡先 | バックボーン要素[] | 0..* | 連絡先担当者 |
| コミュニケーション。コミュニケーション | バックボーン要素[] | 0..* | コミュニケーション言語 |
| 一般開業医 | 参照[] | 0..* | かかりつけ医 |
| 組織の管理 | 参考資料 | 0..1 | 記録管理を整理する |
| リンク。リンク | バックボーン要素[] | 0..* | 別のレコードへのリンク (マージ) |
ベトナム人患者向けの患者リソース — 全例
{
"resourceType": "Patient",
"id": "vn-patient-001",
"meta": {
"profile": ["http://fhir.vn/StructureDefinition/vn-core-patient"]
},
"identifier": [
{
"use": "official",
"type": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "NI",
"display": "National unique individual identifier"
}]
},
"system": "http://fhir.vn/sid/cccd",
"value": "001085012345"
},
{
"use": "secondary",
"type": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "SB",
"display": "Social Beneficiary Identifier"
}]
},
"system": "http://fhir.vn/sid/bhyt",
"value": "DN4850112340001"
},
{
"use": "usual",
"type": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR",
"display": "Medical record number"
}]
},
"system": "http://benhvien-a.vn/sid/mrn",
"value": "BN-2026-00123"
}
],
"active": true,
"name": [
{
"use": "official",
"text": "Nguyễn Văn An",
"family": "Nguyễn",
"given": ["Văn", "An"]
}
],
"telecom": [
{
"system": "phone",
"value": "+84901234567",
"use": "mobile",
"rank": 1
},
{
"system": "email",
"value": "[email protected]",
"use": "home"
}
],
"gender": "male",
"birthDate": "1985-03-15",
"address": [
{
"use": "home",
"type": "physical",
"text": "123 Lê Lợi, Phường Bến Nghé, Quận 1, TP.HCM",
"line": ["123 Lê Lợi"],
"city": "Thành phố Hồ Chí Minh",
"district": "Quận 1",
"state": "Thành phố Hồ Chí Minh",
"postalCode": "700000",
"country": "VN"
}
],
"maritalStatus": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
"code": "M",
"display": "Married"
}],
"text": "Đã kết hôn"
},
"contact": [
{
"relationship": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/v2-0131",
"code": "N",
"display": "Next-of-Kin"
}]
}],
"name": {
"text": "Trần Thị Bình",
"family": "Trần",
"given": ["Thị", "Bình"]
},
"telecom": [{
"system": "phone",
"value": "+84907654321"
}]
}
],
"communication": [{
"language": {
"coding": [{
"system": "urn:ietf:bcp:47",
"code": "vi",
"display": "Vietnamese"
}]
},
"preferred": true
}],
"managingOrganization": {
"reference": "Organization/benhvien-a",
"display": "Bệnh viện Đại học Y Dược TP.HCM"
}
}
ベトナムの識別子パターン
| IDの種類 | システム（URL） | 値の例 |
|---|---|---|
| 国民 ID カード (CCCD) | http://fhir.vn/sid/cccd | 001085012345 |
| 健康保険証 | http://fhir.vn/sid/bhyt | DN4850112340001 |
| 患者コード (MRN) | http://benhvien.vn/sid/mrn | BN-2026-00123 |
| パスポート | http://fhir.vn/sid/passport | C1234567 |
2. 医師向けリソース — 医療スタッフ
開業医 医師、看護師、薬剤師、技術者など、医療に関わるあらゆる個人を表します。
{
"resourceType": "Practitioner",
"id": "dr-tran-001",
"identifier": [{
"system": "http://fhir.vn/sid/physician-license",
"value": "BS-TPHCM-2010-00456"
}],
"active": true,
"name": [{
"use": "official",
"text": "TS.BS Trần Minh Đức",
"family": "Trần",
"given": ["Minh", "Đức"],
"prefix": ["TS.BS"]
}],
"telecom": [{
"system": "phone",
"value": "+84909876543",
"use": "work"
}],
"gender": "male",
"birthDate": "1978-05-20",
"qualification": [
{
"identifier": [{
"system": "http://fhir.vn/sid/medical-degree",
"value": "BSCK2-NKH-2010"
}],
"code": {
"coding": [{
"system": "http://fhir.vn/CodeSystem/qualification",
"code": "BSCK2",
"display": "Bác sĩ Chuyên khoa II"
}]
},
"issuer": {
"display": "Đại học Y Dược TP.HCM"
}
}
],
"communication": [{
"coding": [{
"system": "urn:ietf:bcp:47",
"code": "vi"
}]
}]
}
PractitionerRole — 特定の役割
プラクティショナー役割 特定の組織における開業医の役割について説明します。医師は多くの PractitionerRoles (さまざまな場所で働く) を持つことができます。
{
"resourceType": "PractitionerRole",
"id": "dr-tran-role-bva",
"active": true,
"practitioner": {
"reference": "Practitioner/dr-tran-001",
"display": "TS.BS Trần Minh Đức"
},
"organization": {
"reference": "Organization/benhvien-a",
"display": "Bệnh viện A"
},
"code": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/practitioner-role",
"code": "doctor",
"display": "Doctor"
}]
}],
"specialty": [{
"coding": [{
"system": "http://snomed.info/sct",
"code": "394579002",
"display": "Cardiology"
}],
"text": "Tim mạch"
}],
"location": [{
"reference": "Location/phong-kham-tim-mach"
}],
"availableTime": [{
"daysOfWeek": ["mon", "tue", "wed", "thu", "fri"],
"availableStartTime": "07:30:00",
"availableEndTime": "16:30:00"
}]
}
3. 組織リソース — 医療施設
{
"resourceType": "Organization",
"id": "benhvien-a",
"identifier": [
{
"system": "http://fhir.vn/sid/facility-code",
"value": "79001"
},
{
"system": "http://fhir.vn/sid/bhxh-facility",
"value": "79-001"
}
],
"active": true,
"type": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/organization-type",
"code": "prov",
"display": "Healthcare Provider"
}]
}],
"name": "Bệnh viện Đại học Y Dược TP.HCM",
"alias": ["BV ĐHYD"],
"telecom": [
{
"system": "phone",
"value": "+842838554269",
"use": "work"
},
{
"system": "url",
"value": "https://www.bvdhydtphcm.vn"
}
],
"address": [{
"use": "work",
"line": ["215 Hồng Bàng"],
"city": "Thành phố Hồ Chí Minh",
"district": "Quận 5",
"country": "VN"
}]
}
4. 位置リソース — 位置
場所 物理的な場所を説明します: 診療所、部門、病院のベッド、手術室など。
{
"resourceType": "Location",
"id": "phong-kham-tim-mach",
"status": "active",
"name": "Phòng khám Tim mạch - Tầng 3",
"description": "Phòng khám chuyên khoa Tim mạch, tầng 3 tòa nhà B",
"mode": "instance",
"type": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"code": "CARD",
"display": "Ambulatory Health Care Facilities; Clinic/Center; Rehabilitation: Cardiac Facilities"
}]
}],
"telecom": [{
"system": "phone",
"value": "+842838554269-303"
}],
"address": {
"line": ["Tầng 3, Tòa B, 215 Hồng Bàng"],
"city": "TP.HCM",
"country": "VN"
},
"physicalType": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
"code": "ro",
"display": "Room"
}]
},
"managingOrganization": {
"reference": "Organization/benhvien-a"
}
}
5. 管理リソース間の関係
┌──────────────────┐
│ Organization │ ← Bệnh viện/Phòng khám
│ (benhvien-a) │
└───────┬──────────┘
│ managingOrganization
▼
┌──────────────────┐ ┌──────────────────────┐
│ Location │◄───────│ PractitionerRole │
│ (phong-kham-tm) │ │ (dr-tran-role-bva) │
└──────────────────┘ └───────┬──────────────┘
│ practitioner
▼
┌──────────────────┐
│ Practitioner │
│ (dr-tran-001) │
└──────────────────┘
▲ generalPractitioner
│
┌──────────────────┐
│ Patient │
│ (vn-patient-001) │
└──────────────────┘
6. 実践: 完全なリソース システムを作成する
病院での患者登録という実際的なワークフローを作成してみましょう。
ステップ 1: 組織を作成する
curl -X POST http://localhost:8080/fhir/Organization \
-H "Content-Type: application/fhir+json" \
-d '{"resourceType":"Organization","name":"Bệnh viện Đa khoa A","active":true}'
# Ghi lại id trả về → {org-id}
ステップ 2: プラクティショナーを作成する
curl -X POST http://localhost:8080/fhir/Practitioner \
-H "Content-Type: application/fhir+json" \
-d '{"resourceType":"Practitioner","name":[{"family":"Trần","given":["Minh","Đức"],"prefix":["BS"]}],"active":true}'
# Ghi lại id trả về → {prac-id}
ステップ 3: 組織および医師に関連付けられた患者を作成する
curl -X POST http://localhost:8080/fhir/Patient \
-H "Content-Type: application/fhir+json" \
-d '{
"resourceType": "Patient",
"name": [{"family":"Nguyễn","given":["Thị","Mai"]}],
"gender": "female",
"birthDate": "1992-08-10",
"generalPractitioner": [{"reference":"Practitioner/{prac-id}"}],
"managingOrganization": {"reference":"Organization/{org-id}"}
}'
ステップ 4: 確認 — _include を使用して患者を検索する
# Tìm patient kèm thông tin Practitioner
curl -s "http://localhost:8080/fhir/Patient?_include=Patient:general-practitioner" | jq '.entry[].resource.resourceType'
# Kết quả: "Patient", "Practitioner"
7. まとめ
患者: データセンター、識別子、人口統計、連絡先が含まれます
開業医：医療従事者の個人情報、学位、証明書
プラクティショナー役割: 特定の組織における特定の役割 (1 人が複数の役割を担う)
組織: 病院、診療所、科、部門
場所: 物理的な場所 (部屋、床、ベッド)
リソースは相互にリンクされています 参考文献
使用する 識別子 ベトナムの状況に適したもの（CCCD、健康保険、MRN）