From ccd5909fc6d85dee08300b9dbe9341ea16a496dd Mon Sep 17 00:00:00 2001 From: DevSoftTech Server Date: Wed, 30 Sep 2026 00:24:40 +0530 Subject: [PATCH] docs: remove technical URLs, database fields and developer codes from user help guide --- public/help.html | 164 +++++++++++++++++++++++------------------------ 1 file changed, 79 insertions(+), 85 deletions(-) diff --git a/public/help.html b/public/help.html index d03eb5e..0fcad7a 100644 --- a/public/help.html +++ b/public/help.html @@ -241,7 +241,7 @@
ABDM Milestone 2 (M2) HIP Certified Workflows NEW -
HIP-initiated care context linking via Method 4 Demographic Auth and Deep Link SMS (sms/notify2). Instant care context discovery for newly generated OPD visit slips from reception, dual 14-digit numeric & @sbx handle auto-resolution, and automated FHIR R4 Bundle publishing (OPConsultRecord, DiagnosticReportRecord, DischargeSummaryRecord).
+
HIP-initiated care context linking via Method 4 Demographic Auth and Deep Link SMS Notifications. Instant care context discovery for newly generated OPD visit slips from reception, dual 14-digit numeric & @sbx handle auto-resolution, and automated FHIR R4 clinical record publishing (OPConsultRecord, DiagnosticReportRecord, DischargeSummaryRecord).
@@ -250,8 +250,8 @@
- Standardized Radiology Templates for Modalities 2, 3, 4 NEW -
Complete seed of clinical reporting templates for X-Ray (Modality 3), CT-Scan (Modality 4), and MRI (Modality 2), along with dynamically synchronized service charge links in hc_items for direct billing-to-template injection.
+ Standardized Radiology Templates for Imaging Modalities NEW +
Complete seed of clinical reporting templates for Digital X-Ray, CT-Scan, and MRI, along with dynamically synchronized service charge links in the Hospital Tariff Master for direct billing-to-template injection.
@@ -349,7 +349,7 @@

03Patient Management & Registration Module

-

Sidebar Menu: Billing → Patient List (URL: /billing/patient)
+

Sidebar Menu: Billing → Patient List
Intended Users: Front Desk Receptionists, OPD Registration Staff, Admission Clerks.

This module serves as the primary master registry for all individuals receiving healthcare services at the facility. It provides comprehensive duplicate prevention, ABDM ABHA creation and verification, quick search, and direct launching of OPD, IPD, and Emergency encounters.

@@ -362,72 +362,72 @@
  • Search by Patient Full Name (supports partial matching, e.g. "Rahul").
  • Search by Aadhaar Number (12 digits) or 14-Digit ABHA ID.
  • Search by ABHA Address Handle (e.g. rahul@sbx).
    • -
  • Action: Clicking on any patient row opens their comprehensive Patient Profile (/billing/patient/person_record/:id).
    • +
  • Action: Clicking on any patient row opens their comprehensive Patient 360° Profile & Medical History.
    • -

    Screen 2: New Person Registration Form (`#nperson`)

    +

    Screen 2: New Person Registration Form

    Purpose: Register a brand-new patient into the hospital master database. All fields are explained below:

    - - + + - + - - - + + + - + - - + + - - + + - - + + - - + + - - + + - + - +
    Field NameType / RequirementForm FieldFormat / Requirement Operational Description & Clinical Purpose
    Aadhaar Number (input_udai)Aadhaar Number 12 Digits (Numeric)
    Optional    		 Government unique identity number. Used for duplicate checking across the database and mandatory for Ayushman Bharat (PM-JAY) claims and official schemes.
    ABHA ID (input_abha_id)14 Digits (Numeric)
    Auto-filled via ABHA    		Ayushman Bharat Health Account 14-digit national identifier. Prevents duplicate patient creation and links hospital files to national health ecosystem.ABHA Number / Address14 Digits or @sbx Handle
    Auto-filled via ABHA    		Ayushman Bharat Health Account national identifier. Prevents duplicate patient creation and links hospital files to national health ecosystem.
    Phone Number (input_mphone1)Primary Mobile Number 10 Digits (Numeric)
    Mandatory *    		 Primary communication mobile number. Used for SMS appointment alerts, OTP verification, billing invoice delivery, and ABDM discovery matching.
    Title & Full Name (cbo_title, input_name)Dropdown & Text
    Mandatory *    		Title & Full NameSalutation Dropdown & Text
    Mandatory *    		 Patient's legal name. Appears on all official medical records, prescriptions, diagnostic reports, and medico-legal documents.
    Gender (optionsRadios_gender)Radio (Male / Female / Other)
    Mandatory *    		GenderMale / Female / Other
    Mandatory *    		 Clinical gender. Critical for ward bed allocation, diagnostic reference range calculations (e.g. Hemoglobin), and obstetrics/gynecology workflows.
    Age / Date of Birth (datepicker_dob, input_age_year)Date or Numeric Years
    Mandatory *    		Date of Birth / AgeCalendar Date or Years
    Mandatory *    		 Toggle between exact calendar DOB or estimated Age in years/months. System auto-calculates Year of Birth (YOB) required for ABDM and pediatric dosing.
    Relation & Relative Name (cbo_relation, input_relative_name)Dropdown & Text
    Mandatory *    		Relation & Guardian / Relative NameRelation Type & Full Name
    Mandatory *    		 Caregiver / Legal Guardian (S/o, D/o, W/o, C/o, M/o). Essential for pediatric and unconscious patients, informed consent, and billing authorizations.
    Blood Group (input_blood_group)Dropdown
    Default: 'Not Define'    		Blood GroupDropdown Selection
    Default: 'Not Defined'    		 ABO & Rh group (A+, B+, O+, AB+, etc.). Vital for emergency trauma resuscitation, surgery readiness, and blood bank compatibility.
    Refer By (refer_by_name)Referred By (Doctor / Hospital / Self) Searchable Autocomplete
    Optional    		Referring physician, healthcare provider, or outreach hospital. Automatically validates against active doctor master for referral accounting.Referring physician, healthcare provider, or outreach hospital. Automatically validates against active doctor list for referral accounting.
    -

    Screen 3: ABHA Management Tab (`#abha`)

    +

    Screen 3: ABHA Management Tab

    Purpose: Seamless national Ayushman Bharat digital health identity integration directly at the registration desk:

    @@ -448,7 +448,7 @@
    -

    Screen 4: Patient Profile Hub (`person_record/:id`)

    +

    Screen 4: Patient 360° Profile Hub

    Once a patient is registered, their profile displays emergency and clinical shortcuts:

    • Appointment For OPD — Generates OPD visit slip and assigns consulting doctor.
      • @@ -473,10 +473,10 @@
    • Reception Registration: Receptionist opens patient profile and clicks Appointment For OPD.
    • Consultation Parameters: Select Department (General Medicine, Orthopedics, Cardiology, etc.), Doctor, Fee Category (Normal, Revisit, Free, Camp), and Organization/Insurance case if applicable.
    • Receipt & Token: System generates OPD Slip with unique visit token (e.g. Token #14) and care context reference OPD-{PatientId}-S{OpdId}-{Date}.
      • -
    • ABDM OPD Queue: Patients scanning the hospital facility QR code via ABHA app appear automatically in the ABDM OPD Queue (AbdmOpdQueue) with pre-filled demographics for 1-click token creation.
      • +
    • ABDM OPD Queue: Patients scanning the hospital facility QR code via ABHA app appear automatically in the ABDM OPD Queue under Front Desk with pre-filled demographics for 1-click token creation.
      • -

      Clinical Consultation Screen (`opd_prescription_basic`)

      +

      Doctor OPD Consultation & Prescription Desk

      Doctors access the consultation workspace from their daily appointment list. The screen contains dedicated clinical sections:

      • Vitals & Physical Examination: BP (Systolic/Diastolic), Pulse, SpO2, Temperature, Respiratory Rate, Height, Weight, BMI, Waist circumference, and general examination tags (Pallor, Icterus, Cyanosis, Clubbing, Edema).
        • @@ -563,7 +563,7 @@

        06Operation Theatre (OT) Management

        -

        Sidebar Menu: In-Patient & Nursing Care → OT Surgery Queue (URL: /ot/queue)

        +

        Sidebar Menu: In-Patient & Nursing Care → OT Surgery Queue

        1. Surgery Request: Treating surgeon submits surgery request specifying procedure name, operating surgeon, assistant, anaesthetist, required OT room, priority (Elective / Emergency), and requested date/time.
          2. @@ -589,23 +589,23 @@

          07Doctor's Work & Clinical Masters

          Sidebar Menu: Doctor's Work (Appointments, Rx-Group, OPD Medicine, Clinical Masters, Clinical Templates, Document Issue, Immunization)

          -

          1. Rx-Group Master (`Opd_prescription/rx_group_panel`)

          +

          1. Rx-Group Master (Prescription Protocol Sets)

          Purpose: Build reusable multi-medicine prescription sets for 1-click prescribing during busy OPD hours.

          • Create groups such as "Acute Gastroenteritis Kit", "Hypertension Starter", or "Viral Fever Pack".
          • Each group contains pre-configured dosages, frequencies, and instructions. During consultation, picking one group populates all medicines instantly.
          -

          2. Clinical Master Workspace (`Opd_prescription/clinical_master_workspace`)

          +

          2. Clinical Master Workspace (Complaints, Profiles & Advice)

          Purpose: Maintain hospital-wide clinical dictionaries:

            -
          • Chief Complaints Master: Frequently presenting symptoms mapped to SNOMED-CT concepts.
            • -
          • Investigation Master (`opd_invest_master`): Master catalog of diagnostic tests.
            • -
          • Investigation Profile Master (`opd_invest_profile_master`): Grouping individual tests into test batteries (e.g. Lipid Profile containing Total Cholesterol, Triglycerides, HDL, LDL, VLDL).
            • -
          • OPD Advice Master (`opd_advice`): Standard dietary, physical therapy, and medication precautions.
            • +
          • Chief Complaints Master: Frequently presenting symptoms mapped to standard clinical concepts.
            • +
          • Investigation Master: Master catalog of diagnostic tests and individual laboratory parameters.
            • +
          • Investigation Profile Master: Grouping individual tests into test batteries (e.g. Lipid Profile containing Total Cholesterol, Triglycerides, HDL, LDL, VLDL).
            • +
          • OPD Advice Master: Standard dietary, physical therapy, and medication precautions.
          -

          3. Doctor Document Issue (`doctor_work/document_workspace`)

          +

          3. Doctor Document & Certificate Issuance Desk

          Purpose: Issue legal and clinical certificates directly from the patient encounter:

          • Medical Leave & Fitness Certificates
            • @@ -614,7 +614,7 @@
          • Emergency Travel Medical Clearance
          -

          4. Pediatric Immunization (`Immunization`)

          +

          4. Pediatric Immunization Tracker

          Purpose: Track national vaccine schedules for infants and children:

          • Pre-configured national immunization schedule (BCG, OPV, Hepatitis B, Pentavalent, Rotavirus, Measles, MMR).
            • @@ -655,53 +655,47 @@

            09Template Design & Configuration Guide

            -

            Sidebar Menu: Admin & Settings → Template (URL: /setting/template)
            - Intended Users: Radiologists, Pathologists, Chief Medical Officers, System Administrators.

            +

            Sidebar Menu: Admin & Settings → Template
            + Intended Users: Radiologists, Pathologists, Chief Medical Officers, Hospital Administrators.

            Standardized templates ensure clinical precision, reduce reporting turnaround time by over 70%, and ensure medico-legal compliance across all imaging and diagnostic disciplines.

            -

            1. Modality Identification Table

            -

            In E-Atria HMIS, each diagnostic imaging modality corresponds to an internal system modality ID:

            +

            1. Diagnostic Modality Navigation & Scope

            +

            In E-Atria HMIS, pre-configured diagnostic report templates are organized into dedicated modality tabs under Admin & Settings → Template:

            - - - - + + + - - - + + - - - + + - - - - + + + - - - + + - - - - + + +
            Modality NameModality IDTemplate Management URLDefault Charge Mapping CategoryDiagnostic ModalityHow to Access in SystemClinical Scope & Typical Investigations
            Ultrasound (USG)1/Setting/Template/report_ultrasound_list/1Ultrasound Procedures (Abdomen, Pelvis, KUB, Obstetric)Click Admin & Settings → Template, then select the Ultrasound tab.USG Whole Abdomen, Pelvis, KUB, Obstetric / Antenatal Scans, Thyroid, Scrotum, Venous & Arterial Doppler.
            Magnetic Resonance Imaging (MRI)2/Setting/Template/report_ultrasound_list/2MRI Studies (Brain, Spine, Joints, Whole Body)Click Admin & Settings → Template, then select the MRI tab.MRI Brain (plain & contrast), Cervical/Lumbar Spine, Knee / Shoulder Joints, MRCP, Whole Body MRI.
            X-Ray (Radiography)3/Setting/Template/report_ultrasound_list/3Plain & Contrast Radiography (Chest PA, Extremities, Spine)Digital X-Ray (Radiography)Click Admin & Settings → Template, then select the X-Ray tab.Plain & Contrast Radiography: Chest PA View, KUB, Extremities (Bones & Joints), Spine AP/Lateral views, Barium studies.
            Computed Tomography (CT-Scan)4/Setting/Template/report_ultrasound_list/4CT Studies (Head, NCCT/CECT Abdomen, HRCT Chest, Angio)Click Admin & Settings → Template, then select the CT-Scan tab.NCCT Head, HRCT Thorax, CECT Abdomen & Pelvis, CT Angiography, PNS (Coronal/Axial views).
            2D Echocardiography (Echo)6/Setting/Template/report_ultrasound_list/6Cardiology 2D Echo with Doppler Studies2D Echocardiography (Echo) & SpecialClick Admin & Settings → Template, then select the Echocardiography / Special tab.Transthoracic 2D Echo, Color Doppler, Left Ventricular Ejection Fraction (LVEF), Valvular regurgitation assessment.
            @@ -709,11 +703,11 @@

            2. How to Design a New Radiology Template (Step-by-Step)

              -
            1. Open Modality Template Workspace: Go to Admin & Settings → Template and click on the desired modality tab (e.g. X-Ray, CT-Scan, or MRI).
              2. +
            2. Open Modality Template Workspace: Go to Admin & Settings → Template and click on the desired modality tab (e.g. X-Ray, CT-Scan, MRI, or Ultrasound).
            3. Click "+ Add Template": Opens the rich-text template builder.
            4. Specify Template Title: Enter a clear, standardized name (e.g. X-RAY CHEST PA VIEW - NORMAL STUDY or CT HEAD - NORMAL BRAIN STUDY).
              5. -
            5. Link Service Charge Item (`charge_id`): -
              Critical Automation Link: In the "Linked Charge / Test Item" dropdown, select the corresponding service charge from hc_items. When reception bills this service, the system will automatically inject this template into the doctor's report editor without requiring manual search!
              +
            6. Link Hospital Service / Billing Test: +
              Automatic Template Loading: In the "Linked Charge / Test Item" dropdown, select the corresponding test name from the Hospital Charges Master. When reception bills this service on an OPD or IPD slip, the system will automatically inject this template into the doctor's report editor without requiring manual search!
            7. Structure the Clinical Content: Adhere to professional NABH reporting standards by dividing the template into 4 standard sections:
              @@ -760,7 +754,7 @@ NORMAL STUDY.

              10Pharmacy & Medical Store Module

              -

              Sidebar Menu: Pharmacy → Medical Store (URL: /Medical)

              +

              Sidebar Menu: Pharmacy → Medical Store

              1. Point of Sale (POS) Dispensing

                @@ -770,7 +764,7 @@ NORMAL STUDY.
              1. Receipt & Label: Prints tax invoice with dosage frequency labels and Schedule H warnings.
              -

              2. Medicine Returns (`Medicine Return`)

              +

              2. Medicine Returns & Credit Notes

              Unopened and non-expired medications returned by patients are processed with credit notes or cash refunds. Returned stock instantly increments the active batch inventory.

              3. Pharmacy Credit Payout Workflow

              @@ -787,7 +781,7 @@ NORMAL STUDY.

              11Hospital Stock & Inventory Management

              -

              Sidebar Menu: Hospital Stock → Hospital Stock (URL: /Storestock)

              +

              Sidebar Menu: Hospital Stock → Hospital Stock

              1. Stock Indent & Issue Workflow

                @@ -818,7 +812,7 @@ NORMAL STUDY.
              1. IPD Billing: Running patient ledger tracking room rents, doctor visits, surgery fees, bedside medicines, and advance receipts. Supports interim provisional billing and final discharge invoice.
          -

          2. Shift-End Cash Statement Submission (`billing/cash-submission/create`)

          +

          2. Shift-End Cash Statement Submission

          Purpose: Guarantee 100% financial accountability at the end of every cashier's work shift.

          1. At the end of the shift, the billing cashier opens Cash Submission.
            2. @@ -885,17 +879,17 @@ NORMAL STUDY.
            • Aadhaar OTP Creation: Enter 12-digit Aadhaar → healthcare worker and beneficiary declarations are collected → OTP verified → ABHA Number & Address generated.
            • ABHA Verification: Retrieve verified demographic profile and photograph from ABDM via mobile OTP or ABHA number.
              • -
            • Facility Scan & Share: Generates hospital QR code displayed at reception. Patients scan QR via their ABHA app, populating their details directly in the ABDM OPD Queue (AbdmOpdQueue).
              • +
            • Facility Scan & Share: Generates hospital QR code displayed at reception. Patients scan QR via their ABHA app, populating their details directly in the ABDM OPD Queue for 1-click token creation.

            2. Milestone 2 (M2): Health Information Provider (HIP) Linking

            HIP-Initiated Linking (Method 4) -
            Hospital submits patient demographics to ABDM Gateway. Gateway returns a secure JWT Link Token to link hospital care contexts directly.
            +
            Hospital submits patient demographics to ABDM Gateway. Gateway returns a secure Link Token to link hospital care contexts directly.
            - Deep Link SMS (sms/notify2) + Deep Link SMS Notification
            Hospital dispatches an SMS containing a direct app link to the patient's smartphone for 1-tap care context linking in their ABHA app.
            @@ -912,7 +906,7 @@ NORMAL STUDY. Clinical Document Type FHIR Resource Type - Care Context Format + Care Context Reference Clinical Content Transferred @@ -920,19 +914,19 @@ NORMAL STUDY. OPD Consultation OPConsultRecord - OPD-{PatientId}-S{OpdId}-{YYYYMMDD} + Unique Visit Receipt Number Encounter, Vitals, Chief complaints, ICD-10 diagnosis, prescribed medicines with dosage, doctor advice. Diagnostic & Radiology DiagnosticReportRecord - RAD-{LabReqId}-{YYYYMMDD} / LAB-... + Diagnostic Lab Requisition ID Laboratory values, reference ranges, radiologist imaging findings, impression, and PDF study attachments. Discharge Summary DischargeSummaryRecord - DISCHARGE-{IpdId}-{YYYYMMDD} + Inpatient Admission Number Admission/discharge dates, clinical course, procedures performed, discharge medications, follow-up advice. @@ -940,7 +934,7 @@ NORMAL STUDY.

            4. Milestone 3 (M3): Health Information User (HIU)

            -

            Allows hospital doctors to request digital consent from arriving patients to view their previous medical history and diagnostic reports from other hospitals across India via the ABHA Patient Request List (AbdmHiu).

            +

            Allows hospital doctors to request digital consent from arriving patients to view their previous medical history and diagnostic reports from other hospitals across India via the ABHA Patient Request List (Digital Consent Management).

            Back to Top
        @@ -1011,14 +1005,14 @@ NORMAL STUDY.
      • Live real-time graphical bed census showing Occupied, Vacant, Cleaning, and Maintenance beds.
      -

      2. User Management & Permissions (`Setting/Admin/UserManagement`)

      +

      2. User Management & Access Permissions

        -
      • Create system users with individual usernames and encrypted passwords.
        • +
      • Create system users with individual usernames and secure passwords.
      • Assign users to system groups (Doctor, Reception, Nursing, Accounts, Pharmacy, Admin).
        • -
      • Grant granular individual permissions (e.g. finance.payment.edit, template.xray, billing.charges.cancel).
        • +
      • Grant granular operational privileges (e.g. Payment Adjustments, Radiology Template Setup, Bill Cancellation, Pharmacy Dispensing).
      -

      3. Charges Master (`setting/charges`)

      +

      3. Hospital Charges & Tariff Master

      • Configure hospital master rate list for consultations, investigations, surgical procedures, nursing care, and consumables.
      • Set differential pricing tiers for Private, General, and Empanelled Corporate/TPA patients.
        • @@ -1066,7 +1060,7 @@ NORMAL STUDY. Care Context Not Appearing in ABHA App Patient searched in PHR app using a mobile number different from hospital record. - Verify that the mobile number in patient_master matches the mobile registered on patient's ABHA account. + Verify that the patient's mobile number registered in hospital records matches the mobile registered on patient's ABHA account. PDF Print Preview Blank or Misaligned @@ -1085,9 +1079,9 @@ NORMAL STUDY.
        Technical Support Escalation: When reporting an unresolved issue to technical support, include:
          -
        1. The exact page URL and patient UHID (or invoice number).
          2. +
        2. The active module/screen name and patient UHID (or invoice number).
        3. Logged-in user role (never share passwords).
          4. -
        4. Screenshot of the error dialog and browser console output (F12 → Console).
          5. +
        5. Screenshot of the error dialog and message.
        Back to Top