@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,648 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject, NotFoundException, BadRequestException } from '@nestjs/common';
3
- import { DataSource, In } from 'typeorm';
4
- import { InventoryCountStatus } from '../constants/inventory-count-status.js';
5
- import '../models/metadata/batch.entity.js';
6
- import '../models/metadata/batch-group.entity.js';
7
- import { LoadersEntityClass } from '../models/metadata/loader.entity.js';
8
- import '../models/metadata/loader-type.entity.js';
9
- import '../models/metadata/loader-unit.entity.js';
10
- import '../models/metadata/location.entity.js';
11
- import '../models/metadata/material.entity.js';
12
- import { MaterialUnitEntityClass } from '../models/metadata/material-unit.entity.js';
13
- import '@rytass/wms-base-nestjs-module';
14
- import '../models/metadata/sale-order.entity.js';
15
- import '../models/metadata/stock.entity.js';
16
- import '../models/metadata/unit.entity.js';
17
- import { WmsEntities } from '../models/wms-entities.js';
18
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js';
19
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.js';
20
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js';
21
- import '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js';
22
- import '../models/extensions/ship-inventory-order/ship-inventory-order.entity.js';
23
- import '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js';
24
- import '../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 { InventoryCountOrderEntity, InventoryCountOrderLocationEntityClass } from '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
56
- import { InventoryCountOrderItemEntityClass } from '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
57
- import { InventoryCountOrderChangeEntityClass } from '../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 { BatchService } from './batch.service.js';
63
- import { HelperService } from './helper.service.js';
64
- import { MaterialService } from './material.service.js';
65
- import { StockService } from './stock.service.js';
66
-
67
- /**
68
- * Inventory counting: compare the ledger against what is physically there, then
69
- * adjust the ledger to match.
70
- *
71
- * The shape follows the "D. 盤點" design flow. Three properties are worth
72
- * stating up front because everything else follows from them:
73
- *
74
- * - **Counting never moves stock between locations.** A line that is in the
75
- * wrong place is a transfer, not a count; `transfer-order:create` already does
76
- * that. This service only ever adjusts quantity, up or down, in place.
77
- * - **Nothing touches stock until settlement.** Counted quantities are working
78
- * notes ("暫存的對帳資料"); only {@link settle} writes changes, and it does so
79
- * in a single transaction.
80
- * - **Starting a count locks its locations.** The book snapshot taken at
81
- * {@link start} would be worthless if stock kept moving underneath it, so
82
- * `InventoryCountLockSubscriber` refuses every other stock movement in the
83
- * scope until the order settles or is cancelled.
84
- */
85
- let InventoryCountOrderService = class InventoryCountOrderService {
86
- dataSource;
87
- entities;
88
- helperService;
89
- materialService;
90
- stockService;
91
- batchService;
92
- inventoryCountOrderEntity;
93
- seqPrefix = 'ICO';
94
- constructor(dataSource, entities, helperService, materialService, stockService, batchService, inventoryCountOrderEntity) {
95
- this.dataSource = dataSource;
96
- this.entities = entities;
97
- this.helperService = helperService;
98
- this.materialService = materialService;
99
- this.stockService = stockService;
100
- this.batchService = batchService;
101
- this.inventoryCountOrderEntity = inventoryCountOrderEntity;
102
- }
103
- getRepositories(manager) {
104
- return {
105
- order: manager.getRepository(this.inventoryCountOrderEntity),
106
- scope: manager.getRepository(InventoryCountOrderLocationEntityClass),
107
- item: manager.getRepository(InventoryCountOrderItemEntityClass),
108
- change: manager.getRepository(InventoryCountOrderChangeEntityClass),
109
- baseOrder: manager.getRepository(this.entities.order),
110
- stock: manager.getRepository(this.entities.stock),
111
- };
112
- }
113
- /**
114
- * Expand chosen locations into themselves plus every descendant.
115
- *
116
- * `LocationEntity` is a plain adjacency list (`parent` / `children`) with no
117
- * materialised path, so the subtree needs a recursive CTE. It runs once per
118
- * scope change and the result is stored, precisely so the lock check never has
119
- * to run it.
120
- */
121
- async expandLocationScope(rootIds, manager) {
122
- if (!rootIds.length) {
123
- return [];
124
- }
125
- const table = manager.getRepository(this.entities.location).metadata
126
- .tableName;
127
- const rows = await manager.query(`WITH RECURSIVE subtree AS (
128
- SELECT id FROM "${table}" WHERE id = ANY($1)
129
- UNION
130
- SELECT child.id
131
- FROM "${table}" child
132
- JOIN subtree parent ON child."parentId" = parent.id
133
- )
134
- SELECT id FROM subtree`, [[...rootIds]]);
135
- const roots = new Set(rootIds);
136
- return rows.map(({ id }) => ({ id, isRoot: roots.has(id) }));
137
- }
138
- /** Current ledger quantity per physical position inside the scope. */
139
- async readPositions(locationIds, manager) {
140
- if (!locationIds.length) {
141
- return [];
142
- }
143
- // The batch table is joined by name rather than through its repository
144
- // because it is only read for its attribute columns — the same thing
145
- // `StockService.selectQueryBuilder` does. Single-table inheritance means
146
- // every configured batch entity shares this table, so the join is override
147
- // safe; the name still comes from the configured entity's metadata rather
148
- // than being hard-coded.
149
- const batchTable = manager.getRepository(this.entities.batch).metadata
150
- .tableName;
151
- // Through the repository, not raw SQL on the table: the stock entity is
152
- // overridable, and the repository is what applies the right
153
- // single-table-inheritance discriminator.
154
- const rows = await manager
155
- .getRepository(this.entities.stock)
156
- .createQueryBuilder('stock')
157
- .leftJoin(batchTable, 'batch', 'batch.id = stock."batchId"')
158
- .select('stock.materialId', 'materialId')
159
- .addSelect('stock.batchId', 'batchId')
160
- .addSelect('stock.locationId', 'locationId')
161
- .addSelect('stock.loaderId', 'loaderId')
162
- .addSelect('SUM(stock.quantity)', 'quantity')
163
- .addSelect('batch.held', 'held')
164
- .addSelect('batch."inShipment"', 'inShipment')
165
- .addSelect('batch."inspectionResult"', 'inspectionResult')
166
- .addSelect('batch."requiresInspection"', 'requiresInspection')
167
- .addSelect('batch."transferId"', 'transferId')
168
- .addSelect('batch."vendorId"', 'vendorId')
169
- .addSelect('batch."customerId"', 'customerId')
170
- .addSelect('batch."saleId"', 'saleId')
171
- .addSelect('batch."saleSerialId"', 'saleSerialId')
172
- .where('stock.locationId IN (:...locationIds)', {
173
- locationIds: [...locationIds],
174
- })
175
- .groupBy('stock.materialId')
176
- .addGroupBy('stock.batchId')
177
- .addGroupBy('stock.locationId')
178
- .addGroupBy('stock.loaderId')
179
- // Functionally dependent on batchId, but PostgreSQL only infers that from
180
- // the grouped table's own primary key, so they have to be listed.
181
- .addGroupBy('batch.held')
182
- .addGroupBy('batch."inShipment"')
183
- .addGroupBy('batch."inspectionResult"')
184
- .addGroupBy('batch."requiresInspection"')
185
- .addGroupBy('batch."transferId"')
186
- .addGroupBy('batch."vendorId"')
187
- .addGroupBy('batch."customerId"')
188
- .addGroupBy('batch."saleId"')
189
- .addGroupBy('batch."saleSerialId"')
190
- .having('SUM(stock.quantity) > 0')
191
- .getRawMany();
192
- return rows.map((row) => ({
193
- materialId: row.materialId,
194
- batchId: row.batchId,
195
- locationId: row.locationId,
196
- loaderId: row.loaderId,
197
- quantity: Number(row.quantity),
198
- attributes: {
199
- held: row.held ?? null,
200
- inShipment: row.inShipment ?? null,
201
- inspectionResult: row.inspectionResult ?? null,
202
- requiresInspection: row.requiresInspection ?? null,
203
- transferId: row.transferId ?? null,
204
- vendorId: row.vendorId ?? null,
205
- customerId: row.customerId ?? null,
206
- saleId: row.saleId ?? null,
207
- saleSerialId: row.saleSerialId ?? null,
208
- },
209
- }));
210
- }
211
- positionKey(position) {
212
- return [
213
- position.materialId,
214
- position.batchId,
215
- position.locationId ?? '',
216
- position.loaderId ?? '',
217
- ].join('|');
218
- }
219
- async scopedLocationIds(orderId, manager) {
220
- const rows = await this.getRepositories(manager).scope.find({
221
- where: { orderId },
222
- select: { locationId: true },
223
- });
224
- return rows.map(({ locationId }) => locationId);
225
- }
226
- async loadOrderOrFail(id, manager) {
227
- const order = await this.getRepositories(manager).order.findOneBy({ id });
228
- if (!order) {
229
- throw new NotFoundException(`Inventory count order ${id} not found`);
230
- }
231
- return order;
232
- }
233
- assertStatus(order, allowed) {
234
- if (!allowed.includes(order.status)) {
235
- throw new BadRequestException(`Inventory count order ${order.id} is ${order.status}; this operation requires ${allowed.join(' or ')}`);
236
- }
237
- }
238
- /**
239
- * Rebuild the sheet from the current ledger.
240
- *
241
- * Called when the scope changes and again when counting starts. Additions
242
- * (盤盈 lines) are never touched — they describe stock the ledger does not know
243
- * about, so a rebuild has nothing to say about them.
244
- */
245
- async rebuildItems(orderId, manager) {
246
- const repos = this.getRepositories(manager);
247
- const locationIds = await this.scopedLocationIds(orderId, manager);
248
- const positions = await this.readPositions(locationIds, manager);
249
- const existing = await repos.item.find({
250
- where: { orderId, isAddition: false },
251
- });
252
- const byKey = new Map(existing.map((item) => [this.positionKey(item), item]));
253
- const seen = new Set();
254
- for (const position of positions) {
255
- const key = this.positionKey(position);
256
- seen.add(key);
257
- const item = byKey.get(key);
258
- if (item) {
259
- item.bookQuantity = position.quantity;
260
- Object.assign(item, position.attributes);
261
- await repos.item.save(item);
262
- continue;
263
- }
264
- await repos.item.save(repos.item.create({
265
- orderId,
266
- materialId: position.materialId,
267
- batchId: position.batchId,
268
- locationId: position.locationId,
269
- loaderId: position.loaderId,
270
- bookQuantity: position.quantity,
271
- countedQuantity: null,
272
- unitId: null,
273
- isAddition: false,
274
- ...position.attributes,
275
- }));
276
- }
277
- // A position that emptied out between two rebuilds is no longer on the
278
- // sheet; it cannot be counted and would settle to a meaningless zero.
279
- const stale = existing.filter((item) => !seen.has(this.positionKey(item)));
280
- if (stale.length) {
281
- await repos.item.delete({ id: In(stale.map(({ id }) => id)) });
282
- }
283
- }
284
- /** Filters for the list page. All optional; combined with AND. */
285
- async findMany(options, manager = this.dataSource.manager) {
286
- const query = this.getRepositories(manager)
287
- // The alias is lowercase and is deliberately not `order`. `order` is a
288
- // PostgreSQL reserved word, so the raw fragments below would render
289
- // `order."countDate"` and fail to parse; and a camelCase alias would be
290
- // emitted quoted by the query builder while the unquoted references here
291
- // fold to lowercase, so the two would never match.
292
- .order.createQueryBuilder('count_order')
293
- .orderBy('count_order."countDate"', 'DESC')
294
- .addOrderBy('count_order."createdAt"', 'DESC');
295
- if (options.name) {
296
- query.andWhere('count_order.name ILIKE :name', {
297
- name: `%${options.name}%`,
298
- });
299
- }
300
- if (options.statuses?.length) {
301
- query.andWhere('count_order.status IN (:...statuses)', {
302
- statuses: options.statuses,
303
- });
304
- }
305
- if (options.createdBy) {
306
- query.andWhere('count_order."createdBy" = :createdBy', {
307
- createdBy: options.createdBy,
308
- });
309
- }
310
- if (options.countDateFrom) {
311
- query.andWhere('count_order."countDate" >= :from', {
312
- from: options.countDateFrom,
313
- });
314
- }
315
- if (options.countDateTo) {
316
- query.andWhere('count_order."countDate" <= :to', {
317
- to: options.countDateTo,
318
- });
319
- }
320
- if (options.locationIds?.length) {
321
- // Scope membership, not the roots the user picked: a count of a whole
322
- // aisle should surface when filtering by any shelf inside it.
323
- query.andWhere(`EXISTS (
324
- SELECT 1 FROM inventory_count_order_locations scope
325
- WHERE scope."orderId" = count_order.id
326
- AND scope."locationId" IN (:...locationIds)
327
- )`, { locationIds: options.locationIds });
328
- }
329
- if (options.offset !== undefined && options.offset >= 0) {
330
- query.skip(options.offset);
331
- }
332
- if (options.limit !== undefined && options.limit > 0) {
333
- query.take(options.limit);
334
- }
335
- return query.getManyAndCount();
336
- }
337
- async findOne(id, manager = this.dataSource.manager) {
338
- return this.loadOrderOrFail(id, manager);
339
- }
340
- /**
341
- * The count sheet, filtered and paginated.
342
- *
343
- * Server-side rather than handing the whole sheet to the client: a count over
344
- * a whole warehouse is thousands of lines, and the operator's job is to narrow
345
- * to the shelf in front of them.
346
- */
347
- async findItems(orderId, options = {}, manager = this.dataSource.manager) {
348
- const tableOf = (entity) => manager.getRepository(entity).metadata.tableName;
349
- const query = this.getRepositories(manager)
350
- .item.createQueryBuilder('item')
351
- .leftJoin(tableOf(this.entities.material), 'material', 'material.id = item."materialId"')
352
- .leftJoin(tableOf(this.entities.batch), 'batch', 'batch.id = item."batchId"')
353
- .leftJoin(tableOf(this.entities.location), 'location', 'location.id = item."locationId"')
354
- .leftJoin(LoadersEntityClass, 'loader', 'loader.id = item."loaderId"')
355
- .where('item."orderId" = :orderId', { orderId });
356
- const like = (column, value, parameter) => {
357
- if (!value)
358
- return;
359
- query.andWhere(`${column} ILIKE :${parameter}`, {
360
- [parameter]: `%${value}%`,
361
- });
362
- };
363
- like('material.key', options.materialKey, 'materialKey');
364
- like('material.description', options.materialDescription, 'materialDescription');
365
- like('batch.key', options.batchKey, 'batchKey');
366
- like('location.key', options.locationKey, 'locationKey');
367
- like('loader."serialId"', options.loaderSerialId, 'loaderSerialId');
368
- const exact = (column, value, parameter) => {
369
- if (!value)
370
- return;
371
- query.andWhere(`${column} = :${parameter}`, { [parameter]: value });
372
- };
373
- exact('item."vendorId"', options.vendorId, 'vendorId');
374
- exact('item."customerId"', options.customerId, 'customerId');
375
- exact('item."saleId"', options.saleId, 'saleId');
376
- exact('item."saleSerialId"', options.saleSerialId, 'saleSerialId');
377
- if (options.onlyVariance) {
378
- // The counted quantity is expressed in the line's unit, so it has to be
379
- // converted before it can be compared with the base-unit book quantity —
380
- // the same conversion settlement applies.
381
- query
382
- .leftJoin(MaterialUnitEntityClass, 'unit', 'unit.id = item."unitId"')
383
- .andWhere('item."countedQuantity" IS NOT NULL')
384
- .andWhere('item."countedQuantity" * COALESCE(unit."conversionFactor", 1) <> item."bookQuantity"');
385
- }
386
- // Counted before ordering and paginating: `getCount()` rewrites the query
387
- // into a COUNT, and an ORDER BY on a joined column it does not select makes
388
- // that rewrite fail.
389
- const total = await query.getCount();
390
- // Additions first — they are what the operator just typed — then a stable
391
- // order so paging cannot repeat or skip a line.
392
- query
393
- .orderBy('item."isAddition"', 'DESC')
394
- .addOrderBy('material.key', 'ASC')
395
- .addOrderBy('batch.key', 'ASC')
396
- .addOrderBy('item.id', 'ASC');
397
- // `limit`/`offset` rather than `take`/`skip`: the latter wraps the query in a
398
- // DISTINCT subquery to survive one-to-many joins, and then cannot map an
399
- // ORDER BY on a joined column into it. Every join here is many-to-one, so no
400
- // row multiplication and no need for that machinery.
401
- if (options.offset !== undefined && options.offset >= 0) {
402
- query.offset(options.offset);
403
- }
404
- if (options.limit !== undefined && options.limit > 0) {
405
- query.limit(options.limit);
406
- }
407
- return [await query.getMany(), total];
408
- }
409
- async create(input, manager = this.dataSource.manager) {
410
- if (!input.locationIds.length) {
411
- throw new BadRequestException('An inventory count needs at least one location in scope');
412
- }
413
- const repos = this.getRepositories(manager);
414
- const key = await this.helperService.getSeq(this.seqPrefix, manager);
415
- const order = await repos.order.save(repos.order.create({
416
- key,
417
- name: input.name,
418
- countDate: input.countDate,
419
- status: InventoryCountStatus.PENDING,
420
- createdBy: input.createdBy ?? null,
421
- }));
422
- const scope = await this.expandLocationScope(input.locationIds, manager);
423
- await repos.scope.save(scope.map(({ id, isRoot }) => repos.scope.create({ orderId: order.id, locationId: id, isRoot })));
424
- await this.rebuildItems(order.id, manager);
425
- return order;
426
- }
427
- async update(id, input, manager = this.dataSource.manager) {
428
- const repos = this.getRepositories(manager);
429
- const order = await this.loadOrderOrFail(id, manager);
430
- // The design keeps the info panel editable only while nothing has been
431
- // counted; afterwards the sheet is already anchored to this scope and date.
432
- this.assertStatus(order, [InventoryCountStatus.PENDING]);
433
- if (input.name !== undefined)
434
- order.name = input.name;
435
- if (input.countDate !== undefined)
436
- order.countDate = input.countDate;
437
- await repos.order.save(order);
438
- if (input.locationIds) {
439
- if (!input.locationIds.length) {
440
- throw new BadRequestException('An inventory count needs at least one location in scope');
441
- }
442
- await repos.scope.delete({ orderId: id });
443
- const scope = await this.expandLocationScope(input.locationIds, manager);
444
- await repos.scope.save(scope.map(({ id: locationId, isRoot }) => repos.scope.create({ orderId: id, locationId, isRoot })));
445
- await this.rebuildItems(id, manager);
446
- }
447
- return order;
448
- }
449
- /**
450
- * Freeze the ledger and open the sheet for counting.
451
- *
452
- * The rebuild here is the snapshot: from this point `bookQuantity` is what the
453
- * variance is measured against, and the lock keeps it true.
454
- */
455
- async start(id, manager = this.dataSource.manager) {
456
- const repos = this.getRepositories(manager);
457
- const order = await this.loadOrderOrFail(id, manager);
458
- this.assertStatus(order, [InventoryCountStatus.PENDING]);
459
- await this.rebuildItems(id, manager);
460
- order.status = InventoryCountStatus.COUNTING;
461
- order.startedAt = new Date();
462
- await repos.order.save(order);
463
- return order;
464
- }
465
- /** Save counted quantities without touching stock ("暫存結果"). */
466
- async count(id, entries, manager = this.dataSource.manager) {
467
- const repos = this.getRepositories(manager);
468
- const order = await this.loadOrderOrFail(id, manager);
469
- this.assertStatus(order, [InventoryCountStatus.COUNTING]);
470
- if (!entries.length) {
471
- return order;
472
- }
473
- const items = await repos.item.find({
474
- where: { orderId: id, id: In(entries.map(({ itemId }) => itemId)) },
475
- });
476
- const byId = new Map(items.map((item) => [item.id, item]));
477
- for (const entry of entries) {
478
- const item = byId.get(entry.itemId);
479
- if (!item) {
480
- throw new NotFoundException(`Item ${entry.itemId} does not belong to inventory count order ${id}`);
481
- }
482
- if (entry.countedQuantity !== null &&
483
- (!Number.isFinite(entry.countedQuantity) || entry.countedQuantity < 0)) {
484
- throw new BadRequestException(`Counted quantity for item ${entry.itemId} must be a non-negative number`);
485
- }
486
- item.countedQuantity = entry.countedQuantity;
487
- if (entry.unitId !== undefined) {
488
- item.unitId = entry.unitId;
489
- }
490
- await repos.item.save(item);
491
- }
492
- return order;
493
- }
494
- /**
495
- * Add a line for stock the ledger has no record of (盤盈).
496
- *
497
- * The batch is resolved by key and created when it does not exist, which is
498
- * what makes "the batch field's default is editable" in the design work.
499
- */
500
- async addItem(id, input, manager = this.dataSource.manager) {
501
- const repos = this.getRepositories(manager);
502
- const order = await this.loadOrderOrFail(id, manager);
503
- this.assertStatus(order, [InventoryCountStatus.COUNTING]);
504
- if (!Number.isFinite(input.countedQuantity) || input.countedQuantity <= 0) {
505
- throw new BadRequestException('An added inventory count line needs a positive counted quantity');
506
- }
507
- const scoped = await this.scopedLocationIds(id, manager);
508
- // Settlement writes stock at this location, so it has to be one the order
509
- // locked — otherwise the count would adjust a position other operations are
510
- // still free to move.
511
- if (!scoped.includes(input.locationId)) {
512
- throw new BadRequestException(`Location ${input.locationId} is outside the scope of inventory count order ${id}`);
513
- }
514
- const batch = await this.batchService.getBatch({
515
- key: input.batchKey,
516
- materialId: input.materialId,
517
- manager,
518
- });
519
- return repos.item.save(repos.item.create({
520
- orderId: id,
521
- materialId: input.materialId,
522
- batchId: batch.id,
523
- locationId: input.locationId,
524
- loaderId: input.loaderId ?? null,
525
- unitId: input.unitId ?? null,
526
- bookQuantity: 0,
527
- countedQuantity: input.countedQuantity,
528
- isAddition: true,
529
- // Snapshotted from the batch the same way a scoped line is, so an added
530
- // line renders through the identical columns. A brand-new batch carries
531
- // the defaults, which is exactly right: unbooked stock is not held, not
532
- // in transfer and not inspected.
533
- held: batch.held ?? null,
534
- inShipment: batch.inShipment ?? null,
535
- inspectionResult: batch.inspectionResult ?? null,
536
- transferId: batch.transferId ?? null,
537
- vendorId: batch.vendorId ?? null,
538
- customerId: batch.customerId ?? null,
539
- saleId: batch.saleId ?? null,
540
- saleSerialId: batch.saleSerialId ?? null,
541
- }));
542
- }
543
- /** Remove an added line. Scoped lines are part of the sheet and never removed. */
544
- async removeItem(id, itemId, manager = this.dataSource.manager) {
545
- const repos = this.getRepositories(manager);
546
- const order = await this.loadOrderOrFail(id, manager);
547
- this.assertStatus(order, [InventoryCountStatus.COUNTING]);
548
- const item = await repos.item.findOneBy({ id: itemId, orderId: id });
549
- if (!item) {
550
- throw new NotFoundException(`Item ${itemId} does not belong to inventory count order ${id}`);
551
- }
552
- if (!item.isAddition) {
553
- throw new BadRequestException(`Item ${itemId} came from the counted scope and cannot be removed`);
554
- }
555
- await repos.item.delete({ id: itemId });
556
- return order;
557
- }
558
- /**
559
- * Throw the counting away and start over, without leaving the count.
560
- *
561
- * The scope stays locked and the status stays `COUNTING`: the point is a
562
- * re-measure after something went wrong on the floor, not an abandonment. The
563
- * book snapshot is deliberately *not* retaken — the lock means it has not
564
- * moved.
565
- */
566
- async reset(id, manager = this.dataSource.manager) {
567
- const repos = this.getRepositories(manager);
568
- const order = await this.loadOrderOrFail(id, manager);
569
- this.assertStatus(order, [InventoryCountStatus.COUNTING]);
570
- await repos.item.delete({ orderId: id, isAddition: true });
571
- await repos.item.update({ orderId: id }, { countedQuantity: null, unitId: null });
572
- return order;
573
- }
574
- async cancel(id, manager = this.dataSource.manager) {
575
- const repos = this.getRepositories(manager);
576
- const order = await this.loadOrderOrFail(id, manager);
577
- this.assertStatus(order, [
578
- InventoryCountStatus.PENDING,
579
- InventoryCountStatus.COUNTING,
580
- ]);
581
- order.status = InventoryCountStatus.CANCELLED;
582
- order.cancelledAt = new Date();
583
- await repos.order.save(order);
584
- return order;
585
- }
586
- /**
587
- * Adjust the ledger to the counted reality ("執行盤差").
588
- *
589
- * Runs in one transaction and is awaited end to end, so the mutation
590
- * interceptor's post-commit guarantee holds: every `stock.count-gained` /
591
- * `stock.count-lost` event fires only after the adjustments are durable.
592
- *
593
- * Uncounted lines are left alone — "not counted" is not "counted as zero", and
594
- * treating it as zero would wipe out stock nobody looked at.
595
- */
596
- async settle(id, outerManager) {
597
- const run = async (manager) => {
598
- const repos = this.getRepositories(manager);
599
- const order = await this.loadOrderOrFail(id, manager);
600
- this.assertStatus(order, [InventoryCountStatus.COUNTING]);
601
- const items = await repos.item.find({ where: { orderId: id } });
602
- for (const item of items) {
603
- if (item.countedQuantity === null) {
604
- continue;
605
- }
606
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId ?? undefined);
607
- const counted = Number(item.countedQuantity) * conversionFactor;
608
- const delta = counted - Number(item.bookQuantity);
609
- if (delta === 0) {
610
- continue;
611
- }
612
- const baseOrder = await repos.baseOrder.save({});
613
- await repos.change.save(repos.change.create({
614
- item,
615
- order: baseOrder,
616
- quantityChanged: delta,
617
- }));
618
- await repos.stock.save(repos.stock.create({
619
- orderId: baseOrder.id,
620
- materialId: item.materialId,
621
- batchId: item.batchId,
622
- locationId: this.stockService.resolveLocationId(item.locationId),
623
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
624
- quantity: delta,
625
- }));
626
- }
627
- order.status = InventoryCountStatus.COMPLETED;
628
- order.settledAt = new Date();
629
- await repos.order.save(order);
630
- return order;
631
- };
632
- return outerManager
633
- ? run(outerManager)
634
- : this.dataSource.transaction((manager) => run(manager));
635
- }
636
- };
637
- InventoryCountOrderService = __decorate([
638
- Injectable(),
639
- __param(6, Inject(InventoryCountOrderEntity)),
640
- __metadata("design:paramtypes", [DataSource,
641
- WmsEntities,
642
- HelperService,
643
- MaterialService,
644
- StockService,
645
- BatchService, Object])
646
- ], InventoryCountOrderService);
647
-
648
- export { InventoryCountOrderService };