FHIR Developer Skill

• FHIR REST 엔드포인트(Patient, Observation, Encounter, Condition, MedicationRequest)를 구축하고 있으며 사양에 맞는 필드 요구사항과 값 집합이 필요합니다.
• FHIR 서버에 적합한 HTTP 상태 코드와 OperationOutcome 오류 응답을 구현해야 합니다.
• SMART on FHIR OAuth 인증을 통합하고 있으며 올바른 스코프 구문과 적용 패턴이 필요합니다.
• FHIR 번들(transaction, batch, searchset) 작업을 수행하거나 검색 페이지네이션을 구현하고 있습니다.

• FHIR DSTU2 또는 STU3로 작업하고 있는 경우 — 이 스킬은 R4를 특정 대상으로 합니다.
• 실제 FHIR 서버 또는 데이터 스토리지 솔루션이 필요한 경우; 이 스킬은 개발 지침만 제공하며 인프라는 제공하지 않습니다.
• 프로젝트에 의료 데이터 또는 FHIR API 요구 사항이 없는 경우.

Patient, Observation, Encounter, Condition, MedicationRequest, Medication, Bundle에 대한 신뢰할 수 있는 필수 필드 카디널리티 표를 제공하며, 선택적 필드를 필수로 잘못 처리하는 등의 일반적인 실수를 방지합니다.

모든 주요 값 집합(Observation.status, Encounter.status/class, Condition.clinicalStatus, MedicationRequest.status/intent, Bundle.type, Patient.gender)을 다루며, 유효하지 않은 열거형 값에 대해 올바른 422 응답을 반환합니다.

200, 201, 204, 400, 401, 403, 404, 412, 422를 언제 사용해야 하는지에 대한 정확한 안내 — ETag 불일치에 대한 412 Precondition Failed와 유효성 검사 오류에 대한 422의 중요한 차이점을 포함합니다.

Python/FastAPI 및 TypeScript/Express를 위한 즉시 사용 가능한 OperationOutcome JSON 구조와 코드 스니펫으로, 모든 오류 응답이 FHIR 규격을 준수하도록 보장합니다.

LOINC, SNOMED CT, RxNorm, ICD-10 및 HL7 용어 체계에 대한 표준 시스템 URL과 빠른 참조를 위한 일반적인 활력징후 LOINC 코드를 제공합니다.

OAuth 범위 적용, 조건부 생성/업데이트 작업, 트랜잭션 대 배치 번들 의미론, 그리고 검색 결과 페이지네이션 패턴에 대한 참고 자료입니다.

어시스턴트에게 FastAPI 또는 Express에서 올바른 상태 유효성 검사, 422 오류 응답, 그리고 OperationOutcome 형식을 갖춘 POST /Observation 엔드포인트의 기본 구조를 생성해 달라고 요청하세요.

기존 FHIR 엔드포인트 코드를 붙여넣고 어시스턴트에게 위반 사항을 식별하도록 요청하세요 — 잘못된 상태 코드, 누락된 Location 헤더, 또는 잘못된 Encounter.class 데이터 유형 등이 해당됩니다.

OAuth 범위 구문(v1/v2), 백엔드 서비스 흐름, 그리고 FHIR 엔드포인트 보안을 위한 범위 적용 로직에 대한 안내를 받아보세요.

내장된 빠른 시작 스크립트 참조를 활용하여 올바른 Pydantic v2 모델, OperationOutcome 헬퍼, 그리고 Patient CRUD 엔드포인트가 포함된 FastAPI 프로젝트를 생성하세요.