# Kiosk Patient Self-Registration ## Overview The **Kiosk Self-Registration** feature allows patients to register themselves at a physical kiosk terminal installed in the facility — without requiring any staff intervention. The kiosk is pre-authenticated at the device level; patients do not need an HMIS login. When a patient registers via the kiosk, their record is saved with a **Registration Source** of **Kiosk**, so that clinical and billing staff know the identity has not been verified in person by a staff member. --- ## When to Use This The kiosk registration workflow is designed for: - Outpatient waiting areas where patients can self-check whether they are already in the system, or register themselves before reaching the counter - Emergency and A&E lobby areas where patients with mild conditions can register while waiting - Any facility where reducing front-desk queue time is a priority Kiosk registrations are **identity-unverified** — the patient enters their own demographic details. For patients who need identity-verified records, front-desk or counter registration should be used instead. --- ## How the Kiosk Flow Works The kiosk page is a four-step workflow: ### Step 1 — Search by Mobile Number The patient enters their mobile number. The system searches for existing patient records matching that number (checking both the primary and mobile phone fields). - If the number contains formatting characters (spaces, hyphens, `+` prefix), the system normalises it automatically. - If the number is invalid, the patient is asked to re-enter. ### Step 2 — Results - **If existing records are found:** Each matching profile is displayed with name, NIC, and date of birth. The patient taps **"This is me"** to confirm their identity and proceed to the done screen — no new record is created. - **If no records are found:** The patient proceeds directly to the registration form. ### Step 3 — New Patient Registration Form The patient fills in their details: | Field | Required | |---|---| | Title | Yes | | Full Name | Yes | | Gender | Yes | | Age / Date of Birth | Yes | | Mobile Number | Pre-filled, read-only | | NIC / Passport No | Optional | Selecting a Title automatically updates the Gender field. The patient taps **Register** to save. ### Step 4 — Done A confirmation screen is shown with the patient's name. The patient is directed to proceed to the reception desk. --- ## Registration Source All patients registered via the kiosk receive: - `patient.registrationSource = KIOSK` The **"Kiosk"** badge is then displayed on the patient profile, OPD bill screen, and any other location that shows the Registration Source. Existing patients who confirm their profile via **"This is me"** are **not** modified — their original Registration Source is preserved. --- ## URL / Access The kiosk page is accessible at: ``` /faces/kiosk/kiosk_registration.xhtml ``` No HMIS user login is required. Kiosk terminals should be set up to open this URL directly in a full-screen browser session. --- ## Administrator Notes - The controller is `com.divudi.bean.kiosk.KioskController` (`@ViewScoped`) - The page uses `PatientFacade` and `PersonFacade` directly — no dependency on the logged-in session user; `patient.creater` is stored as `null` for kiosk-registered patients - Phone input is normalised with `CommonFunctions.removeSpecialCharsInPhonenumber()` before search and save - Duplicate detection is by phone number (both `patientPhoneNumber` and `patientMobileNumber` columns are checked) - No configuration key is required — the page is always accessible --- ## Related Articles - [Patient Registration Source](https://github.com/hmislk/hmis/wiki/Patient-Registration-Source) - [Add New Patient](https://github.com/hmislk/hmis/wiki/Add-new-patient) - [Preventing Duplicate Patient Records](https://github.com/hmislk/hmis/wiki/Preventing-Duplicate-Patient-Records) - [Channelling Patient Portal](https://github.com/hmislk/hmis/wiki/Channelling-Patient-Portal)