Self Report Shape
Validation constraints for patient-reported daily check-ins and self-assessments. Ensures required timestamping, type classification, and completion tracking.
Report Date
Self-report must have exactly one reportDate timestamp
Report Type
Self-report must specify a reportType (e.g., medication_adherence, symptom_tracking, mood, sleep)
Completion Status
Self-report must have a completionStatus of complete, partial, or skipped
Report Context
Consider adding reportContext to link this report to a tracking plan
Report Notes
Consider adding reportNotes for additional patient context
VO2 Max Statistics Shape
Validation constraints for VO2 Max statistical summaries. Ensures core statistics, fitness classification, and trend analysis fields are present. Supports the dual-path UI pattern where rich statistics are preferred when available.
Mean VO2 Max
VO2 Max statistics must have a mean value (mL/kg/min, >= 0)
VO2 Sample Count
VO2 Max statistics must have at least 1 sample
Fitness Classification
VO2 Max statistics must have a fitnessClassification (veryPoor, poor, fair, good, excellent, or superior)
Period Start
VO2 Max statistics should specify the measurement period start date
Period End
VO2 Max statistics should specify the measurement period end date
Minimum VO2 Max
Consider including minimum VO2 Max for range analysis
Maximum VO2 Max
Consider including maximum VO2 Max for range analysis
VO2 Trend Direction
Consider including vo2TrendDirection for fitness trend analysis
Sparse Data Indicator
Consider setting isSparseData to flag limited measurement periods
HRV Statistics Shape
Validation constraints for Heart Rate Variability (SDNN) statistical summaries. Ensures core statistics and measurement period are present for trend analysis.
Mean HRV
HRV statistics must have a mean value (ms, >= 0)
HRV Sample Count
HRV statistics must have at least 1 sample
HRV statistics must specify the measurement period start date
HRV statistics must specify the measurement period end date
Median HRV
Consider including median HRV for distribution analysis
HRV Standard Deviation
Consider including HRV standard deviation for variability analysis
Minimum HRV
Consider including minimum HRV for range analysis
Maximum HRV
Consider including maximum HRV for range analysis
HRV Trend Direction
Consider including hrvTrendDirection for autonomic nervous system trend analysis
Blood Pressure Statistics Shape
Validation constraints for blood pressure statistical summaries. Ensures mean systolic/diastolic values and AHA category classification are present.
Mean Systolic BP
BP statistics must have a mean systolic value (mmHg, 40-300)
Mean Diastolic BP
BP statistics must have a mean diastolic value (mmHg, 20-200)
BP Category
BP statistics must have an AHA category (normal, elevated, hypertension_stage1, hypertension_stage2, or hypertensive_crisis)
BP Sample Count
BP statistics should include a sample count for data quality assessment
Minimum Systolic BP
Consider including minimum systolic BP for range analysis
Maximum Systolic BP
Consider including maximum systolic BP for range analysis
Minimum Diastolic BP
Consider including minimum diastolic BP for range analysis
Maximum Diastolic BP
Consider including maximum diastolic BP for range analysis
Metric Trend Shape
Validation constraints for time-bounded wellness metric trends. Ensures trend direction is present and encourages confidence and period metadata for proper interpretation.
Trend Direction
Metric trend must have a direction (increasing, decreasing, stable, or insufficient_data)
Trend Confidence
Metric trend should include confidence level (high >30d, medium 14-30d, low <14d)
Trend Period Start
Metric trend should specify the observation period start date
Trend Period End
Metric trend should specify the observation period end date
Trend Magnitude
Consider including trendMagnitude (percentage change) for quantitative trend analysis
Baseline Value
Consider including trendBaselineValue for comparative analysis
Current Value
Consider including trendCurrentValue for comparative analysis
Activity Snapshot Shape
Validation constraints for aggregated activity metrics over a measurement period (typically 7 days). All fields are optional since activity data availability depends on device capabilities.
Average Daily Steps
Activity snapshot should include average daily steps as a primary activity metric
Exercise Minutes (Weekly)
Consider including weekly exercise minutes for fitness context
Stand Hours (Daily)
Consider including daily stand hours for sedentary behavior tracking
Active Energy Burned (kcal)
Consider including active energy burned for caloric expenditure tracking
Sleep Snapshot Shape
Validation constraints for aggregated sleep metrics over a measurement period (typically 7 days). Sleep data availability depends on device capabilities and user behavior.
Average Sleep Duration (hours)
Sleep snapshot should include average duration as a primary sleep metric
Sleep Quality
Consider including sleep quality assessment for comprehensive sleep analysis
Health Profile Shape
Validation constraints for the top-level wellness profile aggregating vital signs, body measurements, activity, and sleep data from consumer devices. Stored at /wellness/ in the Cascade Pod.
Blood Type
Blood type should be a valid ABO/Rh value if provided
Resting Heart Rate History
Consider populating resting heart rate history for cardiac trend analysis
Walking Heart Rate History
Consider populating walking heart rate history for activity-related cardiac trends
HRV History
Consider populating HRV history for autonomic nervous system analysis
Blood Pressure History
Consider populating blood pressure history for cardiovascular trend analysis
VO2 Max History
Consider populating VO2 Max history for fitness trend analysis
Body Mass History
Consider populating body mass history for weight trend analysis
Daily Activity History
Consider populating daily activity history for activity trend analysis
Daily Sleep History
Consider populating daily sleep history for sleep pattern analysis
HRV Statistics
Consider linking HRV statistics for heart rate variability summary
BP Statistics
Consider linking BP statistics for blood pressure summary
Social History Record Shape
Source System
Source system attribution is recommended for social history records
Smoking Status
Smoking status is a key social history field
Lab Result Record Shape
Validation constraints for laboratory result records. Lifted from clinical:LabResultShape and checked against FHIR R4 Observation.
Test Name
Lab result must have exactly one non-empty testName
Result Value
Lab result must not carry more than one resultValue; two readings of the same analyte are two records
Result Unit
Lab result must not carry more than one resultUnit
Reference Range
Interpretation
Interpretation must be a code from the HL7 v3 ObservationInterpretation code system (http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation), a code from http://terminology.hl7.org/CodeSystem/data-absent-reason, or one of the retained health v2.5 words. A source code in none of those is carried verbatim on health:interpretationSourceCode.
Interpretation Source Code
Interpretation source code must be a single string: the source's verbatim code, unmodified
Performed Date must be an xsd:date or an xsd:dateTime. FHIR's dateTime primitive permits date precision (YYYY, YYYY-MM, YYYY-MM-DD), so a source that stated only a calendar day must not be given an invented time; an untyped or xsd:string literal is not either type.
Performed Date
Reported Date must be an xsd:date or an xsd:dateTime. FHIR's dateTime primitive permits date precision (YYYY, YYYY-MM, YYYY-MM-DD), so a source that stated only a calendar day must not be given an invented time; an untyped or xsd:string literal is not either type.
Reported Date
Test Code (LOINC)
Lab Category
Specimen Type
Ordering Provider
Performing Laboratory
Source Record Identifier
Data Provenance
Lab result must declare exactly one valid cascade:dataProvenance
Schema Version
Lab result must declare exactly one schemaVersion in major.minor form
Condition Record Shape
Validation constraints for condition and problem-list records. Lifted from clinical:ConditionShape and checked against FHIR R4 Condition.
Condition Name
Condition must have exactly one non-empty conditionName
Clinical Status
Condition status must be one of the FHIR R4 ConditionClinicalStatusCodes: active, recurrence, relapse, inactive, remission, resolved
Onset Date must be an xsd:date or an xsd:dateTime. FHIR's dateTime primitive permits date precision (YYYY, YYYY-MM, YYYY-MM-DD), so a source that stated only a calendar day must not be given an invented time; an untyped or xsd:string literal is not either type.
Onset Date
ICD-10-CM Code
SNOMED CT Code
Condition Class
Monitored Vital Signs
Monitored vital signs must be a single rdf:List, not repeated
Condition must declare exactly one valid cascade:dataProvenance
Condition must declare exactly one schemaVersion in major.minor form
Allergy Record Shape
Validation constraints for allergy and intolerance records. Lifted from clinical:AllergyShape and checked against FHIR R4 AllergyIntolerance.
Allergen
Allergy must specify exactly one non-empty allergen
Reaction
Allergy Severity
Allergy severity must be one of the FHIR R4 AllergyIntoleranceSeverity codes: mild, moderate, severe
Allergy Category
Allergy category must be one of the FHIR R4 AllergyIntoleranceCategory codes: food, medication, environment, biologic
Allergy must declare exactly one valid cascade:dataProvenance
Allergy must declare exactly one schemaVersion in major.minor form
Immunization Record Shape
Validation constraints for immunization records. Lifted from clinical:ImmunizationShape and checked against FHIR R4 Immunization.
Vaccine Name
Immunization must have exactly one non-empty vaccineName
Administration Date must be an xsd:date or an xsd:dateTime. FHIR's dateTime primitive permits date precision (YYYY, YYYY-MM, YYYY-MM-DD), so a source that stated only a calendar day must not be given an invented time; an untyped or xsd:string literal is not either type.
Administration Date
Status
Immunization status must be one of the FHIR R4 ImmunizationStatusCodes: completed, entered-in-error, not-done
Vaccine Code
Manufacturer
Lot Number
Immunization must not carry more than one lotNumber; a lot number identifies a single administered dose
Dose Quantity
Route
Administration Site
Administering Provider
Administering Location
Immunization must declare exactly one valid cascade:dataProvenance
Immunization must declare exactly one schemaVersion in major.minor form
Family History Record Shape
Validation constraints for family history records. Derived from FHIR R4 FamilyMemberHistory.
Family history record must name exactly one condition
Relationship
Family history record must state exactly one relationship to the patient
Onset Age
Onset age must be a single integer between 0 and 130
Family history record must declare exactly one valid cascade:dataProvenance
Family history record must declare exactly one schemaVersion in major.minor form
Daily Vital Reading Shape
Validation constraints for a single day's aggregated vital sign reading inside a history container.
Daily vital reading must carry a timestamp as either cascade:date or health:date
Date
Sample Count
Sample count must be a single non-negative integer
Value
Daily vital reading must not carry more than one value
Unit
LOINC Code
Daily Activity Snapshot Shape
Validation constraints for a single day's activity metrics.
Daily activity snapshot must carry exactly one cascade:date
Steps
Steps must be a single non-negative integer
Active Energy (kcal)
Active energy must be a single non-negative decimal
Exercise Minutes
Exercise minutes must be a single integer between 0 and 1440
Stand Hours
Stand hours must be a single integer between 0 and 24
Daily Sleep Snapshot Shape
Validation constraints for a single night's sleep metrics.
Daily sleep snapshot must carry exactly one cascade:date
Sleep Duration (hours)
Sleep duration must be a single decimal between 0 and 24 hours
Sleep quality must be one of health:Excellent, health:Good, health:Fair, health:Poor