@openmrs/esm-fast-data-entry-app 1.0.0-pre.59 → 1.0.0

package/src/form-entry-workflow/FormEntryWorkflow.tsx

@@ -1,107 +1,22 @@
-import {
-  ExtensionSlot,
-  getGlobalStore,
-  useStore,
-} from "@openmrs/esm-framework";
-import {
-  Button,
-  ComposedModal,
-  ModalBody,
-  ModalFooter,
-  ModalHeader,
-} from "carbon-components-react";
-import React, { useContext, useState } from "react";
-import { useHistory } from "react-router-dom";
-import FormBootstrap from "../FormBootstrap";
-import PatientCard from "../patient-card/PatientCard";
-import PatientBanner from "../patient-banner";
-import styles from "./styles.scss";
-import PatientSearchHeader from "../patient-search-header";
-import { useTranslation } from "react-i18next";
-import FormWorkflowContext, {
-  FormWorkflowProvider,
-} from "../context/FormWorkflowContext";
-import WorkflowReview from "../workflow-review";
-
-const formStore = getGlobalStore("ampath-form-state");
-
-const CancelModal = ({ open, setOpen }) => {
-  const { destroySession, closeSession } = useContext(FormWorkflowContext);
-  const { t } = useTranslation();
-  const history = useHistory();
-
-  const discard = () => {
-    destroySession();
-    setOpen(false);
-    history.push("/");
-  };
-
-  const saveAndClose = () => {
-    closeSession();
-    setOpen(false);
-    history.push("/");
-  };
-
-  return (
-    <ComposedModal open={open}>
-      <ModalHeader>{t("areYouSure", "Are you sure?")}</ModalHeader>
-      <ModalBody>
-        {t(
-          "cancelExplanation",
-          "You will lose any unsaved changes on the current form. Do you want to discard the current session?"
-        )}
-      </ModalBody>
-      <ModalFooter>
-        <Button kind="secondary" onClick={() => setOpen(false)}>
-          {t("cancel", "Cancel")}
-        </Button>
-        <Button kind="danger" onClick={discard}>
-          {t("discard", "Discard")}
-        </Button>
-        <Button kind="primary" onClick={saveAndClose}>
-          {t("saveSession", "Save Session")}
-        </Button>
-      </ModalFooter>
-    </ComposedModal>
-  );
-};
-
-const CompleteModal = ({ open, setOpen }) => {
-  const { submitForComplete } = useContext(FormWorkflowContext);
-  const { t } = useTranslation();
-
-  const completeSession = () => {
-    submitForComplete();
-    setOpen(false);
-  };
-
-  return (
-    <ComposedModal open={open}>
-      <ModalHeader>{t("areYouSure", "Are you sure?")}</ModalHeader>
-      <ModalBody>
-        {t(
-          "saveExplanation",
-          "Do you want to save the current form and exit the workflow?"
-        )}
-      </ModalBody>
-      <ModalFooter>
-        <Button kind="secondary" onClick={() => setOpen(false)}>
-          {t("cancel", "Cancel")}
-        </Button>
-        <Button kind="primary" onClick={completeSession}>
-          {t("complete", "Complete")}
-        </Button>
-      </ModalFooter>
-    </ComposedModal>
-  );
-};
+import { ExtensionSlot, useSession } from '@openmrs/esm-framework';
+import { Button } from '@carbon/react';
+import React, { useCallback, useContext, useEffect, useState } from 'react';
+import FormBootstrap from '../FormBootstrap';
+import PatientCard from '../patient-card/PatientCard';
+import styles from './styles.scss';
+import PatientSearchHeader from './patient-search-header';
+import { useTranslation } from 'react-i18next';
+import { v4 as uuid } from 'uuid';
+import FormWorkflowContext, { FormWorkflowProvider } from '../context/FormWorkflowContext';
+import WorkflowReview from './workflow-review';
+import PatientBanner from './patient-banner';
+import CompleteModal from '../CompleteModal';
+import CancelModal from '../CancelModal';
+import useStartVisit from '../hooks/useStartVisit';
 
 const WorkflowNavigationButtons = () => {
-  const { activeFormUuid, submitForNext, workflowState, destroySession } =
-    useContext(FormWorkflowContext);
-  const store = useStore(formStore);
-  const formState = store[activeFormUuid];
-  const navigationDisabled = formState !== "ready";
+  const context = useContext(FormWorkflowContext);
+  const { workflowState, destroySession } = context;
   const [cancelModalOpen, setCancelModalOpen] = useState(false);
   const [completeModalOpen, setCompleteModalOpen] = useState(false);
   const { t } = useTranslation();
@@ -111,29 +26,18 @@ const WorkflowNavigationButtons = () => {
   return (
     <>
       <div className={styles.rightPanelActionButtons}>
-        <Button
-          kind="primary"
-          onClick={() => submitForNext()}
-          disabled={navigationDisabled || workflowState === "NEW_PATIENT"}
-        >
-          {t("nextPatient", "Next Patient")}
-        </Button>
         <Button
           kind="secondary"
-          onClick={
-            workflowState === "NEW_PATIENT"
-              ? () => destroySession()
-              : () => setCompleteModalOpen(true)
-          }
+          onClick={workflowState === 'NEW_PATIENT' ? () => destroySession() : () => setCompleteModalOpen(true)}
         >
-          {t("saveAndComplete", "Save & Complete")}
+          {t('saveAndComplete', 'Save & Complete')}
         </Button>
         <Button kind="tertiary" onClick={() => setCancelModalOpen(true)}>
-          {t("cancel", "Cancel")}
+          {t('cancel', 'Cancel')}
         </Button>
       </div>
-      <CancelModal open={cancelModalOpen} setOpen={setCancelModalOpen} />
-      <CompleteModal open={completeModalOpen} setOpen={setCompleteModalOpen} />
+      <CancelModal open={cancelModalOpen} setOpen={setCancelModalOpen} context={context} />
+      <CompleteModal open={completeModalOpen} setOpen={setCompleteModalOpen} context={context} />
     </>
   );
 };
@@ -145,21 +49,72 @@ const FormWorkspace = () => {
     activeEncounterUuid,
     saveEncounter,
     activeFormUuid,
+    editEncounter,
+    encounters,
+    singleSessionVisitTypeUuid,
   } = useContext(FormWorkflowContext);
   const { t } = useTranslation();
 
+  const [encounter, setEncounter] = useState(null);
+  const [visit, setVisit] = useState(null);
+  const { sessionLocation } = useSession();
+
+  const { updateEncounter, success: visitSaveSuccess } = useStartVisit({
+    showSuccessNotification: false,
+    showErrorNotification: true,
+  });
+
   const handlePostResponse = (encounter) => {
     if (encounter && encounter.uuid) {
       saveEncounter(encounter.uuid);
+      setEncounter(encounter);
     }
   };
 
+  useEffect(() => {
+    if (encounter && visit) {
+      // Update encounter so that it belongs to the created visit
+      updateEncounter({ uuid: encounter.uuid, visit: visit.uuid });
+    }
+  }, [encounter, visit, updateEncounter]);
+
+  useEffect(() => {
+    if (visitSaveSuccess) {
+      setVisit(visitSaveSuccess.data);
+    }
+  }, [visitSaveSuccess]);
+
+  const handleEncounterCreate = useCallback(
+    (payload) => {
+      payload.location = sessionLocation?.uuid;
+      payload.encounterDatetime = payload.encounterDatetime ? payload.encounterDatetime : new Date().toISOString();
+      // Create a visit with the same date as the encounter being saved
+      const visitStartDatetime = new Date(payload.encounterDatetime);
+      const visitStopDatetime = new Date(payload.encounterDatetime);
+      const visitInfo = {
+        startDatetime: visitStartDatetime,
+        stopDatetime: visitStopDatetime,
+        uuid: uuid(),
+        patient: {
+          uuid: activePatientUuid,
+        },
+        location: {
+          uuid: sessionLocation?.uuid,
+        },
+        visitType: {
+          uuid: singleSessionVisitTypeUuid,
+        },
+      };
+
+      payload.visit = visitInfo;
+    },
+    [activePatientUuid, singleSessionVisitTypeUuid, sessionLocation],
+  );
+
   return (
     <div className={styles.workspace}>
       {!patientUuids.length && (
-        <div className={styles.selectPatientMessage}>
-          {t("selectPatientFirst", "Please select a patient first")}
-        </div>
+        <div className={styles.selectPatientMessage}>{t('selectPatientFirst', 'Please select a patient first')}</div>
       )}
       {!!patientUuids.length && (
         <div className={styles.formMainContent}>
@@ -170,14 +125,23 @@ const FormWorkspace = () => {
               {...{
                 formUuid: activeFormUuid,
                 handlePostResponse,
+                handleEncounterCreate,
               }}
             />
           </div>
           <div className={styles.rightPanel}>
-            <h4>Forms filled</h4>
+            <h4>{t('formsFilled', 'Forms filled')}</h4>
             <div className={styles.patientCardsSection}>
               {patientUuids.map((patientUuid) => (
-                <PatientCard patientUuid={patientUuid} key={patientUuid} />
+                <PatientCard
+                  key={patientUuid}
+                  {...{
+                    patientUuid,
+                    activePatientUuid,
+                    editEncounter,
+                    encounters,
+                  }}
+                />
               ))}
             </div>
             <WorkflowNavigationButtons />
@@ -195,8 +159,8 @@ const FormEntryWorkflow = () => {
       <div className={styles.breadcrumbsContainer}>
         <ExtensionSlot extensionSlotName="breadcrumbs-slot" />
       </div>
-      {workflowState === "REVIEW" && <WorkflowReview />}
-      {workflowState !== "REVIEW" && (
+      {workflowState === 'REVIEW' && <WorkflowReview />}
+      {workflowState !== 'REVIEW' && (
         <>
           <PatientSearchHeader />
           <PatientBanner />

package/src/{form-review-card → form-entry-workflow/form-review-card}/FormReviewCard.tsx

@@ -1,9 +1,9 @@
-import { Accordion, AccordionItem, Button } from "carbon-components-react";
-import React, { useContext } from "react";
-import { useTranslation } from "react-i18next";
-import FormWorkflowContext from "../context/FormWorkflowContext";
-import { useGetPatient, useGetEncounter } from "../hooks";
-import styles from "./styles.scss";
+import { Accordion, AccordionItem, Button } from '@carbon/react';
+import React, { useContext } from 'react';
+import { useTranslation } from 'react-i18next';
+import FormWorkflowContext from '../../context/FormWorkflowContext';
+import { useGetPatient, useGetEncounter } from '../../hooks';
+import styles from './styles.scss';
 
 const FormReviewCard = ({ patientUuid }) => {
   const { encounters, editEncounter } = useContext(FormWorkflowContext);
@@ -39,7 +39,7 @@ const FormReviewCard = ({ patientUuid }) => {
             </div>
           )}
           <Button kind="primary" onClick={() => editEncounter(patientUuid)}>
-            {t("goToForm", "Go To Form")}
+            {t('goToForm', 'Go To Form')}
           </Button>
         </AccordionItem>
       </Accordion>

package/src/form-entry-workflow/form-review-card/index.ts

@@ -0,0 +1,3 @@
+import FormReviewCard from './FormReviewCard';
+
+export default FormReviewCard;

package/src/form-entry-workflow/form-review-card/styles.scss

@@ -0,0 +1,37 @@
+@use '@carbon/colors';
+@use '@carbon/layout';
+@use '@carbon/type';
+
+.formReviewCard {
+  background-color: colors.$white-0;
+  padding: layout.$spacing-02;
+}
+
+.formReviewCard :global(.cds--accordion) :global(.cds--accordion__item) {
+  border: none;
+}
+
+.formReviewCard :global(.cds--accordion__title) {
+  display: flex;
+  align-items: baseline;
+  column-gap: layout.$spacing-05;
+}
+
+.formReviewCard :global(.cds--accordion__content) {
+  padding: layout.$spacing-03;
+}
+
+.dataField {
+  @include type.type-style('code-02');
+  background-color: colors.$gray-10;
+  padding: layout.$spacing-03;
+}
+
+.displayName {
+  @include type.type-style('heading-02');
+  font-weight: bold;
+}
+
+.identifier {
+  @include type.type-style('body-compact-01')
+}

package/src/form-entry-workflow/index.ts

@@ -1,3 +1,3 @@
-import FormEntryWorkflow from "./FormEntryWorkflow";
+import FormEntryWorkflow from './FormEntryWorkflow';
 
 export default FormEntryWorkflow;

package/src/form-entry-workflow/patient-banner/PatientBanner.test.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+import { render } from '@testing-library/react';
+import PatientBanner from './PatientBanner';
+
+describe('PatientBanner', () => {
+  it('renders placeholder information when no data is present', () => {
+    render(<PatientBanner />);
+  });
+});

package/src/{patient-banner → form-entry-workflow/patient-banner}/PatientBanner.tsx

@@ -1,10 +1,10 @@
-import { age, ExtensionSlot } from "@openmrs/esm-framework";
-import { SkeletonPlaceholder, SkeletonText } from "carbon-components-react";
-import React, { useContext } from "react";
-import styles from "./styles.scss";
-import { useTranslation } from "react-i18next";
-import useGetPatient from "../hooks/useGetPatient";
-import FormWorkflowContext from "../context/FormWorkflowContext";
+import { age, ExtensionSlot } from '@openmrs/esm-framework';
+import { SkeletonPlaceholder, SkeletonText } from '@carbon/react';
+import React, { useContext } from 'react';
+import styles from './styles.scss';
+import { useTranslation } from 'react-i18next';
+import useGetPatient from '../../hooks/useGetPatient';
+import FormWorkflowContext from '../../context/FormWorkflowContext';
 
 const SkeletonPatientInfo = () => {
   return (
@@ -36,16 +36,14 @@ const PatientBanner = () => {
   const { activePatientUuid, workflowState } = useContext(FormWorkflowContext);
   const patient = useGetPatient(activePatientUuid);
   const { t } = useTranslation();
-  const patientName = `${patient?.name?.[0].given?.join(" ")} ${
-    patient?.name?.[0]?.family
-  }`;
+  const patientName = `${patient?.name?.[0].given?.join(' ')} ${patient?.name?.[0]?.family}`;
 
   const patientPhotoSlotState = React.useMemo(
-    () => ({ patientUuid: patient?.id, patientName, size: "small" }),
-    [patient?.id, patientName]
+    () => ({ patientUuid: patient?.id, patientName, size: 'small' }),
+    [patient?.id, patientName],
   );
 
-  if (workflowState === "NEW_PATIENT") return null;
+  if (workflowState === 'NEW_PATIENT') return null;
 
   if (!patient) {
     return <SkeletonPatientInfo />;
@@ -53,29 +51,18 @@ const PatientBanner = () => {
 
   return (
     <div className={styles.container}>
-      <ExtensionSlot
-        extensionSlotName="patient-photo-slot"
-        state={patientPhotoSlotState}
-      />
+      <ExtensionSlot extensionSlotName="patient-photo-slot" state={patientPhotoSlotState} />
       <div className={styles.patientInfoContent}>
         <div className={styles.patientInfoRow}>
           <span className={styles.patientName}>{patientName}</span>
         </div>
         <div className={styles.patientInfoRow}>
-          <span>
-            {(patient.gender ?? t("unknown", "Unknown")).replace(/^\w/, (c) =>
-              c.toUpperCase()
-            )}
-          </span>
+          <span>{(patient.gender ?? t('unknown', 'Unknown')).replace(/^\w/, (c) => c.toUpperCase())}</span>
           <span>&middot;</span>
           <span>{age(patient.birthDate)}</span>
           <span>&middot;</span>
           <span>
-            {patient.identifier.length
-              ? patient.identifier
-                  .map((identifier) => identifier.value)
-                  .join(", ")
-              : "--"}
+            {patient.identifier.length ? patient.identifier.map((identifier) => identifier.value).join(', ') : '--'}
           </span>
         </div>
       </div>

package/src/form-entry-workflow/patient-banner/index.ts

@@ -0,0 +1,3 @@
+import PatientBanner from './PatientBanner';
+
+export default PatientBanner;

package/src/form-entry-workflow/patient-banner/styles.scss

@@ -0,0 +1,44 @@
+@use '@carbon/colors';
+@use '@carbon/layout';
+@use '@carbon/type';
+
+.container {
+  height: layout.$spacing-11;
+  display: flex;
+  align-items: center;
+  background-color: colors.$white-0;
+  border-top: 0.0125rem solid colors.$gray-20;
+  border-bottom: 0.0125rem solid colors.$gray-20;
+  padding: 0 layout.$spacing-05;
+}
+
+.photoPlaceholder {
+  height: 48px;
+  width: 48px;
+}
+
+.patientName {
+  @include type.type-style('heading-03');
+  font-weight: 600;
+}
+
+.patientInfoContent {
+  width: 100%;
+  margin-left: 1rem;
+}
+
+.patientInfoRow {
+  display: flex;
+  align-items: center;
+  & > button {
+    min-height: 2rem;
+  }
+  @include type.type-style('body-compact-02');
+  color: colors.$gray-70;
+  column-gap: 0.8rem;
+}
+
+.patientEditBtn {
+  color: colors.$gray-100;
+  margin: layout.$spacing-03;
+}

package/src/form-entry-workflow/patient-search-header/PatientSearchHeader.tsx

@@ -0,0 +1,54 @@
+import { Add, Close } from '@carbon/react/icons';
+import { ExtensionSlot, interpolateUrl, navigate } from '@openmrs/esm-framework';
+import { Button } from '@carbon/react';
+import React, { useContext } from 'react';
+import { Link } from 'react-router-dom';
+import FormWorkflowContext from '../../context/FormWorkflowContext';
+import styles from './styles.scss';
+import { useTranslation } from 'react-i18next';
+
+const PatientSearchHeader = () => {
+  const { addPatient, workflowState, activeFormUuid } = useContext(FormWorkflowContext);
+  const handleSelectPatient = (patient) => {
+    addPatient(patient);
+  };
+  const { t } = useTranslation();
+
+  if (workflowState !== 'NEW_PATIENT') return null;
+
+  const afterUrl = encodeURIComponent(`\${openmrsSpaBase}/forms/form/${activeFormUuid}?patientUuid=\${patientUuid}`);
+  const patientRegistrationUrl = interpolateUrl(`\${openmrsSpaBase}/patient-registration?afterUrl=${afterUrl}`);
+
+  return (
+    <div className={styles.searchHeaderContainer}>
+      <span className={styles.padded}>{t('nextPatient', 'Next patient')}:</span>
+      <span className={styles.searchBarWrapper}>
+        <ExtensionSlot
+          name="patient-search-bar-slot"
+          state={{
+            selectPatientAction: handleSelectPatient,
+            buttonProps: {
+              kind: 'primary',
+            },
+          }}
+        />
+      </span>
+      <span className={styles.padded}>{t('or', 'or')}</span>
+      <span>
+        <Button onClick={() => navigate({ to: patientRegistrationUrl })}>
+          {t('createNewPatient', 'Create new patient')} <Add size={20} />
+        </Button>
+      </span>
+      <span style={{ flexGrow: 1 }} />
+      <span>
+        <Link to="../">
+          <Button kind="ghost">
+            {t('cancel', 'Cancel')} <Close size={20} />
+          </Button>
+        </Link>
+      </span>
+    </div>
+  );
+};
+
+export default PatientSearchHeader;

package/src/form-entry-workflow/patient-search-header/index.ts

@@ -0,0 +1,3 @@
+import PatientSearchHeader from './PatientSearchHeader';
+
+export default PatientSearchHeader;

package/src/form-entry-workflow/patient-search-header/styles.scss

@@ -0,0 +1,25 @@
+@use '@carbon/colors';
+@use '@carbon/layout';
+@use '@carbon/type';
+
+.searchHeaderContainer {
+  height: layout.$spacing-11;
+  display: flex;
+  align-items: center;
+  background-color: colors.$white-0;
+  border-top: 0.0125rem solid colors.$gray-20;
+  border-bottom: 0.0125rem solid colors.$gray-20;
+  padding: 0 layout.$spacing-05;
+}
+
+.searchBarWrapper {
+  min-width: 35rem;
+}
+
+.searchBarWrapper > div button {
+  height: auto;
+}
+
+.padded {
+  padding: layout.$spacing-05;
+}

package/src/form-entry-workflow/styles.scss

@@ -1,12 +1,11 @@
-@import "~@openmrs/esm-styleguide/src/vars";
-@import "~carbon-components/src/globals/scss/vars";
-@import "~carbon-components/src/globals/scss/mixins";
-
+@use '@carbon/colors';
+@use '@carbon/layout';
+@use '@carbon/type';
 
 .breadcrumbsContainer > div > div > nav {
-  background-color: $ui-02;
-  padding: $spacing-04 $spacing-05;
-  height: $spacing-08;
+  background-color: colors.$white-0;
+  padding: layout.$spacing-04 layout.$spacing-05;
+  height: layout.$spacing-08;
 }
 
 .workspaceWrapper {
@@ -19,43 +18,44 @@
 }
 
 .selectPatientMessage {
-  @include carbon--type-style('productive-heading-03');
-  margin: $spacing-07;
+  @include type.type-style('heading-03');
+  margin: layout.$spacing-07;
   text-align: center;
 }
 
 .formMainContent {
   display: flex;
   text-align: center;
-  margin-top: $spacing-05;
-  column-gap: $spacing-05;
+  margin-top: layout.$spacing-05;
+  column-gap: layout.$spacing-05;
 }
 
 .formContainer {
   flex-grow: 1;
   max-height: calc(100vh - 14rem);
   overflow-y: scroll;
+  text-align: left;
 }
 
-.formContainer :global(.bx--form-item) :global(.question-area) {
+.formContainer :global(.cds--form-item) :global(.question-area) {
   max-width: 100%;
 }
 
 .rightPanel {
-  width: 13rem;
+  min-width: 13rem;
   text-align: left;
   overflow-y: scroll;
 }
 
 .patientCardsSection {
-  margin: $spacing-05 0;
-  border-bottom: 1px solid $carbon--gray-10;
+  margin: layout.$spacing-05 0;
+  border-bottom: 1px solid colors.$gray-10;
 }
 
 .rightPanelActionButtons {
   display: flex;
   flex-direction: column;
-  row-gap: $spacing-03;
+  row-gap: layout.$spacing-03;
   & button {
     width: 100%;
     text-decoration: "none";

package/src/form-entry-workflow/workflow-review/WorkflowReview.tsx

@@ -0,0 +1,37 @@
+import { Button } from '@carbon/react';
+import React, { useContext } from 'react';
+import { useNavigate } from 'react-router-dom';
+import FormWorkflowContext from '../../context/FormWorkflowContext';
+import FormReviewCard from '../form-review-card';
+import styles from './styles.scss';
+import { useTranslation } from 'react-i18next';
+
+const WorkflowReview = () => {
+  const { patientUuids } = useContext(FormWorkflowContext);
+  const { t } = useTranslation();
+  const navigate = useNavigate();
+  return (
+    <div className={styles.workspaceWrapper}>
+      <div className={styles.workspace}>
+        <div className={styles.leftPanel}>
+          <h4>{t('review', 'Review')}</h4>
+          <div className={styles.navButtons}>
+            <Button kind="primary" onClick={() => navigate('/')}>
+              {t('save&close', 'Save & Close')}
+            </Button>
+            <Button kind="tertiary" onClick={() => navigate('/')}>
+              {t('cancel', 'Cancel')}
+            </Button>
+          </div>
+        </div>
+        <div className={styles.formContainer}>
+          {patientUuids.map((patientUuid) => (
+            <FormReviewCard patientUuid={patientUuid} key={patientUuid} />
+          ))}
+        </div>
+      </div>
+    </div>
+  );
+};
+
+export default WorkflowReview;