# VN Core Citizen App Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client ứng dụng người dân - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## CapabilityStatement: VN Core Citizen App Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client ứng dụng người dân (Thử nghiệm) 

 
Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho ứng dụng người dân/cổng công dân/kết nối VNeID. Tập trung vào truy cập hồ sơ cá nhân, giấy tờ lâm sàng, `Consent` và lịch sử truy cập. / Minimum conformance requirements for citizen-facing or VNeID-connected apps. 

 [Raw OpenAPI-Swagger Definition file](../vn-core-citizen-app-client.openapi.json) | [Tải xuống](../vn-core-citizen-app-client.openapi.json) 



## Resource Content

```json
{
  "resourceType" : "CapabilityStatement",
  "id" : "vn-core-citizen-app-client",
  "url" : "http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-citizen-app-client",
  "version" : "0.5.0",
  "name" : "VNCitizenAppClientCapabilityStatement",
  "title" : "VN Core Citizen App Client CapabilityStatement",
  "status" : "draft",
  "experimental" : true,
  "date" : "2026-03-23",
  "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
  "contact" : [{
    "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.org.vn"
    },
    {
      "system" : "email",
      "value" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho ứng dụng người dân/cổng công dân/kết nối VNeID. Tập trung vào truy cập hồ sơ cá nhân, giấy tờ lâm sàng, `Consent` và lịch sử truy cập. / Minimum conformance requirements for citizen-facing or VNeID-connected apps.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "kind" : "requirements",
  "fhirVersion" : "4.0.1",
  "format" : ["json", "xml"],
  "rest" : [{
    "mode" : "client",
    "documentation" : "Ứng dụng người dân chỉ nên truy cập theo patient compartment của chính chủ thể dữ liệu hoặc người đại diện hợp pháp.",
    "security" : {
      "service" : [{
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/restful-security-service",
          "code" : "SMART-on-FHIR",
          "display" : "SMART-on-FHIR"
        }]
      }],
      "description" : "Khuyến nghị khởi chạy ứng dụng theo SMART-on-FHIR với scope tối thiểu `patient/*.read`, `patient/Consent.*`, audit bắt buộc và kiểm soát truy cập qua người giám hộ/RelatedPerson."
    },
    "resource" : [{
      "type" : "Patient",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token"
      }]
    },
    {
      "type" : "RelatedPerson",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      }]
    },
    {
      "type" : "Coverage",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "beneficiary",
        "type" : "reference"
      }]
    },
    {
      "type" : "DocumentReference",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      }]
    },
    {
      "type" : "Consent",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      }]
    },
    {
      "type" : "AuditEvent",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-event",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      }]
    }]
  }]
}

```
