@floristcloud/api-lib 1.2.137 → 1.2.139

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

@@ -3,10 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PriceCorrectionAnalyzeContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../../schemas");
+const PRICE_CORRECTION_ANALYZE_DEFAULT_LIMIT = 200;
+const PRICE_CORRECTION_ANALYZE_MAX_LIMIT = 1000;
 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),
+    // Страница обязательна по смыслу, а не по схеме: строк здесь товары × заказы, то есть
+    // десятки тысяч на партию, и безлимитная выдача кладёт запрос независимо от того, сколько
+    // из неё нарисует таблица. Усечение при этом урезает только предпросмотр — execute в
+    // scope-форме пересобирает набор на сервере и списком из analyze не пользуется.
+    page: zod_1.z.number().int().positive().optional().default(1),
+    limit: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(PRICE_CORRECTION_ANALYZE_MAX_LIMIT)
+        .optional()
+        .default(PRICE_CORRECTION_ANALYZE_DEFAULT_LIMIT),
 })
     .refine(data => { var _a; return ((_a = data.productUUIDList) === null || _a === void 0 ? void 0 : _a.length) || data.consignmentUUID; }, {
     message: 'validation.productListOrConsignment',
@@ -15,11 +33,15 @@ const PriceCorrectionAnalyzeResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: zod_1.z.object({
         items: zod_1.z.array(schemas_1.PriceCorrectionAnalyzeItemSchema),
+        // Сколько строк во всём наборе после фильтра `onlyChanged`, а не на странице.
+        total: zod_1.z.number(),
     }),
 });
 var PriceCorrectionAnalyzeContractCommand;
 (function (PriceCorrectionAnalyzeContractCommand) {
     PriceCorrectionAnalyzeContractCommand.RequestSchema = PriceCorrectionAnalyzeRequestSchema;
+    PriceCorrectionAnalyzeContractCommand.DEFAULT_LIMIT = PRICE_CORRECTION_ANALYZE_DEFAULT_LIMIT;
+    PriceCorrectionAnalyzeContractCommand.MAX_LIMIT = PRICE_CORRECTION_ANALYZE_MAX_LIMIT;
     PriceCorrectionAnalyzeContractCommand.ItemSchema = schemas_1.PriceCorrectionAnalyzeItemSchema;
     PriceCorrectionAnalyzeContractCommand.ResponseSchema = PriceCorrectionAnalyzeResponseSchema;
 })(PriceCorrectionAnalyzeContractCommand || (exports.PriceCorrectionAnalyzeContractCommand = PriceCorrectionAnalyzeContractCommand = {}));

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

@@ -4,21 +4,54 @@ 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),
+// Потолок на число строк в ответе scope-формы. Ошибки не обязаны быть редкими: коррекция старой
+// партии, где все заказы закрыты, даёт отказ по статусу на каждую позицию, и без потолка ответ
+// снова становится O(позиций). Сколько их всего — видно по `skippedCount` и разбивке `orders`.
+const PRICE_CORRECTION_RESULTS_LIMIT = 200;
+/**
+ * Две формы адресации, ровно одна на запрос.
+ *
+ * `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(),
+    // Снять товар целиком — одним uuid, а не списком всех его позиций: иначе запрос снова
+    // становится O(позиций), от чего и уходили.
+    excludeProductUUIDList: 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(),
+        // `results` в scope-форме обрезан по лимиту. Полные числа — в счётчиках и в `orders`.
+        isTruncated: zod_1.z.boolean(),
     }),
 });
 var PriceCorrectionExecuteContractCommand;
 (function (PriceCorrectionExecuteContractCommand) {
     PriceCorrectionExecuteContractCommand.RequestSchema = PriceCorrectionExecuteRequestSchema;
     PriceCorrectionExecuteContractCommand.BATCH_LIMIT = PRICE_CORRECTION_BATCH_LIMIT;
+    PriceCorrectionExecuteContractCommand.RESULTS_LIMIT = PRICE_CORRECTION_RESULTS_LIMIT;
     PriceCorrectionExecuteContractCommand.ResponseSchema = PriceCorrectionExecuteResponseSchema;
 })(PriceCorrectionExecuteContractCommand || (exports.PriceCorrectionExecuteContractCommand = PriceCorrectionExecuteContractCommand = {}));

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/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

@@ -1,10 +1,30 @@
 import { z } from 'zod';
 import { PriceCorrectionAnalyzeItemSchema } from '../../../schemas';
 
+const PRICE_CORRECTION_ANALYZE_DEFAULT_LIMIT = 200;
+const PRICE_CORRECTION_ANALYZE_MAX_LIMIT = 1000;
+
 const PriceCorrectionAnalyzeRequestSchema = z
     .object({
         productUUIDList: z.array(z.string().uuid()).optional(),
         consignmentUUID: z.string().uuid().optional(),
+        // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
+        // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
+        // список — режим «показать всё».
+        onlyChanged: z.boolean().optional().default(true),
+
+        // Страница обязательна по смыслу, а не по схеме: строк здесь товары × заказы, то есть
+        // десятки тысяч на партию, и безлимитная выдача кладёт запрос независимо от того, сколько
+        // из неё нарисует таблица. Усечение при этом урезает только предпросмотр — execute в
+        // scope-форме пересобирает набор на сервере и списком из analyze не пользуется.
+        page: z.number().int().positive().optional().default(1),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(PRICE_CORRECTION_ANALYZE_MAX_LIMIT)
+            .optional()
+            .default(PRICE_CORRECTION_ANALYZE_DEFAULT_LIMIT),
     })
     .refine(data => data.productUUIDList?.length || data.consignmentUUID, {
         message: 'validation.productListOrConsignment',
@@ -14,6 +34,8 @@ const PriceCorrectionAnalyzeResponseSchema = z.object({
     message: z.string().optional(),
     data: z.object({
         items: z.array(PriceCorrectionAnalyzeItemSchema),
+        // Сколько строк во всём наборе после фильтра `onlyChanged`, а не на странице.
+        total: z.number(),
     }),
 });
 
@@ -21,6 +43,9 @@ export namespace PriceCorrectionAnalyzeContractCommand {
     export const RequestSchema = PriceCorrectionAnalyzeRequestSchema;
     export type Request = z.infer<typeof RequestSchema>;
 
+    export const DEFAULT_LIMIT = PRICE_CORRECTION_ANALYZE_DEFAULT_LIMIT;
+    export const MAX_LIMIT = PRICE_CORRECTION_ANALYZE_MAX_LIMIT;
+
     export const ItemSchema = PriceCorrectionAnalyzeItemSchema;
     export type Item = z.infer<typeof ItemSchema>;
 

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

@@ -1,19 +1,56 @@
 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(),
-});
+// Потолок на число строк в ответе scope-формы. Ошибки не обязаны быть редкими: коррекция старой
+// партии, где все заказы закрыты, даёт отказ по статусу на каждую позицию, и без потолка ответ
+// снова становится O(позиций). Сколько их всего — видно по `skippedCount` и разбивке `orders`.
+const PRICE_CORRECTION_RESULTS_LIMIT = 200;
+
+/**
+ * Две формы адресации, ровно одна на запрос.
+ *
+ * `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(),
+        // Снять товар целиком — одним uuid, а не списком всех его позиций: иначе запрос снова
+        // становится O(позиций), от чего и уходили.
+        excludeProductUUIDList: 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(),
+        // `results` в scope-форме обрезан по лимиту. Полные числа — в счётчиках и в `orders`.
+        isTruncated: z.boolean(),
     }),
 });
 
@@ -22,6 +59,7 @@ export namespace PriceCorrectionExecuteContractCommand {
     export type Request = z.infer<typeof RequestSchema>;
 
     export const BATCH_LIMIT = PRICE_CORRECTION_BATCH_LIMIT;
+    export const RESULTS_LIMIT = PRICE_CORRECTION_RESULTS_LIMIT;
 
     export const ResponseSchema = PriceCorrectionExecuteResponseSchema;
     export type Response = z.infer<typeof ResponseSchema>;

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/package.json

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

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(),
+});