Patient Management

PATIENT_MANAGEMENT.md

Patient Management

The Patients section is the central registry for all patient records. It stores demographic information, contact details, and discount eligibility, and links to every visit, prescription, invoice, and document associated with each patient.


Accessing the Patient List

Go to Patients in the sidebar. The page displays all registered patients with search and filter controls at the top.

Searching for a Patient

Type a name, email, phone number, or patient code in the search bar. Results update as you type.

Filtering Patients

FilterOptions
SexMale, Female, Other
ActiveActive only, Inactive only, All
Age RangeSet minimum and/or maximum age
CityFilter by city of residence
State / ProvinceFilter by state or province

Sorting

Click the Sort control to order results by:

  • Name A–Z or Z–A
  • Date registered (newest or oldest first)
  • Patient code

Registering a New Patient

  1. Click New Patient (top-right of the Patients page).
  2. Fill in the patient details form.
  3. Click Save.

Required Fields

FieldDescription
First NamePatient's given name
Last NamePatient's family name
Date of BirthUsed to calculate age and eligibility
SexMale, Female, or Other

Optional Fields

FieldDescription
Middle NameOptional middle name
EmailPatient's email address
PhoneContact phone number
Civil StatusSingle, Married, Widowed, etc.
AddressStreet, city, state/province
ActiveToggle to mark the patient as active or inactive

Discount Eligibility

These fields unlock automatic discounts when billing this patient.

FieldDescription
PWD EligibleCheck if patient has a PWD (Persons with Disability) card; enter the PWD ID number
Senior Citizen EligibleCheck if patient qualifies for senior discounts; enter the Senior Citizen ID number
MembershipAssign an active membership plan to apply its discount percentage

Viewing a Patient Profile

Click any patient in the list to open their full profile. The profile page is organized into tabs:

TabContents
OverviewSummary of demographic information and active alerts
VisitsHistory of all clinical visits
AppointmentsPast and upcoming appointments
PrescriptionsAll prescriptions issued to this patient
Lab ResultsLab orders and test results
InvoicesBilling history and outstanding balances
DocumentsUploaded medical files
ReferralsReferrals sent to or from this patient

Patient Alerts

Alerts are notes displayed prominently on the patient profile for clinical staff (e.g., drug allergies, chronic conditions). They appear at the top of the Overview tab and in the queue when the patient is called.


Editing a Patient

  1. Open the patient profile.
  2. Click Edit (top-right).
  3. Update the relevant fields.
  4. Click Save.

Deactivating a Patient

Patients cannot be permanently deleted to preserve medical record integrity. To remove a patient from active searches:

  1. Open the patient profile and click Edit.
  2. Toggle the Active field to off.
  3. Save.

Inactive patients still appear when the "All" filter is selected.


Patient Codes

Every patient is automatically assigned a unique Patient Code (format: CLINIC-####) when registered. This code:

  • Appears on all invoices, prescriptions, and lab results.
  • Can be used to search for the patient.
  • Is printed on QR codes for quick check-in (if QR check-in is enabled).

Tips

  • Before registering a new patient, search by name and phone number to avoid duplicates.
  • Adding a patient's email enables automated appointment reminders (if email is configured in Settings).
  • PWD and senior discount rates are set in Settings → Billing.