jembi · MatthewErispe · Sep 11, 2024 · Sep 2, 2024 · Sep 4, 2024 · Sep 4, 2024
diff --git a/documentation/.gitbook/assets/19.png b/documentation/.gitbook/assets/19.png
diff --git a/documentation/.gitbook/assets/20.png b/documentation/.gitbook/assets/20.png
diff --git a/documentation/.gitbook/assets/21.png b/documentation/.gitbook/assets/21.png
diff --git a/documentation/.gitbook/assets/22.png b/documentation/.gitbook/assets/22.png
diff --git a/documentation/.gitbook/assets/23.png b/documentation/.gitbook/assets/23.png
diff --git a/documentation/.gitbook/assets/24.png b/documentation/.gitbook/assets/24.png
diff --git a/documentation/.gitbook/assets/25.png b/documentation/.gitbook/assets/25.png
diff --git a/documentation/.gitbook/assets/26.png b/documentation/.gitbook/assets/26.png
diff --git a/documentation/.gitbook/assets/27.png b/documentation/.gitbook/assets/27.png
diff --git a/documentation/.gitbook/assets/28.png b/documentation/.gitbook/assets/28.png
diff --git a/documentation/.gitbook/assets/29.png b/documentation/.gitbook/assets/29.png
diff --git a/documentation/.gitbook/assets/30.png b/documentation/.gitbook/assets/30.png
diff --git a/documentation/.gitbook/assets/31.png b/documentation/.gitbook/assets/31.png
diff --git a/documentation/.gitbook/assets/32.png b/documentation/.gitbook/assets/32.png
diff --git a/documentation/.gitbook/assets/33.png b/documentation/.gitbook/assets/33.png
diff --git a/documentation/.gitbook/assets/34.png b/documentation/.gitbook/assets/34.png
diff --git a/documentation/.gitbook/assets/35.png b/documentation/.gitbook/assets/35.png
diff --git a/documentation/.gitbook/assets/36.png b/documentation/.gitbook/assets/36.png
diff --git a/documentation/.gitbook/assets/37.png b/documentation/.gitbook/assets/37.png
diff --git a/documentation/.gitbook/assets/38.png b/documentation/.gitbook/assets/38.png
diff --git a/documentation/.gitbook/assets/40.png b/documentation/.gitbook/assets/40.png
diff --git a/documentation/.gitbook/assets/41.png b/documentation/.gitbook/assets/41.png
diff --git a/documentation/.gitbook/assets/42.png b/documentation/.gitbook/assets/42.png
diff --git a/documentation/.gitbook/assets/43.png b/documentation/.gitbook/assets/43.png
diff --git a/documentation/.gitbook/assets/44.png b/documentation/.gitbook/assets/44.png
diff --git a/documentation/.gitbook/assets/45.png b/documentation/.gitbook/assets/45.png
diff --git a/documentation/.gitbook/assets/46.png b/documentation/.gitbook/assets/46.png
diff --git a/documentation/.gitbook/assets/47.png b/documentation/.gitbook/assets/47.png
diff --git a/documentation/.gitbook/assets/48.png b/documentation/.gitbook/assets/48.png
diff --git a/documentation/.gitbook/assets/49.png b/documentation/.gitbook/assets/49.png
diff --git a/documentation/.gitbook/assets/50.png b/documentation/.gitbook/assets/50.png
diff --git a/documentation/.gitbook/assets/51.png b/documentation/.gitbook/assets/51.png
diff --git a/documentation/.gitbook/assets/52.png b/documentation/.gitbook/assets/52.png
diff --git a/documentation/.gitbook/assets/53.png b/documentation/.gitbook/assets/53.png
diff --git a/documentation/.gitbook/assets/54.png b/documentation/.gitbook/assets/54.png
diff --git a/documentation/.gitbook/assets/55.png b/documentation/.gitbook/assets/55.png
diff --git a/documentation/.gitbook/assets/56.png b/documentation/.gitbook/assets/56.png
diff --git a/documentation/.gitbook/assets/57.png b/documentation/.gitbook/assets/57.png
diff --git a/documentation/.gitbook/assets/58.png b/documentation/.gitbook/assets/58.png
diff --git a/documentation/.gitbook/assets/59.png b/documentation/.gitbook/assets/59.png
diff --git a/documentation/.gitbook/assets/60.png b/documentation/.gitbook/assets/60.png
diff --git a/documentation/.gitbook/assets/61.png b/documentation/.gitbook/assets/61.png
diff --git a/documentation/.gitbook/assets/62.png b/documentation/.gitbook/assets/62.png
diff --git a/documentation/.gitbook/assets/63.png b/documentation/.gitbook/assets/63.png
diff --git a/documentation/.gitbook/assets/64.png b/documentation/.gitbook/assets/64.png
diff --git a/documentation/.gitbook/assets/65.png b/documentation/.gitbook/assets/65.png
diff --git a/documentation/.gitbook/assets/66.png b/documentation/.gitbook/assets/66.png
diff --git a/documentation/.gitbook/assets/67.png b/documentation/.gitbook/assets/67.png
diff --git a/documentation/SUMMARY.md b/documentation/SUMMARY.md
@@ -8,3 +8,4 @@
 * [API](api.md)
 * [Single Sign-On](sso.md)
 * [Backup and Restore](backup-and-restore.md)
+* [UI User Guide](ui-user-guide.md)
diff --git a/documentation/backup-and-restore.md b/documentation/backup-and-restore.md
@@ -42,7 +42,7 @@ JeMPI/devops/linux/docker/backup_restore/postgres-backup.sh
 
 The backup process creates a folder with a timestamp. Inside this folder, backups are created for each Dgraph and Postgres.
 
-![Backup Postgres and Dgraph](../.gitbook/assets/14)
+![Backup Postgres and Dgraph](.gitbook/assets/14)
 
 ## Restore Dgraph and Postgres Process
 
@@ -61,4 +61,4 @@ Select Option 6: Restore Postgres & Dgraph
 - **Backup Directory Postgres:** JeMPI/devops/linux/docker/docker_data/data/backups/postgres
 - **Manual Backup Run Script:** ./restore-dgraph-postgres.sh {{ Folder_Name }}
 
-![Restore Postgres and Dgraph](../.gitbook/assets/15)
+![Restore Postgres and Dgraph](.gitbook/assets/15)
diff --git a/documentation/sso.md b/documentation/sso.md
@@ -42,13 +42,13 @@ cd devops/linux/docker/deployment
 ./local-deployment.sh
 ```
 
-![Deployment Script Options](../.gitbook/assets/13)
+![Deployment Script Options](.gitbook/assets/13)
 
 4. Select Option 1: Deploy JeMPI (For Fresh Start)
 6. Access : http://localhost:3000/login
 
-![JeMPI Web Keycloak Sign in](../.gitbook/assets/16)
+![JeMPI Web Keycloak Sign in](.gitbook/assets/16)
 
 7. Sign in with Keycloak user credentials
 
-![JeMPI Web Keycloak Sign in](../.gitbook/assets/17)
+![JeMPI Web Keycloak Sign in](.gitbook/assets/17)
diff --git a/documentation/ui-user-guide.md b/documentation/ui-user-guide.md
diff --git a/documentation/user-interface-user-guide.md b/documentation/user-interface-user-guide.md
@@ -0,0 +1,102 @@
+**Configuration Settings**
+The configuration settings screen enables the user to make edits to the default settings, the best fit the desired implementation of the MPI.
+
+![Configuration Settings](.gitbook/assets/27.png)
+
+**Common Properties**
+This tab defines the demographic details for a patient that will be used for linking.
+![Common Properties](.gitbook/assets/19)
+
+**The user can do the following:**
+- Select the Edit icon button to initiate edit mode on a row for the common properties.
+When the row is in edit mode the following changes occur :
+The colour of the row changes to white 
+The edit icon changes to show a save icon and a close icon
+![Common Properties Edit Mode](.gitbook/assets/20)
+
+-Choose to select the close button to exit edit mode.
+-Choose to select the save icon button to save changes made and exit edit mode.
+-Edit the relevant fields and select the save button to save changes on the current tab.
+
+**Deterministic**
+The deterministic tab  is used to define the deterministic rules. 
+
+The deterministic tab has three sub tabs : 
+- Linking
+- Validate 
+- Matching 
+
+**Source view**
+ this view allows the user to do the following :
+- View the displayed rules
+- Click edit mode by clicking the edit icon button which opens up the design view
+- Click add icon button which initiates edit mode ,  switches to design - - View tab (If there are no existing rules on display)
+![Determistic Source View](.gitbook/assets/21)
+
+**Design view**
+this view allows the user to do the following :
+- Select the operator values from a drop down field eg “And” and “Or”
+- Select common field values from a drop down field
+- Select comparator function from a drop down field eg “Exact”, “Low Fuzziness” etc
+- Add a second row of input fields by selecting the add add icon button
+- Save rule by selecting the add rule button
+- Exit edit mode and cancel previous edits.
+- Delete existing row of input fields
+![Determistic Design View](.gitbook/assets/22)
+
+**Blocking**
+The blocking tab  is used to define the blocking rules. 
+
+The blocking tabs has two sub tabs : 
+- Linking 
+- Matching 
+
+The blocking sub tabs  have two different views :
+
+Source view 
+This view allows the user to do the following :
+- View the displayed rules
+- Click edit mode by clicking the edit icon button which opens up the design view
+- Click add icon button which initiates edit mode ,  switches to design view tab (If there are no existing rules on display)
+![Blocking Source View](.gitbook/assets/23)
+
+**Design view**
+This view must allows the user to do the following :
+
+- Select the operator values from a drop down field eg “And” and “Or”
+- Select common field values from a drop down field.
+- Select comparator function from a drop down field eg “Exact”, “Low Fuzziness” etc
+- Add a second row of input fields by selecting the add add icon button
+- Save rule by selecting the add rule button
+- Exit edit mode and cancel previous edits.
+- Delete existing row of input fields
+![Blocking Design View](.gitbook/assets/25)
+
+**Probabilistic**
+   In the Probabilistic tab the user can  define the linking threshold ranges and/or values. 
+
+All values must be entered as per the rules defined.
+![Probabilistic Tab](.gitbook/assets/26)
+
+**Rules on threshold slider**
+- Do not allow the link threshold (green circle):
+To be < the Minimum threshold review value
+To be > the Maximum threshold review value
+
+**Rules on Threshold**
+For all threshold values that are entered, system allows for exponential notation e.g. 123E-3 which is the same as 0.012
+System display default values 
+
+**Nodes**
+This section displays the following  : 
+- Golden record node
+- Interaction node
+- Source ID
+
+![Nodes](.gitbook/assets/28)
+
+Golden record node shows properties unique to the golden record.
+Interaction node shows properties unique to the interaction.
+Source ID : The third node denoted e.g Source ID, shows unique common lists e.g 
+- Source ID list
+- Biometric ID list