@things-factory/worksheet-base 8.0.0-beta.8 → 8.0.0

package/server/controllers/inbound/putaway-worksheet-controller.ts

@@ -0,0 +1,454 @@
+import { Equal, In, Not } from 'typeorm'
+
+import { Bizplace } from '@things-factory/biz-base'
+import {
+  ArrivalNotice,
+  ORDER_INVENTORY_STATUS,
+  ORDER_PRODUCT_STATUS,
+  ORDER_STATUS,
+  ORDER_TYPES,
+  OrderInventory,
+  OrderNoGenerator
+} from '@things-factory/sales-base'
+import {
+  Inventory,
+  INVENTORY_STATUS,
+  INVENTORY_TRANSACTION_TYPE,
+  Location,
+  LOCATION_TYPE,
+  Pallet,
+  Warehouse
+} from '@things-factory/warehouse-base'
+
+import { WORKSHEET_STATUS, WORKSHEET_TYPE } from '../../constants'
+import { Worksheet, WorksheetDetail } from '../../entities'
+import { switchLocationStatus } from '../../utils'
+import { VasWorksheetController } from '../vas/vas-worksheet-controller'
+
+export class PutawayWorksheetController extends VasWorksheetController {
+  async generatePutawayWorksheet(arrivalNoticeNo: string, inventories: Inventory[]): Promise<Worksheet> {
+    //@ts-ignore
+    let arrivalNotice: ArrivalNotice = await this.findRefOrder(
+      //@ts-ignore
+      ArrivalNotice,
+      { domain: { id: this.domain.id }, name: arrivalNoticeNo },
+      ['bizplace']
+    )
+
+    const bizplace: Bizplace = arrivalNotice.bizplace
+    const unloadingWorksheet: Worksheet = await this.findWorksheetByRefOrder(arrivalNotice, WORKSHEET_TYPE.UNLOADING, [
+      'bufferLocation'
+    ])
+    const bufferLocation: Location = unloadingWorksheet.bufferLocation
+
+    // Check whether putaway worksheet is exists or not
+    let worksheet: Worksheet
+    try {
+      worksheet = await this.findWorksheetByRefOrder(arrivalNotice, WORKSHEET_TYPE.PUTAWAY)
+    } catch (e) {}
+
+    let oiStatus: string = ORDER_PRODUCT_STATUS.UNLOADED // Default status of order inventories is UNLOADED
+    let wsdStatus: string = WORKSHEET_STATUS.DEACTIVATED // Default status of worksheet is DEACTIVATED
+    if (!worksheet) {
+      // If it's not exists create new putaway worksheet
+      worksheet = await this.createWorksheet(arrivalNotice, WORKSHEET_TYPE.PUTAWAY, { bufferLocation })
+    } else {
+      // If there is putaway worksheet. It means unloading is completed partially.
+      // So status of newly created worksheet details and order inventories should be changed to
+      // Executing situation.
+      oiStatus = ORDER_PRODUCT_STATUS.PUTTING_AWAY // Default status = PUTTING_AWAY
+      wsdStatus = WORKSHEET_STATUS.EXECUTING // Default status = EXECUTING
+    }
+
+    if (inventories.some((inv: Inventory) => !(inv instanceof Inventory))) {
+      inventories = await this.trxMgr.getRepository(Inventory).findByIds(inventories.map((inv: Inventory) => inv.id))
+    }
+
+    let worksheetDetails: WorksheetDetail[] = []
+    for (let inventory of inventories) {
+      inventory.status = INVENTORY_STATUS.PUTTING_AWAY
+      inventory.updater = this.user
+      inventory = await this.trxMgr.getRepository(Inventory).save(inventory)
+
+      // check if there's existing orderInventory
+      let targetInventory: OrderInventory = await this.trxMgr.getRepository(OrderInventory).findOne({
+        where: { inventory: { id: inventory.id } }
+      })
+
+      // if no existing orderInventory, create new one
+      if (!targetInventory) {
+        targetInventory = new OrderInventory()
+        targetInventory.domain = this.domain
+        targetInventory.bizplace = bizplace
+        targetInventory.name = OrderNoGenerator.orderInventory()
+        targetInventory.status = oiStatus
+        targetInventory.type = ORDER_TYPES.ARRIVAL_NOTICE
+        targetInventory.arrivalNotice = arrivalNotice
+        targetInventory.inventory = inventory
+        targetInventory.creator = this.user
+        targetInventory.updater = this.user
+        targetInventory = await this.trxMgr.getRepository(OrderInventory).save(targetInventory)
+      }
+
+      const newWorksheetDetails: WorksheetDetail[] = await this.createWorksheetDetails(
+        worksheet,
+        WORKSHEET_TYPE.PUTAWAY,
+        [targetInventory],
+        { status: wsdStatus, fromLocation: bufferLocation }
+      )
+
+      worksheetDetails.push(...newWorksheetDetails)
+    }
+
+    return {
+      ...worksheet,
+      worksheetDetails
+    }
+  }
+
+  async activatePutaway(worksheetNo: string, putawayWorksheetDetails: Partial<WorksheetDetail>[]): Promise<Worksheet> {
+    let worksheet: Worksheet = await this.findActivatableWorksheet(worksheetNo, WORKSHEET_TYPE.PUTAWAY, [
+      'arrivalNotice',
+      'worksheetDetails',
+      'worksheetDetails.targetInventory'
+    ])
+
+    let arrivalNotice: ArrivalNotice = worksheet.arrivalNotice
+    const nonFinishedVasCnt: number = await this.trxMgr.getRepository(Worksheet).count({
+      where: {
+        domain: { id: this.domain.id },
+        arrivalNotice: { id: arrivalNotice.id },
+        type: WORKSHEET_TYPE.VAS,
+        status: Not(Equal(WORKSHEET_STATUS.DONE))
+      }
+    })
+    if (nonFinishedVasCnt) return
+
+    const worksheetDetails: WorksheetDetail[] = worksheet.worksheetDetails
+    const targetInventories: OrderInventory[] = worksheetDetails.map((wsd: WorksheetDetail) => {
+      let targetInventory: OrderInventory = wsd.targetInventory
+      targetInventory.status = ORDER_PRODUCT_STATUS.PUTTING_AWAY
+      targetInventory.updater = this.user
+      return targetInventory
+    })
+    await this.updateOrderTargets(targetInventories)
+
+    arrivalNotice.status = ORDER_STATUS.PUTTING_AWAY
+    arrivalNotice.updater = this.user
+    await this.updateRefOrder(arrivalNotice)
+    return this.activateWorksheet(worksheet, worksheetDetails, putawayWorksheetDetails)
+  }
+
+  async completePutaway(arrivalNoticeNo: string): Promise<Worksheet> {
+    // Because of partial unloading current status of arrivalNotice can be PUTTING_AWAY or PROCESSING
+    // PUTTING_AWAY means unloading is completely finished.
+    // PROCESSING means some products are still being unloaded.
+    //@ts-ignore
+    let arrivalNotice: ArrivalNotice = await this.findRefOrder(ArrivalNotice, {
+      name: arrivalNoticeNo,
+      status: In([ORDER_STATUS.PUTTING_AWAY, ORDER_STATUS.PROCESSING])
+    })
+
+    // Check whether unloading is done or not.
+    const unloadingWorksheetCnt: number = await this.trxMgr.getRepository(Worksheet).count({
+      where: {
+        domain: { id: this.domain.id },
+        arrivalNotice: { id: arrivalNotice.id },
+        type: WORKSHEET_TYPE.UNLOADING,
+        status: WORKSHEET_STATUS.EXECUTING
+      }
+    })
+    if (unloadingWorksheetCnt) throw new Error(`Unloading is not completed yet`)
+
+    const putawayWorksheet: Worksheet = await this.findWorksheetByRefOrder(arrivalNotice, WORKSHEET_TYPE.PUTAWAY, [
+      'bufferLocation'
+    ])
+    await switchLocationStatus(this.domain, putawayWorksheet.bufferLocation, this.user, this.trxMgr)
+    return await this.completeWorksheet(putawayWorksheet, ORDER_STATUS.DONE)
+  }
+
+  async putaway(
+    worksheetDetailName: [string],
+    palletId: string,
+    cartonId: string,
+    locationName: string
+  ): Promise<void> {
+    const reusablePallet: Pallet = await this.trxMgr.getRepository(Pallet).findOne({
+      where: { domain: { id: this.domain.id }, name: palletId }
+    })
+
+    if (reusablePallet) {
+      await this.putawayPallets(worksheetDetailName[0], reusablePallet, locationName)
+    } else if (cartonId) {
+      await this.putawayCarton(worksheetDetailName, cartonId, locationName)
+    } else {
+      await this.putawayPallet(worksheetDetailName[0], palletId, locationName)
+    }
+  }
+
+  async putawayPallets(worksheetDetailName: string, reusablePallet: Pallet, locationName: string): Promise<void> {
+    const worksheetDetail: WorksheetDetail = await this.findExecutableWorksheetDetailByName(
+      worksheetDetailName,
+      WORKSHEET_TYPE.PUTAWAY,
+      [
+        'worksheet',
+        'worksheet.arrivalNotice',
+        'worksheet.worksheetDetails',
+        'worksheet.worksheetDetails.targetInventory',
+        'worksheet.worksheetDetails.targetInventory.inventory'
+      ]
+    )
+
+    const worksheet: Worksheet = worksheetDetail.worksheet
+    const arrivalNotice: ArrivalNotice = worksheet.arrivalNotice
+    const worksheetDetails: WorksheetDetail[] = worksheet.worksheetDetails
+    const inventories: Inventory[] = await this.trxMgr.getRepository(Inventory).find({
+      where: {
+        domain: { id: this.domain.id },
+        reusablePallet: { id: reusablePallet.id },
+        refOrderId: arrivalNotice.id,
+        status: In([INVENTORY_STATUS.PUTTING_AWAY, INVENTORY_STATUS.UNLOADED])
+      }
+    })
+
+    for (let inventory of inventories) {
+      const worksheetDetail: WorksheetDetail = worksheetDetails.find(
+        (wsd: WorksheetDetail) => wsd.targetInventory.inventory.name === inventory.name
+      )
+
+      let targetInventory: OrderInventory = worksheetDetail.targetInventory
+      inventory = targetInventory.inventory
+
+      let location: Location = await this.trxMgr.getRepository(Location).findOne({
+        where: {
+          domain: { id: this.domain.id },
+          name: locationName,
+          type: In([
+            LOCATION_TYPE.SHELF,
+            LOCATION_TYPE.BUFFER,
+            LOCATION_TYPE.FLOOR,
+            LOCATION_TYPE.QUARANTINE,
+            LOCATION_TYPE.RESERVE
+          ])
+        },
+        relations: ['warehouse']
+      })
+      if (!location) throw new Error(this.ERROR_MSG.FIND.NO_RESULT(locationName))
+      const warehouse: Warehouse = location.warehouse
+      const zone: string = location.zone
+
+      inventory.location = location
+      inventory.status = INVENTORY_STATUS.STORED
+      inventory.warehouse = warehouse
+      inventory.zone = zone
+      await this.transactionInventory(inventory, arrivalNotice, 0, 0, INVENTORY_TRANSACTION_TYPE.PUTAWAY)
+
+      targetInventory.status = ORDER_INVENTORY_STATUS.TERMINATED
+      targetInventory.updater = this.user
+      await this.updateOrderTargets([targetInventory])
+
+      worksheetDetail.status = WORKSHEET_STATUS.DONE
+      worksheetDetail.updater = this.user
+      await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+    }
+  }
+
+  async putawayCarton(worksheetDetailName: [string], cartonId: string, locationName: string): Promise<void> {
+    const worksheetDetails: WorksheetDetail[] = await this.findExecutableWorksheetDetailByNames(
+      worksheetDetailName,
+      WORKSHEET_TYPE.PUTAWAY,
+      ['worksheet', 'worksheet.arrivalNotice', 'targetInventory', 'targetInventory.inventory']
+    )
+
+    for (var i = 0; i < worksheetDetails.length; i++) {
+      const worksheetDetail = worksheetDetails[i]
+      const worksheet: Worksheet = worksheetDetail.worksheet
+      const arrivalNotice: ArrivalNotice = worksheet.arrivalNotice
+      let targetInventory: OrderInventory = worksheetDetail.targetInventory
+      let inventory: Inventory = targetInventory.inventory
+
+      if (inventory.cartonId !== cartonId) {
+        throw new Error(this.ERROR_MSG.VALIDITY.UNEXPECTED_FIELD_VALUE('cartonId', cartonId, inventory.cartonId))
+      }
+
+      const location: Location = await this.trxMgr.getRepository(Location).findOne({
+        where: {
+          domain: { id: this.domain.id },
+          name: locationName,
+          type: In([
+            LOCATION_TYPE.SHELF,
+            LOCATION_TYPE.BUFFER,
+            LOCATION_TYPE.FLOOR,
+            LOCATION_TYPE.BIN,
+            LOCATION_TYPE.QUARANTINE,
+            LOCATION_TYPE.RESERVE
+          ])
+        },
+        relations: ['warehouse']
+      })
+
+      if (!location) throw new Error(this.ERROR_MSG.FIND.NO_RESULT(locationName))
+      const warehouse: Warehouse = location.warehouse
+      //@ts-ignore
+      const zone: string = warehouse.zone
+
+      inventory.location = location
+      inventory.status = INVENTORY_STATUS.STORED
+      inventory.warehouse = warehouse
+      inventory.zone = zone
+      await this.transactionInventory(inventory, arrivalNotice, 0, 0, INVENTORY_TRANSACTION_TYPE.PUTAWAY)
+
+      targetInventory.status = ORDER_INVENTORY_STATUS.TERMINATED
+      targetInventory.updater = this.user
+      await this.updateOrderTargets([targetInventory])
+
+      worksheetDetail.status = WORKSHEET_STATUS.DONE
+      worksheetDetail.updater = this.user
+      await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+    }
+  }
+
+  async putawayPallet(worksheetDetailName: string, palletId: string, locationName: string): Promise<void> {
+    const worksheetDetail: WorksheetDetail = await this.findExecutableWorksheetDetailByName(
+      worksheetDetailName,
+      WORKSHEET_TYPE.PUTAWAY,
+      ['worksheet', 'worksheet.arrivalNotice', 'targetInventory', 'targetInventory.inventory']
+    )
+
+    const worksheet: Worksheet = worksheetDetail.worksheet
+    const arrivalNotice: ArrivalNotice = worksheet.arrivalNotice
+    let targetInventory: OrderInventory = worksheetDetail.targetInventory
+    let inventory: Inventory = targetInventory.inventory
+
+    if (inventory.palletId !== palletId) {
+      throw new Error(this.ERROR_MSG.VALIDITY.UNEXPECTED_FIELD_VALUE('lot ID', palletId, inventory.palletId))
+    }
+
+    const location: Location = await this.trxMgr.getRepository(Location).findOne({
+      where: {
+        domain: { id: this.domain.id },
+        name: locationName,
+        type: In([
+          LOCATION_TYPE.SHELF,
+          LOCATION_TYPE.BUFFER,
+          LOCATION_TYPE.FLOOR,
+          LOCATION_TYPE.QUARANTINE,
+          LOCATION_TYPE.RESERVE
+        ])
+      },
+      relations: ['warehouse']
+    })
+    if (!location) throw new Error(this.ERROR_MSG.FIND.NO_RESULT(locationName))
+    const warehouse: Warehouse = location.warehouse
+    //@ts-ignore
+    const zone: string = warehouse.zone
+
+    inventory.location = location
+    inventory.status = INVENTORY_STATUS.STORED
+    inventory.warehouse = warehouse
+    inventory.zone = zone
+    await this.transactionInventory(inventory, arrivalNotice, 0, 0, INVENTORY_TRANSACTION_TYPE.PUTAWAY)
+
+    targetInventory.status = ORDER_INVENTORY_STATUS.TERMINATED
+    targetInventory.updater = this.user
+    await this.updateOrderTargets([targetInventory])
+
+    worksheetDetail.status = WORKSHEET_STATUS.DONE
+    worksheetDetail.updater = this.user
+    await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+  }
+
+  async undoPutaway(worksheetDetailName: [string], palletId: string, cartonId: string): Promise<void> {
+    if (cartonId) {
+      await this.undoCarton(worksheetDetailName, cartonId)
+    } else {
+      await this.undoPallet(worksheetDetailName[0], palletId)
+    }
+  }
+
+  async undoPallet(worksheetDetailName: string, palletId: string): Promise<void> {
+    let worksheetDetail: WorksheetDetail = await this.findWorksheetDetailByName(worksheetDetailName, [
+      'worksheet',
+      'worksheet.arrivalNotice',
+      'targetInventory',
+      'targetInventory.inventory',
+      'fromLocation'
+    ])
+    this.checkRecordValidity(worksheetDetail, { status: WORKSHEET_STATUS.DONE })
+
+    const worksheet: Worksheet = worksheetDetail.worksheet
+    const arrivalNotice: ArrivalNotice = worksheet.arrivalNotice
+    const targetInventory: OrderInventory = worksheetDetail.targetInventory
+    let inventory: Inventory = await this.trxMgr.getRepository(Inventory).findOne({
+      where: { domain: { id: this.domain.id }, palletId }
+    })
+    await this.checkReleaseTarget(inventory)
+
+    const bufferLocation: Location = await this.trxMgr.getRepository(Location).findOne({
+      where: { domain: { id: this.domain.id }, name: worksheetDetail.fromLocation.name }
+    })
+    inventory.location = bufferLocation
+    inventory.status = INVENTORY_STATUS.UNLOADED
+    await this.transactionInventory(inventory, arrivalNotice, 0, 0, INVENTORY_TRANSACTION_TYPE.UNDO_PUTAWAY)
+
+    targetInventory.status = ORDER_PRODUCT_STATUS.PUTTING_AWAY
+    targetInventory.updater = this.user
+    await this.updateOrderTargets([targetInventory])
+
+    worksheetDetail.status = WORKSHEET_STATUS.EXECUTING
+    worksheetDetail.updater = this.user
+    await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+  }
+
+  async undoCarton(worksheetDetailName: [string], cartonId: string): Promise<void> {
+    let worksheetDetails: WorksheetDetail[] = await this.findWorksheetDetailByNames(worksheetDetailName, [
+      'worksheet',
+      'worksheet.arrivalNotice',
+      'targetInventory',
+      'targetInventory.inventory',
+      'fromLocation'
+    ])
+
+    for (var i = 0; i < worksheetDetails?.length; i++) {
+      const worksheetDetail = worksheetDetails[i]
+      this.checkRecordValidity(worksheetDetail, { status: WORKSHEET_STATUS.DONE })
+      const worksheet: Worksheet = worksheetDetail.worksheet
+      const arrivalNotice: ArrivalNotice = worksheet.arrivalNotice
+      const targetInventory: OrderInventory = worksheetDetail.targetInventory
+      let inventory: Inventory = await this.trxMgr.getRepository(Inventory).findOne({
+        where: { domain: { id: this.domain.id }, cartonId, palletId: targetInventory.inventory.palletId }
+      })
+      await this.checkReleaseTarget(inventory)
+
+      const bufferLocation: Location = await this.trxMgr.getRepository(Location).findOne({
+        where: { domain: { id: this.domain.id }, name: worksheetDetail.fromLocation.name }
+      })
+      inventory.location = bufferLocation
+      inventory.status = INVENTORY_STATUS.UNLOADED
+      await this.transactionInventory(inventory, arrivalNotice, 0, 0, INVENTORY_TRANSACTION_TYPE.UNDO_PUTAWAY)
+
+      targetInventory.status = ORDER_PRODUCT_STATUS.PUTTING_AWAY
+      targetInventory.updater = this.user
+      await this.updateOrderTargets([targetInventory])
+
+      worksheetDetail.status = WORKSHEET_STATUS.EXECUTING
+      worksheetDetail.updater = this.user
+      await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+    }
+  }
+
+  private async checkReleaseTarget(inventory: Inventory): Promise<void> {
+    const releaseTargetInventory: OrderInventory = await this.trxMgr.getRepository(OrderInventory).findOne({
+      where: {
+        domain: { id: this.domain.id },
+        type: ORDER_TYPES.RELEASE_OF_GOODS,
+        inventory: { id: inventory.id }
+      }
+    })
+
+    if (releaseTargetInventory)
+      throw new Error(
+        this.ERROR_MSG.VALIDITY.CANT_PROCEED_STEP_BY('undo putaway', 'this pallet ID has been selected for releasing')
+      )
+  }
+}