@tolinax/ayoune-interfaces 2026.28.0 → 2026.29.0

package/data/modelNames.d.ts

@@ -253,6 +253,8 @@ export declare enum aMN {
     DevOpsAlerts = "DevOpsAlerts",
     DiscountGroups = "DiscountGroups",
     DMCampaigns = "DMCampaigns",
+    DockAppointments = "DockAppointments",
+    Docks = "Docks",
     Documents = "Documents",
     DoiLogs = "DoiLogs",
     Dois = "Dois",
@@ -352,6 +354,7 @@ export declare enum aMN {
     InternalChatMessages = "InternalChatMessages",
     InternalForms = "InternalForms",
     InternalOrders = "InternalOrders",
+    InventoryAdjustments = "InventoryAdjustments",
     InventoryLists = "InventoryLists",
     Invoices = "Invoices",
     IoTDevices = "IoTDevices",
@@ -453,6 +456,7 @@ export declare enum aMN {
     PaymentProviders = "PaymentProviders",
     PermissionRequests = "PermissionRequests",
     PickLists = "PickLists",
+    PickWaves = "PickWaves",
     PimSelections = "PimSelections",
     Pipelines = "Pipelines",
     Polls = "Polls",
@@ -611,6 +615,7 @@ export declare enum aMN {
     Tips = "Tips",
     Trades = "Trades",
     Transactions = "Transactions",
+    TransportOrders = "TransportOrders",
     Travels = "Travels",
     TriggerActionsLogs = "TriggerActionsLogs",
     TriggerChains = "TriggerChains",

package/data/modelNames.js

@@ -257,6 +257,8 @@ var aMN;
     aMN["DevOpsAlerts"] = "DevOpsAlerts";
     aMN["DiscountGroups"] = "DiscountGroups";
     aMN["DMCampaigns"] = "DMCampaigns";
+    aMN["DockAppointments"] = "DockAppointments";
+    aMN["Docks"] = "Docks";
     aMN["Documents"] = "Documents";
     aMN["DoiLogs"] = "DoiLogs";
     aMN["Dois"] = "Dois";
@@ -356,6 +358,7 @@ var aMN;
     aMN["InternalChatMessages"] = "InternalChatMessages";
     aMN["InternalForms"] = "InternalForms";
     aMN["InternalOrders"] = "InternalOrders";
+    aMN["InventoryAdjustments"] = "InventoryAdjustments";
     aMN["InventoryLists"] = "InventoryLists";
     aMN["Invoices"] = "Invoices";
     aMN["IoTDevices"] = "IoTDevices";
@@ -457,6 +460,7 @@ var aMN;
     aMN["PaymentProviders"] = "PaymentProviders";
     aMN["PermissionRequests"] = "PermissionRequests";
     aMN["PickLists"] = "PickLists";
+    aMN["PickWaves"] = "PickWaves";
     aMN["PimSelections"] = "PimSelections";
     aMN["Pipelines"] = "Pipelines";
     aMN["Polls"] = "Polls";
@@ -615,6 +619,7 @@ var aMN;
     aMN["Tips"] = "Tips";
     aMN["Trades"] = "Trades";
     aMN["Transactions"] = "Transactions";
+    aMN["TransportOrders"] = "TransportOrders";
     aMN["Travels"] = "Travels";
     aMN["TriggerActionsLogs"] = "TriggerActionsLogs";
     aMN["TriggerChains"] = "TriggerChains";

package/data/modelsAndRights.js

@@ -2839,6 +2839,26 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "DockAppointments",
+        singular: "DockAppointment",
+        module: "warehouse",
+        right: "warehouse.dockappointments",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
+    {
+        plural: "Docks",
+        singular: "Dock",
+        module: "warehouse",
+        right: "warehouse.docks",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Documents",
         singular: "Document",
@@ -3749,6 +3769,16 @@ const modelsAndRights = [
         allowDuplicate: true,
         updateBy: "_id",
     },
+    {
+        plural: "InventoryAdjustments",
+        singular: "InventoryAdjustment",
+        module: "warehouse",
+        right: "warehouse.inventoryadjustments",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "InventoryLists",
         singular: "InventoryList",
@@ -4733,6 +4763,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PickWaves",
+        singular: "PickWave",
+        module: "warehouse",
+        right: "warehouse.pickwaves",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PimSelections",
         singular: "PimSelection",
@@ -6203,6 +6243,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "TransportOrders",
+        singular: "TransportOrder",
+        module: "warehouse",
+        right: "warehouse.transportorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Travels",
         singular: "Travel",

package/interfaces/IDock.d.ts

@@ -0,0 +1,37 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Dock — physical loading/unloading bay at a warehouse.
+ *
+ * Used for receiving (inbound) and shipping (outbound) operations.
+ * Can be scheduled via IDockAppointment.
+ *
+ * Solves the gap that there is no formal dock management — currently trucks
+ * just arrive and warehouse workers improvise.
+ */
+export interface IDock extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    warehouse: ObjectId;
+    name: string;
+    code?: string;
+    type: "inbound" | "outbound" | "both";
+    status: "available" | "occupied" | "maintenance" | "blocked";
+    maxWeight?: number;
+    maxLength?: number;
+    maxHeight?: number;
+    maxWidth?: number;
+    hasLeveler?: boolean;
+    hasCanopy?: boolean;
+    hasRefrigeration?: boolean;
+    hasLiveLoad?: boolean;
+    currentAppointment?: ObjectId;
+    currentVehicle?: string;
+    occupiedSince?: Date;
+    coordinates?: {
+        x?: number;
+        y?: number;
+    };
+    note?: string;
+    active?: boolean;
+}

package/interfaces/IDock.js

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

package/interfaces/IDockAppointment.d.ts

@@ -0,0 +1,41 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Dock Appointment — scheduled time slot at a dock for a delivery or pickup.
+ *
+ * Drivers/carriers book a slot in advance; warehouse staff prepare goods
+ * accordingly. Reduces yard congestion and idle truck time.
+ *
+ * Lifecycle: scheduled → confirmed → arrived → loading → completed | no_show | cancelled
+ */
+export interface IDockAppointment extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    dock: ObjectId;
+    warehouse: ObjectId;
+    type: "receiving" | "shipping";
+    status: "scheduled" | "confirmed" | "arrived" | "loading" | "completed" | "no_show" | "cancelled";
+    scheduledStart: Date;
+    scheduledEnd: Date;
+    actualArrival?: Date;
+    actualStart?: Date;
+    actualEnd?: Date;
+    goodsReceipt?: ObjectId;
+    supplierOrder?: ObjectId;
+    shipping?: ObjectId;
+    transportOrder?: ObjectId;
+    carrier?: string;
+    driverName?: string;
+    driverPhone?: string;
+    vehicleLicense?: string;
+    vehicleType?: string;
+    trailerLicense?: string;
+    expectedWeight?: number;
+    expectedVolume?: number;
+    expectedPallets?: number;
+    assignedTo?: ObjectId;
+    notifiedAt?: Date;
+    confirmedAt?: Date;
+    note?: string;
+}

package/interfaces/IDockAppointment.js

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

package/interfaces/IInventoryAdjustment.d.ts

@@ -0,0 +1,54 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Inventory Adjustment — standalone correction entity with reason and approval workflow.
+ *
+ * Solves the gap that stock corrections currently happen via free-form
+ * IStockLog `kindofmovement` strings without structured reasons, audit trail,
+ * or approval requirements.
+ *
+ * Reason types:
+ * - shrinkage: theft / loss / unexplained shortage
+ * - damage: physically damaged, unsellable
+ * - found: surplus discovered during cycle count
+ * - correction: data entry error
+ * - obsolescence: expired / discontinued
+ * - sample: removed for QC sampling
+ * - donation: gifted out
+ * - return_to_supplier: defective batch sent back
+ * - cycle_count: result of cycle count variance
+ */
+export interface IInventoryAdjustment extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    warehouse: ObjectId;
+    storageArea?: ObjectId;
+    lot?: ObjectId;
+    serialNumbers?: string[];
+    qtyBefore: number;
+    qtyAfter: number;
+    qtyDelta: number;
+    unit?: string;
+    reason: "shrinkage" | "damage" | "found" | "correction" | "obsolescence" | "sample" | "donation" | "return_to_supplier" | "cycle_count" | "other";
+    reasonDescription?: string;
+    cycleCount?: ObjectId;
+    status: "draft" | "pending_approval" | "approved" | "applied" | "rejected" | "cancelled";
+    requiresApproval?: boolean;
+    submittedBy?: ObjectId;
+    submittedAt?: Date;
+    approvedBy?: ObjectId;
+    approvedAt?: Date;
+    rejectedBy?: ObjectId;
+    rejectedAt?: Date;
+    rejectedReason?: string;
+    appliedAt?: Date;
+    stockLogRef?: ObjectId;
+    valueImpact?: number;
+    costCenter?: ObjectId;
+    accountingNbr?: string;
+    note?: string;
+}

package/interfaces/IInventoryAdjustment.js

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

package/interfaces/IPickWave.d.ts

@@ -0,0 +1,40 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Pick Wave — bundles multiple PickLists for efficient batch picking.
+ *
+ * Solves the gap that pickers currently process one PickList at a time —
+ * inefficient for warehouses with many small orders. A wave groups orders
+ * by zone / route / shipping cutoff so the picker walks the warehouse once.
+ *
+ * Lifecycle: planned → released (pickers can start) → in_progress → completed | cancelled
+ *
+ * Wave Strategies:
+ * - by_zone: group by warehouse zone (StorageArea cluster)
+ * - by_carrier: group by shipping carrier cutoff time
+ * - by_priority: group by deadline / priority score
+ * - by_product: group by same product (batch picking)
+ */
+export interface IPickWave extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    name?: string;
+    status: "planned" | "released" | "in_progress" | "completed" | "cancelled";
+    warehouse: ObjectId;
+    strategy?: "by_zone" | "by_carrier" | "by_priority" | "by_product" | "manual";
+    pickLists: ObjectId[];
+    assignedTo?: ObjectId[];
+    totalLines?: number;
+    pickedLines?: number;
+    progress?: number;
+    totalOrders?: number;
+    plannedStart?: Date;
+    plannedEnd?: Date;
+    releasedAt?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    estimatedDuration?: number;
+    walkingDistance?: number;
+    note?: string;
+}

package/interfaces/IPickWave.js

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

package/interfaces/ITransportOrder.d.ts

@@ -0,0 +1,60 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Transport Order — staging entity that bundles one or more shipments
+ * for a single carrier pickup.
+ *
+ * Solves the gap that IShipping goes directly to a carrier with no
+ * intermediate stop for route optimization, multi-stop tours, or
+ * carrier handoff documentation (Bill of Lading equivalent).
+ *
+ * Lifecycle: planned → confirmed → ready → in_transit → delivered | cancelled
+ */
+export interface ITransportOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    referenceNumber?: string;
+    bolNumber?: string;
+    status: "planned" | "confirmed" | "ready" | "in_transit" | "delivered" | "cancelled";
+    shippings: ObjectId[];
+    carrier?: string;
+    carrierAccount?: string;
+    serviceLevel?: string;
+    plannedPickup?: Date;
+    actualPickup?: Date;
+    plannedDelivery?: Date;
+    estimatedDelivery?: Date;
+    actualDelivery?: Date;
+    tourNumber?: string;
+    stopSequence?: number;
+    totalStops?: number;
+    pickupDock?: ObjectId;
+    pickupAppointment?: ObjectId;
+    deliveryAddress?: {
+        company?: string;
+        street?: string;
+        zip?: string;
+        city?: string;
+        country?: string;
+    };
+    driverName?: string;
+    driverPhone?: string;
+    vehicleLicense?: string;
+    trailerLicense?: string;
+    totalWeight?: number;
+    totalVolume?: number;
+    totalPackages?: number;
+    totalPallets?: number;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    bolUrl?: string;
+    cmrUrl?: string;
+    sealNumbers?: string[];
+    transportCost?: number;
+    fuelSurcharge?: number;
+    accessoryCharges?: number;
+    totalCost?: number;
+    currency?: string;
+    note?: string;
+}

package/interfaces/ITransportOrder.js

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

package/interfaces/index.d.ts

@@ -270,6 +270,8 @@ export * from "./IDesktopClient";
 export * from "./IDesktopNotification";
 export * from "./IDiscountGroup";
 export * from "./IDMCampaign";
+export * from "./IDock";
+export * from "./IDockAppointment";
 export * from "./IDocument";
 export * from "./IDoi";
 export * from "./IDoiLog";
@@ -373,6 +375,7 @@ export * from "./IIntermediary";
 export * from "./IInternalChatMessage";
 export * from "./IInternalForm";
 export * from "./IInternalOrder";
+export * from "./IInventoryAdjustment";
 export * from "./IInventoryList";
 export * from "./IInvoice";
 export * from "./IIoTDevice";
@@ -480,6 +483,7 @@ export * from "./IPaymentGroup";
 export * from "./IPaymentProvider";
 export * from "./IPermissionRequest";
 export * from "./IPickList";
+export * from "./IPickWave";
 export * from "./IPimSelection";
 export * from "./IPipeline";
 export * from "./IPoints";
@@ -650,6 +654,7 @@ export * from "./ITip";
 export * from "./ITitle";
 export * from "./ITrade";
 export * from "./ITransaction";
+export * from "./ITransportOrder";
 export * from "./ITravel";
 export * from "./ITrigger";
 export * from "./ITriggerAction";

package/interfaces/index.js

@@ -286,6 +286,8 @@ __exportStar(require("./IDesktopClient"), exports);
 __exportStar(require("./IDesktopNotification"), exports);
 __exportStar(require("./IDiscountGroup"), exports);
 __exportStar(require("./IDMCampaign"), exports);
+__exportStar(require("./IDock"), exports);
+__exportStar(require("./IDockAppointment"), exports);
 __exportStar(require("./IDocument"), exports);
 __exportStar(require("./IDoi"), exports);
 __exportStar(require("./IDoiLog"), exports);
@@ -389,6 +391,7 @@ __exportStar(require("./IIntermediary"), exports);
 __exportStar(require("./IInternalChatMessage"), exports);
 __exportStar(require("./IInternalForm"), exports);
 __exportStar(require("./IInternalOrder"), exports);
+__exportStar(require("./IInventoryAdjustment"), exports);
 __exportStar(require("./IInventoryList"), exports);
 __exportStar(require("./IInvoice"), exports);
 __exportStar(require("./IIoTDevice"), exports);
@@ -496,6 +499,7 @@ __exportStar(require("./IPaymentGroup"), exports);
 __exportStar(require("./IPaymentProvider"), exports);
 __exportStar(require("./IPermissionRequest"), exports);
 __exportStar(require("./IPickList"), exports);
+__exportStar(require("./IPickWave"), exports);
 __exportStar(require("./IPimSelection"), exports);
 __exportStar(require("./IPipeline"), exports);
 __exportStar(require("./IPoints"), exports);
@@ -666,6 +670,7 @@ __exportStar(require("./ITip"), exports);
 __exportStar(require("./ITitle"), exports);
 __exportStar(require("./ITrade"), exports);
 __exportStar(require("./ITransaction"), exports);
+__exportStar(require("./ITransportOrder"), exports);
 __exportStar(require("./ITravel"), exports);
 __exportStar(require("./ITrigger"), exports);
 __exportStar(require("./ITriggerAction"), exports);

package/package.json

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