@ampath/esm-dha-workflow-app 4.0.0-next.12 → 4.0.0-next.14

package/src/registry/utils/hie-client-adapter.ts

@@ -0,0 +1,309 @@
+import { IdentifierTypesUuids } from '../../resources/identifier-types';
+import { CivilStatusUids } from '../../shared/constants/civil-status';
+import { PersonAttributeTypeUuids } from '../../shared/constants/person-attributes';
+import {
+  type AlternateContact,
+  type CreatePersonDto,
+  type HieClient,
+  type HieIdentifications,
+  HieIdentificationType,
+} from '../types';
+
+const clientDatailsFields = [
+  'id',
+  'other_identifications',
+  'first_name',
+  'middle_name',
+  'last_name',
+  'gender',
+  'date_of_birth',
+  'is_alive',
+  'deceased_datetime',
+  'phone',
+  'email',
+  'civil_status',
+  'place_of_birth',
+  'citizenship',
+  'country',
+  'county',
+  'sub_county',
+  'ward',
+  'village_estate',
+  'longitude',
+  'latitude',
+  'identification_type',
+];
+
+const nameFields = ['first_name', 'middle_name', 'last_name'];
+const otherPersonFields = ['gender', 'date_of_birth', 'is_alive', 'deceased_datetime'];
+const attributeFields = ['phone', 'email', 'civil_status', 'place_of_birth', 'citizenship'];
+const addressFields = ['country', 'county', 'sub_county', 'ward', 'village_estate', 'longitude', 'latitude'];
+const otherFields = ['gender', 'date_of_birth'];
+const identifierFields = [
+  HieIdentificationType.Cr,
+  HieIdentificationType.SHANumber,
+  HieIdentificationType.HouseholdNumber,
+  HieIdentificationType.RefugeeID,
+  HieIdentificationType.MandateNumber,
+  HieIdentificationType.AlienID,
+  HieIdentificationType.NationalID,
+  HieIdentificationType.TemporaryDependantID,
+];
+const hieAmrsSyncFields = [
+  ...identifierFields,
+  ...nameFields,
+  ...otherPersonFields,
+  ...attributeFields,
+  ...addressFields,
+];
+
+export function generateHieClientDetails(hieClient: HieClient) {
+  let data = {};
+  Object.keys(hieClient)
+    .filter((key) => {
+      return clientDatailsFields.includes(key);
+    })
+    .forEach((key) => {
+      if (key === 'other_identifications') {
+        const otherIds = generateOtherIdentifications(hieClient[key]);
+        data = {
+          ...data,
+          ...otherIds,
+        };
+      } else if (key === 'identification_type') {
+        data[hieClient['identification_type']] = hieClient.identification_number;
+      } else {
+        const value = hieClient[key];
+        data[key] = value;
+      }
+    });
+  return data;
+}
+function generateOtherIdentifications(hieIdentifications: HieIdentifications[]) {
+  const other = {};
+  hieIdentifications.forEach((id) => {
+    other[id.identification_type] = id.identification_number;
+  });
+  return other;
+}
+
+export function generateAmrsPersonPayload(hieClient: HieClient): CreatePersonDto {
+  const createPersonPayload: CreatePersonDto = {};
+  const namesAttribute = {};
+  const addresses = {};
+  let attributes = [];
+  hieAmrsSyncFields.forEach((d) => {
+    if (d === 'first_name') {
+      namesAttribute['givenName'] = hieClient.first_name;
+    }
+    if (d === 'middle_name') {
+      namesAttribute['middleName'] = hieClient.middle_name;
+    }
+    if (d === 'last_name') {
+      namesAttribute['familyName'] = hieClient.last_name;
+    }
+    if (d === 'gender') {
+      createPersonPayload['gender'] = hieClient.gender === 'Male' ? 'M' : 'F';
+    }
+    if (d === 'date_of_birth') {
+      createPersonPayload['birthdate'] = hieClient.date_of_birth;
+      createPersonPayload['birthdateEstimated'] = false;
+    }
+    if (d === 'is_alive') {
+      createPersonPayload['dead'] = hieClient.is_alive === 0 ? true : false;
+    }
+    if (d === 'deceased_datetime') {
+      if (hieClient.deceased_datetime.length > 0) {
+        createPersonPayload['deathDate'] = hieClient.deceased_datetime;
+      }
+    }
+    if (d === 'country' && hieClient.country.length > 0) {
+      addresses['country'] = hieClient.country;
+      addresses['address1'] = hieClient.country;
+    }
+    if (d === 'place_of_birth' && hieClient.place_of_birth.length > 0) {
+      addresses['address10'] = hieClient.place_of_birth;
+    }
+    if (d === 'county' && hieClient.county.length > 0) {
+      addresses['countyDistrict'] = hieClient.county;
+    }
+    if (d === 'sub_county' && hieClient.sub_county.length > 0) {
+      addresses['address2'] = hieClient.sub_county;
+      addresses['stateProvince'] = hieClient.sub_county;
+    }
+    if (d === 'ward' && hieClient.sub_county.length > 0) {
+      addresses['address7'] = hieClient.sub_county;
+      addresses['address4'] = hieClient.sub_county;
+    }
+    if (d === 'village_estate' && hieClient.village_estate.length > 0) {
+      addresses['cityVillage'] = hieClient.village_estate;
+    }
+    if (d === 'longitude' && hieClient.longitude.length > 0) {
+      addresses['longitude'] = hieClient.longitude;
+    }
+    if (d === 'latitude' && hieClient.latitude.length > 0) {
+      addresses['latitude'] = hieClient.latitude;
+    }
+    if (d === 'place_of_birth' && hieClient.place_of_birth.length > 0) {
+      attributes.push({
+        value: hieClient.place_of_birth,
+        attributeType: PersonAttributeTypeUuids.PLACE_OF_BIRTH_UUID,
+      });
+    }
+    if (d === 'phone' && hieClient.phone.length > 0) {
+      attributes.push({
+        value: hieClient.phone,
+        attributeType: PersonAttributeTypeUuids.CONTACT_PHONE_NUMBER_UUID,
+      });
+    }
+    if (d === 'email' && hieClient.email.length > 0) {
+      attributes.push({
+        value: hieClient.email,
+        attributeType: PersonAttributeTypeUuids.CONTACT_EMAIL_ADDRESS_UUID,
+      });
+    }
+    if (d === 'civil_status' && hieClient.civil_status.length > 0) {
+      attributes.push({
+        value: getAmrsConceptUuidFromField(hieClient.civil_status),
+        attributeType: PersonAttributeTypeUuids.CIVIL_STATUS_UUID,
+      });
+    }
+    if (d === 'id' && hieClient.id) {
+      attributes.push({
+        value: hieClient.id,
+        attributeType: PersonAttributeTypeUuids.CLIENT_REGISTRY_ID_UUID,
+      });
+    }
+    if (d === 'citizenship' && hieClient.citizenship) {
+      attributes.push({
+        value: hieClient.citizenship,
+        attributeType: PersonAttributeTypeUuids.CITIZENSHIP_UUID,
+      });
+    }
+  });
+  // Add next of kin details
+  const nextOfKinAndAlternativeAttributes = generateNextOfKinAndAlternateContactDetails(hieClient.alternative_contacts);
+  attributes = [...attributes, ...nextOfKinAndAlternativeAttributes];
+  if (Object.keys(namesAttribute).length > 0) {
+    createPersonPayload['names'] = [namesAttribute];
+  }
+  if (Object.keys(addresses).length > 0) {
+    createPersonPayload['addresses'] = [addresses];
+  }
+  if (attributes.length > 0) {
+    createPersonPayload['attributes'] = attributes;
+  }
+  return createPersonPayload;
+}
+function generateNextOfKinAndAlternateContactDetails(alternativeContacts: AlternateContact[]) {
+  const attributes = [];
+  const alterNativeClientContact = alternativeContacts.find((a) => {
+    return a.relationship === 'Alternative Phone Number';
+  });
+  const nextOfKinContact = alternativeContacts.find((a) => {
+    return a.remarks === 'Next Of Kin';
+  });
+  if (alterNativeClientContact) {
+    if (alterNativeClientContact.contact_type === 'Phone') {
+      attributes.push({
+        value: alterNativeClientContact.contact_id,
+        attributeType: PersonAttributeTypeUuids.ALTERNATIVE_CONTACT_PHONE_NUMBER_UUID,
+      });
+    }
+  }
+  if (nextOfKinContact) {
+    if (nextOfKinContact.contact_type === 'Phone') {
+      attributes.push({
+        value: nextOfKinContact.contact_id,
+        attributeType: PersonAttributeTypeUuids.NEXT_OF_KIN_CONTACT_PHONE_NUMBER_UUID,
+      });
+    }
+    attributes.push({
+      value: nextOfKinContact.relationship,
+      attributeType: PersonAttributeTypeUuids.NEXT_OF_KIN_RELATIONSHIP_UUID,
+    });
+    attributes.push({
+      value: nextOfKinContact.contact_name,
+      attributeType: PersonAttributeTypeUuids.NEXT_OF_KIN_NAME_UUID,
+    });
+  }
+  return attributes;
+}
+function getAmrsConceptUuidFromField(fieldName: string): string {
+  let conceptUuid = '';
+  switch (fieldName) {
+    case 'Divorced':
+      conceptUuid = CivilStatusUids.DIVORCED_UUID;
+      break;
+    case 'Married':
+      conceptUuid = CivilStatusUids.MARRIED_UUID;
+      break;
+    case 'Single':
+      conceptUuid = CivilStatusUids.SINGLE_UUID;
+      break;
+    default:
+      conceptUuid = CivilStatusUids.NOT_APPLICABLE_UUID;
+  }
+  return conceptUuid;
+}
+export function generateAmrsCreatePatientIdentifiersPayload(hieClient: HieClient, identifierLocation: string) {
+  const identifiers = [];
+  // add CR number
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(HieIdentificationType.Cr),
+    identifier: hieClient.id,
+    location: identifierLocation,
+  });
+
+  // add main identifier
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(hieClient.identification_type),
+    identifier: hieClient.identification_number,
+    location: identifierLocation,
+  });
+
+  // add other idenfications
+  hieClient.other_identifications.forEach((id) => {
+    identifiers.push({
+      identifierType: getAmrsIdentifierTypeUuid(id.identification_type),
+      identifier: id.identification_number,
+      location: identifierLocation,
+    });
+  });
+
+  return identifiers;
+}
+
+export function getAmrsIdentifierTypeUuid(hieIdentifierName: string) {
+  let idTypeUuid;
+  switch (hieIdentifierName) {
+    case HieIdentificationType.NationalID:
+      idTypeUuid = IdentifierTypesUuids.NATIONAL_ID_UUID;
+      break;
+    case HieIdentificationType.HouseholdNumber:
+      idTypeUuid = IdentifierTypesUuids.HOUSE_HOLD_NUMBER_UUID;
+      break;
+    case HieIdentificationType.AlienID:
+      idTypeUuid = IdentifierTypesUuids.ALIEN_ID_UUID;
+      break;
+    case HieIdentificationType.SHANumber:
+      idTypeUuid = IdentifierTypesUuids.SHA_UUID;
+      break;
+    case HieIdentificationType.MandateNumber:
+      idTypeUuid = IdentifierTypesUuids.MANDATE_NUMBER_UUID;
+      break;
+    case HieIdentificationType.RefugeeID:
+      idTypeUuid = IdentifierTypesUuids.REFUGEE_ID_UUID;
+      break;
+    case HieIdentificationType.Cr:
+      idTypeUuid = IdentifierTypesUuids.CLIENT_REGISTRY_NO_UUID;
+      break;
+    case HieIdentificationType.BirthCertificate:
+      idTypeUuid = IdentifierTypesUuids.BIRTH_CERTIFICATE_NUMBER_UUID;
+      break;
+    case HieIdentificationType.TemporaryDependantID:
+      idTypeUuid = IdentifierTypesUuids.TEMPORARY_DEPENDANT_ID_UUID;
+      break;
+  }
+  return idTypeUuid;
+}

package/src/resources/hie-amrs-automatic-registration.service.ts

@@ -0,0 +1,16 @@
+import { type Patient } from '@openmrs/esm-framework';
+import { type HieClient } from '../registry/types';
+import { generateAmrsPersonPayload } from '../registry/utils/hie-client-adapter';
+import { createPatient, generatePatientIdentifiers } from './patient-resource';
+
+export async function registerHieClientInAmrs(client: HieClient, identifierLocation: string): Promise<Patient> {
+  const createPersonPayload = generateAmrsPersonPayload(client);
+  const identifiers = await generatePatientIdentifiers(identifierLocation, client);
+  const resp = await createPatient({
+    person: createPersonPayload,
+    identifiers: identifiers,
+  });
+
+  const res = await resp.json();
+  return res;
+}

package/src/resources/identifier-types.ts

@@ -0,0 +1,27 @@
+const HOUSE_HOLD_NUMBER_UUID = 'bb74b20e-dcee-4f59-bdf1-2dffc3abf106';
+const SHA_UUID = 'cf5362b2-8049-4442-b3c6-36f870e320cb';
+const CLIENT_REGISTRY_NO_UUID = 'e88dc246-3614-4ee3-8141-1f2a83054e72';
+const NATIONAL_ID_UUID = '58a47054-1359-11df-a1f1-0026b9348838';
+const PROVIDER_NATIONAL_ID_UUID = '4550df92-c684-4597-8ab8-d6b10eabdcfb';
+const REFUGEE_ID_UUID = '465e81af-8d69-47e9-9127-53a94adc75fb';
+const MANDATE_NUMBER_UUID = 'aae2d097-20ba-43ca-9b71-fd8296068f39';
+const ALIEN_ID_UUID = '12f5b147-3403-4a73-913d-7ded9ffec094';
+const TEMPORARY_DEPENDANT_ID_UUID = 'a3d34214-93e8-4faf-bf4d-0272eee079eb';
+const AMRS_UNIVERSAL_ID_UUID = '58a4732e-1359-11df-a1f1-0026b9348838';
+const UPI_NUMBER_UUID = 'cba702b9-4664-4b43-83f1-9ab473cbd64d';
+const BIRTH_CERTIFICATE_NUMBER_UUID = '7924e13b-131a-4da8-8efa-e294184a1b0d';
+
+export const IdentifierTypesUuids = {
+  HOUSE_HOLD_NUMBER_UUID,
+  SHA_UUID,
+  CLIENT_REGISTRY_NO_UUID,
+  NATIONAL_ID_UUID,
+  PROVIDER_NATIONAL_ID_UUID,
+  REFUGEE_ID_UUID,
+  MANDATE_NUMBER_UUID,
+  ALIEN_ID_UUID,
+  TEMPORARY_DEPENDANT_ID_UUID,
+  AMRS_UNIVERSAL_ID_UUID,
+  UPI_NUMBER_UUID,
+  BIRTH_CERTIFICATE_NUMBER_UUID,
+};

package/src/resources/patient-resource.ts

@@ -0,0 +1,60 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type HieClient, type CreatePatientDto, HieIdentificationType } from '../registry/types';
+import { IdentifierTypesUuids } from './identifier-types';
+import { getAmrsIdentifierTypeUuid } from '../registry/utils/hie-client-adapter';
+
+export async function createPatient(payload: CreatePatientDto) {
+  return await openmrsFetch(`${restBaseUrl}/patient`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: payload,
+  });
+}
+
+export const generatePatientIdentifiers = async (identifierLocation: string, client: HieClient) => {
+  const amrsUniverSalId = await generateAmrsUniversalIdentifier();
+  const identifiers = generateAmrsCreatePatientIdentifiersPayload(client, identifierLocation);
+  identifiers.push({
+    identifierType: IdentifierTypesUuids.AMRS_UNIVERSAL_ID_UUID,
+    identifier: amrsUniverSalId,
+    location: identifierLocation,
+    preferred: true,
+  });
+  return identifiers;
+};
+
+export function generateAmrsCreatePatientIdentifiersPayload(hieClient: HieClient, identifierLocation: string) {
+  const identifiers = [];
+  // add CR number
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(HieIdentificationType.Cr),
+    identifier: hieClient.id,
+    location: identifierLocation,
+  });
+
+  // add main identifier
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(hieClient.identification_type),
+    identifier: hieClient.identification_number,
+    location: identifierLocation,
+  });
+  return identifiers;
+}
+
+export async function generateAmrsUniversalIdentifier() {
+  const abortController = new AbortController();
+  const resp = await openmrsFetch(`https://staging.ampath.or.ke/amrs-id-generator/generateidentifier`, {
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    method: 'POST',
+    body: {
+      user: 1,
+    },
+    signal: abortController.signal,
+  });
+  const data = await resp.json();
+  return data['identifier'] ?? '';
+}

package/src/shared/constants/civil-status.ts

@@ -0,0 +1,29 @@
+const SEPARATED_UUID = 'a899aba0-1350-11df-a1f1-0026b9348838';
+const NEVER_MARRIED_UUID = 'a899ac7c-1350-11df-a1f1-0026b9348838';
+const DIVORCED_UUID = 'a899ad58-1350-11df-a1f1-0026b9348838';
+const WIDOWED_UUID = 'a899ae34-1350-11df-a1f1-0026b9348838';
+const MARRIED_UUID = 'a8aa76b0-1350-11df-a1f1-0026b9348838';
+const LIVING_WITH_PARTNER_UUID = 'a899af10-1350-11df-a1f1-0026b9348838';
+const FRIEND_UUID = 'a8aaf07c-1350-11df-a1f1-0026b9348838';
+const NOT_APPLICABLE_UUID = 'a89ad3a4-1350-11df-a1f1-0026b9348838';
+const POLYGAMOUS_UUID = 'a8b03712-1350-11df-a1f1-0026b9348838';
+const PARTNER_UUID = 'a89ebd3e-1350-11df-a1f1-0026b9348838';
+const CASUAL_SEX_PARTNER_UUID = '7831f002-331d-4f07-bf91-6bb65cd31050';
+const OTHER_UUID = 'a8aaf3e2-1350-11df-a1f1-0026b9348838';
+const SINGLE_UUID = 'a899ac7c-1350-11df-a1f1-0026b9348838';
+
+export const CivilStatusUids = {
+  SEPARATED_UUID,
+  NEVER_MARRIED_UUID,
+  DIVORCED_UUID,
+  WIDOWED_UUID,
+  MARRIED_UUID,
+  LIVING_WITH_PARTNER_UUID,
+  FRIEND_UUID,
+  NOT_APPLICABLE_UUID,
+  POLYGAMOUS_UUID,
+  PARTNER_UUID,
+  CASUAL_SEX_PARTNER_UUID,
+  SINGLE_UUID,
+  OTHER_UUID,
+};

package/src/shared/constants/person-attributes.ts

@@ -0,0 +1,33 @@
+const CONTACT_PHONE_NUMBER_UUID = '72a759a8-1359-11df-a1f1-0026b9348838';
+const CITIZENSHIP_UUID = '8d871afc-c2cc-11de-8d13-0010c6dffd0f';
+const CONTACT_EMAIL_ADDRESS_UUID = '2f65dbcb-3e58-45a3-8be7-fd1dc9aa0faa';
+const ALTERNATIVE_CONTACT_PHONE_NUMBER_UUID = 'c725f524-c14a-4468-ac19-4a0e6661c930';
+const KRA_PIN_UUID = 'ae683747-b3fc-4e5c-bad3-c3be743b248f';
+const CIVIL_STATUS_UUID = '8d871f2a-c2cc-11de-8d13-0010c6dffd0f';
+const CLIENT_REGISTRY_ID_UUID = 'e068e02b-faac-4baf-bd58-fe6e0c29a81f';
+const PLACE_OF_BIRTH_UUID = '8d8718c2-c2cc-11de-8d13-0010c6dffd0f';
+const EMAIL_UUID = '2f65dbcb-3e58-45a3-8be7-fd1dc9aa0faa';
+const HIGHEST_LEVEL_OF_EDUCATION_UUID = '352b0d51-63c6-47d0-a295-156bebee4fd5';
+const RELIGION_UUID = '4ae16101-cfba-4c08-9c9c-d848e6f609aa';
+const OCCUPATION_UUID = '9e86409f-9c20-42d0-aeb3-f29a4ca0a7a0';
+const NEXT_OF_KIN_CONTACT_PHONE_NUMBER_UUID = 'a657a4f1-9c0f-444b-a1fd-445bb91dd12d';
+const NEXT_OF_KIN_NAME_UUID = '72a75bec-1359-11df-a1f1-0026b9348838';
+const NEXT_OF_KIN_RELATIONSHIP_UUID = '5730994e-c267-426b-87b6-c152b606973d';
+
+export const PersonAttributeTypeUuids = {
+  CONTACT_PHONE_NUMBER_UUID,
+  CITIZENSHIP_UUID,
+  CONTACT_EMAIL_ADDRESS_UUID,
+  ALTERNATIVE_CONTACT_PHONE_NUMBER_UUID,
+  KRA_PIN_UUID,
+  CIVIL_STATUS_UUID,
+  CLIENT_REGISTRY_ID_UUID,
+  PLACE_OF_BIRTH_UUID,
+  EMAIL_UUID,
+  HIGHEST_LEVEL_OF_EDUCATION_UUID,
+  RELIGION_UUID,
+  OCCUPATION_UUID,
+  NEXT_OF_KIN_CONTACT_PHONE_NUMBER_UUID,
+  NEXT_OF_KIN_NAME_UUID,
+  NEXT_OF_KIN_RELATIONSHIP_UUID,
+};

package/src/side-nav-menu/nav-link-config.ts

@@ -19,24 +19,58 @@ export const navLinksConfig = [
     to: 'consultation',
     title: 'Consultation',
   },
+  {
+    to: 'mch',
+    title: 'MCH',
+    children: [
+      {
+        to: 'triage',
+        title: 'Triage',
+      },
+      {
+        to: 'consultation',
+        title: 'Consultation',
+      },
+    ],
+  },
+  {
+    to: 'admissions',
+    title: 'Admissions',
+  },
+  {
+    to: 'procedures',
+    title: 'Procedures',
+  },
+  {
+    to: 'radiology-imaging',
+    title: 'Radiology and Imaging',
+  },
   {
     to: 'laboratory',
     title: 'Laboratory',
   },
   {
-    to: 'bookings',
-    title: 'Bookings',
+    to: 'pharmacy',
+    title: 'Pharmacy',
   },
   {
-    to: 'reports',
-    title: 'Reports',
+    to: 'mortuary',
+    title: 'Mortuary',
+  },
+  {
+    to: 'accounting',
+    title: 'Accounting',
   },
   {
     to: 'registers',
     title: 'Registers',
   },
   {
-    to: 'pharmacy',
-    title: 'Pharmacy',
+    to: 'reports',
+    title: 'Reports',
+  },
+  {
+    to: 'bookings',
+    title: 'Bookings',
   },
 ];

package/src/side-nav-menu/nav-links.tsx

@@ -2,20 +2,38 @@ import React from 'react';
 import { ConfigurableLink } from '@openmrs/esm-framework';
 import classNames from 'classnames';
 import { navLinksConfig } from './nav-link-config';
+import { SideNavMenu } from '@carbon/react';
 
 interface NavLinksProps {}
 const NavLinks: React.FC<NavLinksProps> = () => {
   return (
     <>
       {navLinksConfig.map((n) => {
-        return (
-          <ConfigurableLink
-            to={`${window.getOpenmrsSpaBase()}home/${n.to}`}
-            className={classNames('cds--side-nav__link', '')}
-          >
-            {n.title}
-          </ConfigurableLink>
-        );
+        if (n.children && n.children.length > 0) {
+          return (
+            <SideNavMenu title={n.title}>
+              {n.children.map((c) => {
+                return (
+                  <ConfigurableLink
+                    to={`${window.getOpenmrsSpaBase()}home/${n.to}/${c.to}`}
+                    className={classNames('cds--side-nav__link', '')}
+                  >
+                    {c.title}
+                  </ConfigurableLink>
+                );
+              })}
+            </SideNavMenu>
+          );
+        } else {
+          return (
+            <ConfigurableLink
+              to={`${window.getOpenmrsSpaBase()}home/${n.to}`}
+              className={classNames('cds--side-nav__link', '')}
+            >
+              {n.title}
+            </ConfigurableLink>
+          );
+        }
       })}
     </>
   );