@palladium-ethiopia/esm-clinical-workflow-app 5.4.2-pre.20

package/dist/routes.json

@@ -0,0 +1 @@
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"fhir2":">=1.2","webservices.rest":"^2.24.0"},"pages":[],"extensions":[{"name":"clinical-workflow-triage-dashboard-link","component":"triageDashboardLink","slot":"homepage-dashboard-slot","order":0,"meta":{"name":"clinical-workflow-triage","slot":"clinical-workflow-triage-dashboard-slot","title":"clinical-workflow-triage"}},{"name":"clinical-workflow-triage-dashboard","component":"triageDashboard","slot":"clinical-workflow-triage-dashboard-slot"},{"name":"ewf-mru-dashboard-link","component":"mruLeftPanelLink","slot":"homepage-dashboard-slot","order":1,"meta":{"name":"mru","title":"MRU","path":"mru","slot":"mru-dashboard-slot"}},{"name":"ewf-mru-dashboard","component":"mruDashboard","slot":"mru-dashboard-slot","online":true,"offline":false},{"name":"patient-scoreboard-link","component":"patientScoreboardLink","slot":"homepage-dashboard-slot","order":1,"meta":{"name":"patient-scoreboard","title":"Patient Scoreboard","path":"patient-scoreboard","slot":"patient-scoreboard-slot"}},{"name":"patient-scoreboard","component":"patientScoreboard","slot":"patient-scoreboard-slot","online":true,"offline":false}],"workspaces":[{"name":"triage-workspace","component":"triageWorkspace","title":"Triage Form","canMaximize":true,"type":"clinical-form"},{"name":"patient-registration-workspace","component":"patientRegistrationWorkspace","title":"Patient Registration","canMaximize":true,"type":"registration-form"},{"name":"billing-information-workspace","component":"billingInformationWorkspace","title":"Billing Information Workspace","type":"clinical-form"}],"workspaces2":[{"name":"clinical-workflow-patient-form-entry-workspace","component":"@openmrs/esm-patient-forms-app#exportedPatientFormEntryWorkspace","window":"clinical-workflow-window"}],"workspaceWindows2":[{"name":"clinical-workflow-window","group":"clinical-workflow-group","width":"wider","canMaximize":true}],"workspaceGroups2":[{"name":"clinical-workflow-group","overlay":true,"persistence":"closable"}],"version":"5.4.2-pre.20"}

package/jest.config.js

@@ -0,0 +1,3 @@
+const rootConfig = require('../../jest.config.js');
+
+module.exports = rootConfig;

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@palladium-ethiopia/esm-clinical-workflow-app",
+  "version": "5.4.2-pre.20",
+  "description": "Express workflow app for OpenMRS 3",
+  "keywords": [
+    "openmrs",
+    "ethiopiaemr"
+  ],
+  "homepage": "https://github.com/palladium-group/ethiopiaemr-esm-3.x#readme",
+  "bugs": {
+    "url": "https://github.com/palladium-group/ethiopiaemr-esm-3.x/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/palladium-group/ethiopiaemr-esm-3.x.git"
+  },
+  "license": "MPL-2.0",
+  "main": "src/index.ts",
+  "source": true,
+  "browser": "dist/ethiopia-esm-clinical-workflow-app.js",
+  "scripts": {
+    "analyze": "rspack --mode=production --env analyze=true",
+    "build": "rspack --mode=production",
+    "coverage": "yarn test --coverage",
+    "debug": "npm run serve",
+    "extract-translations": "i18next 'src/**/*.component.tsx' 'src/**/*.extension.tsx' 'src/**/*modal.tsx' 'src/**/*.workspace.tsx' 'src/index.ts' --config ../../tools/i18next-parser.config.js",
+    "lint": "cross-env eslint src --ext ts,tsx",
+    "serve": "rspack serve --mode=development",
+    "start": "openmrs develop",
+    "test": "cross-env TZ=UTC jest --config jest.config.js --verbose false --passWithNoTests --color",
+    "test:watch": "cross-env TZ=UTC jest --watch --config jest.config.js --color",
+    "typescript": "tsc"
+  },
+  "browserslist": [
+    "extends browserslist-config-openmrs"
+  ],
+  "dependencies": {
+    "@carbon/react": "^1.83.0",
+    "@hookform/resolvers": "^3.9.1",
+    "@superset-ui/embedded-sdk": "^0.2.0",
+    "classnames": "^2.3.2",
+    "lodash-es": "^4.17.15",
+    "react-hook-form": "^7.54.0",
+    "react-otp-input": "^3.1.1",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "@openmrs/esm-framework": "8.x",
+    "dayjs": "1.x",
+    "react": "18.x",
+    "react-i18next": "11.x",
+    "react-router-dom": "6.x",
+    "swr": "2.x"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "stableVersion": "5.4.1"
+}

package/rspack.config.js

@@ -0,0 +1 @@
+module.exports = require('openmrs/default-rspack-config');

package/src/config-schema.ts

@@ -0,0 +1,69 @@
+import { Type } from '@openmrs/esm-framework';
+
+export const configSchema = {
+  triageLocationForms: {
+    _type: Type.Object,
+    _description:
+      'Mapping of location UUIDs to their triage form configurations. Each location can have one triage form.',
+    _default: {
+      '44c3efb0-2583-4c80-a79e-1f756a03c0a1': {
+        formUuid: '35093e6c-f35e-48a7-ae42-17b988d86c17',
+        name: 'Central Triage Form',
+      },
+      '8d9045ad-50f0-45b8-93c8-3ed4bce19dbf': {
+        formUuid: 'ffbe6be3-3b72-4271-a2f4-803907ca4ef4',
+        name: 'Emergency Triage Form',
+      },
+    },
+  },
+  billingVisitAttributeTypes: {
+    _type: Type.Object,
+    _description: 'Visit attribute type UUIDs for billing information',
+    _default: {
+      paymentMethod: 'e6cb0c3b-04b0-4117-9bc6-ce24adbda802',
+      creditType: '5cd1eb62-e006-4146-bd22-80bc4d5bd2f7',
+      creditTypeDetails: 'd824aa96-d2c7-4a52-aa8d-03f60a516083',
+      freeType: '7523ecfe-b8f1-4e7f-80a7-1a495b15ace4',
+    },
+  },
+  visitTypeUuid: {
+    _type: Type.String,
+    _description: 'Visit type UUID',
+    _default: '7b0f5697-27e3-40c4-8bae-f4049abfb4ed', // Outpatient
+  },
+  identifierSourceUuid: {
+    _type: Type.String,
+    _description: 'Identifier source UUID',
+    _default: '8549f706-7e85-4c1d-9424-217d50a2988b',
+  },
+  defaultIdentifierTypeUuid: {
+    _type: Type.String,
+    _description: 'OpenMRS ID',
+    _default: '05a29f94-c0ed-11e2-94be-8c13b969e334',
+  },
+  medicoLegalCasesAttributeTypeUuid: {
+    _type: Type.String,
+    _description: 'Patient attribute type UUID for Medico Legal Cases',
+    _default: '',
+  },
+};
+
+export type ClinicalWorkflowConfig = {
+  triageLocationForms: Record<
+    string,
+    {
+      formUuid: string;
+      name: string;
+    }
+  >;
+  billingVisitAttributeTypes: {
+    paymentMethod: string;
+    creditType: string;
+    creditTypeDetails: string;
+    freeType: string;
+  };
+  visitTypeUuid: string;
+  identifierSourceUuid: string;
+  defaultIdentifierTypeUuid: string;
+  medicoLegalCasesAttributeTypeUuid: string;
+};

package/src/constants.ts

@@ -0,0 +1,2 @@
+export const moduleName = '@palladium-ethiopia/esm-clinical-workflow-app';
+export const spaBasePath = `${window.spaBase}/home`;

package/src/createDashboardLink.tsx

@@ -0,0 +1,10 @@
+import React from 'react';
+import { BrowserRouter } from 'react-router-dom';
+import { DashboardExtension, type DashboardExtensionProps } from '@openmrs/esm-framework';
+
+export const createDashboardLink = (config: Omit<DashboardExtensionProps, 'icon'> & { icon?: any }) => () =>
+  (
+    <BrowserRouter>
+      <DashboardExtension path={config.path} title={config.title} basePath={config.basePath} icon={config.icon} />
+    </BrowserRouter>
+  );

package/src/dashboard.meta.ts

@@ -0,0 +1,6 @@
+export const dashboardMeta = {
+  path: 'clinical-workflow-triage',
+  slot: 'clinical-workflow-triage-dashboard-slot',
+  title: 'Triage',
+  basePath: `${window.spaBase}/home`,
+} as const;

package/src/declarations.d.ts

@@ -0,0 +1,3 @@
+declare module '*.png';
+declare module '*.svg';
+declare module '*.scss';

package/src/helper.ts

@@ -0,0 +1,115 @@
+import { Encounter, fetchCurrentPatient, launchWorkspace2, showModal, showSnackbar } from '@openmrs/esm-framework';
+import { createVisitForPatient, getCurrentVisitForPatient } from './triage/triage.resource';
+
+export const handleStartVisitAndLaunchTriageForm = async (
+  patientUuid: string,
+  formUuid: string,
+  formName: string,
+  visitTypeUuid: string,
+) => {
+  if (!patientUuid?.trim()) {
+    showSnackbar({
+      title: 'Error',
+      kind: 'error',
+      subtitle: 'Patient UUID is required',
+      isLowContrast: true,
+    });
+    return;
+  }
+
+  if (!formUuid?.trim()) {
+    showSnackbar({
+      title: 'Error',
+      kind: 'error',
+      subtitle: 'Form UUID is required',
+      isLowContrast: true,
+    });
+    return;
+  }
+
+  if (!formName?.trim()) {
+    showSnackbar({
+      title: 'Error',
+      kind: 'error',
+      subtitle: 'Form name is required',
+      isLowContrast: true,
+    });
+    return;
+  }
+
+  if (!visitTypeUuid?.trim()) {
+    showSnackbar({
+      title: 'Error',
+      kind: 'error',
+      subtitle: 'Visit type UUID is required',
+      isLowContrast: true,
+    });
+    return;
+  }
+
+  try {
+    const patient = await fetchCurrentPatient(patientUuid);
+
+    if (!patient) {
+      throw new Error('Failed to fetch patient data');
+    }
+
+    let activeVisit = await getCurrentVisitForPatient(patientUuid);
+    if (!activeVisit) {
+      const visitResponse = await createVisitForPatient(patientUuid, visitTypeUuid);
+      if (!visitResponse.ok) {
+        throw new Error(visitResponse.data?.error?.message || 'Error starting visit for patient');
+      }
+      activeVisit = visitResponse.data;
+    }
+
+    if (!activeVisit?.uuid || !activeVisit?.visitType?.uuid) {
+      throw new Error('Invalid visit data received');
+    }
+
+    const handleShowModal = (encounter: Encounter) => {
+      const dispose = showModal('transition-patient-to-latest-queue-modal', {
+        activeVisit: activeVisit,
+        closeModal: () => dispose(),
+      });
+    };
+
+    launchWorkspace2(
+      'clinical-workflow-patient-form-entry-workspace',
+      {
+        formEntryWorkspaceName: formName,
+        patient: patient,
+        visitContext: activeVisit,
+        form: {
+          visitUuid: activeVisit.uuid,
+          uuid: formUuid,
+          visitTypeUuid: activeVisit.visitType.uuid,
+        },
+        encounterUuid: '',
+        handlePostResponse: handleShowModal,
+      },
+      {
+        patientUuid: patientUuid,
+        patient: patient,
+        visitContext: activeVisit,
+      },
+    );
+
+    // Set z-index for workspace container
+    setTimeout(() => {
+      const workspaceContainer = document.getElementById('omrs-workspaces-container');
+      if (workspaceContainer) {
+        workspaceContainer.style.zIndex = '100';
+      }
+    }, 0);
+  } catch (err) {
+    const errorMessage = err instanceof Error ? err.message : 'An unexpected error occurred';
+
+    showSnackbar({
+      title: 'Error starting visit for patient',
+      kind: 'error',
+      subtitle: errorMessage,
+      isLowContrast: true,
+    });
+  }
+};

package/src/index.ts

@@ -0,0 +1,51 @@
+import { defineConfigSchema, getAsyncLifecycle, getSyncLifecycle } from '@openmrs/esm-framework';
+import { createDashboardLink } from './createDashboardLink';
+import { configSchema } from './config-schema';
+import { dashboardMeta } from './dashboard.meta';
+import MRUDashboard from './mru/dashboard.component';
+import { spaBasePath } from './constants';
+import BillingInformationWorkspace from './mru/billing-information/billing-information.workspace';
+import PatientScoreboard from './patient-scoreboard/patient-scoreboard.component';
+
+const moduleName = '@ethiopia/esm-clinical-workflow-app';
+
+const options = {
+  featureName: 'clinical-workflow',
+  moduleName,
+};
+
+export function startupApp() {
+  defineConfigSchema(moduleName, configSchema);
+}
+
+export const root = getAsyncLifecycle(() => import('./root.component'), options);
+
+export const triageDashboardLink = getSyncLifecycle(createDashboardLink(dashboardMeta), options);
+export const triageDashboard = getAsyncLifecycle(() => import('./triage/triage-dashboard.component'), options);
+export const patientRegistrationWorkspace = getAsyncLifecycle(
+  () => import('./patient-registration/patient.registration.workspace'),
+  options,
+);
+
+export const mruDashboard = getSyncLifecycle(MRUDashboard, options);
+export const mruLeftPanelLink = getSyncLifecycle(
+  createDashboardLink({
+    path: 'mru',
+    title: 'MRU',
+    basePath: spaBasePath,
+  }),
+  options,
+);
+
+export const billingInformationWorkspace = getSyncLifecycle(BillingInformationWorkspace, options);
+
+export const patientScoreboardLink = getSyncLifecycle(
+  createDashboardLink({
+    path: 'patient-scoreboard',
+    title: 'Patient Scoreboard',
+    basePath: spaBasePath,
+  }),
+  options,
+);
+
+export const patientScoreboard = getSyncLifecycle(PatientScoreboard, options);

package/src/mru/billing-information/billing-information.resource.ts

@@ -0,0 +1,139 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { z } from 'zod';
+// Create the billing form schema factory with conditional validation based on skip logic
+import type { TFunction } from 'i18next';
+
+export const createBillingFormSchema = (t: TFunction) => {
+  return z
+    .object({
+      billingType: z.enum(['credit', 'free', 'cash']).optional(),
+      creditType: z.string().optional(),
+      name: z.string().optional(),
+      code: z.string().optional(),
+      id: z.string().optional(),
+      expiryDate: z.string().optional(),
+      zone: z.string().optional(),
+      freeType: z.string().optional(),
+    })
+    .superRefine((data, ctx) => {
+      // Billing type is required on submit
+      if (!data.billingType) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: t('billingTypeRequired', 'Billing type is required'),
+          path: ['billingType'],
+        });
+        return;
+      }
+
+      // Credit billing type validation
+      if (data.billingType === 'credit') {
+        // Credit type is required
+        if (!data.creditType || data.creditType.trim() === '') {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: t('creditTypeRequired', 'Credit type is required'),
+            path: ['creditType'],
+          });
+        }
+
+        // If creditType is insurance, require additional fields
+        if (data.creditType === 'insurance') {
+          if (!data.id || data.id.trim() === '') {
+            ctx.addIssue({
+              code: z.ZodIssueCode.custom,
+              message: t('idRequired', 'ID is required'),
+              path: ['id'],
+            });
+          }
+        }
+      }
+
+      // Free billing type validation
+      if (data.billingType === 'free') {
+        if (!data.freeType || data.freeType.trim() === '') {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: t('freeTypeRequired', 'Free type is required'),
+            path: ['freeType'],
+          });
+        }
+      }
+    });
+};
+
+export type BillingFormData = z.infer<ReturnType<typeof createBillingFormSchema>>;
+
+const transformFormObjectToVisitAttributes = (
+  formObject: Record<string, any>,
+  visitAttributeTypeUuidsMap: Record<string, string>,
+) => {
+  return Object.entries(formObject)
+    .map(([key, value]) => ({
+      attributeType: visitAttributeTypeUuidsMap[key],
+      value: value,
+    }))
+    .filter((item) => {
+      // Filter out undefined, null, or empty string values
+      if (item.value === undefined || item.value === null || item.value === '') {
+        return false;
+      }
+      // Filter out empty creditTypeDetails object
+      if (item.value && typeof item.value === 'object' && !Array.isArray(item.value)) {
+        const creditDetails = item.value as Record<string, any>;
+        const hasAnyValue = Object.values(creditDetails).some((val) => val !== undefined && val !== null && val !== '');
+        if (!hasAnyValue) {
+          return false;
+        }
+      }
+      return true;
+    })
+    .map((item) => ({
+      attributeType: item.attributeType,
+      value: item.value && typeof item.value === 'object' ? JSON.stringify(item.value) : item.value,
+    }));
+};
+
+export const createBillingInformationVisitAttribute = (
+  billingFormData: BillingFormData,
+  visitAttributeTypeUuidsMap: {
+    paymentMethod: string;
+    creditType: string;
+    creditTypeDetails: string;
+    freeType: string;
+  },
+) => {
+  const { billingType, creditType, name, code, id, expiryDate, zone, freeType } = billingFormData;
+
+  const formObject = {
+    paymentMethod: billingType,
+    creditType: creditType,
+    creditTypeDetails: {
+      name: name,
+      code: code,
+      id: id,
+      expiryDate: expiryDate,
+      zone: zone,
+    },
+    freeType: freeType,
+  };
+
+  const visitAttributePayload = transformFormObjectToVisitAttributes(formObject, visitAttributeTypeUuidsMap);
+
+  return visitAttributePayload;
+};
+
+export const updateVisitWithBillingInformation = (
+  visitAttributePayload: Array<{ attributeType: string; value: string }>,
+  visitUuid: string,
+) => {
+  return openmrsFetch(`${restBaseUrl}/visit/${visitUuid}`, {
+    method: 'POST',
+    headers: {
+      'Content-type': 'application/json',
+    },
+    body: {
+      attributes: visitAttributePayload,
+    },
+  });
+};

package/src/mru/billing-information/billing-information.scss

@@ -0,0 +1,55 @@
+@use '@carbon/styles/scss/spacing';
+@use '@carbon/type';
+@use '@carbon/layout';
+@use '@carbon/colors';
+
+.sectionTitle {
+  @include type.type-style('label-01');
+  color: colors.$gray-70;
+  margin-bottom: spacing.$spacing-03;
+}
+
+.buttonSet {
+  width: 100%;
+  padding-top: spacing.$spacing-05;
+  background-color: colors.$white-0;
+  justify-content: space-between;
+  bottom: 0;
+  position: absolute;
+  & > button {
+    max-width: 50% !important;
+    width: 50%;
+  }
+}
+
+.billingInformationContainer {
+  margin: spacing.$spacing-05;
+  height: 100%;
+  overflow-y: auto;
+}
+
+.creditDetailsContainer {
+  display: flex;
+  flex-direction: column;
+  gap: spacing.$spacing-05;
+  margin-top: spacing.$spacing-03;
+  min-height: 45rem;
+  border: 1px solid colors.$gray-20;
+  padding: spacing.$spacing-03;
+}
+
+.freeDetailsContainer {
+  display: flex;
+  flex-direction: column;
+  gap: spacing.$spacing-05;
+  margin-top: spacing.$spacing-03;
+  min-height: 20rem;
+  border: 1px solid colors.$gray-20;
+  padding: spacing.$spacing-03;
+}
+
+.creditTypeDetailsContainer {
+  display: flex;
+  flex-direction: column;
+  gap: spacing.$spacing-03;
+}