@tolinax/ayoune-interfaces 2026.26.0 → 2026.27.0

package/data/modelNames.d.ts

@@ -406,6 +406,7 @@ export declare enum aMN {
     IndustryKPIs = "IndustryKPIs",
     MarketResearches = "MarketResearches",
     Markets = "Markets",
+    MaterialCommissionings = "MaterialCommissionings",
     MeetingLocations = "MeetingLocations",
     MeetingMinutes = "MeetingMinutes",
     Meetings = "Meetings",
@@ -449,6 +450,7 @@ export declare enum aMN {
     PaymentGroups = "PaymentGroups",
     PaymentProviders = "PaymentProviders",
     PermissionRequests = "PermissionRequests",
+    PickLists = "PickLists",
     PimSelections = "PimSelections",
     Pipelines = "Pipelines",
     Polls = "Polls",
@@ -495,6 +497,7 @@ export declare enum aMN {
     PublicationRuns = "PublicationRuns",
     Publications = "Publications",
     PublisherAPIs = "PublisherAPIs",
+    PutAwayOrders = "PutAwayOrders",
     PushClicks = "PushClicks",
     PushDeliveries = "PushDeliveries",
     PushErrors = "PushErrors",
@@ -571,6 +574,7 @@ export declare enum aMN {
     StateLogs = "StateLogs",
     States = "States",
     StockLogs = "StockLogs",
+    StockReservations = "StockReservations",
     Stocks = "Stocks",
     StorageAreas = "StorageAreas",
     StoreAssets = "StoreAssets",

package/data/modelNames.js

@@ -410,6 +410,7 @@ var aMN;
     aMN["IndustryKPIs"] = "IndustryKPIs";
     aMN["MarketResearches"] = "MarketResearches";
     aMN["Markets"] = "Markets";
+    aMN["MaterialCommissionings"] = "MaterialCommissionings";
     aMN["MeetingLocations"] = "MeetingLocations";
     aMN["MeetingMinutes"] = "MeetingMinutes";
     aMN["Meetings"] = "Meetings";
@@ -453,6 +454,7 @@ var aMN;
     aMN["PaymentGroups"] = "PaymentGroups";
     aMN["PaymentProviders"] = "PaymentProviders";
     aMN["PermissionRequests"] = "PermissionRequests";
+    aMN["PickLists"] = "PickLists";
     aMN["PimSelections"] = "PimSelections";
     aMN["Pipelines"] = "Pipelines";
     aMN["Polls"] = "Polls";
@@ -499,6 +501,7 @@ var aMN;
     aMN["PublicationRuns"] = "PublicationRuns";
     aMN["Publications"] = "Publications";
     aMN["PublisherAPIs"] = "PublisherAPIs";
+    aMN["PutAwayOrders"] = "PutAwayOrders";
     aMN["PushClicks"] = "PushClicks";
     aMN["PushDeliveries"] = "PushDeliveries";
     aMN["PushErrors"] = "PushErrors";
@@ -575,6 +578,7 @@ var aMN;
     aMN["StateLogs"] = "StateLogs";
     aMN["States"] = "States";
     aMN["StockLogs"] = "StockLogs";
+    aMN["StockReservations"] = "StockReservations";
     aMN["Stocks"] = "Stocks";
     aMN["StorageAreas"] = "StorageAreas";
     aMN["StoreAssets"] = "StoreAssets";

package/data/modelsAndRights.js

@@ -4266,6 +4266,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "MaterialCommissionings",
+        singular: "MaterialCommissioning",
+        module: "warehouse",
+        right: "warehouse.materialcommissionings",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "MeetingLocations",
         singular: "MeetingLocation",
@@ -4693,6 +4703,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PickLists",
+        singular: "PickList",
+        module: "warehouse",
+        right: "warehouse.picklists",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PimSelections",
         singular: "PimSelection",
@@ -5151,6 +5171,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PutAwayOrders",
+        singular: "PutAwayOrder",
+        module: "warehouse",
+        right: "warehouse.putawayorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PushClicks",
         singular: "PushClick",
@@ -5843,6 +5873,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "StockReservations",
+        singular: "StockReservation",
+        module: "warehouse",
+        right: "warehouse.stockreservations",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Stocks",
         singular: "Stock",

package/interfaces/IMaterialCommissioning.d.ts

@@ -0,0 +1,58 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Material Commissioning Position — single material line in a commissioning order.
+ */
+export interface IMaterialCommissioningPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    qtyRequired: number;
+    qtyReserved?: number;
+    qtyPicked?: number;
+    qtyDelivered?: number;
+    qtyConsumed?: number;
+    qtyReturned?: number;
+    unit?: string;
+    lot?: ObjectId;
+    storageArea?: ObjectId;
+    warehouse?: ObjectId;
+    stockReservation?: ObjectId;
+    status: "pending" | "reserved" | "picked" | "delivered" | "consumed" | "returned" | "short";
+    pickedAt?: Date;
+    deliveredAt?: Date;
+    consumedAt?: Date;
+    note?: string;
+}
+/**
+ * Material Commissioning — formal workflow for picking and delivering material to a production step.
+ *
+ * Solves the gap that material is currently embedded as a subdocument in IProductionOrder.material[]
+ * and IProductionOrdersPosition.material[] without standalone CRUD or audit trail.
+ *
+ * Lifecycle: planned → reserved → picking → delivered → consumed
+ */
+export interface IMaterialCommissioning extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    status: "planned" | "reserved" | "picking" | "delivered" | "consumed" | "cancelled";
+    productionOrder: ObjectId;
+    productionOrderPosition?: number;
+    productionOrderPositionStep?: number;
+    workCenter?: ObjectId;
+    machine?: ObjectId;
+    positions: IMaterialCommissioningPosition[];
+    totalLines?: number;
+    completedLines?: number;
+    progress?: number;
+    pickList?: ObjectId;
+    plannedFor?: Date;
+    reservedAt?: Date;
+    pickedAt?: Date;
+    deliveredAt?: Date;
+    consumedAt?: Date;
+    deliveredBy?: ObjectId;
+    note?: string;
+}

package/interfaces/IMaterialCommissioning.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IPickList.d.ts

@@ -0,0 +1,68 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Pick List Position — single line in a pick list.
+ */
+export interface IPickListPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    storageArea?: ObjectId;
+    warehouse?: ObjectId;
+    qtyRequested: number;
+    qtyPicked?: number;
+    qtyMissing?: number;
+    unit?: string;
+    lot?: ObjectId;
+    lotNumber?: string;
+    serialNumbers?: string[];
+    sourceType: "assignment" | "productionOrder" | "shipping" | "internalOrder" | "manual";
+    sourceId: ObjectId;
+    sourcePosition?: number;
+    sourceStep?: number;
+    stockReservation?: ObjectId;
+    status: "pending" | "picked" | "short" | "skipped" | "cancelled";
+    pickedAt?: Date;
+    pickedBy?: ObjectId;
+    note?: string;
+    skipReason?: string;
+}
+/**
+ * Pick List — formal picking instruction for warehouse workers.
+ *
+ * Replaces the gap where IPackList was used loosely for both picking and packing.
+ * IPickList is strictly for picking; IPackList stays for packing.
+ *
+ * Picking strategies:
+ * - single_order: one assignment / production order per pick
+ * - wave: multiple orders grouped, picker walks once
+ * - batch: same product across many orders, then sort
+ * - cluster: multiple bins on a cart, sorted in real-time
+ */
+export interface IPickList extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    name?: string;
+    status: "open" | "in_progress" | "completed" | "cancelled";
+    type: "single_order" | "wave" | "batch" | "cluster";
+    warehouse: ObjectId;
+    assignedTo?: ObjectId;
+    assignments?: ObjectId[];
+    productionOrders?: ObjectId[];
+    shippings?: ObjectId[];
+    internalOrders?: ObjectId[];
+    pickWave?: ObjectId;
+    positions: IPickListPosition[];
+    totalLines?: number;
+    pickedLines?: number;
+    progress?: number;
+    pickingStrategy?: "fifo" | "lifo" | "fefo" | "random" | "shortest_path";
+    walkingPath?: ObjectId[];
+    startedAt?: Date;
+    completedAt?: Date;
+    deadline?: Date;
+    pickConfirmation?: ObjectId;
+    note?: string;
+}

package/interfaces/IPickList.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IPutAwayOrder.d.ts

@@ -0,0 +1,58 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Put-Away Position — single line in a put-away order.
+ */
+export interface IPutAwayPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    qty: number;
+    unit?: string;
+    lot?: ObjectId;
+    lotNumber?: string;
+    serialNumbers?: string[];
+    sourceArea?: ObjectId;
+    suggestedArea?: ObjectId;
+    suggestedReason?: "empty_bin" | "same_product" | "abc_class" | "fefo" | "fifo" | "manual";
+    actualArea?: ObjectId;
+    placedAt?: Date;
+    placedBy?: ObjectId;
+    status: "pending" | "placed" | "skipped";
+    note?: string;
+}
+/**
+ * Put-Away Order — instruction for warehouse workers to place received goods in storage.
+ *
+ * Solves the gap that after a GoodsReceipt is approved, there is no formal instruction
+ * where to put the items. Receiving area accumulates without systematic placement.
+ *
+ * Strategies:
+ * - empty_bin: prefer empty storage areas first
+ * - same_product: consolidate with existing stock of same product
+ * - abc_class: place high-velocity items in close locations
+ * - fefo: first-expiry-first-out (for perishables)
+ * - fifo: first-in-first-out
+ * - manual: warehouse worker decides
+ */
+export interface IPutAwayOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    warehouse: ObjectId;
+    assignedTo?: ObjectId;
+    goodsReceipt?: ObjectId;
+    productionOrder?: ObjectId;
+    internalOrder?: ObjectId;
+    returnOrder?: ObjectId;
+    strategy?: "empty_bin" | "same_product" | "abc_class" | "fefo" | "fifo" | "manual";
+    positions: IPutAwayPosition[];
+    totalLines?: number;
+    completedLines?: number;
+    progress?: number;
+    startedAt?: Date;
+    completedAt?: Date;
+    note?: string;
+}

package/interfaces/IPutAwayOrder.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IStock.d.ts

@@ -8,6 +8,14 @@ export interface IStock extends IDefaultFields {
     warehouse?: ObjectId;
     storageArea?: ObjectId;
     amount?: number;
+    /** Sum of active stock reservations against this stock record (computed). */
+    amountReserved?: number;
+    /** amount - amountReserved (computed). Authoritative for available-to-promise. */
+    amountAvailable?: number;
+    /** Quantity currently in quality control. */
+    amountInQC?: number;
+    /** Quantity currently in quarantine. */
+    amountInQuarantine?: number;
     unit?: string;
     serialNumber?: string;
     lotNumber?: string;

package/interfaces/IStockLog.d.ts

@@ -1,4 +1,32 @@
 import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Canonical movement types for stock log entries.
+ *
+ * Use these constants instead of free-form strings to prevent typos.
+ * The `kindofmovement` field on IStockLog stays a `string` for backward compat —
+ * but new code should use values from this enum.
+ */
+export declare enum StockMovementKind {
+    Incoming = "incoming",
+    Outgoing = "outgoing",
+    Transfer = "transfer",
+    Reservation = "reservation",
+    ReservationRelease = "reservation_release",
+    Production = "production",
+    Consumption = "consumption",
+    PutAway = "putaway",
+    Picking = "picking",
+    Pack = "pack",
+    Ship = "ship",
+    Return = "return",
+    Adjustment = "adjustment",
+    QuarantineIn = "quarantine_in",
+    QuarantineOut = "quarantine_out",
+    QcIn = "qc_in",
+    QcOut = "qc_out",
+    Replenishment = "replenishment",
+    InventoryCount = "inventory_count"
+}
 export interface IStockLog extends IDefaultFields {
     _customerID: ObjectId;
     _clientID?: ObjectId[];

package/interfaces/IStockLog.js

@@ -1,2 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.StockMovementKind = void 0;
+/**
+ * Canonical movement types for stock log entries.
+ *
+ * Use these constants instead of free-form strings to prevent typos.
+ * The `kindofmovement` field on IStockLog stays a `string` for backward compat —
+ * but new code should use values from this enum.
+ */
+var StockMovementKind;
+(function (StockMovementKind) {
+    StockMovementKind["Incoming"] = "incoming";
+    StockMovementKind["Outgoing"] = "outgoing";
+    StockMovementKind["Transfer"] = "transfer";
+    StockMovementKind["Reservation"] = "reservation";
+    StockMovementKind["ReservationRelease"] = "reservation_release";
+    StockMovementKind["Production"] = "production";
+    StockMovementKind["Consumption"] = "consumption";
+    StockMovementKind["PutAway"] = "putaway";
+    StockMovementKind["Picking"] = "picking";
+    StockMovementKind["Pack"] = "pack";
+    StockMovementKind["Ship"] = "ship";
+    StockMovementKind["Return"] = "return";
+    StockMovementKind["Adjustment"] = "adjustment";
+    StockMovementKind["QuarantineIn"] = "quarantine_in";
+    StockMovementKind["QuarantineOut"] = "quarantine_out";
+    StockMovementKind["QcIn"] = "qc_in";
+    StockMovementKind["QcOut"] = "qc_out";
+    StockMovementKind["Replenishment"] = "replenishment";
+    StockMovementKind["InventoryCount"] = "inventory_count";
+})(StockMovementKind || (exports.StockMovementKind = StockMovementKind = {}));

package/interfaces/IStockReservation.d.ts

@@ -0,0 +1,35 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Stock Reservation — quantitative reservation of stock for a specific source document.
+ *
+ * Solves the gap that IStock only knows `amount` (no available vs. reserved distinction)
+ * and IAssignment.stock_booked is just a boolean flag.
+ *
+ * Lifecycle: active → fulfilled (when picked) | released (manual cancel) | expired (TTL).
+ */
+export interface IStockReservation extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    product: ObjectId;
+    warehouse: ObjectId;
+    storageArea?: ObjectId;
+    lot?: ObjectId;
+    serialNumbers?: string[];
+    qtyReserved: number;
+    qtyFulfilled?: number;
+    unit?: string;
+    sourceType: "assignment" | "productionOrder" | "internalOrder" | "shipping" | "manual";
+    sourceId: ObjectId;
+    sourcePosition?: number;
+    sourceStep?: number;
+    status: "active" | "released" | "fulfilled" | "expired";
+    reservedAt?: Date;
+    expiresAt?: Date;
+    releasedAt?: Date;
+    fulfilledAt?: Date;
+    priority?: number;
+    pickList?: ObjectId;
+    reservedBy?: ObjectId;
+    note?: string;
+}

package/interfaces/IStockReservation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/index.d.ts

@@ -429,6 +429,7 @@ export * from "./IMarketBudgetByIndustry";
 export * from "./IIndustryKPI";
 export * from "./IMarketResearch";
 export * from "./IMaterial";
+export * from "./IMaterialCommissioning";
 export * from "./IMeeting";
 export * from "./IMeetingGroup";
 export * from "./IEventRegisterView";
@@ -476,6 +477,7 @@ export * from "./IPAT";
 export * from "./IPaymentGroup";
 export * from "./IPaymentProvider";
 export * from "./IPermissionRequest";
+export * from "./IPickList";
 export * from "./IPimSelection";
 export * from "./IPipeline";
 export * from "./IPoints";
@@ -527,6 +529,7 @@ export * from "./IPublication";
 export * from "./IPublicationOptions";
 export * from "./IPublicationRun";
 export * from "./IPublisherAPI";
+export * from "./IPutAwayOrder";
 export * from "./IPushClick";
 export * from "./IPushDelivery";
 export * from "./IPushError";
@@ -609,6 +612,7 @@ export * from "./IState";
 export * from "./IStateLog";
 export * from "./IStock";
 export * from "./IStockLog";
+export * from "./IStockReservation";
 export * from "./IStorageArea";
 export * from "./IStore";
 export * from "./IStoreAsset";

package/interfaces/index.js

@@ -445,6 +445,7 @@ __exportStar(require("./IMarketBudgetByIndustry"), exports);
 __exportStar(require("./IIndustryKPI"), exports);
 __exportStar(require("./IMarketResearch"), exports);
 __exportStar(require("./IMaterial"), exports);
+__exportStar(require("./IMaterialCommissioning"), exports);
 __exportStar(require("./IMeeting"), exports);
 __exportStar(require("./IMeetingGroup"), exports);
 __exportStar(require("./IEventRegisterView"), exports);
@@ -492,6 +493,7 @@ __exportStar(require("./IPAT"), exports);
 __exportStar(require("./IPaymentGroup"), exports);
 __exportStar(require("./IPaymentProvider"), exports);
 __exportStar(require("./IPermissionRequest"), exports);
+__exportStar(require("./IPickList"), exports);
 __exportStar(require("./IPimSelection"), exports);
 __exportStar(require("./IPipeline"), exports);
 __exportStar(require("./IPoints"), exports);
@@ -543,6 +545,7 @@ __exportStar(require("./IPublication"), exports);
 __exportStar(require("./IPublicationOptions"), exports);
 __exportStar(require("./IPublicationRun"), exports);
 __exportStar(require("./IPublisherAPI"), exports);
+__exportStar(require("./IPutAwayOrder"), exports);
 __exportStar(require("./IPushClick"), exports);
 __exportStar(require("./IPushDelivery"), exports);
 __exportStar(require("./IPushError"), exports);
@@ -625,6 +628,7 @@ __exportStar(require("./IState"), exports);
 __exportStar(require("./IStateLog"), exports);
 __exportStar(require("./IStock"), exports);
 __exportStar(require("./IStockLog"), exports);
+__exportStar(require("./IStockReservation"), exports);
 __exportStar(require("./IStorageArea"), exports);
 __exportStar(require("./IStore"), exports);
 __exportStar(require("./IStoreAsset"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-interfaces",
-  "version": "2026.26.0",
+  "version": "2026.27.0",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",