@kenyaemr/esm-admin-app 5.4.1-pre.2021 → 5.4.1-pre.2025

package/dist/routes.json

@@ -1 +1 @@
-{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemrCharts":"^1.6.7"},"extensions":[{"component":"adminLeftPanelLink","name":"admin-left-panel-link","slot":"admin-left-panel-slot"},{"component":"userManagementLeftPannelLink","name":"user-management-left-panel-link","slot":"admin-left-panel-slot"},{"component":"etlAdministrationLeftPannelLink","name":"etl-administration-left-panel-link","slot":"admin-left-panel-slot"},{"component":"facilitySetupLeftPanelLink","name":"facility-setup-left-panel-link","slot":"admin-left-panel-slot"}],"workspaces":[{"name":"manage-user-workspace","component":"manageUserWorkspace","title":"Manage User Workspace","type":"other-form","canMaximize":true,"width":"extra-wide"},{"name":"user-role-scope-workspace","component":"userRoleScopeWorkspace","title":"User Rple Scope Workspace","type":"other-form","canMaximize":true,"width":"extra-wide"}],"modals":[{"component":"operationConfirmationModal","name":"operation-confirmation-modal"},{"component":"hwrConfirmationModal","name":"hwr-confirmation-modal"},{"component":"hwrEmptyModal","name":"hwr-empty-modal"},{"component":"hwrSyncModal","name":"hwr-syncing-modal"}],"pages":[{"component":"root","route":"admin"}],"version":"5.4.1-pre.2021"}
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemrCharts":"^1.6.7"},"extensions":[{"component":"adminLeftPanelLink","name":"admin-left-panel-link","slot":"admin-left-panel-slot"},{"component":"userManagementLeftPannelLink","name":"user-management-left-panel-link","slot":"admin-left-panel-slot"},{"component":"etlAdministrationLeftPannelLink","name":"etl-administration-left-panel-link","slot":"admin-left-panel-slot"},{"component":"facilitySetupLeftPanelLink","name":"facility-setup-left-panel-link","slot":"admin-left-panel-slot"}],"workspaces":[{"name":"manage-user-workspace","component":"manageUserWorkspace","title":"Manage User Workspace","type":"other-form","canMaximize":true,"width":"extra-wide"},{"name":"user-role-scope-workspace","component":"userRoleScopeWorkspace","title":"User Rple Scope Workspace","type":"other-form","canMaximize":true,"width":"extra-wide"}],"modals":[{"component":"operationConfirmationModal","name":"operation-confirmation-modal"},{"component":"hwrConfirmationModal","name":"hwr-confirmation-modal"},{"component":"hwrEmptyModal","name":"hwr-empty-modal"},{"component":"hwrSyncModal","name":"hwr-syncing-modal"}],"pages":[{"component":"root","route":"admin"}],"version":"5.4.1-pre.2025"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenyaemr/esm-admin-app",
-  "version": "5.4.1-pre.2021",
+  "version": "5.4.1-pre.2025",
   "description": "Facilitates the management of ETL tables",
   "browser": "dist/kenyaemr-esm-admin-app.js",
   "main": "src/index.ts",

package/src/components/modal/hwr-confirmation.modal.tsx

@@ -63,7 +63,10 @@ const HWRConfirmModal: React.FC<HWRConfirmModalProps> = ({ close, onConfirm, hea
               label={t('healthWorkerName', 'Health worker name')}
               value={practitioner?.name?.[0]?.text}
             />
-
+            <HealthWorkerInfo
+              label={t('providerUniqueIdentifier', 'Provider unique identifier')}
+              value={practitioner?.id}
+            />
             {practitioner?.telecom?.map((telecom, index) => (
               <HealthWorkerInfo key={index} label={capitalize(telecom?.system)} value={telecom?.value || '--'} />
             ))}

package/src/components/modal/hwr-sync.modal.tsx

@@ -30,6 +30,7 @@ const HWRSyncModal: React.FC<HWRSyncModalProps> = ({ close, provider }) => {
     qualificationUuid,
     providerAddressUuid,
     providerHieFhirReference,
+    providerUniqueIdentifierAttributeTypeUuid,
   } = config;
 
   const attributeMapping = {
@@ -89,6 +90,7 @@ const HWRSyncModal: React.FC<HWRSyncModalProps> = ({ close, provider }) => {
             ?.valueCodeableConcept?.coding?.[0]?.display,
         nationalId: resource?.identifier?.find((id) => id.type?.coding?.some((code) => code.code === 'national-id'))
           ?.value,
+        providerUniqueIdentifier: resource?.id,
       };
 
       const updatableAttributes = [
@@ -100,6 +102,10 @@ const HWRSyncModal: React.FC<HWRSyncModalProps> = ({ close, provider }) => {
         { attributeType: providerHieFhirReference, value: JSON.stringify(healthWorker) },
         { attributeType: providerAddressUuid, value: extractedAttributes.email },
         { attributeType: providerNationalIdUuid, value: extractedAttributes.nationalId },
+        {
+          attributeType: providerUniqueIdentifierAttributeTypeUuid,
+          value: extractedAttributes.providerUniqueIdentifier,
+        },
       ].filter((attr) => attr.value !== undefined && attr.value !== null && attr.value !== '');
 
       await Promise.all(

package/src/components/users/manage-users/user-details/user-details.component.tsx

@@ -26,6 +26,7 @@ interface ProviderAttributes {
   registrationNumber?: ProviderAttribute;
   emailAddress?: ProviderAttribute;
   passportNumber: ProviderAttribute;
+  providerUniqueIdentifier: ProviderAttribute;
 }
 
 const UserDetails: React.FC<UserDetailsProps> = ({ provider, user }) => {
@@ -41,6 +42,7 @@ const UserDetails: React.FC<UserDetailsProps> = ({ provider, user }) => {
     registrationNumber: 'License Body',
     emailAddress: 'Provider Address',
     passportNumber: 'Provider passport number',
+    providerUniqueIdentifier: 'Provider unique identifier',
   };
 
   const attributes: ProviderAttributes = Object.entries(attributeMap).reduce((acc, [key, display]) => {
@@ -60,6 +62,7 @@ const UserDetails: React.FC<UserDetailsProps> = ({ provider, user }) => {
     registrationNumber,
     emailAddress,
     passportNumber,
+    providerUniqueIdentifier,
   } = attributes;
 
   const formattedExpiryDate = dateAttr?.value ? dayjs(dateAttr.value).format('YYYY-MM-DD') : null;
@@ -104,6 +107,11 @@ const UserDetails: React.FC<UserDetailsProps> = ({ provider, user }) => {
                 <span className={styles.statusTag}>
                   {qualification?.value && <Tag type="cyan">{capitalize(qualification?.value)}</Tag>}
                 </span>
+                <span className={styles.statusTag}>
+                  {providerUniqueIdentifier?.value && (
+                    <Tag type="cyan">{capitalize(providerUniqueIdentifier?.value)}</Tag>
+                  )}
+                </span>
               </div>
             </div>
 
@@ -134,9 +142,13 @@ const UserDetails: React.FC<UserDetailsProps> = ({ provider, user }) => {
                   {t('registrationNumber', 'Registration number')}:{' '}
                   {registrationNumber?.value ? registrationNumber.value : '--'}
                 </span>
+                <span className={styles.middot}>&middot; </span>
+
                 <span className={styles.spanField}>
                   {t('passportNumber', 'Passport number')}: {passportNumber?.value ? passportNumber.value : '--'}
                 </span>
+                <span className={styles.middot}>&middot; </span>
+
                 <span className={styles.spanField}>
                   {t('licenseExpiryDate', 'License expiry date')}: {formattedExpiryDate ? formattedExpiryDate : '--'}
                 </span>

package/src/components/users/manage-users/user-list/user-list.component.tsx

@@ -42,6 +42,7 @@ import styles from './user-list.scss';
 import { ConfigObject } from '../../../../config-schema';
 import { formatDateTime } from '../../../../utils/utils';
 import UserDetails from '../user-details/user-details.component';
+import upperCase from 'lodash-es/upperCase';
 
 type FilterType = 'allUsers' | 'activeLicensed' | 'expiredLicensed' | 'licensedExpiringSoon' | 'unlicensed';
 
@@ -63,8 +64,14 @@ const UserList: React.FC = () => {
   const { users, isLoading: isLoadingUsers, error: usersError } = useUsers();
   const { provider, isLoading, error: providerError } = useProvider();
   const [syncLoading, setSyncLoading] = useState(false);
-  const { licenseNumberUuid, licenseExpiryDateUuid, providerNationalIdUuid, licenseBodyUuid, passportNumberUuid } =
-    useConfig<ConfigObject>();
+  const {
+    licenseNumberUuid,
+    licenseExpiryDateUuid,
+    providerNationalIdUuid,
+    licenseBodyUuid,
+    passportNumberUuid,
+    providerUniqueIdentifierAttributeTypeUuid,
+  } = useConfig<ConfigObject>();
 
   const [pageSize, setPageSize] = useState(10);
   const [searchQuery, setSearchQuery] = useState('');
@@ -198,6 +205,10 @@ const UserList: React.FC = () => {
       key: 'licenseNumber',
       header: t('licenseNumber', 'License Number'),
     },
+    {
+      key: 'providerUniqueIdentifier',
+      header: t('providerUniqueIdentifier', 'Provider Unique Identifier'),
+    },
     {
       key: 'licenseExpiryDate',
       header: t('licenseExpiryDate', 'License Expiry Date'),
@@ -221,6 +232,11 @@ const UserList: React.FC = () => {
     const licenseNumber = licenseNumberAttribute ? licenseNumberAttribute.value : '--';
     const licenseExpiryDate = licenseExpiryDateAttribute ? licenseExpiryDateAttribute.value : '--';
 
+    const providerUniqueIdentifierAttribute = userProvider?.attributes.find(
+      (attr) => attr?.attributeType?.uuid === providerUniqueIdentifierAttributeTypeUuid,
+    );
+    const providerUniqueIdentifier = providerUniqueIdentifierAttribute ? providerUniqueIdentifierAttribute.value : '--';
+
     const providerNationalId = userProvider?.attributes.find(
       (attr) => attr?.attributeType?.uuid === providerNationalIdUuid,
     );
@@ -232,9 +248,10 @@ const UserList: React.FC = () => {
     return {
       id: user.uuid,
       systemId: user.systemId,
-      names: capitalize(user.person.display),
+      names: upperCase(user.person.display),
       licenseNumber: licenseNumber,
       licenseExpiryDate: formatDateTime(new Date(licenseExpiryDate)),
+      providerUniqueIdentifier: providerUniqueIdentifier,
       userProvider,
       user,
       actions: (

package/src/components/users/manage-users/user-management.workspace.tsx

@@ -101,6 +101,7 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
     providerNationalIdUuid,
     licenseNumberUuid,
     licenseExpiryDateUuid,
+    providerUniqueIdentifierAttributeTypeUuid,
   } = useConfig<ConfigObject>();
   const [searchHWR, setSearchHWR] = useState({
     identifierType: identifierTypes[0]?.key ?? '',
@@ -121,6 +122,8 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
       phoneNumber: providerAttributeType.find((type) => type.uuid === phoneNumberUuid)?.uuid || '',
       providerAddress: providerAttributeType.find((type) => type.uuid === providerAddressUuid)?.uuid || '',
       passportNumber: providerAttributeType.find((type) => type.uuid === passportNumberUuid)?.uuid || '',
+      providerUniqueIdentifier:
+        providerAttributeType.find((type) => type.uuid === providerUniqueIdentifierAttributeTypeUuid)?.uuid || '',
     };
   }, [
     licenseBodyUuid,
@@ -133,6 +136,7 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
     providerHieFhirReference,
     providerNationalIdUuid,
     qualificationUuid,
+    providerUniqueIdentifierAttributeTypeUuid,
   ]);
 
   const providerAttributes = useMemo(() => provider.flatMap((item) => item.attributes || []), [provider]);
@@ -176,6 +180,10 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
     () => getProviderAttributeValue(attributeTypeMapping.providerAddress),
     [attributeTypeMapping, getProviderAttributeValue],
   );
+  const providerUniqueIdentifier = useMemo(
+    () => getProviderAttributeValue(attributeTypeMapping.providerUniqueIdentifier),
+    [attributeTypeMapping, getProviderAttributeValue],
+  );
   type UserFormSchema = z.infer<typeof userManagementFormSchema>;
   const formDefaultValues = useMemo(() => {
     if (isInitialValuesEmpty) {
@@ -208,6 +216,7 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
       nationalId: nationalId,
       passportNumber: passportNumber,
       registrationNumber: registrationNumber,
+      providerUniqueIdentifier: providerUniqueIdentifier,
     };
   }, [
     isInitialValuesEmpty,
@@ -220,6 +229,7 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
     nationalId,
     passportNumber,
     registrationNumber,
+    providerUniqueIdentifier,
   ]);
 
   function extractAttributeValue(attributes, prefix: string) {
@@ -330,6 +340,7 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
             ),
           );
           setValue('passportNumber', healthWorkerPassPortNumber);
+          setValue('providerUniqueIdentifier', fetchedHealthWorker?.entry[0]?.resource?.id);
           setHealthWorker(fetchedHealthWorker);
         },
       });
@@ -356,6 +367,10 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
           attributeType: attributeTypeMapping?.providerHieFhirReference,
           value: JSON.stringify(healthWorker),
         },
+        {
+          attributeType: attributeTypeMapping.providerUniqueIdentifier,
+          value: data.providerUniqueIdentifier,
+        },
         {
           attributeType: attributeTypeMapping.providerNationalId,
           value: data.nationalId,
@@ -446,6 +461,10 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
               attributeType: passportNumberUuid,
               value: data?.passportNumber,
             },
+            {
+              attributeType: providerUniqueIdentifierAttributeTypeUuid,
+              value: data?.providerUniqueIdentifier,
+            },
           ].filter((attr) => attr?.value !== undefined && attr?.value !== null && attr?.value !== '');
 
           await Promise.all(
@@ -747,6 +766,26 @@ const ManageUserWorkspace: React.FC<ManageUserWorkspaceProps> = ({
                     {hasProviderAccount && (
                       <ResponsiveWrapper>
                         <span className={styles.formHeaderSection}>{t('providerDetails', 'Provider details')}</span>
+                        <ResponsiveWrapper>
+                          <Controller
+                            name="providerUniqueIdentifier"
+                            control={userFormMethods.control}
+                            render={({ field }) => (
+                              <TextInput
+                                {...field}
+                                id="providerUniqueIdentifier"
+                                type="text"
+                                labelText={t('providerUniqueIdentifier', 'Provider Unique Identifier')}
+                                placeholder={t(
+                                  'providerUniqueIdentifierPlaceholder',
+                                  'Enter Provider Unqiue Identifier',
+                                )}
+                                invalid={!!errors.providerUniqueIdentifier}
+                                invalidText={errors.providerUniqueIdentifier?.message}
+                              />
+                            )}
+                          />
+                        </ResponsiveWrapper>
                         <ResponsiveWrapper>
                           <Controller
                             name="nationalId"

package/src/components/users/userManagementFormSchema.tsx

@@ -43,6 +43,7 @@ const UserManagementFormSchema = (existingUsernames: Array<string>, isEdit?: boo
     nationalId: z.string().optional(),
     passportNumber: z.string().optional(),
     isEditProvider: z.boolean().optional(),
+    providerUniqueIdentifier: z.string().optional(),
   });
 
   return { userManagementFormSchema };

package/src/config-schema.ts

@@ -57,6 +57,11 @@ export const configSchema = {
     _description: 'UUID for person phone number attribute',
     _default: 'b2c38640-2603-4629-aebd-3b54f33f1e3a',
   },
+  providerUniqueIdentifierAttributeTypeUuid: {
+    _type: Type.String,
+    _description: 'UUID for provider unique identifier attribute type',
+    _default: 'dace9d99-9f29-4653-9eae-c05929f34a32',
+  },
   identifierTypes: {
     _type: Type.Array,
     _elements: {
@@ -84,6 +89,7 @@ export interface ConfigObject {
   providerNationalIdUuid: string;
   passportNumberUuid: string;
   providerHieFhirReference: string;
+  providerUniqueIdentifierAttributeTypeUuid: string;
   phoneNumberUuid: string;
   providerAddressUuid: string;
   qualificationUuid: string;

package/translations/en.json

@@ -66,6 +66,7 @@
   "phoneNumber": "Phone number",
   "previousPage": "Previous page",
   "procedure": "Procedure",
+  "providerUniqueIdentifier": "Provider Unique Identifier",
   "recreated": "recreated",
   "recreateDatatools": "Recreate datatools",
   "recreateFacilityWideTables": "Recreate facility wide tables",