@flowselections/logistiek-engine 1.0.34 → 1.0.89

package/dist-lib/lib/resolveBuffer.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from "vitest";
+import { resolveBufferForOrderInternal } from "./loadCarrierPlanning.server";
+function fakeClient(initial, afterRpc) {
+    const calls = { rpc: 0, writes: 0 };
+    let current = initial;
+    const client = {
+        from(table) {
+            return {
+                select: () => ({
+                    eq: () => ({
+                        maybeSingle: async () => ({ data: table === "orders" ? { id: "o1", buffer_id: current } : null }),
+                    }),
+                }),
+                update: () => { calls.writes++; return { eq: async () => ({}) }; },
+                insert: () => { calls.writes++; return { select: () => ({ single: async () => ({}) }) }; },
+            };
+        },
+        async rpc() { calls.rpc++; current = afterRpc; return { error: null }; },
+    };
+    return { client: client, calls };
+}
+describe("resolveBufferForOrderInternal (alleen lezen)", () => {
+    it("gebruikt de bestaande buffer zonder iets te schrijven", async () => {
+        const { client, calls } = fakeClient("b1", "b2");
+        expect(await resolveBufferForOrderInternal(client, "o1")).toBe("b1");
+        expect(calls).toEqual({ rpc: 0, writes: 0 });
+    });
+    it("laat de database beslissen als er nog geen buffer is", async () => {
+        const { client, calls } = fakeClient(null, "b9");
+        expect(await resolveBufferForOrderInternal(client, "o1")).toBe("b9");
+        expect(calls).toEqual({ rpc: 1, writes: 0 });
+    });
+    it("maakt nooit zelf een buffer als de database er geen geeft", async () => {
+        const { client, calls } = fakeClient(null, null);
+        expect(await resolveBufferForOrderInternal(client, "o1")).toBeNull();
+        expect(calls.writes).toBe(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":"AAQA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,OAAO,GACP,MAAM,GACN,QAAQ,GACR,aAAa,GACb,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAMf,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,OAAO,EAAE,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,wGAAwG;IACxG,SAAS,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;CAC/C;AAGD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAID,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAQzC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,EAK5C,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAI9D,eAAO,MAAM,UAAU,EAAE,QAAQ,EAo+BhC,CAAC;AAKF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAgBhE;AAED,wBAAgB,eAAe,IAAI,kBAAkB,CAMpD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAalE;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,CAAC,EAAE,kBAAkB,WAcjC;AAYD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,UAE3D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,UAEhD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,UAEnD"}
+{"version":3,"file":"ruleEngineSchema.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineSchema.ts"],"names":[],"mappings":"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"}

package/dist-lib/lib/ruleEngineSchema.js

@@ -30,6 +30,20 @@ export const RULE_STEPS = [
         description: "Bepaal wanneer een order in een gecombineerde order (orderbuffer) terechtkomt.",
         supportsConditions: true,
         groups: [
+            {
+                id: "herkomst",
+                label: "Herkomst van bestellingen",
+                description: "Bestellingen komen binnen uit Floriday, de mailbox voor bestellingen, de actiemail of handmatige invoer.",
+                fields: [
+                    {
+                        key: "floriday_merge_lines",
+                        label: "Floriday-bestelregels samenvoegen tot \u00e9\u00e9n bestelling",
+                        type: "toggle",
+                        default: true,
+                        description: "Floriday levert elke bestelregel als een eigen verkooporder. Staat dit aan, dan worden regels van dezelfde klant, hetzelfde levermoment en dezelfde afleverlocatie samengevoegd tot \u00e9\u00e9n order met \u00e9\u00e9n ordernummer (het laagste FO-nummer). Orders die al zijn ingedeeld, geprint of gecontroleerd blijven ongewijzigd.",
+                    },
+                ],
+            },
             {
                 id: "orderbuffer",
                 label: "Orderbuffer",
@@ -232,6 +246,27 @@ export const RULE_STEPS = [
                         dependsOn: { key: "mode", in: ["auto"] },
                     },
                     { key: "max_customers", label: "Maximaal aantal klanten per ladingdrager", type: "number", min: 1, max: 99, default: 2, dependsOn: [{ key: "mode", in: ["auto"] }, { key: "fill_customers_as_much_as_fits", in: [false] }] },
+                    {
+                        key: "max_customers_per_layer",
+                        label: "Maximaal aantal klanten op een laag",
+                        type: "number",
+                        min: 1,
+                        max: 99,
+                        default: 1,
+                        description: "Staat dit op 1, dan mogen op één laag alleen producten van dezelfde klant staan. Meerdere bestellingen van dezelfde klant mogen wel samen op een laag.",
+                        dependsOn: { key: "mode", in: ["auto"] },
+                    },
+                    {
+                        key: "cart_plan_freeze",
+                        label: "Wanneer ligt de karrenindeling vast?",
+                        type: "select",
+                        default: "per_cart",
+                        options: [
+                            { value: "per_cart", label: "Als de pakbon is uitgeprint" },
+                            { value: "first_packing_slip", label: "Als de eerste pakbon van de order of buffer is uitgeprint" },
+                        ],
+                        description: "Per kar: alleen de kar met een geprinte pakbon blijft staan, de rest mag nog opnieuw ingedeeld worden. Eerste pakbon: zodra de eerste pakbon van de order of buffer is geprint, ligt de hele indeling vast en komen er hoogstens karren bij.",
+                    },
                     {
                         key: "fill_layers_as_much_as_fits",
                         label: "Lagen: zoveel als past",
@@ -538,8 +573,8 @@ export const RULE_STEPS = [
                             },
                             {
                                 value: "manual_approval",
-                                label: "Wachten op handmatige goedkeuring",
-                                description: "De Engine past de planning niet aan totdat een gebruiker de wijziging heeft goedgekeurd.",
+                                label: "Handmatig herinplannen",
+                                description: "De Engine doet niets met vertraagde orders: de nieuwe leverdag wordt handmatig in de Afhandeling-module bepaald.",
                             },
                         ],
                     },
@@ -782,7 +817,7 @@ export const RULE_STEPS = [
                         options: [
                             { value: "after_checkin", label: "Na het aanmeldmoment van het transport" },
                             { value: "after_scan", label: "Automatisch afdrukken nadat een kar is gescand" },
-                            { value: "with_packing_slip", label: "Gelijktijdig met de pakbon" },
+                            { value: "with_packing_slip", label: "Als de pakbon wordt uitgeprint" },
                             { value: "manual_approval", label: "Pas na handmatige goedkeuring op een pickstation" },
                         ],
                     },
@@ -883,16 +918,18 @@ export const RULE_STEPS = [
                         type: "select",
                         default: "scanner",
                         options: [
-                            { value: "scanner", label: "Scancontrole" },
+                            { value: "scanner", label: "Scancontrole met verzendbrief uitprinten" },
+                            { value: "scan_only", label: "Scannen voor afmelden" },
                             { value: "paper", label: "Papieren controle" },
                             { value: "skip", label: "Controle overslaan" },
                         ],
+                        description: "Bij 'Scannen voor afmelden' scant de medewerker alleen de pakbon; die ene scan meldt de hele kar direct af. Er wordt dan niets geprint.",
                     },
                     {
                         key: "control_scanner_id",
                         label: "Scanner",
                         type: "scanner",
-                        dependsOn: [{ key: "control_mode", in: ["scanner"] }],
+                        dependsOn: [{ key: "control_mode", in: ["scanner", "scan_only"] }],
                         description: "De scanner die bij deze controlepost hoort. Alle pakbonnen die gecontroleerd moeten worden, komen bij deze scanner binnen.",
                     },
                     {
@@ -920,6 +957,13 @@ export const RULE_STEPS = [
                         default: false,
                         description: "Staat dit uit, dan verstuurt de Logistics Engine geen enkele statuswijziging naar Floriday. Staat dit aan, dan wordt een order pas op afgehandeld gezet nadat de karrencontrole is goedgekeurd.",
                     },
+                    {
+                        key: "floriday_delivery_note_create",
+                        label: "Verzendbrief laten aanmaken in Floriday",
+                        type: "toggle",
+                        default: false,
+                        description: "Staat dit aan, dan laat de Engine bij een Floriday-order een officiele verzendbrief aanmaken zodra de pakbon naar het pickstation gaat, en haalt dat document daarna op. De order wordt hierdoor niet afgemeld; dat blijft aan de controlescan.",
+                    },
                     {
                         key: "floriday_stock_updates",
                         label: "Voorraad doorgeven aan Floriday",
@@ -935,7 +979,59 @@ export const RULE_STEPS = [
                         max: 100,
                         default: 100,
                         unit: "%",
-                        dependsOn: { key: "control_mode", in: ["scanner", "paper"] },
+                        dependsOn: { key: "control_mode", in: ["scanner", "scan_only", "paper"] },
+                    },
+                ],
+            },
+        ],
+    },
+    {
+        id: "opruimen",
+        label: "Opruimen",
+        icon: "trash",
+        description: "Hoe lang bewaart de engine afgeronde en geannuleerde taken voordat ze worden opgeruimd?",
+        supportsConditions: false,
+        groups: [
+            {
+                id: "opruimen",
+                label: "Bewaartermijn",
+                description: "Afgeronde, overgeslagen en geannuleerde taken worden na deze termijn verwijderd. Lopende en geplande taken blijven altijd staan. Zonder ingevulde termijn wordt er niets opgeruimd.",
+                fields: [
+                    {
+                        key: "task_retention_days",
+                        default: 90,
+                        label: "Afgeronde taken bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Laat dit leeg om niets op te ruimen. Karren, karnummers en totalen van afgehandelde of gecontroleerde karren blijven hoe dan ook behouden.",
+                    },
+                    {
+                        key: "trace_retention_days",
+                        default: 30,
+                        label: "Logboekregels bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Na deze termijn worden logboekregels van orders opgeruimd. Laat leeg om niets op te ruimen.",
+                    },
+                    {
+                        key: "pick_history_retention_days",
+                        default: 180,
+                        label: "Pickhistorie bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Na deze termijn wordt de historie van de pickstations opgeruimd. Laat leeg om niets op te ruimen.",
+                    },
+                    {
+                        key: "barcode_retention_days",
+                        default: 30,
+                        label: "Barcodes van verdwenen karren bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Alleen barcodes van karren die niet meer bestaan en nooit zijn geprint, gescand of gecontroleerd. Laat leeg om niets op te ruimen.",
                     },
                 ],
             },

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

@@ -1 +1 @@
-{"version":3,"file":"ruleEngineWizard.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineWizard.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;CACzB;AAeD,eAAO,MAAM,YAAY,EAAE,UAAU,EAsDpC,CAAC;AA+BF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEzD;AAkED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE9D;AAyCD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAStF"}
+{"version":3,"file":"ruleEngineWizard.d.ts","sourceRoot":"","sources":["../../src/lib/ruleEngineWizard.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;CACzB;AAeD,eAAO,MAAM,YAAY,EAAE,UAAU,EAsDpC,CAAC;AA+BF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEzD;AAwED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE9D;AAyCD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAStF"}

package/dist-lib/lib/ruleEngineWizard.js

@@ -114,6 +114,8 @@ const EXTRA_HELP = {
     multi_order: "Aan: orders van meerdere bestellingen mogen op dezelfde drager staan.",
     max_orders: "Meer orders op één drager betekent minder karren, maar wel meer sorteerwerk.",
     max_customers: "Handig als klanten hun eigen kar willen ontvangen.",
+    max_customers_per_layer: "Op 1 komen er nooit twee verschillende klanten op dezelfde laag; meerdere bestellingen van dezelfde klant mogen wel samen.",
+    cart_plan_freeze: "Bepaalt hoe streng een eenmaal geprinte indeling vaststaat. Per kar blijft alleen de geprinte kar staan; bij 'eerste pakbon' ligt de hele order of buffer vast zodra er één pakbon uit de printer is.",
     max_layers: "Het aantal lagen dat je fysiek op een kar of container kwijt kunt.",
     max_boxes_per_pallet: "Het aantal dozen dat je fysiek op één pallet kwijt kunt.",
     optimal_fill: "Aan: het systeem zoekt de indeling waarbij de minste dragers nodig zijn.",
@@ -144,7 +146,7 @@ const EXTRA_HELP = {
     shipping_note_layout: "\u00c9\u00e9n layout voor de verzend-, aflever- en veilingbrief van BVO orders.",
     production_note_release: "Bepaalt op welk moment de productiebon beschikbaar komt.",
     production_note_station: "Het pickstation waar de productiebon uitgeprint wordt.",
-    control_mode: "Hoe je controleert of de kar klopt voordat hij weggaat.",
+    control_mode: "Hoe je controleert of de kar klopt voordat hij weggaat. Bij 'Scannen voor afmelden' is één pakbonscan genoeg en wordt de hele kar direct afgemeld.",
     control_print_items: "Welke papieren de medewerker bij de controle krijgt.",
     sample_percentage: "100% betekent alles controleren; lager betekent steekproefsgewijs.",
     pick_reserve_minutes: "Extra tijd die je altijd vrijhoudt vóór de vervoerder komt.",

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

@@ -0,0 +1,18 @@
+import type { SupabaseClient } from "@supabase/supabase-js";
+export interface ShippingNoteRun {
+    /** Het aantal aanvragen dat deze ronde is opgepakt. */
+    claimed: number;
+    /** Aantal aangemaakte verzendbrief-printopdrachten. */
+    printed: number;
+    /** Aantal aanvragen dat wacht op het officiële Floriday-document. */
+    waiting: number;
+    /** Aantal aanvragen dat door een tijdelijke storing opnieuw wordt geprobeerd. */
+    retrying: number;
+    /** Aantal aanvragen met een definitieve fout. */
+    failed: number;
+    errors: string[];
+}
+export declare function runShippingNoteQueue(sb: SupabaseClient, options?: {
+    limit?: number;
+}): Promise<ShippingNoteRun>;
+//# sourceMappingURL=shippingNoteQueue.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shippingNoteQueue.server.d.ts","sourceRoot":"","sources":["../../src/lib/shippingNoteQueue.server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAqCD,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,CAmU1B"}

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

@@ -0,0 +1,304 @@
+// ============================================================================
+// src/lib/shippingNoteQueue.server.ts
+// Verzendbrief bij het printen van een kar.
+//
+// De pakbon is de enige bron voor kar en printer. De wachtrijregel bewaart
+// alleen de verwijzing naar de pakbon; op het moment dat de printopdracht
+// wordt aangemaakt worden kar en printer uit die pakbon gelezen.
+//
+// BVO-orders krijgen hun eigen layout al vanuit de database. FO-orders (Floriday)
+// komen hier langs: alleen het officiële Floriday-document mag worden geprint.
+// Er wordt niets bevestigd of afgehandeld, en er komen geen omgevings- of
+// klantwaarden in deze code.
+// ============================================================================
+import { trace, newTraceId, classifyError } from "./trace.server.js";
+import { FLOW_NODE } from "./flowNodes.js";
+/** Na dit aantal pogingen is een aanvraag definitief mislukt. */
+const MAX_ATTEMPTS = 60;
+function pickPdf(result) {
+    const base64 = result["pdfBase64"] ??
+        result["base64"] ??
+        result["pdf"] ??
+        null;
+    const url = result["url"] ??
+        result["pdfUrl"] ??
+        result["documentUrl"] ??
+        null;
+    return { base64: base64 ?? null, url: url ?? null };
+}
+/** Bepaalt of een Floriday-antwoord tijdelijk is of "nog niet beschikbaar". */
+function classifyFloridayReason(message) {
+    const tijdelijk = /(timeout|time-out|tijdelijk|netwerk|network|rate.?limit|429|50\d|service unavailable|unavailable|opnieuw)/i;
+    return tijdelijk.test(message) ? "tijdelijk" : "nog_niet_beschikbaar";
+}
+export async function runShippingNoteQueue(sb, options = {}) {
+    const run = {
+        claimed: 0,
+        printed: 0,
+        waiting: 0,
+        retrying: 0,
+        failed: 0,
+        errors: [],
+    };
+    const { data, error } = await sb.rpc("logistics_slip_note_claim", {
+        _limit: options.limit ?? 10,
+        _lease_seconds: 120,
+    });
+    if (error) {
+        run.errors.push(`Verzendbrieven niet leesbaar: ${error.message}`);
+        return run;
+    }
+    const rows = Array.isArray(data) ? data : [];
+    run.claimed = rows.length;
+    if (rows.length === 0)
+        return run;
+    const { getFlorydayDocument } = await import("./floridayDocuments.server.js");
+    for (const row of rows) {
+        const attempts = Number(row.attempts ?? 0);
+        const traceId = newTraceId();
+        const basis = {
+            traceId,
+            orderRef: row.order_number ?? row.order_id ?? null,
+            orderSource: "floriday",
+            cartRef: row.cart_id ?? null,
+            slipRef: row.slip_job_id ?? null,
+            phase: "verzendbrief",
+            actor: "logistiek-engine:verzendbriefwachtrij",
+            attempts,
+            nodeId: FLOW_NODE.stations,
+        };
+        await trace(sb, {
+            ...basis,
+            step: "Verzendbriefaanvraag opgepakt",
+            status: "geslaagd",
+            input: { aanvraagId: row.id, pakbonJobId: row.slip_job_id, pogingen: attempts },
+            nextStep: "Officiële Floriday-verzendbrief ophalen",
+        });
+        const faal = async (code, reden, fulfillmentOrderId) => {
+            await sb.rpc("logistics_slip_note_finish", {
+                _id: row.id,
+                _ok: false,
+                _status: "mislukt",
+                _fulfillment_order_id: fulfillmentOrderId ?? null,
+                _error_code: code,
+                _error: reden,
+            });
+            run.failed++;
+            await trace(sb, {
+                ...basis,
+                step: "Verzendbrief definitief mislukt",
+                status: "mislukt",
+                decision: code,
+                reason: reden,
+                error: reden,
+                errorClass: classifyError(code, reden),
+                nextStep: "Handmatig oplossen; de Engine probeert het niet meer.",
+                calc: { values: { pogingen: attempts, maximaal: MAX_ATTEMPTS }, conclusion: reden },
+                ...(fulfillmentOrderId ? { externalRef: fulfillmentOrderId } : {}),
+            });
+        };
+        const wacht = async (reden, klasse) => {
+            if (attempts >= MAX_ATTEMPTS) {
+                await faal("wachten_verlopen", `Na ${attempts} pogingen is er nog steeds geen officiële verzendbrief. Laatste reden: ${reden}`);
+                return;
+            }
+            await sb.rpc("logistics_slip_note_keep_waiting", {
+                _id: row.id,
+                _reason: reden,
+                _class: klasse,
+            });
+            if (klasse === "tijdelijk")
+                run.retrying++;
+            else
+                run.waiting++;
+            await trace(sb, {
+                ...basis,
+                step: "Wachten op officiële Floriday-verzendbrief",
+                status: "wachtend",
+                decision: klasse,
+                reason: reden,
+                errorClass: "extern",
+                rule: "FO-orders krijgen uitsluitend het officiële Floriday-document",
+                nextStep: "Automatisch opnieuw proberen",
+                calc: {
+                    setting: "Maximaal aantal pogingen voor de verzendbrief",
+                    values: { poging: attempts, maximaal: MAX_ATTEMPTS },
+                    conclusion: `Nog ${Math.max(MAX_ATTEMPTS - attempts, 0)} poging(en) over.`,
+                },
+            });
+        };
+        try {
+            if (!row.order_number) {
+                await faal("geen_ordernummer", "Bij deze kar hoort geen ordernummer; de verzendbrief kan niet worden opgehaald.");
+                continue;
+            }
+            // Een verzendbrief ophalen is een leesactie. Wacht daarom niet op de
+            // status-/afhandelpush: die is bewust geblokkeerd tot na de controlescan.
+            const { data: order, error: orderError } = await sb
+                .from("orders")
+                .select("floriday_sales_order_id")
+                .eq("id", row.order_id ?? "")
+                .maybeSingle();
+            if (orderError) {
+                await wacht(`De Floriday-order kon niet worden gelezen: ${orderError.message}`, "tijdelijk");
+                continue;
+            }
+            const salesOrderId = String(order?.["floriday_sales_order_id"] ?? "").trim();
+            if (!salesOrderId) {
+                await faal("sales_order_ontbreekt", "Bij deze FO-order ontbreekt het Floriday sales-order-ID; de verzendbrief kan niet worden opgehaald.");
+                continue;
+            }
+            // Stap 1: zorg dat Floriday een officiele verzendbrief heeft. Bestaat er
+            // al een fulfillment-order voor deze pakbon, dan wordt er geen tweede
+            // aangemaakt.
+            let bestaandeFo = String(row.fulfillment_order_id ?? "").trim() || null;
+            if (!bestaandeFo) {
+                const { createFlorydayDeliveryNote } = await import("./floridayDocuments.server.js");
+                const startAanmaak = Date.now();
+                const aangemaakt = await createFlorydayDeliveryNote(sb, row.order_number);
+                await trace(sb, {
+                    ...basis,
+                    step: "Floriday: verzendbrief aanvragen",
+                    status: aangemaakt.fulfillmentOrderId ? "geslaagd" : aangemaakt.ok ? "wachtend" : "mislukt",
+                    externalSystem: "floriday",
+                    externalAction: "fulfillment-order aanmaken",
+                    ...(aangemaakt.fulfillmentOrderId ? { externalRef: aangemaakt.fulfillmentOrderId } : {}),
+                    externalResponse: aangemaakt,
+                    durationMs: Date.now() - startAanmaak,
+                    ...(aangemaakt.error ? { error: aangemaakt.error } : {}),
+                });
+                if (aangemaakt.fulfillmentOrderId) {
+                    bestaandeFo = aangemaakt.fulfillmentOrderId;
+                    await sb
+                        .from("logistics_slip_shipping_note")
+                        .update({ fulfillment_order_id: bestaandeFo })
+                        .eq("id", row.id)
+                        .is("fulfillment_order_id", null);
+                }
+                else if (!aangemaakt.ok) {
+                    await wacht(`Wachten op Floriday-verzendbrief: ${aangemaakt.error ?? "Floriday heeft het document nog niet aangemaakt."}`, aangemaakt.skipped ? "nog_niet_beschikbaar" : classifyFloridayReason(aangemaakt.error ?? ""));
+                    continue;
+                }
+            }
+            // Stap 2: het officiele document ophalen.
+            const startOphalen = Date.now();
+            const doc = (await getFlorydayDocument(sb, {
+                kind: "delivery-note",
+                salesOrderId,
+                ...(bestaandeFo ? { fulfillmentOrderId: bestaandeFo } : {}),
+            }));
+            await trace(sb, {
+                ...basis,
+                step: "Floriday: verzendbrief ophalen",
+                status: doc["ok"] ? "geslaagd" : "wachtend",
+                externalSystem: "floriday",
+                externalAction: "delivery-note ophalen",
+                ...(bestaandeFo ? { externalRef: bestaandeFo } : {}),
+                externalResponse: {
+                    ok: doc["ok"] ?? false,
+                    error: doc["error"] ?? null,
+                    heeftBestand: Boolean(doc["pdfBase64"] ?? doc["base64"] ?? doc["pdf"] ?? doc["url"]),
+                },
+                durationMs: Date.now() - startOphalen,
+            });
+            if (!doc["ok"]) {
+                const message = String(doc["error"] ?? "") ||
+                    "Wachten op officiële Floriday-afleverbrief: Floriday heeft het document nog niet aangemaakt.";
+                await wacht(message, classifyFloridayReason(message));
+                continue;
+            }
+            const fulfillmentOrderId = String(doc["fulfillmentOrderId"] ?? doc["fulfillment_order_id"] ?? "").trim() ||
+                bestaandeFo;
+            const { base64, url } = pickPdf(doc);
+            if (!base64 && !url) {
+                // Nooit een leeg of zelfgemaakt document printen.
+                await wacht("Wachten op officiële Floriday-afleverbrief: Floriday gaf nog geen bruikbaar bestand terug.", "nog_niet_beschikbaar");
+                continue;
+            }
+            // De pakbon is de bron voor printer en kar.
+            const { data: slip } = await sb
+                .from("print_jobs")
+                .select("payload, printer_id, documentnaam, is_herprint")
+                .eq("id", row.slip_job_id)
+                .maybeSingle();
+            const slipRow = (slip ?? null);
+            if (!slipRow) {
+                await faal("pakbon_verdwenen", "De bijbehorende pakbon bestaat niet meer; er wordt geen losse verzendbrief gemaakt.", fulfillmentOrderId);
+                continue;
+            }
+            const slipPayload = slipRow["payload"] ?? {};
+            const printerId = slipRow["printer_id"] ?? null;
+            const cartId = slipPayload["cart_id"] ?? row.cart_id;
+            if (!printerId) {
+                await wacht("De pakbon heeft nog geen printer toegewezen gekregen; de verzendbrief wacht op dezelfde printer.", "tijdelijk");
+                continue;
+            }
+            const idempotentie = `verzendbrief-bij-pakbon:${row.slip_job_id}`;
+            const { data: bestaand } = await sb
+                .from("print_jobs")
+                .select("id")
+                .eq("idempotentie_sleutel", idempotentie)
+                .maybeSingle();
+            let jobId = bestaand?.["id"] ?? null;
+            if (!jobId) {
+                const { data: job, error: jobError } = await sb
+                    .from("print_jobs")
+                    .insert({
+                    printer_id: printerId,
+                    documenttype: "afleverbrief",
+                    documentnaam: `Verzendbrief ${row.order_number}`,
+                    status: "wachtend",
+                    idempotentie_sleutel: idempotentie,
+                    pdf_base64: base64,
+                    pdf_url: url,
+                    herkomst: "logistiek-engine",
+                    gebruiker_naam: "Pickstation",
+                    is_herprint: Boolean(slipRow["is_herprint"] ?? false),
+                    payload: {
+                        ...slipPayload,
+                        source: "pickstation",
+                        document_type_code: "verzendbrief",
+                        documentType: "verzendbrief",
+                        trigger: "with_packing_slip",
+                        is_floriday: true,
+                        packing_slip_job_id: row.slip_job_id,
+                        print_batch_key: row.batch_key ?? `kar-print:${row.slip_job_id}`,
+                        order_id: row.order_id,
+                        order_number: row.order_number,
+                        cart_id: cartId,
+                        fulfillment_order_id: fulfillmentOrderId,
+                    },
+                })
+                    .select("id")
+                    .maybeSingle();
+                if (jobError) {
+                    await wacht(`De verzendbrief kon nog niet worden klaargezet om te printen: ${jobError.message}`, "tijdelijk");
+                    continue;
+                }
+                jobId = job?.["id"] ?? null;
+            }
+            await sb.rpc("logistics_slip_note_finish", {
+                _id: row.id,
+                _ok: true,
+                _status: "geprint",
+                _print_job_id: jobId,
+                _fulfillment_order_id: fulfillmentOrderId,
+            });
+            run.printed++;
+            await trace(sb, {
+                ...basis,
+                step: "Verzendbrief klaargezet om te printen",
+                status: "geslaagd",
+                decision: "samen met de pakbon naar dezelfde printer",
+                ...(fulfillmentOrderId ? { externalRef: fulfillmentOrderId } : {}),
+                output: { printJobId: jobId, printerId, cartId },
+            });
+        }
+        catch (e) {
+            const message = String(e?.message ?? e);
+            run.errors.push(message);
+            await wacht(`Onverwachte fout bij het ophalen van de verzendbrief: ${message}`, "tijdelijk");
+        }
+    }
+    return run;
+}

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

@@ -0,0 +1,43 @@
+import type { TraceOrderStand } from "../hooks/useOrderTrace";
+import type { ShippingNoteDiagnose } from "../hooks/useShippingNoteDiagnose";
+import type { NodeTraceGroep } from "./nodeTrace";
+export type StopSoort = "mislukt" | "wachtrij" | "handeling" | "nietvastgelegd" | "klaar";
+export interface StopReden {
+    soort: StopSoort;
+    /** Korte kop, bijvoorbeeld "Hier is de order vastgelopen". */
+    titel: string;
+    /** Waarom de reis hier ophoudt. */
+    reden: string;
+    /** Bepalende gegevens, als korte regels. */
+    feiten: string[];
+    /** Wat er hierna moet gebeuren. */
+    volgendeStap: string | null;
+    /** De route is elders opgehouden door een gewijzigde instelling. */
+    verouderd: boolean;
+}
+/**
+ * Waarom de flow bij een samenkomstpunt blijft staan: de ingestelde voorwaarde
+ * is nog niet gehaald, of een verplichte tak is mislukt.
+ */
+export declare function samenkomstStop(input: {
+    wachtOp: string[];
+    mislukt?: string[];
+    voorwaarde: string;
+    maxWachtMinuten: number;
+}): StopReden;
+/**
+ * Bepaalt in gewone taal waarom de blauwe route bij dit vakje ophoudt.
+ * Werkt ook als er voor dit vakje nog niets is vastgelegd.
+ */
+export declare function stopReden(input: {
+    nodeId: string;
+    groep?: NodeTraceGroep | null;
+    stand?: TraceOrderStand | null;
+    verouderd?: boolean;
+}): StopReden;
+/**
+ * Waarom is de verzendbrief bij deze order nog niet opgehaald? Zet de
+ * alleen-lezen diagnose om naar dezelfde stoptekst als de rest van de kaart.
+ */
+export declare function verzendbriefStop(d: ShippingNoteDiagnose | null | undefined): StopReden | null;
+//# sourceMappingURL=stopReden.d.ts.map