FHIR Developer Skill

• Está construyendo endpoints REST de FHIR (Patient, Observation, Encounter, Condition, MedicationRequest) y necesita requisitos de campos y conjuntos de valores correctos según la especificación.
• Necesita implementar códigos de estado HTTP adecuados y respuestas de error OperationOutcome para un servidor FHIR.
• Está integrando la autorización OAuth de SMART on FHIR y necesita una sintaxis de alcance correcta y patrones de aplicación.
• Está trabajando con FHIR Bundles (transaction, batch, searchset) o implementando paginación de búsqueda.

• Estás trabajando con FHIR DSTU2 o STU3 — esta habilidad está orientada específicamente a R4.
• Necesitas un servidor FHIR activo o una solución de almacenamiento de datos; esta habilidad proporciona únicamente orientación para el desarrollo, no infraestructura.
• Tu proyecto no tiene datos de salud ni requisitos de API de FHIR.

Proporciona tablas de cardinalidad autoritativas de campos requeridos para Patient, Observation, Encounter, Condition, MedicationRequest, Medication y Bundle — previniendo errores comunes como tratar campos opcionales como requeridos.

Cubre todos los value sets clave (Observation.status, Encounter.status/class, Condition.clinicalStatus, MedicationRequest.status/intent, Bundle.type, Patient.gender) con la respuesta 422 correcta para valores de enumeración no válidos.

Orientación precisa sobre cuándo usar 200, 201, 204, 400, 401, 403, 404, 412 y 422 — incluyendo la distinción crítica entre 412 Precondition Failed para discrepancias de ETag y 422 para errores de validación.

Estructuras JSON de OperationOutcome listas para usar y fragmentos de código para Python/FastAPI y TypeScript/Express, garantizando que todas las respuestas de error sean conformes con FHIR.

URLs de sistema canónicas para LOINC, SNOMED CT, RxNorm, ICD-10 y sistemas de terminología HL7, además de códigos LOINC de signos vitales comunes para consulta rápida.

Referencias para la aplicación de ámbitos OAuth, operaciones de creación/actualización condicional, semántica de Bundles de transacción frente a lote, y patrones de paginación de resultados de búsqueda.

Pide al asistente que genere la estructura de un endpoint POST /Observation con validación correcta de estado, respuestas de error 422 y formato OperationOutcome en FastAPI o Express.

Pega el código de tu endpoint FHIR existente y pide al asistente que identifique las infracciones, como códigos de estado incorrectos, encabezados Location faltantes o tipos de datos incorrectos en Encounter.class.

Obtén orientación sobre la sintaxis de alcances OAuth (v1/v2), flujos de servicios backend y lógica de aplicación de alcances para proteger los endpoints FHIR.

Utiliza la referencia del script de inicio rápido integrado para generar un proyecto FastAPI con modelos Pydantic v2 correctos, helpers de OperationOutcome y endpoints CRUD de Patient.