@flowselections/floriday-voorraad 1.0.139 → 1.0.143

package/dist-lib/lib/__tests__/release-140.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-140.test.d.ts.map

package/dist-lib/lib/__tests__/release-140.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-140.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/release-140.test.ts"],"names":[],"mappings":""}

package/dist-lib/lib/__tests__/release-140.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { readFileSync } from "node:fs";
+import { opslaanMelding, valuesAfterSave, OPSLAAN_MISLUKT_TEKST } from "../stock-save.js";
+import { dbFoutTekst } from "../db-error-message.js";
+// @ts-expect-error plain ESM script
+import { controleerSchema } from "../../../scripts/check-schema-version.mjs";
+const saved = { physical_stock: 10, minimum_stock: 0, reserved_stock: 2, incoming_stock: 0, notes: null };
+const entered = { ...saved, physical_stock: 100 };
+describe("1.0.140 opslaan bij dichte poort", () => {
+    it("bevestigde opslag met dichte poort: 'Opgeslagen; er is niets naar Floriday gestuurd.'", () => {
+        const m = opslaanMelding({ opgeslagen: true, floriday_klaargezet_toegestaan: false }, true);
+        expect(m).toEqual({ ok: true, tekst: "Opgeslagen; er is niets naar Floriday gestuurd." });
+    });
+    it("teruggedraaide opslag (fout, geen antwoord) = mislukt en oude waarden terug", () => {
+        const m = opslaanMelding(null, true);
+        expect(m).toEqual({ ok: false, tekst: OPSLAAN_MISLUKT_TEKST });
+        expect(valuesAfterSave(m.ok, entered, saved).physical_stock).toBe(10);
+    });
+    it("antwoord zonder bevestiging telt niet als opgeslagen", () => {
+        expect(opslaanMelding({ opgeslagen: false }, true).ok).toBe(false);
+    });
+});
+describe("1.0.140 databasefouten in gewone taal", () => {
+    it("ontbrekende controlewaarde wordt 'nog niet beschikbaar'", () => {
+        const t = dbFoutTekst({ code: "23514", message: 'new row for relation "stock_mutation_log" violates check constraint' }, "Afboeken");
+        expect(t).toBe("Afboeken is nog niet beschikbaar in deze omgeving, neem contact op met de beheerder.");
+    });
+    it("oude poortfout toont geen technische tekst", () => {
+        const t = dbFoutTekst({ message: "Uitgaand Floriday-verkeer (stock_publish) is uitgeschakeld" }, "Opslaan");
+        expect(t).not.toContain("stock_publish");
+    });
+});
+describe("1.0.140 schemacontrole", () => {
+    it("ouder schema blokkeert", () => {
+        expect(controleerSchema("-- @flowselections/floriday-voorraad 1.0.136 x", "1.0.140").length).toBeGreaterThan(0);
+    });
+    it("het meegeleverde schema hoort bij de versie in package.json", () => {
+        const versie = JSON.parse(readFileSync("package.json", "utf8")).version;
+        const sql = readFileSync("sql/floriday-voorraad-schema.sql", "utf8");
+        expect(controleerSchema(sql, versie)).toEqual([]);
+    });
+});

package/dist-lib/lib/db-error-message.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Databasefouten nooit letterlijk tonen (1.0.140). De technische tekst gaat
+ * alleen naar de console; de gebruiker krijgt gewone taal.
+ */
+export type DbFoutActie = "Opslaan" | "Afboeken" | "Geschiedenis laden" | "Deze actie";
+export declare function dbFoutTekst(e: unknown, actie?: DbFoutActie): string;
+//# sourceMappingURL=db-error-message.d.ts.map

package/dist-lib/lib/db-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-error-message.d.ts","sourceRoot":"","sources":["../../src/lib/db-error-message.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAmBvF,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,GAAE,WAA0B,GAAG,MAAM,CA0BjF"}

package/dist-lib/lib/db-error-message.js

@@ -0,0 +1,36 @@
+/** Eigen Nederlandse meldingen uit onze functies (ERRCODE 22023/P0002/42501) mogen wel door. */
+const EIGEN_MELDINGEN = [
+    /^Kies een reden/i,
+    /^Vul een (aantal|voorraadaantal)/i,
+    /^Je kunt niet meer afboeken/i,
+    /^Voorraadaantallen mogen niet negatief/i,
+    /^Geen voorraadregel/i,
+    /^Je hebt geen schrijfrechten/i,
+    /^Onvoldoende voorraad/i,
+];
+export function dbFoutTekst(e, actie = "Deze actie") {
+    const err = (e ?? {});
+    const raw = String(err.message ?? (e instanceof Error ? e.message : e ?? ""));
+    const code = String(err.code ?? "");
+    const lower = raw.toLowerCase();
+    if (typeof console !== "undefined")
+        console.warn(`[voorraad] ${actie} mislukt:`, raw, code);
+    const eigen = EIGEN_MELDINGEN.find((re) => re.test(raw.trim()));
+    if (eigen)
+        return raw.trim();
+    if (lower.includes("uitgaand floriday-verkeer") || lower.includes("stock_publish")) {
+        return `${actie} is nog niet beschikbaar in deze omgeving (de databaseversie is ouder dan de app), neem contact op met de beheerder.`;
+    }
+    if (code === "42883" || code === "PGRST202" || code === "23514" ||
+        lower.includes("could not find the function") || lower.includes("does not exist") ||
+        lower.includes("violates check constraint")) {
+        return `${actie} is nog niet beschikbaar in deze omgeving, neem contact op met de beheerder.`;
+    }
+    if (code === "42501" || lower.includes("permission denied") || lower.includes("niet ingelogd")) {
+        return "Je hebt geen rechten voor deze actie. Log opnieuw in of vraag de beheerder.";
+    }
+    if (lower.includes("failed to fetch") || lower.includes("network")) {
+        return "Geen verbinding. Controleer je internet en probeer het opnieuw.";
+    }
+    return `${actie} is niet gelukt. Probeer het opnieuw of neem contact op met de beheerder.`;
+}

package/dist-lib/lib/engine-carrier.d.ts

@@ -0,0 +1,15 @@
+export type EngineCarrier = {
+    code: string | null;
+    melding: string | null;
+};
+export declare const ENGINE_ONTBREEKT = "De Logistiek Engine is niet ge\u00EFnstalleerd, daardoor kan de ladingdrager niet worden vertaald. Neem contact op met de beheerder.";
+/** Zet het antwoord (of de fout) van de Engine om; puur, zodat het te testen is. */
+export declare function interpretEngineCarrier(invoer: string, data: {
+    code?: string | null;
+    fout?: string | null;
+} | null | undefined, error: {
+    code?: string;
+    message?: string;
+} | null | undefined): EngineCarrier;
+export declare function resolveEngineCarrier(client: any, code: string): Promise<EngineCarrier>;
+//# sourceMappingURL=engine-carrier.d.ts.map

package/dist-lib/lib/engine-carrier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-carrier.d.ts","sourceRoot":"","sources":["../../src/lib/engine-carrier.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE5E,eAAO,MAAM,gBAAgB,yIACsG,CAAC;AAEpI,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EACvE,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAC5D,aAAa,CAUf;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAI5F"}

package/dist-lib/lib/engine-carrier.js

@@ -0,0 +1,27 @@
+/**
+ * Ladingdrager → Engine-code. De enige bron is de Logistiek Engine
+ * (logistics_ladingdrager_resolve over logistics_floriday_carrier_map).
+ * Geen eigen terugvallijst: ontbreekt de Engine of de vertaling, dan een melding.
+ */
+import { isMissingFunctionError } from "./buyer-organizations.js";
+export const ENGINE_ONTBREEKT = "De Logistiek Engine is niet geïnstalleerd, daardoor kan de ladingdrager niet worden vertaald. Neem contact op met de beheerder.";
+/** Zet het antwoord (of de fout) van de Engine om; puur, zodat het te testen is. */
+export function interpretEngineCarrier(invoer, data, error) {
+    if (error) {
+        if (isMissingFunctionError(error))
+            return { code: null, melding: ENGINE_ONTBREEKT };
+        return { code: null, melding: "De ladingdrager kon niet bij de Logistiek Engine worden gecontroleerd. Probeer het opnieuw." };
+    }
+    if (data?.code)
+        return { code: data.code, melding: null };
+    return {
+        code: null,
+        melding: `De Logistiek Engine kan ladingdrager "${invoer}" niet vertalen${data?.fout ? ` (${data.fout})` : ""}. Kies een andere ladingdrager of vraag de beheerder de vertaling toe te voegen.`,
+    };
+}
+export async function resolveEngineCarrier(client, code) {
+    if (!code.trim())
+        return { code: null, melding: null };
+    const { data, error } = await client.rpc("logistics_ladingdrager_resolve", { p_code: code });
+    return interpretEngineCarrier(code, data, error);
+}

package/dist-lib/lib/simple-packing.d.ts

@@ -14,16 +14,14 @@ export interface SimplePacking {
     loadCarrier: string;
 }
 export declare const EMPTY_SIMPLE_PACKING: SimplePacking;
-/** Floriday-ladingdrager → code van de Engine (load_carrier_types.code). */
-export declare const ENGINE_CARRIER_CODE: Record<string, string>;
 /** Namen van de velden die nog ontbreken of ongeldig zijn (leeg = compleet). */
 export declare function missingPackingFields(p: SimplePacking): string[];
 /** Hoofdverpakking voor product_packings; gooit als iets ontbreekt. */
 export declare function simplePackingToRow(p: SimplePacking): ProductPackingRow;
 /** Regel voor logistics_product_oordeel_belading (Engine). */
-export declare function engineOordeelRegel(productId: string, p: SimplePacking): {
+export declare function engineOordeelRegel(productId: string, p: SimplePacking, engineCarrierCode: string | null): {
     product_id: string;
-    carrier_code: string;
+    carrier_code: string | null;
     plants_per_crate: number | null;
     crates_per_layer: number | null;
     layers_per_cart: number | null;

package/dist-lib/lib/simple-packing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simple-packing.d.ts","sourceRoot":"","sources":["../../src/lib/simple-packing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,oBAAoB,EAAE,aAMlC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAC;AAOF,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAQ/D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,GAAG,iBAAiB,CActE;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa;;;;;;EAQrE"}
+{"version":3,"file":"simple-packing.d.ts","sourceRoot":"","sources":["../../src/lib/simple-packing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,oBAAoB,EAAE,aAMlC,CAAC;AAUF,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAQ/D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,GAAG,iBAAiB,CActE;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;;;;;;EAQvG"}

package/dist-lib/lib/simple-packing.js

@@ -5,15 +5,8 @@ export const EMPTY_SIMPLE_PACKING = {
     layersPerLoadCarrier: "",
     loadCarrier: "",
 };
-/** Floriday-ladingdrager → code van de Engine (load_carrier_types.code). */
-export const ENGINE_CARRIER_CODE = {
-    AUCTION_TROLLEY: "trolley",
-    DANISH_TROLLEY: "danish_container",
-    EURO_TROLLEY: "euro_rolcontainer",
-    PALLET: "pallet",
-    EURO_PALLET: "euro_pallet",
-    NONE: "loose",
-};
+// De vertaling Floriday-ladingdrager → Engine-code komt alleen van de Engine
+// (zie ../lib/engine-carrier.ts); hier staat bewust geen eigen lijst.
 function posInt(v) {
     const n = Number(String(v).trim());
     return Number.isInteger(n) && n > 0 ? n : null;
@@ -29,7 +22,7 @@ export function missingPackingFields(p) {
         out.push("fusten per laag");
     if (posInt(p.layersPerLoadCarrier) === null)
         out.push("lagen per kar");
-    if (!ENGINE_CARRIER_CODE[p.loadCarrier])
+    if (!p.loadCarrier.trim())
         out.push("ladingdrager");
     return out;
 }
@@ -51,10 +44,10 @@ export function simplePackingToRow(p) {
     };
 }
 /** Regel voor logistics_product_oordeel_belading (Engine). */
-export function engineOordeelRegel(productId, p) {
+export function engineOordeelRegel(productId, p, engineCarrierCode) {
     return {
         product_id: productId,
-        carrier_code: ENGINE_CARRIER_CODE[p.loadCarrier] ?? null,
+        carrier_code: engineCarrierCode,
         plants_per_crate: posInt(p.piecesPerPackage),
         crates_per_layer: posInt(p.packagesPerLayer),
         layers_per_cart: posInt(p.layersPerLoadCarrier),

package/dist-lib/lib/stock-save.d.ts

@@ -29,4 +29,15 @@ export type AfboekReden = (typeof AFBOEK_REDENEN)[number]["value"];
 export declare function afboekFout(aantal: number, reden: string | null, liggend: number): string | null;
 /** Melding na een geslaagde lokale opslag van een Floriday-artikel. */
 export declare function floridayNaOpslaanTekst(isFloridayArtikel: boolean, poortOpen: boolean | null): string | null;
+/**
+ * 1.0.140: alleen een bevestiging van de database ({ opgeslagen: true }) telt
+ * als opgeslagen. Alles anders (fout, leeg antwoord, teruggedraaid) = mislukt.
+ */
+export declare function opslagBevestigd(result: unknown): boolean;
+export declare const OPSLAAN_MISLUKT_TEKST = "Opslaan mislukt, er is niets gewijzigd";
+/** Melding na opslaan; null-resultaat of fout = mislukt (waarden terugzetten). */
+export declare function opslaanMelding(result: unknown, isFloridayArtikel: boolean): {
+    ok: boolean;
+    tekst: string;
+};
 //# sourceMappingURL=stock-save.d.ts.map

package/dist-lib/lib/stock-save.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stock-save.d.ts","sourceRoot":"","sources":["../../src/lib/stock-save.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAG3F;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;EAKjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAEnE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/F;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAI3G"}
+{"version":3,"file":"stock-save.d.ts","sourceRoot":"","sources":["../../src/lib/stock-save.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAG3F;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;EAKjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAEnE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/F;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAI3G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAExD;AAED,eAAO,MAAM,qBAAqB,2CAA2C,CAAC;AAE9E,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK1G"}

package/dist-lib/lib/stock-save.js

@@ -26,3 +26,20 @@ export function floridayNaOpslaanTekst(isFloridayArtikel, poortOpen) {
         return null;
     return "Lokaal opgeslagen. Er gaat niets naar Floriday: versturen staat uit.";
 }
+/**
+ * 1.0.140: alleen een bevestiging van de database ({ opgeslagen: true }) telt
+ * als opgeslagen. Alles anders (fout, leeg antwoord, teruggedraaid) = mislukt.
+ */
+export function opslagBevestigd(result) {
+    return !!result && typeof result === "object" && result.opgeslagen === true;
+}
+export const OPSLAAN_MISLUKT_TEKST = "Opslaan mislukt, er is niets gewijzigd";
+/** Melding na opslaan; null-resultaat of fout = mislukt (waarden terugzetten). */
+export function opslaanMelding(result, isFloridayArtikel) {
+    if (!opslagBevestigd(result))
+        return { ok: false, tekst: OPSLAAN_MISLUKT_TEKST };
+    const klaar = result.floriday_klaargezet_toegestaan === true;
+    if (isFloridayArtikel && !klaar)
+        return { ok: true, tekst: "Opgeslagen; er is niets naar Floriday gestuurd." };
+    return { ok: true, tekst: "Voorraad opgeslagen" };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowselections/floriday-voorraad",
-  "version": "1.0.139",
+  "version": "1.0.143",
   "sideEffects": false,
   "type": "module",
   "main": "./dist-lib/index.js",
@@ -32,6 +32,8 @@
     "preview": "vite preview",
     "lint": "eslint .",
     "test": "vitest run",
+    "check:schema": "node scripts/check-schema-version.mjs",
+    "prepublishOnly": "node scripts/check-schema-version.mjs",
     "test:watch": "vitest"
   },
   "peerDependencies": {
@@ -49,7 +51,7 @@
   "devDependencies": {
     "@cloudflare/vite-plugin": "^1.25.5",
     "@eslint/js": "^9.32.0",
-    "@flowselections/core": "1.0.34",
+    "@flowselections/core": "1.0.35",
     "@lovable.dev/vite-tanstack-config": "2.26.5",
     "@rsbuild/core": "^1.0.0",
     "@tailwindcss/vite": "^4.2.1",

package/sql/AGENTS.md

@@ -5,3 +5,7 @@
 - An order line counts as cancelled for fust when `order_items.quarantined_at` is set or its order is cancelled (`voorraad_order_geannuleerd`: status geannuleerd/cancelled case-insensitive, `cancelled_at` or `deleted_at`): `sync_order_item_fusten` wants 0 and triggers on order_items (quarantine on/off) and orders (those three fields) book the difference against the line's own bookings, because quarantined or cancelled orders otherwise kept fust booked.
 - The correct fust count per order line comes only from `voorraad_fust_juist(order_item_id)` (same rule as `sync_order_item_fusten`; removed, quarantined, externally fulfilled or cancelled = 0); fust corrections compare against it, because every hand-built copy of the rule drifted.
 - Local stock saves never depend on the Floriday write gate: every Voorraad queue insert first checks `voorraad_floriday_klaarzetten_toegestaan()` and runs in its own exception block, because the Engine gate trigger raises and rolled back the local save.
+- A note per stock change travels via tx setting `stock.change_note` (read by the deferred log trigger at commit, so never clear it inside the call); `trade_item_stock.notes` is the fixed article note and changes only when the caller asks (`stock.keep_notes`), because appending each save stacked notes.
+- `sql/floriday-voorraad-schema.sql` must name the newest `supabase/migrations` file in its "Laatste migratie" header and contain the required objects; `scripts/check-schema-version.mjs` (prepublishOnly + test) blocks publishing otherwise; the header version is informational and never higher than package.json, because 1.0.139 shipped a stale schema and the dashboard bumps versions without schema changes.
+- Default data only via `voorraad_ensure_defaults()` (system data upserted by code keeping `naam_aangepast`, retired codes set inactive; customer settings only inserted when missing, with column defaults equal to reader fallbacks); bump `voorraad_defaults_versie()` on every list change, because new shells get the schema without data and the fast exit compares that version.
+- Load carrier → Engine code only via the Engine's `logistics_ladingdrager_resolve`; no own mapping list or fallback, because two lists drift.