Patient Management API

Related: Main API Documentation

Table of Contents

1. Patient Friendly ID Generation
2. Duplicate Detection Engine
3. Patient Merge API
4. Code Examples
5. Performance Considerations

Patient Friendly ID Generation

Overview

Service: PatientIdGeneratorService

Interface: IPatientIdGeneratorService

Purpose: Generate unique, human-readable patient IDs with thread-safe concurrent creation.

ID Format

Pattern: P-{YEAR}-{SEQUENCE}
Example: P-2026-0001

Components:

• P - Patient prefix
• {YEAR} - 4-digit year (e.g., 2026)
• {SEQUENCE} - 4-digit zero-padded sequential number (0001-9999)

Thread-Safety Implementation

Problem: Multiple users creating patients simultaneously could generate duplicate IDs.