@ampath/esm-dha-workflow-app 4.0.0-next.34 → 4.0.0-next.340

package/src/billing/dashboard/v3/patient-bill-details/attachments/type.ts

@@ -0,0 +1,259 @@
+export interface UploadedFile {
+  id: string;
+  file: File;
+  uploaded?: boolean;
+}
+
+export interface GeneratedDocument {
+  id: string;
+  name: string;
+  generated: boolean;
+  uploaded?: boolean;
+  file?: File;
+  url?: string;
+}
+
+export type DocumentType = 'DISCHARGE SUMMARY' | 'INVOICE';
+
+export interface DischargeSummary {
+  patientName: string;
+  age: string;
+  ipNumber: string;
+  parity: string;
+  admissionDate: string;
+  deliveryDate: string;
+  modeOfDelivery: string;
+  babySex: string;
+  birthWeight: string;
+  fate: string;
+  hygieneAdvice: string;
+  nutrition: string;
+  breastFeeding: string;
+  immunization: string;
+  familyPlanning: string;
+  remarks: string;
+  dischargeDate: string;
+  clinician: string;
+}
+
+export type Attachment = {
+  id: string;
+  documentType: string;
+  title: string;
+  files: UploadedFile[];
+};
+
+export interface VisitSummaryResponse {
+  visit: VisitInfo;
+  visitUuids: string[];
+  demographics: PatientDemographics;
+  allergies: Allergy[];
+  conditions: Condition[];
+  vitals: PatientVitals;
+  medications: Medication[];
+  clinicalNotes: ClinicalNote[];
+  soapNote: SoapNote;
+  labOrders: LabOrder[];
+  inpatientDetails?: VisitSummaryAdmissionDetails;
+  dialysis?: VisitSummaryDialysis;
+}
+
+export interface VisitInfo {
+  uuid: string;
+  display: string;
+  visitType: string;
+  startDatetime: string;
+}
+
+export interface PatientDemographics {
+  name: string;
+  birthDate: string;
+  gender: string;
+  age: string;
+  patientId: string;
+  nationalId: string;
+  crNumber: string;
+  contact: string;
+  clinic: string;
+  diagnosis: string;
+  address: string;
+}
+
+export interface Allergy {
+  // Empty array in your payload, so keep it flexible
+  [key: string]: any;
+}
+
+export interface Condition {
+  code: string;
+  description: string;
+  certainty: string;
+  primary?: boolean;
+  onsetDate: string;
+}
+
+export interface PatientVitals {
+  temperature: string;
+  bloodPressure: string;
+  pulse: string;
+  respiratoryRate: string;
+  spo2: string;
+  height: string;
+  weight: string;
+  bmi: string;
+  tewScore: string;
+}
+
+export interface Medication {
+  [key: string]: any;
+}
+
+export interface ClinicalNote {
+  encounterUuid: string;
+  encounterType: string;
+  datetime: string;
+  fields: ClinicalField[];
+}
+
+export interface ClinicalField {
+  label: string;
+  value: string;
+}
+
+export interface SoapNote {
+  subjective: string;
+  objective: string;
+  assessment: string;
+  plan: string;
+}
+
+export interface LabOrder {
+  uuid: string;
+  test: string;
+  orderNumber: string;
+  orderedDate: string;
+  pending: boolean;
+  action: string;
+  results: LabResult[];
+}
+
+export interface LabResult {
+  [key: string]: any;
+}
+
+export type VitalReading = {
+  label: string;
+  value: string;
+  unit: string;
+  trend: 'up' | 'down' | 'flat';
+};
+
+export interface VisitSummaryAdmissionDetails {
+  admissionNumber?: string;
+  admissionDate?: string;
+  dischargeDate?: string | null;
+  ward?: string;
+  bed?: string;
+  room?: string;
+  admittingDoctor?: string;
+  referringFacility?: string;
+  admissionReason?: string;
+  status?: 'ADMITTED' | 'DISCHARGED' | 'TRANSFERRED' | 'PENDING' | string;
+  diagnosis?: string;
+}
+export interface VisitSummaryDialysis {
+  facility: VisitSummaryDialysisFacility;
+  patient: VisitSummaryDialysisPatient;
+  preAssessment: VisitSummaryDialysisPreAssessment;
+  prescription: VisitSummaryDialysisPrescription;
+  monitoring: VisitSummaryDialysisMonitoringEntry[];
+  postAssessment: VisitSummaryDialysisPostAssessment;
+  summary: VisitSummaryDialysisSummary;
+  signoff: VisitSummaryDialysisSignoff;
+}
+
+export interface VisitSummaryDialysisFacility {
+  name: string;
+  hospital: string;
+  address: string;
+  phone: string;
+  email: string;
+}
+
+export interface VisitSummaryDialysisPatient {
+  name: string;
+  opNo: string;
+  insuranceNo: string;
+  date: string;
+  age: string;
+  sex: string;
+  contact: string;
+  clinic: string;
+  diagnosis: string;
+  address: string;
+}
+
+export interface VisitSummaryDialysisPreAssessment {
+  weightBefore: string;
+  temperature: string;
+  pulse: string;
+  bp: string;
+  respRate: string;
+  oxygenSat: string;
+  bloodSugar: string;
+  accessType: string;
+  accessSite: string;
+  doctor: string;
+}
+
+export interface VisitSummaryDialysisPrescription {
+  dialyzerType: string;
+  bfr: string;
+  dfr: string;
+  duration: string;
+  ufGoal: string;
+  heparinDose: string;
+  dialysateComposition: string;
+}
+
+export interface VisitSummaryDialysisMonitoringEntry {
+  time: string;
+  bp: string;
+  pulse: string;
+  temp: string;
+  ufRemoved: string;
+  heparin: string;
+  remarks: string;
+}
+
+export interface VisitSummaryDialysisPostAssessment {
+  weightAfter: string;
+  totalUfAchieved: string;
+  bp: string;
+  pulse: string;
+  temperature: string;
+  accessSite: string;
+  condition: string;
+  complications: string;
+}
+
+export interface VisitSummaryDialysisSummary {
+  prescribedDuration: string;
+  actualDuration: string;
+  adequacyAchieved: string;
+  toleratedProcedure: string;
+  comments: string;
+  nextSessionDate: string;
+  additionalRemarks: string;
+}
+
+export interface VisitSummaryDialysisSignoff {
+  nurse: VisitSummaryDialysisSignatory;
+  doctor: VisitSummaryDialysisSignatory;
+}
+
+export interface VisitSummaryDialysisSignatory {
+  name: string;
+  regNo: string;
+  date: string;
+}

package/src/billing/dashboard/v3/patient-bill-details/bill-details/bill-details.scss

@@ -0,0 +1,13 @@
+.billDetailsLayout{
+    display: flex;
+    flex-direction: column;
+    row-gap: 10px;
+    width: 100%;
+    padding: 15px 15px;
+    .billRow{
+        display: flex;
+        flex-direction: column;
+        width: 100%;
+        row-gap: 10px;
+    }
+}

package/src/billing/dashboard/v3/patient-bill-details/bill-details/bill-details.tsx

@@ -0,0 +1,235 @@
+import React, { useEffect, useMemo, useState } from 'react';
+import { type PatientPayment, type PatientFacilityBillDetails, ClaimsVisit } from '../../types';
+import styles from './bill-details.scss';
+import { Button, OverflowMenu, OverflowMenuItem, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tag } from '@carbon/react';
+import { formatDate, parseDate } from '@openmrs/esm-framework';
+import BillItemPaymentModal from '../modals/bill-item-payment/bill-item-payment.modal';
+import AddClaimLineModal from '../modals/add-claim-line/add-claim-line.modal';
+import { type AmrsVisitDiagnosis } from '../../../../types';
+import VisitDiagnosisDetails from '../visit-diagnosis-details/visit-diagnosis-details.component';
+import { useInvalidateProviderClaimPreview } from '../../../../billing-claims.resource';
+
+interface billDetailsProps {
+  patientBillDetails: PatientFacilityBillDetails[];
+  patientPayments: PatientPayment[];
+  amrsVisitDiagnosis: AmrsVisitDiagnosis[];
+  consentToken: string;
+  locationUuid: string;
+  claimsVisit: ClaimsVisit;
+}
+const BillDetails: React.FC<billDetailsProps> = ({ patientBillDetails, patientPayments, amrsVisitDiagnosis, consentToken, locationUuid, claimsVisit }) => {
+  const [showPaymentModal, setShowPaymentModal] = useState<boolean>(false);
+  const [showAddClaimLineModal, setShowAddClaimLineModal] = useState<boolean>(false);
+  const [selectedBillItem, setSelectedBillItem] = useState<PatientFacilityBillDetails | null>(null);
+  const setDiagnosisInterventionCode = useMemo(() => getConsultationBillIntervantionCode(), [patientBillDetails]);
+  const invalidateProviderClaimPreview = useInvalidateProviderClaimPreview();
+
+  if (!patientBillDetails && !patientPayments) {
+    return <>No Data</>;
+  }
+  function handleBillItemPayment(patientBillDetail: PatientFacilityBillDetails) {
+    setSelectedBillItem(patientBillDetail);
+    setShowPaymentModal(true);
+  }
+  function handleClosePayModal() {
+    setShowPaymentModal(false);
+  }
+  function handleSuccessfullPayment() {
+    handleClosePayModal();
+  }
+  function handleClaimLineAddition(patientBillDetail: PatientFacilityBillDetails) {
+    setSelectedBillItem(patientBillDetail);
+    setShowAddClaimLineModal(true);
+  }
+  function handleCloseAddClaimItemModal() {
+    setShowAddClaimLineModal(false);
+  }
+  function getConsultationBillIntervantionCode() {
+    if (!patientBillDetails || patientBillDetails.length === 0) {
+      return '';
+    }
+    const consultationBill = patientBillDetails.find((b) => {
+      return b.billable_service.toLocaleLowerCase().trim().includes('consultation');
+    });
+    if (consultationBill) {
+      return consultationBill.intervention_code;
+    } else {
+      return patientBillDetails[0].intervention_code ?? '';
+    }
+  }
+  function onSuccess() {
+    handleCloseAddClaimItemModal();
+    invalidateProviderClaimPreview();
+  }
+  function interventionAddedToClaimLine(b: PatientFacilityBillDetails) {
+    if (b.intervention_code && b.has_claim_line === 0) {
+      if (claimsVisit && claimsVisit.invoices) {
+        const lineExists = claimsVisit.invoices.some((inv) =>
+          inv.lines.some(l => l.intervention_code === b.intervention_code)
+        );
+        return lineExists;
+      }
+      return false;
+    }
+    return true;
+  }
+  return (
+    <>
+      <div className={styles.billDetailsLayout}>
+        {patientBillDetails.length > 0 ? (
+          <>
+            <div className={styles.billRow}>
+              <div>
+                <h6>Bill Items</h6>
+              </div>
+              <div>
+                <Table aria-label="bill details" size="sm">
+                  <TableHead>
+                    <TableRow>
+                      <TableHeader>No</TableHeader>
+                      <TableHeader>Bill Item</TableHeader>
+                      <TableHeader>Intervention Code</TableHeader>
+                      <TableHeader>Order No</TableHeader>
+                      <TableHeader>Service Type</TableHeader>
+                      <TableHeader>Payer</TableHeader>
+                      <TableHeader>Payment Status</TableHeader>
+                      <TableHeader>Quantity</TableHeader>
+                      <TableHeader>Total</TableHeader>
+                      <TableHeader>Actions</TableHeader>
+                    </TableRow>
+                  </TableHead>
+                  <TableBody>
+                    {patientBillDetails &&
+                      patientBillDetails.map((b, index) => {
+                        return (
+                          <>
+                            <TableRow key={b.patient_uuid}>
+                              <TableCell>{index + 1}</TableCell>
+                              <TableCell>{b.billable_service}</TableCell>
+                              <TableCell>{b.intervention_code ?? ''}</TableCell>
+                              <TableCell>{b.order_no ?? ''}</TableCell>
+                              <TableCell>{b.service_type ?? ''}</TableCell>
+                              <TableCell>{b.payment_scheme}</TableCell>
+                              <TableCell>{b.paid_status}</TableCell>
+                              <TableCell>{b.item_quantity}</TableCell>
+                              <TableCell>Ksh {b.item_total_price}</TableCell>
+                              <TableCell>
+                                {/* <OverflowMenu aria-label="overflow-menu">
+                                  {
+                                    (b.paid_status !== 'PAID' && !b.intervention_code) && <OverflowMenuItem itemText="Pay" onClick={() => handleBillItemPayment(b)} />
+                                  }
+                                  {
+                                    (b.intervention_code && b.has_claim_line === 0) && <OverflowMenuItem itemText="Add Claim Line" onClick={() => handleClaimLineAddition(b)} />
+                                  }
+                                </OverflowMenu> */}
+                                {
+                                  (b.paid_status !== 'PAID' && !b.intervention_code) && <Button size="sm" kind="tertiary" onClick={() => handleBillItemPayment(b)}>Pay</Button>
+                                }
+                                {
+                                  b.intervention_code ?
+                                    (
+                                      claimsVisit ?
+                                        (
+                                          claimsVisit.workflow_state === 'DRAFT' ?
+                                            (!interventionAddedToClaimLine(b) && <Button size="sm" kind="tertiary" onClick={() => handleClaimLineAddition(b)}>Add Claim Line</Button>)
+                                            : <Tag>{claimsVisit.workflow_state}</Tag>
+                                        )
+                                        : <></>
+                                    )
+                                    : <></>
+                                }
+                              </TableCell>
+                            </TableRow>
+                          </>
+                        );
+                      })}
+                  </TableBody>
+                </Table>
+              </div>
+            </div>
+          </>
+        ) : (
+          <></>
+        )}
+        {patientPayments.length > 0 ? (
+          <>
+            <div className={styles.billRow}>
+              <div>
+                <h6>Bill Payments</h6>
+              </div>
+              <div>
+                <Table aria-label="bill details" size="sm">
+                  <TableHead>
+                    <TableRow>
+                      <TableHeader>No</TableHeader>
+                      <TableHeader>Payment Type</TableHeader>
+                      <TableHeader>Amount</TableHeader>
+                      <TableHeader>Amount Tendered</TableHeader>
+                      <TableHeader>Date / Time</TableHeader>
+                    </TableRow>
+                  </TableHead>
+                  <TableBody>
+                    {patientPayments &&
+                      patientPayments.map((p, index) => {
+                        return (
+                          <>
+                            <TableRow key={p.cashier_bill_payment_uuid}>
+                              <TableCell>{index + 1}</TableCell>
+                              <TableCell>{p.payment_mode}</TableCell>
+                              <TableCell>Ksh {p.amount}</TableCell>
+                              <TableCell>Ksh {p.amount_tendered}</TableCell>
+                              <TableCell>
+                                {formatDate(parseDate(p.payment_time))}</TableCell>
+                            </TableRow>
+                          </>
+                        );
+                      })}
+                  </TableBody>
+                </Table>
+              </div>
+            </div>
+          </>
+        ) : (
+          <></>
+        )}
+        {
+          amrsVisitDiagnosis.length > 0 ? (<>
+            <div className={styles.billRow}>
+              <div>
+                <h6>Patient Dignosis</h6>
+              </div>
+              <div>
+                <VisitDiagnosisDetails
+                  amrsVisitDiagnosis={amrsVisitDiagnosis}
+                  consentToken={consentToken}
+                  locationUuid={locationUuid}
+                  interventionCode={setDiagnosisInterventionCode}
+                  claimsVisit={claimsVisit}
+                />
+              </div>
+            </div>
+
+          </>) : (<></>)
+        }
+        {
+          (showPaymentModal && selectedBillItem) && <BillItemPaymentModal
+            open={showPaymentModal}
+            billItem={selectedBillItem}
+            onClose={handleClosePayModal}
+            onPay={handleSuccessfullPayment} />
+        }
+        {
+          (showAddClaimLineModal && selectedBillItem) && <AddClaimLineModal
+            open={showAddClaimLineModal}
+            billItem={selectedBillItem}
+            onClose={handleCloseAddClaimItemModal}
+            onSuccess={onSuccess}
+            locationUuid={locationUuid}
+            consentToken={consentToken}
+          />
+        }
+      </div>
+    </>
+  );
+};
+export default BillDetails;

package/src/billing/dashboard/v3/patient-bill-details/claim-details/patient-claim-details.component.tsx

@@ -0,0 +1,69 @@
+import React, { useEffect } from "react";
+import { useState } from "react";
+import { type ProviderClaimPreviewDto, type ClaimsVisit, type PatientFacilityBillDetails } from "../../types";
+import { showSnackbar } from "@openmrs/esm-framework";
+import { fetchProviderClaimPreview, useProviderClaimPreview } from "../../../../billing-claims.resource";
+import styles from './patient-claim-details.component.scss';
+import ClaimVisitDetails from "../../claim-visits/claim-visit-details/claim-visit-details.component";
+import { InlineLoading } from "@carbon/react";
+
+interface patientClaimDetailsProps {
+  consentToken: string;
+  locationUuid: string;
+  patientBillDetails: PatientFacilityBillDetails[];
+  onBillDetailsChange?: () => void;
+  onLoadingClaimVisit?: (claimVisit: ClaimsVisit) => void;
+}
+const PatientClaimDetails: React.FC<patientClaimDetailsProps> = ({
+  consentToken,
+  locationUuid,
+  patientBillDetails,
+  onBillDetailsChange,
+  onLoadingClaimVisit
+}) => {
+  const [patientBill, setPatientBill] = useState<PatientFacilityBillDetails>();
+  const { claimVisit, isLoading, isValidating } = useProviderClaimPreview(consentToken, locationUuid);
+
+  useEffect(() => {
+    if (claimVisit && !isLoading && !isValidating) {
+      onLoadingClaimVisit(claimVisit);
+    }
+  }, [claimVisit, isLoading, isValidating])
+
+  useEffect(() => {
+    if (consentToken && locationUuid) {
+      getPatientBill();
+    }
+  }, [consentToken, locationUuid]);
+
+  if (isLoading && !claimVisit) {
+    return <InlineLoading description='Loading data...please wait' />
+  }
+
+  function getPatientBill() {
+    const bill = patientBillDetails.find(details => details.consent_token === consentToken);
+    setPatientBill(bill);
+  }
+
+  return <>
+    {
+      isValidating &&
+      <InlineLoading description='Refreshing data...' />
+    }
+    <div className={styles.pcLayout}>
+      {
+        claimVisit && (
+          <ClaimVisitDetails
+            patientBillDetails={patientBill}
+            claimsVisit={claimVisit}
+            locationUuid={locationUuid}
+            onBillDetailsChange={onBillDetailsChange}
+            claimRefreshing={isValidating}
+          />
+        )
+      }
+
+    </div>
+  </>
+};
+export default PatientClaimDetails;

package/src/billing/dashboard/v3/patient-bill-details/modals/add-claim-diagnosis/add-claim-diagnosis.modal.tsx

@@ -0,0 +1,99 @@
+import React, { useState } from "react";
+import styles from './add-claim-diagnosis.modal.scss';
+import { type AmrsVisitDiagnosis } from "../../../../../types";
+import { Modal, ModalBody, TextInput } from "@carbon/react";
+import { showSnackbar } from "@openmrs/esm-framework";
+import { addClaimDiagnosis } from "../../../../../billing-claims.resource";
+import { type AddClaimDiagnosisDto } from "../../../types";
+interface addClaimDiagnosisModal {
+     open: boolean;
+     onClose: () => void;
+     onSuccess: () => void;
+     amrsVisitDiagnosis: AmrsVisitDiagnosis;
+     interventionCode: string;
+     consentToken: string;
+     locationUuid: string;
+}
+const AddClaimDiagnosisModal:React.FC<addClaimDiagnosisModal> = ({open,onClose,onSuccess,amrsVisitDiagnosis,interventionCode,consentToken,locationUuid})=>{
+    const [loading,setLoading] = useState<boolean>(false);
+  async function handleAddClaimDiagnosis() {
+    setLoading(true);
+    const addClaimDiagnosisDto = getClaimDiagnosisDto();
+    try{
+        const resp = await addClaimDiagnosis(addClaimDiagnosisDto);
+        if(resp['error']){
+           showSnackbar({
+             title: resp['error'] ?? 'Error Adding Claim Diagnosis',
+             kind: 'error',
+             subtitle: resp['message'] ?? 'An error occurred while adding the claim disgnosis. Kindy retry or contact support'
+           })
+           onSuccess();
+        }else{
+             showSnackbar({
+             title: 'Sucess Adding Claim Diagnosis',
+             kind: 'success',
+             subtitle: 'Claim Item added successfully'
+           });
+           onSuccess();
+        }
+    }catch(error){
+       showSnackbar({
+        kind: 'error',
+        title: 'Error Adding Claim Diagnosis',
+        subtitle: 'An error occurred while adding the Claim Diagnosis. Kindy retry or contact support'
+       });
+    }finally{
+        setLoading(false);
+    }
+  }
+  function getClaimDiagnosisDto(): AddClaimDiagnosisDto {
+    return {
+      consentToken: consentToken,
+      interventionCode: interventionCode,
+      locationUuid: locationUuid,
+      icdCode: amrsVisitDiagnosis.icd11_code,
+      practitionerIdentificationNumber: amrsVisitDiagnosis.practioner_nat_id,
+      practitionerIdentificationType: amrsVisitDiagnosis.practitioner_identifier_type,
+      practitionerRegulationBody: amrsVisitDiagnosis.practitioner_body
+    };
+  }
+  function holderFunction(){
+    return;
+  }
+  return (
+    <>
+      <Modal
+        modalHeading="Add Claim Diagnosis"
+        open={open}
+        size="md"
+        onSecondarySubmit={onClose}
+        onRequestClose={onClose}
+        onRequestSubmit={loading ? holderFunction : handleAddClaimDiagnosis}
+        primaryButtonText={loading ? 'Adding...': 'Add'}
+        secondaryButtonText="Close"
+      >
+        <ModalBody>
+          <div className={styles.addClaimDiagnosisModalLayout}>
+            <div className={styles.addClaimDiagnosisModalRow}>
+              <TextInput
+                id="intervention-code"
+                labelText="Intervention Code"
+                value={interventionCode}
+                readOnly={true}
+              />
+            </div>
+            <div className={styles.addClaimDiagnosisModalRow}>
+              <TextInput
+                id="icd11Code"
+                labelText="ICD11 Diagnosis"
+                value={amrsVisitDiagnosis.icd11_code}
+                readOnly={true}
+              />
+            </div>
+          </div>
+        </ModalBody>
+      </Modal>
+    </>
+  );
+}
+export default AddClaimDiagnosisModal;

package/src/billing/dashboard/v3/patient-bill-details/modals/add-claim-line/add-claim-line.modal.scss

@@ -0,0 +1,14 @@
+.addClaimLineModalLayout{
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    row-gap: 10px;
+    width: 100%;
+    .addClaimLineModalRow{
+        display: flex;
+        flex-direction: row;
+        width: 100%;
+        column-gap: 5px;
+        padding: 5px 5px;
+    }
+}