Cascade Checkup Vocabulary
type: Ontology
description: Structured health data for patient intake forms and pre-visit preparation. Enables aggregation of EHR, HealthKit, and manually entered health data.
creator: Cascade Agentic Labs
created: 2026-01-03
modified: 2026-08-08
version info: 3.3

Intake Form Data
type: Class
comment: Aggregated patient data formatted for healthcare intake forms. Contains all sections needed for a complete pre-visit profile including demographics, medications, allergies, conditions, and visit concerns.
sub concern: intake

Insurance Information
type: Class
comment: Patient-reported insurance information for visit preparation. Uses coverage: namespace for standardized insurance properties (providerName, memberId, groupNumber, coverageType, effectiveStart/End, subscriberName/Relationship, rxBin/rxPcn/rxGroup); adds checkup-specific PCP information (primaryCareProvider, pcpPhone). See coverage.ttl for property definitions.
sub concern: financial

Medication Summary
type: Class
comment: Current medication with enriched adherence and tolerability data. Links to clinical:Medication source records and tracks self-reported adherence barriers and side effects.
sub concern: summary

Allergy Summary
type: Class
comment: Known allergen with reaction type and severity. Tracks data provenance (EHR verified, self-reported) and links to clinical:AllergyIntolerance source records.
sub concern: summary

Condition Summary
type: Class
comment: Active or resolved health condition with ICD-10 coding. Includes onset information and current status for clinical context.
sub concern: summary

Family History Entry
type: Class
comment: Single family member health condition for risk assessment. Captures relative type, condition, and age at diagnosis for inherited condition screening.
sub concern: summary

Screening Status
type: Class
comment: Patient status for recommended preventive screening. Tracks last completed date, next due date, and applicable USPSTF/ACS guidelines.
sub concern: structural

Visit Issue
type: Class
comment: Health issue or symptom the patient wants to discuss at their visit (chief complaint). Includes severity, duration, and user-assigned priority for visit planning.
sub concern: intake

Suggested Question
type: Class
comment: AI-generated or template question for the patient to ask their provider. Based on conditions, medications, symptoms, or health trends identified in their profile.
sub concern: analytics

Diagnostic Test Result
type: Class
comment: Reference to a diagnostic test from an external Cascade app (e.g., POTS Check, glucose monitoring). Provides summary for intake forms and links to detailed results in pod.
sub concern: intake

Supplement Summary
type: Class
comment: Dietary supplement, OTC product, or herbal remedy with regulatory classification and evidence strength. Separate from MedicationSummary to reflect different regulatory status and data requirements. Links to clinical:Supplement source records.
sub concern: summary

Immunization Summary
type: Class
comment: Patient-facing immunization record for intake forms. Uses mixed namespace pattern: checkup: properties for app-layer enrichment (vaccineCategory) alongside clinical data fields.
sub concern: summary
subclass of: Entity

Lab Result Summary
type: Class
comment: Patient-facing lab result summary for intake forms. Uses mixed namespace pattern: checkup:labCategory for app-layer categorization, clinical: properties for standardized lab data.
sub concern: summary
subclass of: Entity

Procedure Summary
type: Class
comment: Patient-facing procedure record for intake forms. Uses mixed namespace pattern: checkup: properties for app-layer fields (procedureName, procedureCategory, procedureLocation), clinical: properties for standardized clinical data (procedureStatus, performedDate, bodySite, performer, outcome, snomedCode, cptCode).
sub concern: summary
subclass of: Entity

Wellness Profile Reference
type: Class
comment: Lightweight pointer to the patient's full wellness profile stored in the SDK HealthProfile. Uses rdfs:seeAlso to link to the wellness data file.
sub concern: structural
subclass of: Entity

Insurance Provider
type: Property
comment: Name of insurance company: Aetna, Blue Cross, Medicare, Medicaid, etc.
domain: Insurance Information
range: string

Member ID
type: Property
comment: Insurance policy member/subscriber ID number.
domain: Insurance Information
range: string

Group Number
type: Property
comment: Employer group number for employer-sponsored plans.
domain: Insurance Information
range: string

Coverage Type
type: Property
comment: Type of coverage: hmo, ppo, epo, pos, medicare, medicaid, tricare, self_pay.
domain: Insurance Information
range: string

Primary Care Provider
type: Property
comment: Name of assigned primary care provider on file with insurance.
domain: Insurance Information
range: string

PCP Phone
type: Property
comment: Primary care provider office phone for referral verification.
domain: Insurance Information
range: string

Medication Name
type: Property
comment: Name of the medication (generic or brand).
domain: Medication Summary
range: string

Dose
type: Property
comment: Medication dose with units (e.g., '10mg', '500mg').
domain: Medication Summary
range: string

Frequency
type: Property
comment: How often medication is taken: once_daily, twice_daily, three_times_daily, as_needed, weekly, monthly.
domain: Medication Summary
range: string

Adherence Status
type: Property
comment: Self-reported adherence: taking_as_prescribed, usually_take, sometimes_miss, often_miss, stopped.
domain: Medication Summary
range: string

Adherence Barrier
type: Property
comment: Reason for non-adherence if applicable: cost, side_effects, forgetfulness, access, complexity, other.
domain: Medication Summary
range: string

Side Effects
type: Property
comment: List of reported side effects as comma-separated string.
domain: Medication Summary
range: string

Perceived Effectiveness
type: Property
comment: Patient assessment of medication effectiveness: very_effective, somewhat_effective, not_sure, not_effective.
domain: Medication Summary
range: string

Last Refill Date
type: Property
comment: Date of most recent prescription refill.
domain: Medication Summary
range: date

Prescriber
type: Property
comment: Name of prescribing provider.
domain: Medication Summary
range: string

Source Record
type: Property
comment: Link to clinical:Medication source record in pod.
domain: Medication Summary
range: anyURI

Episode ID
type: Property
comment: Link to canonical MedicationUseEpisode in CascadeSDK. Enables longitudinal tracking.
domain: Medication Summary
range: string

Start Date
type: Property
comment: Date when patient started taking this medication.
domain: Medication Summary
range: date

Indication
type: Property
comment: Why the patient takes this medication (patient's understanding of the reason).
domain: Medication Summary
range: string

Patient Cost
type: Property
comment: Patient's out-of-pocket cost for medication or supplement.
range: decimal

Cost Frequency
type: Property
comment: Frequency of cost: per_month, per_refill, per_dose, per_bottle, annual.
range: string

Functional Impact
type: Property
comment: How this medication helps the patient functionally (e.g., 'helps me sleep').
domain: Medication Summary
range: string

Concerns For Doctor
type: Property
comment: Concerns the patient wants to discuss with their healthcare provider.
domain: Medication Summary
range: string

Needs Verification
type: DatatypeProperty
comment: Whether this medication needs patient verification.
domain: Medication Summary
range: boolean

Verification Reason
type: DatatypeProperty
comment: Why verification is needed: historical, duplicate, conflicting_sources.
domain: Medication Summary
range: string

Last Verified Date
type: DatatypeProperty
comment: When the patient last verified this medication.
domain: Medication Summary
range: dateTime

Import Session ID
type: ObjectProperty
comment: Link to the import session that created this medication record.
domain: Medication Summary
range: anyURI

Supplement Name
type: Property
comment: Name of the supplement or OTC product.
domain: Supplement Summary
range: string

Supplement Dose
type: Property
comment: Dose with units (e.g., '2000 IU', '500mg').
domain: Supplement Summary
range: string

Supplement Frequency
type: Property
comment: How often supplement is taken: once_daily, twice_daily, as_needed, weekly.
domain: Supplement Summary
range: string

Supplement Brand
type: Property
comment: Brand name if known (e.g., 'Nature Made', 'Garden of Life').
domain: Supplement Summary
range: string

Supplement Form
type: Property
comment: Physical form: capsule, tablet, softgel, liquid, powder, gummy, spray, patch, tea, tincture, other.
domain: Supplement Summary
range: string

Regulatory Status
type: Property
comment: Regulatory classification distinguishing from FDA-approved medications: dietarySupplement (DSHEA), otcDrug (FDA OTC monograph), homeopathic, herbalRemedy, unknown.
domain: Supplement Summary
range: string

Evidence Strength
type: Property
comment: Level of clinical evidence: strongEvidence, moderateEvidence, limitedEvidence, traditionalUse, noEvidence, unknown.
domain: Supplement Summary
range: string

Reason For Use
type: Property
comment: User-provided reason for taking supplement (e.g., 'bone health', 'sleep support').
domain: Supplement Summary
range: string

Supplement Start Date
type: Property
comment: Date when patient started taking the supplement.
domain: Supplement Summary
range: date

Supplement Is Active
type: Property
comment: Whether patient is currently taking the supplement.
domain: Supplement Summary
range: boolean
type: DatatypeProperty
comment: Whether the patient is currently taking this supplement. Replaces dark vocabulary checkup:isActive (disambiguated from generic boolean use).

DSLD ID
type: Property
comment: NIH Dietary Supplement Label Database identifier for lookup.
domain: Supplement Summary
range: string

Supplement Source Record
type: Property
comment: Link to clinical:Supplement source record in pod.
domain: Supplement Summary
range: anyURI

Doctor Aware
type: Property
comment: Whether the patient's healthcare provider knows about this supplement. Used to identify supplements that should be discussed at visits.
domain: Supplement Summary
range: boolean

Vaccine Name
type: DatatypeProperty
comment: Name of the vaccine administered.
domain: Immunization Summary
range: string

Administration Date
type: DatatypeProperty
comment: Date the vaccine was administered.
domain: Immunization Summary
range: dateTime

Immunization Status
type: DatatypeProperty
comment: Status: completed, entered-in-error, not-done.
domain: Immunization Summary
range: string

Vaccine Code
type: DatatypeProperty
comment: CVX vaccine code for standardized identification.
domain: Immunization Summary
range: string

Vaccine Category
type: DatatypeProperty
comment: Categorization for intake form display: routine, travel, occupational, other.
domain: Immunization Summary
range: string

Manufacturer
type: DatatypeProperty
comment: Vaccine manufacturer name.
domain: Immunization Summary
range: string

Lot Number
type: DatatypeProperty
comment: Vaccine lot number.
domain: Immunization Summary
range: string

Expiration Date
type: DatatypeProperty
comment: Vaccine expiration date.
domain: Immunization Summary
range: date

Dose Number
type: DatatypeProperty
comment: Dose sequence number in multi-dose series.
domain: Immunization Summary
range: integer

Dose Quantity
type: DatatypeProperty
comment: Dose quantity administered.
domain: Immunization Summary
range: string

Administration Route
type: DatatypeProperty
comment: Route of vaccine administration: intramuscular, subcutaneous, oral, etc.
domain: Immunization Summary
range: string

Administration Site
type: DatatypeProperty
comment: Body site where vaccine was administered: left arm, right arm, etc.
domain: Immunization Summary
range: string

Administering Provider
type: DatatypeProperty
comment: Name of the provider who administered the vaccine.
domain: Immunization Summary
range: string

Administering Location
type: DatatypeProperty
comment: Location where vaccine was administered.
domain: Immunization Summary
range: string

Notes
type: DatatypeProperty
comment: Additional notes about the immunization.
domain: Immunization Summary
range: string
label: Immunization Notes
comment: Free-text notes about an immunization record. Replaces dark vocabulary checkup:notes (disambiguated from clinical:notes used in lab results).

Source Record
type: ObjectProperty
comment: Link to the source clinical:Immunization record.
domain: Immunization Summary
range: anyURI

Lab Category
type: DatatypeProperty
comment: Intake form display category: metabolic, hematology, lipid, thyroid, vitamin, other.
domain: Lab Result Summary
range: string

Procedure Name
type: DatatypeProperty
comment: Name of the medical procedure.
domain: Procedure Summary
range: string

Procedure Category
type: DatatypeProperty
comment: Categorization for intake form display: surgical, diagnostic, therapeutic, other.
domain: Procedure Summary
range: string

Procedure Location
type: DatatypeProperty
comment: Facility or location where the procedure was performed.
domain: Procedure Summary
range: string

Source Record
type: ObjectProperty
comment: Link to the source clinical:Procedure record.
domain: Procedure Summary
range: anyURI

Allergen
type: Property
comment: Name of the allergenic substance (drug, food, environmental).
domain: Allergy Summary
range: string

Reaction
type: Property
comment: Type of allergic reaction: hives, rash, swelling, difficulty_breathing, anaphylaxis, nausea, other.
domain: Allergy Summary
range: string

Allergy Severity
type: Property
comment: Severity of allergic reaction: mild, moderate, severe, life_threatening.
domain: Allergy Summary
range: string

Allergy Category
type: Property
comment: Category of allergen: medication, food, environmental, latex, contrast, other.
domain: Allergy Summary
range: string

Condition Name
type: Property
comment: Name of the health condition or diagnosis.
domain: Condition Summary
range: string

ICD-10 Code
type: Property
comment: ICD-10-CM diagnosis code if available.
domain: Condition Summary
range: string

SNOMED Code
type: Property
comment: SNOMED CT concept ID if available.
domain: Condition Summary
range: string

Onset Date
type: Property
comment: Date when condition was first diagnosed or symptoms began.
domain: Condition Summary
range: date

Onset Year
type: Property
comment: Year of condition onset if exact date unknown.
domain: Condition Summary
range: gYear

Condition Status
type: Property
comment: Current status: active, resolved, remission, recurrence, inactive.
domain: Condition Summary
range: string

Relative Type
type: Property
comment: Relationship to patient: mother, father, sibling, maternal_grandmother, maternal_grandfather, paternal_grandmother, paternal_grandfather, aunt, uncle, child.
domain: Family History Entry
range: string

Relative Sex
type: Property
comment: Biological sex of relative: male, female.
domain: Family History Entry
range: string

Family Condition
type: Property
comment: Name of health condition the relative has/had.
domain: Family History Entry
range: string

Family Condition Code
type: Property
comment: ICD-10 or SNOMED code for the family condition.
domain: Family History Entry
range: string

Age at Diagnosis
type: Property
comment: Relative's age when condition was diagnosed (if known).
domain: Family History Entry
range: integer

Age at Death
type: Property
comment: Relative's age at death if deceased.
domain: Family History Entry
range: integer

Is Deceased
type: Property
comment: Whether the relative is deceased.
domain: Family History Entry
range: boolean

Screening Type
type: Property
comment: Type of preventive screening: mammogram, colonoscopy, pap_smear, psa, bone_density, aaa_ultrasound, lung_ct, diabetes_a1c, lipid_panel, colorectal.
domain: Screening Status
range: string

Screening Status
type: Property
comment: Current status: not_due, due, overdue, completed, declined, not_applicable.
domain: Screening Status
range: string

Last Completed Date
type: Property
comment: Date when screening was last completed.
domain: Screening Status
range: date

Next Due Date
type: Property
comment: Date when screening is next due.
domain: Screening Status
range: date

Guideline Source
type: Property
comment: Source of recommendation: USPSTF, ACS, AAP, ACOG, ADA.
domain: Screening Status
range: string

Grade Level
type: Property
comment: USPSTF grade if applicable: A, B, C, D, I.
domain: Screening Status
range: string

Applicable Age Min
type: Property
comment: Minimum age for this screening recommendation.
domain: Screening Status
range: integer

Applicable Age Max
type: Property
comment: Maximum age for this screening recommendation.
domain: Screening Status
range: integer

Applicable Sex
type: Property
comment: Sex this screening applies to: male, female, all.
domain: Screening Status
range: string

Frequency Months
type: Property
comment: Recommended screening frequency in months.
domain: Screening Status
range: integer

Issue Category
type: Property
comment: Category of health issue: pain, skin, digestive, respiratory, cardiovascular, mental_health, neurological, musculoskeletal, urinary, medication, screening, general, other.
domain: Visit Issue
range: string

Issue Description
type: Property
comment: Free text description of the health issue.
domain: Visit Issue
range: string

Issue Duration
type: Property
comment: How long the issue has been present: days, weeks, months, years.
domain: Visit Issue
range: string

Issue Severity
type: Property
comment: Severity of the issue: mild, moderate, severe.
domain: Visit Issue
range: string

Issue Frequency
type: Property
comment: How often the issue occurs: constant, intermittent, occasional, rare.
domain: Visit Issue
range: string

Affects Daily Activities
type: Property
comment: Whether the issue impacts daily activities.
domain: Visit Issue
range: boolean

Related Conditions
type: Property
comment: Links to existing condition entries that may be related.
domain: Visit Issue
range: Condition Summary

Issue Priority
type: Property
comment: User-ranked importance (1 = highest priority).
domain: Visit Issue
range: integer

Question Text
type: Property
comment: The suggested question to ask the provider.
domain: Suggested Question
range: string

Question Category
type: Property
comment: Category: treatment_options, side_effects, prevention, lifestyle, referral, diagnosis, prognosis, medication, screening.
domain: Suggested Question
range: string

Based On Condition
type: Property
comment: Link to condition that triggered this question.
domain: Suggested Question
range: Condition Summary

Based On Medication
type: Property
comment: Link to medication that triggered this question.
domain: Suggested Question
range: Medication Summary

Based On Issue
type: Property
comment: Link to visit issue that triggered this question.
domain: Suggested Question
range: Visit Issue

Based On Trend
type: Property
comment: Link to a health metric trend that triggered this question.
domain: Suggested Question
range: MetricTrend

Based On Template
type: DatatypeProperty
comment: Template name the question was generated from.
domain: Suggested Question
range: string

Based On Screening
type: ObjectProperty
comment: Link to the screening record the question relates to.
domain: Suggested Question
range: anyURI

Test Type
type: Property
comment: Type of diagnostic test: pots_check, blood_pressure_series, glucose_series, ecg, sleep_analysis, other.
domain: Diagnostic Test Result
range: string

Test Date
type: Property
comment: Date and time when the test was performed.
domain: Diagnostic Test Result
range: dateTime

Source App
type: Property
comment: Name of the app that generated this result: POTS Check, Cascade Checkup, etc.
domain: Diagnostic Test Result
range: string

Source App Version
type: Property
comment: Version of the source app.
domain: Diagnostic Test Result
range: string

Result Summary
type: Property
comment: Brief text summary suitable for intake forms.
domain: Diagnostic Test Result
range: string

Result Details
type: Property
comment: Link to full result in pod (e.g., pots-check-uuid.ttl).
domain: Diagnostic Test Result
range: anyURI

Flagged For Discussion
type: Property
comment: Whether user wants to discuss this result with provider.
domain: Diagnostic Test Result
range: boolean

POTS Threshold Met
type: Property
comment: Whether the POTS diagnostic threshold was met (HR increase >= 30 bpm).
domain: Diagnostic Test Result
range: boolean

Max Heart Rate Delta
type: Property
comment: Maximum heart rate change during standing test (bpm).
domain: Diagnostic Test Result
range: double

Orthostatic Flags
type: Property
comment: Orthostatic findings: hypotension_suspected, hypertension_suspected, none.
domain: Diagnostic Test Result
range: string

Generated At
type: Property
comment: Timestamp when intake form data was generated.
domain: Intake Form Data
range: dateTime

Schema Version
type: Property
comment: Version of the checkup vocabulary used.
domain: Intake Form Data
range: string

Has Patient Profile
type: Property
comment: DEPRECATED (v3.0): checkup:PatientProfile class removed. Use cascade:PatientProfile from core.ttl for patient demographics.
deprecated: true
domain: Intake Form Data

Has Insurance
type: Property
comment: Link to insurance information.
domain: Intake Form Data
range: Insurance Information

Has Medication
type: Property
comment: Link to medication summary entry.
domain: Intake Form Data
range: Medication Summary

Has Supplement
type: Property
comment: Link to supplement summary entry.
domain: Intake Form Data
range: Supplement Summary

Has Allergy
type: Property
comment: Link to allergy summary entry.
domain: Intake Form Data
range: Allergy Summary

Has Condition
type: Property
comment: Link to condition summary entry.
domain: Intake Form Data
range: Condition Summary

Has Family History
type: Property
comment: Link to family history entry.
domain: Intake Form Data
range: Family History Entry

Has Vitals Trend
type: Property
comment: DEPRECATED (v3.0): checkup:VitalSignsTrend class removed. Use health:MetricTrend (Layer 2) and checkup:WellnessSummary (Layer 3) instead.
deprecated: true
domain: Intake Form Data

Has Screening
type: Property
comment: Link to screening status entry.
domain: Intake Form Data
range: Screening Status

Has Visit Issue
type: Property
comment: Link to visit issue/chief complaint.
domain: Intake Form Data
range: Visit Issue

Has Suggested Question
type: Property
comment: Link to generated question for provider.
domain: Intake Form Data
range: Suggested Question

Has Diagnostic Result
type: Property
comment: Link to diagnostic test result from external app.
domain: Intake Form Data
range: Diagnostic Test Result

Has Wellness Summary
type: Property
comment: Link to wellness summary with trends and baselines.
domain: Intake Form Data
range: Wellness Summary

Has Trend Insight
type: Property
comment: Link to a patient-readable trend insight.
domain: Intake Form Data
range: Trend Insight

Has Correlation Insight
type: Property
comment: Link to a temporal correlation insight.
domain: Intake Form Data
range: Correlation Insight

Has Key Indicator
type: Property
comment: Link to a key health indicator for dashboard display.
domain: Intake Form Data
range: Key Indicator

Has Attention Item
type: Property
comment: Link to an item requiring patient attention.
domain: Intake Form Data
range: Attention Item

Has Visit Prep Summary
type: Property
comment: Link to a curated visit preparation summary.
domain: Intake Form Data
range: Visit Prep Summary

Has Provenance
type: Property
comment: Link to provenance information for any record.
range: DataProvenance

Provenance Type
type: Property
comment: Source type: ehr_verified, self_reported, scanned, device, ai_extracted, imported.
range: string

Provenance Source
type: Property
comment: Specific source identifier: MyChart, Apple Health, manual entry, etc.
range: string

Provenance Date
type: Property
comment: Date when data was recorded or verified at source.
range: dateTime

EHR System Name
type: Property
comment: Name of the EHR patient portal or system: MyChart, Swedish Connect, Cerner, etc.
domain: Medication Summary
range: string

EHR Organization
type: Property
comment: Healthcare organization name associated with the EHR record: Virginia Mason, Swedish Medical, etc.
domain: Medication Summary
range: string

FHIR Resource Type
type: Property
comment: FHIR resource type the medication was derived from: MedicationStatement, MedicationDispense, MedicationRequest, MedicationAdministration.
domain: Medication Summary
range: string

Last Synced From Source
type: Property
comment: Timestamp when this medication record was last synchronized from the EHR source.
domain: Medication Summary
range: dateTime

Relevance Tier
type: Property
comment: Classification tier for medication relevance. Values: 'current' (actively taking), 'needsVerification' (status unclear), 'historical' (past medication), 'filtered' (procedure/IV meds).
domain: Medication Summary
range: string

Brand Name
type: Property
comment: Common brand name for the medication if different from generic name. Stored in pod for portability across apps.
domain: Medication Summary
range: string

Common Brand Names
type: Property
comment: Comma-separated list of common brand names for reference data.
range: string

Therapeutic Class
type: Property
comment: Therapeutic/pharmacological class: Beta Blocker, ACE Inhibitor, SSRI, etc.
domain: Medication Summary
range: string

Tier Classification Reason
type: Property
comment: Human-readable explanation for why a medication was classified into its tier.
domain: Medication Summary
range: string

Wellness Summary
type: Class
comment: Layer 3 patient-facing summary of wellness data. Aggregates trends and baselines from health: Layer 2 properties into a patient-readable format.
sub concern: analytics
subclass of: Entity

Trend Insight
type: Class
comment: A patient-readable observation derived from trend data. Example: 'Your resting heart rate has dropped 5 bpm since you started walking 10k steps/day.'
sub concern: analytics
subclass of: Entity

Correlation Insight
type: Class
comment: Links two data domains with an observed temporal relationship. Example: medication start date correlates with metric change. IMPORTANT: Temporal correlation only — never implies causation.
sub concern: analytics
subclass of: Entity

Key Indicator
type: Class
comment: A distilled, patient-friendly health metric chosen for its predictive value and simplicity. Used for dashboard summaries and health scores.
sub concern: analytics
subclass of: Entity

Attention Item
type: Class
comment: Flags when a metric deviates significantly from personal baseline, data has gone stale, or a trend crosses a threshold. Rule-based, not clinical advice.
sub concern: analytics
subclass of: Entity

Wellness Trend
type: ObjectProperty
comment: Link to a health:MetricTrend for a wellness metric
domain: Wellness Summary
range: MetricTrend

Baseline Date
type: DatatypeProperty
comment: Date of the baseline snapshot this summary compares against
domain: Wellness Summary
range: dateTime

Insight Text
type: DatatypeProperty
comment: Patient-readable description of the insight
domain: Trend Insight
range: string

Source Trend
type: ObjectProperty
comment: The health:MetricTrend this insight is derived from
domain: Trend Insight
range: MetricTrend

Generated By
type: ObjectProperty
comment: The agent that produced this insight. Should link to a prov:Agent (e.g., a cascade:DataSource for 'cascade-rule-engine', or a provider agent). Aligns with W3C PROV-O prov:wasGeneratedBy pattern.
domain: Trend Insight
range: Agent

Correlated Metric
type: ObjectProperty
comment: The wellness metric involved in the correlation
domain: Correlation Insight
range: MetricTrend

Correlated Event
type: ObjectProperty
comment: The clinical event (medication start/stop, condition onset) involved in the correlation
domain: Correlation Insight

Correlation Text
type: DatatypeProperty
comment: Patient-readable description. Must use temporal language only ('started approximately after'), never causal language ('caused by').
domain: Correlation Insight
range: string

Time Lag
type: DatatypeProperty
comment: Days between the clinical event and the observed metric change onset
domain: Correlation Insight
range: integer

Indicator Metric Key
type: DatatypeProperty
comment: The metric key this indicator represents (e.g., 'restingHeartRate')
domain: Key Indicator
range: string

Patient-Friendly Label
type: DatatypeProperty
comment: e.g., 'Your resting heart rate' instead of 'RHR'
domain: Key Indicator
range: string

Status
type: DatatypeProperty
comment: Traffic light: 'good', 'watch', 'attention'
domain: Key Indicator
range: string

Attention Reason
type: DatatypeProperty
comment: Why this needs attention: 'baseline_deviation', 'stale_data', 'threshold_crossed'
domain: Attention Item
range: string

Attention Metric
type: DatatypeProperty
domain: Attention Item
range: string

Attention Text
type: DatatypeProperty
comment: Patient-readable explanation: 'Your blood pressure hasn't been recorded in 60 days'
domain: Attention Item
range: string

Severity
type: DatatypeProperty
comment: 'info', 'watch', 'action'
domain: Attention Item
range: string

Visit Prep Summary
type: Class
comment: A curated, one-page clinical summary designed for a 15-minute appointment. Auto-generated from metric changes, medication context, and patient questions, then user-edited before export.
sub concern: analytics
subclass of: Entity

visitPrepComparisonDate
type: DatatypeProperty
comment: Date of the previous snapshot being compared against
domain: Visit Prep Summary
range: dateTime

visitPrepChange
type: ObjectProperty
comment: A metric change included in this visit prep
domain: Visit Prep Summary
range: MetricTrend

visitPrepUserNotes
type: DatatypeProperty
comment: Patient-authored questions and concerns for the visit
domain: Visit Prep Summary
range: string

Note Content
type: DatatypeProperty
comment: Free-text notes for visit preparation. Merges previously separate VisitPrepNotes content into VisitPrepSummary.
domain: Visit Prep Summary
range: string

Daily Check-in
type: Class
comment: Patient-reported daily medication adherence check-in capturing response status, missed medications, and optional notes.
sub concern: self-report
subclass of: SelfReport

Discussion Topic
type: Class
comment: AI-generated or user-created topic for discussion during a healthcare visit. Topics are derived from medication data, adherence patterns, supplement interactions, or user input.
sub concern: analytics
subclass of: Entity

Check-in Settings
type: Class
comment: Application configuration for daily check-in notification scheduling and day-of-week preferences.
sub concern: app-config

Check-in Date
type: DatatypeProperty
comment: Date of the check-in (normalized to midnight)
domain: Daily Check-in
range: dateTime

Check-in Response
type: DatatypeProperty
comment: Adherence response: allTaken, missedSome, skippedToday
domain: Daily Check-in
range: string

Missed Medication IDs
type: DatatypeProperty
comment: Comma-separated UUIDs of missed medications (when response is missedSome)
domain: Daily Check-in
range: string

Check-in Notes
type: DatatypeProperty
comment: Optional patient notes about the day
domain: Daily Check-in
range: string

Submitted At
type: DatatypeProperty
comment: Timestamp when the check-in was submitted
domain: Daily Check-in
range: dateTime

Topic Text
type: DatatypeProperty
comment: The discussion topic question or statement
domain: Discussion Topic
range: string

Topic Category
type: DatatypeProperty
comment: Category: durationBased, recentChange, adherenceConcern, sideEffectReport, multipleForSame, supplementDoctor, interactionRisk, refillDue, effectivenessConcern, costConcern, custom
domain: Discussion Topic
range: string

Topic Source
type: DatatypeProperty
comment: Source type: medication, supplement, medicationPair, supplementMedicationPair, adherencePattern, custom
domain: Discussion Topic
range: string

Relevance Score
type: DatatypeProperty
comment: AI-computed relevance score (0.0-1.0)
domain: Discussion Topic
range: double

Is Selected
type: DatatypeProperty
comment: Whether the topic is active for the next visit
domain: Discussion Topic
range: boolean

Related Medication Name
type: DatatypeProperty
comment: Optional medication name providing context
domain: Discussion Topic
range: string

Detail Text
type: DatatypeProperty
comment: Optional supplementary detail text
domain: Discussion Topic
range: string

Check-in Enabled
type: DatatypeProperty
comment: Whether daily check-ins are active
domain: Check-in Settings
range: boolean

Notification Hour
type: DatatypeProperty
comment: Notification hour in 24-hour format (0-23)
domain: Check-in Settings
range: integer

Notification Minute
type: DatatypeProperty
comment: Notification minute (0-59)
domain: Check-in Settings
range: integer

Enabled Days
type: DatatypeProperty
comment: Comma-separated enabled days: sunday, monday, tuesday, wednesday, thursday, friday, saturday
domain: Check-in Settings
range: string

Has Daily Check-in
type: ObjectProperty
comment: Link to a daily medication adherence check-in record.
domain: Intake Form Data
range: Daily Check-in

Has Discussion Topic
type: ObjectProperty
comment: Link to a discussion topic for a healthcare visit.
domain: Intake Form Data
range: Discussion Topic

Has Check-in Settings
type: ObjectProperty
comment: Link to check-in notification configuration.
domain: Intake Form Data
range: Check-in Settings

Intake Questionnaire Response
type: Class
comment: Response to a standardized intake questionnaire section. Structure inspired by FHIR QuestionnaireResponse but uses native Cascade Protocol serialization. Uses LOINC panel codes as questionnaire identifiers and SNOMED CT codes for standardized answers.
sub concern: intake
subclass of: Entity

Response Item
type: Class
comment: A question-answer pair within an intake questionnaire response. Uses LOINC item codes as link identifiers and SNOMED CT codes for coded answers where available. Supports nested sub-items via childItem for hierarchical questionnaire structures.
sub concern: intake
subclass of: Entity

Questionnaire ID
type: DatatypeProperty
comment: LOINC panel code identifying the questionnaire section (e.g., 71421-2 for Social History, 10187-3 for Review of Systems)
domain: Intake Questionnaire Response
range: string

Questionnaire Title
type: DatatypeProperty
comment: Human-readable title of the questionnaire section
domain: Intake Questionnaire Response
range: string

Response Item
type: ObjectProperty
comment: Link to a ResponseItem containing a question-answer pair
domain: Intake Questionnaire Response
range: Response Item

Completed At
type: DatatypeProperty
comment: Timestamp when the questionnaire response was completed
domain: Intake Questionnaire Response
range: dateTime

Item Link ID
type: DatatypeProperty
comment: LOINC item code identifying the question (e.g., 72166-2 for Tobacco smoking status, 63512-8 for Alcohol use)
domain: Response Item
range: string

Item Text
type: DatatypeProperty
comment: Human-readable question display text
domain: Response Item
range: string

Item Answer
type: DatatypeProperty
comment: Free-text answer value
domain: Response Item
range: string

Item Answer Code
type: DatatypeProperty
comment: Coded answer value from a standard terminology (SNOMED CT or LOINC answer code)
domain: Response Item
range: string

Item Answer Code System
type: DatatypeProperty
comment: Code system URI for the coded answer (e.g., http://snomed.info/sct/, http://loinc.org/)
domain: Response Item
range: anyURI

Child Item
type: ObjectProperty
comment: Nested sub-item for hierarchical questionnaire structures (e.g., follow-up questions based on answers)
domain: Response Item
range: Response Item

Has Questionnaire Response
type: ObjectProperty
comment: Link to a completed intake questionnaire response section.
domain: Intake Form Data
range: Intake Questionnaire Response

Has Immunization
type: ObjectProperty
comment: Link to an immunization summary entry.
domain: Intake Form Data
range: Immunization Summary

Has Lab Result
type: ObjectProperty
comment: Link to a lab result summary entry.
domain: Intake Form Data
range: Lab Result Summary

Has Wellness Baseline
type: ObjectProperty
comment: DEPRECATED (v3.0): checkup:WellnessBaseline class removed. Use checkup:WellnessProfileReference to link to SDK HealthProfile.
deprecated: true
domain: Intake Form Data

Has Activity Summary
type: ObjectProperty
comment: DEPRECATED (v3.0): checkup:ActivitySummary class removed. Use checkup:WellnessProfileReference to link to SDK HealthProfile.
deprecated: true
domain: Intake Form Data

Has Procedure
type: ObjectProperty
comment: Link to a procedure summary entry.
domain: Intake Form Data
range: Procedure Summary

Medication Change Record
type: Class
comment: A recorded change to a medication or supplement since the last visit snapshot. Tracked for the Changes Since Last Visit report section.
sub concern: analytics
subclass of: Entity

Change Type
type: DatatypeProperty
comment: Type of change: added, stopped, doseChanged, frequencyChanged, adherenceChanged, statusChanged.
domain: Medication Change Record
range: string

Changed Field
type: DatatypeProperty
comment: Name of the field that was changed (e.g., dose, frequency).
domain: Medication Change Record
range: string

Previous Value
type: DatatypeProperty
comment: Value of the field before the change.
domain: Medication Change Record
range: string

New Value
type: DatatypeProperty
comment: Value of the field after the change.
domain: Medication Change Record
range: string

Change Date
type: DatatypeProperty
comment: Date when the change occurred.
domain: Medication Change Record
range: dateTime

Has Change
type: ObjectProperty
comment: Link from a MedicationSummary or SupplementSummary to a change record.
range: Medication Change Record

Visit Prep Tray
type: Class
comment: Per-appointment visit preparation container grouping issues, discussion topics, questions, and notes. Uses a typed payload wrapper (VisitItemPayload) to preserve existing type richness from VisitIssue, DiscussionTopic, and SuggestedQuestion.
sub concern: intake
subclass of: Entity

Visit Tray Item
type: Class
comment: A typed item within a VisitPrepTray. Wraps VisitIssue, DiscussionTopic, SuggestedQuestion, note, or custom content with intent category and resolution tracking.
subclass of: Entity

Prep Title
type: DatatypeProperty
comment: Display title for the visit prep (e.g., 'Rheumatologist - Feb 28').
domain: Visit Prep Tray
range: string

Appointment Date
type: DatatypeProperty
comment: Scheduled appointment date and time.
domain: Visit Prep Tray
range: dateTime

Prep Provider Name
type: DatatypeProperty
comment: Name of the healthcare provider for this appointment.
domain: Visit Prep Tray
range: string

Specialty
type: DatatypeProperty
comment: Provider specialty (e.g., 'Rheumatology', 'Cardiology').
domain: Visit Prep Tray
range: string

Visit Prep Status
type: DatatypeProperty
comment: Tray status: preparing, ready, completed.
domain: Visit Prep Tray
range: string

Prep Completed Date
type: DatatypeProperty
comment: When the visit was marked completed.
domain: Visit Prep Tray
range: dateTime

Has Tray Item
type: ObjectProperty
comment: Link from a VisitPrepTray to a VisitTrayItem.
domain: Visit Prep Tray
range: Visit Tray Item

Payload Type
type: DatatypeProperty
comment: Payload discriminator: issue, topic, question, note, custom.
domain: Visit Tray Item
range: string

Intent Category
type: DatatypeProperty
comment: Intent of the tray item: discuss, schedule, inform, ask.
domain: Visit Tray Item
range: string

Is Resolved
type: DatatypeProperty
comment: Whether the tray item has been addressed or resolved.
domain: Visit Tray Item
range: boolean

Source Section
type: DatatypeProperty
comment: Health Map section this item originated from (e.g., 'medications', 'conditions').
domain: Visit Tray Item
range: string

Source Record ID
type: DatatypeProperty
comment: UUID linking to the source record that prompted this tray item.
domain: Visit Tray Item
range: anyURI

Has Visit Prep
type: ObjectProperty
comment: Link from IntakeFormData to a VisitPrepTray.
domain: Intake Form Data
range: Visit Prep Tray

Active Visit Prep ID
type: DatatypeProperty
comment: UUID of the currently active visit prep tray on IntakeFormData.
domain: Intake Form Data
range: string

Has Lab Results
type: ObjectProperty
comment: Link to a lab result summary entry. Replaces dark vocabulary checkup:hasLabResultSummary.
domain: Intake Form Data
range: Lab Result Summary

Wellness Profile Reference
type: ObjectProperty
comment: URI reference to the patient's HealthProfile wellness data file.
domain: Intake Form Data

Last Snapshot Date
type: DatatypeProperty
comment: When the medication or supplement data was last snapshotted from clinical records.
range: dateTime

Medication End Date
type: DatatypeProperty
comment: End date for a medication prescription. Replaces dark vocabulary checkup:endDate (disambiguated from other end-date uses). NOTE: This reflects the administrative EHR order expiry date, which may not match the actual supply exhaustion date. Use checkup:supplyEndDate for the computed supply end date.
domain: Medication Summary
range: date

Supply End Date
type: DatatypeProperty
comment: Computed date when the dispensed medication supply is expected to be exhausted, calculated as startDate + supplyDurationDays. Distinguishes clinical supply exhaustion from administrative EHR order expiry (checkup:medicationEndDate). Consumers should use this property — rather than medicationEndDate — to determine whether a medication is likely still active when adherenceStatus is absent.
domain: Medication Summary
range: date

Supplement UPC
type: DatatypeProperty
comment: Universal Product Code for supplement identification. Replaces dark vocabulary checkup:upc (disambiguated with supplement prefix).
domain: Supplement Summary
range: string