Polaris Profile Registry¶

Quick reference for all Polaris FHIR profiles. Check here first before creating a new profile!

Core Clinical Resources¶

Patient Demographics¶

Profile	Purpose	Key Features	Example Use
PolarisCorePatient	Core patient demographics	PHN support, multiple identifiers	All patient references

Clinical Documentation¶

Profile	Purpose	Key Features	Example Use
PolarisCoreCondition	Diagnoses and problems	Raw code preservation, clinical status	Problem lists, diagnoses
PolarisCoreObservation	Measurements and findings	Component support, categories	Vitals, lab results
PolarisCoreProcedure	Clinical procedures	Status tracking, performer refs	Surgeries, interventions
PolarisCoreAllergyIntolerance	Allergies and intolerances	Criticality, verification	Allergy lists
PolarisCoreImmunization	Vaccination records	Vaccine codes, dates	Immunization history

Medications¶

Profile	Purpose	Key Features	Example Use
PolarisCoreMedicationRequest	Prescriptions	Dosage, duration, refills	Current medications
PolarisCoreMedicationDispense	Dispensed medications	Quantity, days supply	Pharmacy records

Encounters & Appointments¶

Profile	Purpose	Key Features	Example Use
PolarisCoreEncounter	Clinical visits	Visit types, locations	Office visits, admissions
PolarisCoreAppointment	Scheduled appointments	Status, participants	Future appointments

Diagnostic Results¶

Profile	Purpose	Key Features	Example Use
PolarisCoreDiagnosticReport	Test results	Multiple observations, conclusions	Lab panels, imaging
PolarisCoreServiceRequest	Test orders	Priority, instructions	Lab orders, referrals

Clinical Reasoning¶

Profile	Purpose	Key Features	Example Use
PolarisCoreClinicalImpression	Clinical assessments	Summary, prognosis	Care plans, assessments

Administrative Resources¶

Organizations & Providers¶

Profile	Purpose	Key Features	Example Use
PolarisCoreOrganization	Healthcare organizations	Identifiers, contact info	Clinics, hospitals
PolarisCorePractitioner	Healthcare providers	Qualifications, identifiers	Doctors, nurses
PolarisCorePractitionerRole	Provider roles	Specialties, locations	Role assignments
PolarisCoreLocation	Physical locations	Address, position	Clinic locations

Devices & Systems¶

Profile	Purpose	Key Features	Example Use
PolarisCoreEmrDevice	EMR systems	Version, manufacturer	Data provenance

Documents¶

Profile	Purpose	Key Features	Example Use
PolarisCoreDocumentReference	Clinical documents	Content, format	Reports, images

Special Purpose Resources¶

Panel Management¶

Profile	Purpose	Key Features	Example Use
PolarisCoreRosterPanel	Patient panels	Panel assignments	Primary care panels

Application State¶

Profile	Purpose	Key Features	Example Use
PolarisCoreAppState	UI state tracking	State codes, context	App preferences

Decision Tree: Do I Need a New Profile?¶

graph TD
    A[Need to represent data] --> B{Existing profile covers it?}
    B -->|Yes| C[Use existing profile]
    B -->|No| D{Can extend existing?}
    D -->|Yes| E[Create minimal constraints]
    D -->|No| F{Similar to CA-Core?}
    F -->|Yes| G[Extend CA-Core profile]
    F -->|No| H{Truly unique need?}
    H -->|Yes| I[Create new profile]
    H -->|No| J[Reconsider approach]

Before Creating a New Profile¶

Search this registry - Is there already a profile for your use case?
Check CA-Core - Does CA-Core have a suitable profile?
Consider extensions - Can you add an extension to existing profile?
Discuss with team - Post in Slack or email Shawn
Document rationale - Why existing profiles don't work

Common Patterns to Reuse¶

Identifier Pattern¶

All Polaris profiles use:

* identifier 1..* MS
* obeys [resource]-has-polaris-id

Status Elements¶

Most clinical resources need:

* status MS
* status from [appropriate-value-set] (required)

Subject References¶

Patient references always use:

* subject only Reference(PolarisCorePatient)
* subject 1..1 MS
* subject.identifier 1..1 MS

Coding Pattern¶

For coded elements with raw preservation:

* code.coding ^slicing.discriminator.type = #value
* code.coding ^slicing.discriminator.path = "system"
* code.coding contains
    standard 0..1 MS and
    raw 0..1 MS

Adding to This Registry¶

When you create a new profile: 1. Add it to the appropriate section 2. Include purpose and key features 3. Provide example use cases 4. Update the count at the top

Last Updated: 2025-01-15
Total Profiles: 21
Maintainer: Shawn Vincent (shawn.vincent@well.company)