Skip to content

Home

FHIR Electronic Medical Records

Open Source FHIR Based Electronic Medical Records System

Akhester FHIR Electronic Medical Records is a modern, production-ready Electronic Medical Records (EMR) system built on HL7 FHIR R4 standards. It features intelligent medical coding with ICD-10 and SNOMED CT autocomplete, comprehensive clinical workflows, and a professional healthcare UI.

🎯 Key Features

📋 FHIR R4 Compliant

Built on HL7 FHIR R4 with 13 core clinical resources. Full interoperability with other healthcare systems.

View FHIR Resources →

🔧 Intelligent Autocomplete

Real-time ICD-10 and SNOMED CT code suggestions. Reduces medical coding time by 90%.

Learn More →

🛡️ Clinical Safety

High-criticality allergy warnings, patient identity verification, breadcrumb navigation for error prevention.

Safety Features →

⚡ Modern Tech Stack

Spring Boot 3, HAPI FHIR, Thymeleaf, PostgreSQL. Production-ready architecture.

Architecture →

🚀 Quick Start

Get FHIR Electronic Medical Records running in 5 minutes:

# Clone repository
git clone https://github.com/vedpr625/FHIR-Electronic-Heath-Records.git

# Run with Maven
./mvnw spring-boot:run

# Or run with provided scripts
./run.sh  # Linux/Mac
run.bat   # Windows

Access the application at http://localhost:8080

Get Started

📋 What's Included

13 FHIR Resources Implemented

Resource Purpose Standard
Patient Demographics, insurance, emergency contacts FHIR R4
Practitioner Healthcare providers, qualifications FHIR R4
Organization Hospitals, clinics, departments FHIR R4
Appointment Scheduling, booking, status tracking FHIR R4
Encounter Clinical visits, admission/discharge FHIR R4
Condition Diagnoses with ICD-10 autocomplete FHIR R4
MedicationRequest Prescriptions with SNOMED autocomplete FHIR R4
AllergyIntolerance Allergies with SNOMED autocomplete FHIR R4
Procedure Surgical/diagnostic procedures FHIR R4
ServiceRequest Lab tests, imaging orders FHIR R4
DocumentReference Clinical documents, reports FHIR R4
FamilyMemberHistory Genetic conditions with ICD-10 autocomplete FHIR R4
AuditEvent Complete audit trail FHIR R4

View All Features

🎨 Modern Healthcare UI

Production-Grade Design

  • Blue medical theme - Professional color palette
  • Sticky patient context - Patient info always visible
  • Clinical tab navigation - Quick access to all records
  • Responsive design - Works on desktop, tablet, mobile
  • Accessibility - Keyboard navigation, WCAG 2.1 AA compliant

Key UI Components:

  • Patient Identity Bar - Gender-coded left border, MRN chip with click-to-copy, sticky positioning prevents wrong-patient errors
  • Allergy Safety Banner - High-criticality allergies shown on every clinical page with red banner and allergen details
  • Breadcrumb Navigation - Dashboard › Patients › John Doe › Prescriptions - always know where you are
  • Medical Autocomplete - Type 3 letters, get ICD-10/SNOMED codes instantly with dropdown showing code + description

💡 Intelligent Medical Coding

ICD-10 Autocomplete

Type diagnosis names and get real-time ICD-10 code suggestions from the NIH Clinicaltables API:

Example: User types "diab"

Dropdown shows:
┌─────────────────────────────────────────────┐
│ E11.9                                       │
│ Type 2 diabetes mellitus                    │
│ ICD-10                                 │
├─────────────────────────────────────────────┤
│ E10.9                                       │
│ Type 1 diabetes mellitus                    │
│ ICD-10                                  │
└─────────────────────────────────────────────┘

Features:

  • ✅ No authentication required
  • ✅ Real-time search (200-400ms response)
  • ✅ Auto-fills code field
  • ✅ Keyboard navigation (↑↓ arrows, Enter, Esc)

SNOMED CT Autocomplete

Local library of 300+ common clinical terms for instant autocomplete:

  • Allergens - Penicillin, Peanuts, Latex, etc.
  • Medications - Metformin, Aspirin, Lisinopril, etc.
  • Procedures - Appendectomy, Hip replacement, etc.

Performance: <10ms response, works offline.

Read Autocomplete Guide →

🏗️ Architecture Overview

graph TD
    A[Web Browser] -->|HTTP| B[Spring Boot 3]
    B -->|Thymeleaf| C[Server-Side Rendering]
    B -->|HAPI FHIR| D[FHIR Store]
    B -->|REST| F[Clinicaltables API]
    B -->|Local| G[SNOMED Codes JS]

    style B fill:#1976d2
    style D fill:#42a5f5
    style E fill:#7c4dff

Tech Stack:

  • Backend: Spring Boot 3.2.x, Java 17+
  • FHIR: HAPI FHIR 6.x (R4)
  • Frontend: Thymeleaf, Vanilla JS, Modern CSS
  • Medical Coding: Clinicaltables API (ICD-10), Local SNOMED CT

Architecture Details →

🎓 Who Is This For?

🏥 Healthcare Organizations

Small clinics, specialty practices, or regional hospitals needing a modern EMR without vendor lock-in.

🎓 Medical Education

Teaching hospitals, medical schools, or training programs demonstrating EHR workflows and FHIR standards.

💻 Healthcare Developers

Teams building FHIR integrations, learning healthcare IT, or prototyping clinical applications.

🌍 Open Source Community

Contributors passionate about open healthcare, FHIR adoption, and accessible medical technology.

📚 Documentation

Getting Started

Installation, configuration, first steps

Features

Autocomplete, FHIR resources, UI

User Guide

Clinical workflows, patient records

Developer Guide

Architecture, API, extensions

🤝 Contributing

We welcome contributions! Whether it's:

  • 🐛 Bug reports
  • 💡 Feature requests
  • 📝 Documentation improvements
  • 🔧 Code contributions
  • 🌍 Translations

Check out our GitHub repository to get started.

📄 License

MediCare ERP is open source under the MIT License. Free for personal, educational, and commercial use.

View License →

🚀 Ready to Get Started?

Quick Start Guide View on GitHub