@flowselections/logistiek-engine 1.0.34 → 1.0.89

package/dist-lib/lib/floridayPush.functions.js

@@ -2,8 +2,8 @@
 // src/lib/floridayPush.functions.ts — server functions (thin wrappers)
 // ============================================================================
 import { createServerFn } from "@tanstack/react-start";
-import { requireSupabaseAuth } from "../integrations/supabase/auth-middleware";
-import { readableServerErrors } from "../lib/readableServerErrors";
+import { requireSupabaseAuth } from "../integrations/supabase/auth-middleware.js";
+import { readableServerErrors } from "./readableServerErrors.js";
 /** Zet een order opnieuw in de wachtrij (handmatig opnieuw proberen). */
 export const retryFloridayPush = createServerFn({ method: "POST" })
     .middleware([readableServerErrors, requireSupabaseAuth])
@@ -14,7 +14,7 @@ export const retryFloridayPush = createServerFn({ method: "POST" })
     return data;
 })
     .handler(async ({ data }) => {
-    const { supabaseAdmin } = await import("../integrations/supabase/client.server");
+    const { supabaseAdmin } = await import("../integrations/supabase/client.server.js");
     const { queueFloridayPush } = await import("./floridayPush.server");
     await queueFloridayPush(supabaseAdmin, data.orderRef);
     return { ok: true };

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

@@ -0,0 +1,43 @@
+import { type RuleEngineSettings, type RuleField, type RuleGroup } from "./ruleEngineSchema";
+import { type WizardStep } from "./ruleEngineWizard";
+export interface FlowBranch {
+    value: string;
+    label: string;
+    active: boolean;
+}
+export interface FlowDecision {
+    /** Sleutel van het veld dat deze beslissing bepaalt. */
+    key: string;
+    label: string;
+    /** Naam van het blok waarin de instelling staat. */
+    groupLabel: string;
+    /** De uitkomst die nu geldt. */
+    currentLabel: string;
+    branches: FlowBranch[];
+    /** Beslissing met meerdere zichtbare uitkomsten (ruit) of vaste waarde. */
+    isChoice: boolean;
+    /** True als de waarde een ja/nee-schakelaar is (waarde is boolean). */
+    isBoolean: boolean;
+    /** Uitleg in gewone taal, regel voor regel. */
+    help: string[];
+}
+export interface FlowNode {
+    id: string;
+    label: string;
+    description: string;
+    storeId: string;
+    decisions: FlowDecision[];
+    conditions: string[];
+    /** Aantal zichtbare instellingen achter deze stap. */
+    settingCount: number;
+    /** Uitleg in gewone taal, regel voor regel. */
+    help: string[];
+}
+/** Alle zichtbare velden van een wizardstap, met hun blok. */
+export declare function visibleFieldsOf(step: WizardStep, settings: RuleEngineSettings): Array<{
+    field: RuleField;
+    group: RuleGroup;
+}>;
+/** Bouwt het flowschema uit de werkwijze die de engine gebruikt. */
+export declare function buildFlow(settings: RuleEngineSettings): FlowNode[];
+//# sourceMappingURL=flowGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flowGraph.d.ts","sourceRoot":"","sources":["../../src/lib/flowGraph.ts"],"names":[],"mappings":"AASA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA8GD,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,kBAAkB,GAC3B,KAAK,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC,CAW/C;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CA2ClE"}

package/dist-lib/lib/flowGraph.js

@@ -0,0 +1,153 @@
+// ============================================================================
+// src/lib/flowGraph.ts — flowschema afgeleid van de echte werkwijze
+// ============================================================================
+// Bouwt de knopen en beslismomenten van de flowpagina UITSLUITEND op uit
+// WIZARD_STEPS/RULE_STEPS en de opgeslagen instellingen van de werkwijze die
+// de engine gebruikt. Er wordt hier geen aparte flow beschreven: verandert een
+// instelling, dan verandert dit schema mee.
+// ============================================================================
+import { fieldVisible, optionLabel, conditionFieldLabel, conditionOperatorLabel, } from "./ruleEngineSchema";
+import { WIZARD_STEPS } from "./ruleEngineWizard";
+const DAY_SHORT = {
+    mon: "ma",
+    tue: "di",
+    wed: "wo",
+    thu: "do",
+    fri: "vr",
+    sat: "za",
+    sun: "zo",
+};
+function valueLabel(field, value) {
+    if (value === undefined || value === null || value === "")
+        return "niet ingesteld";
+    switch (field.type) {
+        case "toggle":
+            return value === true ? "aan" : "uit";
+        case "select":
+        case "radio":
+            return optionLabel(field, value);
+        case "days": {
+            const days = Array.isArray(value) ? value : [];
+            return days.length ? days.map((d) => DAY_SHORT[d] ?? d).join(", ") : "geen";
+        }
+        case "number":
+            return `${String(value)}${field.unit ? ` ${field.unit}` : ""}`;
+        case "priority": {
+            const entries = Array.isArray(value) ? value : [];
+            return `${entries.filter((e) => e?.enabled).length} actief`;
+        }
+        default:
+            return String(value);
+    }
+}
+function decisionFor(field, group, values) {
+    const value = values[field.key];
+    const current = valueLabel(field, value);
+    const basisUitleg = (branches) => {
+        const regels = [];
+        if (field.description)
+            regels.push(field.description);
+        regels.push(`Deze keuze hoort bij het blok "${group.label}".`);
+        regels.push(`Nu ingesteld op: ${current}.`);
+        if (branches.length) {
+            regels.push(`Mogelijke keuzes: ${branches.map((b) => b.label).join(" · ")}. Wijzig je hier iets, dan werkt de engine daarna meteen volgens die keuze.`);
+        }
+        return regels;
+    };
+    if (field.type === "toggle") {
+        const branches = [
+            { value: "true", label: "ja", active: value === true },
+            { value: "false", label: "nee", active: value !== true },
+        ];
+        return {
+            key: field.key,
+            label: field.label,
+            groupLabel: group.label,
+            currentLabel: current,
+            isChoice: true,
+            isBoolean: true,
+            branches,
+            help: basisUitleg(branches),
+        };
+    }
+    if (field.type === "select" || field.type === "radio") {
+        const options = Array.isArray(field.options) ? field.options : [];
+        if (options.length < 2)
+            return null;
+        const branches = options.map((o) => ({
+            value: o.value,
+            label: o.label,
+            active: o.value === value,
+        }));
+        return {
+            key: field.key,
+            label: field.label,
+            groupLabel: group.label,
+            currentLabel: current,
+            isChoice: true,
+            isBoolean: false,
+            branches,
+            help: basisUitleg(branches),
+        };
+    }
+    return null;
+}
+function describeConditions(conditions) {
+    const veilig = Array.isArray(conditions) ? conditions : [];
+    return veilig
+        .filter((c) => c && typeof c === "object")
+        .map((c) => {
+        const values = Array.isArray(c.values) ? c.values : [];
+        return `${conditionFieldLabel(c.field)} ${conditionOperatorLabel(c.operator)} ${values.length ? values.join(", ") : "—"}`;
+    });
+}
+/** Alle zichtbare velden van een wizardstap, met hun blok. */
+export function visibleFieldsOf(step, settings) {
+    const values = settings?.[step.storeId]?.fields ?? {};
+    const groups = Array.isArray(step.groups) ? step.groups : [];
+    const result = [];
+    for (const group of groups) {
+        const fields = Array.isArray(group.fields) ? group.fields : [];
+        for (const field of fields) {
+            if (fieldVisible(field, values, settings))
+                result.push({ field, group });
+        }
+    }
+    return result;
+}
+/** Bouwt het flowschema uit de werkwijze die de engine gebruikt. */
+export function buildFlow(settings) {
+    const veiligeSettings = settings && typeof settings === "object" ? settings : {};
+    return WIZARD_STEPS.map((step) => {
+        const values = veiligeSettings?.[step.storeId]?.fields ?? {};
+        const zichtbaar = visibleFieldsOf(step, veiligeSettings);
+        const decisions = zichtbaar
+            .map(({ field, group }) => decisionFor(field, group, values))
+            .filter((d) => d !== null);
+        const conditions = step.showConditions
+            ? describeConditions(veiligeSettings?.[step.storeId]?.conditions ?? [])
+            : [];
+        const help = [];
+        if (step.description)
+            help.push(step.description);
+        help.push(zichtbaar.length
+            ? `Achter deze stap staan ${zichtbaar.length} instellingen. Klik op het vakje om ze allemaal te openen en aan te passen.`
+            : "Bij deze stap staan op dit moment geen instelbare regels.");
+        if (decisions.length) {
+            help.push(`Beslismomenten hieronder: ${decisions.map((d) => `${d.label} (nu: ${d.currentLabel})`).join(" · ")}.`);
+        }
+        if (conditions.length) {
+            help.push(`Deze stap geldt alleen als: ${conditions.join(" en ")}.`);
+        }
+        return {
+            id: step.id,
+            label: step.label,
+            description: step.description,
+            storeId: step.storeId,
+            decisions,
+            conditions,
+            settingCount: zichtbaar.length,
+            help,
+        };
+    });
+}

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

@@ -0,0 +1,40 @@
+import type { FlowTree, TreeNode } from "./flowTree";
+import type { TraceEvent } from "./trace.server";
+/** Eén vakje op de route die voor deze order geldt. */
+export interface JourneyVak {
+    nodeId: string;
+    kind: TreeNode["kind"];
+    label: string;
+    /** Keuze die hier geldt (alleen bij beslisvakjes). */
+    beslissing: string | null;
+    /** Waarom die keuze geldt. */
+    waarom: string;
+    /** De bepalende instelling. */
+    regel: string | null;
+    /** Dit is een hoofdstap van de engine. */
+    hoofdstap: boolean;
+}
+/**
+ * De route door de kaart die voor deze order van toepassing is, in volgorde.
+ * Volgt alleen actieve lijnen vanaf "Order komt binnen"; de herkomstvakjes van
+ * andere bronnen blijven buiten beschouwing.
+ */
+export declare function journeyPad(tree: FlowTree, orderSource: string | null | undefined, wachtpunten?: Set<string> | null): JourneyVak[];
+/**
+ * Tot welk punt van de route is de order gekomen? Dat is het laatste vakje in
+ * het pad waarvan de Engine zelf iets heeft vastgelegd.
+ */
+export declare function bereiktTot(pad: JourneyVak[], vastgelegd: Set<string>): number;
+/**
+ * De vakjes die voor deze order gelden en waar nog niets van is vastgelegd,
+ * tot en met het punt waar de order nu is. Vakjes die verderop liggen blijven
+ * leeg: die zijn immers nog niet gebeurd.
+ */
+export declare function ontbrekendeJourneyEvents(input: {
+    tree: FlowTree;
+    orderRef: string;
+    orderSource: string | null | undefined;
+    vastgelegd: Set<string>;
+    wachtpunten?: Set<string> | null;
+}): TraceEvent[];
+//# sourceMappingURL=flowJourney.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flowJourney.d.ts","sourceRoot":"","sources":["../../src/lib/flowJourney.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAqDD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAC/B,UAAU,EAAE,CA4Cd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAM7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAClC,GAAG,UAAU,EAAE,CAwBf"}

package/dist-lib/lib/flowJourney.js

@@ -0,0 +1,156 @@
+// ============================================================================
+// src/lib/flowJourney.ts — de order langs élk vakje laten lopen dat geldt
+// ============================================================================
+// De Engine legt zelf alleen de grote stappen vast. De keuzevakjes ertussen
+// (de ruitjes met ja/nee) worden hier afgeleid uit exact dezelfde boom als de
+// kaart: welke vakjes gelden voor deze order, welke keuze geldt daar en
+// waarom. Zo is de blauwe route aaneengesloten en zie je welk deel van de
+// route al behandeld is.
+//
+// Puur observerend: hier wordt niets besloten, gepland, geprint of gewijzigd.
+// ============================================================================
+import { FLOW_NODE, bronNodeVoor } from "./flowNodes";
+const HOOFDSTAPPEN = new Set([
+    FLOW_NODE.samenvoegen,
+    FLOW_NODE.ontvangst,
+    FLOW_NODE.indeling,
+    FLOW_NODE.vrijgave,
+    FLOW_NODE.stations,
+    FLOW_NODE.picken,
+    FLOW_NODE.controle,
+    FLOW_NODE.eind,
+]);
+const BRON_NODES = new Set([
+    FLOW_NODE.bronFloriday,
+    FLOW_NODE.bronMail,
+    FLOW_NODE.bronActiemail,
+    FLOW_NODE.bronHandmatig,
+]);
+/** Vakjes zonder eigen betekenis in het logboek (samenkomstpunten en labels). */
+function teltMee(node) {
+    return node.kind !== "merge";
+}
+function beslissingVan(node) {
+    if (node.kind !== "decision")
+        return null;
+    const huidig = node.currentValue ?? "";
+    const optie = (node.options ?? []).find((o) => o.value === huidig);
+    return optie?.label ?? (huidig || null);
+}
+function waaromVan(node, beslissing) {
+    if (node.kind === "decision") {
+        return beslissing
+            ? `De instelling "${node.label}" staat op "${beslissing}", dus de order volgt die tak.`
+            : `Voor "${node.label}" is geen keuze ingesteld, dus de standaardtak geldt.`;
+    }
+    if (node.kind === "setting") {
+        const regels = Array.isArray(node.lines) ? node.lines : [];
+        return regels.length > 0
+            ? `Deze instellingen golden voor deze order: ${regels.join("; ")}.`
+            : `De instellingen van "${node.label}" golden voor deze order.`;
+    }
+    if (node.kind === "option") {
+        return `Dit is de uitkomst die voor deze order geldt.`;
+    }
+    if (node.kind === "source") {
+        return `De order is via deze weg binnengekomen.`;
+    }
+    return node.sublabel ?? `Deze stap geldt voor deze order.`;
+}
+/**
+ * De route door de kaart die voor deze order van toepassing is, in volgorde.
+ * Volgt alleen actieve lijnen vanaf "Order komt binnen"; de herkomstvakjes van
+ * andere bronnen blijven buiten beschouwing.
+ */
+export function journeyPad(tree, orderSource, wachtpunten) {
+    const byId = new Map(tree.nodes.map((n) => [n.id, n]));
+    const bron = bronNodeVoor(orderSource);
+    const uit = new Map();
+    for (const e of tree.edges) {
+        if (e.kind !== "flow" || e.state !== "active")
+            continue;
+        // Alleen de eigen herkomst van deze order telt mee.
+        if (BRON_NODES.has(e.to) && bron && e.to !== bron)
+            continue;
+        if (BRON_NODES.has(e.from) && bron && e.from !== bron)
+            continue;
+        const lijst = uit.get(e.from) ?? [];
+        lijst.push({ to: e.to });
+        uit.set(e.from, lijst);
+    }
+    const pad = [];
+    const gezien = new Set([FLOW_NODE.start]);
+    const wachtrij = [FLOW_NODE.start];
+    while (wachtrij.length > 0) {
+        const id = wachtrij.shift();
+        const node = byId.get(id);
+        if (node && node.state === "active" && teltMee(node)) {
+            const beslissing = beslissingVan(node);
+            pad.push({
+                nodeId: node.id,
+                kind: node.kind,
+                label: node.label,
+                beslissing,
+                waarom: waaromVan(node, beslissing),
+                regel: node.storeId && node.fieldKey ? `${node.storeId}.${node.fieldKey}` : null,
+                hoofdstap: HOOFDSTAPPEN.has(node.id),
+            });
+        }
+        // Wacht dit samenkomstpunt op andere takken? Dan loopt de reis hier niet verder.
+        if (wachtpunten?.has(id))
+            continue;
+        for (const { to } of uit.get(id) ?? []) {
+            if (gezien.has(to))
+                continue;
+            const doel = byId.get(to);
+            if (!doel || doel.state !== "active")
+                continue;
+            gezien.add(to);
+            wachtrij.push(to);
+        }
+    }
+    return pad;
+}
+/**
+ * Tot welk punt van de route is de order gekomen? Dat is het laatste vakje in
+ * het pad waarvan de Engine zelf iets heeft vastgelegd.
+ */
+export function bereiktTot(pad, vastgelegd) {
+    let laatste = -1;
+    pad.forEach((vak, i) => {
+        if (vastgelegd.has(vak.nodeId))
+            laatste = i;
+    });
+    return laatste;
+}
+/**
+ * De vakjes die voor deze order gelden en waar nog niets van is vastgelegd,
+ * tot en met het punt waar de order nu is. Vakjes die verderop liggen blijven
+ * leeg: die zijn immers nog niet gebeurd.
+ */
+export function ontbrekendeJourneyEvents(input) {
+    const pad = journeyPad(input.tree, input.orderSource, input.wachtpunten ?? null);
+    const grens = bereiktTot(pad, input.vastgelegd);
+    if (grens < 0)
+        return [];
+    const events = [];
+    for (let i = 0; i <= grens; i++) {
+        const vak = pad[i];
+        if (!vak || input.vastgelegd.has(vak.nodeId))
+            continue;
+        const volgende = pad[i + 1]?.label ?? null;
+        events.push({
+            orderRef: input.orderRef,
+            phase: "flow",
+            step: vak.label,
+            status: "geslaagd",
+            actor: "afgeleid",
+            nodeId: vak.nodeId,
+            decision: vak.beslissing ?? "route gevolgd",
+            reason: vak.waarom,
+            rule: vak.regel ?? undefined,
+            nextStep: volgende ?? undefined,
+        });
+    }
+    return events;
+}

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

@@ -0,0 +1,26 @@
+export declare const FLOW_NODE: {
+    readonly start: "__start";
+    readonly bron: "__bron";
+    readonly bronFloriday: "__bron_floriday";
+    readonly bronMail: "__bron_mail";
+    readonly bronActiemail: "__bron_actiemail";
+    readonly bronHandmatig: "__bron_handmatig";
+    readonly samenvoegen: "stap:bestelregels_samenvoegen";
+    readonly ontvangst: "stap:orders_combineren";
+    readonly indeling: "stap:beladingindeling";
+    readonly picken: "stap:picken";
+    readonly vrijgave: "stap:drukte_vertraging";
+    readonly klaarOmTePicken: "stap:klaar_om_te_picken";
+    readonly stations: "stap:pickstations";
+    readonly geprint: "stap:pakbon_geprint";
+    readonly afgemeld: "stap:kar_afgemeld";
+    readonly controle: "stap:controle";
+    readonly eind: "__eind";
+};
+export type FlowNodeId = (typeof FLOW_NODE)[keyof typeof FLOW_NODE];
+/** Leesbare naam van een vakje, voor het logboek en de tijdlijn. */
+export declare const FLOW_NODE_LABEL: Record<string, string>;
+/** Herkomst van een order (orders.order_source) → bronvakje op de kaart. */
+export declare function bronNodeVoor(source: string | null | undefined): string | null;
+export declare function flowNodeLabel(id: string | null | undefined): string;
+//# sourceMappingURL=flowNodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flowNodes.d.ts","sourceRoot":"","sources":["../../src/lib/flowNodes.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;CAmBZ,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEpE,oEAAoE;AACpE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBlD,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO7E;AAGD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGnE"}

package/dist-lib/lib/flowNodes.js

@@ -0,0 +1,64 @@
+// ============================================================================
+// src/lib/flowNodes.ts — vaste vakjes van de flowkaart
+// ============================================================================
+// De Engine legt bij elke stap vast bij welk vakje van de flowkaart die stap
+// hoort. Zo kleurt de kaart de echt gelopen route in plaats van een schatting.
+// De ids komen letterlijk overeen met de knoop-ids uit flowTree.ts.
+// ============================================================================
+export const FLOW_NODE = {
+    start: "__start",
+    bron: "__bron",
+    bronFloriday: "__bron_floriday",
+    bronMail: "__bron_mail",
+    bronActiemail: "__bron_actiemail",
+    bronHandmatig: "__bron_handmatig",
+    samenvoegen: "stap:bestelregels_samenvoegen",
+    ontvangst: "stap:orders_combineren",
+    indeling: "stap:beladingindeling",
+    picken: "stap:picken",
+    vrijgave: "stap:drukte_vertraging",
+    klaarOmTePicken: "stap:klaar_om_te_picken",
+    stations: "stap:pickstations",
+    geprint: "stap:pakbon_geprint",
+    afgemeld: "stap:kar_afgemeld",
+    controle: "stap:controle",
+    eind: "__eind",
+};
+/** Leesbare naam van een vakje, voor het logboek en de tijdlijn. */
+export const FLOW_NODE_LABEL = {
+    __start: "Order komt binnen",
+    __bron: "Waar komt de order vandaan?",
+    __bron_floriday: "Bestellingen uit Floriday",
+    __bron_mail: "Bestellingen uit de mail",
+    __bron_actiemail: "Bestellingen uit de actiemail",
+    __bron_handmatig: "Handmatige bestellingen",
+    "stap:bestelregels_samenvoegen": "Bestelregels samenvoegen",
+    "stap:orders_combineren": "Orders combineren",
+    "stap:beladingindeling": "Karrenindeling",
+    "stap:picken": "Order picken",
+    "stap:drukte_vertraging": "Vrijgave en aanmeldmoment",
+    "stap:klaar_om_te_picken": "Klaar om te picken",
+    "stap:pickstations": "Pickstations en documenten",
+    "stap:pakbon_geprint": "Pakbon geprint",
+    "stap:kar_afgemeld": "Kar afgemeld",
+    "stap:controle": "Controle en afmelden",
+    __eind: "Order afgehandeld",
+};
+/** Herkomst van een order (orders.order_source) → bronvakje op de kaart. */
+export function bronNodeVoor(source) {
+    const s = (source ?? "").toLowerCase();
+    if (!s)
+        return null;
+    if (s.includes("floriday"))
+        return FLOW_NODE.bronFloriday;
+    if (s.includes("actie"))
+        return FLOW_NODE.bronActiemail;
+    if (s.includes("mail"))
+        return FLOW_NODE.bronMail;
+    return FLOW_NODE.bronHandmatig;
+}
+export function flowNodeLabel(id) {
+    if (!id)
+        return "Onbekend vakje";
+    return FLOW_NODE_LABEL[id] ?? id.replace(/^stap:/, "").replace(/_/g, " ");
+}

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

@@ -0,0 +1,117 @@
+import type { FlowTree } from "./flowTree";
+import type { NodeTraceGroep } from "./nodeTrace";
+import { type StopReden } from "./stopReden";
+import type { TraceOrderStand } from "../hooks/useOrderTrace";
+/** Eén herberekening zoals `logistics_trace_versions` die teruggeeft. */
+export interface OrderVersie {
+    id: string;
+    nr: number;
+    startedAt: string | null;
+    claimedAt: string | null;
+    finishedAt: string | null;
+    windowEnd: string | null;
+    status: string | null;
+    error: string | null;
+    reason: string | null;
+    reasonCode: string | null;
+    attempts: number;
+    events: number;
+    errors: number;
+    warnings: number;
+    waiting: number;
+    printJobs: number;
+    printFailed: number;
+    shippingEvents: number;
+    shippingStatus: string | null;
+    lastErrorStep: string | null;
+    lastError: string | null;
+    lastPhase: string | null;
+    lastStep: string | null;
+    lastEventAt: string | null;
+}
+export interface OrderKop {
+    orderNumber: string;
+    orderSource: string | null;
+    status: string | null;
+    deliveryDate: string | null;
+    customerName: string | null;
+    createdAt: string | null;
+    bufferId: string | null;
+    planLockedAt: string | null;
+    cancelledAt: string | null;
+}
+export interface KarStand {
+    total: number;
+    printed: number;
+    controlled: number;
+    announced: number;
+}
+export interface OrderRoute {
+    /** Herkomst: bepaalt welke bron-tak blauw wordt. */
+    source: "floriday" | "mail" | "actiemail" | "handmatig" | null;
+    /** Stappen (wizard-ids, in volgorde) die de order heeft bereikt. */
+    reached: string[];
+    /** Stap waar het misging, met reden. */
+    stuck: {
+        stepId: string;
+        reason: string;
+    } | null;
+    /** Stap die nog bezig/wachtend is (geen fout). */
+    busy: {
+        stepId: string;
+        reason: string;
+    } | null;
+    /** Helemaal klaar: gecontroleerd en afgemeld. */
+    finished: boolean;
+    /** Korte samenvatting voor de kaart. */
+    summary: string;
+}
+export declare const REASON_LABEL: Record<string, string>;
+export declare function redenTekst(code: string | null | undefined, error?: string | null): string;
+/** Leidt uit één versie + de huidige stand van de order de gelopen route af. */
+export declare function bepaalRoute(versie: OrderVersie | null, order: OrderKop | null, carts: KarStand | null, isLaatste: boolean): OrderRoute;
+export declare function stapLabel(stepId: string): string;
+export type RouteMarker = {
+    kind: "stuck" | "busy" | "done";
+    text: string;
+    /** Welke keuze de Engine hier maakte. */
+    beslissing?: string | null;
+    /** Waarom die keuze is gemaakt. */
+    waarom?: string | null;
+    /** Bepalende gegevens en instellingen. */
+    feiten?: string[];
+    /** Tijdstip van de laatste gebeurtenis in dit vakje. */
+    at?: string | null;
+    /** Opgetelde duur van de stappen in dit vakje. */
+    durationMs?: number | null;
+    /** Aantal vastgelegde gebeurtenissen in dit vakje. */
+    count?: number;
+    /** Hoogste aantal pogingen in dit vakje. */
+    attempts?: number;
+    /** Foutsoort van de zwaarste gebeurtenis. */
+    errorClass?: string | null;
+    /** Wat de order hierna doet. */
+    nextStep?: string | null;
+    /** Bewijs hoort bij een vakje dat door een instellingswijziging niet meer op de kaart ligt. */
+    verouderd?: boolean;
+    /** Dit is het laatste vakje van de route. */
+    eindpunt?: boolean;
+    /** Waarom de reis hier ophoudt. */
+    stop?: StopReden | null;
+};
+export interface RouteOverlay {
+    tree: FlowTree;
+    markers: Map<string, RouteMarker>;
+    /** Samenkomstpunten waar deze order nu wacht op andere takken. */
+    wachtpunten: Set<string>;
+}
+/**
+ * Maakt een kopie van de kaart waarin alleen de gelopen route "active" is.
+ * Knopen/pijlen die de order (nog) niet heeft bereikt worden "possible".
+ *
+ * Zijn er echte gebeurtenissen per vakje (`groepen`), dan winnen die: de reis
+ * komt dan uit wat de Engine heeft vastgelegd. De heuristiek hieronder blijft
+ * de terugval voor oudere gebeurtenissen zonder vakje.
+ */
+export declare function applyRoute(tree: FlowTree, route: OrderRoute | null, groepen?: Map<string, NodeTraceGroep> | null, stand?: TraceOrderStand | null): RouteOverlay;
+//# sourceMappingURL=flowRoute.d.ts.map

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

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