Admin Membership Administration - hmislk/hmis GitHub Wiki

Membership Administration

Overview

The Membership Administration module manages loyalty and welfare membership programmes. Members carry a card that entitles them to discounted rates, priority service, or welfare benefits. Memberships are linked to patients and can have fee discounts applied automatically during billing.

When to Use

  • Setting up a new loyalty or welfare membership programme
  • Configuring the discount rates that apply to member bills
  • Managing member enrolment and card issuance
  • Reviewing membership statistics

Required Privilege

MembershipAdministration

Navigating to Membership Administration

  1. Click Administration in the main menu
  2. Click Membership Administration
  3. The membership administration index opens

Key Functions

Function Description
Membership Schemes Create and manage the membership programme definitions
Member Enrolment Register patients as members and issue cards
Membership Cards Manage card issuance and renewal
Member Benefits Configure what benefits each scheme includes

Membership Schemes

A Membership Scheme is the template for a membership type (e.g. "Gold Card", "Staff Welfare", "Senior Citizen Discount"). Each scheme defines:

  • The name and description of the programme
  • The validity period
  • Which discounts apply (configured separately via Discount Configuration)

From the Membership Administration index, navigate to Membership Schemes to create or edit schemes.

Discount Configuration for Members

Membership discounts are configured separately in the Discounts section:

  • OPD Discounts by Department — percentage off OPD bills for members, per department
  • OPD Discounts by Category — percentage off OPD service categories
  • Inward Discounts — percentage off inpatient bills
  • Pharmacy Discounts — percentage off pharmacy bills by category
  • Channelling Discounts — discount on channelling booking fees

See Discount Configuration for step-by-step setup.

Integration with Billing

When a patient with an active membership card is billed, the system automatically:

  1. Identifies the applicable membership scheme
  2. Applies the configured discount rates to eligible services
  3. Records the discount on the bill

The cashier does not need to manually enter a discount — it is applied based on the membership record.

Technical Notes (Admin/Developer)

Membership programmes are stored as MembershipScheme entities. Member records link Patient to MembershipScheme with validity dates. Discount records are OpdMemberShipDiscount and InwardMemberShipDiscount entities. The membershipController.navigateToMembershipAdministrationIndex() method navigates to the hub.

Related Features