@operato/twin-kernel 0.11.14 → 0.11.15

package/dist/kernel.js

@@ -9,7 +9,7 @@ import { CMD } from '@operato/ops-contract';
 import { firstFitPolicy } from "./allocation-policy.js";
 import { FlowEngine } from "./flow-engine.js";
 import { planMakeToOrder } from "./make-to-order.js";
-import { BIZSTEP, BTT } from '@operato/ops-contract';
+import { BIZSTEP, BTT, WMS_ORDER_KIND } from '@operato/ops-contract';
 import { DISP, ILMD_ATTR, aggregationEvent, objectEvent, transactionEvent } from '@operato/ops-contract';
 import { subLotIdOf, itemKeyOf } from '@operato/ops-contract';
 const TRAVEL_MS = 30_000;
@@ -133,7 +133,7 @@ export class WmsKernel extends FlowEngine {
         const so = this.requireBizTransactionId(`SO-${soSeq}`, 'salesorder');
         const requested = lines.reduce((s, l) => s + l.qty, 0);
         const order = {
-            id, kind: 'outbound', status: 'created', requested, fulfilled: 0, bizTransaction: so,
+            id, kind: WMS_ORDER_KIND.outbound, status: 'created', requested, fulfilled: 0, bizTransaction: so,
             allocated: [], picked: [], shipmentEpc: null, lines: lines.map(l => ({ gtin: l.gtin, requested: l.qty })),
             ...(spec ? this.promiseOf(spec) : {})
         };
@@ -175,7 +175,7 @@ export class WmsKernel extends FlowEngine {
         /* 할당은 아직 집은 것이 아니다 — 물건은 보관 자리에 있고 처분만 '예약' 으로 바뀐다.
          * 그래서 단계는 storing 이다(피킹 관측은 실제로 집을 때 따로 난다). */
         this.reserve(chosenAll, BIZSTEP.storing);
-        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.so, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
+        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.poc, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
         for (const epc of chosenAll) {
             const it = this.items.get(epc);
             const id = `task-${++this.taskSeq}`;
@@ -363,7 +363,7 @@ export class WmsKernel extends FlowEngine {
         const shpSeq = ++this.epcSeq;
         const shipment = this.requireObjectId(`SHP-${shpSeq}`);
         order.shipmentEpc = shipment;
-        const soTxn = [{ type: BTT.so, bizTransaction: order.bizTransaction }];
+        const soTxn = [{ type: BTT.poc, bizTransaction: order.bizTransaction }];
         // 패킹: 화물(shipment) ← 팔레트 조립(merge). 팔레트는 출하 DELETE 까지 독립 유지 → consume 없음.
         this.aggregate(shipment, order.picked.slice(), { bizStep: BIZSTEP.packing, readPoint: staging.id, bizLocation: staging.id });
         order.status = 'packed';

package/dist/yms-kernel.js

@@ -19,7 +19,7 @@ import { itemKeyOf } from '@operato/ops-contract';
 import { firstFitPolicy } from "./allocation-policy.js";
 import { FlowEngine } from "./flow-engine.js";
 import { DISP, objectEvent, transactionEvent } from '@operato/ops-contract';
-import { YARD_BIZSTEP, BTT_DELIVERY } from '@operato/ops-contract';
+import { YARD_BIZSTEP } from '@operato/ops-contract';
 const TRAVEL_MS = 20_000; // 야드 이동
 const DWELL_MS = 30_000; // 도크 체류(상·하차) — depart 이동에 folded
 const WINDOW_DELAY_MS = 40_000; // 도착 후 어포인트먼트 창까지(early arrival → 대기)
@@ -149,7 +149,7 @@ export class YmsKernel extends FlowEngine {
             this.trailerCargo.set(trailer.epc, avail.slice(0, CARGO_PER_TRAILER).map(i => i.epc));
         }
         this.reserve([trailer.epc], bizStep); // 처분 변화를 이벤트로 — 미러가 "잡혔다" 를 알 수 있게
-        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep, bizTransactionList: [{ type: BTT_DELIVERY, bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
+        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep, bizTransactionList: [{ bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
         // drop: 야드→도크 pull. live: 게이트→도크 직행(spot-live). 둘 다 toNode=도크도어.
         const dockKind = mode === 'drop' ? 'pull' : 'spot-live';
         const task = { id: `task-${++this.taskSeq}`, kind: dockKind, status: 'created', itemEpc: trailer.epc, fromNode: trailer.location, toNode: door.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: dockKind, fromNode: trailer.location, toNode: door.id }, TRAVEL_MS), orderId: o.id };

package/dist-cjs/index.cjs

@@ -993,8 +993,28 @@ var BIZSTEP = {
   replenishing: "urn:epcglobal:cbv:bizstep:replenishing"
 };
 var BTT = {
+  /** Purchase Order — the document an inbound receipt is made against. */
   po: "urn:epcglobal:cbv:btt:po",
-  so: "urn:epcglobal:cbv:btt:so"
+  /** Purchase Order Confirmation — the seller's sales order. */
+  poc: "urn:epcglobal:cbv:btt:poc",
+  /** Despatch Advice (ASN) — announces an inbound delivery; also attached when shipping. */
+  desadv: "urn:epcglobal:cbv:btt:desadv",
+  /** Receiving Advice — the reply once an inbound receipt is complete. */
+  recadv: "urn:epcglobal:cbv:btt:recadv",
+  /** Return Merchandise Authorization — what a return is received against. */
+  rma: "urn:epcglobal:cbv:btt:rma",
+  /** Bill of Lading — the carrier's document, attached when shipping. */
+  bol: "urn:epcglobal:cbv:btt:bol"
+};
+var WMS_ORDER_KIND = {
+  /** Expected receipt (ASN). The kernel has no inbound order yet — arrival carries a `po` without one. */
+  inbound: "inbound",
+  /** Outbound order — what the kernel's sales order is. */
+  outbound: "outbound",
+  /** Receipt of returned goods. */
+  return: "return",
+  /** Stock transfer between sites. CBV has no document type for it: carry the id without a type. */
+  transfer: "transfer"
 };
 var WMS_LOCATION_TYPES = ["dock", "storage", "staging", "dock-ship", "vas-station"];
 var WMS_LOCATION_LEVEL = {
@@ -1025,7 +1045,6 @@ var YARD_BIZSTEP = {
   departing: "urn:epcglobal:cbv:bizstep:departing"
   // 게이트-아웃
 };
-var BTT_DELIVERY = "urn:epcglobal:cbv:btt:deliv";
 var YMS_LOCATION_TYPES = ["gate", "yard-slot", "dock-door", "staging"];
 var YMS_LOCATION_LEVEL = {
   gate: "Other",
@@ -7130,7 +7149,7 @@ var WmsKernel = class extends FlowEngine {
     const requested = lines.reduce((s, l) => s + l.qty, 0);
     const order = {
       id,
-      kind: "outbound",
+      kind: WMS_ORDER_KIND.outbound,
       status: "created",
       requested,
       fulfilled: 0,
@@ -7166,7 +7185,7 @@ var WmsKernel = class extends FlowEngine {
     }
     if (chosenAll.length === 0) return this.makeShortLines(o);
     this.reserve(chosenAll, BIZSTEP.storing);
-    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.so, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
+    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.poc, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
     for (const epc of chosenAll) {
       const it = this.items.get(epc);
       const id = `task-${++this.taskSeq}`;
@@ -7317,7 +7336,7 @@ var WmsKernel = class extends FlowEngine {
     const shpSeq = ++this.epcSeq;
     const shipment = this.requireObjectId(`SHP-${shpSeq}`);
     order.shipmentEpc = shipment;
-    const soTxn = [{ type: BTT.so, bizTransaction: order.bizTransaction }];
+    const soTxn = [{ type: BTT.poc, bizTransaction: order.bizTransaction }];
     this.aggregate(shipment, order.picked.slice(), { bizStep: BIZSTEP.packing, readPoint: staging.id, bizLocation: staging.id });
     order.status = "packed";
     this.emit(objectEvent({ eventTime, action: "OBSERVE", bizStep: BIZSTEP.staging_outbound, disposition: DISP.reserved, epcList: [shipment], readPoint: staging.id, bizLocation: staging.id, bizTransactionList: soTxn }));
@@ -7457,7 +7476,7 @@ var YmsKernel = class extends FlowEngine {
       this.trailerCargo.set(trailer.epc, avail.slice(0, CARGO_PER_TRAILER).map((i) => i.epc));
     }
     this.reserve([trailer.epc], bizStep);
-    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep, bizTransactionList: [{ type: BTT_DELIVERY, bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
+    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep, bizTransactionList: [{ bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
     const dockKind = mode === "drop" ? "pull" : "spot-live";
     const task = { id: `task-${++this.taskSeq}`, kind: dockKind, status: "created", itemEpc: trailer.epc, fromNode: trailer.location, toNode: door.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: dockKind, fromNode: trailer.location, toNode: door.id }, TRAVEL_MS2), orderId: o.id };
     this.tasks.set(task.id, task);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.11.14",
+  "version": "0.11.15",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {
@@ -28,6 +28,6 @@
     "test": "node --test test/*.test.ts"
   },
   "dependencies": {
-    "@operato/ops-contract": "^0.9.22"
+    "@operato/ops-contract": "^0.9.24"
   }
 }