@rytass/wms-module-core 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/README.md +15 -2
  2. package/docs/README.md +2 -2
  3. package/docs/api-reference.md +129 -10
  4. package/docs/host-integration.md +172 -0
  5. package/docs/integration-guide.md +84 -43
  6. package/index.cjs.js +2454 -1658
  7. package/index.d.ts +2 -0
  8. package/lib/events/inventory-count-lock.subscriber.d.ts +17 -5
  9. package/lib/models/metadata/index.d.ts +1 -0
  10. package/lib/models/metadata/sequence.entity.d.ts +9 -0
  11. package/lib/models/models.module.d.ts +7 -0
  12. package/lib/services/allocate-inventory-order.service.d.ts +3 -3
  13. package/lib/services/batch.service.d.ts +13 -1
  14. package/lib/services/consumption-order.service.d.ts +6 -6
  15. package/lib/services/helper.service.d.ts +10 -4
  16. package/lib/services/hold-inventory-order.service.d.ts +3 -3
  17. package/lib/services/index.d.ts +1 -0
  18. package/lib/services/inventory-count-order.service.d.ts +28 -9
  19. package/lib/services/loader.service.d.ts +11 -3
  20. package/lib/services/material.service.d.ts +1 -1
  21. package/lib/services/merge-batch-order.service.d.ts +2 -2
  22. package/lib/services/quality-inspection-order.service.d.ts +1 -1
  23. package/lib/services/receive-inventory-order.service.d.ts +4 -4
  24. package/lib/services/reclassify-inventory-order.service.d.ts +2 -2
  25. package/lib/services/scrape.service.d.ts +1 -1
  26. package/lib/services/sequence.service.d.ts +58 -0
  27. package/lib/services/ship-inventory-order.service.d.ts +6 -6
  28. package/lib/services/split-batch-order.service.d.ts +2 -2
  29. package/lib/services/stock.service.d.ts +48 -2
  30. package/lib/services/transfer-customer-order.service.d.ts +3 -3
  31. package/lib/services/transfer-order.service.d.ts +7 -5
  32. package/lib/services/transfer-vendor-order.service.d.ts +3 -3
  33. package/lib/table-prefix/logical-table-name.d.ts +21 -0
  34. package/lib/table-prefix/table-prefix.d.ts +30 -0
  35. package/lib/typings/core-module-options.d.ts +31 -0
  36. package/lib/typings/create-transfer-order.input.d.ts +2 -0
  37. package/lib/typings/index.d.ts +20 -0
  38. package/lib/utils/run-in-transaction.d.ts +23 -0
  39. package/lib/utils/table-path.d.ts +13 -0
  40. package/package.json +9 -6
  41. package/index.js +0 -98
  42. package/lib/constants/consumption-change-kind.js +0 -20
  43. package/lib/constants/inventory-count-status.js +0 -22
  44. package/lib/constants/operations.js +0 -76
  45. package/lib/constants/order-type.js +0 -33
  46. package/lib/constants/stock-status.js +0 -61
  47. package/lib/core.module.js +0 -287
  48. package/lib/events/dispatch-scope.js +0 -29
  49. package/lib/events/inventory-count-lock.subscriber.js +0 -98
  50. package/lib/events/stock-change.subscriber.js +0 -252
  51. package/lib/events/wms-event.collector.js +0 -22
  52. package/lib/events/wms-event.dispatcher.js +0 -63
  53. package/lib/events/wms-event.tokens.js +0 -12
  54. package/lib/events/wms-operation-runner.js +0 -101
  55. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.js +0 -40
  56. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.js +0 -104
  57. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order.entity.js +0 -33
  58. package/lib/models/extensions/consumption-order/consumption-order-change.entity.js +0 -59
  59. package/lib/models/extensions/consumption-order/consumption-order-item.entity.js +0 -114
  60. package/lib/models/extensions/consumption-order/consumption-order.entity.js +0 -69
  61. package/lib/models/extensions/hold-inventory-order/hold-inventory-order-change.entity.js +0 -40
  62. package/lib/models/extensions/hold-inventory-order/hold-inventory-order-item.entity.js +0 -98
  63. package/lib/models/extensions/hold-inventory-order/hold-inventory-order.entity.js +0 -43
  64. package/lib/models/extensions/inventory-count-order/inventory-count-order-change.entity.js +0 -50
  65. package/lib/models/extensions/inventory-count-order/inventory-count-order-item.entity.js +0 -191
  66. package/lib/models/extensions/inventory-count-order/inventory-count-order.entity.js +0 -155
  67. package/lib/models/extensions/merge-batch-order/merge-batch-order-change.entity.js +0 -40
  68. package/lib/models/extensions/merge-batch-order/merge-batch-order-item.entity.js +0 -75
  69. package/lib/models/extensions/merge-batch-order/merge-batch-order.entity.js +0 -33
  70. package/lib/models/extensions/order-reference/order-reference.entity.js +0 -95
  71. package/lib/models/extensions/quality-inspection-order/quality-inspection-order-change.entity.js +0 -45
  72. package/lib/models/extensions/quality-inspection-order/quality-inspection-order-item.entity.js +0 -94
  73. package/lib/models/extensions/quality-inspection-order/quality-inspection-order.entity.js +0 -38
  74. package/lib/models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js +0 -46
  75. package/lib/models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js +0 -89
  76. package/lib/models/extensions/receive-inventory-order/receive-inventory-order.entity.js +0 -57
  77. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.js +0 -40
  78. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.js +0 -75
  79. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.js +0 -33
  80. package/lib/models/extensions/scrape-order/scrape-order-change.entity.js +0 -40
  81. package/lib/models/extensions/scrape-order/scrape-order-item.entity.js +0 -94
  82. package/lib/models/extensions/scrape-order/scrape-order.entity.js +0 -33
  83. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-change.entity.js +0 -46
  84. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js +0 -90
  85. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js +0 -65
  86. package/lib/models/extensions/ship-inventory-order/ship-inventory-order.entity.js +0 -56
  87. package/lib/models/extensions/split-batch-order/split-batch-order-change.entity.js +0 -40
  88. package/lib/models/extensions/split-batch-order/split-batch-order-item.entity.js +0 -75
  89. package/lib/models/extensions/split-batch-order/split-batch-order.entity.js +0 -33
  90. package/lib/models/extensions/transfer-customer-order/transfer-customer-order-change.entity.js +0 -40
  91. package/lib/models/extensions/transfer-customer-order/transfer-customer-order-item.entity.js +0 -99
  92. package/lib/models/extensions/transfer-customer-order/transfer-customer-order.entity.js +0 -33
  93. package/lib/models/extensions/transfer-order/transfer-order-change.entity.js +0 -40
  94. package/lib/models/extensions/transfer-order/transfer-order-item.entity.js +0 -109
  95. package/lib/models/extensions/transfer-order/transfer-order.entity.js +0 -53
  96. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.js +0 -40
  97. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.js +0 -99
  98. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order.entity.js +0 -33
  99. package/lib/models/metadata/batch-group.entity.js +0 -31
  100. package/lib/models/metadata/batch.entity.js +0 -131
  101. package/lib/models/metadata/loader-type.entity.js +0 -43
  102. package/lib/models/metadata/loader-unit.entity.js +0 -21
  103. package/lib/models/metadata/loader.entity.js +0 -98
  104. package/lib/models/metadata/location.entity.js +0 -28
  105. package/lib/models/metadata/material-unit.entity.js +0 -51
  106. package/lib/models/metadata/material.entity.js +0 -28
  107. package/lib/models/metadata/order.entity.js +0 -5
  108. package/lib/models/metadata/sale-order.entity.js +0 -21
  109. package/lib/models/metadata/stock.entity.js +0 -29
  110. package/lib/models/metadata/unit.entity.js +0 -21
  111. package/lib/models/models.module.js +0 -158
  112. package/lib/models/wms-entities.js +0 -82
  113. package/lib/services/allocate-inventory-order.service.js +0 -310
  114. package/lib/services/base-order.service.js +0 -76
  115. package/lib/services/batch.service.js +0 -272
  116. package/lib/services/consumption-order.service.js +0 -504
  117. package/lib/services/helper.service.js +0 -28
  118. package/lib/services/hold-inventory-order.service.js +0 -296
  119. package/lib/services/inventory-count-order.service.js +0 -648
  120. package/lib/services/loader.service.js +0 -291
  121. package/lib/services/location.service.js +0 -139
  122. package/lib/services/material.service.js +0 -181
  123. package/lib/services/merge-batch-order.service.js +0 -206
  124. package/lib/services/order-reference.service.js +0 -136
  125. package/lib/services/quality-inspection-order.service.js +0 -146
  126. package/lib/services/receive-inventory-order.service.js +0 -468
  127. package/lib/services/reclassify-inventory-order.service.js +0 -192
  128. package/lib/services/sale-order.service.js +0 -20
  129. package/lib/services/scrape.service.js +0 -150
  130. package/lib/services/ship-inventory-order.service.js +0 -610
  131. package/lib/services/split-batch-order.service.js +0 -191
  132. package/lib/services/stock.service.js +0 -559
  133. package/lib/services/transfer-customer-order.service.js +0 -290
  134. package/lib/services/transfer-order.service.js +0 -641
  135. package/lib/services/transfer-vendor-order.service.js +0 -290
  136. package/lib/services/unit.service.js +0 -76
  137. package/lib/services/warehouse-map.service.js +0 -50
  138. package/lib/typings/core-module-options.js +0 -3
  139. package/lib/typings/entity-overrides.d.ts +0 -34
  140. package/lib/typings/entity-overrides.js +0 -7
  141. package/lib/typings/find-receive-inventory-order.input.js +0 -9
  142. package/lib/typings/find-ship-inventory-order.input.js +0 -9
  143. package/src/lib/models/extensions/README.md +0 -219
@@ -1,610 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject } from '@nestjs/common';
3
- import { ShipInventoryOrderEntity } from '../models/extensions/ship-inventory-order/ship-inventory-order.entity.js';
4
- import { ShipInventoryOrderItemEntity } from '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js';
5
- import { DataSource, IsNull, In } from 'typeorm';
6
- import { ShipInventoryOrderStatus } from '../typings/find-ship-inventory-order.input.js';
7
- import '../models/metadata/batch.entity.js';
8
- import '../models/metadata/batch-group.entity.js';
9
- import '../models/metadata/loader.entity.js';
10
- import '../models/metadata/loader-type.entity.js';
11
- import '../models/metadata/loader-unit.entity.js';
12
- import '../models/metadata/location.entity.js';
13
- import '../models/metadata/material.entity.js';
14
- import '../models/metadata/material-unit.entity.js';
15
- import '@rytass/wms-base-nestjs-module';
16
- import { SaleOrderEntity } from '../models/metadata/sale-order.entity.js';
17
- import '../models/metadata/stock.entity.js';
18
- import '../models/metadata/unit.entity.js';
19
- import { WmsEntities } from '../models/wms-entities.js';
20
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js';
21
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.js';
22
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js';
23
- import { ShipInventoryOrderReferenceEntity } from '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js';
24
- import { ShipInventoryOrderChangeEntityClass } from '../models/extensions/ship-inventory-order/ship-inventory-order-change.entity.js';
25
- import '../models/extensions/transfer-order/transfer-order.entity.js';
26
- import '../models/extensions/transfer-order/transfer-order-item.entity.js';
27
- import '../models/extensions/transfer-order/transfer-order-change.entity.js';
28
- import '../models/extensions/hold-inventory-order/hold-inventory-order.entity.js';
29
- import '../models/extensions/hold-inventory-order/hold-inventory-order-item.entity.js';
30
- import '../models/extensions/hold-inventory-order/hold-inventory-order-change.entity.js';
31
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order.entity.js';
32
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.js';
33
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.js';
34
- import '../models/extensions/split-batch-order/split-batch-order.entity.js';
35
- import '../models/extensions/split-batch-order/split-batch-order-item.entity.js';
36
- import '../models/extensions/split-batch-order/split-batch-order-change.entity.js';
37
- import '../models/extensions/merge-batch-order/merge-batch-order.entity.js';
38
- import '../models/extensions/merge-batch-order/merge-batch-order-item.entity.js';
39
- import '../models/extensions/merge-batch-order/merge-batch-order-change.entity.js';
40
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.js';
41
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.js';
42
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.js';
43
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order.entity.js';
44
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.js';
45
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.js';
46
- import '../models/extensions/quality-inspection-order/quality-inspection-order.entity.js';
47
- import '../models/extensions/quality-inspection-order/quality-inspection-order-item.entity.js';
48
- import '../models/extensions/quality-inspection-order/quality-inspection-order-change.entity.js';
49
- import '../models/extensions/transfer-customer-order/transfer-customer-order.entity.js';
50
- import '../models/extensions/transfer-customer-order/transfer-customer-order-item.entity.js';
51
- import '../models/extensions/transfer-customer-order/transfer-customer-order-change.entity.js';
52
- import '../models/extensions/scrape-order/scrape-order.entity.js';
53
- import '../models/extensions/scrape-order/scrape-order-item.entity.js';
54
- import '../models/extensions/scrape-order/scrape-order-change.entity.js';
55
- import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
56
- import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
57
- import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
58
- import '../models/extensions/consumption-order/consumption-order.entity.js';
59
- import '../models/extensions/consumption-order/consumption-order-item.entity.js';
60
- import '../models/extensions/consumption-order/consumption-order-change.entity.js';
61
- import '../models/extensions/order-reference/order-reference.entity.js';
62
- import { MaterialService } from './material.service.js';
63
- import { BatchService } from './batch.service.js';
64
- import { StockService } from './stock.service.js';
65
-
66
- /**
67
- * Service for managing ship inventory orders and their items
68
- * Supports dynamic entity injection for customization
69
- * T - Ship Inventory Order entity type
70
- * K - Ship Inventory Order Item entity type
71
- */
72
- let ShipInventoryOrderService = class ShipInventoryOrderService {
73
- dataSource;
74
- entities;
75
- materialService;
76
- batchService;
77
- stockService;
78
- shipInventoryOrderEntity;
79
- shipInventoryOrderItemEntity;
80
- shipInventoryOrderReferenceEntity;
81
- saleOrderEntity;
82
- selectQueryBuilder;
83
- constructor(dataSource, entities, materialService, batchService, stockService, shipInventoryOrderEntity, shipInventoryOrderItemEntity, shipInventoryOrderReferenceEntity, saleOrderEntity) {
84
- this.dataSource = dataSource;
85
- this.entities = entities;
86
- this.materialService = materialService;
87
- this.batchService = batchService;
88
- this.stockService = stockService;
89
- this.shipInventoryOrderEntity = shipInventoryOrderEntity;
90
- this.shipInventoryOrderItemEntity = shipInventoryOrderItemEntity;
91
- this.shipInventoryOrderReferenceEntity = shipInventoryOrderReferenceEntity;
92
- this.saleOrderEntity = saleOrderEntity;
93
- this.selectQueryBuilder = (alias) => {
94
- return this.dataSource
95
- .getRepository(this.shipInventoryOrderEntity)
96
- .createQueryBuilder(alias)
97
- .leftJoin((subQuery) => subQuery
98
- .select(`CASE
99
- WHEN o."removedAt" IS NOT NULL THEN '${ShipInventoryOrderStatus.REMOVED}'
100
- WHEN COALESCE(change_sums.shippedsum, 0) >= COALESCE(target_sum.targetsum, 0) AND COALESCE(target_sum.targetsum, 0) > 0 THEN '${ShipInventoryOrderStatus.SHIPPED}'
101
- WHEN COALESCE(change_sums.shippedsum, 0) > 0 AND COALESCE(change_sums.shippedsum, 0) < COALESCE(target_sum.targetsum, 0) THEN '${ShipInventoryOrderStatus.PARTIAL_SHIPPED}'
102
- ELSE '${ShipInventoryOrderStatus.PENDING}'
103
- END`, 'status')
104
- .addSelect('o.id', 'orderid')
105
- .from('ship_inventory_orders', 'o')
106
- .leftJoin((sumQuery) => sumQuery
107
- .select('i."orderId"', 'orderid')
108
- .addSelect(`SUM(CAST(i."targetShippedQuantity" AS NUMERIC))`, 'targetsum')
109
- .from('ship_inventory_order_items', 'i')
110
- .groupBy('i."orderId"'), 'target_sum', 'target_sum.orderid = o.id')
111
- .leftJoin((sumQuery) => sumQuery
112
- .select('i."orderId"', 'orderid')
113
- .addSelect(`SUM(CASE WHEN CAST(c."quantityChanged" AS NUMERIC) < 0 THEN ABS(CAST(c."quantityChanged" AS NUMERIC)) ELSE 0 END)`, 'shippedsum')
114
- .from('ship_inventory_order_changes', 'c')
115
- .innerJoin('ship_inventory_order_items', 'i', 'c."itemId" = i.id')
116
- .groupBy('i."orderId"'), 'change_sums', 'change_sums.orderid = o.id'), 'order_status', `${alias}.id = order_status.orderid`)
117
- .select('orders.id', 'id')
118
- .addSelect('orders.key', 'key')
119
- .addSelect('orders.description', 'description')
120
- .addSelect('orders."createdBy"', 'createdBy')
121
- .addSelect('orders."createdAt"', 'createdAt')
122
- .addSelect('orders."removedAt"', 'removedAt')
123
- .addSelect('order_status.status', `status`);
124
- };
125
- }
126
- processShipInventoryOrderReferences(references, manager) {
127
- const materialRepository = manager.getRepository(this.materialService.materialEntity);
128
- const saleOrderRepository = manager.getRepository(this.saleOrderEntity);
129
- return references.reduce(async (accPromise, reference) => {
130
- const acc = await accPromise;
131
- try {
132
- const material = await materialRepository.findOneBy({
133
- key: reference.materialKey,
134
- });
135
- if (!material)
136
- return acc;
137
- if (reference.saleId && reference.saleSerialId)
138
- await saleOrderRepository.save(saleOrderRepository.create({
139
- id: reference.saleId,
140
- serialId: reference.saleSerialId,
141
- }));
142
- return [
143
- ...acc,
144
- {
145
- ...reference,
146
- materialId: material.id,
147
- },
148
- ];
149
- }
150
- catch {
151
- return acc;
152
- }
153
- }, Promise.resolve([]));
154
- }
155
- async processShipInventoryOrderItems(items, manager) {
156
- const shipInventoryOrderItemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
157
- const shipInventoryOrderChangeRepository = manager.getRepository(ShipInventoryOrderChangeEntityClass);
158
- const orderRepository = manager.getRepository(this.entities.order);
159
- const stockRepository = manager.getRepository(this.entities.stock);
160
- await Promise.all(items.map(async (data) => {
161
- // Ensure required fields are present
162
- if (!data.batchId || !data.materialId)
163
- return;
164
- // Split batch first with inShipment flag to track shipment state
165
- const splittedBatch = await this.batchService.splitBatch({
166
- id: data.batchId,
167
- inShipment: true,
168
- manager,
169
- });
170
- // Save item with ORIGINAL batch id to maintain source state
171
- const item = await shipInventoryOrderItemRepository.save(shipInventoryOrderItemRepository.create(data));
172
- const base = await orderRepository.save(orderRepository.create());
173
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
174
- await shipInventoryOrderChangeRepository.save(shipInventoryOrderChangeRepository.create({
175
- itemId: item.id,
176
- id: base.id,
177
- quantityChanged: item.targetShippedQuantity * conversionFactor,
178
- }));
179
- // Stock movements track the shipment through splitted batch
180
- await this.stockService.validateStockAvailability({
181
- materialId: item.materialId,
182
- batchId: item.batchId,
183
- locationId: this.stockService.resolveLocationId(item.locationId),
184
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
185
- quantity: item.targetShippedQuantity * conversionFactor,
186
- }, manager);
187
- await stockRepository.save(stockRepository.create([
188
- // deduct from original batch available stock
189
- {
190
- orderId: base.id,
191
- materialId: item.materialId,
192
- batchId: item.batchId, // original batch
193
- locationId: this.stockService.resolveLocationId(item.locationId),
194
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
195
- quantity: -1 * item.targetShippedQuantity * conversionFactor,
196
- },
197
- // add to splitted batch in shipment state
198
- {
199
- orderId: base.id,
200
- materialId: item.materialId,
201
- batchId: splittedBatch.id, // splitted batch marked inShipment
202
- locationId: this.stockService.resolveLocationId(item.locationId),
203
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
204
- quantity: item.targetShippedQuantity * conversionFactor,
205
- },
206
- ]));
207
- }));
208
- }
209
- async createShipInventoryOrder({ manager = this.dataSource.manager, ...options }) {
210
- const orderRepository = manager.getRepository(this.entities.order);
211
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
212
- const shipInventoryOrderReferenceRepository = manager.getRepository(this.shipInventoryOrderReferenceEntity);
213
- // create base order
214
- const { id } = await orderRepository.save(orderRepository.create());
215
- // create ship inventory order
216
- const order = await shipInventoryOrderRepository.save(shipInventoryOrderRepository.create({ id, ...options }));
217
- // create ship inventory order references
218
- if (options.references && options.references.length > 0) {
219
- const processedReferences = await this.processShipInventoryOrderReferences(options.references, manager);
220
- if (processedReferences.length > 0) {
221
- const references = shipInventoryOrderReferenceRepository.create(processedReferences.map((reference) => ({
222
- ...reference,
223
- orderId: order.id,
224
- })));
225
- await shipInventoryOrderReferenceRepository.save(references);
226
- }
227
- }
228
- return order;
229
- }
230
- /**
231
- * Update a ship inventory order and its items
232
- * update existing item when id is provided, otherwise create new item, remove behaviour controlled by removedAt field
233
- */
234
- async updateShipInventoryOrder({ id, manager = this.dataSource.manager, ...options }) {
235
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
236
- const shipInventoryOrderReferenceRepository = manager.getRepository(this.shipInventoryOrderReferenceEntity);
237
- const shipInventoryOrderItemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
238
- const materialRepository = manager.getRepository(this.materialService.materialEntity);
239
- const order = await shipInventoryOrderRepository.findOneByOrFail({
240
- id,
241
- removedAt: IsNull(),
242
- });
243
- const { references, items, ...orderOptions } = options;
244
- const updated = await shipInventoryOrderRepository.save(shipInventoryOrderRepository.create({
245
- ...order,
246
- ...orderOptions,
247
- }));
248
- if (references?.length) {
249
- const newItems = [];
250
- const existingItems = [];
251
- const items = await shipInventoryOrderReferenceRepository.find({
252
- where: { orderId: id, removedAt: IsNull() },
253
- });
254
- const itemSet = new Set(items.map((i) => i.id));
255
- const results = await Promise.all((references || []).map(async (item) => {
256
- let batch = null;
257
- if (item.batchKey) {
258
- const material = await materialRepository.findOneByOrFail({
259
- key: item.materialKey,
260
- });
261
- batch = await this.batchService.getBatch({
262
- manager,
263
- materialId: material.id,
264
- key: item.batchKey,
265
- });
266
- }
267
- return { item, batch };
268
- }));
269
- // Now process results after all async operations are complete
270
- results.forEach((result) => {
271
- if (!result)
272
- return;
273
- const { item, batch } = result;
274
- if (!item.id)
275
- newItems.push({ ...item, batchId: batch?.id || null });
276
- else if (itemSet.has(item.id))
277
- existingItems.push({ ...item, batchId: batch?.id || null });
278
- });
279
- if (newItems.length) {
280
- const processedNewItems = await this.processShipInventoryOrderReferences(newItems, manager);
281
- if (processedNewItems.length > 0) {
282
- await shipInventoryOrderReferenceRepository.save(shipInventoryOrderReferenceRepository.create(processedNewItems.map((item) => ({ ...item, orderId: id }))));
283
- }
284
- }
285
- if (existingItems.length)
286
- await shipInventoryOrderReferenceRepository.save(existingItems.map((item) => shipInventoryOrderReferenceRepository.create({
287
- ...item,
288
- id: item.id,
289
- })));
290
- }
291
- if (items?.length) {
292
- const newItems = [];
293
- const existingItems = [];
294
- await shipInventoryOrderItemRepository
295
- .find({ where: { orderId: id, removedAt: IsNull() } })
296
- .then((dbItems) => {
297
- const itemSet = new Set(dbItems.map((i) => i.id));
298
- items?.forEach((item) => {
299
- if (!item.id)
300
- newItems.push({ ...item, orderId: id });
301
- else if (itemSet.has(item.id))
302
- existingItems.push(item);
303
- });
304
- });
305
- if (newItems.length)
306
- await this.processShipInventoryOrderItems(newItems, manager);
307
- if (existingItems.length)
308
- await shipInventoryOrderItemRepository.save(existingItems.map((item) => shipInventoryOrderItemRepository.create({
309
- ...item,
310
- id: item.id,
311
- })));
312
- }
313
- return updated;
314
- }
315
- /**
316
- * Remove a ship inventory order
317
- * Automatically cancels all remaining prepared (but not shipped) items to release stock
318
- */
319
- async removeShipInventoryOrder(id) {
320
- return this.dataSource.transaction(async (manager) => {
321
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
322
- const itemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
323
- // Find order
324
- const order = await shipInventoryOrderRepository.findOne({
325
- where: { id },
326
- });
327
- if (!order || order.removedAt)
328
- return false;
329
- // Find all items with changes to calculate cancellable quantities
330
- const items = await itemRepository.find({
331
- where: { orderId: id },
332
- relations: { changes: true },
333
- });
334
- // Build cancel inputs for items with remaining prepared quantity
335
- const cancelInputs = [];
336
- for (const item of items) {
337
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
338
- const preparedQuantity = item.changes.reduce((sum, change) => {
339
- const qty = Number(change.quantityChanged);
340
- return qty > 0 ? sum + qty : sum;
341
- }, 0);
342
- const shippedQuantity = item.changes.reduce((sum, change) => {
343
- const qty = Number(change.quantityChanged);
344
- return qty < 0 ? sum + Math.abs(qty) : sum;
345
- }, 0);
346
- const cancellableQuantity = preparedQuantity - shippedQuantity;
347
- if (cancellableQuantity > 0) {
348
- // Use base quantity (without conversion) since cancelShip will apply conversion
349
- cancelInputs.push({
350
- itemId: item.id,
351
- quantity: cancellableQuantity / conversionFactor,
352
- });
353
- }
354
- }
355
- // Cancel all remaining prepared items
356
- if (cancelInputs.length > 0) {
357
- await this.cancelShipInternal(cancelInputs, manager);
358
- }
359
- // Mark order as removed
360
- await shipInventoryOrderRepository.update({ id }, { removedAt: new Date() });
361
- return true;
362
- });
363
- }
364
- /**
365
- * Internal cancel method that accepts a manager for transaction support
366
- */
367
- async cancelShipInternal(options, manager) {
368
- const changeRepository = manager.getRepository(ShipInventoryOrderChangeEntityClass);
369
- const itemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
370
- const orderRepository = manager.getRepository(this.entities.order);
371
- const stockRepository = manager.getRepository(this.entities.stock);
372
- const items = await itemRepository.find({
373
- where: { id: In(options.map((o) => o.itemId)) },
374
- relations: { changes: true },
375
- });
376
- const itemMap = new Map(items.map((item) => [item.id, item]));
377
- await Promise.all(options.map(async (option) => {
378
- const item = itemMap.get(option.itemId);
379
- if (!item)
380
- return;
381
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
382
- const preparedQuantity = item.changes.reduce((sum, change) => {
383
- const qty = Number(change.quantityChanged);
384
- return qty > 0 ? sum + qty : sum;
385
- }, 0);
386
- const shippedQuantity = item.changes.reduce((sum, change) => {
387
- const qty = Number(change.quantityChanged);
388
- return qty < 0 ? sum + Math.abs(qty) : sum;
389
- }, 0);
390
- const cancellableQuantity = preparedQuantity - shippedQuantity;
391
- const cancelQuantity = option.quantity != null
392
- ? option.quantity * conversionFactor
393
- : cancellableQuantity;
394
- if (cancellableQuantity - cancelQuantity < 0) {
395
- throw new Error(`Cancel quantity exceeds prepared quantity for item ${option.itemId}`);
396
- }
397
- if (cancelQuantity <= 0)
398
- return;
399
- const inShipmentBatch = await this.batchService.splitBatch({
400
- id: item.batchId,
401
- inShipment: true,
402
- manager,
403
- });
404
- const reverseOrder = await orderRepository.save(orderRepository.create());
405
- await this.stockService.validateStockAvailability({
406
- materialId: item.materialId,
407
- batchId: inShipmentBatch.id,
408
- locationId: this.stockService.resolveLocationId(item.locationId),
409
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
410
- quantity: cancelQuantity,
411
- }, manager);
412
- await Promise.all([
413
- changeRepository.save(changeRepository.create({
414
- itemId: option.itemId,
415
- id: reverseOrder.id,
416
- quantityChanged: -1 * cancelQuantity,
417
- })),
418
- stockRepository.save(stockRepository.create([
419
- {
420
- orderId: reverseOrder.id,
421
- materialId: item.materialId,
422
- batchId: item.batchId,
423
- locationId: this.stockService.resolveLocationId(item.locationId),
424
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
425
- quantity: cancelQuantity,
426
- },
427
- {
428
- orderId: reverseOrder.id,
429
- materialId: item.materialId,
430
- batchId: inShipmentBatch.id,
431
- locationId: this.stockService.resolveLocationId(item.locationId),
432
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
433
- quantity: -1 * cancelQuantity,
434
- },
435
- ])),
436
- ]);
437
- }));
438
- }
439
- async findMany(options) {
440
- const queryBuilder = this.selectQueryBuilder('orders');
441
- if (options.id)
442
- queryBuilder.andWhere('orders.id = :id', { id: options.id });
443
- if (options.createdBy)
444
- queryBuilder.andWhere('orders."createdBy" ILIKE :createdBy', {
445
- createdBy: `%${options.createdBy}%`,
446
- });
447
- if (options.description)
448
- queryBuilder.andWhere('orders.description ILIKE :description', {
449
- description: `%${options.description}%`,
450
- });
451
- if (options.dateRange)
452
- queryBuilder.andWhere('orders."createdAt" BETWEEN :from AND :to', {
453
- from: options.dateRange.from,
454
- to: options.dateRange.to,
455
- });
456
- if (options.status)
457
- queryBuilder.andWhere(`status = :status`, {
458
- status: options.status,
459
- });
460
- if (options.statuses && options.statuses.length > 0)
461
- queryBuilder.andWhere(`status IN (:...statuses)`, {
462
- statuses: options.statuses,
463
- });
464
- if (options.materialKey)
465
- queryBuilder.andWhere(`EXISTS (
466
- SELECT 1 FROM ship_inventory_order_items si_items
467
- INNER JOIN materials si_mat ON si_mat.id = si_items."materialId"
468
- WHERE si_items."orderId" = orders.id
469
- AND si_mat.key ILIKE :materialKey
470
- )`, { materialKey: `%${options.materialKey}%` });
471
- if (options.batchKey)
472
- queryBuilder.andWhere(`EXISTS (
473
- SELECT 1 FROM ship_inventory_order_items si_items
474
- INNER JOIN batches si_batch ON si_batch.id = si_items."batchId"
475
- WHERE si_items."orderId" = orders.id
476
- AND si_batch.key ILIKE :batchKey
477
- )`, { batchKey: `%${options.batchKey}%` });
478
- if (options.locationKey)
479
- queryBuilder.andWhere(`EXISTS (
480
- SELECT 1 FROM ship_inventory_order_items si_items
481
- INNER JOIN locations si_loc ON si_loc.id = si_items."locationId"
482
- WHERE si_items."orderId" = orders.id
483
- AND si_loc.key ILIKE :locationKey
484
- )`, { locationKey: `%${options.locationKey}%` });
485
- if (options.loaderKey)
486
- queryBuilder.andWhere(`EXISTS (
487
- SELECT 1 FROM ship_inventory_order_items si_items
488
- INNER JOIN loaders si_ldr ON si_ldr.id = si_items."loaderId"
489
- WHERE si_items."orderId" = orders.id
490
- AND si_ldr."serialId" ILIKE :loaderKey
491
- )`, { loaderKey: `%${options.loaderKey}%` });
492
- if (options.wildcard) {
493
- const { key, value } = options.wildcard;
494
- queryBuilder.andWhere(`orders."${String(key)}" ILIKE :value`, {
495
- value: `%${value}%`,
496
- });
497
- }
498
- const total = await queryBuilder.getCount();
499
- if (options.offset !== undefined && options.offset >= 0)
500
- queryBuilder.skip(options.offset);
501
- if (options.limit !== undefined && options.limit > 0)
502
- queryBuilder.take(options.limit);
503
- const items = await queryBuilder.getRawMany();
504
- return [items, total];
505
- }
506
- async addShipInventoryOrderItems(options, manager = this.dataSource.manager) {
507
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
508
- const order = await shipInventoryOrderRepository.findOneByOrFail({
509
- id: options.orderId,
510
- removedAt: IsNull(),
511
- });
512
- if (options.items.length) {
513
- const items = options.items.map((item) => ({
514
- ...item,
515
- orderId: options.orderId,
516
- }));
517
- await this.processShipInventoryOrderItems(items, manager);
518
- }
519
- return order;
520
- }
521
- ship(options) {
522
- if (!Array.isArray(options))
523
- options = [options];
524
- return this.dataSource.transaction(async (manager) => {
525
- const changeRepository = manager.getRepository(ShipInventoryOrderChangeEntityClass);
526
- const itemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
527
- const orderRepository = manager.getRepository(this.entities.order);
528
- const stockRepository = manager.getRepository(this.entities.stock);
529
- const items = await itemRepository.find({
530
- where: { id: In(options.map((option) => option.itemId)) },
531
- relations: { changes: true },
532
- });
533
- const itemMap = new Map(items.map((item) => [item.id, item]));
534
- await Promise.all(options.map(async (option) => {
535
- const item = itemMap.get(option.itemId);
536
- if (!item)
537
- return;
538
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
539
- const totalShipped = item.changes.reduce((sum, change) => {
540
- const qty = Number(change.quantityChanged);
541
- return qty < 0 ? sum + Math.abs(qty) : sum;
542
- }, 0);
543
- const remainingQuantity = conversionFactor * item.targetShippedQuantity - totalShipped;
544
- if (remainingQuantity - option.quantity * conversionFactor < 0) {
545
- throw new Error(`Shipping quantity exceeds target for item ${option.itemId}`);
546
- }
547
- // Create splitted batch for ship completion
548
- const shippedBatch = await this.batchService.splitBatch({
549
- id: item.batchId,
550
- inShipment: true,
551
- manager,
552
- });
553
- const newOrder = await orderRepository.save(orderRepository.create());
554
- await this.stockService.validateStockAvailability({
555
- materialId: item.materialId,
556
- batchId: item.batchId,
557
- locationId: this.stockService.resolveLocationId(item.locationId),
558
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
559
- quantity: option.quantity * conversionFactor,
560
- }, manager);
561
- await Promise.all([
562
- changeRepository.save(changeRepository.create({
563
- itemId: option.itemId,
564
- quantityChanged: -1 * option.quantity * conversionFactor,
565
- id: newOrder.id,
566
- })),
567
- stockRepository.save(stockRepository.create([
568
- {
569
- batchId: shippedBatch.id,
570
- materialId: item.materialId,
571
- locationId: this.stockService.resolveLocationId(item.locationId),
572
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
573
- quantity: -1 * option.quantity * conversionFactor,
574
- orderId: newOrder.id,
575
- },
576
- ])),
577
- ]);
578
- }));
579
- return true;
580
- });
581
- }
582
- /**
583
- * Cancel prepared ship inventory order items
584
- * Reverses the prepare step by moving stock from IN_SHIPMENT back to FREE
585
- * Can only cancel prepared quantity that hasn't been shipped yet
586
- * If quantity is not provided, cancels all remaining cancellable quantity
587
- */
588
- cancelShip(options) {
589
- if (!Array.isArray(options))
590
- options = [options];
591
- return this.dataSource.transaction(async (manager) => {
592
- await this.cancelShipInternal(options, manager);
593
- return true;
594
- });
595
- }
596
- };
597
- ShipInventoryOrderService = __decorate([
598
- Injectable(),
599
- __param(5, Inject(ShipInventoryOrderEntity)),
600
- __param(6, Inject(ShipInventoryOrderItemEntity)),
601
- __param(7, Inject(ShipInventoryOrderReferenceEntity)),
602
- __param(8, Inject(SaleOrderEntity)),
603
- __metadata("design:paramtypes", [DataSource,
604
- WmsEntities,
605
- MaterialService,
606
- BatchService,
607
- StockService, Object, Object, Object, Object])
608
- ], ShipInventoryOrderService);
609
-
610
- export { ShipInventoryOrderService };