Skip to main content

Patient Registration & Master Patient Index (MPI)

This section describes the complete workflow for searching the Master Patient Index (MPI), preventing duplicate records, capturing comprehensive patient demographics, and generating official Moana Health ID cards.


1. Purpose & Overview

The Registration module creates and manages each patient's identity record in Moana. It assigns a unique Moana Patient ID and links all encounters, results, diagnoses, and medications to a single, unduplicated identity. The Master Patient Index (MPI) is the identity foundation of the entire system — a correct registration at this stage protects every subsequent clinical process.

  • Authorized Roles: Hospital Receptionist, Registration Clerk, Triage Nurse, Doctor, Hospital Administrator.
  • Primary Objective: Prevent duplicate identity records by conducting a mandatory MPI duplicate search before initiating new registrations.

2. Two Registration Paths — Know the Difference

Registration PathHow to AccessDuplicate Detection MechanismAdmin Review Queue?When to Use
Path A — Add PatientPatients screen → + Add PatientExact match only (National Health ID or Phone Number)NoStandard walk-in registration of clearly new patients
Path B — Patient Registry (MPI)External Diagnostics → Patient Registry (MPI) tabWeighted probabilistic match: Name, DOB, Phone, Gender, VillageYes — Admin resolvesWhen a patient may already exist; near-duplicate validation scenarios
IMPORTANT:

Patient Safety Checkpoint: Search Before Create Always search for the patient before creating a new record. Duplicate patient records split the clinical history — a missed allergy or previous diagnosis in an unseen record is a severe patient safety risk. If in doubt, use Path B (MPI screen) to catch near-matches.


3. Step-by-Step — Path A: Standard Walk-In Registration

graph LR
A[1. Search MPI by Name/ID] --> B{Matching Record Found?}
B -->|Match Found| C[Open Existing Patient Record]
B -->|No Match| D[2. Click '+ Add Patient']
D --> E[3. Fill Required Demographics]
E --> F[4. Save & Assign Moana ID]
  1. Search First: Open the Patients screen from the sidebar. Type the patient's name and date of birth in the search bar. Review ALL results before proceeding.
  2. Verify Existing Record: If a matching record is found, verify identity with a second identifier (National ID, phone, or address). Use the existing record — do not create a new one.
  3. Open Registration Form: If no match is found, click + Add Patient.
  4. Complete Demographics: Fill all mandatory fields:
    • First Name & Last Name (Required for identity verification at every clinical step).
    • Date of Birth (DOB) (Required — drives age-based dosing, pediatric pathways, and deduplication weighting).
    • Gender / Biological Sex (Male, Female, Other — drives sex-specific biological reference ranges in laboratory).
    • Phone Number (Minimum 7 digits — exact-match deduplication and patient contact).
    • National Health ID & Village (Strongly recommended for national system integration).
    • Emergency Contact (Mandatory for unconscious or incapacitated patients).
  5. Unconscious or Unidentified Patient: Tick the "Unknown Patient" checkbox. This allows minimum emergency registration immediately. Return to add full demographics once the patient is stabilized.
  6. Submit & Conflict Check: Click Submit. The system checks for exact matches. If a conflict appears, a record for this person already exists — open that existing record.
  7. Moana ID Assigned: The new Moana Patient ID is generated. The patient appears in the patient list and is immediately ready for encounter creation and clinic routing.
Path A Standard Patient Registration and Demographics Form
Path A Standard Patient Registration and Demographics Form🔍 Click to enlarge

4. MPI Weighted Probabilistic Scoring — Path B

Path B computes a probabilistic similarity score across multiple demographic fields:

Demographic FactorRelative WeightCalculation & Matching Example
Name Similarity0.50Partial or alternate spelling catches (e.g., "Johan" vs "John")
Same Date of Birth0.25Strong indicator; exact birth date match required
Same Phone Number0.15Exact match on registered contact phone
Same Gender0.05Minor factor; gender classification match
Same Village / Address0.05Minor factor; strengthens near-matches

Scoring Threshold Actions

  • Score ≥ 0.90 (Auto-link): System links to existing record automatically — no manual review needed.
  • Score 0.55 – 0.90 (Review Queue): Admin reviews in MPI Queue and decides: Link (same person) or Create (different person).
  • Score < 0.55 (New Record): System creates a new distinct patient record automatically.

5. Required Demographics & Clinical Impact

Demographic FieldRequirement LevelDirect Clinical Impact & Safety Rule
First Name & Last NameMandatoryPositive patient identity verification at every clinical step.
Date of BirthMandatoryCRITICAL: Drives age-based pediatric dosing calculations and deduplication weighting.
GenderMandatoryDeduplication weighting; sex-stratified biological reference ranges in laboratory tests.
Phone NumberMandatory (7+ digits)Exact-match deduplication; emergency contact for critical lab/radiology results.
National Health IDStrongly RecommendedStrongest unique deduplication identifier; aligns with national digital health registries.
Village / Residential AddressRecommendedMPI weighted scoring; geographical health surveillance and contact tracing.
Emergency ContactRecommendedMandatory for unconscious, pediatric, or incapacitated patients.

6. Registration Training Scenarios (R1 – R4)

Scenario CodeScenario TitleAction PerformedExpected Clinical Outcome
R1New Walk-In PatientSearch MPI → no match found → Path A registration with all fields → SubmitMoana ID assigned; no duplicate; patient queued for encounter.
R2Returning PatientSearch MPI → match found → verify with second identifier → open existing recordNo new record created; existing longitudinal record used.
R3Near-Duplicate RecordSimilar patient loaded → Path B → near-match enters review queue → Admin resolvesCorrectly queued; Admin links or creates; no silent duplicate creation.
R4Unknown Emergency PatientEmergency trauma arrival; Unknown Patient flag ticked → minimum registrationEncounter opens immediately; full demographics completed retrospectively when stable.