Case Management Master Data & Configuration

Case Management Master Data & Configuration

Master Data Inventory

ID Data Set Source Approx. Records Owner Update Frequency Approver
MD-CSM-001 UM Clinical Criteria InterQual-equivalent or facility-developed criteria ~500 Medical Director (Utilization Management) Annual review; ad‑hoc for major guideline changes UM Committee
MD-CSM-002 Level-of-Care Definitions Facility-defined; aligned with DOH/DHA/MOH regulations ~8 UM Committee Chair Rarely changes (on regulatory/operational change) UM Committee + Compliance Officer
MD-CSM-003 Discharge Disposition Codes HL7 Table 0112 + UAE-specific extensions ~15 HIM Manager On regulatory or payer mapping change HIM Director
MD-CSM-004 Post-Acute Service Types Facility-defined ~20 Case Management Director Quarterly review; as services added/removed Case Management Steering Committee
MD-CSM-005 Readmission Risk Score Weights Clinical analytics / published algorithms ~10 Medical Informatics Lead Annual validation; after model recalibration Quality & Patient Safety Committee
MD-CSM-006 Case Assignment Rules Department/service line mapping ~30 Case Management Director On organisational change; at least annually Case Management Director + Nursing Administration
MD-CSM-007 Payer Review Schedules Payer contracts (Daman, Thiqa, Oman, etc.) ~50 UM Team Lead On contract change; at least annually Revenue Cycle Director
MD-CSM-008 Care Coordination Program Types Facility population health programs ~10 Case Management Director As programs evolve; at least annually Population Health Committee
MD-CSM-009 UAE Discharge Destination Facilities External facilities (rehab, SNF, home care, etc.) 50–200 Discharge Planning Lead Quarterly; on affiliation changes Case Management Director
MD-CSM-010 UM Review Types & Outcomes Internal standard list 10–30 UM Team Lead Rarely; annual review UM Committee
MD-CSM-011 Readmission Root Cause Categories Internal taxonomy aligned with quality reporting 15–30 Quality & Patient Safety Lead Annual review Quality & Patient Safety Committee

Note: Core shared entities (patients, providers, encounters, facilities, departments, payers, insurance plans, prior authorizations) are defined in their owning modules and referenced here via foreign keys only (see module brief).


Setup Sequence

Data sets must be configured in the following dependency order.

flowchart TD A["Step 1: MD-CSM-002 Level-of-Care Definitions"] --> B["Step 2: MD-CSM-010 UM Review Types & Outcomes"] B --> C["Step 3: MD-CSM-001 UM Clinical Criteria"] C --> D["Step 4: MD-CSM-007 Payer Review Schedules"] A --> E["Step 5: MD-CSM-003 Discharge Disposition Codes"] A --> F["Step 6: MD-CSM-004 Post-Acute Service Types"] F --> G["Step 7: MD-CSM-009 UAE Discharge Destination Facilities"] A --> H["Step 8: MD-CSM-006 Case Assignment Rules"] H --> I["Step 9: MD-CSM-008 Care Coordination Program Types"] A --> J["Step 10: MD-CSM-005 Readmission Risk Score Weights"] J --> K["Step 11: MD-CSM-011 Readmission Root Cause Categories"] K --> L["Step 12: Case Management Go-Live"]

Load Sequence (narrative):

  1. Level-of-Care Definitions (MD-CSM-002) — foundational for UM criteria, review types, and payer schedules.
  2. UM Review Types & Outcomes (MD-CSM-010) — standardises review events and decisions.
  3. UM Clinical Criteria (MD-CSM-001) — mapped to level-of-care and review types.
  4. Payer Review Schedules (MD-CSM-007) — references level-of-care and review types.
  5. Discharge Disposition Codes (MD-CSM-003) — required for discharge planning and billing mapping.
  6. Post-Acute Service Types (MD-CSM-004) — used in discharge plans.
  7. UAE Discharge Destination Facilities (MD-CSM-009) — linked to service types and dispositions.
  8. Case Assignment Rules (MD-CSM-006) — depends on departments/service lines (from shared entities).
  9. Care Coordination Program Types (MD-CSM-008) — used in care coordination workflows and dashboards.
  10. Readmission Risk Score Weights (MD-CSM-005) — required for automated risk scoring.
  11. Readmission Root Cause Categories (MD-CSM-011) — used in readmission review documentation.
  12. Go-Live — after validation of all above and integration with scheduling, EHR, and billing.

Master Data Specifications

MD-CSM-001: UM Clinical Criteria

Purpose

Structured representation of utilisation management clinical criteria (e.g., InterQual-equivalent or facility-developed) used to determine medical necessity and appropriate level-of-care for admission, continued stay, and discharge. Supports consistent, auditable UM decisions and payer compliance.

Schema

Table: um_clinical_criteria

Field Type Required Description
criteria_id BIGINT YES Surrogate primary key
code VARCHAR(50) YES Unique criteria code (e.g., MED-CHF-ADM-001)
display_name_en VARCHAR(255) YES English title of criteria
display_name_ar VARCHAR(255) YES Arabic title of criteria
clinical_domain VARCHAR(50) YES Domain (e.g., Medical, Surgical, Behavioral)
service_line VARCHAR(100) YES Service line (e.g., Cardiology, Pulmonology)
review_phase VARCHAR(30) YES Admission, Continued Stay, Discharge, Observation
level_of_care_code VARCHAR(30) YES FK to level_of_care.code (MD-CSM-002)
icd10am_group VARCHAR(50) NO Related ICD-10-AM DRG/diagnosis group
criteria_text TEXT YES Human-readable criteria summary
scoring_json JSON NO Structured scoring rules (thresholds, points)
is_active BOOLEAN YES Active flag
effective_from DATE YES Start date
effective_to DATE NO End date (NULL = open)
source_reference VARCHAR(255) NO External guideline reference (e.g., guideline version)
last_reviewed_by BIGINT NO FK to users.user_id (UM committee reviewer)
last_reviewed_at TIMESTAMP NO Last review datetime

Sample Data

code display_name_en display_name_ar clinical_domain service_line review_phase level_of_care_code icd10am_group is_active
MED-CHF-ADM-001 Acute decompensated heart failure – admission criteria معايير قبول فشل القلب الحاد Medical Cardiology Admission INPATIENT_ACUTE DRG-127 TRUE
MED-PNEU-CS-001 Community-acquired pneumonia – continued stay الالتهاب الرئوي المكتسب من المجتمع – استمرار الإقامة Medical Pulmonology Continued Stay INPATIENT_ACUTE DRG-089 TRUE
SUR-POSTOP-OBS-001 Post-operative monitoring – observation المراقبة بعد الجراحة – ملاحظة Surgical General Surgery Admission OBSERVATION DRG-331 TRUE
MED-COPD-ADM-001 COPD exacerbation – admission criteria تفاقم مرض الانسداد الرئوي المزمن – معايير القبول Medical Pulmonology Admission INPATIENT_ACUTE DRG-190 TRUE
MED-UTI-DCH-001 Uncomplicated UTI – discharge readiness التهاب المسالك البولية غير المعقد – جاهزية الخروج Medical General Medicine Discharge INPATIENT_ACUTE DRG-320 TRUE

Data Governance

  • Owner: Medical Director (Utilization Management)
  • Approval process: 1. Draft/updated criteria prepared by UM team or clinical specialty lead. 2. Reviewed by UM Committee (including Physician Advisor, Case Management Director). 3. Legal/compliance review for payer and MOH/DOH/DHA alignment if needed. 4. Approved version recorded; IT updates master data in test then production.
  • Update frequency: Annual formal review; ad-hoc updates when major guidelines or payer requirements change.
  • Change notification:
  • Release notes to case managers, UM nurses, physician advisors.
  • In-system banner for changed criteria for 2–4 weeks.
  • Training sessions for high-impact changes.

Validation Rules

  • code must be unique and non-null.
  • display_name_en and display_name_ar required and <= 255 chars.
  • review_phase limited to controlled list: Admission, Continued Stay, Discharge, Observation, Retrospective.
  • level_of_care_code must exist in level_of_care (MD-CSM-002).
  • effective_to must be NULL or > effective_from.
  • Only one active criteria record per (code) at any time.
  • is_active = TRUE only if current date between effective_from and effective_to (or effective_to NULL).

MD-CSM-002: Level-of-Care Definitions

Purpose

Defines standard levels of care used across UM, billing, and reporting (e.g., inpatient acute, observation, day surgery, home health). Ensures consistent classification aligned with UAE regulatory and payer expectations.

Schema

Table: level_of_care

Field Type Required Description
code VARCHAR(30) YES Unique level-of-care code (PK)
display_name_en VARCHAR(200) YES English name
display_name_ar VARCHAR(200) YES Arabic name
description VARCHAR(500) NO Detailed description
inpatient_flag BOOLEAN YES TRUE if considered inpatient for billing
emergency_flag BOOLEAN YES TRUE if ED-based
moh_reporting_code VARCHAR(20) NO Code used for MOH/DOH/DHA reporting if applicable
default_length_of_stay_days DECIMAL(5,2) NO Typical LOS benchmark
is_active BOOLEAN YES Active flag
sort_order INT NO For UI ordering

Sample Data

code display_name_en display_name_ar inpatient_flag emergency_flag default_length_of_stay_days
INPATIENT_ACUTE Inpatient – Acute تنويم – حاد TRUE FALSE 4.50
INPATIENT_REHAB Inpatient – Rehabilitation تنويم – تأهيلي TRUE FALSE 14.00
OBSERVATION Observation ملاحظة FALSE TRUE 1.00
DAY_SURGERY Day Surgery جراحة اليوم الواحد FALSE FALSE 0.50
HOME_HEALTH Home Health رعاية صحية منزلية FALSE FALSE 0.00
SKILLED_NURSING Skilled Nursing / Long-Term Care رعاية تمريضية ماهرة / رعاية طويلة الأمد TRUE FALSE 20.00
OUTPATIENT Outpatient عيادات خارجية FALSE FALSE 0.00
PALLIATIVE_INPATIENT Inpatient – Palliative تنويم – رعاية تلطيفية TRUE FALSE 7.00

Data Governance

  • Owner: UM Committee Chair
  • Approval process:
  • Proposed changes initiated by UM Committee or Revenue Cycle.
  • Reviewed by Compliance Officer for DOH/DHA/MOH alignment.
  • Approved by UM Committee and Revenue Cycle Director.
  • Update frequency: Rare; only when regulatory or operational model changes.
  • Change notification:
  • Communicated to UM, billing, coding, and bed management teams.
  • Mapping updates coordinated with billing and claims (eClaimLink, DOH eClaims).

Validation Rules

  • code unique and immutable once used in production.
  • display_name_en and display_name_ar required.
  • At least one level with inpatient_flag = TRUE.
  • default_length_of_stay_days ≥ 0.
  • Cannot deactivate (is_active = FALSE) if referenced by active UM criteria or payer review schedules without migration plan.

MD-CSM-003: Discharge Disposition Codes

Purpose

Standardised discharge disposition codes used for clinical documentation, billing, and regulatory reporting. Based on HL7 Table 0112 with UAE-specific extensions (e.g., discharge to home in UAE, transfer to facility in specific emirate).

Schema

Table: discharge_disposition_codes

Field Type Required Description
code VARCHAR(10) YES Disposition code (PK)
display_name_en VARCHAR(200) YES English description
display_name_ar VARCHAR(200) YES Arabic description
hl7_0112_code VARCHAR(10) NO Original HL7 0112 code if mapped
moh_reporting_code VARCHAR(10) NO MOH/DOH/DHA reporting code
is_death BOOLEAN YES TRUE if represents death
is_transfer BOOLEAN YES TRUE if transfer to another facility
is_home BOOLEAN YES TRUE if discharge to home/self-care
requires_destination_facility BOOLEAN YES TRUE if destination facility must be specified
is_active BOOLEAN YES Active flag
sort_order INT NO UI ordering

Sample Data

code display_name_en display_name_ar hl7_0112_code is_home is_transfer is_death requires_destination_facility
HOME_UAE Discharged to home (within UAE) خروج إلى المنزل (داخل دولة الإمارات) 01 TRUE FALSE FALSE FALSE
HOME_ABROAD Discharged to home (outside UAE) خروج إلى المنزل (خارج دولة الإمارات) 01 TRUE FALSE FALSE FALSE
TRANSFER_ACUTE Transfer to acute care hospital تحويل إلى مستشفى رعاية حادة 02 FALSE TRUE FALSE TRUE
TRANSFER_REHAB Transfer to rehabilitation facility تحويل إلى مركز تأهيل 62 FALSE TRUE FALSE TRUE
TRANSFER_LTC Transfer to long-term care / skilled nursing تحويل إلى رعاية طويلة الأمد / تمريضية 63 FALSE TRUE FALSE TRUE
AMA Left against medical advice خروج ضد النصح الطبي 07 FALSE FALSE FALSE FALSE
EXPIRED Patient expired in facility وفاة المريض في المنشأة 20 FALSE FALSE TRUE FALSE
HOSPICE Discharged to hospice / palliative care خروج إلى رعاية تلطيفية 50 FALSE TRUE FALSE TRUE
OTHER Other / unknown أخرى / غير معروفة 99 FALSE FALSE FALSE FALSE

Data Governance

  • Owner: HIM Manager
  • Approval process:
  • New codes or changes proposed by HIM or Case Management.
  • Reviewed for impact on coding, billing, and DOH/DHA/MOH reporting.
  • Approved by HIM Director and Revenue Cycle Director.
  • Update frequency: Infrequent; when HL7 or UAE reporting requirements change.
  • Change notification:
  • Communicated to physicians, case managers, coders.
  • Updated mapping for billing and analytics.

Validation Rules

  • code unique and non-null.
  • Only one of is_home, is_transfer, is_death should be TRUE per code.
  • If requires_destination_facility = TRUE, system must enforce selection of destination facility (MD-CSM-009) in discharge workflow.
  • EXPIRED must have is_death = TRUE.
  • Cannot deactivate codes used in last 12 months without mapping to replacement.

MD-CSM-004: Post-Acute Service Types

Purpose

Defines categories of post-acute services used in discharge planning and care coordination (e.g., home health, rehab, DME). Drives discharge plan structure, referrals, and reporting.

Schema

Table: post_acute_service_types

Field Type Required Description
code VARCHAR(30) YES Unique service type code (PK)
display_name_en VARCHAR(200) YES English name
display_name_ar VARCHAR(200) YES Arabic name
description VARCHAR(500) NO Detailed description
requires_external_provider BOOLEAN YES TRUE if requires external facility/provider
typical_duration_days INT NO Typical service duration
is_home_based BOOLEAN YES TRUE if delivered at patient home
is_active BOOLEAN YES Active flag
sort_order INT NO UI ordering

Sample Data

code display_name_en display_name_ar requires_external_provider is_home_based typical_duration_days
HOME_HEALTH_NURSING Home health nursing تمريض رعاية منزلية TRUE TRUE 14
HOME_PHYSIOTHERAPY Home physiotherapy علاج طبيعي منزلي TRUE TRUE 10
REHAB_INPATIENT Inpatient rehabilitation تأهيل تنويمي TRUE FALSE 21
DME Durable medical equipment أجهزة طبية مساعدة TRUE TRUE 90
PALLIATIVE_HOME Home palliative care رعاية تلطيفية منزلية TRUE TRUE 30
OUTPATIENT_PHYSIO Outpatient physiotherapy علاج طبيعي خارجي TRUE FALSE 10
SOCIAL_SUPPORT Social support / community services دعم اجتماعي / خدمات مجتمعية TRUE TRUE 30
HOME_CAREGIVER Private caregiver / sitter مقدم رعاية خاص TRUE TRUE 30

Data Governance

  • Owner: Case Management Director
  • Approval process:
  • New service types proposed by Discharge Planning or Care Coordination.
  • Reviewed for contractual arrangements and payer coverage implications.
  • Approved by Case Management Director and Revenue Cycle Director if billing impact.
  • Update frequency: Quarterly review; ad-hoc when new programs/services added.
  • Change notification:
  • Communicated to discharge planners, social workers, and care coordinators.
  • Updated in discharge planning templates.

Validation Rules

  • code unique and non-null.
  • requires_external_provider TRUE for services requiring a specific provider/facility.
  • typical_duration_days ≥ 0 if provided.
  • Cannot deactivate if referenced by active discharge plans without migration.

MD-CSM-005: Readmission Risk Score Weights

Purpose

Stores configuration for readmission risk scoring algorithms (e.g., LACE index or facility-specific model). Used in WF-CSM-005 to calculate risk scores and levels.

Schema

Table: readmission_risk_weights

Field Type Required Description
weight_id BIGINT YES Surrogate primary key
model_code VARCHAR(50) YES Model identifier (e.g., LACE, FACILITY_V1)
factor_code VARCHAR(50) YES Factor identifier (e.g., LOS, ED_VISITS_6M)
display_name_en VARCHAR(200) YES English factor label
display_name_ar VARCHAR(200) YES Arabic factor label
weight_value DECIMAL(10,4) YES Weight or points assigned
min_value DECIMAL(10,2) NO Minimum applicable value (if numeric factor)
max_value DECIMAL(10,2) NO Maximum applicable value
risk_level_threshold VARCHAR(20) NO Low, Medium, High if this row defines threshold
is_active BOOLEAN YES Active flag
effective_from DATE YES Start date
effective_to DATE NO End date

Sample Data

Example for a simplified LACE-like model:

model_code factor_code display_name_en display_name_ar weight_value min_value max_value risk_level_threshold
LACE LOS_1_3 Length of stay 1–3 days مدة الإقامة ١–٣ أيام 1.0 1 3 NULL
LACE LOS_4_6 Length of stay 4–6 days مدة الإقامة ٤–٦ أيام 2.0 4 6 NULL
LACE ED_2PLUS ≥2 ED visits in last 6 months زيارتان أو أكثر للطوارئ خلال ٦ أشهر 3.0 2 99 NULL
LACE COMORBID_3PLUS ≥3 chronic conditions ثلاث حالات مزمنة أو أكثر 2.5 3 99 NULL
LACE RISK_LOW Total score < 7 مجموع النقاط أقل من ٧ 0.0 0 6.99 Low
LACE RISK_MEDIUM Total score 7–11 مجموع النقاط ٧–١١ 0.0 7 11 Medium
LACE RISK_HIGH Total score ≥ 12 مجموع النقاط ١٢ أو أكثر 0.0 12 99 High

Data Governance

  • Owner: Medical Informatics Lead
  • Approval process:
  • Model design/recalibration by analytics team.
  • Validation on historical UAE facility data (e.g., readmission outcomes).
  • Approval by Quality & Patient Safety Committee and Medical Director.
  • Update frequency: Annual or when performance review indicates need.
  • Change notification:
  • Communicated to case managers, care coordinators, and physicians.
  • Updated documentation on how scores should influence interventions.

Validation Rules

  • Combination (model_code, factor_code, effective_from) must be unique.
  • effective_to > effective_from when not NULL.
  • Risk thresholds (risk_level_threshold not NULL) must cover full score range without overlap for each model.
  • Only one active version of a model at a time.

MD-CSM-006: Case Assignment Rules

Purpose

Defines rules for automatic assignment of cases to case managers/UM nurses based on department, service line, payer, and workload. Used in WF-CSM-001 for automated case assignment.

Schema

Table: case_assignment_rules

Field Type Required Description
rule_id BIGINT YES Surrogate primary key
code VARCHAR(50) YES Rule code (e.g., MED-SURG-DXB-01)
display_name_en VARCHAR(200) YES English description
display_name_ar VARCHAR(200) YES Arabic description
department_id BIGINT NO FK to departments.department_id (nullable for cross-department rules)
service_line VARCHAR(100) NO Service line (e.g., Cardiology)
payer_id BIGINT NO FK to payers.payer_id (for payer-specific assignment)
emirate VARCHAR(50) NO Dubai, Abu Dhabi, Sharjah, etc.
case_manager_id BIGINT YES FK to users.user_id (case manager)
max_caseload INT YES Maximum concurrent cases for this rule/case manager
priority INT YES Rule priority (1 = highest)
is_active BOOLEAN YES Active flag

Sample Data

code display_name_en display_name_ar department_id service_line payer_id emirate case_manager_id max_caseload priority
MED-SURG-DXB-01 Dubai Medical/Surgical – general payers دبي باطني/جراحة – جميع شركات التأمين 101 General Medicine NULL Dubai 2001 25 2
CARD-ABU-THIQA Abu Dhabi Cardiology – Thiqa أبوظبي قلب – ثقة 205 Cardiology 301 Abu Dhabi 2002 20 1
ICU-DXB-ALL Dubai ICU – all payers دبي عناية مركزة – جميع شركات التأمين 110 ICU NULL Dubai 2003 15 1
PED-DXB-DAMAN Dubai Pediatrics – Daman دبي أطفال – ضمان 130 Pediatrics 302 Dubai 2004 22 1
SUR-ABU-ALL Abu Dhabi Surgery – all payers أبوظبي جراحة – جميع شركات التأمين 210 General Surgery NULL Abu Dhabi 2005 25 3

(IDs are illustrative; actual IDs come from shared entity tables.)

Data Governance

  • Owner: Case Management Director
  • Approval process:
  • Proposed changes from Case Management leadership or Nursing Administration.
  • Reviewed for workload balance and coverage.
  • Approved by Case Management Director.
  • Update frequency: On staffing or organisational changes; at least annually.
  • Change notification:
  • Communicated to case management team and bed management.
  • Changes scheduled outside peak hours to avoid assignment instability.

Validation Rules

  • code unique.
  • max_caseload > 0.
  • For active rules, case_manager_id must reference an active user with appropriate role.
  • Rule evaluation engine must apply highest priority (lowest numeric value) first; ties broken by more specific criteria (payer > department > service_line).
  • System must prevent configuration that would leave a department/emirate with no active rule.

MD-CSM-007: Payer Review Schedules

Purpose

Defines payer-specific UM requirements: review frequency, initial authorization windows, and communication channels. Used in WF-CSM-001, WF-CSM-002, and WF-CSM-006.

Schema

Table: payer_review_schedules

Field Type Required Description
schedule_id BIGINT YES Surrogate primary key
payer_id BIGINT YES FK to payers.payer_id
insurance_plan_id BIGINT NO FK to insurance_plans.plan_id (nullable for payer-wide rules)
level_of_care_code VARCHAR(30) YES FK to level_of_care.code
review_type VARCHAR(30) YES Admission, Continued Stay, Retrospective
initial_review_hours INT NO Hours from admission to first review (e.g., 24, 48)
subsequent_review_days INT NO Days between continued stay reviews
max_days_without_auth INT NO Maximum days allowed without renewed authorization
communication_channel VARCHAR(50) YES Portal, Phone, Fax, eClaimLink, DOH_eClaims
notes VARCHAR(500) NO Free-text notes
is_active BOOLEAN YES Active flag
effective_from DATE YES Start date
effective_to DATE NO End date

Sample Data

Assume payer IDs: Daman=302, Thiqa=303, Oman=304.

payer_id insurance_plan_id level_of_care_code review_type initial_review_hours subsequent_review_days max_days_without_auth communication_channel
302 NULL INPATIENT_ACUTE Admission 24 NULL 2 eClaimLink
302 NULL INPATIENT_ACUTE Continued Stay NULL 3 1 eClaimLink
303 NULL INPATIENT_ACUTE Admission 48 NULL 3 DOH_eClaims
303 NULL INPATIENT_ACUTE Continued Stay NULL 4 2 DOH_eClaims
304 NULL INPATIENT_ACUTE Admission 24 NULL 1 Portal
304 NULL OBSERVATION Admission 12 NULL 1 Portal
304 NULL INPATIENT_ACUTE Continued Stay NULL 2 1 Portal

Data Governance

  • Owner: UM Team Lead
  • Approval process:
  • Data sourced from signed payer contracts and UM manuals.
  • Reviewed by Contract Management and Revenue Cycle.
  • Approved by Revenue Cycle Director.
  • Update frequency: On contract renewal or payer policy change.
  • Change notification:
  • Communicated to UM team and Patient Access (Prior Auth).
  • System alerts for changed schedules for active cases.

Validation Rules

  • For each active combination (payer_id, level_of_care_code, review_type), only one schedule may be active at a time.
  • effective_to > effective_from when not NULL.
  • initial_review_hours, subsequent_review_days, max_days_without_auth must be ≥ 0 if provided.
  • communication_channel limited to controlled list.

MD-CSM-008: Care Coordination Program Types

Purpose

Defines types of care coordination programs (e.g., heart failure clinic, diabetes management, high-risk readmission program) used in WF-CSM-004 and readmission prevention workflows.

Schema

Table: care_coordination_program_types

Field Type Required Description
code VARCHAR(50) YES Program code (PK)
display_name_en VARCHAR(200) YES English name
display_name_ar VARCHAR(200) YES Arabic name
description VARCHAR(500) NO Program description and inclusion criteria
target_population VARCHAR(200) NO e.g., HF, COPD, Diabetes, High-risk readmission
min_risk_level VARCHAR(20) NO Minimum risk level (Low, Medium, High)
auto_enroll_flag BOOLEAN YES TRUE if system auto-enrols based on rules
is_active BOOLEAN YES Active flag
owning_department_id BIGINT NO FK to departments.department_id

Sample Data

code display_name_en display_name_ar target_population min_risk_level auto_enroll_flag
HF_HIGH_RISK Heart failure high-risk program برنامج فشل القلب عالي الخطورة HF High TRUE
COPD_MANAGEMENT COPD management program برنامج إدارة مرض الانسداد الرئوي المزمن COPD Medium TRUE
DM_EDUCATION Diabetes education program برنامج تثقيف مرضى السكري Diabetes Low FALSE
POLYCHRONIC Multi-morbidity care coordination تنسيق رعاية الأمراض المزمنة المتعددة Multi-morbid Medium TRUE
POST_ACUTE_30D 30-day post-discharge follow-up متابعة ما بعد الخروج لمدة ٣٠ يوماً All Medium TRUE

Data Governance

  • Owner: Case Management Director
  • Approval process:
  • New programs proposed by Population Health or Quality.
  • Reviewed for resource availability and KPIs.
  • Approved by Population Health Committee.
  • Update frequency: As programs evolve; at least annual review.
  • Change notification:
  • Communicated to care coordinators and relevant clinical teams.
  • Patient portal content updated for patient-facing programs.

Validation Rules

  • code unique.
  • min_risk_level limited to Low, Medium, High or NULL.
  • If auto_enroll_flag = TRUE, program must have clear inclusion rules configured in care coordination engine (outside this table).

MD-CSM-009: UAE Discharge Destination Facilities

Purpose

Directory of external facilities and providers used as discharge destinations (rehab centres, long-term care, home care agencies, etc.) within UAE and abroad. Supports WF-CSM-003 and mapping to discharge dispositions.

Schema

Table: discharge_destination_facilities

Field Type Required Description
destination_id BIGINT YES Surrogate primary key
code VARCHAR(50) YES Internal code
display_name_en VARCHAR(200) YES English facility name
display_name_ar VARCHAR(200) YES Arabic facility name
emirate VARCHAR(50) NO Dubai, Abu Dhabi, Sharjah, etc.
country VARCHAR(100) YES Country (e.g., United Arab Emirates)
service_type_code VARCHAR(30) YES FK to post_acute_service_types.code
moh_facility_id VARCHAR(50) NO MOH/DOH/DHA facility ID if applicable
phone_number VARCHAR(30) NO Contact phone
contact_email VARCHAR(200) NO Contact email
address_line VARCHAR(255) NO Address / PO Box
is_active BOOLEAN YES Active flag

Sample Data

code display_name_en display_name_ar emirate country service_type_code phone_number address_line
REHAB_DXB_RASHID Rashid Hospital Rehab Unit وحدة التأهيل بمستشفى راشد Dubai United Arab Emirates REHAB_INPATIENT +971 4 219 2000 PO Box 4545, Dubai
LTC_AD_MAFRAQ Mafraq Long-Term Care Center مركز المفرق للرعاية طويلة الأمد Abu Dhabi United Arab Emirates SKILLED_NURSING +971 2 501 1111 PO Box 2951, Abu Dhabi
HH_DXB_SEHAHOME SEHA Home Care Dubai رعاية صحة المنزل – صحة دبي Dubai United Arab Emirates HOME_HEALTH_NURSING +971 4 555 1234 PO Box 12345, Dubai
REHAB_AD_SHEIKHKHALIFA Sheikh Khalifa Medical City Rehab تأهيل مدينة الشيخ خليفة الطبية Abu Dhabi United Arab Emirates REHAB_INPATIENT +971 2 819 0000 PO Box 51900, Abu Dhabi
DME_DXB_VENDOR1 Dubai Medical Equipment Supplier مورد الأجهزة الطبية بدبي Dubai United Arab Emirates DME +971 4 333 7788 PO Box 6789, Dubai

Data Governance

  • Owner: Discharge Planning Lead
  • Approval process:
  • New facilities added upon credentialing/contracting.
  • Verified against DOH/DHA/MOH licensing where applicable.
  • Approved by Case Management Director and Contracting team.
  • Update frequency: Quarterly review; ad-hoc for contract changes.
  • Change notification:
  • Communicated to discharge planners and social workers.
  • Inactive facilities flagged in UI and removed from selection lists.

Validation Rules

  • code unique.
  • service_type_code must exist in post_acute_service_types.
  • If country = 'United Arab Emirates', emirate should be one of configured emirates.
  • Cannot deactivate if referenced by future-dated discharge plans without reassignment.

MD-CSM-010: UM Review Types & Outcomes

Purpose

Standardises UM review types and possible outcomes for documentation and analytics (e.g., admission review, continued stay review, outcomes like approved, denied, downgraded).

Schema

Table: um_review_types

Field Type Required Description
code VARCHAR(30) YES Review type code (PK)
display_name_en VARCHAR(200) YES English name
display_name_ar VARCHAR(200) YES Arabic name
description VARCHAR(500) NO Description
is_active BOOLEAN YES Active flag
sort_order INT NO UI ordering

Table: um_review_outcomes

Field Type Required Description
code VARCHAR(30) YES Outcome code (PK)
display_name_en VARCHAR(200) YES English name
display_name_ar VARCHAR(200) YES Arabic name
description VARCHAR(500) NO Description
is_final BOOLEAN YES TRUE if final decision (e.g., Denied)
is_active BOOLEAN YES Active flag
sort_order INT NO UI ordering

Sample Data

Review Types

code display_name_en display_name_ar
ADMISSION Admission review مراجعة القبول
CONTINUED_STAY Continued stay review مراجعة استمرار الإقامة
DISCHARGE Discharge review مراجعة الخروج
RETROSPECTIVE Retrospective review مراجعة بأثر رجعي
LEVEL_OF_CARE_CHANGE Level-of-care change review مراجعة تغيير مستوى الرعاية

Outcomes

code display_name_en display_name_ar is_final
APPROVED Approved as requested تمت الموافقة كما طُلب TRUE
APPROVED_REDUCED_DAYS Approved with reduced days تمت الموافقة مع تقليل الأيام TRUE
DENIED Denied مرفوض TRUE
PENDED_INFO Pending – additional information required معلق – معلومات إضافية مطلوبة FALSE
DOWNGRADE_OBS Downgraded to observation تخفيض إلى ملاحظة TRUE
DOWNGRADE_OUTPATIENT Downgraded to outpatient تخفيض إلى عيادات خارجية TRUE
PEER_REVIEW_REQUIRED Peer-to-peer review required مطلوب مراجعة بين الأطباء FALSE

Data Governance

  • Owner: UM Team Lead
  • Approval process:
  • Changes proposed by UM Committee.
  • Reviewed for alignment with payer terminology and reporting.
  • Approved by UM Committee Chair.
  • Update frequency: Rare; annual review.
  • Change notification:
  • Communicated to UM staff.
  • Mapping updates in reports and dashboards.

Validation Rules

  • code unique.
  • At least one final outcome (is_final = TRUE) must exist.
  • Outcomes used in continued stay authorizations must remain stable; deprecation requires mapping.

MD-CSM-011: Readmission Root Cause Categories

Purpose

Taxonomy for documenting root causes of 30-day readmissions, used in WF-CSM-005 and quality improvement analytics.

Schema

Table: readmission_root_cause_categories

Field Type Required Description
code VARCHAR(50) YES Root cause code (PK)
display_name_en VARCHAR(200) YES English label
display_name_ar VARCHAR(200) YES Arabic label
category_group VARCHAR(100) NO Grouping (e.g., Clinical, Social, System)
description VARCHAR(500) NO Description and examples
is_preventable BOOLEAN YES TRUE if generally preventable
is_active BOOLEAN YES Active flag
sort_order INT NO UI ordering

Sample Data

code display_name_en display_name_ar category_group is_preventable
CLINICAL_DISEASE_PROGRESS Disease progression تطور المرض Clinical FALSE
CLINICAL_INADEQUATE_TREATMENT Inadequate treatment plan خطة علاج غير كافية Clinical TRUE
SOCIAL_NON_ADHERENCE Medication / follow-up non-adherence عدم الالتزام بالأدوية / المواعيد Social TRUE
SOCIAL_LACK_SUPPORT Lack of caregiver / social support نقص الدعم الأسري / الاجتماعي Social TRUE
SYSTEM_EARLY_DISCHARGE Premature discharge خروج مبكر System TRUE
SYSTEM_FOLLOWUP_ACCESS Limited access to follow-up care صعوبة الوصول إلى الرعاية اللاحقة System TRUE
OTHER_UNRELATED Unrelated new condition حالة جديدة غير مرتبطة Clinical FALSE

Data Governance

  • Owner: Quality & Patient Safety Lead
  • Approval process:
  • Categories proposed by Quality team based on RCA findings.
  • Reviewed by multidisciplinary quality committee.
  • Approved by Quality & Patient Safety Committee.
  • Update frequency: Annual; ad-hoc when new patterns identified.
  • Change notification:
  • Communicated to case managers and quality reviewers.
  • Historical data mapping considered before deactivating codes.

Validation Rules

  • code unique.
  • is_preventable must be explicitly set.
  • Cannot deactivate categories used in active quality improvement projects without replacement mapping.

Configuration Parameters

Parameter Type Default Description Governance
max_results_per_search Integer 50 Maximum records returned in worklist or search queries (e.g., case worklist) System Administrator
um_review_alert_window_hours Integer 24 Hours before scheduled review when alerts start for WF-CSM-002 UM Team Lead
default_initial_review_hours Integer 24 Default hours from admission to first UM review when payer schedule not defined UM Committee
high_risk_readmission_threshold Integer 12 Minimum risk score to classify as high risk (used with MD-CSM-005) Medical Informatics Lead
medium_risk_readmission_threshold Integer 7 Minimum risk score to classify as medium risk Medical Informatics Lead
discharge_plan_required_los_days Integer 2 LOS threshold after which discharge plan becomes mandatory Case Management Director
auto_assign_case_on_adt Boolean true Whether cases are auto-created and assigned on ADT A01 events Case Management Director
max_cases_per_case_manager Integer 20 Soft cap for concurrent active cases per case manager (used in WF-CSM-001) Case Management Director
payer_auth_expiry_alert_days Integer 2 Days before authorization expiry to trigger alerts in WF-CSM-006 UM Team Lead
enable_patient_portal_discharge_plan Boolean true Whether discharge plan summary is exposed via Patient Portal (INT-CSM-006) Privacy Officer (PDPL) + Case Management Director
anonymize_data_for_analytics Boolean true Whether case management analytics use de-identified data where possible (PDPL compliance) Data Protection Officer

Data Load Procedures

1. Initial Load

Sources

  • UM criteria and level-of-care: Excel/CSV from UM vendor or internal guidelines.
  • Discharge dispositions: HL7 0112 reference + UAE-specific mapping from HIM.
  • Post-acute service types and destination facilities: Contracting and Case Management spreadsheets.
  • Payer review schedules: Contract abstracts from Policy & Contract Management.
  • Readmission risk weights: Analytics model specification.
  • Case assignment rules: Case Management staffing plan.
  • Care coordination program types: Population Health documentation.
  • Root cause categories: Quality & Patient Safety taxonomy.

Process

  1. Data extraction & standardisation - Convert all sources to UTF-8 CSV with bilingual columns (display_name_en, display_name_ar). - Ensure codes follow agreed naming conventions (no spaces, uppercase, underscore-separated).

  2. Staging import - Load into staging tables (e.g., stg_um_clinical_criteria) via ETL or bulk import. - Validate mandatory fields and referential integrity (e.g., level_of_care_code exists).

  3. Data validation - Run validation scripts:

    • Uniqueness of codes.
    • Date ranges (effective_from/effective_to).
    • Cross-reference checks (e.g., payer IDs, department IDs).
    • Generate exception reports for records failing validation.
  4. Business review - UM Committee, HIM, Case Management, and Quality teams review sample records and summary counts. - Sign-off captured for audit (per UAE PDPL accountability).

  5. Promotion to production - Move validated records from staging to production tables. - Enable configuration flags (e.g., is_active) only after sign-off.

2. Ongoing Synchronisation

  • UM Clinical Criteria:
  • When using an external UM vendor, schedule periodic JSON/CSV imports via internal API.
  • Versioning handled via effective_from/effective_to.
  • Payer Review Schedules:
  • Triggered by contract updates in Policy & Contract Management (INT-CSM-005).
  • API-based updates with change logs.
  • Destination Facilities:
  • Quarterly reconciliation with Contract Management and facility licensing data (DOH/DHA/MOH).
  • Readmission Risk Weights:
  • Updated after model recalibration; changes deployed via controlled release process.

3. Import/Export Formats

  • Import:
  • Preferred: CSV over secure SFTP or internal API (JSON).
  • Required columns documented per table schema.
  • Date format: YYYY-MM-DD.
  • Boolean: TRUE/FALSE.

  • Export:

  • CSV and JSON exports for:
    • Analytics (e.g., readmission programs).
    • External audits (payer, regulator).
  • Exports must respect UAE PDPL:
    • Use pseudonymised identifiers where possible.
    • Exclude direct patient identifiers from master data exports.

4. Validation on Import

For each import job:

  1. Syntactic validation - Check file encoding (UTF-8). - Validate headers and required columns. - Validate data types (numeric, dates, booleans).

  2. Semantic validation - Referential integrity (e.g., payer_id exists). - Code uniqueness and immutability rules. - Business rules (e.g., review schedules not overlapping).

  3. Regulatory & privacy checks - Ensure no patient-level data is present in master data imports. - Log all imports with user, timestamp, and record counts for audit (PDPL accountability).

  4. Error handling - Reject file if > X% of rows invalid (configurable, default 5%). - Provide detailed error report (row number, field, error message). - Support partial load with clear logging when appropriate (for non-critical datasets).


This specification provides the master data and configuration foundation for the Case Management module, enabling developers to implement database schemas, admin UIs, and integration points consistent with UAE regulatory and operational requirements.

content/rcm/case-management/06-master-data.md Generated 2026-02-20 22:54