@ampath/esm-dha-workflow-app 4.0.0-next.35 → 4.0.0-next.355

package/src/emt/types/emt.types.ts

@@ -0,0 +1,137 @@
+import type { HieClient } from '../../registry/types';
+
+/**
+ * A single pending EMT / ambulance referral as returned by
+ * `GET {hieBaseUrl}/emt/referrals`. Sample payload:
+ *
+ * ```json
+ * {
+ *   "submission_id": 77,
+ *   "cr_id": "CR4089468813472-8",
+ *   "status": "pending_acceptance",
+ *   "incident_id": "INC-1786295440",
+ *   "dispatch_id": "5aee41d2-7cb9-4a56-991f-6c014428819a",
+ *   "case_number": "AMB-5aee41d2-7cb9-4a56-991f-6c014428819a-FAC",
+ *   "ambulance_fr_code": "FID-AMB-916293-3",
+ *   "ambulance_registration_number": "GKB 847V",
+ *   "facility_fr_code": "FID-01-116951-6",
+ *   "evacuation_scene": "Nairobi Central",
+ *   "priority": "p1 life threatening (als) with altered consciousness",
+ *   "referral_reason": "",
+ *   "referral_category": "",
+ *   "transport_modality": "",
+ *   "referral_notes": "Chief complaint: Seizures. History of present illness: Witnessed seizure at scene. Medical history: None reported",
+ *   "bundle_id": "5aee41d2-7cb9-4a56-991f-6c014428819a",
+ *   "encounter_ref": "b64ff563-5ed6-4c9e-885d-3de53ae9d3f9",
+ *   "interventions": ["SHA-01-001"],
+ *   "requested_at": "2026-08-09T21:56:23.206621Z",
+ *   "updated_at": "2026-08-09T21:56:24.978157Z"
+ * }
+ * ```
+ *
+ * `visit_id` and `encounter_ref` are only present once the referral has an
+ * associated AMRS visit / resolved HIE encounter — earlier-stage submissions omit them.
+ */
+export interface EmtReferral {
+  submission_id: number;
+  cr_id: string;
+  status: EmtReferralStatus;
+  incident_id: string;
+  dispatch_id: string;
+  case_number: string;
+  ambulance_fr_code: string;
+  ambulance_registration_number: string;
+  facility_fr_code: string;
+  evacuation_scene: string;
+  /** Free-text triage priority, e.g. "p1 life threatening (als) with altered consciousness". */
+  priority: string;
+  referral_reason: string;
+  referral_category: string;
+  transport_modality: string;
+  referral_notes: string;
+  bundle_id: string;
+  /** Present once an AMRS visit has been started for this referral. */
+  visit_id?: string;
+  /** Present once the originating HIE encounter has been resolved. */
+  encounter_ref?: string;
+  interventions: string[];
+  requested_at: string;
+  updated_at: string;
+}
+
+export type EmtReferralStatus =
+  | 'pending_acceptance'
+  | 'accepted'
+  | 'rejected'
+  | 'handed_over'
+  | string;
+
+/** Paginated envelope returned by the pending-list endpoint. */
+export interface EmtReferralListResponse {
+  results: EmtReferral[];
+  count: number;
+  limit: number;
+  offset: number;
+}
+
+/** The receiving doctor's regulatory identifier — sent to `handover/initiate`. */
+export interface ReceivingDoctor {
+  /** Display name, surfaced in the confirmation step (not sent to the API). */
+  name: string;
+  /** e.g. the KMPDC registration number ("A13579"). */
+  identifier: string;
+  identifierType: string;
+  /** Licensing body, e.g. "KMPDC" | "COC" | "NCK". */
+  regulator: string;
+}
+
+/** Request body for `POST /api/v1/claims/emt/handover/initiate`. */
+export interface InitiateHandoverRequest {
+  incidenceNumber: string;
+  identifier: string;
+  identifierType: string;
+  regulator: string;
+  /** The current facility's OpenMRS location uuid — the backend scopes the handover to it. */
+  locationUuid: string;
+}
+
+/** Response from `handover/initiate` — carries the request id needed to verify. */
+export interface InitiateHandoverResponse {
+  request_id?: string;
+  requestId?: string;
+  [key: string]: unknown;
+}
+
+/** Request body for `POST /api/v1/claims/emt/handover/verify`. */
+export interface VerifyHandoverRequest {
+  incidenceNumber: string;
+  requestId: string;
+  otp: string;
+  /** The current facility's OpenMRS location uuid — the backend scopes the handover to it. */
+  locationUuid: string;
+}
+
+/**
+ * A referral row enriched with its lazily-fetched Client Registry record,
+ * so the queue can show a human-readable patient instead of a bare `cr_id`.
+ */
+export interface EmtReferralRow extends EmtReferral {
+  /** Display name resolved from CR (falls back to the cr_id). */
+  patientName: string;
+  /** True while the CR record is being fetched for this row. */
+  crLoading: boolean;
+  /** Set if the CR lookup for this row failed — the row degrades gracefully. */
+  crError?: string;
+  /** The full CR record when available. */
+  client?: HieClient;
+}
+
+/** Discriminated error thrown by the EMT resource for branchable UI handling. */
+export class EmtApiError extends Error {
+  status: number;
+  constructor(status: number, message: string) {
+    super(message);
+    this.name = 'EmtApiError';
+    this.status = status;
+  }
+}

package/src/index.ts

@@ -1,11 +1,21 @@
-/**
- * This is the entrypoint file of the application. It communicates the
- * important features of this microfrontend to the app shell. It
- * connects the app shell to the React application(s) that make up this
- * microfrontend.
- */
 import { getAsyncLifecycle, defineConfigSchema, getSyncLifecycle } from '@openmrs/esm-framework';
 import { configSchema } from './config-schema';
+import { registryDashboardMeta } from './dashboard-meta/registry-dashboard.meta';
+import { createDashboardLink } from './createDashboardLink';
+import { createDashboardLink as openMrsCreateDashboardLink } from '@openmrs/esm-patient-common-lib';
+import { queueDashboardMeta } from './dashboard-meta/queue-dashboard.meta';
+import { pharmacyDashboardMeta } from './dashboard-meta/pharmacy-dashboard.meta';
+import { triageDashboardMeta } from './dashboard-meta/triage-dashboard.meta';
+import { consultationDashboardMeta } from './dashboard-meta/consultation-dashboard.meta';
+import { dhaWorkflowDashboardMeta } from './dashboard-meta/dha-workflow-dashboard.meta';
+import { accountingDashboardMeta } from './dashboard-meta/accounting-dashboard.meta';
+import { bookingsDashboardMeta } from './dashboard-meta/bookings-dashboard.meta';
+import { serviceQueueAdminDashboardMeta } from './dashboard-meta/service-queue-admin.meta';
+import { admissionsDashboardMeta } from './dashboard-meta/admissions-dashboard.meta';
+import { patientChartAdmissionsMetaData } from './dashboard-meta/inpatient-admissions.meta';
+import { caseSummaryMeta } from './dashboard-meta/case-summary.meta';
+import { emtDashboardMeta } from './dashboard-meta/emt-dashboard.meta';
+import { electivePreauthMeta } from './dashboard-meta/elective-preauth.meta';
 
 export const moduleName = '@ampath/esm-dha-workflow-app';
 
@@ -65,3 +75,191 @@ export const workflowRegistryLink = getAsyncLifecycle(() => import('./widgets/wo
   featureName: 'workflow-registry-link',
   moduleName,
 });
+
+export const registryDashboardLink = getSyncLifecycle(createDashboardLink(registryDashboardMeta), options);
+
+export const registryExtension = getAsyncLifecycle(() => import('./registry/registry-entry'), options);
+
+export const queueDashboardLink = getSyncLifecycle(createDashboardLink(queueDashboardMeta), options);
+
+export const queueDashboardExtension = getAsyncLifecycle(() => import('./dashboard/dashboard.component'), options);
+
+export const pharmacyDashboardLink = getSyncLifecycle(createDashboardLink(pharmacyDashboardMeta), options);
+
+export const triageDashboardLink = getSyncLifecycle(createDashboardLink(triageDashboardMeta), options);
+
+export const triageQueueExtension = getAsyncLifecycle(() => import('./triage/triage.component'), options);
+
+export const consultationDashboardLink = getSyncLifecycle(createDashboardLink(consultationDashboardMeta), options);
+
+export const consultationQueue = getAsyncLifecycle(
+  () => import('./service-queues/consultation/consultation.component'),
+  options,
+);
+
+export const dhaWorkflowDashboardLink = getSyncLifecycle(createDashboardLink(dhaWorkflowDashboardMeta), options);
+
+export const dhaWorkflowDashboard = getAsyncLifecycle(() => import('./dashboard/dashboard.component'), options);
+
+export const accountingDashboardLink = getSyncLifecycle(createDashboardLink(accountingDashboardMeta), options);
+
+export const accountingDashboard = getAsyncLifecycle(() => import('./accounting/accounting.component'), options);
+
+export const bookingsDashboardLink = getSyncLifecycle(createDashboardLink(bookingsDashboardMeta), options);
+
+export const bookings = getAsyncLifecycle(() => import('./bookings/bookings.component'), options);
+
+export const mnchQueueDashboardLink = getAsyncLifecycle(() => import('./side-nav-menu/mnch-nav-links'), options);
+
+export const specializedClinicsDashboardLink = getAsyncLifecycle(
+  () => import('./side-nav-menu/specialized-clinics-nav-links'),
+  options,
+);
+
+export const MNCHRoot = getAsyncLifecycle(() => import('./mnch/mnch-root'), options);
+
+export const SpecializedClinicsRoot = getAsyncLifecycle(
+  () => import('./specialized-clinics/specialized-clinics-root'),
+  options,
+);
+
+export const serviceQueueAdmin = getAsyncLifecycle(
+  () => import('./service-queues/admin/service-queue-admin-dashboard.component'),
+  options,
+);
+
+export const serviceQueuesAdminLink = getSyncLifecycle(createDashboardLink(serviceQueueAdminDashboardMeta), options);
+export const admissionsDashboardLink = getSyncLifecycle(createDashboardLink(admissionsDashboardMeta), options);
+
+export const admissionsDashboard = getAsyncLifecycle(
+  () => import('./admissions/admissions-dashboard.component'),
+  options,
+);
+
+export const serviceQueueBannerComponent = getAsyncLifecycle(
+  () => import('./service-queues/extensions/service-queue-patient-banner/service-queue-patient-banner'),
+  options,
+);
+export const patientChartAdmissionsLink = getSyncLifecycle(
+  openMrsCreateDashboardLink(patientChartAdmissionsMetaData as any),
+  options,
+);
+export const patientAdmissionSummary = getAsyncLifecycle(
+  () => import('./admissions/inpatient/inpatient-admissions.component'),
+  options,
+);
+
+export const caseSummaryLink = getSyncLifecycle(openMrsCreateDashboardLink(caseSummaryMeta as any), options);
+
+export const emtDashboardLink = getSyncLifecycle(createDashboardLink(emtDashboardMeta), options);
+
+export const emtQueue = getAsyncLifecycle(() => import('./emt/emt-queue.component'), options);
+
+export const emtHandoverWorkspace = getAsyncLifecycle(
+  () => import('./emt/handover-modal/handover-modal.component'),
+  options,
+);
+
+export const caseSummary = getAsyncLifecycle(() => import('./case-summary/case-summary.extension'), options);
+
+export const electivePreauthLink = getSyncLifecycle(
+  openMrsCreateDashboardLink(electivePreauthMeta as any),
+  options,
+);
+
+export const electivePreauth = getAsyncLifecycle(
+  () => import('./billing/dashboard/v3/preauth/elective/elective-preauth.component'),
+  options,
+);
+
+export const billingDashboardLink = getAsyncLifecycle(
+  () => import('./billing/billing-dashboard-link.component'),
+  options,
+);
+
+export const billingDashboard = getAsyncLifecycle(
+  () => import('./billing/dashboard/billingDashboard.component'),
+  options,
+);
+
+export const billingRoot = getAsyncLifecycle(() => import('./billing/billing-root'), options);
+
+export const createOrderBillFormWorkspace = getAsyncLifecycle(
+  () => import('./billing/workspaces/create-order-bill-form-workspace/create-order-bill-form.workspace'),
+  options,
+);
+
+export const visitBillingForm = getAsyncLifecycle(
+  () => import('./billing/extensions/visit-billing/visit-billing.extension'),
+  options,
+);
+
+export const claims = getAsyncLifecycle(() => import('./claims/claims.component'), options);
+
+export const formEntryWorkspace = getAsyncLifecycle(
+  () => import('./admissions/form-entry-workspace/form-entry-workspace'),
+  {
+    featureName: 'admissions-form-entry',
+    moduleName,
+  },
+);
+
+export const uploadInterventionAttachmentsWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/patient-bill-details/attachments/add-attachments.component'),
+  options,
+);
+
+export const generateInterventionAttachmentsWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/patient-bill-details/attachments/generate-attachments.component'),
+  options,
+);
+
+export const billItemPaymentWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/patient-bill-details/workspaces/bill-item-payment/bill-item-payment.workspace'),
+  options,
+);
+
+export const addClaimLineWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/patient-bill-details/workspaces/add-claim-line/add-claim-line.workspace'),
+  options,
+);
+
+export const switchInterventionWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/claim-visits/switch-intervention/switch-intervention.workspace'),
+  options,
+);
+
+export const preauthFormWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v3/preauth/preauth.workspace'),
+  options,
+);
+
+export const recordDetailsWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/claim-visits/shared/record-details.workspace'),
+  options,
+);
+
+export const payCashWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v2/clearance/pay-cash.component'),
+  options,
+);
+
+export const sendToQueueWorkspace = getAsyncLifecycle(
+  () => import('./registry/modal/send-to-triage/send-to-queue.modal'),
+  options,
+);
+
+export const generateOrderBillButton = getAsyncLifecycle(
+  () => import('./billing/extensions/generate-order-bill-button/generate-order-bill-button.extension'),
+  options,
+);
+
+export const payerPreviewWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v3/claim-visits/payer-preview/payer-preview-workspace.component'),
+  options,
+);
+
+export const electivePreauthRequestWorkspace = getAsyncLifecycle(
+  () => import('./billing/dashboard/v3/preauth/elective/elective-preauth-request.workspace'),
+  options,
+);

package/src/mnch/maternity/maternity-queues.component.scss

@@ -0,0 +1,7 @@
+.mnchLayout{
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    row-gap: 10px;
+    padding: 2% 2%;
+}

package/src/mnch/maternity/maternity-queues.component.tsx

@@ -0,0 +1,32 @@
+import React from 'react';
+import styles from './maternity-queues.component.scss';
+import { Tab, TabList, TabPanel, TabPanels, Tabs } from '@carbon/react';
+import MaternityTriage from './queues/triage/maternity-triage';
+import FacilityAndWorkerSlot from '../../shared/ui/facility-worker-slot/facility-worker.component-slot.component';
+interface MchQueuesProps {}
+const MaternityQueues: React.FC<MchQueuesProps> = () => {
+  return (
+    <div className={styles.mnchLayout}>
+      <div className={styles.hwrSection}>
+            <FacilityAndWorkerSlot />
+      </div>
+      <div className={styles.mnchHeader}>
+        <h4>Maternity</h4>
+      </div>
+      <div className={styles.mnchContent}>
+        <Tabs>
+          <TabList contained>
+            <Tab>Triage</Tab>
+          </TabList>
+          <TabPanels>
+            <TabPanel>
+              <MaternityTriage />
+            </TabPanel>
+
+          </TabPanels>
+        </Tabs>
+      </div>
+    </div>
+  );
+};
+export default MaternityQueues;

package/src/mnch/maternity/queues/triage/maternity-triage.tsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import ServiceQueueComponent from '../../../../service-queues/service-queue/service-queue.component';
+import { QUEUE_SERVICE_UUIDS } from '../../../../shared/constants/concepts';
+
+interface TriageProps {}
+const MaternityTriage: React.FC<TriageProps> = () => {
+  return (
+    <>
+      <div>
+        <ServiceQueueComponent serviceTypeUuid={QUEUE_SERVICE_UUIDS.MATERNITY_TRIAGE_SERVICE_UUID} title="Maternity Triage" />
+      </div>
+    </>
+  );
+};
+export default MaternityTriage;

package/src/mnch/mch/mch-queues.component.scss

@@ -0,0 +1,10 @@
+.mnchLayout{
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    row-gap: 10px;
+    padding: 2% 2%;
+}
+.hwrSection{
+    width: 100%;
+}

package/src/mnch/mch/mch-queues.component.tsx

@@ -0,0 +1,36 @@
+import React from 'react';
+import styles from './mch-queues.component.scss';
+import { Tab, TabList, TabPanel, TabPanels, Tabs } from '@carbon/react';
+import MchTriage from './queues/triage/mch-triage';
+import MchConsultation from './queues/consultation/mch-consultation';
+import FacilityAndWorkerSlot from '../../shared/ui/facility-worker-slot/facility-worker.component-slot.component';
+interface MchQueuesProps {}
+const MchQueues: React.FC<MchQueuesProps> = () => {
+  return (
+    <div className={styles.mnchLayout}>
+      <div className={styles.hwrSection}>
+            <FacilityAndWorkerSlot />
+      </div>
+      <div className={styles.mnchHeader}>
+        <h4>MNCH</h4>
+      </div>
+      <div className={styles.mnchContent}>
+        <Tabs>
+          <TabList contained>
+            <Tab>Triage</Tab>
+            <Tab>Consultation</Tab>
+          </TabList>
+          <TabPanels>
+            <TabPanel>
+              <MchTriage />
+            </TabPanel>
+            <TabPanel>
+              <MchConsultation />
+            </TabPanel>
+          </TabPanels>
+        </Tabs>
+      </div>
+    </div>
+  );
+};
+export default MchQueues;

package/src/mnch/mch/queues/consultation/mch-consultation.tsx

@@ -0,0 +1,18 @@
+import React from 'react';
+import ServiceQueueComponent from '../../../../service-queues/service-queue/service-queue.component';
+import { QUEUE_SERVICE_UUIDS } from '../../../../shared/constants/concepts';
+
+interface MchConsultationProps {}
+const MchConsultation: React.FC<MchConsultationProps> = () => {
+  return (
+    <>
+      <div>
+        <ServiceQueueComponent
+          serviceTypeUuid={QUEUE_SERVICE_UUIDS.MCH_CLINICAL_CONSULTATION_SERVICE_UUID}
+          title="MCH Consultation"
+        />
+      </div>
+    </>
+  );
+};
+export default MchConsultation;

package/src/mnch/mch/queues/triage/mch-triage.tsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import ServiceQueueComponent from '../../../../service-queues/service-queue/service-queue.component';
+import { QUEUE_SERVICE_UUIDS } from '../../../../shared/constants/concepts';
+
+interface TriageProps {}
+const MchTriage: React.FC<TriageProps> = () => {
+  return (
+    <>
+      <div>
+        <ServiceQueueComponent serviceTypeUuid={QUEUE_SERVICE_UUIDS.MCH_TRIAGE_SERVICE_UUID} title="MCH Triage" />
+      </div>
+    </>
+  );
+};
+export default MchTriage;

package/src/mnch/mnch-root.tsx

@@ -0,0 +1,17 @@
+import React from 'react';
+import { BrowserRouter, Route, Routes } from 'react-router-dom';
+import MchQueues from './mch/mch-queues.component';
+import MaternityQueues from './maternity/maternity-queues.component';
+
+const MNCHRoot: React.FC = () => {
+  return (
+    <BrowserRouter basename={`${window.spaBase}/home/mnch`}>
+      <Routes>
+        <Route path="/mch" element={<MchQueues/>} />
+        <Route path="/maternity" element={<MaternityQueues />} />
+      </Routes>
+    </BrowserRouter>
+  );
+};
+
+export default MNCHRoot;

package/src/mortuary/mortuary.component.tsx

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ExtensionSlot } from '@openmrs/esm-framework';
+
+const Mortuary: React.FC = () => {
+  
+  return (
+    <div>
+      <ExtensionSlot name="mortuary-dashboard-slot" />
+    </div>
+  );
+};
+
+export default Mortuary;

package/src/pharmacy/pharmacy.component.scss

@@ -0,0 +1,16 @@
+.pharmacyLayout{
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    row-gap: 1px;
+    .hwrSection{
+        display: flex;
+        flex-direction: column;
+        width: 100%;
+    }
+    .pharmacySection{
+        display: flex;
+        flex-direction: column;
+        width: 100%;
+    }
+}

package/src/pharmacy/pharmacy.component.tsx

@@ -1,11 +1,16 @@
-import React, { useEffect, useState } from 'react';
-import { ExtensionSlot, WorkspaceContainer } from '@openmrs/esm-framework';
-
+import React from 'react';
+import { ExtensionSlot } from '@openmrs/esm-framework';
+import styles from './pharmacy.component.scss';
+import FacilityAndWorkerSlot from '../shared/ui/facility-worker-slot/facility-worker.component-slot.component';
 const PharmacyComponent: React.FC = () => {
-  
   return (
-    <div>
-      <ExtensionSlot name="dispensing-dashboard-slot" />
+    <div className={styles.pharmacyLayout}>
+      <div className={styles.hwrSection}>
+        <FacilityAndWorkerSlot />
+      </div>
+      <div className={styles.pharmacySection}>
+        <ExtensionSlot name="dispensing-dashboard-slot" />
+      </div>
     </div>
   );
 };

package/src/registers/registers.component.tsx

@@ -0,0 +1,8 @@
+import React from 'react';
+
+interface RegistersProps {}
+const Registers: React.FC<RegistersProps> = () => {
+  return <>Registers</>;
+};
+
+export default Registers;