FHIR Developer Skill

• Você está construindo endpoints REST FHIR (Patient, Observation, Encounter, Condition, MedicationRequest) e precisa de requisitos de campos e conjuntos de valores corretos conforme a especificação.
• Você precisa implementar códigos de status HTTP adequados e respostas de erro OperationOutcome para um servidor FHIR.
• Você está integrando autorização OAuth SMART on FHIR e precisa de sintaxe de escopo correta e padrões de aplicação.
• Você está trabalhando com FHIR Bundles (transaction, batch, searchset) ou implementando paginação de busca.

• Você está trabalhando com FHIR DSTU2 ou STU3 — esta skill tem como alvo especificamente o R4.
• Você precisa de um servidor FHIR ativo ou solução de armazenamento de dados; esta skill fornece apenas orientação de desenvolvimento, não infraestrutura.
• Seu projeto não possui dados de saúde ou requisitos de API FHIR.

Fornece tabelas autoritativas de cardinalidade de campos obrigatórios para Patient, Observation, Encounter, Condition, MedicationRequest, Medication e Bundle — prevenindo erros comuns como tratar campos opcionais como obrigatórios.

Abrange todos os principais value sets (Observation.status, Encounter.status/class, Condition.clinicalStatus, MedicationRequest.status/intent, Bundle.type, Patient.gender) com a resposta 422 correta para valores de enum inválidos.

Orientação precisa sobre quando usar 200, 201, 204, 400, 401, 403, 404, 412 e 422 — incluindo a distinção crítica entre 412 Precondition Failed para incompatibilidades de ETag e 422 para erros de validação.

Estruturas JSON de OperationOutcome prontas para uso e trechos de código para Python/FastAPI e TypeScript/Express, garantindo que todas as respostas de erro sejam compatíveis com FHIR.

URLs canônicas de sistema para LOINC, SNOMED CT, RxNorm, ICD-10 e sistemas de terminologia HL7, além de códigos LOINC comuns de sinais vitais para referência rápida.

Referências para aplicação de escopos OAuth, operações de criação/atualização condicional, semântica de Bundles de transação versus lote e padrões de paginação de resultados de busca.

Peça ao assistente para criar a estrutura de um endpoint POST /Observation com validação correta de status, respostas de erro 422 e formatação de OperationOutcome no FastAPI ou Express.

Cole o código do seu endpoint FHIR existente e peça ao assistente para identificar violações — como códigos de status incorretos, cabeçalhos Location ausentes ou tipos de dados incorretos em Encounter.class.

Obtenha orientações sobre sintaxe de escopo OAuth (v1/v2), fluxos de serviço backend e lógica de aplicação de escopo para proteger endpoints FHIR.

Use a referência do script de início rápido integrado para gerar um projeto FastAPI com modelos Pydantic v2 corretos, helpers de OperationOutcome e endpoints CRUD de Patient.