@things-factory/operato-wms 4.3.824 → 4.3.826

package/server/graphql/resolvers/transfer-location/check-transfer-location-recommendation.ts

@@ -0,0 +1,123 @@
+import { EntityManager } from 'typeorm'
+
+import { Setting } from '@things-factory/setting-base'
+import { Domain } from '@things-factory/shell'
+import { Inventory, Location, INVENTORY_STATUS, LOCATION_STATUS, calcVolumeInM3, buildProductDetailLabel } from '@things-factory/warehouse-base'
+
+export const checkTransferLocationRecommendation = {
+  async checkTransferLocationRecommendation(
+    _: any,
+    { originPalletId, toLocationName, qty }: { originPalletId: string; toLocationName: string; qty: number },
+    context: any
+  ): Promise<{ warningMessage: string | null }> {
+    const { domain, tx }: { domain: Domain; tx: EntityManager } = context.state
+
+    const levelSetting: Setting = await tx
+      .getRepository(Setting)
+      .findOne({ where: { domain, name: 'location-recommendation-level' } })
+
+    const level = levelSetting?.value?.toUpperCase().trim()
+    if (!level) return { warningMessage: null }
+
+    const inventory: Inventory = await tx
+      .getRepository(Inventory)
+      .createQueryBuilder('inv')
+      .innerJoinAndSelect('inv.product', 'product')
+      .leftJoinAndSelect('inv.productDetail', 'productDetail')
+      .where('inv.domain_id = :domainId', { domainId: domain.id })
+      .andWhere('inv.pallet_id = :palletId', { palletId: originPalletId })
+      .getOne()
+    if (!inventory) return { warningMessage: null } // Return silently. Actual transfer location process will only prompt error
+
+    const toLocation: Location = await tx.getRepository(Location).findOne({ where: { domain, name: toLocationName } })
+    if (!toLocation) return { warningMessage: null } // Return silently. Actual transfer location process will only prompt error
+
+    const inventoriesAtLocation: Inventory[] = await tx
+      .getRepository(Inventory)
+      .createQueryBuilder('inv')
+      .innerJoinAndSelect('inv.product', 'product')
+      .leftJoinAndSelect('inv.productDetail', 'productDetail')
+      .where('inv.domain_id = :domainId', { domainId: domain.id })
+      .andWhere('inv.location_id = :locationId', { locationId: toLocation.id })
+      .andWhere('inv.status = :status', { status: INVENTORY_STATUS.STORED })
+      .getMany()
+
+    switch (level) {
+      case 'LEVEL 1': {
+        if (toLocation.status?.toUpperCase() !== LOCATION_STATUS.EMPTY) {
+          return { warningMessage: 'reminder_location_assigned_to_another_sku' }
+        }
+        break
+      }
+
+      case 'LEVEL 2': {
+        const fromSku = inventory.product?.sku
+        const hasDifferentSku = inventoriesAtLocation.some(inv => inv.product?.sku !== fromSku)
+        if (hasDifferentSku) {
+          return { warningMessage: 'reminder_location_assigned_to_another_sku' }
+        }
+        break
+      }
+
+      case 'LEVEL 3': {
+        const fromSku = inventory.product?.sku
+        const hasDifferentSku = inventoriesAtLocation.some(inv => inv.product?.sku !== fromSku)
+
+        const stackingSetting: Setting = await tx.getRepository(Setting).findOne({ where: { domain, name: 'stacking-option-limit' } })
+
+        let maxLimit = 1
+        if (stackingSetting?.value) {
+          try {
+            const parsed = JSON.parse(stackingSetting.value)
+            maxLimit = Number(parsed.Max) || 1
+          } catch {
+            // ignore malformed setting
+          }
+        }
+
+        const stackingLimit = inventory.product?.allowStackingOption ? maxLimit : null
+        const hitStackingLimit = stackingLimit != null && inventoriesAtLocation.length >= stackingLimit
+
+        if (hasDifferentSku || hitStackingLimit) {
+          return { warningMessage: 'reminder_location_occupied_by_different_sku_or_stacking_capacity' }
+        }
+        break
+      }
+
+      case 'LEVEL 4': {
+        if (!toLocation.volume) return { warningMessage: 'location_missing_volume' }
+
+        // Check selected inventory's product
+        const incomingPd = inventory.productDetail
+        const incomingInvalid =
+          !incomingPd?.lengthUnit ||
+          (incomingPd?.volume == null && (!incomingPd?.width || !incomingPd?.depth || !incomingPd?.height))
+        if (incomingInvalid) return { warningMessage: 'incoming_inventory_missing_product_dimensions' }
+
+        // Check products stored in the targeted destination location
+        const existingInvalid = inventoriesAtLocation.some(inv => {
+          const pd = inv.productDetail
+          return !pd?.lengthUnit || (pd?.volume == null && (!pd?.width || !pd?.depth || !pd?.height))
+        })
+        if (existingInvalid) return { warningMessage: 'existing_inventory_missing_product_dimensions' }
+
+
+        const locationVolume = toLocation.volume
+        const existingVolume = inventoriesAtLocation.reduce((sum, inv) => {
+          const pd = inv.productDetail
+          const detail = buildProductDetailLabel(pd)
+          const label = `SKU: ${inv.product?.sku} ${detail}`.trim()
+          return sum + calcVolumeInM3(pd, label) * (inv.qty ?? 0)
+        }, 0)
+
+        const incomingDetail = buildProductDetailLabel(incomingPd)
+        const incomingLabel = `SKU: ${inventory.product?.sku} ${incomingDetail}`.trim()
+        if (existingVolume + calcVolumeInM3(incomingPd, incomingLabel) * qty > locationVolume) return { warningMessage: 'volume_over_location_capacity' }
+        break
+      }
+    }
+
+    return { warningMessage: null }
+  }
+}
+

package/server/graphql/resolvers/transfer-location/index.ts

@@ -0,0 +1,7 @@
+import { checkTransferLocationRecommendation } from './check-transfer-location-recommendation'
+
+export const Query = {
+  ...checkTransferLocationRecommendation
+}
+
+export const Mutation = {}

package/server/graphql/resolvers/zone-worksheet/zone-worksheet.ts

@@ -75,16 +75,6 @@ export const zonePickingWorksheet = {
       where: { worksheet }
     })
 
-    // Lightweight pre-pass: only the columns needed to compute invIds, roIds, and
-    // isCompletable. Avoids running the heavy joined SELECT (product/inventory/
-    // location/productDetail/...) twice — the second, filtered getMany() below
-    // produces the rows actually returned to the client.
-    const orderInventories: OrderInventory[] = await getRepository(OrderInventory)
-      .createQueryBuilder('oi')
-      .select(['oi.id', 'oi.inventoryId', 'oi.releaseGoodId', 'oi.status'])
-      .where('oi.ref_worksheet_id = :worksheetId', { worksheetId: worksheet.id })
-      .getMany()
-
     //fetch order inventories
     let qb = getRepository(OrderInventory)
       .createQueryBuilder('oi')
@@ -97,6 +87,9 @@ export const zonePickingWorksheet = {
       .leftJoinAndSelect('pd.parentProductDetails', 'ppd')
       .where('ref_worksheet_id = :worksheetId', { worksheetId: worksheet.id })
 
+    //get all oi to find inventory changes and determine if the worksheet is completable
+    const orderInventories: OrderInventory[] = await qb.getMany()
+
     //item assigned to obsolete inventories will not be displayed during picking
     if (filter) {
       qb.andWhere('rg.status != :orderStatus', { orderStatus: ORDER_STATUS.OBSOLETE })
@@ -181,10 +174,6 @@ export const zonePickingWorksheet = {
 }
 
 function isCompletable(oi: OrderInventory[], ic: InventoryChange[]): String {
-  // NOTE: callers may pass a partial OrderInventory with only id/inventoryId/
-  // releaseGoodId/status populated (see the lightweight pre-pass in
-  // zonePickingWorksheet). Don't reference other fields here without first
-  // widening that SELECT.
   //find processing oi and check if there is any pending inventory adjustment
   let processingOi = oi.filter(item => item.status === ORDER_INVENTORY_STATUS.PROCESSING)
 

package/server/graphql/types/index.ts

@@ -7,6 +7,7 @@ import * as OpaMenu from './opa-menu'
 import * as Reports from './reports'
 import * as InventoryComparison from './inventory-comparison'
 import * as ShippingProvider from './shipping-provider'
+import * as TransferLocation from './transfer-location'
 import * as WarehouseInventory from './warehouse-inventory-adjustment'
 import * as RouteLabel from './route-label'
 import * as ZoneWorksheet from './zone-worksheet'
@@ -22,6 +23,7 @@ export const queries = [
   InventoryComparison.Query,
   ShippingProvider.Query,
   Other.Query,
+  TransferLocation.Query,
   RouteLabel.Query,
   ZoneWorksheet.Query,
   Outbound.Query
@@ -44,6 +46,7 @@ export const types = [
   ...InventoryComparison.Types,
   ...ShippingProvider.Types,
   ...Other.Types,
+  ...TransferLocation.Types,
   ...RouteLabel.Types,
   ...ZoneWorksheet.Types,
   ...Outbound.Types

package/server/graphql/types/transfer-location/index.ts

@@ -0,0 +1,13 @@
+import { TransferLocationRecommendationResult } from './transfer-location-recommendation'
+
+export const Query = `
+  checkTransferLocationRecommendation(
+    originPalletId: String!
+    toLocationName: String!
+    qty: Float!
+  ): TransferLocationRecommendationResult @privilege(category: "inventory", privilege: "query") @transaction
+`
+
+export const Mutation = ``
+
+export const Types = [TransferLocationRecommendationResult]

package/server/graphql/types/transfer-location/transfer-location-recommendation.ts

@@ -0,0 +1,7 @@
+import gql from 'graphql-tag'
+
+export const TransferLocationRecommendationResult = gql`
+  type TransferLocationRecommendationResult {
+    warningMessage: String
+  }
+`

package/translations/en.json

@@ -425,6 +425,9 @@
   "field.latest_execution_to_date": "latest execution to date",
   "field.latest_execution": "latest execution",
   "field.latlng": "latlng",
+  "field.length_m": "length (m)",
+  "field.width_m": "width (m)",
+  "field.height_m": "height (m)",
   "field.length_unit": "length unit",
   "field.level_end": "level end",
   "field.level_start": "level start",
@@ -814,6 +817,7 @@
   "field.vehicle_no": "vehicle no",
   "field.view": "view",
   "field.volume_m3": "volume (M3)",
+  "field.class": "Class",
   "field.volume_size": "volume size",
   "field.volume": "volume",
   "field.w/h": "W/H",
@@ -1566,6 +1570,9 @@
   "text.goods_received_note_has_been_sent_successfully": "GRN has been sent successfully",
   "text.group_quantity_cannot_be_negative": "group quantity cannot be negative",
   "text.group_quantity_cannot_be_zero": "group quantity cannot be zero",
+  "text.value_must_be_greater_than_zero": "value must be greater than 0",
+  "text.cannot_update_class_for_quarantine_or_damage_location": "Class is not supported for Quarantine and Damage location types. Please select a different location type.",
+  "text.missing_product_dimensions_for_level_4": "Some products are missing dimensions. Please provide width, depth, height (or volume) and length unit in the product master. You may still proceed to create GAN.",
   "text.group_quantity_exceeds_total": "group quantity cannot exceed total quantity",
   "text.holder_field_is_empty": "holder field is empty",
   "text.inbound": "inbound",
@@ -1974,6 +1981,11 @@
   "text.tracking_no_duplicated": "tracking no duplicated",
   "text.reminder_location_assigned_to_another_sku": "This location is already assigned to another SKU.",
   "text.reminder_location_occupied_by_different_sku_or_stacking_capacity": "This location is occupied by a different SKU or has reached its stacking capacity.",
+  "text.location_missing_volume": "To location does not have a volume set. Please update the Location Master.",
+  "text.existing_inventory_missing_product_dimensions": "Inventory at the destination location is missing product dimensions or length unit. Please update the product details.",
+  "text.incoming_inventory_missing_product_dimensions": "The selected inventory is missing product dimensions or length unit. Please update the product details.",
+  "text.volume_over_location_capacity": "Reminder: The volume for this inventory is over the Location Volume",
+  "text.may_proceed_without_level_4_recommendation": "You may still proceed without level 4 recommendation checking",
   "text.transfer_inventory_to_different_location": "transfer inventory to different location",
   "text.transfer_location_completed": "transfer location completed",
   "text.transfer_qty_cannot_exceed_3_decimal_places": "Transfer qty cannot exceed 3 decimal places",

package/translations/ko.json

@@ -426,6 +426,9 @@
   "field.label_id_for_location": "로케이션 라벨 아이디",
   "field.label_id_for_pallet": "파레트 라벨 아이디",
   "field.latlng": "위경도",
+  "field.length_m": "길이 (m)",
+  "field.width_m": "너비 (m)",
+  "field.height_m": "높이 (m)",
   "field.length_unit": "길이 단위",
   "field.level_end": "level end",
   "field.level_start": "level start",
@@ -794,6 +797,7 @@
   "field.view": "보기",
   "field.volume": "볼륨",
   "field.volume_m3": "[ko] volume (M3)",
+  "field.class": "클래스",
   "field.volume_size": "[ko]volume size",
   "field.w/h": "창고",
   "field.warehouse_name": "창고명",
@@ -1529,6 +1533,9 @@
   "text.goods_received_note_uploaded": "text.goods_received_note_uploaded",
   "text.group_quantity_cannot_be_negative": "그룹 수량은 음수가 될 수 없습니다",
   "text.group_quantity_cannot_be_zero": "그룹 수량은 0이 될 수 없습니다",
+  "text.value_must_be_greater_than_zero": "값은 0보다 커야 합니다",
+  "text.cannot_update_class_for_quarantine_or_damage_location": "클래스는 검역 및 손상 위치 유형에 지원되지 않습니다. 다른 위치 유형을 선택하세요.",
+  "text.missing_product_dimensions_for_level_4": "일부 제품의 치수가 누락되었습니다. 제품 마스터에서 너비, 깊이, 높이(또는 부피)와 길이 단위를 입력해 주세요. GAN 생성을 계속 진행할 수 있습니다.",
   "text.group_quantity_exceeds_total": "그룹 수량이 총 수량을 초과할 수 없습니다",
   "text.holder_field_is_empty": "[ko] holder field is empty",
   "text.inbound": "[ko]inbound",
@@ -1953,6 +1960,11 @@
   "text.tracking_no_deleted": "[ko] tracking no deleted",
   "text.reminder_location_assigned_to_another_sku": "이 위치는 이미 다른 SKU에 할당되어 있습니다.",
   "text.reminder_location_occupied_by_different_sku_or_stacking_capacity": "이 위치는 다른 SKU가 점유하고 있거나 적재 용량에 도달했습니다.",
+  "text.location_missing_volume": "이동할 위치에 부피가 설정되어 있지 않습니다. 위치 마스터를 업데이트하세요.",
+  "text.existing_inventory_missing_product_dimensions": "목적지 위치에 이미 보관된 재고 중 제품 치수 또는 길이 단위가 없는 항목이 있습니다. 제품 세부 정보를 업데이트하세요.",
+  "text.incoming_inventory_missing_product_dimensions": "선택된 재고에 제품 치수 또는 길이 단위가 없습니다. 제품 세부 정보를 업데이트하세요.",
+  "text.volume_over_location_capacity": "알림: 이 재고의 부피가 위치 부피를 초과합니다",
+  "text.may_proceed_without_level_4_recommendation": "레벨 4 추천 검사 없이 진행할 수 있습니다",
   "text.transfer_inventory_to_different_location": "[ko] transfer inventory to different location",
   "text.transfer_location_completed": "이동 완료",
   "text.transfer_quantity_cannot_be_uploaded_as_it_does_not_meet_the_minimum_required_quantity": "[ko] transfer quantity cannot be uploaded as it does not meet the minimum required quantity",

package/translations/ms.json

@@ -445,6 +445,9 @@
   "field.latest_execution_from_date": "pengendalian terakhir dari tarikh",
   "field.latest_execution_to_date": "pengendalian terakhir hingga tarikh",
   "field.latlng": "latlng",
+  "field.length_m": "panjang (m)",
+  "field.width_m": "lebar (m)",
+  "field.height_m": "tinggi (m)",
   "field.length_unit": "unit panjang",
   "field.level_end": "pengakhiran peringkat",
   "field.level_start": "permulaan peringkat",
@@ -837,6 +840,7 @@
   "field.view": "paparan",
   "field.volume": "volume",
   "field.volume_m3": "volume (M3)",
+  "field.class": "Kelas",
   "field.volume_size": "saiz volume",
   "field.w/h": "W/H",
   "field.warehouse": "gudang",
@@ -1577,6 +1581,9 @@
   "text.goods_received_note_has_been_sent_successfully": "GRN berjaya dihantar",
   "text.group_quantity_cannot_be_negative": "kuantiti kumpulan tidak boleh negatif",
   "text.group_quantity_cannot_be_zero": "kuantiti kumpulan tidak boleh sifar",
+  "text.value_must_be_greater_than_zero": "value mesti lebih daripada 0",
+  "text.cannot_update_class_for_quarantine_or_damage_location": "Kelas tidak disokong untuk jenis lokasi Kuarantin dan Rosak. Sila pilih jenis lokasi yang lain.",
+  "text.missing_product_dimensions_for_level_4": "Sesetengah produk tiada dimensi. Sila masukkan lebar, kedalaman, tinggi (atau isipadu) dan unit panjang dalam rekod induk produk. Anda masih boleh teruskan untuk mencipta GAN.",
   "text.group_quantity_exceeds_total": "kuantiti kumpulan tidak boleh melebihi jumlah keseluruhan",
   "text.holder_field_is_empty": "ruangan pemilik kosong",
   "text.inbound": "masuk",
@@ -2006,6 +2013,11 @@
   "text.tracking_no_duplicated": "no. penjejak duplikat",
   "text.reminder_location_assigned_to_another_sku": "Lokasi ini sudah ditetapkan kepada SKU lain.",
   "text.reminder_location_occupied_by_different_sku_or_stacking_capacity": "Lokasi ini diduduki oleh SKU yang berbeza atau telah mencapai kapasiti susunan.",
+  "text.location_missing_volume": "Lokasi destinasi tidak mempunyai isipadu yang ditetapkan. Sila kemaskini Lokasi Master.",
+  "text.existing_inventory_missing_product_dimensions": "Inventori di lokasi destinasi tiada dimensi produk atau unit panjang. Sila kemaskini butiran produk.",
+  "text.incoming_inventory_missing_product_dimensions": "Inventori terpilih tiada dimensi produk atau unit panjang. Sila kemaskini butiran produk.",
+  "text.volume_over_location_capacity": "Peringatan: Isipadu inventori ini melebihi isipadu lokasi",
+  "text.may_proceed_without_level_4_recommendation": "Anda masih boleh meneruskan tanpa semakan cadangan tahap 4",
   "text.transfer_inventory_to_different_location": "transfer inventori ke lokasi berlainan",
   "text.transfer_location_completed": "transfer lokasi telah selesai",
   "text.transfer_qty_cannot_exceed_3_decimal_places": "kuantiti transfer tidak boleh melebihi 3 tempat perpuluhan",

package/translations/zh.json

@@ -445,6 +445,9 @@
   "field.latest_execution_from_date": "最新执行从日期",
   "field.latest_execution_to_date": "最新执行到日期",
   "field.latlng": "经纬度",
+  "field.length_m": "长度 (m)",
+  "field.width_m": "宽度 (m)",
+  "field.height_m": "高度 (m)",
   "field.length_unit": "长度单位",
   "field.level_end": "层级结束",
   "field.level_start": "层级开始",
@@ -842,6 +845,7 @@
   "field.view": "视图",
   "field.volume": "体积",
   "field.volume_m3": "体积 (M3)",
+  "field.class": "分类",
   "field.volume_size": "体积大小",
   "field.w/h": "W/H",
   "field.warehouse": "仓库",
@@ -1603,6 +1607,9 @@
   "text.goods_received_note_has_been_sent_successfully": "GRN已发送成功",
   "text.group_quantity_cannot_be_negative": "分组数量不能为负数",
   "text.group_quantity_cannot_be_zero": "分组数量不能为零",
+  "text.value_must_be_greater_than_zero": "值必须大于0",
+  "text.cannot_update_class_for_quarantine_or_damage_location": "隔离和损坏位置类型不支持分类。请选择其他位置类型。",
+  "text.missing_product_dimensions_for_level_4": "部分产品缺少尺寸信息。请在产品主数据中提供宽度、深度、高度（或体积）及长度单位。您仍可继续创建GAN。",
   "text.group_quantity_exceeds_total": "分组数量不能超过总数量",
   "text.holder_field_is_empty": "持有人字段为空",
   "text.inbound": "入库",
@@ -2039,6 +2046,11 @@
   "text.tracking_no_duplicated": "跟踪号已重复",
   "text.reminder_location_assigned_to_another_sku": "此位置已分配给另一个SKU。",
   "text.reminder_location_occupied_by_different_sku_or_stacking_capacity": "此位置已被不同SKU占用或已达到堆叠容量。",
+  "text.location_missing_volume": "目标位置未设置体积。请更新位置主数据。",
+  "text.existing_inventory_missing_product_dimensions": "目标位置已存放的库存中存在缺少产品尺寸或长度单位的记录。请更新产品详情。",
+  "text.incoming_inventory_missing_product_dimensions": "所选待转移库存缺少产品尺寸或长度单位。请更新产品详情。",
+  "text.volume_over_location_capacity": "提醒：此库存的体积超过了库位体积",
+  "text.may_proceed_without_level_4_recommendation": "您仍可在不进行第4级推荐检查的情况下继续操作",
   "text.transfer_inventory_to_different_location": "转移库存到不同位置",
   "text.transfer_location_completed": "转移位置已完成",
   "text.transfer_qty_cannot_exceed_3_decimal_places": "转移数量不能超过3个小数位",