@rytass/wms-module-core 0.8.1 → 0.9.1

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 (141) hide show
  1. package/index.cjs.js +1689 -199
  2. package/index.d.mts +6 -0
  3. package/{index.js → index.mjs} +97 -87
  4. package/lib/constants/consumption-change-kind.d.ts +17 -0
  5. package/lib/constants/consumption-change-kind.mjs +20 -0
  6. package/lib/constants/index.d.ts +2 -0
  7. package/lib/constants/operations.d.ts +1 -1
  8. package/lib/constants/{operations.js → operations.mjs} +9 -0
  9. package/lib/constants/order-type.d.ts +30 -0
  10. package/lib/constants/order-type.mjs +33 -0
  11. package/lib/constants/stock-status.d.ts +4 -1
  12. package/lib/constants/{stock-status.js → stock-status.mjs} +6 -0
  13. package/lib/{core.module.js → core.module.mjs} +118 -34
  14. package/lib/events/index.d.ts +2 -1
  15. package/lib/events/stock-change.subscriber.d.ts +26 -1
  16. package/lib/events/{stock-change.subscriber.js → stock-change.subscriber.mjs} +100 -17
  17. package/lib/events/{wms-event.collector.js → wms-event.collector.mjs} +1 -1
  18. package/lib/events/{wms-event.dispatcher.js → wms-event.dispatcher.mjs} +1 -1
  19. package/lib/events/wms-event.tokens.d.ts +2 -0
  20. package/lib/events/{wms-event.tokens.js → wms-event.tokens.mjs} +3 -1
  21. package/lib/events/wms-event.types.d.ts +38 -6
  22. package/lib/events/wms-operation-runner.d.ts +57 -0
  23. package/lib/events/wms-operation-runner.mjs +101 -0
  24. package/lib/models/extensions/allocate-inventory-order/{allocate-inventory-order-change.entity.js → allocate-inventory-order-change.entity.mjs} +1 -1
  25. package/lib/models/extensions/allocate-inventory-order/{allocate-inventory-order-item.entity.js → allocate-inventory-order-item.entity.mjs} +12 -12
  26. package/lib/models/extensions/consumption-order/consumption-order-change.entity.d.ts +19 -0
  27. package/lib/models/extensions/consumption-order/consumption-order-change.entity.mjs +59 -0
  28. package/lib/models/extensions/consumption-order/consumption-order-item.entity.d.ts +26 -0
  29. package/lib/models/extensions/consumption-order/consumption-order-item.entity.mjs +114 -0
  30. package/lib/models/extensions/consumption-order/consumption-order.entity.d.ts +32 -0
  31. package/lib/models/extensions/consumption-order/consumption-order.entity.mjs +69 -0
  32. package/lib/models/extensions/consumption-order/index.d.ts +3 -0
  33. package/lib/models/extensions/hold-inventory-order/{hold-inventory-order-change.entity.js → hold-inventory-order-change.entity.mjs} +1 -1
  34. package/lib/models/extensions/hold-inventory-order/{hold-inventory-order-item.entity.js → hold-inventory-order-item.entity.mjs} +12 -12
  35. package/lib/models/extensions/index.d.ts +4 -0
  36. package/lib/models/extensions/inventory-count-order/{inventory-count-order-change.entity.js → inventory-count-order-change.entity.mjs} +1 -1
  37. package/lib/models/extensions/inventory-count-order/inventory-count-order-item.entity.d.ts +13 -1
  38. package/lib/models/extensions/inventory-count-order/{inventory-count-order-item.entity.js → inventory-count-order-item.entity.mjs} +29 -13
  39. package/lib/models/extensions/inventory-count-order/{inventory-count-order.entity.js → inventory-count-order.entity.mjs} +12 -12
  40. package/lib/models/extensions/merge-batch-order/{merge-batch-order-change.entity.js → merge-batch-order-change.entity.mjs} +1 -1
  41. package/lib/models/extensions/merge-batch-order/{merge-batch-order-item.entity.js → merge-batch-order-item.entity.mjs} +12 -12
  42. package/lib/models/extensions/order-reference/index.d.ts +1 -0
  43. package/lib/models/extensions/order-reference/order-reference.entity.d.ts +49 -0
  44. package/lib/models/extensions/order-reference/order-reference.entity.mjs +95 -0
  45. package/lib/models/extensions/quality-inspection-order/{quality-inspection-order-change.entity.js → quality-inspection-order-change.entity.mjs} +1 -1
  46. package/lib/models/extensions/quality-inspection-order/{quality-inspection-order-item.entity.js → quality-inspection-order-item.entity.mjs} +12 -12
  47. package/lib/models/extensions/receive-inventory-order/{receive-inventory-order-change.entity.js → receive-inventory-order-change.entity.mjs} +2 -2
  48. package/lib/models/extensions/receive-inventory-order/{receive-inventory-order-item.entity.js → receive-inventory-order-item.entity.mjs} +2 -2
  49. package/lib/models/extensions/receive-inventory-order/{receive-inventory-order.entity.js → receive-inventory-order.entity.mjs} +2 -2
  50. package/lib/models/extensions/reclassify-inventory-order/{reclassify-inventory-order-change.entity.js → reclassify-inventory-order-change.entity.mjs} +1 -1
  51. package/lib/models/extensions/reclassify-inventory-order/{reclassify-inventory-order-item.entity.js → reclassify-inventory-order-item.entity.mjs} +12 -12
  52. package/lib/models/extensions/scrape-order/{scrape-order-change.entity.js → scrape-order-change.entity.mjs} +1 -1
  53. package/lib/models/extensions/scrape-order/{scrape-order-item.entity.js → scrape-order-item.entity.mjs} +12 -12
  54. package/lib/models/extensions/ship-inventory-order/{ship-inventory-order-change.entity.js → ship-inventory-order-change.entity.mjs} +2 -2
  55. package/lib/models/extensions/ship-inventory-order/{ship-inventory-order-item.entity.js → ship-inventory-order-item.entity.mjs} +2 -2
  56. package/lib/models/extensions/ship-inventory-order/{ship-inventory-order.entity.js → ship-inventory-order.entity.mjs} +2 -2
  57. package/lib/models/extensions/split-batch-order/{split-batch-order-change.entity.js → split-batch-order-change.entity.mjs} +1 -1
  58. package/lib/models/extensions/split-batch-order/{split-batch-order-item.entity.js → split-batch-order-item.entity.mjs} +12 -12
  59. package/lib/models/extensions/transfer-customer-order/{transfer-customer-order-change.entity.js → transfer-customer-order-change.entity.mjs} +1 -1
  60. package/lib/models/extensions/transfer-customer-order/{transfer-customer-order-item.entity.js → transfer-customer-order-item.entity.mjs} +12 -12
  61. package/lib/models/extensions/transfer-order/{transfer-order-change.entity.js → transfer-order-change.entity.mjs} +1 -1
  62. package/lib/models/extensions/transfer-order/{transfer-order-item.entity.js → transfer-order-item.entity.mjs} +12 -12
  63. package/lib/models/extensions/transfer-vendor-order/{transfer-vendor-order-change.entity.js → transfer-vendor-order-change.entity.mjs} +1 -1
  64. package/lib/models/extensions/transfer-vendor-order/{transfer-vendor-order-item.entity.js → transfer-vendor-order-item.entity.mjs} +12 -12
  65. package/lib/models/metadata/batch.entity.d.ts +46 -0
  66. package/lib/models/metadata/batch.entity.mjs +131 -0
  67. package/lib/models/metadata/{loader.entity.js → loader.entity.mjs} +1 -1
  68. package/lib/models/metadata/{material-unit.entity.js → material-unit.entity.mjs} +1 -1
  69. package/lib/models/metadata/{stock.entity.js → stock.entity.mjs} +1 -1
  70. package/lib/models/{models.module.js → models.module.mjs} +60 -52
  71. package/lib/models/{wms-entities.js → wms-entities.mjs} +5 -5
  72. package/lib/services/{allocate-inventory-order.service.js → allocate-inventory-order.service.mjs} +60 -56
  73. package/lib/services/base-order.service.d.ts +18 -3
  74. package/lib/services/base-order.service.mjs +76 -0
  75. package/lib/services/batch.service.d.ts +17 -0
  76. package/lib/services/{batch.service.js → batch.service.mjs} +93 -53
  77. package/lib/services/consumption-order.service.d.ts +75 -0
  78. package/lib/services/consumption-order.service.mjs +504 -0
  79. package/lib/services/{hold-inventory-order.service.js → hold-inventory-order.service.mjs} +60 -56
  80. package/lib/services/index.d.ts +3 -0
  81. package/lib/services/{inventory-count-order.service.js → inventory-count-order.service.mjs} +64 -57
  82. package/lib/services/{loader.service.js → loader.service.mjs} +56 -52
  83. package/lib/services/{location.service.js → location.service.mjs} +56 -52
  84. package/lib/services/{material.service.js → material.service.mjs} +56 -52
  85. package/lib/services/{merge-batch-order.service.js → merge-batch-order.service.mjs} +60 -56
  86. package/lib/services/order-reference.service.d.ts +50 -0
  87. package/lib/services/order-reference.service.mjs +136 -0
  88. package/lib/services/{quality-inspection-order.service.js → quality-inspection-order.service.mjs} +59 -55
  89. package/lib/services/{receive-inventory-order.service.js → receive-inventory-order.service.mjs} +189 -135
  90. package/lib/services/{reclassify-inventory-order.service.js → reclassify-inventory-order.service.mjs} +60 -56
  91. package/lib/services/{sale-order.service.js → sale-order.service.mjs} +1 -1
  92. package/lib/services/{scrape.service.js → scrape.service.mjs} +59 -55
  93. package/lib/services/{ship-inventory-order.service.js → ship-inventory-order.service.mjs} +60 -56
  94. package/lib/services/split-batch-order.service.mjs +191 -0
  95. package/lib/services/{stock.service.js → stock.service.mjs} +86 -56
  96. package/lib/services/{transfer-customer-order.service.js → transfer-customer-order.service.mjs} +60 -56
  97. package/lib/services/{transfer-order.service.js → transfer-order.service.mjs} +61 -57
  98. package/lib/services/{transfer-vendor-order.service.js → transfer-vendor-order.service.mjs} +60 -56
  99. package/lib/services/{unit.service.js → unit.service.mjs} +56 -52
  100. package/lib/services/{warehouse-map.service.js → warehouse-map.service.mjs} +1 -1
  101. package/lib/typings/aggregated-stock.d.ts +6 -0
  102. package/lib/typings/consumption-order.input.d.ts +72 -0
  103. package/lib/typings/core-module-options.d.ts +34 -1
  104. package/lib/typings/custom-change-table.d.ts +70 -0
  105. package/lib/typings/find-stock.input.d.ts +14 -0
  106. package/lib/typings/get-batch.input.d.ts +16 -0
  107. package/lib/typings/index.d.ts +3 -0
  108. package/lib/typings/order-reference.input.d.ts +28 -0
  109. package/lib/typings/split-batch.input.d.ts +11 -0
  110. package/package.json +19 -7
  111. package/lib/models/metadata/batch.entity.js +0 -73
  112. package/lib/services/split-batch-order.service.js +0 -168
  113. package/lib/typings/entity-overrides.d.ts +0 -34
  114. package/lib/typings/entity-overrides.js +0 -7
  115. package/src/lib/models/extensions/README.md +0 -219
  116. /package/lib/constants/{inventory-count-status.js → inventory-count-status.mjs} +0 -0
  117. /package/lib/events/{dispatch-scope.js → dispatch-scope.mjs} +0 -0
  118. /package/lib/events/{inventory-count-lock.subscriber.js → inventory-count-lock.subscriber.mjs} +0 -0
  119. /package/lib/models/extensions/allocate-inventory-order/{allocate-inventory-order.entity.js → allocate-inventory-order.entity.mjs} +0 -0
  120. /package/lib/models/extensions/hold-inventory-order/{hold-inventory-order.entity.js → hold-inventory-order.entity.mjs} +0 -0
  121. /package/lib/models/extensions/merge-batch-order/{merge-batch-order.entity.js → merge-batch-order.entity.mjs} +0 -0
  122. /package/lib/models/extensions/quality-inspection-order/{quality-inspection-order.entity.js → quality-inspection-order.entity.mjs} +0 -0
  123. /package/lib/models/extensions/reclassify-inventory-order/{reclassify-inventory-order.entity.js → reclassify-inventory-order.entity.mjs} +0 -0
  124. /package/lib/models/extensions/scrape-order/{scrape-order.entity.js → scrape-order.entity.mjs} +0 -0
  125. /package/lib/models/extensions/ship-inventory-order/{ship-inventory-order-reference.entity.js → ship-inventory-order-reference.entity.mjs} +0 -0
  126. /package/lib/models/extensions/split-batch-order/{split-batch-order.entity.js → split-batch-order.entity.mjs} +0 -0
  127. /package/lib/models/extensions/transfer-customer-order/{transfer-customer-order.entity.js → transfer-customer-order.entity.mjs} +0 -0
  128. /package/lib/models/extensions/transfer-order/{transfer-order.entity.js → transfer-order.entity.mjs} +0 -0
  129. /package/lib/models/extensions/transfer-vendor-order/{transfer-vendor-order.entity.js → transfer-vendor-order.entity.mjs} +0 -0
  130. /package/lib/models/metadata/{batch-group.entity.js → batch-group.entity.mjs} +0 -0
  131. /package/lib/models/metadata/{loader-type.entity.js → loader-type.entity.mjs} +0 -0
  132. /package/lib/models/metadata/{loader-unit.entity.js → loader-unit.entity.mjs} +0 -0
  133. /package/lib/models/metadata/{location.entity.js → location.entity.mjs} +0 -0
  134. /package/lib/models/metadata/{material.entity.js → material.entity.mjs} +0 -0
  135. /package/lib/models/metadata/{order.entity.js → order.entity.mjs} +0 -0
  136. /package/lib/models/metadata/{sale-order.entity.js → sale-order.entity.mjs} +0 -0
  137. /package/lib/models/metadata/{unit.entity.js → unit.entity.mjs} +0 -0
  138. /package/lib/services/{helper.service.js → helper.service.mjs} +0 -0
  139. /package/lib/typings/{core-module-options.js → core-module-options.mjs} +0 -0
  140. /package/lib/typings/{find-receive-inventory-order.input.js → find-receive-inventory-order.input.mjs} +0 -0
  141. /package/lib/typings/{find-ship-inventory-order.input.js → find-ship-inventory-order.input.mjs} +0 -0
@@ -1,73 +0,0 @@
1
- import { __decorate, __metadata } from 'tslib';
2
- import { Column, ManyToOne, JoinColumn, ChildEntity } from 'typeorm';
3
- import { BatchEntity as BatchEntity$1 } from '@rytass/wms-base-nestjs-module';
4
-
5
- const BatchEntity = Symbol('BatchEntity');
6
- let BatchEntityClass = class BatchEntityClass extends BatchEntity$1 {
7
- groupId;
8
- // added when allocate inventory, used to link to sale
9
- saleId;
10
- saleSerialId;
11
- // added when customer return, used to link to customer
12
- customerId;
13
- // added when vendor return, used to link to vendor
14
- vendorId;
15
- // added when quality inspection, used to link to quality inspection order
16
- inspectionResult;
17
- // added when transfer inventory, used to link to transfer order
18
- transferId;
19
- // added when hold inventory, used to link to hold inventory order
20
- held;
21
- // added when shipment inventory, used to link to shipment order
22
- inShipment;
23
- batchGroup;
24
- };
25
- __decorate([
26
- Column({ type: 'varchar', nullable: true }),
27
- __metadata("design:type", String)
28
- ], BatchEntityClass.prototype, "groupId", void 0);
29
- __decorate([
30
- Column({ type: 'varchar', nullable: true }),
31
- __metadata("design:type", Object)
32
- ], BatchEntityClass.prototype, "saleId", void 0);
33
- __decorate([
34
- Column({ type: 'varchar', nullable: true }),
35
- __metadata("design:type", Object)
36
- ], BatchEntityClass.prototype, "saleSerialId", void 0);
37
- __decorate([
38
- Column({ type: 'varchar', nullable: true }),
39
- __metadata("design:type", Object)
40
- ], BatchEntityClass.prototype, "customerId", void 0);
41
- __decorate([
42
- Column({ type: 'varchar', nullable: true }),
43
- __metadata("design:type", Object)
44
- ], BatchEntityClass.prototype, "vendorId", void 0);
45
- __decorate([
46
- Column({ type: 'bool', nullable: true }),
47
- __metadata("design:type", Object)
48
- ], BatchEntityClass.prototype, "inspectionResult", void 0);
49
- __decorate([
50
- Column({ type: 'varchar', nullable: true }),
51
- __metadata("design:type", Object)
52
- ], BatchEntityClass.prototype, "transferId", void 0);
53
- __decorate([
54
- Column({ type: 'bool', default: false }),
55
- __metadata("design:type", Boolean)
56
- ], BatchEntityClass.prototype, "held", void 0);
57
- __decorate([
58
- Column({ type: 'bool', default: false }),
59
- __metadata("design:type", Boolean)
60
- ], BatchEntityClass.prototype, "inShipment", void 0);
61
- __decorate([
62
- ManyToOne('batch_groups', (batchGroup) => batchGroup.batches, {
63
- onDelete: 'CASCADE',
64
- orphanedRowAction: 'delete',
65
- }),
66
- JoinColumn({ name: 'groupId', referencedColumnName: 'id' }),
67
- __metadata("design:type", Function)
68
- ], BatchEntityClass.prototype, "batchGroup", void 0);
69
- BatchEntityClass = __decorate([
70
- ChildEntity()
71
- ], BatchEntityClass);
72
-
73
- export { BatchEntity, BatchEntityClass };
@@ -1,168 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject } from '@nestjs/common';
3
- import '../models/metadata/batch.entity.js';
4
- import '../models/metadata/batch-group.entity.js';
5
- import '../models/metadata/loader.entity.js';
6
- import '../models/metadata/loader-type.entity.js';
7
- import '../models/metadata/loader-unit.entity.js';
8
- import '../models/metadata/location.entity.js';
9
- import '../models/metadata/material.entity.js';
10
- import '../models/metadata/material-unit.entity.js';
11
- import '@rytass/wms-base-nestjs-module';
12
- import '../models/metadata/sale-order.entity.js';
13
- import '../models/metadata/stock.entity.js';
14
- import '../models/metadata/unit.entity.js';
15
- import { WmsEntities } from '../models/wms-entities.js';
16
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js';
17
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.js';
18
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js';
19
- import '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js';
20
- import '../models/extensions/ship-inventory-order/ship-inventory-order.entity.js';
21
- import '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js';
22
- import '../models/extensions/ship-inventory-order/ship-inventory-order-change.entity.js';
23
- import '../models/extensions/transfer-order/transfer-order.entity.js';
24
- import '../models/extensions/transfer-order/transfer-order-item.entity.js';
25
- import '../models/extensions/transfer-order/transfer-order-change.entity.js';
26
- import '../models/extensions/hold-inventory-order/hold-inventory-order.entity.js';
27
- import '../models/extensions/hold-inventory-order/hold-inventory-order-item.entity.js';
28
- import '../models/extensions/hold-inventory-order/hold-inventory-order-change.entity.js';
29
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order.entity.js';
30
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.js';
31
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.js';
32
- import { SplitBatchOrderEntity } from '../models/extensions/split-batch-order/split-batch-order.entity.js';
33
- import { SplitBatchOrderItemEntity } from '../models/extensions/split-batch-order/split-batch-order-item.entity.js';
34
- import { SplitBatchOrderChangeEntityClass } from '../models/extensions/split-batch-order/split-batch-order-change.entity.js';
35
- import '../models/extensions/merge-batch-order/merge-batch-order.entity.js';
36
- import '../models/extensions/merge-batch-order/merge-batch-order-item.entity.js';
37
- import '../models/extensions/merge-batch-order/merge-batch-order-change.entity.js';
38
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.js';
39
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.js';
40
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.js';
41
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order.entity.js';
42
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.js';
43
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.js';
44
- import '../models/extensions/quality-inspection-order/quality-inspection-order.entity.js';
45
- import '../models/extensions/quality-inspection-order/quality-inspection-order-item.entity.js';
46
- import '../models/extensions/quality-inspection-order/quality-inspection-order-change.entity.js';
47
- import '../models/extensions/transfer-customer-order/transfer-customer-order.entity.js';
48
- import '../models/extensions/transfer-customer-order/transfer-customer-order-item.entity.js';
49
- import '../models/extensions/transfer-customer-order/transfer-customer-order-change.entity.js';
50
- import '../models/extensions/scrape-order/scrape-order.entity.js';
51
- import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
- import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
- import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
- import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
- import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
56
- import { DataSource } from 'typeorm';
57
- import { MaterialService } from './material.service.js';
58
- import { BatchService } from './batch.service.js';
59
- import { HelperService } from './helper.service.js';
60
- import { StockService } from './stock.service.js';
61
-
62
- let SplitBatchOrderService = class SplitBatchOrderService {
63
- dataSource;
64
- entities;
65
- materialService;
66
- batchService;
67
- helperService;
68
- stockService;
69
- splitBatchOrderEntity;
70
- splitBatchOrderItemEntity;
71
- seqPrefix = 'SBO';
72
- constructor(dataSource, entities, materialService, batchService, helperService, stockService, splitBatchOrderEntity, splitBatchOrderItemEntity) {
73
- this.dataSource = dataSource;
74
- this.entities = entities;
75
- this.materialService = materialService;
76
- this.batchService = batchService;
77
- this.helperService = helperService;
78
- this.stockService = stockService;
79
- this.splitBatchOrderEntity = splitBatchOrderEntity;
80
- this.splitBatchOrderItemEntity = splitBatchOrderItemEntity;
81
- }
82
- split(options) {
83
- return this.dataSource.transaction(async (manager) => {
84
- const splitBatchOrderRepository = manager.getRepository(this.splitBatchOrderEntity);
85
- const splitBatchOrderItemRepository = manager.getRepository(this.splitBatchOrderItemEntity);
86
- const splitBatchOrderChangeRepository = manager.getRepository(SplitBatchOrderChangeEntityClass);
87
- const orderRepository = manager.getRepository(this.entities.order);
88
- const stockRepository = manager.getRepository(this.entities.stock);
89
- const batchRepository = manager.getRepository(this.entities.batch);
90
- // Get original batch information
91
- const originalBatch = await batchRepository.findOneOrFail({
92
- where: { id: options.batchId },
93
- });
94
- const key = await this.helperService.getSeq(this.seqPrefix, manager);
95
- const order = await splitBatchOrderRepository.save(splitBatchOrderRepository.create({
96
- key,
97
- }));
98
- // Get conversion factor for unit conversion
99
- const conversionFactor = await this.materialService.getConversionFactor(originalBatch.materialId, options.unitId || undefined);
100
- // Process each item split
101
- await Promise.all(options.items.map(async (item) => {
102
- // Get or create target batch
103
- const targetBatch = await this.batchService.getBatch({
104
- key: item.batchKey,
105
- materialId: originalBatch.materialId,
106
- manager,
107
- });
108
- // Create base order record
109
- const baseOrder = await orderRepository.save({});
110
- // Create split batch order item
111
- const splitItem = await splitBatchOrderItemRepository.save(splitBatchOrderItemRepository.create({
112
- targetSplitQuantity: item.quantity,
113
- locationId: this.stockService.resolveLocationId(item.locationId),
114
- loaderId: item.loaderId,
115
- orderId: order.id,
116
- }));
117
- // Record the change
118
- await splitBatchOrderChangeRepository.save(splitBatchOrderChangeRepository.create({
119
- itemId: splitItem.id,
120
- id: baseOrder.id,
121
- quantityChanged: item.quantity * conversionFactor,
122
- }));
123
- // Update stock: deduct from original batch and add to target batch
124
- await this.stockService.validateStockAvailability({
125
- materialId: originalBatch.materialId,
126
- batchId: options.batchId,
127
- locationId: this.stockService.resolveLocationId(item.locationId),
128
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
129
- quantity: item.quantity * conversionFactor,
130
- }, manager);
131
- await stockRepository.save(stockRepository.create([
132
- // Deduct from original batch
133
- {
134
- orderId: baseOrder.id,
135
- materialId: originalBatch.materialId,
136
- batchId: options.batchId,
137
- locationId: this.stockService.resolveLocationId(item.locationId),
138
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
139
- quantity: -1 * item.quantity * conversionFactor,
140
- },
141
- // Add to target batch
142
- {
143
- orderId: baseOrder.id,
144
- materialId: originalBatch.materialId,
145
- batchId: targetBatch.id,
146
- locationId: this.stockService.resolveLocationId(item.locationId),
147
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
148
- quantity: item.quantity * conversionFactor,
149
- },
150
- ]));
151
- }));
152
- return order;
153
- });
154
- }
155
- };
156
- SplitBatchOrderService = __decorate([
157
- Injectable(),
158
- __param(6, Inject(SplitBatchOrderEntity)),
159
- __param(7, Inject(SplitBatchOrderItemEntity)),
160
- __metadata("design:paramtypes", [DataSource,
161
- WmsEntities,
162
- MaterialService,
163
- BatchService,
164
- HelperService,
165
- StockService, Object, Object])
166
- ], SplitBatchOrderService);
167
-
168
- export { SplitBatchOrderService };
@@ -1,34 +0,0 @@
1
- import type { MaterialEntityClass } from '../models/metadata/material.entity';
2
- /**
3
- * Consumer-supplied replacements for the entity classes the module binds its
4
- * entity Symbols to.
5
- *
6
- * An override has to be a `@ChildEntity()` of the class it replaces: the tables
7
- * (`materials`, …) and their `@TableInheritance()` discriminator columns are part
8
- * of the module's schema contract, so an override *joins* the existing
9
- * single-table hierarchy — it never moves the data to another table.
10
- *
11
- * Entity classes are static, so — unlike the credentials in
12
- * `WMSBaseModuleOptions` — they are configured **synchronously**, even on
13
- * `forRootAsync`. `TypeOrmModule.forFeature()` and the `Symbol` → entity
14
- * providers are built while the module graph is assembled, long before an async
15
- * options factory has resolved; an entity that only appears in the factory's
16
- * result would be too late to register. `WmsModuleCoreModule.forRootAsync`
17
- * therefore takes these next to `defaultLocationKey` and forwards them into the
18
- * base module's options for you, and throws if the async factory tries to set
19
- * one behind their back.
20
- */
21
- export interface WmsModuleEntityOverrides {
22
- /**
23
- * Replaces `MaterialEntityClass` everywhere the module reads or writes
24
- * materials: the `MaterialEntity` Symbol, `MaterialService`, the receive /
25
- * ship / reclassify order services, `StockService`'s `materialKey` filter and
26
- * the GraphQL `material` DataLoaders.
27
- */
28
- readonly materialEntity?: new () => MaterialEntityClass;
29
- }
30
- /**
31
- * The overridable entity options, paired for `Object.keys`-style iteration over
32
- * {@link WmsModuleEntityOverrides} without losing the key type.
33
- */
34
- export declare const WMS_ENTITY_OVERRIDE_KEYS: readonly (keyof WmsModuleEntityOverrides)[];
@@ -1,7 +0,0 @@
1
- /**
2
- * The overridable entity options, paired for `Object.keys`-style iteration over
3
- * {@link WmsModuleEntityOverrides} without losing the key type.
4
- */
5
- const WMS_ENTITY_OVERRIDE_KEYS = ['materialEntity'];
6
-
7
- export { WMS_ENTITY_OVERRIDE_KEYS };
@@ -1,219 +0,0 @@
1
- # Order Management Entities
2
-
3
- This directory contains all order-related entities for the WMS system. Each order type follows a consistent three-entity pattern to manage inventory operations.
4
-
5
- ## Entity Pattern
6
-
7
- Each order group consists of three interconnected entities:
8
-
9
- ### 1. `*.order.entity.ts` - Order Master
10
-
11
- **Purpose**: Groups order items together, representing a single user-initiated order operation.
12
-
13
- **Characteristics**:
14
-
15
- - Represents a creation event from the user
16
- - Contains metadata like `key`, `description`, `createdAt`
17
- - Has a one-to-many relationship with items
18
- - May include specific fields depending on order type (e.g., `vendor`, `customer`, `reason`, `inspector`)
19
-
20
- **Example**: `HoldInventoryOrderEntityClass`
21
-
22
- - Groups multiple items that need to be held together
23
- - Single order can affect multiple locations/batches
24
-
25
- ---
26
-
27
- ### 2. `*.order-item.entity.ts` - Order Item (Line Item)
28
-
29
- **Purpose**: Defines which material will be manipulated, by which batch, at which location, with which loader, and what quantity.
30
-
31
- **Characteristics**:
32
-
33
- - Many-to-one relationship with the order
34
- - References metadata: `Location`, `Loader`, `Material` (implied through usage)
35
- - Specifies the target quantity for the action (e.g., `targetHeldQuantity`, `targetTransferredQuantity`)
36
- - May be partially or fully executed
37
-
38
- **Structure**:
39
-
40
- ```
41
- - material (via external reference)
42
- - batch (via external reference)
43
- - location (uuid reference)
44
- - loader (uuid reference)
45
- - targetQuantity (numeric)
46
- - order (reference to parent order)
47
- ```
48
-
49
- **Example**: `HoldInventoryOrderItemEntityClass`
50
-
51
- - Specifies that 100 units of Material X in Batch Y at Location Z should be held
52
- - May use Loader A for the operation
53
-
54
- ---
55
-
56
- ### 3. `*.order-change.entity.ts` - Order Change (Execution Record)
57
-
58
- **Purpose**: Records the actual execution of an item, which may be partial or complete.
59
-
60
- **Characteristics**:
61
-
62
- - Many-to-one relationship with order items
63
- - One-to-one relationship with system `Order` (from base module)
64
- - Records `quantityChanged` - the actual quantity executed
65
- - Triggers the creation of corresponding stock records
66
-
67
- **Key Logic**:
68
- When an `order-change` is created, it automatically creates one or more `Stock` records based on the order type.
69
-
70
- ---
71
-
72
- ## Stock Records Created by Order Changes
73
-
74
- Different order types create different stock records:
75
-
76
- ### Single Stock Record
77
-
78
- - **receive-inventory-order**: Creates **+n** quantity record
79
- - **ship-inventory-order**: Creates **-n** quantity record
80
- - **transfer-order**: Creates **-n** (from source) and **+n** (at destination)
81
-
82
- ### Multiple Stock Records (Inventory Status Change)
83
-
84
- - **hold-inventory-order**: Creates **2** records
85
- 1. **+n** quantity with status: `HELD`
86
- 2. **-n** quantity from status: `FREE`
87
-
88
- - **release-inventory-order**: Creates **2** records
89
- 1. **-n** quantity from status: `HELD`
90
- 2. **+n** quantity with status: `FREE`
91
-
92
- - **allocate-inventory-order**: Creates **2** records
93
- 1. **+n** quantity with status: `ALLOCATED`
94
- 2. **-n** quantity from status: `FREE`
95
-
96
- - **deallocate-inventory-order**: Creates **2** records
97
- 1. **-n** quantity from status: `ALLOCATED`
98
- 2. **+n** quantity with status: `FREE`
99
-
100
- - **quality-inspection-order**: Creates **1-2** records
101
- - Full pass: **-n** from `FREE` or current status
102
- - Partial fail: **-n** failed, **+n** defective
103
-
104
- - **Other order types**: Follow similar patterns based on inventory flow
105
-
106
- ---
107
-
108
- ## Actual Inventory Calculation
109
-
110
- The actual inventory is determined by aggregating and summing all stock records:
111
-
112
- ```
113
- SELECT
114
- material_id,
115
- batch_id,
116
- location_id,
117
- loader_id,
118
- status,
119
- SUM(quantity) as total_quantity
120
- FROM stocks
121
- GROUP BY material_id, batch_id, location_id, loader_id, status
122
- HAVING SUM(quantity) > 0
123
- ```
124
-
125
- **Dimensions**:
126
-
127
- - `material`: Which product
128
- - `batch`: Which batch/lot
129
- - `location`: Where it is stored
130
- - `loader`: Which loader/container holds it
131
- - `status`: Inventory classification (FREE, HELD, ALLOCATED, DEFECTIVE, etc.)
132
-
133
- ---
134
-
135
- ## Order Type Examples
136
-
137
- ### Hold Inventory Order
138
-
139
- ```
140
- Order → Items → Changes → 2 Stock Records
141
- Item: 100 units at Location A
142
- ↓
143
- Change: Execute 100 units
144
- ↓
145
- Stocks:
146
- 1. +100 (HELD) at Location A
147
- 2. -100 (FREE) at Location A
148
- ```
149
-
150
- ### Transfer Inventory Order
151
-
152
- ```
153
- Order → Items → Changes → Multiple Stock Records
154
- Item: 50 units from Location A to Location B
155
- ↓
156
- Change: Execute 50 units
157
- ↓
158
- Stocks:
159
- 1. -50 at Location A
160
- 2. +50 at Location B
161
- ```
162
-
163
- ---
164
-
165
- ## Data Flow Summary
166
-
167
- ```
168
- User Action
169
- ↓
170
- Order Created (*.order.entity)
171
- ↓
172
- Order Items Added (*.order-item.entity)
173
- ↓
174
- Order Execution (*.order-change.entity)
175
- ↓
176
- Stock Records Created
177
- ↓
178
- Inventory Available for Query
179
- (Grouped by: material + batch + location + loader + status)
180
- ```
181
-
182
- ---
183
-
184
- ## File Organization
185
-
186
- ```
187
- extensions/
188
- ├── README.md (this file)
189
- ├── receive-inventory-order/
190
- │ ├── receive-inventory-order.entity.ts
191
- │ ├── receive-inventory-order-item.entity.ts
192
- │ └── receive-inventory-order-change.entity.ts
193
- ├── ship-inventory-order/
194
- ├── transfer-order/
195
- ├── hold-inventory-order/
196
- ├── release-inventory-order/
197
- ├── allocate-inventory-order/
198
- ├── deallocate-inventory-order/
199
- ├── split-batch-order/
200
- ├── merge-batch-order/
201
- ├── reclassify-inventory-order/
202
- ├── transfer-vendor-order/
203
- ├── return-vendor-order/
204
- ├── quality-inspection-order/
205
- ├── transfer-customer-order/
206
- ├── return-customer-order/
207
- └── index.ts (exports all entities)
208
- ```
209
-
210
- ---
211
-
212
- ## Key Design Principles
213
-
214
- 1. **Three-Layer Model**: Order → Items → Changes ensures traceability
215
- 2. **Immutable History**: All changes are recorded as new records, never modified
216
- 3. **Stock-Based Inventory**: No direct quantity fields; inventory is calculated from stocks
217
- 4. **Status Tracking**: Stock records track material status through its lifecycle
218
- 5. **Flexibility**: Partial execution supported through quantity-based changes
219
- 6. **Auditability**: Every stock movement is traceable to an order and change record