From 6f666aeb4dd788f5f431e3700b80845064277643 Mon Sep 17 00:00:00 2001
From: Cameron Bowler <cameron.bowler@ca.ey.com>
Date: Fri, 19 Jan 2024 08:42:32 -0800
Subject: [PATCH] Support for MF and HD QS Applicant Reviews

---
 auth-web/package-lock.json                    |   6 +-
 auth-web/package.json                         |   2 +-
 .../auth/staff/review-task/QsApplication.vue  | 165 +++++++++++++-----
 auth-web/src/models/external.ts               |  42 ++++-
 .../QualifiedSupplierAccessResource.ts        |  25 ++-
 auth-web/src/services/task.services.ts        |  10 +-
 .../unit/components/QsApplication.spec.ts     | 115 ++++++------
 7 files changed, 256 insertions(+), 109 deletions(-)

diff --git a/auth-web/package-lock.json b/auth-web/package-lock.json
index 50e3c9e745..5cbc6c569f 100644
--- a/auth-web/package-lock.json
+++ b/auth-web/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "auth-web",
-  "version": "2.4.57",
+  "version": "2.4.58",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "auth-web",
-      "version": "2.4.57",
+      "version": "2.4.58",
       "dependencies": {
         "@bcrs-shared-components/base-address": "2.0.3",
         "@bcrs-shared-components/bread-crumb": "1.0.8",
@@ -50,7 +50,7 @@
         "@types/vuelidate": "^0.7.13",
         "@typescript-eslint/eslint-plugin": "^6.4.0",
         "@typescript-eslint/parser": "^6.4.0",
-        "@volar-plugins/vetur": "*",
+        "@volar-plugins/vetur": "latest",
         "@vue/eslint-config-standard": "^4.0.0",
         "@vue/eslint-config-typescript": "^4.0.0",
         "@vue/test-utils": "1.3.6",
diff --git a/auth-web/package.json b/auth-web/package.json
index 4b4a4f974c..ba92579688 100644
--- a/auth-web/package.json
+++ b/auth-web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "auth-web",
-  "version": "2.4.57",
+  "version": "2.4.58",
   "appName": "Auth Web",
   "sbcName": "SBC Common Components",
   "private": true,
diff --git a/auth-web/src/components/auth/staff/review-task/QsApplication.vue b/auth-web/src/components/auth/staff/review-task/QsApplication.vue
index fcac5cfff3..10bd2f7bcd 100644
--- a/auth-web/src/components/auth/staff/review-task/QsApplication.vue
+++ b/auth-web/src/components/auth/staff/review-task/QsApplication.vue
@@ -24,46 +24,76 @@
     </v-row>
 
     <!-- QS Applicant Info -->
-    <v-row>
-      <v-col class="cols-12 mt-5 py-2">
-        <h3>Qualified Supplier ({{ qsApplicationTypeDisplay }}) Information</h3>
-      </v-col>
-    </v-row>
-    <v-row>
-      <v-col class="cols-12 col-sm-3 py-2 pr-2">
-        Qualified Supplier Name
-      </v-col>
-      <v-col
-        class="py-2"
-        data-test="qs-org-name"
-      >
-        {{ qsApplicantData && qsApplicantData.businessName }}
-      </v-col>
-    </v-row>
-    <v-row>
-      <v-col class="cols-12 col-sm-3 py-2">
-        Phone Number
-      </v-col>
-      <v-col
-        class="py-2"
-        data-test="qs-phone"
+    <template v-if="qsApplicantData">
+      <v-row>
+        <v-col class="cols-12 mt-5 py-2">
+          <h3>Qualified Supplier ({{ qsApplicationTypeDisplay }}) Information</h3>
+        </v-col>
+      </v-row>
+      <v-row>
+        <v-col class="cols-12 col-sm-3 py-2 pr-2">
+          Qualified Supplier Name
+        </v-col>
+        <v-col
+          class="py-2"
+          data-test="qs-org-name"
+        >
+          {{ qsApplicantData.businessName }}
+        </v-col>
+      </v-row>
+      <v-row v-if="!isLawyerNotaryApplication">
+        <v-col class="cols-12 col-sm-3 py-2 pr-2">
+          DBA / Operating Name
+        </v-col>
+        <v-col
+          class="py-2"
+          data-test="qs-dba-name"
+        >
+          {{ qsApplicantData.dbaName || '(Not Entered)' }}
+        </v-col>
+      </v-row>
+      <v-row>
+        <v-col class="cols-12 col-sm-3 py-2">
+          Phone Number
+        </v-col>
+        <v-col
+          class="py-2"
+          data-test="qs-phone"
+        >
+          {{ qsApplicantPhone }}
+        </v-col>
+      </v-row>
+      <v-row>
+        <v-col class="cols-12 col-sm-3 py-2">
+          Mailing Address
+        </v-col>
+        <v-col class="py-2">
+          <BaseAddressForm
+            v-if="qsApplicantData"
+            :schema="null"
+            :editing="false"
+            :address="formatAddress(qsApplicantData.address)"
+          />
+        </v-col>
+      </v-row>
+      <v-row
+        v-if="isManufacturerApplication"
+        data-test="qs-mf-location-row"
       >
-        {{ qsApplicantData && qsApplicantPhone }}
-      </v-col>
-    </v-row>
-    <v-row>
-      <v-col class="cols-12 col-sm-3 py-2">
-        Mailing Address
-      </v-col>
-      <v-col class="py-2">
-        <BaseAddressForm
-          v-if="qsApplicantData"
-          :schema="null"
-          :editing="false"
-          :address="formatAddress(qsApplicantData.address)"
-        />
-      </v-col>
-    </v-row>
+        <v-col class="cols-12 col-sm-3 py-2">
+          Location of the Manufactured Home(s)
+        </v-col>
+        <v-col class="py-2">
+          <BaseAddressForm
+            v-if="qsApplicantData.mfLocation"
+            :schema="null"
+            :editing="false"
+            :address="formatAddress(qsApplicantData.mfLocation)"
+            data-test="qs-mf-location"
+          />
+        </v-col>
+      </v-row>
+    </template>
 
     <!-- Submitting Party Info -->
     <v-row>
@@ -147,7 +177,7 @@
       </v-col>
     </v-row>
     <v-row>
-      <v-col class="cols-12 py-2 icon-text">
+      <v-col class="cols-12 py-0 icon-text">
         <v-icon
           class="pr-2"
           color="success"
@@ -166,8 +196,10 @@
     </v-row>
     <v-row>
       <v-col class="py-2">
-        Legal name of the person authorized to complete and submit this application. <b>Note:</b> The authorized person
-        must be an active B.C. lawyer or notary in good standing.
+        Legal name of the person authorized to complete and submit this application.
+        <span v-if="isLawyerNotaryApplication">
+          <b>Note:</b> The authorized person must be an active B.C. lawyer or notary in good standing.
+        </span>
       </v-col>
     </v-row>
     <v-row>
@@ -199,7 +231,11 @@
 </template>
 
 <script lang="ts">
-import { QualifiedSupplierApplicant, QualifiedSupplierRequirementsConfig } from '@/models/external'
+import {
+  MhrManufacturerInfoIF,
+  QualifiedSupplierApplicant,
+  QualifiedSupplierRequirementsConfig
+} from '@/models/external'
 import { computed, defineComponent, onMounted, reactive, toRefs } from '@vue/composition-api'
 import { userAccessDisplayNames, userAccessRequirements } from '@/resources/QualifiedSupplierAccessResource'
 import { Address } from '@/models/address'
@@ -209,6 +245,7 @@ import { Contact } from '@/models/contact'
 import { Organization } from '@/models/Organization'
 import { Task } from '@/models/Task'
 import TaskService from '@/services/task.services'
+import { TaskType } from '@/util/constants'
 import { User } from '@/models/user'
 import moment from 'moment/moment'
 
@@ -236,22 +273,58 @@ export default defineComponent({
       }),
       qsRequirements: computed((): QualifiedSupplierRequirementsConfig[] => {
         return userAccessRequirements[props.taskDetails?.type]
-      })
+      }),
+      isLawyerNotaryApplication: computed((): boolean => props.taskDetails?.type === TaskType.MHR_LAWYER_NOTARY),
+      isManufacturerApplication: computed((): boolean => props.taskDetails?.type === TaskType.MHR_MANUFACTURERS)
     })
 
+    /**
+     * Converts manufacturer data to a qualified supplier applicant.
+     * @param {MhrManufacturerInfoIF} mfData - The manufacturer data to convert.
+     * @returns {QualifiedSupplierApplicant} The converted qualified supplier applicant.
+     */
+    const formatManufacturer = (mfData: MhrManufacturerInfoIF): QualifiedSupplierApplicant => {
+      // Always 1 group with 1 owner in Manufacturer Owner record
+      const mfOwner = mfData.ownerGroups[0].owners[0]
+      return {
+        address: mfOwner.address,
+        authorizationName: mfData.authorizationName,
+        businessName: mfOwner.organizationName,
+        dbaName: mfData.dbaName,
+        phoneNumber: mfOwner.phoneNumber,
+        termsAccepted: mfData.termsAccepted,
+        mfLocation: mfData.location.address
+      }
+    }
+
+    /** On Mount: Fetch and parse Qualified Supplier applicant into local model. */
     onMounted(async () => {
-      await TaskService.getQsApplicantForTaskReview(props.accountUnderReview.id).then(response => {
+      // Fetch Qualified Suppler application data
+      await TaskService.getQsApplicantForTaskReview(props.accountUnderReview.id, props.taskDetails?.type).then(response => {
         if (!response?.data) {
           throw new Error('Invalid API response')
         }
-        localState.qsApplicantData = response.data
+        // Format response to fit QS model when Manufacturer
+        localState.qsApplicantData = localState.isManufacturerApplication
+          ? formatManufacturer(response.data)
+          : response.data
       }).catch(error => { console.error(error) })
     })
 
+    /**
+     * Formats the given date into a string representation.
+     * @param {Date} date - The date object to format.
+     * @returns {string} The formatted date string.
+     */
     const formatDate = (date: Date): string => {
       return moment(date).format('MMM DD, YYYY')
     }
 
+    /**
+     * Formats the address by converting the city and street values to lowercase.
+     * @param {Address} address - The address object to be formatted.
+     * @returns {Address} - The formatted address object.
+     */
     const formatAddress = (address: Address): Address => {
       address && Object.keys(address).forEach(key => {
         if (['city', 'street'].includes(key)) {
diff --git a/auth-web/src/models/external.ts b/auth-web/src/models/external.ts
index f383dd3d1e..17887fe6d0 100644
--- a/auth-web/src/models/external.ts
+++ b/auth-web/src/models/external.ts
@@ -5,9 +5,45 @@ export interface QualifiedSupplierApplicant {
   address: Address
   authorizationName: string
   businessName: string
-  partyType: string
-  phoneExtension: string
-  phoneNumber: string
+  dbaName?: string
+  partyType?: string
+  phoneExtension?: string
+  phoneNumber?: string
+  termsAccepted: boolean
+  mfLocation?: Address
+}
+
+// Interface describing response from MHR api for Qualified Supplier applicant info
+export interface MhrManufacturerInfoIF {
+  authorizationName?: string
+  dbaName?: string
+  description: {
+    manufacturer: string
+  }
+  location: {
+    address: Address
+    dealerName: string
+    leaveProvince: boolean
+    locationType: string
+  }
+  ownerGroups: [
+    {
+      groupId: number
+      owners: [
+        {
+          address: Address
+          organizationName: string
+          partyType: string
+          phoneNumber: string
+        }
+      ]
+      type: string
+    }
+  ],
+  submittingParty: {
+    address: Address
+    businessName: string
+  }
   termsAccepted: boolean
 }
 
diff --git a/auth-web/src/resources/QualifiedSupplierAccessResource.ts b/auth-web/src/resources/QualifiedSupplierAccessResource.ts
index 0496c4f279..1464a68f20 100644
--- a/auth-web/src/resources/QualifiedSupplierAccessResource.ts
+++ b/auth-web/src/resources/QualifiedSupplierAccessResource.ts
@@ -14,12 +14,31 @@ export const userAccessRequirements: Partial<Record<TaskType, QualifiedSupplierR
        forms), will be provided within 7 business days, at the fee level set by the Registrar.`
     }
   ],
-  [TaskType.MHR_MANUFACTURERS]: [],
-  [TaskType.MHR_DEALERS]: []
+  [TaskType.MHR_MANUFACTURERS]: [
+    {
+      boldText: `Have comprehensive general liability insurance `,
+      regularText: `equal to or greater than $2,000,000.00.`
+    },
+    {
+      boldText: `Manufactured homes built are CSA approved `,
+      regularText: `(Z240 or A277).`
+    },
+    {
+      boldText: `All filed documents will be stored for 7 years. `,
+      regularText: `If requested, a copy or certified copy of filed documents (such as the Bill of Sale, or other 
+        signed forms), will be provided within 7 business days, at the fee level set by the Registrar. `
+    }
+  ],
+  [TaskType.MHR_DEALERS]: [
+    {
+      boldText: `Have comprehensive general liability insurance `,
+      regularText: `equal to or greater than $2,000,000.00.`
+    }
+  ]
 }
 
 export const userAccessDisplayNames: Partial<Record<TaskType, string>> = {
   [TaskType.MHR_LAWYER_NOTARY]: 'Lawyers and Notaries',
-  [TaskType.MHR_MANUFACTURERS]: 'Manufacturers',
+  [TaskType.MHR_MANUFACTURERS]: 'Home Manufacturers',
   [TaskType.MHR_DEALERS]: 'Home Dealers'
 }
diff --git a/auth-web/src/services/task.services.ts b/auth-web/src/services/task.services.ts
index 72c5cebdac..b49225b5c2 100644
--- a/auth-web/src/services/task.services.ts
+++ b/auth-web/src/services/task.services.ts
@@ -1,8 +1,8 @@
 import { Task, TaskFilterParams, TaskList } from '@/models/Task'
+import { TaskRelationshipStatus, TaskType } from '@/util/constants'
 
 import { AxiosResponse } from 'axios'
 import ConfigHelper from '@/util/config-helper'
-import { TaskRelationshipStatus } from '@/util/constants'
 import { axios } from '@/util/http-util'
 
 export default class TaskService {
@@ -60,12 +60,16 @@ export default class TaskService {
       { status: TaskRelationshipStatus.HOLD, remarks, relationshipStatus: TaskRelationshipStatus.PENDING_STAFF_REVIEW })
   }
 
-  public static async getQsApplicantForTaskReview (accountId: number | string): Promise<AxiosResponse> {
+  public static async getQsApplicantForTaskReview (accountId: number | string, type: TaskType): Promise<AxiosResponse> {
     const apiKey = ConfigHelper.getMhrAPIKey()
     const headers = {
       'x-apikey': apiKey,
       'Account-Id': accountId
     }
-    return axios.get(`${ConfigHelper.getMhrAPIUrl()}/qualified-suppliers`, { headers })
+    const url = type === TaskType.MHR_MANUFACTURERS
+      ? `${ConfigHelper.getMhrAPIUrl()}/manufacturers`
+      : `${ConfigHelper.getMhrAPIUrl()}/qualified-suppliers`
+
+    return axios.get(url, { headers })
   }
 }
diff --git a/auth-web/tests/unit/components/QsApplication.spec.ts b/auth-web/tests/unit/components/QsApplication.spec.ts
index a5ec7e901b..f1a8b0fe59 100644
--- a/auth-web/tests/unit/components/QsApplication.spec.ts
+++ b/auth-web/tests/unit/components/QsApplication.spec.ts
@@ -2,13 +2,14 @@ import { createLocalVue, shallowMount } from '@vue/test-utils'
 import QsApplication from '@/components/auth/staff/review-task/QsApplication.vue'
 import { TaskType } from '@/util/constants'
 import Vuetify from 'vuetify'
+import { userAccessDisplayNames } from '@/resources/QualifiedSupplierAccessResource'
 
 // Mocked props
 const mockProps = {
   tabNumber: 1,
   title: 'Test Application',
   taskDetails: {
-    type: TaskType.MHR_LAWYER_NOTARY,
+    type: null,
     created: new Date()
   },
   accountUnderReview: {
@@ -26,71 +27,85 @@ const mockProps = {
     phone: '123-456-7890'
   }
 }
-
 const mockQsApplicantData = {
   businessName: 'Test Business',
   phoneNumber: '987-654-3210',
   authorizationName: 'Authorized Person',
-  address: {
-  }
+  dbaName: 'DBA Test Business',
+  address: {}
 }
+const taskTypes: TaskType[] = [TaskType.MHR_LAWYER_NOTARY, TaskType.MHR_MANUFACTURERS, TaskType.MHR_DEALERS]
+
+for (const taskType of taskTypes) {
+  describe(`QsApplication.vue: ${taskType}`, () => {
+    let wrapper
+    const localVue = createLocalVue()
+    const vuetify = new Vuetify({})
 
-describe('QsApplication.vue', () => {
-  let wrapper
-  const localVue = createLocalVue()
-  const vuetify = new Vuetify({})
+    beforeEach(() => {
+      wrapper = shallowMount(QsApplication, {
+        localVue,
+        vuetify,
+        propsData: { ...mockProps, taskDetails: { type: taskType } }
+      })
 
-  beforeEach(() => {
-    wrapper = shallowMount(QsApplication, {
-      localVue,
-      vuetify,
-      propsData: mockProps
+      // Set the mock qsApplicantData
+      wrapper.vm.qsApplicantData = mockQsApplicantData
     })
 
-    // Set the mock qsApplicantData
-    wrapper.vm.qsApplicantData = mockQsApplicantData
-  })
+    afterEach(() => {
+      wrapper.destroy()
+    })
 
-  afterEach(() => {
-    wrapper.destroy()
-  })
+    it('renders the component', () => {
+      expect(wrapper.exists()).toBe(true)
+    })
 
-  it('renders the component', () => {
-    expect(wrapper.exists()).toBe(true)
-  })
+    it('displays the correct tabNumber in the title', () => {
+      const title = wrapper.find('h2').text()
+      expect(title).toContain('1. Test Application')
+    })
 
-  it('displays the correct tabNumber in the title', () => {
-    const title = wrapper.find('h2').text()
-    expect(title).toContain('1. Test Application')
-  })
+    it('displays the correct title', () => {
+      const title = wrapper.find('h2').text()
+      expect(title).toContain('Test Application')
+    })
 
-  it('displays the correct title', () => {
-    const title = wrapper.find('h2').text()
-    expect(title).toContain('Test Application')
-  })
+    it('displays the correct task type', () => {
+      const taskTypeContent = wrapper.findAll('h3').at(1).text()
+      expect(taskTypeContent).toBe(`Qualified Supplier (${userAccessDisplayNames[taskType]}) Information`)
+    })
 
-  it('displays the correct task type', () => {
-    const taskType = wrapper.findAll('h3').at(1).text()
-    expect(taskType).toBe('Qualified Supplier (Lawyers and Notaries) Information')
-  })
+    it('displays the correct applicant organization name', () => {
+      const orgName = wrapper.find('[data-test="qs-org-name"]').text()
+      expect(orgName).toContain('Test Business')
+    })
 
-  it('displays the correct applicant organization name', () => {
-    const orgName = wrapper.find('[data-test="qs-org-name"]').text()
-    expect(orgName).toContain('Test Business')
-  })
+    it.runIf([TaskType.MHR_MANUFACTURERS, TaskType.MHR_DEALERS].includes(taskType))(
+      'displays the correct applicant Dba name when Dealers or Manufacturers', () => {
+        const dbaName = wrapper.find('[data-test="qs-dba-name"]').text()
+        expect(dbaName).toContain('DBA Test Business')
+      })
 
-  it('displays the correct admin full name', () => {
-    const adminName = wrapper.find('[data-test="qs-username"]').text()
-    expect(adminName).toContain('John Doe')
-  })
+    it('displays the correct admin full name', () => {
+      const adminName = wrapper.find('[data-test="qs-username"]').text()
+      expect(adminName).toContain('John Doe')
+    })
 
-  it('displays the correct admin contact email', () => {
-    const adminEmail = wrapper.find('[data-test="qs-email"]').text()
-    expect(adminEmail).toContain('john.doe@example.com')
-  })
+    it('displays the correct admin contact email', () => {
+      const adminEmail = wrapper.find('[data-test="qs-email"]').text()
+      expect(adminEmail).toContain('john.doe@example.com')
+    })
 
-  it('displays the correct applicant contact phone number', () => {
-    const adminPhone = wrapper.find('[data-test="qs-phone"]').text()
-    expect(adminPhone).toContain('(987) 654-3210')
+    it('displays the correct applicant contact phone number', () => {
+      const adminPhone = wrapper.find('[data-test="qs-phone"]').text()
+      expect(adminPhone).toContain('(987) 654-3210')
+    })
+
+    it.runIf([TaskType.MHR_MANUFACTURERS].includes(taskType))(
+      'displays the applicant Location when Manufacturer', () => {
+        const mfLocationRow = wrapper.find('[data-test="qs-mf-location-row"]')
+        expect(mfLocationRow.exists()).toBe(true)
+      })
   })
-})
+}