@flowselections/logistiek-engine 1.0.34 → 1.0.53

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,7 @@ 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"] },
                     },
                 ],
             },

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/trace.server.d.ts

@@ -0,0 +1,75 @@
+import type { SupabaseClient } from "@supabase/supabase-js";
+export type TraceStatus = "geslaagd" | "wachtend" | "waarschuwing" | "overgeslagen" | "mislukt";
+/**
+ * Foutsoort — zodat het logboek onderscheid maakt tussen een storing en een
+ * bewuste regel.
+ *  technisch            = database/API/printer/integratie ging stuk
+ *  ontbrekende_gegevens = de order of stamgegevens missen iets
+ *  configuratie         = een instelling of koppeling staat niet goed
+ *  regel                = de Engine mag bewust niet verder (business rule)
+ *  extern               = een extern systeem heeft (nog) niet geleverd
+ */
+export type TraceErrorClass = "technisch" | "ontbrekende_gegevens" | "configuratie" | "regel" | "extern";
+/** Berekening achter een beslissing, in begrijpelijke stappen. */
+export interface TraceCalc {
+    /** Welke instelling(en) meespeelden. */
+    setting?: string;
+    /** De gebruikte waarden, bijv. { lagen: 7, maxPerKar: 5 }. */
+    values?: Record<string, unknown>;
+    /** De rekenstap zelf, bijv. "7 / 5". */
+    formula?: string;
+    /** De uitkomst, bijv. "1 volle kar + 1 deelkar". */
+    result?: string;
+    /** Conclusie in gewone taal. */
+    conclusion?: string;
+}
+export interface TraceEvent {
+    traceId?: string | null;
+    orderRef?: string | null;
+    orderSource?: "floriday" | "eigen" | null;
+    cartRef?: string | null;
+    slipRef?: string | null;
+    phase: string;
+    step: string;
+    status: TraceStatus;
+    actor?: string;
+    /** Vakje in de flowkaart waar deze stap hoort (id uit flowTree). */
+    nodeId?: string;
+    input?: unknown;
+    output?: unknown;
+    reads?: unknown;
+    decision?: string;
+    reason?: string;
+    values?: unknown;
+    rule?: string;
+    /** Berekening achter de beslissing. */
+    calc?: TraceCalc;
+    /** Wat de order hierna gaat doen. */
+    nextStep?: string;
+    errorClass?: TraceErrorClass;
+    dbTable?: string;
+    dbRecord?: string;
+    dbAction?: string;
+    dbOld?: unknown;
+    dbNew?: unknown;
+    externalSystem?: string;
+    externalAction?: string;
+    externalRef?: string;
+    externalStatus?: string;
+    externalResponse?: unknown;
+    error?: string;
+    attempts?: number;
+    nextAttemptAt?: string | null;
+    durationMs?: number;
+}
+/** Bepaalt de foutsoort uit een reden-code of foutmelding. */
+export declare function classifyError(reasonCode?: string | null, message?: string | null): TraceErrorClass;
+/** Nieuw trace-id voor één volledige verwerkingsronde van een order. */
+export declare function newTraceId(): string;
+/** Eén gebeurtenis vastleggen. Faalt nooit hard. */
+export declare function trace(sb: SupabaseClient, event: TraceEvent): Promise<void>;
+/** Meerdere gebeurtenissen in één keer vastleggen. */
+export declare function traceBatch(sb: SupabaseClient, events: TraceEvent[]): Promise<void>;
+/** Meet de duur van een stap en legt uitkomst of fout vast. */
+export declare function traced<T>(sb: SupabaseClient, event: Omit<TraceEvent, "status">, run: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=trace.server.d.ts.map

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

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

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

@@ -0,0 +1,75 @@
+// ============================================================================
+// src/lib/trace.server.ts — audittrail vanuit de Engine zelf
+// ============================================================================
+// Elke stap, beslissing, databasewijziging en externe aanvraag wordt hier
+// vastgelegd via public.logistics_trace. Loggen mag de verwerking nooit
+// blokkeren: fouten worden bewust ingeslikt.
+// ============================================================================
+/** Bepaalt de foutsoort uit een reden-code of foutmelding. */
+export function classifyError(reasonCode, message) {
+    const t = `${reasonCode ?? ""} ${message ?? ""}`.toLowerCase();
+    if (/afmeting|ontbreek|onbekend|geen regels|mist|niet gevuld|leeg/.test(t))
+        return "ontbrekende_gegevens";
+    if (/instelling|configurat|layout|mapping|niet ingesteld|werktijden/.test(t))
+        return "configuratie";
+    if (/kargrens|regel|niet toegestaan|geblokkeerd|vrijgave|aanmeldmoment|bevroren/.test(t))
+        return "regel";
+    if (/floriday|api|http|timeout|extern|printer/.test(t))
+        return "extern";
+    return "technisch";
+}
+/** Nieuw trace-id voor één volledige verwerkingsronde van een order. */
+export function newTraceId() {
+    return globalThis.crypto?.randomUUID?.() ?? "";
+}
+function clean(event) {
+    const out = {};
+    for (const [key, value] of Object.entries(event)) {
+        if (value !== undefined && value !== null && value !== "")
+            out[key] = value;
+    }
+    return out;
+}
+/** Eén gebeurtenis vastleggen. Faalt nooit hard. */
+export async function trace(sb, event) {
+    try {
+        await sb.rpc("logistics_trace", { p: clean(event) });
+    }
+    catch {
+        /* loggen mag de verwerking niet blokkeren */
+    }
+}
+/** Meerdere gebeurtenissen in één keer vastleggen. */
+export async function traceBatch(sb, events) {
+    if (!Array.isArray(events) || events.length === 0)
+        return;
+    try {
+        await sb.rpc("logistics_trace_batch", { p: events.map(clean) });
+    }
+    catch {
+        /* loggen mag de verwerking niet blokkeren */
+    }
+}
+/** Meet de duur van een stap en legt uitkomst of fout vast. */
+export async function traced(sb, event, run) {
+    const start = Date.now();
+    try {
+        const result = await run();
+        await trace(sb, {
+            ...event,
+            status: "geslaagd",
+            durationMs: Date.now() - start,
+            output: event.output ?? result,
+        });
+        return result;
+    }
+    catch (e) {
+        await trace(sb, {
+            ...event,
+            status: "mislukt",
+            durationMs: Date.now() - start,
+            error: String(e?.message ?? e),
+        });
+        throw e;
+    }
+}

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

@@ -0,0 +1,19 @@
+import { type NodeTraceGroep } from "./nodeTrace";
+export interface VakUitleg {
+    /** Welke keuze de Engine hier maakte. */
+    beslissing: string;
+    /** Waarom die keuze is gemaakt. */
+    waarom: string | null;
+    /** De bepalende gegevens en instellingen, als korte paren. */
+    feiten: string[];
+    /** Regel/instelling waarop de keuze steunt. */
+    regel: string | null;
+    /** Is dit afgeleid uit de registraties in plaats van vastgelegd? */
+    afgeleid: boolean;
+}
+/**
+ * Maakt van de gebeurtenissen van één vakje een vaste uitleg:
+ * welke keuze is gemaakt, waarom, en welke gegevens dat bepaalden.
+ */
+export declare function vakUitleg(groep: NodeTraceGroep): VakUitleg;
+//# sourceMappingURL=vakUitleg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vakUitleg.d.ts","sourceRoot":"","sources":["../../src/lib/vakUitleg.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;CACnB;AA6DD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAoD1D"}