Kulcare Docs
DeveloperCare plansCare planArchitecture

Architecture Documentation

Core architectural concepts and data models for the clinical documentation system.

Documents

DocumentDescription
LHR ConceptWhat LHR means, industry context, and Kulcare's approach
LHR Components AuditWhat's implemented vs planned for comprehensive LHR
LHR Presentation StrategyHow to present LHR in the UI, role-based views
Clinical Data HierarchyCore relationships: LHR, Episode of Care, Encounter
Multi-Practitioner Encounter TypesEncounterDocument model for practitioner-specific documentation

Standard Healthcare Terminology

Kulcare uses industry-standard terminology where possible:

Kulcare TermFHIR StandardDescription
LHRN/A (computed view)Patient's complete health story - application concept
Episode of CareEpisodeOfCareTreatment program container
EncounterEncounterSingle visit/session
ProblemConditionPatient condition/diagnosis
PrescriptionMedicationRequestMedication order
Care PlanCarePlanTreatment plan
Vital SignsObservationClinical measurements

See LHR Concept for complete terminology mapping.

Key Concepts

Clinical Data Hierarchy

The system is built around three levels:

  1. Longitudinal Health Record (LHR) - Computed aggregate view of patient's complete health story
  2. Episode of Care - Container for related encounters in a treatment program (PLANNED)
  3. Encounter - Single visit/session where documentation is created

Data Flow

Encounter (atomic)
    |
    +-- Creates: Vitals, Medications, Notes, Assessments
    v
Episode of Care (if linked)
    |
    +-- Aggregates: Session count, Goal progress
    v
Longitudinal Health Record (computed)
    |
    +-- Aggregates: All data across encounters
    +-- Computes: Health score, trends, alerts

On this page