Introduction¶
Welcome to FHIR Electronic Medical Records - an open-source Electronic Medical Records system built with modern healthcare standards.
What is FHIR Electronic Medical Records?¶
FHIR Electronic Medical Records is a FHIR-based EMR system designed for clinics, hospitals, and healthcare developers. It combines:
- ✅ HL7 FHIR R4 compliance for full interoperability
- ✅ Intelligent medical coding with ICD-10 and SNOMED CT autocomplete
- ✅ Production-ready architecture with Spring Boot and PostgreSQL
- ✅ Professional healthcare UI designed for clinical workflows
Why FHIR Electronic Medical Records?¶
The Problem¶
Most Electronic Medical Records systems suffer from:
- Vendor lock-in - Proprietary formats and expensive licensing
- Poor interoperability - Can't exchange data with other systems
- Manual coding - Doctors spend 2-3 minutes looking up medical codes
- Outdated UI - Built for desktops in the 2000s
Our Solution¶
| Problem | MediCare Solution |
|---|---|
| Vendor lock-in | Open source (MIT license), standard FHIR data |
| Poor interoperability | 100% HL7 FHIR R4 compliant |
| Manual coding | Real-time autocomplete (90% time savings) |
| Outdated UI | Modern responsive teal healthcare theme |
Key Features¶
Intelligent Autocomplete¶
ICD-10-CM for diagnoses (live API):
SNOMED CT for medications and allergens (local library):
Time Savings: 90% reduction (from 2-3 minutes to 10 seconds per code)
13 FHIR Resources¶
Complete clinical workflow coverage:
- Patient - Demographics, insurance, emergency contacts
- Practitioner - Healthcare providers and qualifications
- Appointment - Scheduling and booking
- Encounter - Clinical visits
- Condition - Diagnoses with ICD-10 autocomplete
- MedicationRequest - Prescriptions with SNOMED autocomplete
- AllergyIntolerance - Allergies with SNOMED autocomplete
- Procedure - Surgical and diagnostic procedures
- ServiceRequest - Lab tests and imaging orders
- DocumentReference - Clinical documents
- FamilyMemberHistory - Genetic conditions with ICD-10 autocomplete
- Organization - Hospitals and clinics
- AuditEvent - Complete audit trail
Professional UI¶
- Sticky patient identity bar - Patient info always visible
- Allergy safety banner - High-criticality warnings on every page
- Breadcrumb navigation - Dashboard › Patients › John Doe › Medications
- Clinical tab bar - Quick access to all patient records
- Teal medical theme - Calm, professional color palette
Architecture¶
graph TB
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]
style B fill:#14b8a6
style D fill:#0ea5e9
style E fill:#8b5cf6Tech Stack:
- Backend: Spring Boot 3.2.x, Java 17+
- FHIR: HAPI FHIR 6.x (R4)
- Frontend: Thymeleaf, Vanilla JavaScript
- Medical Coding: NIH Clinicaltables API + local SNOMED CT
Who Is This For?¶
Healthcare Organizations¶
- 🏥 Small to medium clinics needing modern EMR
- 🏫 Medical schools teaching EHR workflows
- 🔬 Research institutions collecting clinical data
- 🌍 International healthcare adapting to local codes
Developers & IT Teams¶
- 💻 Healthcare developers learning FHIR
- 🏗️ System architects needing reference implementation
- 🔧 Integration teams building HL7 connections
- 📚 Students learning healthcare IT
System Requirements¶
Minimum:
- Java 17 or higher
- 2GB RAM (4GB recommended)
- 1GB disk space
- Modern web browser
Development:
- IDE (IntelliJ IDEA, Eclipse, VS Code)
- Maven 3.6+
- Git
- Docker (optional)
Getting Help¶
- 📖 Documentation - You're reading it!
- 💬 GitHub Discussions - Ask questions
- 🐛 Issue Tracker - Report bugs
- 📧 Email - support@medicare-erp.com
Next Steps¶
- Quick Start - Get running in 5 minutes
- Installation - Detailed setup guide
- Configuration - Customize settings
Already Familiar with FHIR?
Skip to Features Overview to see what makes MediCare unique.