@flowselections/logistiek-engine 1.0.33 → 1.0.53

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

@@ -0,0 +1,61 @@
+import type { TraceEventRow } from "../hooks/useLogisticsTrace";
+export type NodeStatus = "geslaagd" | "wachtend" | "waarschuwing" | "overgeslagen" | "mislukt";
+export interface NodeTraceGroep {
+    nodeId: string;
+    events: TraceEventRow[];
+    aantal: number;
+    eerste: string | null;
+    laatste: string | null;
+    duurMs: number | null;
+    status: NodeStatus;
+    pogingen: number;
+    reden: string | null;
+    errorClass: string | null;
+    volgendeStap: string | null;
+}
+/** Terugval voor oude gebeurtenissen zonder vastgelegd vakje. */
+export declare function gokNode(e: TraceEventRow): string | null;
+/** Groepeert de gebeurtenissen van één order per vakje van de flowkaart. */
+export declare function groepeerPerNode(events: TraceEventRow[] | null | undefined): Map<string, NodeTraceGroep>;
+/** De vakjes op volgorde van de eerste gebeurtenis: de reis van de order. */
+export declare function reisVolgorde(groepen: Map<string, NodeTraceGroep>): NodeTraceGroep[];
+export interface VakSamenvatting {
+    beslissing: string | null;
+    reden: string | null;
+    regel: string | null;
+    berekening: {
+        setting?: string;
+        formula?: string;
+        result?: string;
+        conclusion?: string;
+        values?: Record<string, unknown>;
+    } | null;
+    volgendeStap: string | null;
+    fout: string | null;
+    errorClass: string | null;
+    pogingen: number;
+    volgendePoging: string | null;
+    aantalBeslissingen: number;
+    aantalAutomatisch: number;
+}
+/** Is dit een automatische database-regel (trigger) in plaats van een engine-beslissing? */
+export declare function isAutomatisch(e: TraceEventRow): boolean;
+/** Korte samenvatting van wat de Engine in dit vakje besliste. */
+export declare function samenvatVak(groep: NodeTraceGroep): VakSamenvatting;
+export interface Gebundeld {
+    key: string;
+    /** Eén losse engine-gebeurtenis, of null bij een bundel. */
+    event: TraceEventRow | null;
+    /** Bij een bundel: alle gelijksoortige automatische regels. */
+    events: TraceEventRow[];
+    aantal: number;
+    laatste: string | null;
+    label: string;
+}
+/**
+ * Engine-gebeurtenissen blijven los; automatische database-regels worden
+ * per soort (stap + tabel + actie) samengevoegd tot één regel met telling.
+ * Nieuwste eerst.
+ */
+export declare function bundelGebeurtenissen(events: TraceEventRow[] | null | undefined): Gebundeld[];
+//# sourceMappingURL=nodeTrace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodeTrace.d.ts","sourceRoot":"","sources":["../../src/lib/nodeTrace.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,CAAC;AAE/F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAUD,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAwBvD;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAgDvG;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,cAAc,EAAE,CAMnF;AAMD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GAAG,IAAI,CAAC;IACT,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAEvD;AAQD,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CA8BlE;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EAAE,CAuC5F"}

package/dist-lib/lib/nodeTrace.js

@@ -0,0 +1,191 @@
+// ============================================================================
+// src/lib/nodeTrace.ts — gebeurtenissen van een order per vakje van de flowkaart
+// ============================================================================
+// De Engine legt bij nieuwe gebeurtenissen het vakje (node_id) vast. Oudere
+// gebeurtenissen missen dat; die plaatsen we met een terugval op stap/fase.
+// Alleen lezen: hier wordt niets bepaald, alleen gegroepeerd.
+// ============================================================================
+import { FLOW_NODE } from "./flowNodes";
+const ERNST = {
+    geslaagd: 0,
+    overgeslagen: 0,
+    waarschuwing: 1,
+    wachtend: 2,
+    mislukt: 3,
+};
+/** Terugval voor oude gebeurtenissen zonder vastgelegd vakje. */
+export function gokNode(e) {
+    if (e.nodeId)
+        return e.nodeId;
+    // Automatische registraties: eerst op tabel en actie, dan pas op tekst.
+    const tabel = (e.dbTable ?? "").toLowerCase();
+    if (tabel) {
+        if (tabel === "logistics_plan_queue") {
+            return (e.dbAction ?? "").toUpperCase() === "INSERT" ? FLOW_NODE.ontvangst : FLOW_NODE.indeling;
+        }
+        if (/control|scan/.test(tabel))
+            return FLOW_NODE.controle;
+        if (/print|slip|shipping_note|document/.test(tabel))
+            return FLOW_NODE.stations;
+        if (/pick|cart/.test(tabel))
+            return FLOW_NODE.picken;
+        if (/order/.test(tabel))
+            return FLOW_NODE.ontvangst;
+    }
+    const t = `${e.phase ?? ""} ${e.step ?? ""}`.toLowerCase();
+    if (/binnengekomen|ontvangst|nieuwe order|combineren|buffer/.test(t))
+        return FLOW_NODE.ontvangst;
+    if (/indeling|plan|kar|belading/.test(t))
+        return FLOW_NODE.indeling;
+    if (/pick(?!station)/.test(t))
+        return FLOW_NODE.picken;
+    if (/vrijgave|aanmeld|drukte|vertraging|wacht/.test(t))
+        return FLOW_NODE.vrijgave;
+    if (/pakbon|print|verzendbrief|document|station|floriday/.test(t))
+        return FLOW_NODE.stations;
+    if (/controle|scan|afmeld/.test(t))
+        return FLOW_NODE.controle;
+    if (/afgehandeld|gereed|klaar/.test(t))
+        return FLOW_NODE.eind;
+    return null;
+}
+/** Groepeert de gebeurtenissen van één order per vakje van de flowkaart. */
+export function groepeerPerNode(events) {
+    const veilig = Array.isArray(events) ? events : [];
+    const map = new Map();
+    for (const e of veilig) {
+        const id = gokNode(e);
+        if (!id)
+            continue;
+        const bestaand = map.get(id);
+        if (bestaand) {
+            bestaand.events.push(e);
+        }
+        else {
+            map.set(id, {
+                nodeId: id,
+                events: [e],
+                aantal: 0,
+                eerste: null,
+                laatste: null,
+                duurMs: null,
+                status: "geslaagd",
+                pogingen: 0,
+                reden: null,
+                errorClass: null,
+                volgendeStap: null,
+            });
+        }
+    }
+    for (const groep of map.values()) {
+        groep.events.sort((a, b) => (a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : 0));
+        const laatsteEvent = groep.events[groep.events.length - 1];
+        groep.aantal = groep.events.length;
+        groep.eerste = groep.events[0]?.createdAt ?? null;
+        groep.laatste = laatsteEvent?.createdAt ?? null;
+        const totaal = groep.events.reduce((som, e) => som + (e.durationMs ?? 0), 0);
+        groep.duurMs = totaal > 0 ? totaal : null;
+        groep.pogingen = groep.events.reduce((m, e) => Math.max(m, e.attempts ?? 0), 0);
+        groep.volgendeStap = laatsteEvent?.nextStep ?? null;
+        let ergste = groep.events[0];
+        for (const e of groep.events) {
+            if ((ERNST[e.status] ?? 0) >= (ERNST[ergste?.status ?? "geslaagd"] ?? 0))
+                ergste = e;
+        }
+        groep.status = ergste?.status ?? "geslaagd";
+        groep.reden = ergste?.reason ?? ergste?.error ?? ergste?.decision ?? laatsteEvent?.reason ?? null;
+        groep.errorClass = ergste?.errorClass ?? null;
+    }
+    return map;
+}
+/** De vakjes op volgorde van de eerste gebeurtenis: de reis van de order. */
+export function reisVolgorde(groepen) {
+    return [...groepen.values()].sort((a, b) => {
+        const ta = a.eerste ?? "";
+        const tb = b.eerste ?? "";
+        return ta < tb ? -1 : ta > tb ? 1 : 0;
+    });
+}
+/** Is dit een automatische database-regel (trigger) in plaats van een engine-beslissing? */
+export function isAutomatisch(e) {
+    return (e.phase ?? "").toLowerCase() === "database";
+}
+function calcVan(e) {
+    const c = e.calc;
+    if (!c || typeof c !== "object")
+        return null;
+    return c;
+}
+/** Korte samenvatting van wat de Engine in dit vakje besliste. */
+export function samenvatVak(groep) {
+    const events = Array.isArray(groep.events) ? groep.events : [];
+    const engine = events.filter((e) => !isAutomatisch(e));
+    const relevant = engine.length > 0 ? engine : events;
+    const laatsteMet = (kies) => {
+        for (let i = relevant.length - 1; i >= 0; i--) {
+            const ev = relevant[i];
+            if (!ev)
+                continue;
+            const v = kies(ev);
+            if (v !== null && v !== undefined && v !== "")
+                return v;
+        }
+        return null;
+    };
+    const foutEvent = [...relevant].reverse().find((e) => e.status === "mislukt") ?? null;
+    return {
+        beslissing: laatsteMet((e) => e.decision),
+        reden: laatsteMet((e) => e.reason) ?? groep.reden,
+        regel: laatsteMet((e) => e.rule),
+        berekening: laatsteMet((e) => calcVan(e)),
+        volgendeStap: laatsteMet((e) => e.nextStep) ?? groep.volgendeStap,
+        fout: foutEvent?.error ?? null,
+        errorClass: foutEvent?.errorClass ?? groep.errorClass,
+        pogingen: groep.pogingen,
+        volgendePoging: laatsteMet((e) => e.nextAttemptAt),
+        aantalBeslissingen: engine.length,
+        aantalAutomatisch: events.length - engine.length,
+    };
+}
+/**
+ * Engine-gebeurtenissen blijven los; automatische database-regels worden
+ * per soort (stap + tabel + actie) samengevoegd tot één regel met telling.
+ * Nieuwste eerst.
+ */
+export function bundelGebeurtenissen(events) {
+    const veilig = Array.isArray(events) ? [...events] : [];
+    veilig.sort((a, b) => (a.createdAt < b.createdAt ? 1 : a.createdAt > b.createdAt ? -1 : 0));
+    const uit = [];
+    const index = new Map();
+    for (const e of veilig) {
+        if (!isAutomatisch(e)) {
+            uit.push({
+                key: e.id,
+                event: e,
+                events: [e],
+                aantal: 1,
+                laatste: e.createdAt,
+                label: e.step,
+            });
+            continue;
+        }
+        const key = `auto:${e.step}|${e.dbTable ?? ""}|${e.dbAction ?? ""}`;
+        const bestaand = index.get(key);
+        if (bestaand) {
+            bestaand.events.push(e);
+            bestaand.aantal += 1;
+            continue;
+        }
+        const bundel = {
+            key,
+            event: null,
+            events: [e],
+            aantal: 1,
+            laatste: e.createdAt,
+            label: e.step,
+        };
+        index.set(key, bundel);
+        uit.push(bundel);
+    }
+    return uit;
+}

package/dist-lib/lib/pickQueueCleanup.server.d.ts

@@ -0,0 +1,14 @@
+import type { SupabaseClient } from "@supabase/supabase-js";
+export interface PickQueueCleanupResult {
+    mode: string | null;
+    cartRows: number;
+    retiredOrderRows: number;
+    errors: string[];
+}
+/**
+ * Verbergt oude orderregels uit het actieve pickscherm zodra dezelfde
+ * pickeenheid concrete karregels heeft. De regel blijft als printhistorie
+ * bestaan; karrencontrole gebruikt de canonieke kargegevens en blijft intact.
+ */
+export declare function retireSupersededOrderRows(sb: SupabaseClient): Promise<PickQueueCleanupResult>;
+//# sourceMappingURL=pickQueueCleanup.server.d.ts.map

package/dist-lib/lib/pickQueueCleanup.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickQueueCleanup.server.d.ts","sourceRoot":"","sources":["../../src/lib/pickQueueCleanup.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAiFjC"}

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

@@ -0,0 +1,80 @@
+const REPLACED_REASON = "Vervangen door actuele karregels.";
+/**
+ * Verbergt oude orderregels uit het actieve pickscherm zodra dezelfde
+ * pickeenheid concrete karregels heeft. De regel blijft als printhistorie
+ * bestaan; karrencontrole gebruikt de canonieke kargegevens en blijft intact.
+ */
+export async function retireSupersededOrderRows(sb) {
+    const result = {
+        mode: null,
+        cartRows: 0,
+        retiredOrderRows: 0,
+        errors: [],
+    };
+    const { data: modeData, error: modeError } = await sb.rpc("logistics_pick_mode");
+    if (modeError) {
+        result.errors.push(modeError.message);
+        return result;
+    }
+    const modeValue = Array.isArray(modeData) ? modeData[0] : modeData;
+    const modeObject = modeValue && typeof modeValue === "object"
+        ? modeValue
+        : null;
+    result.mode = String(modeObject?.["pickMode"] ?? modeObject?.["mode"] ?? "");
+    if (result.mode !== "cart")
+        return result;
+    const { data: cartRows, error: cartRowsError } = await sb
+        .from("pick_queue")
+        .select("order_number")
+        .is("cancelled_at", null)
+        .not("payload->>cartRowFor", "is", null);
+    if (cartRowsError) {
+        result.errors.push(cartRowsError.message);
+        return result;
+    }
+    const safeCartRows = Array.isArray(cartRows) ? cartRows : [];
+    const orderNumbers = [...new Set(safeCartRows
+            .map((row) => row.order_number)
+            .filter((value) => typeof value === "string" && value.length > 0))];
+    result.cartRows = safeCartRows.length;
+    if (orderNumbers.length === 0)
+        return result;
+    const replacedAt = new Date().toISOString();
+    const { data: oldRows, error: oldRowsError } = await sb
+        .from("pick_queue")
+        .select("id, payload")
+        .in("order_number", orderNumbers)
+        .is("cancelled_at", null)
+        .is("payload->>cartRowFor", null);
+    if (oldRowsError) {
+        result.errors.push(oldRowsError.message);
+        return result;
+    }
+    const safeOldRows = Array.isArray(oldRows) ? oldRows : [];
+    for (const row of safeOldRows) {
+        const payload = row.payload && typeof row.payload === "object" && !Array.isArray(row.payload)
+            ? row.payload
+            : {};
+        const { error } = await sb
+            .from("pick_queue")
+            .update({
+            cancelled_at: replacedAt,
+            payload: {
+                ...payload,
+                cartPlanReady: true,
+                cartPlanReason: null,
+                supersededByCartRows: true,
+                supersededReason: REPLACED_REASON,
+                supersededAt: replacedAt,
+            },
+            updated_at: replacedAt,
+        })
+            .eq("id", row.id)
+            .is("cancelled_at", null);
+        if (error)
+            result.errors.push(error.message);
+        else
+            result.retiredOrderRows += 1;
+    }
+    return result;
+}

package/dist-lib/lib/planQueue.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planQueue.server.d.ts","sourceRoot":"","sources":["../../src/lib/planQueue.server.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD,wFAAwF;AACxF,wBAAsB,YAAY,CAChC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC3D,OAAO,CAAC,eAAe,CAAC,CAsG1B;AA0CD,4EAA4E;AAE5E,wBAAsB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}
+{"version":3,"file":"planQueue.server.d.ts","sourceRoot":"","sources":["../../src/lib/planQueue.server.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD,wFAAwF;AACxF,wBAAsB,YAAY,CAChC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC3D,OAAO,CAAC,eAAe,CAAC,CAuP1B;AA0CD,4EAA4E;AAE5E,wBAAsB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}

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

@@ -9,6 +9,8 @@
 // ============================================================================
 import { replanBufferInternal, replanOrderInternal } from "./loadCarrierPlanning.server.js";
 import { attachIndelingToTasks } from "./loadCarrierTaskSync.server.js";
+import { trace, newTraceId, classifyError } from "./trace.server.js";
+import { FLOW_NODE } from "./flowNodes.js";
 const EMPTY = {
     claimed: 0,
     planned: 0,
@@ -37,10 +39,54 @@ export async function runPlanQueue(sb, options = {}) {
     // Voorkomt dat dezelfde buffer binnen één ronde meerdere keren wordt gepland.
     const plannedBuffers = new Set();
     const touchedDates = new Set();
+    // Herkenbare ordernummers voor het logboek; nooit verzinnen bij ontbreken.
+    const orderNumbers = new Map();
+    {
+        const ids = Array.from(new Set(rows.map((r) => r.order_id).filter(Boolean)));
+        if (ids.length > 0) {
+            const { data: orderRows } = await sb
+                .from("orders")
+                .select("id, order_number, order_source")
+                .in("id", ids);
+            for (const o of Array.isArray(orderRows) ? orderRows : []) {
+                orderNumbers.set(String(o?.id), {
+                    number: o?.order_number ? String(o.order_number) : null,
+                    source: o?.order_source === "floriday" ? "floriday" : o?.order_source ? "eigen" : null,
+                });
+            }
+        }
+    }
     for (const row of rows) {
+        // Het trace-id is de wachtrijrij zelf: zo horen alle stappen van deze
+        // herberekening aantoonbaar bij één "versie" in het orderlogboek.
+        const traceId = row.id || newTraceId();
+        const gevonden = orderNumbers.get(row.order_id);
+        const basis = {
+            traceId,
+            orderRef: gevonden?.number ?? row.order_id,
+            orderSource: gevonden?.source ?? null,
+            phase: "karindeling",
+            actor: "logistiek-engine:planwachtrij",
+            attempts: Number(row.attempts ?? 0),
+            nodeId: FLOW_NODE.indeling,
+        };
         if (Date.now() > deadlineAt) {
             // Teruggeven aan de wachtrij; de volgende ronde pakt hem weer op.
             await sb.rpc("logistics_plan_finish", { p_id: row.id, p_error: "deadline" });
+            await trace(sb, {
+                ...basis,
+                step: "Indelen uitgesteld",
+                status: "wachtend",
+                decision: "Order blijft wachten",
+                reason: "De ronde was te lang bezig; deze order gaat mee met de volgende ronde.",
+                errorClass: "regel",
+                nextStep: "Volgende planronde (elke minuut)",
+                calc: {
+                    setting: "Maximale duur van één planronde",
+                    values: { rondeEindigdeOm: new Date(deadlineAt).toISOString(), beoordeeldOm: new Date().toISOString() },
+                    conclusion: "De order is niet overgeslagen, maar doorgeschoven naar de eerstvolgende ronde.",
+                },
+            });
             continue;
         }
         try {
@@ -54,23 +100,74 @@ export async function runPlanQueue(sb, options = {}) {
             }
             const bufferId = group.find((g) => g.buffer_id)?.buffer_id ?? null;
             let blocked = false;
+            await trace(sb, {
+                ...basis,
+                nodeId: FLOW_NODE.ontvangst,
+                step: "Order opgepakt voor indeling",
+                status: "geslaagd",
+                decision: bufferId ? "Order hoort bij een buffer" : "Order wordt los ingedeeld",
+                reason: bufferId
+                    ? "De order zit in een buffer; alle orders van die buffer worden samen ingedeeld."
+                    : "Er is geen open buffer voor deze order, dus hij wordt zelfstandig ingedeeld.",
+                reads: { geraakteOrders: group.length, bufferId, planDatums: [...touchedDates] },
+                nextStep: "Karrenindeling berekenen",
+            });
+            const startMs = Date.now();
             if (bufferId) {
                 if (!plannedBuffers.has(bufferId)) {
                     plannedBuffers.add(bufferId);
                     const plan = await replanBufferInternal(sb, bufferId);
                     if (plan.skipped === "locked") {
                         result.skippedLocked++;
+                        await trace(sb, {
+                            ...basis,
+                            step: "Indeling overgeslagen",
+                            status: "overgeslagen",
+                            decision: "Indeling blijft zoals hij is",
+                            reason: "De karren van deze buffer zijn al geprint, gescand of gecontroleerd.",
+                            errorClass: "regel",
+                            durationMs: Date.now() - startMs,
+                            calc: {
+                                setting: "Wanneer mag een karrenindeling niet meer veranderen",
+                                conclusion: "Bevroren karren worden nooit opnieuw ingedeeld, ook niet bij een herberekening.",
+                            },
+                            nextStep: "Pickstations en documenten",
+                        });
                     }
                     else if (plan.skipped === "blocked") {
                         blocked = true;
                         result.blocked++;
                         if (result.errors.length < 5 && plan.blockedReason)
                             result.errors.push(plan.blockedReason);
+                        await trace(sb, {
+                            ...basis,
+                            step: "Indeling geblokkeerd",
+                            status: "mislukt",
+                            decision: "Order gaat niet verder",
+                            errorClass: classifyError(null, plan.blockedReason ?? null),
+                            durationMs: Date.now() - startMs,
+                            nextStep: "Gegevens aanvullen en opnieuw indelen",
+                            ...(plan.blockedReason ? { reason: plan.blockedReason, error: plan.blockedReason } : {}),
+                        });
                     }
                     else {
                         result.planned++;
                         result.cartsCreated += Number(plan.cartsCreated ?? 0);
                         await attachIndelingToTasks(sb, plan);
+                        await trace(sb, {
+                            ...basis,
+                            step: "Buffer ingedeeld op karren",
+                            status: "geslaagd",
+                            decision: "Karrenindeling gemaakt",
+                            durationMs: Date.now() - startMs,
+                            output: { bufferId, karrenAangemaakt: Number(plan.cartsCreated ?? 0) },
+                            calc: {
+                                setting: "Indelingsmethode van de actieve werkwijze",
+                                values: { buffer: bufferId, karren: Number(plan.cartsCreated ?? 0) },
+                                result: `${Number(plan.cartsCreated ?? 0)} kar(ren) voor deze buffer`,
+                            },
+                            nextStep: "Vrijgave en aanmeldmoment",
+                        });
                     }
                 }
             }
@@ -78,17 +175,51 @@ export async function runPlanQueue(sb, options = {}) {
                 const plan = await replanOrderInternal(sb, row.order_id);
                 if (plan?.skipped === "locked") {
                     result.skippedLocked++;
+                    await trace(sb, {
+                        ...basis,
+                        step: "Indeling overgeslagen",
+                        status: "overgeslagen",
+                        decision: "Indeling blijft zoals hij is",
+                        reason: "De karren van deze order zijn al geprint, gescand of gecontroleerd.",
+                        errorClass: "regel",
+                        durationMs: Date.now() - startMs,
+                        nextStep: "Pickstations en documenten",
+                    });
                 }
                 else if (plan?.skipped === "blocked") {
                     blocked = true;
                     result.blocked++;
                     if (result.errors.length < 5 && plan.blockedReason)
                         result.errors.push(plan.blockedReason);
+                    await trace(sb, {
+                        ...basis,
+                        step: "Indeling geblokkeerd",
+                        status: "mislukt",
+                        decision: "Order gaat niet verder",
+                        errorClass: classifyError(null, plan.blockedReason ?? null),
+                        durationMs: Date.now() - startMs,
+                        nextStep: "Gegevens aanvullen en opnieuw indelen",
+                        ...(plan.blockedReason ? { reason: plan.blockedReason, error: plan.blockedReason } : {}),
+                    });
                 }
                 else if (plan) {
                     result.planned++;
                     result.cartsCreated += Number(plan.cartsCreated ?? 0);
                     await attachIndelingToTasks(sb, plan);
+                    await trace(sb, {
+                        ...basis,
+                        step: "Order ingedeeld op karren",
+                        status: "geslaagd",
+                        decision: "Karrenindeling gemaakt",
+                        durationMs: Date.now() - startMs,
+                        output: { karrenAangemaakt: Number(plan.cartsCreated ?? 0) },
+                        calc: {
+                            setting: "Indelingsmethode van de actieve werkwijze",
+                            values: { karren: Number(plan.cartsCreated ?? 0) },
+                            result: `${Number(plan.cartsCreated ?? 0)} kar(ren) voor deze order`,
+                        },
+                        nextStep: "Vrijgave en aanmeldmoment",
+                    });
                 }
             }
             // De blokkade zet de wachtrijregel zelf al op 'geblokkeerd'; die mag niet
@@ -110,6 +241,15 @@ export async function runPlanQueue(sb, options = {}) {
             if (result.errors.length < 5)
                 result.errors.push(message);
             await sb.rpc("logistics_plan_finish", { p_id: row.id, p_error: message });
+            await trace(sb, {
+                ...basis,
+                step: "Indelen mislukt",
+                status: "mislukt",
+                decision: "Order gaat niet verder",
+                errorClass: classifyError(null, message),
+                error: message,
+                nextStep: "Automatisch opnieuw geprobeerd in de volgende planronde",
+            });
         }
     }
     if (result.planned > 0) {

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

@@ -1 +1 @@
-{"version":3,"file":"ruleEngineImpact.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineImpact.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAgL1E;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,EAAE,CA2CrE;AAID,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD,wBAAgB,YAAY,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CAqBrF"}
+{"version":3,"file":"ruleEngineImpact.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineImpact.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAwL1E;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,EAAE,CA2CrE;AAID,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD,wBAAgB,YAAY,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CAqBrF"}

package/dist-lib/lib/ruleEngineImpact.js

@@ -81,9 +81,16 @@ export function analyseImpact(settings) {
         });
     }
     const control = f(settings, "controle", "control_mode");
-    score(control === "scanner");
-    if (control === "scanner")
+    score(control === "scanner" || control === "scan_only");
+    if (control === "scanner" || control === "scan_only")
         scanMoments += 1;
+    if (control === "scan_only") {
+        signals.push({
+            level: "info",
+            title: "Scannen voor afmelden",
+            detail: "Eén scan van de pakbon meldt de hele kar af; er wordt geen verzendbrief geprint.",
+        });
+    }
     if (control === "skip") {
         signals.push({
             level: "risk",
@@ -111,8 +118,8 @@ export function analyseImpact(settings) {
     if (reschedule === "manual_approval") {
         signals.push({
             level: "warning",
-            title: "Herplannen wacht op goedkeuring",
-            detail: "Vertraagde orders blijven staan tot een gebruiker de nieuwe leverdatum goedkeurt.",
+            title: "Herplannen gebeurt handmatig",
+            detail: "De Engine verzet vertraagde orders niet; dat doe je zelf in de Afhandeling-module.",
         });
     }
     if (f(settings, "order_picken", "internal_alert_enabled") === false) {

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

@@ -1 +1 @@
-{"version":3,"file":"ruleEngineSchema.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ruleEngineSchema.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineSchema.ts"],"names":[],"mappings":"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"}