Visit Summary (Printable; early discharge summary)

Visit Summary (Printable; early discharge summary)

4 Must-Do’s

Find out from Implementers: Typical Printer constraints/expectations. E.g. do they expect to use a receipt printer? A4?
1. Problem Description: Have you clearly defined the user problem(s) you intend to solve, and what value this creates? Write down a story, user insight, or quote about this problem (this is important because (1) this will motivate your team, and (2) without this your problem might not actually be a big problem for the users themselves).
2. User Stories: Have you clearly written at least 3 user stories and use cases
3. Market Analysis: Have you surveyed what the market is doing here (e.g. comparison to other EMRs, or paper approaches; and don’t forget about learning from historic/existing OMRS instances)? Have you written down any possible gaps in your understanding of your users or their workflows? Have you reviewed the topic in FHIR to see what requirements or fields the global community references? (Eg if working on insurance, should look here)
4. Technical Considerations & Dependencies: Have you outlined what you need from cross-functional areas for success of the feature? E.g. do you need the platform to support a new API call? Have you explained how you’ve addressed dev concerns, such as designs that may not be feasible, or will be extra time-intensive to implement? 

Optional/Encouraged

Sketches: Have you added a drawing or description of how the feature could work to solve the problem at hand? (Pictures of sketches are ok!) 
Project Management: Have you created the Epic and JIRA tasks so you can share work clearly? Roll-out plan: Do you have an idea whether this will be an experiment, gradual roll out, and when? Have you added this to the timeline view? Have you planned how you will promote and/or work with communications folks in order to help this feature reach the widest audience and have the biggest impact it can?

Later but should do

QA Plan: Have you mentioned the plan for QA, such as how you will discover and address edge cases? Does your team/squad have a plan for automated tests to be added to new components (unit tests) or workflows (e2e tests)?
Safety & Tech Risks: Is there any reason you could regret rolling out this feature? (e.g. possible patient harm, heavy tech debt like introducing an unsupported library) Have you thought through the risks for this particular solution? And, how to reduce/address those? 

This checklist was inspired by this article. Additional Business Analyst Resources here.

Status: Requirements In Progress

Technical Complexity: Medium

Summary:

A printable visit summary serves both patient-facing needs (personal records, insurance claims) and provider-facing requirements (referrals, discharge documentation, care continuity).

  • It provides patients with comprehensive visit documentation for personal records, insurance claims, and continuity of care across facilities.

  • It enables providers to generate clean, printable visit summaries that facilitate seamless referrals and discharges while minimizing manual paperwork.

  • It ensures insurance companies receive structured, comprehensive visit records that facilitate efficient claim processing and reduce documentation queries.

image-20251023-150149.png

1. Problem

⚠️ RefApp currently lacks a printable visit summary that serves patient documentation needs and facilitates provider workflows for referrals, discharges, and care coordination.

  • Lack of printed visit summaries leaves patients without essential documentation for personal health records, facility-to-facility care coordination (where there is no digital records integration), and insurance claims.

  • Manual visit documentation consumes clinicians' time, introduces inconsistencies and illegibility issues, and results in information gaps during patient referrals, transfers or discharge.

  • Incomplete or inadequate visit documentation results in delayed insurance claims, disrupts care continuity between facilities, and increases administrative costs through manual, error-prone processes.

Roadmap item: https://openmrs.atlassian.net/browse/OMRS-348

Notable Constraints:

  • Cost: Printing is considered a very costly expense (for most OpenMRS, low-resource sites). This is because there needs to be a budget for paper and ink that is continuously refilled month by month. For this reason, we generally want to keep printed summaries as dense & simple as possible to reduce paper and ink costs.

    • Example: EGPAF Malawi was printing HIV visit summaries on barcode labels!

2. User Stories and Workflows

1️⃣ Patient-Facing Needs

1.1: Patient Portable Records

🎯 As a patient, I want a printed visit summary with clinical findings, medications, and recommendations in clear language for my personal records and future healthcare visits, so I can use the summary to help another provider to understand my clinical issues.

1.2: Patient Insurance Documentation (For Reimbursement)

🎯 As a patient with health insurance, I want a printed visit summary with complete diagnoses, treatments, and billable services for insurance claim submission for reimbursement.

Note that in both of these cases, the end-user is ultimately not the patient: It’s the next provider who reviews the record (next clinician or insurance reviewer). Patient Education is outside of the scope of this project for now.

2️⃣ Provider-Facing Requirements

2.1: Provider Time Optimization

🎯 As a physician, I want automated visit summary generation from EMR data so that I can focus more time on direct patient care rather than manual documentation.

3️⃣ Insurance Claim Processing & Revenue Management

3.1: Insurance Processing & Facility Billing

🎯 As an insurance claims processor and billing manager, I want complete, standardized visit documentation with all required fields and itemized billable services to process claims efficiently, minimize rejections, and reduce reimbursement delays.

4️⃣ Standardized Referral Documentation

4.1: Provider Referral Exchange

🎯 As a referring provider, I want to generate standardized referral summaries with relevant medical history, current medications, allergies, vital signs, and specific consultation questions so that receiving providers have complete information to prepare for the patient visit and deliver optimal care.

4.2: Patient Care Continuity During Referrals

🎯 As a patient being referred, I want complete documentation from my referring doctor so that my next provider has my medical history and I don't have to repeat information during my visit.

3. Market Analysis

  1. Bahmni: https://talk.openmrs.org/t/bahmni-lite-print-certificate/40228/2

Strengths

Key Features

Strengths

Key Features

  1. Demographics (name, age, gender, address, identifiers)

  2. Visit / Encounter Details

  3. Clinical Observations (vitals, symptoms, lab results)

  4. Diagnoses & Conditions

  5. Medications & Treatments

  6. Procedures & Orders

  7. Discharge Notes / Clinical Notes

  1. Ensures correct patient identity and supports referrals or transfers.

  2. Provides a structured overview of each consultation or hospital admission.

  3. Offers a consolidated view of patient condition for follow-up care or external referrals.

  4. Highlights current and past conditions for continuity of care.

  5. Lists prescriptions and treatments given, helping avoid duplication and errors.

  6. Captures clinical interventions (e.g., lab/imaging requests).

  7. Enables narrative summaries that contextualize structured data

image-20250923-054525.png
❶ Bahmni – Printable Patient Report (Summary)
image-20250923-054803.png
❷ Bahmni – Printable Patient Report (Summary)

 

image-20250923-054829.png
❸ Bahmni – Printable Patient Report (Summary)

 

image-20250923-054846.png
❹ Bahmni – Printable Patient Report (Summary)

 

  1. Openemr:

Strengths

Key Features

Strengths

Key Features

  1. Quick reference for a patient’s active and past conditions.

  2. Detailed medication information including RxNorm code, status, form, strength, quantity, indications

  3. Flexible—clinicians can print only what’s relevant for a referral, summary, or insurance claim.

  4. Patient report can be generated for a specified period

  1. Medical Problems / Diagnoses

  2. Medications

  3. Customizable Sections (checkbox selection before generating report)

  4. Date range selection

image-20250923-045546.png
Continuity of Care Record - Report Generation

 

image-20250923-045606.png
Continuity of Care Record - Generated Report

 

image-20250923-045648.png
Continuity of Care Document - Customizable Sections

 

image-20250923-045806.png
Continuity of Care Document - Generated Report

 

image-20250923-045839.png
Continuity of Care Document - Generated Report

 

  1. PIH EMR

Strengths

Key Features

Strengths

Key Features

  1. Demographics & Identifiers (name, age, gender, address, medical record number, program IDs)

  2. Shows program-specific context, which is critical in long-term care and cohort monitoring.

  3. Quickly conveys active conditions and chronic illnesses.

  4. Includes medications

  5. Includes lab data i.e., test, date of the test and test results

  6. Provides a chronological view of patient visits, enabling clinicians to see progress over time.

  7. Local implementations (e.g., HIV summary in Haiti, maternal health summary in Sierra Leone) tailor printouts to specific use cases.

  1. A clear, patient identity for handoff and referrals.

  2. Program Enrollment Information (e.g., HIV, TB, NCD programs)

  3. Problem List / Diagnoses

  4. Medications & Prescriptions

  5. Lab & Diagnostic Results

  6. Vitals & Biometrics

  7. Encounter History

  8. Customizable Templates

image-20250923-064330.png
image-20250923-070401.png

4. Technical Considerations & Dependencies

Use updated OpenMRS-module-commonreports backend module to support.

Our technical plan is to use the same underlying technology that Joshua Nsereko has been working on for the print-label feature.

  1. Print functionality location: Make the print function accessible directly under the visit to align with clinical workflows and reduce friction.

  2. Preview before print: Allow users to review and potentially edit before printing

  3. Data Sources: Patient summary pulls from multiple modules: demographics, encounters, forms, meds, allergies, vitals, immunizations, billing. This calls for proper mappings.

  4. Customization: Facilities may desire to add/remove fields in the patient summary to suit the need (e.g., billing, lab results). Is it feasible to have templates that are easy to adjust???

  5. Security and Privacy: Access control: Only authorized users should generate/print reports.

  6. Styling and layout: CSS drives printable format. Different clinics may want logo, header/footer, contact info etc.

  7. Multi-language / Localized Printing: Supports localized content for different countries and languages.

  8. Incomplete data handling: How to display pending lab results????

5. Sketches

image-20251103-122312.png
image-20251103-122502.png

Sample Visit Summary

image-20250930-075858.png
Add a Print icon/button directly in the visit row alongside the existing edit pencil icon (<Printer />)

Data Element

OMRS Data Source

Concept / Form

Patient ID

person attributes

 

Patient Name

person attributes

 

Age

person attributes

Calculated from person birthdate

Gender

person attributes

 

Visit Date

visits table

 

Provider

encounter_providers table

 

Department *

visit type

Start visit form

Systolic BP

obs table

5085AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Diastolic BP

obs table

5086AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Heart Rate

obs table

5087AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Temperature

obs table

5088AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Respiration Rate

obs table

5242AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

O2 Saturation

obs table

5092AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Height

obs table

5090AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Weight

obs table

5089AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

Primary Diagnosis

diagnoses table

 

Secondary Diagnosis

diagnoses table

 

Conditions

conditions table

 

Lab Test

test_order table

 

Lab Result

obs table

 

Drug Order

drug_order table

 

Next Appointment

appointments table