Cascade Checkup Vocabulary
Structured health data for patient intake forms and pre-visit preparation. Enables aggregation of EHR, HealthKit, and manually entered health data.
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.
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.
Current medication with enriched adherence and tolerability data. Links to clinical:Medication source records and tracks self-reported adherence barriers and side effects.
Known allergen with reaction type and severity. Tracks data provenance (EHR verified, self-reported) and links to clinical:AllergyIntolerance source records.
Active or resolved health condition with ICD-10 coding. Includes onset information and current status for clinical context.
Single family member health condition for risk assessment. Captures relative type, condition, and age at diagnosis for inherited condition screening.
Patient status for recommended preventive screening. Tracks last completed date, next due date, and applicable USPSTF/ACS guidelines.
Health issue or symptom the patient wants to discuss at their visit (chief complaint). Includes severity, duration, and user-assigned priority for visit planning.
AI-generated or template question for the patient to ask their provider. Based on conditions, medications, symptoms, or health trends identified in their profile.
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.
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.
Patient-facing immunization record for intake forms. Uses mixed namespace pattern: checkup: properties for app-layer enrichment (vaccineCategory) alongside clinical data fields.
Patient-facing lab result summary for intake forms. Uses mixed namespace pattern: checkup:labCategory for app-layer categorization, clinical: properties for standardized lab data.
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).
Lightweight pointer to the patient's full wellness profile stored in the SDK HealthProfile. Uses rdfs:seeAlso to link to the wellness data file.
Name of insurance company: Aetna, Blue Cross, Medicare, Medicaid, etc.
Insurance policy member/subscriber ID number.
Employer group number for employer-sponsored plans.
Type of coverage: hmo, ppo, epo, pos, medicare, medicaid, tricare, self_pay.
Name of assigned primary care provider on file with insurance.
Primary care provider office phone for referral verification.
Name of the medication (generic or brand).
Medication dose with units (e.g., '10mg', '500mg').
How often medication is taken: once_daily, twice_daily, three_times_daily, as_needed, weekly, monthly.
Self-reported adherence: taking_as_prescribed, usually_take, sometimes_miss, often_miss, stopped.
Reason for non-adherence if applicable: cost, side_effects, forgetfulness, access, complexity, other.
List of reported side effects as comma-separated string.
Patient assessment of medication effectiveness: very_effective, somewhat_effective, not_sure, not_effective.
Date of most recent prescription refill.
Link to clinical:Medication source record in pod.
Link to canonical MedicationUseEpisode in CascadeSDK. Enables longitudinal tracking.
Date when patient started taking this medication.
Why the patient takes this medication (patient's understanding of the reason).
Patient's out-of-pocket cost for medication or supplement.
Frequency of cost: per_month, per_refill, per_dose, per_bottle, annual.
How this medication helps the patient functionally (e.g., 'helps me sleep').
Concerns the patient wants to discuss with their healthcare provider.
Whether this medication needs patient verification.
Why verification is needed: historical, duplicate, conflicting_sources.
When the patient last verified this medication.
Link to the import session that created this medication record.
Dose with units (e.g., '2000 IU', '500mg').
How often supplement is taken: once_daily, twice_daily, as_needed, weekly.
Brand name if known (e.g., 'Nature Made', 'Garden of Life').
Physical form: capsule, tablet, softgel, liquid, powder, gummy, spray, patch, tea, tincture, other.
Regulatory classification distinguishing from FDA-approved medications: dietarySupplement (DSHEA), otcDrug (FDA OTC monograph), homeopathic, herbalRemedy, unknown.
Level of clinical evidence: strongEvidence, moderateEvidence, limitedEvidence, traditionalUse, noEvidence, unknown.
User-provided reason for taking supplement (e.g., 'bone health', 'sleep support').
Date when patient started taking the supplement.
Whether patient is currently taking the supplement.
NIH Dietary Supplement Label Database identifier for lookup.
Link to clinical:Supplement source record in pod.
Whether the patient's healthcare provider knows about this supplement. Used to identify supplements that should be discussed at visits.
Status: completed, entered-in-error, not-done.
CVX vaccine code for standardized identification.
Categorization for intake form display: routine, travel, occupational, other.
Dose sequence number in multi-dose series.
Route of vaccine administration: intramuscular, subcutaneous, oral, etc.
Body site where vaccine was administered: left arm, right arm, etc.
Name of the provider who administered the vaccine.
Location where vaccine was administered.
Additional notes about the immunization.
Link to the source clinical:Immunization record.
Intake form display category: metabolic, hematology, lipid, thyroid, vitamin, other.
Categorization for intake form display: surgical, diagnostic, therapeutic, other.
Facility or location where the procedure was performed.
Link to the source clinical:Procedure record.
Name of the allergenic substance (drug, food, environmental).
Type of allergic reaction: hives, rash, swelling, difficulty_breathing, anaphylaxis, nausea, other.
Severity of allergic reaction: mild, moderate, severe, life_threatening.
Category of allergen: medication, food, environmental, latex, contrast, other.
Name of the health condition or diagnosis.
Date when condition was first diagnosed or symptoms began.
Year of condition onset if exact date unknown.
Current status: active, resolved, remission, recurrence, inactive.
Relationship to patient: mother, father, sibling, maternal_grandmother, maternal_grandfather, paternal_grandmother, paternal_grandfather, aunt, uncle, child.
Biological sex of relative: male, female.
Name of health condition the relative has/had.
ICD-10 or SNOMED code for the family condition.
Relative's age when condition was diagnosed (if known).
Type of preventive screening: mammogram, colonoscopy, pap_smear, psa, bone_density, aaa_ultrasound, lung_ct, diabetes_a1c, lipid_panel, colorectal.
Current status: not_due, due, overdue, completed, declined, not_applicable.
Source of recommendation: USPSTF, ACS, AAP, ACOG, ADA.
USPSTF grade if applicable: A, B, C, D, I.
Minimum age for this screening recommendation.
Maximum age for this screening recommendation.
Sex this screening applies to: male, female, all.
Recommended screening frequency in months.
Category of health issue: pain, skin, digestive, respiratory, cardiovascular, mental_health, neurological, musculoskeletal, urinary, medication, screening, general, other.
Free text description of the health issue.
How long the issue has been present: days, weeks, months, years.
Severity of the issue: mild, moderate, severe.
How often the issue occurs: constant, intermittent, occasional, rare.
Whether the issue impacts daily activities.
Links to existing condition entries that may be related.
User-ranked importance (1 = highest priority).
The suggested question to ask the provider.
Category: treatment_options, side_effects, prevention, lifestyle, referral, diagnosis, prognosis, medication, screening.
Link to condition that triggered this question.
Link to medication that triggered this question.
Link to visit issue that triggered this question.
Link to a health metric trend that triggered this question.
Template name the question was generated from.
Link to the screening record the question relates to.
Type of diagnostic test: pots_check, blood_pressure_series, glucose_series, ecg, sleep_analysis, other.
Date and time when the test was performed.
Name of the app that generated this result: POTS Check, Cascade Checkup, etc.
Brief text summary suitable for intake forms.
Link to full result in pod (e.g., pots-check-uuid.ttl).
Whether user wants to discuss this result with provider.
Whether the POTS diagnostic threshold was met (HR increase >= 30 bpm).
Maximum heart rate change during standing test (bpm).
Orthostatic findings: hypotension_suspected, hypertension_suspected, none.
Timestamp when intake form data was generated.
DEPRECATED (v3.0): checkup:PatientProfile class removed. Use cascade:PatientProfile from core.ttl for patient demographics.
DEPRECATED (v3.0): checkup:VitalSignsTrend class removed. Use health:MetricTrend (Layer 2) and checkup:WellnessSummary (Layer 3) instead.
Link to generated question for provider.
Link to diagnostic test result from external app.
Link to wellness summary with trends and baselines.
Link to a patient-readable trend insight.
Link to a key health indicator for dashboard display.
Link to an item requiring patient attention.
Link to a curated visit preparation summary.
Link to provenance information for any record.
Source type: ehr_verified, self_reported, scanned, device, ai_extracted, imported.
Specific source identifier: MyChart, Apple Health, manual entry, etc.
Date when data was recorded or verified at source.
Name of the EHR patient portal or system: MyChart, Swedish Connect, Cerner, etc.
Healthcare organization name associated with the EHR record: Virginia Mason, Swedish Medical, etc.
FHIR resource type the medication was derived from: MedicationStatement, MedicationDispense, MedicationRequest, MedicationAdministration.
Timestamp when this medication record was last synchronized from the EHR source.
Classification tier for medication relevance. Values: 'current' (actively taking), 'needsVerification' (status unclear), 'historical' (past medication), 'filtered' (procedure/IV meds).
Common brand name for the medication if different from generic name. Stored in pod for portability across apps.
Comma-separated list of common brand names for reference data.
Therapeutic/pharmacological class: Beta Blocker, ACE Inhibitor, SSRI, etc.
Human-readable explanation for why a medication was classified into its tier.
Layer 3 patient-facing summary of wellness data. Aggregates trends and baselines from health: Layer 2 properties into a patient-readable format.
A patient-readable observation derived from trend data. Example: 'Your resting heart rate has dropped 5 bpm since you started walking 10k steps/day.'
Links two data domains with an observed temporal relationship. Example: medication start date correlates with metric change. IMPORTANT: Temporal correlation only — never implies causation.
A distilled, patient-friendly health metric chosen for its predictive value and simplicity. Used for dashboard summaries and health scores.
Flags when a metric deviates significantly from personal baseline, data has gone stale, or a trend crosses a threshold. Rule-based, not clinical advice.
Link to a health:MetricTrend for a wellness metric
Date of the baseline snapshot this summary compares against
Patient-readable description of the insight
The health:MetricTrend this insight is derived from
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.
The wellness metric involved in the correlation
The clinical event (medication start/stop, condition onset) involved in the correlation
Patient-readable description. Must use temporal language only ('started approximately after'), never causal language ('caused by').
Days between the clinical event and the observed metric change onset
The metric key this indicator represents (e.g., 'restingHeartRate')
e.g., 'Your resting heart rate' instead of 'RHR'
Traffic light: 'good', 'watch', 'attention'
Why this needs attention: 'baseline_deviation', 'stale_data', 'threshold_crossed'
Patient-readable explanation: 'Your blood pressure hasn't been recorded in 60 days'
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.
Date of the previous snapshot being compared against
A metric change included in this visit prep
Patient-authored questions and concerns for the visit
Free-text notes for visit preparation. Merges previously separate VisitPrepNotes content into VisitPrepSummary.
Patient-reported daily medication adherence check-in capturing response status, missed medications, and optional notes.
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.
Application configuration for daily check-in notification scheduling and day-of-week preferences.
Date of the check-in (normalized to midnight)
Adherence response: allTaken, missedSome, skippedToday
Comma-separated UUIDs of missed medications (when response is missedSome)
Timestamp when the check-in was submitted
The discussion topic question or statement
Category: durationBased, recentChange, adherenceConcern, sideEffectReport, multipleForSame, supplementDoctor, interactionRisk, refillDue, effectivenessConcern, costConcern, custom
Source type: medication, supplement, medicationPair, supplementMedicationPair, adherencePattern, custom
Whether the topic is active for the next visit
Optional medication name providing context
Notification hour in 24-hour format (0-23)
Comma-separated enabled days: sunday, monday, tuesday, wednesday, thursday, friday, saturday
Link to a daily medication adherence check-in record.
Link to a discussion topic for a healthcare visit.
Link to check-in notification configuration.
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.
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.
LOINC panel code identifying the questionnaire section (e.g., 71421-2 for Social History, 10187-3 for Review of Systems)
Human-readable title of the questionnaire section
Link to a ResponseItem containing a question-answer pair
Timestamp when the questionnaire response was completed
LOINC item code identifying the question (e.g., 72166-2 for Tobacco smoking status, 63512-8 for Alcohol use)
Coded answer value from a standard terminology (SNOMED CT or LOINC answer code)
Code system URI for the coded answer (e.g., http://snomed.info/sct/, http://loinc.org/)
Nested sub-item for hierarchical questionnaire structures (e.g., follow-up questions based on answers)
Link to a completed intake questionnaire response section.
DEPRECATED (v3.0): checkup:WellnessBaseline class removed. Use checkup:WellnessProfileReference to link to SDK HealthProfile.
DEPRECATED (v3.0): checkup:ActivitySummary class removed. Use checkup:WellnessProfileReference to link to SDK HealthProfile.
A recorded change to a medication or supplement since the last visit snapshot. Tracked for the Changes Since Last Visit report section.
Type of change: added, stopped, doseChanged, frequencyChanged, adherenceChanged, statusChanged.
Name of the field that was changed (e.g., dose, frequency).
Link from a MedicationSummary or SupplementSummary to a change record.
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.
A typed item within a VisitPrepTray. Wraps VisitIssue, DiscussionTopic, SuggestedQuestion, note, or custom content with intent category and resolution tracking.
Display title for the visit prep (e.g., 'Rheumatologist - Feb 28').
Name of the healthcare provider for this appointment.
Provider specialty (e.g., 'Rheumatology', 'Cardiology').
Tray status: preparing, ready, completed.
Link from a VisitPrepTray to a VisitTrayItem.
Payload discriminator: issue, topic, question, note, custom.
Intent of the tray item: discuss, schedule, inform, ask.
Whether the tray item has been addressed or resolved.
Health Map section this item originated from (e.g., 'medications', 'conditions').
UUID linking to the source record that prompted this tray item.
Link from IntakeFormData to a VisitPrepTray.
UUID of the currently active visit prep tray on IntakeFormData.
Link to a lab result summary entry. Replaces dark vocabulary checkup:hasLabResultSummary.
URI reference to the patient's HealthProfile wellness data file.
When the medication or supplement data was last snapshotted from clinical records.
End date for a medication prescription. Replaces dark vocabulary checkup:endDate (disambiguated from other end-date uses).
Free-text notes about an immunization record. Replaces dark vocabulary checkup:notes (disambiguated from clinical:notes used in lab results).
Whether the patient is currently taking this supplement. Replaces dark vocabulary checkup:isActive (disambiguated from generic boolean use).
Universal Product Code for supplement identification. Replaces dark vocabulary checkup:upc (disambiguated with supplement prefix).