healthcare-emr-patterns

EMR/EHR development patterns for healthcare applications. Clinical safety, encounter workflows, prescription generation, clinical decision support integration, and accessibility-first UI for medical data entry. Use when building EMR or EHR features such as encounter workflows, prescription generatio

By affaan-m · 2,831 installs

npx skills add affaan-m/ecc --skill healthcare-emr-patterns

Source repository · Upstream listing

Healthcare EMR Development Patterns Patterns for building Electronic Medical Record (EMR) and Electronic Health Record (EHR) systems. Prioritizes patient safety, clinical accuracy, and practitioner efficiency. When to Use Building patient encounter workflows (complaint, exam, diagnosis, prescription) Implementing clinical note taking (structured + free text + voice to text) Designing prescription/medication modules with drug interaction checking Integrating Clinical Decision Support Systems (CDSS) Building lab result displays with reference range highlighting Implementing audit trails for clinical data Designing healthcare accessible UIs for clinical data entry How It Works Patient Safety First Every design decision must be evaluated against: "Could this harm a patient?" Drug interactions MUST alert, not silently pass Abnormal lab values MUST be visually flagged Critical vitals MUST trigger escalation workflows No clinical data modification without audit trail Single Page Encounter Flow Clinical encounters should flow vertically on a single page — no tab switching: Smart Template System Red flags in any template must trigger a visible, non dismissable alert — NOT a toast notification. Medication Safety Pattern Critical interactions block prescribing by default . The clinician must explicitly override with a documented reason stored in the audit trail. The system never silently allows a critical interaction. Locked Encounter Pattern Once a clinical encounter is signed: No edits allowed — only an addendum (a separate linked record) Both original and addendum appear in the patient timeline Audit trail captures who signed, when, and any addendum records UI Patterns for Clinical Data Vitals Display: Current values with normal range highlighting (green/yellow/red), trend arrows vs previous, clinical scoring auto calculated (NEWS2, qSOFA), escalation guidance inline. Lab Results Display: Normal range highlighting, previous value comparison, critical values with non dismissable alert, collection/analysis timestamps, pending orders with expected turnaround. Prescription PDF: One click generation with patient demographics, allergies, diagnosis, drug details (generic + brand, dose, route, frequency, duration), clinician signature block. Accessibility for Healthcare Healthcare UIs have stricter requirements than typical web apps: 4.5:1 minimum contrast (WCAG AA) — clinicians work in varied lighting Large touch targets (44x44px minimum) — for gloved/rushed interaction Keyboard navigation — for power users entering data rapidly No color only indicators — always pair color with text/icon (colorblind clinicians) Screen reader labels on all form fields No auto dismissing toasts for clinical alerts — clinician must actively acknowledge Anti Patterns Storing clinical data in browser localStorage Silent failures in drug interaction checking Dismissable toasts for critical clinical alerts Tab based encounter UIs that fragment the clinical workflow Allowing edits to signed/locked encounters Displaying clinical data without audit trail Using any type for clinical data structures Examples Example 1: Patient Encounter Flow Example 2: Medication Safety Workflow Example 3: Locked Encounter + Addendum