@flowselections/logistiek-engine 1.0.177 → 1.0.180

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

@@ -12,6 +12,7 @@ import { fallbackCarrierProfile } from "./loadCarrierTypes.js";
 import { planByDimensions, DIMENSION_PLANNER_VERSION } from "./dimensionPlanner.js";
 import { buildDimensionItems, carrierDimensions } from "./dimensionData.server.js";
 import { zonderExternAfgehandeld } from "./externalFulfillment.js";
+import { vulBeladingAan, deelUitFloridayVerpakking, plantenVanRegel, plausibiliteit, karrenOnwaarschijnlijk, verpakkingSleutel, controleerInvariant, VELD_NAAM, } from "./beladingRegels.js";
 // ---------------------------------------------------------------------------
 // Buffer
 // ---------------------------------------------------------------------------
@@ -84,62 +85,62 @@ export function beladingPerRegelUitOrder(customFields) {
         const tradeItemId = line.trade_item_id ? String(line.trade_item_id) : null;
         if (!tradeItemId)
             continue;
-        const belading = beladingFromFloridayPacking(line.packing);
-        if (belading)
-            out.set(tradeItemId, belading);
+        // 1.0.179: per veld; 0 (klokorders) = onbekend, de rest van de verpakking telt wel.
+        const deel = deelUitFloridayVerpakking(line.packing);
+        if (deel)
+            out.set(tradeItemId, deel);
     }
     return out;
 }
-/** Waarden van de orderregel zelf, of null als de regel niets heeft. */
-function beladingVanRegel(row) {
-    if (positive(row.plants_per_crate) == null &&
-        positive(row.crates_per_layer) == null &&
-        positive(row.layers_per_cart) == null) {
+/** Waarden van de orderregel zelf (per veld; 0 of leeg = onbekend). */
+function deelVanRij(row) {
+    if (!row)
         return null;
-    }
-    return {
-        plants_per_crate: positive(row.plants_per_crate) ?? 1,
-        crates_per_layer: positive(row.crates_per_layer) ?? 1,
-        layers_per_cart: positive(row.layers_per_cart) ?? 1,
+    const d = {
+        plants_per_crate: positive(row.plants_per_crate),
+        crates_per_layer: positive(row.crates_per_layer),
+        layers_per_cart: positive(row.layers_per_cart),
     };
+    return d.plants_per_crate != null || d.crates_per_layer != null || d.layers_per_cart != null ? d : null;
 }
 /**
- * Beladingbronnen in vaste volgorde:
- *   1. handmatig vastgezette regel (packing_locked_at);
- *   2. de Floriday-verpakking van díe regel (op artikel gekoppeld);
- *   3. de eigen waarden van de bestelregel;
- *   4. het product;
- *   5. de order-brede Floriday-verpakking — uitsluitend als allerlaatste noodgreep
- *      voor een regel die van 1 t/m 4 niets heeft;
- *   6. anders onbekend: er wordt niet gegokt, de indeling blokkeert.
+ * 1.0.179: belading per veld, nooit een stille 1. Volgorde per veld:
+ *   handmatig vastgezet (alleen regel, dan product) of anders
+ *   Floriday-regel -> orderregel-snapshot -> product -> order-brede Floriday-verpakking.
+ * De standaard van de ladingdrager vult daarna in de indeling nog fusten per laag en lagen aan.
+ * Blijft een veld leeg, dan wordt die regel geblokkeerd (belading_onvolledig).
  */
-function resolveBelading(row, packing, linePacking = null) {
-    const fromRow = beladingVanRegel(row);
-    // 1. Handmatig vastgezet: niemand overschrijft dat, ook Floriday niet.
-    if (row.packing_locked_at && fromRow)
-        return { belading: fromRow, source: "handmatig" };
-    // 2. De Floriday-verpakking van deze regel.
-    if (linePacking)
-        return { belading: linePacking, source: "floriday_line" };
-    // 3. De eigen waarden van de bestelregel.
-    if (fromRow)
-        return { belading: fromRow, source: "order_items" };
-    const p = row.products ?? null;
-    const fromProduct = p && (positive(p.plants_per_crate) != null || positive(p.crates_per_layer) != null || positive(p.layers_per_cart) != null)
-        ? {
-            plants_per_crate: positive(p.plants_per_crate) ?? 1,
-            crates_per_layer: positive(p.crates_per_layer) ?? 1,
-            layers_per_cart: positive(p.layers_per_cart) ?? 1,
+export function resolveBelading(row, packing, linePacking = null) {
+    const regel = deelVanRij(row);
+    const product = deelVanRij(row.products ?? null);
+    const bronnen = row.packing_locked_at && regel
+        ? [
+            { naam: "handmatig", waarden: regel },
+            { naam: "product", waarden: product },
+        ]
+        : [
+            { naam: "floriday_line", waarden: linePacking },
+            { naam: "order_items", waarden: regel },
+            { naam: "product", waarden: product },
+            { naam: "floriday_packing", waarden: packing },
+        ];
+    const u = vulBeladingAan(bronnen);
+    const gebruikte = new Set(Object.values(u.bronPerVeld));
+    const source = (u.bronPerVeld.plants_per_crate ?? u.bronPerVeld.crates_per_layer ?? u.bronPerVeld.layers_per_cart ?? "geen");
+    const deel = u.belading ?? {
+        plants_per_crate: 0,
+        crates_per_layer: 0,
+        layers_per_cart: 0,
+    };
+    if (!u.belading) {
+        for (const b of bronnen) {
+            for (const v of ["plants_per_crate", "crates_per_layer", "layers_per_cart"]) {
+                if (deel[v] === 0 && positive(b.waarden?.[v]) != null)
+                    deel[v] = positive(b.waarden?.[v]);
+            }
         }
-        : null;
-    // 4. Het product.
-    if (fromProduct)
-        return { belading: fromProduct, source: "product" };
-    // 5. Allerlaatste noodgreep: de order-brede Floriday-verpakking.
-    if (packing)
-        return { belading: packing, source: "floriday_packing" };
-    // 6. Onbekend.
-    return { belading: { plants_per_crate: 1, crates_per_layer: 1, layers_per_cart: 1 }, source: "geen" };
+    }
+    return { belading: deel, source, ontbrekend: u.ontbrekend, aangevuld: gebruikte.size > 1 };
 }
 /** Schaal de onderdelen van een setregel naar het aantal sets op één kar. */
 export function scaleComponents(entry, plantsOnCart) {
@@ -225,8 +226,14 @@ export async function expandOrderItemsForPlanner(sb, rows, options = {}) {
                 lineMap.get(String(row.products?.floriday_trade_item_id ?? "")) ??
                 null
             : null;
-        const { belading: base, source } = resolveBelading(row, packing, linePacking);
-        const plants = Math.max(0, Number(row.quantity ?? 0));
+        const opgelost = resolveBelading(row, packing, linePacking);
+        const { belading: base, source } = opgelost;
+        // 1.0.179: intern altijd planten; eenheid fust = quantity x planten per fust van de regel.
+        const planten = plantenVanRegel(row.unit, row.quantity, row.plants_per_crate ?? base.plants_per_crate);
+        if (planten == null) {
+            options.onbekendePlanten?.push({ order_id: orderKey, order_item_id: String(row.id), naam: String(row.product_name ?? "onbekend") });
+        }
+        const plants = Math.max(0, planten ?? 0);
         const lines = linesByItem.get(String(row.id)) ?? [];
         const kind = lines[0]?.unit_kind ?? "artikel";
         if (kind === "uitgesloten") {
@@ -242,6 +249,8 @@ export async function expandOrderItemsForPlanner(sb, rows, options = {}) {
         }
         if (kind !== "groepslid") {
             options.sources?.set(String(row.id), source);
+            if (opgelost.ontbrekend.length > 0)
+                options.ontbrekend?.set(String(row.id), opgelost.ontbrekend);
             if (kind === "set") {
                 options.components?.set(String(row.id), { lineQty: plants, components: toComponents(lines[0]?.components) });
             }
@@ -253,7 +262,7 @@ export async function expandOrderItemsForPlanner(sb, rows, options = {}) {
                 product_name: row.product_name ?? "Onbekend",
                 plants,
                 ...base,
-                packing_authoritative: isAuthoritative(source),
+                packing_authoritative: isAuthoritative(source) && !opgelost.aangevuld && opgelost.ontbrekend.length === 0,
                 weight_per_crate: row.products?.weight != null ? Number(row.products.weight) : null,
             });
             continue;
@@ -266,37 +275,16 @@ export async function expandOrderItemsForPlanner(sb, rows, options = {}) {
             if (!p) {
                 throw new Error(`Indeling geblokkeerd voor ${row.product_name ?? "groep"}: groepslid ${l.trade_item_key ?? "onbekend"} heeft geen artikel.`);
             }
-            let belading;
-            let src;
             const eigenLijn = lineMap?.get(String(p.floriday_trade_item_id ?? "")) ?? lineMap?.get(String(p.id)) ?? null;
-            if (source === "handmatig") {
-                belading = { ...base };
-                src = source;
-            }
-            else if (eigenLijn) {
-                belading = { ...eigenLijn };
-                src = "floriday_line";
-            }
-            else if (positive(p.plants_per_crate) != null ||
-                positive(p.crates_per_layer) != null ||
-                positive(p.layers_per_cart) != null) {
-                belading = {
-                    plants_per_crate: positive(p.plants_per_crate) ?? 1,
-                    crates_per_layer: positive(p.crates_per_layer) ?? 1,
-                    layers_per_cart: positive(p.layers_per_cart) ?? 1,
-                };
-                src = "product";
-            }
-            else if (packing) {
-                belading = { ...packing };
-                src = "floriday_packing";
-            }
-            else {
-                belading = { ...base };
-                src = "geen";
-            }
+            const lid = source === "handmatig"
+                ? { belading: { ...base }, source: source, ontbrekend: opgelost.ontbrekend, aangevuld: opgelost.aangevuld }
+                : resolveBelading({ products: p }, packing, eigenLijn);
+            const belading = lid.belading;
+            const src = lid.source;
             const itemKey = `${row.id}::${l.trade_item_key ?? p.id}`;
             options.sources?.set(itemKey, src);
+            if (lid.ontbrekend.length > 0)
+                options.ontbrekend?.set(itemKey, lid.ontbrekend);
             out.push({
                 order_item_id: itemKey,
                 order_id: row.order_id ?? null,
@@ -305,13 +293,71 @@ export async function expandOrderItemsForPlanner(sb, rows, options = {}) {
                 product_name: `${row.product_name ?? "Groep"} — ${p.product ?? "onbekend groepslid"}`,
                 plants: qty,
                 ...belading,
-                packing_authoritative: isAuthoritative(src),
+                packing_authoritative: isAuthoritative(src) && !lid.aangevuld && lid.ontbrekend.length === 0,
                 weight_per_crate: p.weight != null ? Number(p.weight) : null,
             });
         }
     }
     return out;
 }
+async function bevestigdeSleutels(sb, orderIds) {
+    const set = new Set();
+    if (orderIds.length === 0)
+        return set;
+    const { data, error } = await sb
+        .from("logistics_belading_bevestigingen")
+        .select("order_id, verpakking_sleutel")
+        .in("order_id", orderIds);
+    if (error)
+        throw new Error(`Indeling geblokkeerd: bevestigingen konden niet worden gelezen (${error.message}).`);
+    for (const r of (Array.isArray(data) ? data : []))
+        set.add(`${r.order_id}|${r.verpakking_sleutel}`);
+    return set;
+}
+async function beladingOnwaarschijnlijk(sb, inputs, rawRows, profile) {
+    const fustIds = Array.from(new Set(rawRows.map((r) => r.products?.fust_type_id).filter((x) => !!x).map(String)));
+    const fustById = new Map();
+    if (fustIds.length > 0) {
+        const { data } = await sb.from("fust_types").select("id, name, capacity_units").in("id", fustIds);
+        for (const f of (Array.isArray(data) ? data : []))
+            fustById.set(String(f.id), f);
+    }
+    const fustPerProduct = new Map();
+    for (const r of rawRows)
+        if (r.product_id)
+            fustPerProduct.set(String(r.product_id), r.products?.fust_type_id ?? null);
+    const kandidaten = [];
+    for (const i of inputs) {
+        if (i.plants <= 0)
+            continue;
+        const fustId = i.product_id ? fustPerProduct.get(String(i.product_id)) ?? null : null;
+        const redenen = plausibiliteit({
+            belading: { plants_per_crate: i.plants_per_crate, crates_per_layer: i.crates_per_layer, layers_per_cart: i.layers_per_cart },
+            fust: fustId ? fustById.get(fustId) ?? null : null,
+            maxLagenLadingdrager: i.packing_authoritative ? null : profile.layers_per_carrier,
+        });
+        if (redenen.length === 0)
+            continue;
+        kandidaten.push({
+            order_id: i.order_id ?? null,
+            product: i.product_name,
+            sleutel: verpakkingSleutel(i.product_id, i),
+            redenen,
+        });
+    }
+    if (kandidaten.length === 0)
+        return [];
+    const ok = await bevestigdeSleutels(sb, Array.from(new Set(kandidaten.map((k) => k.order_id).filter((x) => !!x))));
+    return kandidaten.filter((k) => !ok.has(`${k.order_id}|${k.sleutel}`));
+}
+/** Invariant: elk fust van elke ingedeelde regel staat op precies één kar en de planten kloppen. */
+export function invariantFouten(inputs, carts) {
+    const regels = inputs
+        .filter((i) => i.plants > 0 && i.plants_per_crate > 0)
+        .map((i) => ({ id: i.order_item_id, planten: i.plants, plants_per_crate: i.plants_per_crate }));
+    const karRegels = carts.flatMap((c, idx) => c.items.map((it) => ({ regelId: it.order_item_id, cartId: String(idx), fusten: it.crates, planten: null })));
+    return controleerInvariant(regels, karRegels);
+}
 // ---------------------------------------------------------------------------
 // Ladingdragertypen
 // ---------------------------------------------------------------------------
@@ -734,6 +780,9 @@ export async function replanBufferInternal(sb, bufferId, options = {}) {
     // Een proefberekening schrijft niets weg en hoeft dus niets te vergrendelen.
     if (options.dryRun)
         return replanBufferUnlocked(sb, bufferId, options);
+    // Bijdelen binnen dezelfde ronde: de lease is al in handen, herbruiken.
+    if (options.leaseHeld)
+        return replanBufferUnlocked(sb, bufferId, options);
     const lockKey = `buffer:${bufferId}`;
     let held = false;
     try {
@@ -756,7 +805,7 @@ export async function replanBufferInternal(sb, bufferId, options = {}) {
             replacedManualCount: 0,
             usedFloridayPacking: false,
             warnings: [BUFFER_BUSY_MESSAGE],
-            skipped: "locked",
+            skipped: "busy",
         };
     }
     try {
@@ -866,7 +915,11 @@ async function replanBufferUnlocked(sb, bufferId, options = {}) {
                 const supplement = await replanBufferInternal(sb, bufferId, {
                     ...options,
                     keepCartIds: keep,
+                    leaseHeld: true,
                 });
+                // Melding alleen bij succes; anders de echte uitkomst (geblokkeerd/bezet) doorgeven.
+                if (!supplement.ok || supplement.skipped)
+                    return supplement;
                 return {
                     ...supplement,
                     warnings: [
@@ -884,9 +937,9 @@ async function replanBufferUnlocked(sb, bufferId, options = {}) {
     const idList = orderIds.length > 0 ? orderIds : ["00000000-0000-0000-0000-000000000000"];
     const { data: rawItems } = await sb
         .from("order_items")
-        .select("id, order_id, product_id, product_name, quantity, plants_per_crate, crates_per_layer, layers_per_cart, " +
+        .select("id, order_id, product_id, product_name, quantity, unit, plants_per_crate, crates_per_layer, layers_per_cart, " +
         "packing_locked_at, packing_locked_by, source_line_key, " +
-        "products(plants_per_crate, crates_per_layer, layers_per_cart, weight, floriday_trade_item_id)")
+        "products(plants_per_crate, crates_per_layer, layers_per_cart, weight, floriday_trade_item_id, fust_type_id)")
         .in("order_id", idList)
         // Regels in quarantaine (Verkoop-herstel) nooit inplannen.
         .is("quarantined_at", null);
@@ -973,12 +1026,16 @@ async function replanBufferUnlocked(sb, bufferId, options = {}) {
     const sources = new Map();
     const setComponents = new Map();
     const expandNotes = [];
+    const ontbrekendeVelden = new Map();
+    const onbekendePlanten = [];
     let inputs = await expandOrderItemsForPlanner(sb, rawRows, {
         packingByOrder,
         packingByOrderLine,
         sources,
         components: setComponents,
         notes: expandNotes,
+        ontbrekend: ontbrekendeVelden,
+        onbekendePlanten,
     });
     // Groepsregel naast ledenregels: niet ingedeeld, wel zichtbaar gemeld bij de order.
     for (const n of expandNotes) {
@@ -1108,23 +1165,53 @@ async function replanBufferUnlocked(sb, bufferId, options = {}) {
     // lagenmodel (los product / enkele eenheid) hebben de belading niet nodig.
     const guardProfile = profileFor(profiles, options.carrierType ?? defaultProfile.code);
     const needsBelading = guardProfile.capacity_model !== "single" && guardProfile.capacity_model !== "none";
-    const unknownItems = inputs.filter((i) => sources.get(i.order_item_id) === "geen" && i.plants > 0);
     const useDimensions = rules?.layoutMethod === "afmetingen";
-    if (!useDimensions && needsBelading && unknownItems.length > 0 && !options.dryRun) {
-        const reason = `Belading onbekend voor ${unknownItems.length} orderregel(s): geen Floriday-verpakking, ` +
-            `geen waarden op de orderregel en geen productinstelling. Er is niets ingedeeld.`;
+    // 1.0.179 (punt 1/2): ontbrekende fusten per laag en lagen aanvullen uit de standaard van de ladingdrager.
+    const standaard = {
+        crates_per_layer: positive(guardProfile.max_crates_per_layer),
+        layers_per_cart: positive(guardProfile.layers_per_carrier),
+    };
+    const onvolledig = [];
+    for (const i of inputs) {
+        const mist = ontbrekendeVelden.get(i.order_item_id);
+        if (!mist || mist.length === 0)
+            continue;
+        const rest = [];
+        for (const v of mist) {
+            const w = v === "plants_per_crate" ? null : standaard[v] ?? null;
+            if (w != null) {
+                i[v] = w;
+                i.packing_authoritative = false;
+            }
+            else
+                rest.push(v);
+        }
+        if (rest.length > 0 && i.plants > 0)
+            onvolledig.push({ item: i, velden: rest });
+    }
+    // Planten per fust is altijd nodig (ook zonder lagenmodel): fusten = planten / planten per fust.
+    const blokkeerOnvolledig = onvolledig.filter((o) => o.velden.includes("plants_per_crate") || (needsBelading && !useDimensions));
+    if ((blokkeerOnvolledig.length > 0 || onbekendePlanten.length > 0) && !options.dryRun) {
+        const delen = [
+            ...blokkeerOnvolledig.slice(0, 10).map((o) => `${o.item.product_name}: ${o.velden.map((v) => VELD_NAAM[v]).join(", ")} onbekend`),
+            ...onbekendePlanten.slice(0, 10).map((o) => `${o.naam}: eenheid fust zonder planten per fust`),
+        ];
+        const reason = `Belading onvolledig voor ${blokkeerOnvolledig.length + onbekendePlanten.length} orderregel(s): ${delen.join("; ")}. ` +
+            "Er wordt niet gegokt; vul de ontbrekende waarde in (orderregel, product of ladingdrager).";
         console.error(`[logistiek-engine] buffer ${bufferId} geblokkeerd: ${reason}`);
         const { error: blockError } = await sb.rpc("logistics_plan_block", {
             p_order_ids: orderIds,
             p_reason: reason,
             p_details: {
-                // Stabiele sleutel: nooit afgeleid uit ordernummers of aantallen.
-                reason_code: "belading_onbekend",
+                reason_code: "belading_onvolledig",
                 bufferId,
                 path: "typescript",
                 carrier: guardProfile.code,
                 beladingSources,
-                items: unknownItems.slice(0, 20).map((i) => ({ id: i.order_item_id, product: i.product_name })),
+                items: [
+                    ...blokkeerOnvolledig.slice(0, 20).map((o) => ({ id: o.item.order_item_id, product: o.item.product_name, velden: o.velden })),
+                    ...onbekendePlanten.slice(0, 20).map((o) => ({ id: o.order_item_id, product: o.naam, velden: ["plants_per_crate"] })),
+                ],
             },
         });
         if (blockError)
@@ -1142,6 +1229,33 @@ async function replanBufferUnlocked(sb, bufferId, options = {}) {
             beladingSources,
         };
     }
+    // 1.0.179 (punt 3): plausibiliteit, alle ordersoorten. Eén bevestiging per order en verpakking.
+    if (!options.dryRun) {
+        const onwaarschijnlijk = await beladingOnwaarschijnlijk(sb, inputs, rawRows, guardProfile);
+        if (onwaarschijnlijk.length > 0) {
+            const reason = `Belading onwaarschijnlijk: ${onwaarschijnlijk.slice(0, 10).map((o) => `${o.product}: ${o.redenen.join("; ")}`).join(" | ")}. ` +
+                "Kantoor moet dit bevestigen voordat er wordt ingedeeld.";
+            const { error: blockError } = await sb.rpc("logistics_plan_block", {
+                p_order_ids: orderIds,
+                p_reason: reason,
+                p_details: { reason_code: "belading_onwaarschijnlijk", bufferId, path: "typescript", bevestigen: onwaarschijnlijk.slice(0, 50) },
+            });
+            if (blockError)
+                warnings.push(`Blokkade kon niet worden vastgelegd: ${blockError.message}`);
+            return {
+                ok: false,
+                bufferId,
+                orderIds,
+                cartsCreated: 0,
+                replacedManualCount: 0,
+                usedFloridayPacking: false,
+                warnings: [...warnings, reason],
+                skipped: "blocked",
+                blockedReason: reason,
+                beladingSources,
+            };
+        }
+    }
     let plannedCarts = [];
     // Laagindeling van de afmetingenmethode, per cart_number. Alleen gevuld als
     // er daadwerkelijk op afmetingen is ingedeeld.
@@ -1319,6 +1433,54 @@ async function replanBufferUnlocked(sb, bufferId, options = {}) {
             beladingSources,
         };
     }
+    // 1.0.179 (punt 3): meer dan 50 karren voor één order vraagt bevestiging van kantoor.
+    // 1.0.179 (punt 11): invariant; bij een verschil wordt niets weggeschreven en niets geprint.
+    if (!options.dryRun) {
+        const perOrder = new Map();
+        for (const c of plannedCarts) {
+            for (const oid of new Set(c.items.map((it) => it.order_id).filter((x) => !!x))) {
+                perOrder.set(oid, (perOrder.get(oid) ?? 0) + 1);
+            }
+        }
+        const teVeel = Array.from(perOrder.entries()).filter(([, n]) => karrenOnwaarschijnlijk(n) != null);
+        if (teVeel.length > 0) {
+            const ok = await bevestigdeSleutels(sb, teVeel.map(([oid]) => oid));
+            const open = teVeel.filter(([oid, n]) => !ok.has(`${oid}|karren:${n}`));
+            if (open.length > 0) {
+                const reason = `Belading onwaarschijnlijk: ${open.map(([oid, n]) => `order ${orderRows.find((o) => String(o.id) === oid)?.order_number ?? oid}: ${karrenOnwaarschijnlijk(n)}`).join("; ")}. ` +
+                    "Kantoor moet dit bevestigen voordat er wordt ingedeeld.";
+                await sb.rpc("logistics_plan_block", {
+                    p_order_ids: orderIds,
+                    p_reason: reason,
+                    p_details: {
+                        reason_code: "belading_onwaarschijnlijk",
+                        bufferId,
+                        path: "typescript",
+                        bevestigen: open.map(([oid, n]) => ({ order_id: oid, sleutel: `karren:${n}`, redenen: [karrenOnwaarschijnlijk(n)] })),
+                    },
+                });
+                return {
+                    ok: false, bufferId, orderIds, cartsCreated: 0, replacedManualCount, usedFloridayPacking,
+                    warnings: [...warnings, reason], skipped: "blocked", blockedReason: reason, beladingSources,
+                };
+            }
+        }
+        if (!useDimensions) {
+            const fouten = invariantFouten(inputs, plannedCarts);
+            if (fouten.length > 0) {
+                const reason = `Indeling klopt niet: ${fouten.slice(0, 5).join(" ")} Er is niets weggeschreven en niets geprint.`;
+                await sb.rpc("logistics_plan_block", {
+                    p_order_ids: orderIds,
+                    p_reason: reason,
+                    p_details: { reason_code: "invariant_fusten", bufferId, path: "typescript", fouten: fouten.slice(0, 20) },
+                });
+                return {
+                    ok: false, bufferId, orderIds, cartsCreated: 0, replacedManualCount, usedFloridayPacking,
+                    warnings: [...warnings, reason], skipped: "blocked", blockedReason: reason, beladingSources,
+                };
+            }
+        }
+    }
     if (options.dryRun) {
         return {
             ok: true,

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

@@ -1 +1 @@
-{"version":3,"file":"modulePrompts.d.ts","sourceRoot":"","sources":["../../src/lib/modulePrompts.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAKvB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAKhE,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAwnMD,eAAO,MAAM,cAAc,EAAE,YAAY,EAUL,CAAC;AAErC,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,MAAM,CAiB9C;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAIR"}
+{"version":3,"file":"modulePrompts.d.ts","sourceRoot":"","sources":["../../src/lib/modulePrompts.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAKvB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAKhE,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAosMD,eAAO,MAAM,cAAc,EAAE,YAAY,EAUL,CAAC;AAErC,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,MAAM,CAiB9C;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAIR"}

package/dist-lib/lib/modulePrompts.js

@@ -1241,6 +1241,40 @@ CONTROLELIJST
         order: 2,
         summary: "Voert belading, controle, printen en transport uit volgens de taak-payload.",
         revisions: [
+            {
+                number: 30,
+                title: "Karnummer koppelen aan het kar-id",
+                date: "2026-10-21",
+                summary: "cart_numbers heeft een kolom cart_id; vul die bij elk nieuw karnummer.",
+                body: `KOPPELPROMPT ENGINE 1.0.179 – karnummers op kar-id
+
+De Engine heeft cart_numbers uitgebreid met cart_id uuid (stabiel na herindeling) en
+een unieke index (pick_date, cart_id) waar cart_id gevuld is. Graag:
+- Vul in assign_cart_numbers bij elk nieuw karnummer ook cart_id = order_carts.id.
+- Zoek bestaande nummers voortaan eerst op cart_id, pas daarna op order + cart_index.
+- logistics_cart_seq geeft nu een duidelijke fout als een order twee karren met
+  hetzelfde volgnummer heeft (er wordt geen kar meer weggelaten). Toon die fout.
+- logistics_cart_seq is niet meer aan te roepen als anon; ingelogd en server blijven werken.
+Bestaande nummers worden pas gekoppeld na akkoord van de opdrachtgever.
+Verander niets aan de Engine-functies.`,
+            },
+            {
+                number: 29,
+                title: "Antwoord 1.0.74: fusten en land per kar",
+                date: "2026-10-21",
+                summary: "control_get_todays_carts() geeft per kar ook crates_on_cart en country_code.",
+                body: `ANTWOORD ENGINE 1.0.178 – Afhandeling 1.0.74 (fusten en land per kar)
+
+control_get_todays_carts() heeft achteraan twee kolommen gekregen:
+- crates_on_cart integer: som van order_cart_items.crates op deze kar (op kar-id).
+  Bij een gedeelde kar het totaal van alle orders, één keer geteld. Geen indeling: NULL.
+- country_code text: ISO-landcode (2 letters) van de afleverlocatie van de eerste
+  order op de kar (op ordernummer), via orders.custom_fields->>'delivery_location'
+  -> customer_delivery_locations.id. Geen geldige 2-letterige code (bijv. "Nederland")
+  of geen locatie: NULL; er wordt niet omgezet uit een landnaam.
+Bestaande kolommen, volgorde, rechten en filtering zijn ongewijzigd.
+Je hoeft niets aan de Engine aan te passen.`,
+            },
             {
                 number: 28,
                 title: "Geen layoutkeuze meer: document automatisch uit de order",
@@ -5317,6 +5351,48 @@ Zelf rekenen doe je niet.
         order: 9,
         summary: "Levert de documentlayouts. Kiest zelf geen layout en geen printer: de Engine bepaalt welke layout en welke printplek bij een document horen.",
         revisions: [
+            {
+                number: 13,
+                title: "Correctie 1.69.2: eigen traysticker per fust",
+                date: "2026-10-21",
+                summary: "Een tray is een fust, geen laag: de Engine maakt één eigen traysticker per fust.",
+                body: `CORRECTIE ENGINE 1.0.178 – Layouts 1.69.2 (eigen traystickers per fust)
+
+Vervangt de laag-indeling uit antwoord 12. Een tray is een FUST.
+- Per orderregel op een kar: order_cart_items.crates opdrachten, één per fust.
+- tray_nummer / tray_totaal = fust x van y binnen de hele order
+  (volgorde: kar, regel, fust).
+- tray_producten: één item, het product van die regel (bij een samengesteld
+  product zoals een mixtray het samengestelde product), met
+  aantal = planten per fust (regel, anders product); het laatste fust van een
+  regel krijgt de rest. Optioneel 'onderdelen' als de karregel componenten heeft.
+- Idempotentie: eigen_traysticker:<order>:<kar>:<karregel>:<fustnummer>:<layout>.
+- Aantal fusten onbekend: alleen die sticker wacht met "Aantal fusten onbekend".
+- Verder ongewijzigd: _documenttype 'traysticker', _herkomst 'eigen',
+  _kopieen 1, layout via layout_voor_document, geen logo_url, zelfde vrijgave.`,
+            },
+            {
+                number: 12,
+                title: "Antwoord 1.69.2: eigen traystickers per tray",
+                date: "2026-10-21",
+                summary: "De Engine print traystickers voor eigen orders, één opdracht per tray, via layout_print_document.",
+                body: `ANTWOORD ENGINE 1.0.178 – Layouts 1.69.2 (eigen traystickers)
+
+Voor eigen orders (HO/MO/AO) maakt de Engine per tray (laag) van de karindeling
+één opdracht via layout_print_document:
+- _documenttype 'traysticker', _herkomst 'eigen', _kopieen 1
+- _layout_id uit logistics_document_for_order(order_id, 'traysticker'), die
+  layout_voor_document aanroept (= fs.eigen_traysticker)
+- _payload: order_id, order_number, ordernummer, klantnaam, leverdatum,
+  afleverlocatie, cart_id, print_plek_id, tray_nummer, tray_totaal,
+  tray_producten [{ artikelnummer, naam, aantal }]
+- Geen logo_url: het logo van de eigen organisatie haal je zelf uit de bedrijfsgegevens.
+- Idempotentie: eigen_traysticker:<order>:<kar>:<laag>:<layout>.
+Vrijgave: alleen als de instelling Tray-stickers niet op "Niet printen" staat;
+het moment is de pakbon van de kar (eigen orders hebben geen Floriday-belading).
+Ontbreekt de trayindeling of de layout: voor die tray geen opdracht, met uitleg;
+de rest van de order gaat door. Floriday-traystickers zijn ongewijzigd.`,
+            },
             {
                 number: 11,
                 title: "Verzenddocument: de Engine bepaalt afleverbrief of veilingbrief",

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

@@ -1,2 +1,2 @@
-export declare const MODULE_VERSION = "1.0.177";
+export declare const MODULE_VERSION = "1.0.180";
 //# sourceMappingURL=moduleVersion.d.ts.map

package/dist-lib/lib/moduleVersion.js

@@ -1,2 +1,2 @@
 // Automatisch gegenereerd door prebuild:lib; niet handmatig aanpassen.
-export const MODULE_VERSION = "1.0.177";
+export const MODULE_VERSION = "1.0.180";

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;AAQ5D,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,CAwR1B;AAgCD,iGAAiG;AACjG,eAAO,MAAM,eAAe,0EAA2E,CAAC;AAgCxG,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;AAS5D,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,CA8S1B;AAgCD,iGAAiG;AACjG,eAAO,MAAM,eAAe,0EAA2E,CAAC;AAgCxG,4EAA4E;AAE5E,wBAAsB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}