FHIR Developer Skill

• Stai creando endpoint REST FHIR (Patient, Observation, Encounter, Condition, MedicationRequest) e hai bisogno di requisiti di campo e set di valori conformi alle specifiche.
• Devi implementare codici di stato HTTP corretti e risposte di errore OperationOutcome per un server FHIR.
• Stai integrando l'autorizzazione OAuth SMART on FHIR e hai bisogno della sintassi degli scope corretta e dei pattern di applicazione.
• Stai lavorando con i Bundle FHIR (transaction, batch, searchset) o stai implementando la paginazione delle ricerche.

• Stai lavorando con FHIR DSTU2 o STU3 — questa skill è destinata specificamente a R4.
• Hai bisogno di un server FHIR attivo o di una soluzione di archiviazione dati; questa skill fornisce solo indicazioni per lo sviluppo, non infrastruttura.
• Il tuo progetto non ha requisiti di dati sanitari o API FHIR.

Fornisce tabelle autorevoli di cardinalità per i campi obbligatori di Patient, Observation, Encounter, Condition, MedicationRequest, Medication e Bundle — prevenendo errori comuni come il trattare campi opzionali come obbligatori.

Copre tutti i principali value set (Observation.status, Encounter.status/class, Condition.clinicalStatus, MedicationRequest.status/intent, Bundle.type, Patient.gender) con la corretta risposta 422 per valori enum non validi.

Indicazioni precise su quando utilizzare 200, 201, 204, 400, 401, 403, 404, 412 e 422 — inclusa la distinzione fondamentale tra 412 Precondition Failed per i mismatch di ETag e 422 per gli errori di validazione.

Strutture JSON OperationOutcome pronte all'uso e frammenti di codice per Python/FastAPI e TypeScript/Express, per garantire che tutte le risposte di errore siano conformi a FHIR.

URL canonici dei sistemi per LOINC, SNOMED CT, RxNorm, ICD-10 e i sistemi di terminologia HL7, oltre ai codici LOINC comuni per i segni vitali per una consultazione rapida.

Riferimenti per l'applicazione degli scope OAuth, le operazioni di creazione/aggiornamento condizionale, la semantica dei Bundle di tipo transaction vs. batch e i pattern di paginazione dei risultati di ricerca.

Chiedi all'assistente di generare lo scaffolding di un endpoint POST /Observation con la corretta validazione dello stato, risposte di errore 422 e formattazione OperationOutcome in FastAPI o Express.

Incolla il codice del tuo endpoint FHIR esistente e chiedi all'assistente di identificare le violazioni — come codici di stato errati, header Location mancanti o tipi di dati Encounter.class non corretti.

Ottieni indicazioni sulla sintassi degli scope OAuth (v1/v2), i flussi per i servizi backend e la logica di applicazione degli scope per proteggere gli endpoint FHIR.

Utilizza il riferimento allo script di avvio rapido integrato per generare un progetto FastAPI con modelli Pydantic v2 corretti, helper OperationOutcome ed endpoint CRUD per Patient.