@ketvietlab/ketsuite 0.1.25 → 0.1.30

package/dist/modules/stock_backend/routes.js

@@ -1,3 +1,11 @@
+import { stockOverviewScreen } from './screens/overview.js';
+import { transferContext } from './modal/transfer-context.js';
+import { inventoryCountContext } from './modal/inventory-context.js';
+import { stockConfigurationContext } from './modal/configuration-context.js';
+import { recordModalCreateHref, recordModalHref } from '../../ui/record-modal.js';
+import { optionalRead } from '../backend/optional-read.js';
+import { rowListSearch } from '../backend/row-list.js';
+import { inventoryListSearch, locationListSearch, lotListSearch, pickingTypeListSearch, replenishmentListSearch, stockRouteListSearch, transferListSearch, warehouseListSearch, } from './search.js';
 import { randomUUID } from 'node:crypto';
 import { fragment, json, NAVIGATION_TYPE, text, withHeaders } from '@ketvietlab/ketjs';
 import { backendPage, formatDateTime, modalWorkspace } from '../../ui/index.js';
@@ -28,6 +36,33 @@ const refusePost = (req, accepts = 'POST') => req.method !== 'POST'
         : null;
 import { adminPage, frameOf, inLocale, printGroup } from '../backend/screen.js';
 import { selectionLabel as resolveSelection } from '../backend/screen.js';
+/**
+ * A group heading in the reader's language: a selection code reads as its
+ * label, anything else — a warehouse or location name — reads as itself.
+ */
+const GROUP_MESSAGES = {
+    state: 'state',
+    usage: 'usage',
+    code: 'pickingType',
+    createBackorder: 'backorder',
+    trigger: 'trigger',
+    receptionSteps: 'receptionSteps',
+    deliverySteps: 'deliverySteps',
+};
+const stockGroupLabel = (_, key, value) => {
+    const raw = value == null ? '' : String(value);
+    if (!raw)
+        return _('backend.chrome.groupEmpty');
+    const message = `stock_backend.${GROUP_MESSAGES[key] ?? key}.${raw}`;
+    return _.resolves(message) ? _(message) : raw;
+};
+/** Every stock list shares one set of search-filter functions; see `functions.ts`. */
+const stockSearchFunctions = {
+    apply: 'stock_backend.applySearchFilter',
+    saveFavorite: 'stock_backend.saveSearchFavorite',
+    deleteFavorite: 'stock_backend.deleteSearchFavorite',
+    setDefaultFavorite: 'stock_backend.setDefaultSearchFavorite',
+};
 const options = (rows) => rows.map((row) => ({ value: String(row.id), label: String(row.name) }));
 /** A stable stock code in the reader's language; the code itself survives as data. */
 const selectionLabel = (_, group, value) => resolveSelection(_, 'stock_backend', group, value);
@@ -120,12 +155,12 @@ const dateTimeLabel = (value, lang) => {
 const common = async (ctx, url, req) => {
     const _ = ctx.translate(ctx.localeOf(url, req));
     const [warehouses, locations, pickingTypes, lots, routes, units] = (await Promise.all([
-        ctx.call('stock.listWarehouses', {}, url, req),
-        ctx.call('stock.listLocations', {}, url, req),
-        ctx.call('stock.listPickingTypes', {}, url, req),
-        ctx.call('stock.listLots', {}, url, req),
-        ctx.call('stock.listRoutes', {}, url, req),
-        ctx.call('uom.listUnits', {}, url, req),
+        optionalRead(ctx, 'stock.listWarehouses', {}, url, req, []),
+        optionalRead(ctx, 'stock.listLocations', {}, url, req, []),
+        optionalRead(ctx, 'stock.listPickingTypes', {}, url, req, []),
+        optionalRead(ctx, 'stock.listLots', {}, url, req, []),
+        optionalRead(ctx, 'stock.listRoutes', {}, url, req, []),
+        optionalRead(ctx, 'uom.listUnits', {}, url, req, []),
     ]));
     return {
         warehouses,
@@ -137,6 +172,27 @@ const common = async (ctx, url, req) => {
     };
 };
 export const routes = {
+    '/admin/stock': (ctx) => async (url, req) => {
+        if (req.method !== 'GET')
+            return text('GET', { status: 405 });
+        const rows = (await ctx.call('stock.listPickings', {}, url, req));
+        return adminPage(ctx, url, req, {
+            title: 'stock_backend.overview.title',
+            body: async (_, frame) => stockOverviewScreen(_, frame, {
+                rows,
+                at: (path) => inLocale(url, path),
+                rowHref: (row) => recordModalHref(url, { kind: 'stock.transfer', id: String(row.id) }),
+                createHref: (await ctx.allows('stock.createPicking', url, req))
+                    ? recordModalCreateHref(new URL(inLocale(url, '/admin/stock/transfers'), url), {
+                        kind: 'stock.transfer',
+                    })
+                    : null,
+            }),
+        });
+    },
+    '/admin/stock/transfer/{id}/context': transferContext,
+    '/admin/stock/count/{id}/context': inventoryCountContext,
+    '/admin/stock/record/{kind}/{id}/context': stockConfigurationContext,
     '/admin/stock/inventory': (ctx) => async (url, req) => {
         const lang = ctx.localeOf(url, req);
         const _ = ctx.translate(lang);
@@ -196,18 +252,35 @@ export const routes = {
         });
         return adminPage(ctx, url, req, {
             title: 'stock_backend.inventory',
-            body: (_, frame) => inventoryScreen(_, {
-                rows,
-                products: products.map(({ value, label }) => ({ value, label })),
-                locations: options(data.locations.filter((row) => row.usage === 'internal')),
-                inventoryLocations: options(data.locations.filter((row) => row.usage === 'inventory')),
-                units: options(data.units),
-                lots: options(data.lots),
-                action: inLocale(url, '/admin/stock/inventory'),
-                locationsHref: inLocale(url, '/admin/stock/locations'),
-                applied: url.searchParams.has('applied'),
-                errors: invalid(url, _),
-            }, frame),
+            body: async (_, frame) => {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: inventoryListSearch,
+                    rows,
+                    frame,
+                    name: 'stock-inventory-filter',
+                    bodyId: 'stock-inventory-list',
+                    functions: stockSearchFunctions,
+                });
+                return inventoryScreen(_, {
+                    rows: search.rows,
+                    createHref: (await ctx.allows('stock.adjustInventory', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.count' })
+                        : null,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.count', id: row.id }),
+                    },
+                    products: products.map(({ value, label }) => ({ value, label })),
+                    locations: options(data.locations.filter((row) => row.usage === 'internal')),
+                    inventoryLocations: options(data.locations.filter((row) => row.usage === 'inventory')),
+                    units: options(data.units),
+                    lots: options(data.lots),
+                    action: inLocale(url, '/admin/stock/inventory'),
+                    locationsHref: inLocale(url, '/admin/stock/locations'),
+                    applied: url.searchParams.has('applied'),
+                    errors: invalid(url, _),
+                }, search.frame);
+            },
         });
     },
     '/admin/stock/transfers': (ctx) => async (url, req) => {
@@ -238,19 +311,34 @@ export const routes = {
         const pickingTypesById = new Map(data.pickingTypes.map((row) => [String(row.id), String(row.name)]));
         return adminPage(ctx, url, req, {
             title: 'stock_backend.transfers',
-            body: (_, frame) => transfersListScreen(_, {
-                rows: pickings.map((row) => ({
-                    id: String(row.id),
-                    name: String(row.name),
-                    operationType: pickingTypesById.get(String(row.pickingTypeId)) ?? String(row.pickingTypeId),
-                    source: locationsById.get(String(row.locationId)) ?? String(row.locationId),
-                    destination: locationsById.get(String(row.locationDestId)) ?? String(row.locationDestId),
-                    scheduledDate: dateTimeLabel(row.scheduledDate, lang),
-                    state: String(row.state),
-                    href: inLocale(url, `/admin/stock/transfers/${String(row.id)}`),
-                })),
-                createHref: inLocale(url, '/admin/stock/transfers/new'),
-            }, frame),
+            body: async (_, frame) => {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: transferListSearch,
+                    frame,
+                    rows: pickings.map((row) => ({
+                        id: String(row.id),
+                        name: String(row.name),
+                        operationType: pickingTypesById.get(String(row.pickingTypeId)) ?? String(row.pickingTypeId),
+                        source: locationsById.get(String(row.locationId)) ?? String(row.locationId),
+                        destination: locationsById.get(String(row.locationDestId)) ?? String(row.locationDestId),
+                        scheduledDate: dateTimeLabel(row.scheduledDate, lang),
+                        state: String(row.state),
+                        href: recordModalHref(url, { kind: 'stock.transfer', id: String(row.id) }),
+                    })),
+                    name: 'stock-transfer-filter',
+                    bodyId: 'stock-transfer-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.transfers') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                return transfersListScreen(_, {
+                    rows: search.rows,
+                    ...(search.groups ? { table: { groups: search.groups } } : {}),
+                    createHref: (await ctx.allows('stock.createPicking', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.transfer' })
+                        : null,
+                }, search.frame);
+            },
         });
     },
     '/admin/stock/transfers/new': (ctx) => async (url, req) => {
@@ -459,12 +547,16 @@ export const routes = {
         }
         if (req.method !== 'GET')
             return text('GET or POST', { status: 405 });
+        if (!(await ctx.allows('stock.listWarehouses', url, req)))
+            return text('Forbidden', { status: 403 });
         const rows = (await ctx.call('stock.listWarehouses', {}, url, req));
         return adminPage(ctx, url, req, {
             title: 'stock_backend.warehouses',
-            body: (_, frame) => {
+            body: async (_, frame) => {
                 const collection = inLocale(url, '/admin/stock/warehouses');
-                const list = warehousesListScreen(_, {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: warehouseListSearch,
+                    frame,
                     rows: rows.map((row) => ({
                         id: String(row.id),
                         name: String(row.name),
@@ -472,8 +564,22 @@ export const routes = {
                         receptionSteps: String(row.receptionSteps),
                         deliverySteps: String(row.deliverySteps),
                     })),
-                    createHref: createModalHref(url, '/admin/stock/warehouses'),
-                }, frame);
+                    name: 'stock-warehouse-filter',
+                    bodyId: 'stock-warehouse-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.warehouses') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                const list = warehousesListScreen(_, {
+                    rows: search.rows,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.warehouse', id: String(row.id) }),
+                    },
+                    createHref: (await ctx.allows('stock.saveWarehouse', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.warehouse' })
+                        : null,
+                }, search.frame);
                 return createModalOpen(url)
                     ? modalWorkspace(list, warehouseCreateModal(_, {
                         action: inLocale(url, '/admin/stock/warehouses/new'),
@@ -526,22 +632,40 @@ export const routes = {
         }
         if (req.method !== 'GET')
             return text('GET or POST', { status: 405 });
+        if (!(await ctx.allows('stock.listLocations', url, req)))
+            return text('Forbidden', { status: 403 });
         const data = await common(ctx, url, req);
         const nameById = new Map(data.locations.map((row) => [String(row.id), String(row.name)]));
         const warehouseById = new Map(data.warehouses.map((row) => [String(row.id), String(row.name)]));
         return adminPage(ctx, url, req, {
             title: 'stock_backend.locations',
-            body: (_, frame) => {
+            body: async (_, frame) => {
                 const collection = inLocale(url, '/admin/stock/locations');
-                const list = locationsListScreen(_, {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: locationListSearch,
+                    frame,
                     rows: data.locations.map((row) => ({
                         id: String(row.id),
                         completeName: completeLocationName(row, nameById),
                         usage: String(row.usage),
                         warehouse: warehouseById.get(String(row.warehouseId)) ?? '',
                     })),
-                    createHref: createModalHref(url, '/admin/stock/locations'),
-                }, frame);
+                    name: 'stock-location-filter',
+                    bodyId: 'stock-location-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.locations') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                const list = locationsListScreen(_, {
+                    rows: search.rows,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.location', id: String(row.id) }),
+                    },
+                    createHref: (await ctx.allows('stock.saveLocation', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.location' })
+                        : null,
+                }, search.frame);
                 if (!createModalOpen(url))
                     return list;
                 return modalWorkspace(list, locationCreateModal(_, {
@@ -601,15 +725,19 @@ export const routes = {
         }
         if (req.method !== 'GET')
             return text('GET or POST', { status: 405 });
+        if (!(await ctx.allows('stock.listPickingTypes', url, req)))
+            return text('Forbidden', { status: 403 });
         const data = await common(ctx, url, req);
         const rawLocationNameById = new Map(data.locations.map((row) => [String(row.id), String(row.name)]));
         const completeLocationNameById = new Map(data.locations.map((row) => [String(row.id), completeLocationName(row, rawLocationNameById)]));
         const warehouseById = new Map(data.warehouses.map((row) => [String(row.id), String(row.name)]));
         return adminPage(ctx, url, req, {
             title: 'stock_backend.pickingTypes',
-            body: (_, frame) => {
+            body: async (_, frame) => {
                 const collection = inLocale(url, '/admin/stock/picking-types');
-                const list = pickingTypesListScreen(_, {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: pickingTypeListSearch,
+                    frame,
                     rows: data.pickingTypes.map((row) => ({
                         id: String(row.id),
                         name: String(row.name),
@@ -619,8 +747,22 @@ export const routes = {
                         destination: completeLocationNameById.get(String(row.defaultLocationDestId)) ?? '',
                         createBackorder: String(row.createBackorder ?? 'ask'),
                     })),
-                    createHref: createModalHref(url, '/admin/stock/picking-types'),
-                }, frame);
+                    name: 'stock-picking-type-filter',
+                    bodyId: 'stock-picking-type-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.pickingTypes') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                const list = pickingTypesListScreen(_, {
+                    rows: search.rows,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.pickingType', id: String(row.id) }),
+                    },
+                    createHref: (await ctx.allows('stock.savePickingType', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.pickingType' })
+                        : null,
+                }, search.frame);
                 if (!createModalOpen(url))
                     return list;
                 return modalWorkspace(list, pickingTypeCreateModal(_, {
@@ -703,9 +845,11 @@ export const routes = {
         });
         return adminPage(ctx, url, req, {
             title: 'stock_backend.lots',
-            body: (_, frame) => {
+            body: async (_, frame) => {
                 const collection = inLocale(url, '/admin/stock/lots');
-                const list = lotsListScreen(_, {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: lotListSearch,
+                    frame,
                     rows: lots.map((row) => ({
                         id: String(row.id),
                         name: String(row.name),
@@ -716,8 +860,22 @@ export const routes = {
                         active: row.active !== false,
                         href: inLocale(url, `/admin/stock/lots/${String(row.id)}`),
                     })),
-                    createHref: createModalHref(url, '/admin/stock/lots'),
-                }, frame);
+                    name: 'stock-lot-filter',
+                    bodyId: 'stock-lot-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.lots') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                const list = lotsListScreen(_, {
+                    rows: search.rows,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.lot', id: String(row.id) }),
+                    },
+                    createHref: (await ctx.allows('stock.saveLot', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.lot' })
+                        : null,
+                }, search.frame);
                 return createModalOpen(url)
                     ? modalWorkspace(list, lotCreateModal(_, {
                         products: productOptions,
@@ -876,9 +1034,11 @@ export const routes = {
         }
         return adminPage(ctx, url, req, {
             title: 'stock_backend.routes',
-            body: (_, frame) => {
+            body: async (_, frame) => {
                 const collection = inLocale(url, '/admin/stock/routes');
-                const list = stockRoutesListScreen(_, {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: stockRouteListSearch,
+                    frame,
                     rows: rows.map((row) => ({
                         id: String(row.id),
                         name: localizedGeneratedRouteName(_, row),
@@ -886,8 +1046,22 @@ export const routes = {
                         ruleCount: ruleCountByRoute.get(String(row.id)) ?? 0,
                         href: inLocale(url, `/admin/stock/routes/${String(row.id)}`),
                     })),
-                    createHref: createModalHref(url, '/admin/stock/routes'),
-                }, frame);
+                    name: 'stock-route-filter',
+                    bodyId: 'stock-route-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.routes') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                const list = stockRoutesListScreen(_, {
+                    rows: search.rows,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.route', id: String(row.id) }),
+                    },
+                    createHref: (await ctx.allows('stock.saveRoute', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.route' })
+                        : null,
+                }, search.frame);
                 return createModalOpen(url)
                     ? modalWorkspace(list, stockRouteCreateModal(_, {
                         action: inLocale(url, '/admin/stock/routes/new'),
@@ -994,6 +1168,7 @@ export const routes = {
         });
     },
     '/admin/stock/replenishment': (ctx) => async (url, req) => {
+        const canRun = await ctx.allows('stock.runOrderpoint', url, req);
         const lang = ctx.localeOf(url, req);
         const _ = ctx.translate(lang);
         if (req.method === 'POST') {
@@ -1039,37 +1214,54 @@ export const routes = {
         const unitRecordById = new Map(data.units.map((row) => [String(row.id), row]));
         return adminPage(ctx, url, req, {
             title: 'stock_backend.replenishment',
-            body: (_, frame) => replenishmentListScreen(_, {
-                rows: points.map((row, index) => {
-                    const forecasted = String(forecasts[index]?.forecasted ?? '0');
-                    const baseUom = unitRecordById.get(productUomById.get(String(row.productId)) ?? '');
-                    const replenishmentUom = unitRecordById.get(String(row.replenishmentUomId ?? productUomById.get(String(row.productId)) ?? ''));
-                    const baseQuantity = Math.max(0, Number(row.maxQuantity) - Number(forecasted));
-                    const rawQuantity = baseUom && replenishmentUom
-                        ? (baseQuantity * Number(baseUom.absoluteFactor)) /
-                            Number(replenishmentUom.absoluteFactor)
-                        : baseQuantity;
-                    const rounding = Math.max(Number(replenishmentUom?.rounding ?? 1), 1e-12);
-                    const quantity = Number(forecasted) < Number(row.minQuantity)
-                        ? Math.ceil(rawQuantity / rounding - 1e-12) * rounding
-                        : 0;
-                    return {
-                        id: String(row.id),
-                        product: productById.get(String(row.productId)) ?? String(row.productId),
-                        warehouse: warehouseById.get(String(row.warehouseId)) ?? String(row.warehouseId),
-                        location: locationById.get(String(row.locationId)) ?? String(row.locationId),
-                        trigger: String(row.trigger),
-                        triggerLabel: selectionLabel(_, 'trigger', row.trigger),
-                        minQuantity: String(row.minQuantity),
-                        maxQuantity: String(row.maxQuantity),
-                        forecasted,
-                        toOrder: String(quantity),
-                        replenishmentUom: unitById.get(String(row.replenishmentUomId)) ?? String(row.replenishmentUomId ?? '—'),
-                        runAction: inLocale(url, `/admin/stock/replenishment/${String(row.id)}/run`),
-                    };
-                }),
-                createHref: inLocale(url, '/admin/stock/replenishment/new'),
-            }, frame),
+            body: async (_, frame) => {
+                const search = await rowListSearch(ctx, url, req, {
+                    spec: replenishmentListSearch,
+                    frame,
+                    rows: points.map((row, index) => {
+                        const forecasted = String(forecasts[index]?.forecasted ?? '0');
+                        const baseUom = unitRecordById.get(productUomById.get(String(row.productId)) ?? '');
+                        const replenishmentUom = unitRecordById.get(String(row.replenishmentUomId ?? productUomById.get(String(row.productId)) ?? ''));
+                        const baseQuantity = Math.max(0, Number(row.maxQuantity) - Number(forecasted));
+                        const rawQuantity = baseUom && replenishmentUom
+                            ? (baseQuantity * Number(baseUom.absoluteFactor)) / Number(replenishmentUom.absoluteFactor)
+                            : baseQuantity;
+                        const rounding = Math.max(Number(replenishmentUom?.rounding ?? 1), 1e-12);
+                        const quantity = Number(forecasted) < Number(row.minQuantity)
+                            ? Math.ceil(rawQuantity / rounding - 1e-12) * rounding
+                            : 0;
+                        return {
+                            id: String(row.id),
+                            product: productById.get(String(row.productId)) ?? String(row.productId),
+                            warehouse: warehouseById.get(String(row.warehouseId)) ?? String(row.warehouseId),
+                            location: locationById.get(String(row.locationId)) ?? String(row.locationId),
+                            trigger: String(row.trigger),
+                            triggerLabel: selectionLabel(_, 'trigger', row.trigger),
+                            minQuantity: String(row.minQuantity),
+                            maxQuantity: String(row.maxQuantity),
+                            forecasted,
+                            toOrder: String(quantity),
+                            replenishmentUom: unitById.get(String(row.replenishmentUomId)) ?? String(row.replenishmentUomId ?? '—'),
+                            runAction: canRun ? inLocale(url, `/admin/stock/replenishment/${String(row.id)}/run`) : null,
+                        };
+                    }),
+                    name: 'stock-replenishment-filter',
+                    bodyId: 'stock-replenishment-list',
+                    functions: stockSearchFunctions,
+                    labels: { searchPlaceholder: _('stock_backend.replenishment') },
+                    groupLabel: (key, value) => stockGroupLabel(_, key, value),
+                });
+                return replenishmentListScreen(_, {
+                    rows: search.rows,
+                    table: {
+                        ...(search.groups ? { groups: search.groups } : {}),
+                        rowHref: (row) => recordModalHref(url, { kind: 'stock.replenishment', id: String(row.id) }),
+                    },
+                    createHref: (await ctx.allows('stock.saveOrderpoint', url, req))
+                        ? recordModalCreateHref(url, { kind: 'stock.replenishment' })
+                        : null,
+                }, search.frame);
+            },
         });
     },
     '/admin/stock/replenishment/new': (ctx) => async (url, req) => {