@floristcloud/api-lib 1.2.136 → 1.2.138

package/build/commands/order-product/group/price-correction-analyze.command.js

@@ -7,6 +7,10 @@ const PriceCorrectionAnalyzeRequestSchema = zod_1.z
     .object({
     productUUIDList: zod_1.z.array(zod_1.z.string().uuid()).optional(),
     consignmentUUID: zod_1.z.string().uuid().optional(),
+    // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
+    // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
+    // список — режим «показать всё».
+    onlyChanged: zod_1.z.boolean().optional().default(true),
 })
     .refine(data => { var _a; return ((_a = data.productUUIDList) === null || _a === void 0 ? void 0 : _a.length) || data.consignmentUUID; }, {
     message: 'validation.productListOrConsignment',

package/build/commands/order-product/group/price-correction-execute.command.js

@@ -4,14 +4,37 @@ exports.PriceCorrectionExecuteContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../../schemas");
 const PRICE_CORRECTION_BATCH_LIMIT = 50;
-const PriceCorrectionExecuteRequestSchema = zod_1.z.object({
-    orderProductUUIDList: zod_1.z.array(zod_1.z.string().uuid()).min(1).max(PRICE_CORRECTION_BATCH_LIMIT),
+/**
+ * Две формы адресации, ровно одна на запрос.
+ *
+ * `orderProductUUIDList` — точечная правка выбранных позиций (экран заказа), лимит остаётся.
+ * Scope (`consignmentUUID` / `productUUIDList` + `excludeOrderProductUUIDList`) — «выровнять всё,
+ * кроме снятого»: набор собирает сервер тем же правилом, что и analyze, поэтому размер запроса не
+ * зависит от числа позиций и нарезка на пачки на клиенте не нужна.
+ */
+const PriceCorrectionExecuteRequestSchema = zod_1.z
+    .object({
+    orderProductUUIDList: zod_1.z.array(zod_1.z.string().uuid()).min(1).max(PRICE_CORRECTION_BATCH_LIMIT).optional(),
+    consignmentUUID: zod_1.z.string().uuid().optional(),
+    productUUIDList: zod_1.z.array(zod_1.z.string().uuid()).min(1).optional(),
+    excludeOrderProductUUIDList: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+    onlyChanged: zod_1.z.boolean().optional().default(true),
     withDiscount: zod_1.z.boolean(),
-});
+})
+    .refine(data => {
+    var _a, _b;
+    const isListForm = Boolean((_a = data.orderProductUUIDList) === null || _a === void 0 ? void 0 : _a.length);
+    const isScopeForm = Boolean(data.consignmentUUID) || Boolean((_b = data.productUUIDList) === null || _b === void 0 ? void 0 : _b.length);
+    return isListForm !== isScopeForm;
+}, { message: 'validation.orderProductListOrScope' });
 const PriceCorrectionExecuteResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: zod_1.z.object({
+        // Форма `orderProductUUIDList` — строка на каждую позицию запроса. Scope-форма — только
+        // строки, потребовавшие внимания (ошибки и пропуски): успешных там тысячи, и клиент всё
+        // равно перезапрашивает analyze, чтобы обновить таблицу.
         results: zod_1.z.array(schemas_1.PriceCorrectionExecuteResultItemSchema),
+        orders: zod_1.z.array(schemas_1.PriceCorrectionExecuteOrderItemSchema),
         successCount: zod_1.z.number(),
         skippedCount: zod_1.z.number(),
     }),

package/build/constant/error.js

@@ -552,6 +552,25 @@ exports.ERRORS = {
         message: 'Source and destination orders must differ',
         httpCode: 400,
     },
+    // Статус заказа проверяется до отправки пакета и ещё раз внутри транзакции под блокировкой.
+    // Этот код — про вторую проверку: статус сменили, пока пакет ждал строку заказа.
+    ORDER_PRODUCT_PRICE_APPLY_ORDER_STATUS_CHANGED: {
+        code: 'OP026',
+        message: 'Order status changed and no longer allows price change',
+        httpCode: 409,
+    },
+    ORDER_PRODUCT_PRICE_CORRECTION_ALREADY_RUNNING: {
+        code: 'OP027',
+        message: 'Price correction for this consignment is already in progress',
+        httpCode: 409,
+    },
+    // Redis недоступен, то есть исключительность прогона гарантировать нечем. Коррекция поставки
+    // переписывает цены во всех заказах партии — тут отказ безопаснее, чем прогон вслепую.
+    ORDER_PRODUCT_PRICE_CORRECTION_LOCK_UNAVAILABLE: {
+        code: 'OP028',
+        message: 'Cannot guarantee exclusive price correction right now, try again later',
+        httpCode: 503,
+    },
     //TRANSACTION
     TRANSACTION_NOT_CREATED: { code: 'TR001', message: 'Failed to transaction product', httpCode: 500 },
     TRANSACTION_FETCH_FAILED: { code: 'TR002', message: 'Error when retrieving a transaction', httpCode: 500 },

package/build/enum/userRole.enum.js

@@ -6,6 +6,8 @@ var UserRoleEnum;
     UserRoleEnum["ADMIN"] = "ADMIN";
     UserRoleEnum["MANAGER"] = "MANAGER";
     UserRoleEnum["EMPLOYEE"] = "EMPLOYEE";
+    // Warehouse worker: the same panel access as EMPLOYEE, but always sees every client of the company.
+    UserRoleEnum["WAREHOUSE_EMPLOYEE"] = "WAREHOUSE_EMPLOYEE";
     UserRoleEnum["BUYER"] = "BUYER";
 })(UserRoleEnum || (exports.UserRoleEnum = UserRoleEnum = {}));
 var UserPanelRoleEnum;
@@ -13,5 +15,11 @@ var UserPanelRoleEnum;
     UserPanelRoleEnum["ADMIN"] = "ADMIN";
     UserPanelRoleEnum["MANAGER"] = "MANAGER";
     UserPanelRoleEnum["EMPLOYEE"] = "EMPLOYEE";
+    UserPanelRoleEnum["WAREHOUSE_EMPLOYEE"] = "WAREHOUSE_EMPLOYEE";
 })(UserPanelRoleEnum || (exports.UserPanelRoleEnum = UserPanelRoleEnum = {}));
-exports.USER_PANEL_ROLE_LIST = [UserRoleEnum.ADMIN, UserRoleEnum.MANAGER, UserRoleEnum.EMPLOYEE];
+exports.USER_PANEL_ROLE_LIST = [
+    UserRoleEnum.ADMIN,
+    UserRoleEnum.MANAGER,
+    UserRoleEnum.EMPLOYEE,
+    UserRoleEnum.WAREHOUSE_EMPLOYEE,
+];

package/build/schemas/access-policy/access-policy.schema.js

@@ -9,7 +9,11 @@ const userRole_enum_1 = require("../../enum/userRole.enum");
  * it always bypasses UI restrictions, so any ADMIN entry in a policy is dead
  * config. The admin panel must not offer it, and the sanitizer drops it.
  */
-exports.CONFIGURABLE_PANEL_ROLE_LIST = [userRole_enum_1.UserPanelRoleEnum.MANAGER, userRole_enum_1.UserPanelRoleEnum.EMPLOYEE];
+exports.CONFIGURABLE_PANEL_ROLE_LIST = [
+    userRole_enum_1.UserPanelRoleEnum.MANAGER,
+    userRole_enum_1.UserPanelRoleEnum.EMPLOYEE,
+    userRole_enum_1.UserPanelRoleEnum.WAREHOUSE_EMPLOYEE,
+];
 /**
  * A sparse map of permission key -> boolean.
  * Semantics are default-allow: a missing key means "allowed", so in practice

package/build/schemas/index.js

@@ -30,6 +30,7 @@ __exportStar(require("./order-product/order-product-list.schema"), exports);
 __exportStar(require("./order-product/order-product-multiplicity-optiom.schema"), exports);
 __exportStar(require("./order-product/price-correction-analyze-item.schema"), exports);
 __exportStar(require("./order-product/price-correction-execute-result-item.schema"), exports);
+__exportStar(require("./order-product/price-correction-execute-order-item.schema"), exports);
 __exportStar(require("./transaction/transaction.schema"), exports);
 __exportStar(require("./transaction/transaction-list.schema"), exports);
 __exportStar(require("./cash-flow-item/cash-flow-item.schema"), exports);

package/build/schemas/order-product/price-correction-execute-order-item.schema.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriceCorrectionExecuteOrderItemSchema = void 0;
+const zod_1 = require("zod");
+// Итог коррекции по одному заказу. Ради него ответ scope-формы не обязан нести строку на позицию:
+// на тысяче позиций постраничный разбор клиенту не нужен, нужна сводка «в каком заказе что вышло».
+exports.PriceCorrectionExecuteOrderItemSchema = zod_1.z.object({
+    orderUUID: zod_1.z.string(),
+    orderNumber: zod_1.z.number(),
+    successCount: zod_1.z.number(),
+    skippedCount: zod_1.z.number(),
+});

package/commands/order-product/group/price-correction-analyze.command.ts

@@ -5,6 +5,10 @@ const PriceCorrectionAnalyzeRequestSchema = z
     .object({
         productUUIDList: z.array(z.string().uuid()).optional(),
         consignmentUUID: z.string().uuid().optional(),
+        // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
+        // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
+        // список — режим «показать всё».
+        onlyChanged: z.boolean().optional().default(true),
     })
     .refine(data => data.productUUIDList?.length || data.consignmentUUID, {
         message: 'validation.productListOrConsignment',

package/commands/order-product/group/price-correction-execute.command.ts

@@ -1,17 +1,44 @@
 import { z } from 'zod';
-import { PriceCorrectionExecuteResultItemSchema } from '../../../schemas';
+import { PriceCorrectionExecuteOrderItemSchema, PriceCorrectionExecuteResultItemSchema } from '../../../schemas';
 
 const PRICE_CORRECTION_BATCH_LIMIT = 50;
 
-const PriceCorrectionExecuteRequestSchema = z.object({
-    orderProductUUIDList: z.array(z.string().uuid()).min(1).max(PRICE_CORRECTION_BATCH_LIMIT),
-    withDiscount: z.boolean(),
-});
+/**
+ * Две формы адресации, ровно одна на запрос.
+ *
+ * `orderProductUUIDList` — точечная правка выбранных позиций (экран заказа), лимит остаётся.
+ * Scope (`consignmentUUID` / `productUUIDList` + `excludeOrderProductUUIDList`) — «выровнять всё,
+ * кроме снятого»: набор собирает сервер тем же правилом, что и analyze, поэтому размер запроса не
+ * зависит от числа позиций и нарезка на пачки на клиенте не нужна.
+ */
+const PriceCorrectionExecuteRequestSchema = z
+    .object({
+        orderProductUUIDList: z.array(z.string().uuid()).min(1).max(PRICE_CORRECTION_BATCH_LIMIT).optional(),
+
+        consignmentUUID: z.string().uuid().optional(),
+        productUUIDList: z.array(z.string().uuid()).min(1).optional(),
+        excludeOrderProductUUIDList: z.array(z.string().uuid()).optional(),
+        onlyChanged: z.boolean().optional().default(true),
+
+        withDiscount: z.boolean(),
+    })
+    .refine(
+        data => {
+            const isListForm = Boolean(data.orderProductUUIDList?.length);
+            const isScopeForm = Boolean(data.consignmentUUID) || Boolean(data.productUUIDList?.length);
+            return isListForm !== isScopeForm;
+        },
+        { message: 'validation.orderProductListOrScope' },
+    );
 
 const PriceCorrectionExecuteResponseSchema = z.object({
     message: z.string().optional(),
     data: z.object({
+        // Форма `orderProductUUIDList` — строка на каждую позицию запроса. Scope-форма — только
+        // строки, потребовавшие внимания (ошибки и пропуски): успешных там тысячи, и клиент всё
+        // равно перезапрашивает analyze, чтобы обновить таблицу.
         results: z.array(PriceCorrectionExecuteResultItemSchema),
+        orders: z.array(PriceCorrectionExecuteOrderItemSchema),
         successCount: z.number(),
         skippedCount: z.number(),
     }),

package/constant/error.ts

@@ -570,6 +570,25 @@ export const ERRORS = {
         message: 'Source and destination orders must differ',
         httpCode: 400,
     },
+    // Статус заказа проверяется до отправки пакета и ещё раз внутри транзакции под блокировкой.
+    // Этот код — про вторую проверку: статус сменили, пока пакет ждал строку заказа.
+    ORDER_PRODUCT_PRICE_APPLY_ORDER_STATUS_CHANGED: {
+        code: 'OP026',
+        message: 'Order status changed and no longer allows price change',
+        httpCode: 409,
+    },
+    ORDER_PRODUCT_PRICE_CORRECTION_ALREADY_RUNNING: {
+        code: 'OP027',
+        message: 'Price correction for this consignment is already in progress',
+        httpCode: 409,
+    },
+    // Redis недоступен, то есть исключительность прогона гарантировать нечем. Коррекция поставки
+    // переписывает цены во всех заказах партии — тут отказ безопаснее, чем прогон вслепую.
+    ORDER_PRODUCT_PRICE_CORRECTION_LOCK_UNAVAILABLE: {
+        code: 'OP028',
+        message: 'Cannot guarantee exclusive price correction right now, try again later',
+        httpCode: 503,
+    },
 
     //TRANSACTION
     TRANSACTION_NOT_CREATED: { code: 'TR001', message: 'Failed to transaction product', httpCode: 500 },

package/enum/userRole.enum.ts

@@ -2,6 +2,8 @@ export enum UserRoleEnum {
     ADMIN = 'ADMIN',
     MANAGER = 'MANAGER',
     EMPLOYEE = 'EMPLOYEE',
+    // Warehouse worker: the same panel access as EMPLOYEE, but always sees every client of the company.
+    WAREHOUSE_EMPLOYEE = 'WAREHOUSE_EMPLOYEE',
     BUYER = 'BUYER',
 }
 
@@ -9,6 +11,12 @@ export enum UserPanelRoleEnum {
     ADMIN = 'ADMIN',
     MANAGER = 'MANAGER',
     EMPLOYEE = 'EMPLOYEE',
+    WAREHOUSE_EMPLOYEE = 'WAREHOUSE_EMPLOYEE',
 }
 
-export const USER_PANEL_ROLE_LIST: UserRoleEnum[] = [UserRoleEnum.ADMIN, UserRoleEnum.MANAGER, UserRoleEnum.EMPLOYEE];
+export const USER_PANEL_ROLE_LIST: UserRoleEnum[] = [
+    UserRoleEnum.ADMIN,
+    UserRoleEnum.MANAGER,
+    UserRoleEnum.EMPLOYEE,
+    UserRoleEnum.WAREHOUSE_EMPLOYEE,
+];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.136",
+    "version": "1.2.138",
     "description": "",
     "main": "./build/index.js",
     "scripts": {

package/schemas/access-policy/access-policy.schema.ts

@@ -7,7 +7,11 @@ import { UserPanelRoleEnum } from '../../enum/userRole.enum';
  * it always bypasses UI restrictions, so any ADMIN entry in a policy is dead
  * config. The admin panel must not offer it, and the sanitizer drops it.
  */
-export const CONFIGURABLE_PANEL_ROLE_LIST: UserPanelRoleEnum[] = [UserPanelRoleEnum.MANAGER, UserPanelRoleEnum.EMPLOYEE];
+export const CONFIGURABLE_PANEL_ROLE_LIST: UserPanelRoleEnum[] = [
+    UserPanelRoleEnum.MANAGER,
+    UserPanelRoleEnum.EMPLOYEE,
+    UserPanelRoleEnum.WAREHOUSE_EMPLOYEE,
+];
 
 /**
  * A sparse map of permission key -> boolean.

package/schemas/index.ts

@@ -14,6 +14,7 @@ export * from './order-product/order-product-list.schema';
 export * from './order-product/order-product-multiplicity-optiom.schema';
 export * from './order-product/price-correction-analyze-item.schema';
 export * from './order-product/price-correction-execute-result-item.schema';
+export * from './order-product/price-correction-execute-order-item.schema';
 export * from './transaction/transaction.schema';
 export * from './transaction/transaction-list.schema';
 export * from './cash-flow-item/cash-flow-item.schema';

package/schemas/order-product/price-correction-execute-order-item.schema.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+// Итог коррекции по одному заказу. Ради него ответ scope-формы не обязан нести строку на позицию:
+// на тысяче позиций постраничный разбор клиенту не нужен, нужна сводка «в каком заказе что вышло».
+export const PriceCorrectionExecuteOrderItemSchema = z.object({
+    orderUUID: z.string(),
+    orderNumber: z.number(),
+    successCount: z.number(),
+    skippedCount: z.number(),
+});