Skip to main content

Clinical Modules Overview

OpenEyes is built on a modular architecture where each clinical activity is handled by a dedicated event module. This design allows for flexibility, extensibility, and specialization of clinical workflows.

Module Architecture

Each module in OpenEyes represents a specific clinical event type and follows a consistent structure:
  • Controllers: Handle user interactions and workflow logic
  • Models: Define data structures and business rules
  • Views: Render the user interface
  • Elements: Modular components that can be added to events

Event-Based System

Clinical data in OpenEyes is organized around events - discrete clinical activities that occur at specific points in time. Each event is created by a module and can contain multiple elements.
All clinical modules extend the base event framework, ensuring consistency while allowing for specialty-specific customization.

Module Categories

OpenEyes modules are categorized by prefix, indicating their primary purpose:

OphCi - Clinical Investigation

Modules for recording clinical findings and examinations

OphDr - Drug Administration

Modules for prescribing and administering medications

OphTr - Treatment

Modules for surgical and therapeutic procedures

OphCo - Communication

Modules for correspondence and documentation

OphIn - Investigation

Modules for diagnostic tests and measurements

OphOu - Outcomes

Modules for patient-reported outcomes and audits

Core Clinical Modules

Clinical Investigation (OphCi)

The most comprehensive module in OpenEyes, containing 59+ element types for recording complete ophthalmic examinations. Supports configurable workflows for different subspecialties.Key Features:
  • Visual acuity (distance and near)
  • Intraocular pressure measurement
  • Anterior and posterior segment examination
  • Diabetic retinopathy grading
  • Glaucoma risk assessment
  • OCT and imaging integration
  • Management plans and clinic outcomes
Learn more →
Records diurnal IOP variation studies, used primarily in glaucoma management.
Documents when patients miss scheduled appointments, important for clinic management and patient tracking.

Drug Administration (OphDr)

Handles the complete prescription workflow from creation through to dispensing and administration.Features:
  • Medication selection with formulary integration
  • Allergy checking and drug interaction warnings
  • Electronic prescription generation
  • Print and digital distribution
  • Prescription authorization workflow
Learn more →
Manages Patient Group Directions (PGD) and Patient Specific Directions (PSD) for protocol-based prescribing.

Treatment (OphTr)

Manages the surgical scheduling workflow:
  • Procedure selection and laterality
  • Theatre diary management
  • Scheduling and rescheduling
  • Pre-assessment tracking
  • Patient communication letters
Learn more →
Comprehensive surgical documentation with procedure-specific templates for cataract, vitreoretinal, glaucoma, corneal, and other ophthalmic surgeries.Learn more →
Digital WHO surgical safety checklists for theatre management.
Specialized module for recording anti-VEGF and other intravitreal therapy.
Documents various laser treatments including PRP, focal laser, YAG capsulotomy, and SLT.

Communication (OphCo)

Robust letter generation system with template-based workflows.Capabilities:
  • GP and patient letters
  • Internal referrals
  • Template macros and snippets
  • Digital signature support
  • Bulk printing and electronic distribution
Learn more →
Secure internal messaging for clinical team communication.
Manages applications for funding approval for expensive therapies (e.g., anti-VEGF treatments).
Electronic CVI completion and submission for patients with significant vision loss.
Attach and manage external documents within patient records.

Investigation (OphIn)

Captures biometry measurements for IOL calculation in cataract surgery.Features:
  • Axial length measurements
  • Keratometry readings
  • IOL power calculations
  • Multiple formula support (SRK/T, Holladay, Haigis, Barrett, etc.)
  • Device integration
Learn more →
Records and tracks visual field test results with support for various testing strategies.
Integrates laboratory test results into patient records.
Tracks DNA sample extraction for genetic testing.
Manages DNA sample collection and storage.
Records genetic test results for inherited eye conditions.

Outcomes & Audits (OphOu)

Collects patient satisfaction data for anaesthetic audit.
Patient-reported outcome measures specific to cataract surgery.

Supporting Modules

OphGeneric

Generic event module for recording non-specialized clinical activities

Genetics

Comprehensive genetics module for inherited eye disease clinics

PatientTicketing

Virtual clinic and patient queue management

OETrial

Clinical trial patient recruitment and tracking

Module Configuration

Modules can be enabled or disabled per installation and configured for specific subspecialties. The OphCiExamination module, for example, allows different sets of elements to be available for different subspecialties (glaucoma, medical retina, cataract, etc.).
'modules' => [
    'OphCiExamination' => [
        'class' => '\OEModule\OphCiExamination\OphCiExaminationModule',
    ],
    'OphDrPrescription' => [
        'class' => 'application.modules.OphDrPrescription.OphDrPrescriptionModule',
    ],
],

Element Architecture

Modules use a flexible element-based architecture:
  • Elements are reusable components that capture specific clinical data
  • Events can contain multiple elements
  • Elements can be mandatory or optional
  • Element availability can be configured per subspecialty
  • Elements support laterality (left/right eye)
The modular design allows institutions to customize OpenEyes to match their clinical workflows while maintaining a consistent core framework.

Next Steps

Examination Module

Deep dive into the OphCiExamination module

Prescriptions

Learn about medication management

Operations

Surgical workflow documentation

Build docs developers (and LLMs) love