Skip to content

Quick Start Guide

Get FHIR Electronic Heath Records running in 5 minutes. This guide gets you from zero to a working EMR system.

Prerequisites

Before you begin, ensure you have:

  • Java 17 or higher installed
  • Maven 3.6+ (or use included Maven wrapper)
  • Git for cloning the repository
  • 8080 port available (or configure a different port)

Check Your Java Version

java -version
# Should show: openjdk version "17.0.x" or higher

Option 1: Quick Run (H2 Database)

Perfect for testing and development. Uses in-memory database.

Step 1: Clone the Repository

git clone https://github.com/medicare-erp/medicare-erp.git
cd medicare-erp

Step 2: Run the Application

./run.sh

run.bat

./mvnw spring-boot:run

Step 3: Access the Application

Open your browser and navigate to:

http://localhost:8080

You should see the MediCare ERP login page.

That's It!

The application is now running with an H2 in-memory database. Perfect for testing!

Step 3: Configure Application

Edit src/main/resources/application.properties:

Step 4: Run the Application

./mvnw spring-boot:run

Step 5: Verify Installation

Navigate to http://localhost:8080

Default Credentials

After first run, use these default accounts:

Role Username Password
Admin admin admin123
Doctor doctor doctor123
Nurse nurse nurse123

Change Default Passwords

These are demo credentials. Change them immediately in production!

First Steps

1. Create a Patient

  1. Navigate to Patients in the sidebar
  2. Click Add New Patient
  3. Fill in patient demographics
  4. Click Save Patient

2. Record an Allergy

  1. Open the patient record
  2. Click Allergies tab
  3. Click Record Allergy
  4. Type "peni" in Allergen Name
  5. Select "Penicillin" from autocomplete
  6. Set criticality to "High"
  7. Click Save Allergy

3. Add a Diagnosis

  1. Click Problems tab
  2. Click Add Diagnosis
  3. Type "diab" in Diagnosis Name
  4. Select "E11.9 Type 2 diabetes mellitus" from autocomplete
  5. Set status to "Active"
  6. Click Save Diagnosis

4. Write a Prescription

  1. Click Medications tab
  2. Click New Prescription
  3. Type "metf" in Medication Name
  4. Select "Metformin" from autocomplete
  5. Enter dosage: "500 mg"
  6. Enter frequency: "Twice daily"
  7. Click Save Prescription

Congratulations!

You've just experienced the core features:

  • ✅ Patient management
  • ✅ SNOMED CT allergen autocomplete
  • ✅ ICD-10-CM diagnosis autocomplete
  • ✅ SNOMED CT medication autocomplete

Testing the Autocomplete

ICD-10 Autocomplete (Diagnoses)

Try typing these in the diagnosis field:

  • diabetes → See E11.9, E10.9
  • hypertension → See I10, I11.0
  • asthma → See J45.9
  • copd → See J44.9
  • pneumonia → See J18.9

SNOMED CT Autocomplete (Medications)

Try typing these in medication field:

  • metformin → 108774000
  • lisinopril → 386873009
  • atorvastatin → 318272004
  • aspirin → 372756006
  • omeprazole → 372756006

SNOMED CT Autocomplete (Allergens)

Try typing these in allergen field:

  • penicillin → 387517004
  • peanuts → 227493005
  • latex → 111088007
  • sulfa → 387404004

Troubleshooting

Port 8080 Already in Use

Change the port in application.properties:

server.port=8081

Java Version Error

Ensure Java 17+ is installed:

java -version

If using older version, install Java 17:

sudo apt install openjdk-17-jdk  # Ubuntu/Debian
brew install openjdk@17          # macOS

Maven Build Fails

Clean and rebuild:

./mvnw clean install

Next Steps

Now that you're up and running:

  1. Installation Guide - Detailed setup options
  2. Configuration Guide - Customize your instance
  3. User Guide - Learn clinical workflows
  4. Features Overview - Explore all features

Need Help?