@flowselections/logistiek-engine 1.0.1

package/dist-lib/lib/loadCarrierTaskSync.server.js

@@ -0,0 +1,56 @@
+// ============================================================================
+// src/lib/loadCarrierTaskSync.server.ts
+// ============================================================================
+// Zet het indelingsresultaat in de payload van de openstaande load.compose
+// taken, zodat de Afhandeling-module niets meer zelf hoeft te berekenen.
+// ============================================================================
+import { supabaseAdmin } from "../integrations/supabase/client.server";
+const db = () => supabaseAdmin;
+const OPEN_STATUSES = ["planned", "ready", "in_progress"];
+export async function attachIndelingToTasks(result) {
+    if (!result || result.skipped === "locked")
+        return 0;
+    const carts = Array.isArray(result.carts) ? result.carts : [];
+    if (result.orderIds.length === 0)
+        return 0;
+    const { data: orders } = await db()
+        .from("orders")
+        .select("id, order_number")
+        .in("id", result.orderIds);
+    const refs = (orders ?? []).map((o) => o.order_number).filter(Boolean);
+    if (refs.length === 0)
+        return 0;
+    const { data: tasks } = await db()
+        .from("logistics_tasks")
+        .select("id, payload, order_ref")
+        .eq("task_type", "load.compose")
+        .in("order_ref", refs)
+        .in("status", OPEN_STATUSES);
+    const list = Array.isArray(tasks) ? tasks : [];
+    let updated = 0;
+    for (const task of list) {
+        const payload = { ...(task.payload ?? {}) };
+        payload.indeling = carts.map((c) => ({
+            cart_number: c.cart_number,
+            carrier_type: c.carrier_type,
+            occupancy_pct: c.occupancy_pct,
+            total_layers_used: c.total_layers_used,
+            max_layers: c.max_layers,
+            is_complete: c.is_complete,
+            weight_kg: c.weight_kg,
+            items: c.items.map((i) => ({
+                product_name: i.product_name,
+                product_id: i.product_id,
+                crates: i.crates,
+                plants: i.plants,
+                layer_share_pct: i.layer_share_pct,
+            })),
+        }));
+        payload.indelingWarnings = result.warnings;
+        payload.indelingSource = "logistics-engine";
+        const { error } = await db().from("logistics_tasks").update({ payload }).eq("id", task.id);
+        if (!error)
+            updated++;
+    }
+    return updated;
+}

package/dist-lib/lib/loadCarrierTypes.d.ts

@@ -0,0 +1,19 @@
+import type { CapacityModel, CarrierProfile } from "./loadCarrierPlanner";
+export type LoadCarrierCode = "trolley" | "danish_container" | "euro_rolcontainer" | "pallet" | "euro_pallet" | "loose";
+export interface LoadCarrierTypeRow extends CarrierProfile {
+    id: string;
+    layer_length_cm: number;
+    layer_width_cm: number;
+    max_height_cm: number | null;
+    max_orders: number | null;
+    max_customers: number | null;
+    is_active: boolean;
+    is_default: boolean;
+    sort_order: number;
+}
+export declare const CAPACITY_MODEL_LABELS: Record<CapacityModel, string>;
+export declare const CARRIER_LABELS: Record<string, string>;
+export declare function carrierLabel(code: string, fallback?: string): string;
+/** Fallbackprofiel als een type nog niet in de database staat. */
+export declare function fallbackCarrierProfile(code: string): CarrierProfile;
+//# sourceMappingURL=loadCarrierTypes.d.ts.map

package/dist-lib/lib/loadCarrierTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadCarrierTypes.d.ts","sourceRoot":"","sources":["../../src/lib/loadCarrierTypes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,GACR,aAAa,GACb,OAAO,CAAC;AAEZ,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAK/D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOjD,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmBnE"}

package/dist-lib/lib/loadCarrierTypes.js

@@ -0,0 +1,41 @@
+// ============================================================================
+// src/lib/loadCarrierTypes.ts — gedeelde typen en labels voor ladingdragers
+// ============================================================================
+export const CAPACITY_MODEL_LABELS = {
+    layered: "Lagen (stapelwagen / container)",
+    stacked: "Gestapeld (pallet met dozen)",
+    single: "Enkele eenheid (doos)",
+    none: "Los — geen ladingdrager",
+};
+export const CARRIER_LABELS = {
+    trolley: "Stapelwagen",
+    danish_container: "Deense container",
+    euro_rolcontainer: "Euro-rolcontainer",
+    pallet: "Pallet",
+    euro_pallet: "Euro-pallet",
+    loose: "Geen ladingdrager",
+};
+export function carrierLabel(code, fallback) {
+    return CARRIER_LABELS[code] ?? fallback ?? code;
+}
+/** Fallbackprofiel als een type nog niet in de database staat. */
+export function fallbackCarrierProfile(code) {
+    const layered = { capacity_model: "layered", layers_per_carrier: 5 };
+    const map = {
+        trolley: layered,
+        danish_container: layered,
+        euro_rolcontainer: { capacity_model: "layered", layers_per_carrier: 6 },
+        pallet: { capacity_model: "stacked", layers_per_carrier: 4, max_boxes: 40 },
+        euro_pallet: { capacity_model: "stacked", layers_per_carrier: 4, max_boxes: 32 },
+        loose: { capacity_model: "none", layers_per_carrier: 1, allow_mixing: false },
+    };
+    return {
+        id: null,
+        code,
+        name: carrierLabel(code),
+        capacity_model: "layered",
+        layers_per_carrier: 5,
+        allow_mixing: true,
+        ...(map[code] ?? {}),
+    };
+}

package/dist-lib/lib/logisticsPlanner.d.ts

@@ -0,0 +1,56 @@
+import type { RuleEngineSettings } from "./ruleEngineSchema";
+import { type LogisticsModuleKey, type LogisticsTaskType } from "./logisticsTasks";
+export type LoadCarrierType = "trolley" | "danish_container" | "euro_rolcontainer" | "pallet" | "euro_pallet" | "loose";
+export interface PlannerLoadCarrier {
+    type: LoadCarrierType;
+    count: number;
+}
+export interface PlannerOrder {
+    orderRef: string;
+    /** Aanmeldmoment (ISO). Alles wordt hier vanaf teruggerekend. */
+    checkinAt: string;
+    /** Werkelijk ophaalmoment van de vervoerder (ISO). Valt terug op checkinAt. */
+    pickupAt?: string | null;
+    customerRef?: string | null;
+    deliveryLocationRef?: string | null;
+    bufferRef?: string | null;
+    loadCarriers?: PlannerLoadCarrier[];
+}
+export interface PlannerContext {
+    strategyId?: string | null;
+    ruleConfigId?: string | null;
+    ruleVersion?: number | null;
+    shadow?: boolean;
+}
+export interface PlannedTask {
+    taskType: LogisticsTaskType;
+    ownerModule: LogisticsModuleKey;
+    sequence: number;
+    plannedStart: string | null;
+    plannedEnd: string | null;
+    dueAt: string | null;
+    payload: Record<string, unknown>;
+}
+export interface PlannerResult {
+    tasks: PlannedTask[];
+    /** Berekende tussenwaarden — handig voor het regieoverzicht en voor uitleg. */
+    timeline: {
+        checkinAt: string;
+        pickupAt: string;
+        bufferCloseAt: string | null;
+        pickStartAt: string;
+        pickEndAt: string;
+        pickMinutes: number;
+        reserveMinutes: number;
+        staff: number;
+        controlNoticeAt: string | null;
+    };
+    notes: string[];
+}
+/** Bruto picktijd in minuten voor alle ladingdragers samen, gedeeld door de bezetting. */
+export declare function calculatePickMinutes(carriers: PlannerLoadCarrier[], settings: RuleEngineSettings): {
+    minutes: number;
+    staff: number;
+};
+export declare function planOrder(order: PlannerOrder, settings: RuleEngineSettings, context?: PlannerContext): PlannerResult;
+//# sourceMappingURL=logisticsPlanner.d.ts.map

package/dist-lib/lib/logisticsPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logisticsPlanner.d.ts","sourceRoot":"","sources":["../../src/lib/logisticsPlanner.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAc,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAO/F,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,GACR,aAAa,GACb,OAAO,CAAC;AAEZ,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAgDD,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,EAAE,kBAAkB,GAC3B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASpC;AAMD,wBAAgB,SAAS,CACvB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,cAAmB,GAC3B,aAAa,CAsPf"}

package/dist-lib/lib/logisticsPlanner.js

@@ -0,0 +1,273 @@
+// ============================================================================
+// src/lib/logisticsPlanner.ts — pure planner van de Logistics Engine
+// ============================================================================
+// Zet een order + rule config om in een complete takenlijst voor alle modules.
+// Volledig deterministisch: zelfde input geeft altijd dezelfde taken.
+// Geen database, geen netwerk — daardoor los testbaar.
+// ============================================================================
+import { TASK_OWNER } from "./logisticsTasks";
+import { normalizeBufferCriteria } from "./bufferMatching";
+// ---------------------------------------------------------------------------
+// Hulp
+// ---------------------------------------------------------------------------
+const MIN = 60000;
+function num(value, fallback) {
+    const n = typeof value === "string" ? Number(value) : value;
+    return typeof n === "number" && Number.isFinite(n) ? n : fallback;
+}
+function str(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function bool(value, fallback) {
+    return typeof value === "boolean" ? value : fallback;
+}
+function fields(settings, stepId) {
+    const step = settings?.[stepId];
+    return (step && typeof step === "object" && step.fields) || {};
+}
+function shift(iso, minutes) {
+    return new Date(new Date(iso).getTime() + minutes * MIN).toISOString();
+}
+const PICK_TIME_KEY = {
+    trolley: "pick_time_trolley",
+    danish_container: "pick_time_danish_container",
+    euro_rolcontainer: "pick_time_euro_rolcontainer",
+    pallet: "pick_time_pallet",
+    euro_pallet: "pick_time_euro_pallet",
+    loose: "pick_time_loose",
+};
+const PICK_TIME_DEFAULT = {
+    trolley: 15,
+    danish_container: 15,
+    euro_rolcontainer: 12,
+    pallet: 20,
+    euro_pallet: 3,
+    loose: 5,
+};
+/** Bruto picktijd in minuten voor alle ladingdragers samen, gedeeld door de bezetting. */
+export function calculatePickMinutes(carriers, settings) {
+    const station = fields(settings, "pickstations");
+    const staff = Math.max(1, Math.round(num(station.avg_staff, 5)));
+    let total = 0;
+    for (const carrier of carriers) {
+        const perCarrier = num(station[PICK_TIME_KEY[carrier.type]], PICK_TIME_DEFAULT[carrier.type] ?? 10);
+        total += perCarrier * Math.max(0, num(carrier.count, 0));
+    }
+    return { minutes: Math.ceil(total / staff), staff };
+}
+// ---------------------------------------------------------------------------
+// Planner
+// ---------------------------------------------------------------------------
+export function planOrder(order, settings, context = {}) {
+    const notes = [];
+    const carriers = Array.isArray(order.loadCarriers) ? order.loadCarriers : [];
+    const checkinAt = new Date(order.checkinAt).toISOString();
+    const pickupAt = order.pickupAt ? new Date(order.pickupAt).toISOString() : checkinAt;
+    const orderStep = fields(settings, "order_verwerking");
+    const pickStep = fields(settings, "order_picken");
+    const controleStep = fields(settings, "controle");
+    // --- 1. Orderbuffer ------------------------------------------------------
+    const bufferEnabled = bool(orderStep.buffer_enabled, true);
+    const bufferCloseAt = bufferEnabled
+        ? shift(checkinAt, -num(orderStep.buffer_close_before_minutes, 60))
+        : null;
+    const bufferRelease = str(orderStep.buffer_release, "auto");
+    if (bufferRelease === "none") {
+        notes.push("De buffer geeft niets automatisch vrij; iemand moet de order handmatig oppakken.");
+    }
+    // --- 2. Picktijd ---------------------------------------------------------
+    const { minutes: pickMinutes, staff } = calculatePickMinutes(carriers, settings);
+    if (carriers.length === 0) {
+        notes.push("Geen ladingdragers meegegeven; picktijd is 0 minuten.");
+    }
+    // --- 3. Reservetijd ------------------------------------------------------
+    const pickStartMode = str(pickStep.pick_start_mode, "as_late_as_possible");
+    let reserveMinutes = 0;
+    if (pickStartMode === "as_late_as_possible") {
+        reserveMinutes =
+            str(pickStep.pick_reserve_type, "fixed") === "percentage"
+                ? Math.ceil((pickMinutes * num(pickStep.pick_reserve_percentage, 20)) / 100)
+                : num(pickStep.pick_reserve_minutes, 30);
+    }
+    // --- 4. Pickvenster ------------------------------------------------------
+    let pickEndAt;
+    let pickStartAt;
+    if (pickStartMode === "window_before_checkin") {
+        const unit = str(pickStep.pick_window_unit, "hours");
+        const lead = unit === "days" ? num(pickStep.pick_window_days, 1) * 24 * 60 : num(pickStep.pick_window_hours, 4) * 60;
+        pickStartAt = shift(checkinAt, -lead);
+        pickEndAt = checkinAt;
+    }
+    else {
+        pickEndAt = shift(pickupAt, -reserveMinutes);
+        pickStartAt = shift(pickEndAt, -pickMinutes);
+    }
+    if (bufferCloseAt && new Date(bufferCloseAt) > new Date(pickStartAt)) {
+        notes.push("De buffer sluit later dan het picken zou moeten beginnen; controleer de buffertijd.");
+    }
+    // --- 5. Taken opbouwen ---------------------------------------------------
+    const tasks = [];
+    let seq = 0;
+    const base = {
+        orderRef: order.orderRef,
+        customerRef: order.customerRef ?? null,
+        checkinAt,
+        pickupAt,
+    };
+    const add = (taskType, plannedStart, plannedEnd, payload = {}) => {
+        tasks.push({
+            taskType,
+            ownerModule: TASK_OWNER[taskType],
+            sequence: seq++,
+            plannedStart,
+            plannedEnd,
+            dueAt: plannedEnd ?? plannedStart,
+            payload: { ...base, ...payload },
+        });
+    };
+    if (bufferEnabled && bufferCloseAt) {
+        add("buffer.close", bufferCloseAt, bufferCloseAt, {
+            bufferRef: order.bufferRef ?? null,
+            release: bufferRelease,
+            matchCriteria: normalizeBufferCriteria(orderStep.buffer_match),
+        });
+    }
+    add("stock.reserve", bufferCloseAt ?? pickStartAt, bufferCloseAt ?? pickStartAt, {
+        loadCarriers: carriers,
+    });
+    add("load.compose", shift(pickStartAt, -10), pickStartAt, {
+        loadCarriers: carriers,
+        fillMode: "generated",
+    });
+    add("pick.execute", pickStartAt, pickEndAt, {
+        pickMode: str(pickStep.pick_mode, "cart"),
+        pickStartMode,
+        pickMinutes,
+        staff,
+        reserveMinutes,
+        scanner: str(pickStep.scanner, "required"),
+        loadCarriers: carriers,
+    });
+    if (str(pickStep.scanner, "required") === "required") {
+        add("scan.verify", pickStartAt, pickEndAt, { reason: "pick_scanner_required" });
+    }
+    // --- 6. Controle ---------------------------------------------------------
+    const controlMode = str(controleStep.control_mode, "scanner");
+    const controlNoticeAt = controlMode === "skip" ? null : shift(pickupAt, -num(controleStep.control_notice_minutes, 60));
+    if (controlNoticeAt) {
+        const controlOwner = controlMode === "scanner" ? "scanners" : "afhandeling";
+        tasks.push({
+            taskType: "control.execute",
+            ownerModule: controlOwner,
+            sequence: seq++,
+            plannedStart: controlNoticeAt,
+            plannedEnd: pickupAt,
+            dueAt: pickupAt,
+            payload: { ...base, controlMode, noticeAt: controlNoticeAt },
+        });
+        if (controlMode === "paper") {
+            const printItems = str(controleStep.control_print_items, "control_note");
+            add("print.control_note", controlNoticeAt, controlNoticeAt, { printItems });
+        }
+    }
+    else {
+        notes.push("Controle staat uit; er wordt geen controletaak aangemaakt.");
+    }
+    // --- 7. Verzendbrief -----------------------------------------------------
+    const shippingChoice = str(controleStep.control_print_items, "control_note") === "control_note_and_shipping" && controlMode === "paper"
+        ? "with_control"
+        : "with_packing_slip";
+    const shippingAt = shippingChoice === "with_control" ? (controlNoticeAt ?? pickEndAt) : pickStartAt;
+    // --- 7b. Documenten (Rule Engine stap "Documenten") ----------------------
+    const docStep = fields(settings, "pickstations");
+    const HOUR = 60;
+    const docRelease = (mode, hours) => {
+        if (mode === "hours_before_pick")
+            return shift(pickStartAt, -hours * HOUR);
+        return pickStartAt;
+    };
+    const packingRelease = str(docStep.packing_slip_release, "with_pick_release");
+    const packingAt = docRelease(packingRelease, num(docStep.packing_slip_hours_before, 2));
+    const pickMode = str(pickStep.pick_mode, "cart");
+    const groupIdenticalCarts = pickMode === "cart" && bool(docStep.packing_slip_group_identical_carts, true);
+    add("print.packing_slip", packingAt, packingAt, {
+        documentType: "pakbon",
+        release: packingRelease,
+        pickStationId: str(docStep.packing_slip_station, "") || null,
+        requiresApproval: false,
+        pickMode,
+        groupIdenticalCarts,
+        cartsPerPrint: groupIdenticalCarts ? Math.max(1, num(docStep.packing_slip_carts_per_print, 1)) : null,
+        splitIdenticalGroups: false,
+    });
+    const stickerRelease = str(docStep.sticker_release, "with_pick_release");
+    const stickerAt = docRelease(stickerRelease, num(docStep.sticker_hours_before, 2));
+    add("print.sticker", stickerAt, stickerAt, {
+        documentType: "sticker",
+        release: stickerRelease,
+        pickStationId: str(docStep.sticker_station, "") || null,
+        requiresApproval: false,
+    });
+    const shippingRelease = str(docStep.shipping_note_release, "after_checkin");
+    let shippingReleaseAt;
+    switch (shippingRelease) {
+        case "with_packing_slip":
+            shippingReleaseAt = packingAt;
+            break;
+        case "after_scan":
+            shippingReleaseAt = pickEndAt;
+            break;
+        case "manual_approval":
+            shippingReleaseAt = checkinAt;
+            break;
+        case "after_checkin":
+        default:
+            shippingReleaseAt = checkinAt;
+    }
+    add("print.shipping_note", shippingReleaseAt, shippingReleaseAt, {
+        documentType: "verzendbrief",
+        moment: shippingChoice,
+        release: shippingRelease,
+        pickStationId: str(docStep.shipping_note_station, "") || null,
+        requiresApproval: shippingRelease === "manual_approval",
+        printedAt: shippingAt,
+    });
+    const productionRelease = str(docStep.production_note_release, "on_stock_upgrade");
+    add("print.production_note", null, null, {
+        documentType: "productiebon",
+        release: productionRelease,
+        trigger: "stock.upgraded",
+        pickStationId: str(docStep.production_note_station, "") || null,
+        requiresApproval: productionRelease === "manual_approval_after_upgrade",
+    });
+    if (shippingRelease === "manual_approval") {
+        notes.push("De verzendbrief wacht op handmatige goedkeuring op een pickstation.");
+    }
+    if (productionRelease === "manual_approval_after_upgrade") {
+        notes.push("De productiebon wacht na opwaardering op handmatige goedkeuring.");
+    }
+    // --- 8. Transport --------------------------------------------------------
+    add("transport.dispatch", pickupAt, pickupAt, {});
+    // Shadow-vlag meegeven op elke taak-payload voor de ontvangende module.
+    const shadow = context.shadow ?? true;
+    for (const task of tasks) {
+        task.payload.shadow = shadow;
+        task.payload.strategyId = context.strategyId ?? null;
+        task.payload.ruleVersion = context.ruleVersion ?? null;
+    }
+    return {
+        tasks,
+        timeline: {
+            checkinAt,
+            pickupAt,
+            bufferCloseAt,
+            pickStartAt,
+            pickEndAt,
+            pickMinutes,
+            reserveMinutes,
+            staff,
+            controlNoticeAt,
+        },
+        notes,
+    };
+}