Healthcare AI Copilot & Clinical Decision Support

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Healthcare AI Copilot & Clinical Decision Support within SmartERP.

Leverage embedded AI to assist physicians with ICD-10 coding suggestions, clinical documentation summaries, and drug interaction alerts.

{screenshot:healthcare-ai-copilot-overview-dashboard}

2. Prerequisites & Security Access Groups#

• Required Modules: smarterp_healthcare, smarterp_clinical_core, smarterp_pharmacy
• Security Groups:
  • Healthcare Receptionist (Technical ID: smarterp_healthcare.group_medical_receptionist)
  • Physician / Attending Doctor (Technical ID: smarterp_healthcare.group_medical_doctor)
  • Pharmacy Dispenser (Technical ID: smarterp_healthcare.group_medical_pharmacist)
• Master Data Dependencies: Patient master registry (Medical Record Number - MRN), EFDA drug formulary, Ethiopian Ministry of Health (MoH) HMIS disease codes, and EHIS insurance tariffs.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Module Interface#

1. Log into your SmartERP instance at https://smarterp.et/odoo.
2. Open the main App Switcher (grid icon in the top-left corner).
3. Select the Healthcare app icon.
4. From the top navigation bar, open Healthcare → Clinical Dashboard → OPD Triage / Inpatient ADT / EMR / Pharmacy Dispensing.

{screenshot:healthcare-ai-copilot-app-switcher-navigation}

Step 2: Creating and Parameterizing Records#

1. Click the New button in the top-left control panel.
2. Complete the mandatory fields in the record form:
   • Medical Record Number (MRN) (Mandatory): Unique national health identifier or generated hospital record code
   • Patient Demographics (Mandatory): Full legal name, gender, date of birth, and Kebele residential location
   • Encounter Type (Mandatory): Outpatient (OPD), Inpatient (IPD), Emergency, or Triage consultation
   • Attending Physician (Mandatory): Licensed healthcare practitioner responsible for clinical encounter
3. Configure optional operational parameters and localized tags as required:
   • Insurance Provider & Policy (Optional): EHIS CBHI/SHI policy or corporate credit contract
   • Triage Vital Signs (Optional): Blood pressure, pulse rate, respiratory rate, temperature, and SpO2
   • ICD-11 / HMIS Diagnosis Code (Optional): Standardized diagnosis category for statutory health reporting
4. Click the Save icon in the control bar to commit the record.

{screenshot:healthcare-ai-copilot-record-creation-form}

Step 3: Validating and Processing Transactions#

• State Transitions: Execute operational state progression (Reception / Triage → Consultation → Lab / Radiology → Prescription → Billing / Discharge).
• Ledger & System Impact: Patient billing registers medical service revenue, debits patient or insurance accounts receivable, and debits pharmaceutical inventory upon prescription dispensing.
• Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:healthcare-ai-copilot-transaction-processing-state}

AI Clinical Copilot Capabilities#

The SmartERP Healthcare AI Copilot acts as an augmented clinical intelligence assistant, embedded directly within the physician encounter screen and diagnostic workstations. Operating on privacy-preserving, local enterprise LLM inference, patient identifiable data never exits the secure hospital network.

Voice-to-Text & Clinical Note Summarization#

1. During patient consultation, click the Voice Dictation microphone icon on the SOAP note canvas.
2. The physician dictates clinical findings in English or Amharic (e.g., "Patient presents with acute epigastric burning pain radiating to the back for 4 days, exacerbated by fatty meals. Positive Murphy sign on deep palpation.").
3. The AI Copilot:
   • Transcribes spoken audio with specialized medical terminology recognition.
   • Structures unstructured narrative into discrete Subjective, Objective, and Assessment blocks.
   • Generates a concise 2-sentence clinical summary for the patient transfer sheet.

Intelligent ICD-10 & Differential Diagnosis Suggestions#

As the physician inputs clinical symptoms and examination findings:

1. The AI Copilot analyzes the documented clinical context against clinical practice guidelines.
2. It suggests relevant differential diagnoses with probability rankings:
   • K80.00 - Calculus of gallbladder with acute cholecystitis (88% match).
   • K29.70 - Gastritis, unspecified, without bleeding (64% match).
   • K85.90 - Acute pancreatitis, unspecified (42% match).
3. Clicking Accept Code instantly populates the primary assessment line without manual code searches.

Pharmacovigilance & Drug Interaction Warnings#

When prescribing combinations:

• The Copilot cross-references active prescriptions against the hospital formulary and patient kidney function ($eGFR$).
• If renal clearance is impaired, it alerts: "Caution: Patient eGFR is 32 mL/min. Recommended Ciprofloxacin dose adjustment is 250mg q12h instead of standard 500mg."
• The physician retains full clinical autonomy to accept or reject all AI suggestions with a documented rationale.

4. Advanced Configuration Points#

• Automated Actions & Scheduled Tasks (Crons):
  • Healthcare: Generate daily MoH HMIS aggregate tally (smarterp_healthcare.ir_cron_hmis_sync): Runs daily at 23:00 to prepare DHIS2 health data summaries
  • Pharmacy: Flag expiring EFDA medicine batches (smarterp_healthcare.ir_cron_fefo_expiry): Runs daily at 06:00 to alert dispensers of lots expiring within 60 days
• Custom Print Templates & Reports:
  • Official Patient Encounter Summary & Medical Certificate
  • Electronic Prescription Order Form (Model 19 Compliant)
  • Ethiopian Health Insurance Service (EHIS) Claim Dossier
  • Daily MoH Outpatient / Inpatient Morbidity Tally Sheet
• Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.

5. Comprehensive Troubleshooting Matrix#