@floristcloud/api-lib 1.2.140 → 1.2.142

package/build/commands/client/get-client-list.query.js

@@ -16,6 +16,13 @@ const GetClientListRequestSchema = zod_1.z.object({
     searchQuery: zod_1.z.string().optional(),
     sortByBalance: zod_1.z.union([zod_1.z.literal('asc'), zod_1.z.literal('desc')]).optional(),
     responsibleUserUUID: zod_1.z.string().optional(),
+    // Клиенты без ответственного. Отдельный флаг, а не responsibleUserUUID со специальным значением:
+    // в query всё приходит строкой, и «null» пришлось бы отличать от клиента с таким именем.
+    // true — только с ответственным, false — только без него.
+    hasResponsible: zod_1.z
+        .string()
+        .optional()
+        .transform(val => (val === 'true' ? true : val === 'false' ? false : undefined)),
     hasContract: zod_1.z
         .string()
         .optional()

package/build/commands/client/group/assign-group-client-responsible.command.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignGroupClientResponsibleContractCommand = void 0;
+const zod_1 = require("zod");
+const client_responsible_assignment_schema_1 = require("../../../schemas/client/client-responsible-assignment.schema");
+const client_responsible_assignment_result_schema_1 = require("../../../schemas/client/client-responsible-assignment-result.schema");
+const AssignGroupClientResponsibleRequestSchema = client_responsible_assignment_schema_1.ClientResponsibleAssignmentSchema;
+const AssignGroupClientResponsibleResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: client_responsible_assignment_result_schema_1.ClientResponsibleAssignmentResultSchema,
+});
+var AssignGroupClientResponsibleContractCommand;
+(function (AssignGroupClientResponsibleContractCommand) {
+    AssignGroupClientResponsibleContractCommand.RequestSchema = AssignGroupClientResponsibleRequestSchema;
+    AssignGroupClientResponsibleContractCommand.ResponseSchema = AssignGroupClientResponsibleResponseSchema;
+})(AssignGroupClientResponsibleContractCommand || (exports.AssignGroupClientResponsibleContractCommand = AssignGroupClientResponsibleContractCommand = {}));

package/build/commands/client/index.js

@@ -35,3 +35,4 @@ __exportStar(require("./marking/create-client-marking.command"), exports);
 __exportStar(require("./marking/update-client-marking.command"), exports);
 __exportStar(require("./marking/delete-client-marking.command"), exports);
 __exportStar(require("./marking/get-client-marking-by-client-list.command"), exports);
+__exportStar(require("./group/assign-group-client-responsible.command"), exports);

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

@@ -9,10 +9,24 @@ const PriceCorrectionAnalyzeRequestSchema = zod_1.z
     .object({
     productUUIDList: zod_1.z.array(zod_1.z.string().uuid()).optional(),
     consignmentUUID: zod_1.z.string().uuid().optional(),
+    /**
+     * Режим цены — обязателен и без умолчания, как в execute.
+     *
+     * Раньше analyze этого поля не знал и считал `onlyChanged` по OR обоих режимов: строка
+     * попадала в выдачу, если разошлась цена со скидкой ИЛИ без. На клиенте с фиксированной
+     * скидкой это выносило в предпросмотр каждую его позицию — цена строки законно ниже
+     * каталожной ровно на скидку, и «без скидок» это выглядит расхождением. Execute при этом
+     * считает предикат в выбранном режиме, то есть предпросмотр и применение расходились на
+     * целую партию.
+     */
+    withDiscount: zod_1.z.boolean(),
     // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
     // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
     // список — режим «показать всё».
     onlyChanged: zod_1.z.boolean().optional().default(true),
+    // Позиции, которые применить нельзя (статус заказа, заказ в передаточном документе).
+    // `true` — скрыть их из выдачи; сколько их всего, видно по `skippedTotal`.
+    excludeSkipped: zod_1.z.boolean().optional().default(false),
     // Страница обязательна по смыслу, а не по схеме: строк здесь товары × заказы, то есть
     // десятки тысяч на партию, и безлимитная выдача кладёт запрос независимо от того, сколько
     // из неё нарисует таблица. Усечение при этом урезает только предпросмотр — execute в
@@ -33,8 +47,20 @@ 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`, а не на странице.
+        /**
+         * Размер выдачи, а не страницы: по нему листают. Учитывает ВСЕ фильтры запроса, включая
+         * `excludeSkipped`.
+         */
         total: zod_1.z.number(),
+        /**
+         * Сколько строк набора применить нельзя — статус заказа или заказ в передаточном документе.
+         *
+         * Считается по набору после `onlyChanged`, но ДО `excludeSkipped`: иначе при скрытых
+         * непроходных строках это всегда был бы ноль и шапку «столько-то не пройдёт» стало бы не из
+         * чего собрать. Отсюда: применимых строк — `total` при `excludeSkipped: true` и
+         * `total − skippedTotal` при `false`.
+         */
+        skippedTotal: zod_1.z.number(),
     }),
 });
 var PriceCorrectionAnalyzeContractCommand;

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

@@ -42,7 +42,17 @@ const PriceCorrectionExecuteResponseSchema = zod_1.z.object({
         // равно перезапрашивает analyze, чтобы обновить таблицу.
         results: zod_1.z.array(schemas_1.PriceCorrectionExecuteResultItemSchema),
         orders: zod_1.z.array(schemas_1.PriceCorrectionExecuteOrderItemSchema),
+        /**
+         * «Строк в нужной цене после прогона», а не «строк изменено».
+         *
+         * Применение сходящееся: позиция, уже стоящая в нужной цене, — успех, а не отказ, поэтому
+         * повтор запроса и ретрай после таймаута безопасны и дают тот же ответ. Из-за этого при
+         * `onlyChanged: false` в счётчик попадают и нетронутые позиции. При `onlyChanged: true`
+         * таких строк здесь не будет: они отсеиваются до обработки и в счётчики не идут вовсе.
+         */
         successCount: zod_1.z.number(),
+        // Строки, которые прогон не применил: статус заказа, заказ в передаточном документе, отказ
+        // применения. Каждая из них есть в `results` — с точностью до потолка (см. `isTruncated`).
         skippedCount: zod_1.z.number(),
         // `results` в scope-форме обрезан по лимиту. Полные числа — в счётчиках и в `orders`.
         isTruncated: zod_1.z.boolean(),

package/build/constant/client-group-actions.constant.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIENT_GROUP_ACTIONS_LIMITS = void 0;
+exports.CLIENT_GROUP_ACTIONS_LIMITS = {
+    // Верхняя граница на размер группы: панель шлёт выделение со страницы списка,
+    // а необъявленный предел означал бы неограниченный UPDATE по чужому запросу.
+    MAX_CLIENTS_PER_REQUEST: 500,
+};

package/build/constant/error.js

@@ -144,6 +144,11 @@ exports.ERRORS = {
     CLIENT_FETCH_FAILED: { code: 'CL005', message: 'Error when retrieving a list of clients', httpCode: 500 },
     CLIENT_ALREADY_EXIST: { code: 'CL006', message: 'Client with this properties already exist', httpCode: 409 },
     CLIENT_ACCESS_DENIED: { code: 'CL043', message: 'You are not responsible for this client', httpCode: 403 },
+    CLIENT_RESPONSIBLE_USER_NOT_ASSIGNABLE: {
+        code: 'CL045',
+        message: 'The responsible user does not belong to this company or has no panel role',
+        httpCode: 404,
+    },
     CLIENT_EMAIL_ALREADY_EXIST: { code: 'CL007', message: 'Client with this email already exist', httpCode: 409 },
     CLIENT_PHONE_ALREADY_EXIST: { code: 'CL008', message: 'Client with this phone already exist', httpCode: 409 },
     CLIENT_WITH_SAME_USER_ALREADY_EXIST: { code: 'CL009', message: 'Client with same user already exist', httpCode: 409 },

package/build/constant/index.js

@@ -28,3 +28,4 @@ __exportStar(require("./settings.constant"), exports);
 __exportStar(require("./consignment-product-enrichment.constant"), exports);
 __exportStar(require("./attribute-normalization.constant"), exports);
 __exportStar(require("./product-image-merge.constant"), exports);
+__exportStar(require("./client-group-actions.constant"), exports);

package/build/schemas/client/client-responsible-assignment-result.schema.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientResponsibleAssignmentResultSchema = void 0;
+const zod_1 = require("zod");
+// Итог группового переназначения ответственного.
+exports.ClientResponsibleAssignmentResultSchema = zod_1.z.object({
+    // Клиентов, у которых назначение действительно изменилось. Те, у кого ответственный
+    // уже такой, в счёт не попадают — им не переписывается и дата назначения.
+    updatedCount: zod_1.z.number().int().nonnegative(),
+});

package/build/schemas/client/client-responsible-assignment.schema.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientResponsibleAssignmentSchema = void 0;
+const zod_1 = require("zod");
+const client_group_actions_constant_1 = require("../../constant/client-group-actions.constant");
+// Кому и за каких клиентов переназначить ответственность.
+exports.ClientResponsibleAssignmentSchema = zod_1.z.object({
+    clientUUIDList: zod_1.z.array(zod_1.z.uuid()).min(1).max(client_group_actions_constant_1.CLIENT_GROUP_ACTIONS_LIMITS.MAX_CLIENTS_PER_REQUEST),
+    // null — снять ответственного. Поле обязательное: пропуск означал бы «не менять»,
+    // а групповое действие без изменения не имеет смысла и скрывал бы опечатку на фронте.
+    responsibleUserUUID: zod_1.z.uuid().nullable(),
+});

package/build/schemas/client/index.js

@@ -19,3 +19,5 @@ __exportStar(require("./client-individual-profile.schema"), exports);
 __exportStar(require("./client-legal-profile.schema"), exports);
 __exportStar(require("./client-marking.schema"), exports);
 __exportStar(require("./client-debt.schema"), exports);
+__exportStar(require("./client-responsible-assignment.schema"), exports);
+__exportStar(require("./client-responsible-assignment-result.schema"), exports);

package/commands/client/get-client-list.query.ts

@@ -14,6 +14,13 @@ const GetClientListRequestSchema = z.object({
     searchQuery: z.string().optional(),
     sortByBalance: z.union([z.literal('asc'), z.literal('desc')]).optional(),
     responsibleUserUUID: z.string().optional(),
+    // Клиенты без ответственного. Отдельный флаг, а не responsibleUserUUID со специальным значением:
+    // в query всё приходит строкой, и «null» пришлось бы отличать от клиента с таким именем.
+    // true — только с ответственным, false — только без него.
+    hasResponsible: z
+        .string()
+        .optional()
+        .transform(val => (val === 'true' ? true : val === 'false' ? false : undefined)),
     hasContract: z
         .string()
         .optional()

package/commands/client/group/assign-group-client-responsible.command.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { ClientResponsibleAssignmentSchema } from '../../../schemas/client/client-responsible-assignment.schema';
+import { ClientResponsibleAssignmentResultSchema } from '../../../schemas/client/client-responsible-assignment-result.schema';
+
+const AssignGroupClientResponsibleRequestSchema = ClientResponsibleAssignmentSchema;
+
+const AssignGroupClientResponsibleResponseSchema = z.object({
+    message: z.string().optional(),
+    data: ClientResponsibleAssignmentResultSchema,
+});
+
+export namespace AssignGroupClientResponsibleContractCommand {
+    export const RequestSchema = AssignGroupClientResponsibleRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = AssignGroupClientResponsibleResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/client/index.ts

@@ -19,3 +19,4 @@ export * from './marking/create-client-marking.command';
 export * from './marking/update-client-marking.command';
 export * from './marking/delete-client-marking.command';
 export * from './marking/get-client-marking-by-client-list.command';
+export * from './group/assign-group-client-responsible.command';

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

@@ -8,11 +8,28 @@ const PriceCorrectionAnalyzeRequestSchema = z
     .object({
         productUUIDList: z.array(z.string().uuid()).optional(),
         consignmentUUID: z.string().uuid().optional(),
+
+        /**
+         * Режим цены — обязателен и без умолчания, как в execute.
+         *
+         * Раньше analyze этого поля не знал и считал `onlyChanged` по OR обоих режимов: строка
+         * попадала в выдачу, если разошлась цена со скидкой ИЛИ без. На клиенте с фиксированной
+         * скидкой это выносило в предпросмотр каждую его позицию — цена строки законно ниже
+         * каталожной ровно на скидку, и «без скидок» это выглядит расхождением. Execute при этом
+         * считает предикат в выбранном режиме, то есть предпросмотр и применение расходились на
+         * целую партию.
+         */
+        withDiscount: z.boolean(),
+
         // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
         // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
         // список — режим «показать всё».
         onlyChanged: z.boolean().optional().default(true),
 
+        // Позиции, которые применить нельзя (статус заказа, заказ в передаточном документе).
+        // `true` — скрыть их из выдачи; сколько их всего, видно по `skippedTotal`.
+        excludeSkipped: z.boolean().optional().default(false),
+
         // Страница обязательна по смыслу, а не по схеме: строк здесь товары × заказы, то есть
         // десятки тысяч на партию, и безлимитная выдача кладёт запрос независимо от того, сколько
         // из неё нарисует таблица. Усечение при этом урезает только предпросмотр — execute в
@@ -34,8 +51,22 @@ const PriceCorrectionAnalyzeResponseSchema = z.object({
     message: z.string().optional(),
     data: z.object({
         items: z.array(PriceCorrectionAnalyzeItemSchema),
-        // Сколько строк во всём наборе после фильтра `onlyChanged`, а не на странице.
+
+        /**
+         * Размер выдачи, а не страницы: по нему листают. Учитывает ВСЕ фильтры запроса, включая
+         * `excludeSkipped`.
+         */
         total: z.number(),
+
+        /**
+         * Сколько строк набора применить нельзя — статус заказа или заказ в передаточном документе.
+         *
+         * Считается по набору после `onlyChanged`, но ДО `excludeSkipped`: иначе при скрытых
+         * непроходных строках это всегда был бы ноль и шапку «столько-то не пройдёт» стало бы не из
+         * чего собрать. Отсюда: применимых строк — `total` при `excludeSkipped: true` и
+         * `total − skippedTotal` при `false`.
+         */
+        skippedTotal: z.number(),
     }),
 });
 

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

@@ -47,7 +47,19 @@ const PriceCorrectionExecuteResponseSchema = z.object({
         // равно перезапрашивает analyze, чтобы обновить таблицу.
         results: z.array(PriceCorrectionExecuteResultItemSchema),
         orders: z.array(PriceCorrectionExecuteOrderItemSchema),
+
+        /**
+         * «Строк в нужной цене после прогона», а не «строк изменено».
+         *
+         * Применение сходящееся: позиция, уже стоящая в нужной цене, — успех, а не отказ, поэтому
+         * повтор запроса и ретрай после таймаута безопасны и дают тот же ответ. Из-за этого при
+         * `onlyChanged: false` в счётчик попадают и нетронутые позиции. При `onlyChanged: true`
+         * таких строк здесь не будет: они отсеиваются до обработки и в счётчики не идут вовсе.
+         */
         successCount: z.number(),
+
+        // Строки, которые прогон не применил: статус заказа, заказ в передаточном документе, отказ
+        // применения. Каждая из них есть в `results` — с точностью до потолка (см. `isTruncated`).
         skippedCount: z.number(),
         // `results` в scope-форме обрезан по лимиту. Полные числа — в счётчиках и в `orders`.
         isTruncated: z.boolean(),

package/constant/client-group-actions.constant.ts

@@ -0,0 +1,5 @@
+export const CLIENT_GROUP_ACTIONS_LIMITS = {
+    // Верхняя граница на размер группы: панель шлёт выделение со страницы списка,
+    // а необъявленный предел означал бы неограниченный UPDATE по чужому запросу.
+    MAX_CLIENTS_PER_REQUEST: 500,
+} as const;

package/constant/error.ts

@@ -149,6 +149,11 @@ export const ERRORS = {
     CLIENT_FETCH_FAILED: { code: 'CL005', message: 'Error when retrieving a list of clients', httpCode: 500 },
     CLIENT_ALREADY_EXIST: { code: 'CL006', message: 'Client with this properties already exist', httpCode: 409 },
     CLIENT_ACCESS_DENIED: { code: 'CL043', message: 'You are not responsible for this client', httpCode: 403 },
+    CLIENT_RESPONSIBLE_USER_NOT_ASSIGNABLE: {
+        code: 'CL045',
+        message: 'The responsible user does not belong to this company or has no panel role',
+        httpCode: 404,
+    },
     CLIENT_EMAIL_ALREADY_EXIST: { code: 'CL007', message: 'Client with this email already exist', httpCode: 409 },
     CLIENT_PHONE_ALREADY_EXIST: { code: 'CL008', message: 'Client with this phone already exist', httpCode: 409 },
     CLIENT_WITH_SAME_USER_ALREADY_EXIST: { code: 'CL009', message: 'Client with same user already exist', httpCode: 409 },

package/constant/index.ts

@@ -12,3 +12,4 @@ export * from './settings.constant';
 export * from './consignment-product-enrichment.constant';
 export * from './attribute-normalization.constant';
 export * from './product-image-merge.constant';
+export * from './client-group-actions.constant';

package/package.json

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

package/schemas/client/client-responsible-assignment-result.schema.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+
+// Итог группового переназначения ответственного.
+export const ClientResponsibleAssignmentResultSchema = z.object({
+    // Клиентов, у которых назначение действительно изменилось. Те, у кого ответственный
+    // уже такой, в счёт не попадают — им не переписывается и дата назначения.
+    updatedCount: z.number().int().nonnegative(),
+});

package/schemas/client/client-responsible-assignment.schema.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { CLIENT_GROUP_ACTIONS_LIMITS } from '../../constant/client-group-actions.constant';
+
+// Кому и за каких клиентов переназначить ответственность.
+export const ClientResponsibleAssignmentSchema = z.object({
+    clientUUIDList: z.array(z.uuid()).min(1).max(CLIENT_GROUP_ACTIONS_LIMITS.MAX_CLIENTS_PER_REQUEST),
+    // null — снять ответственного. Поле обязательное: пропуск означал бы «не менять»,
+    // а групповое действие без изменения не имеет смысла и скрывал бы опечатку на фронте.
+    responsibleUserUUID: z.uuid().nullable(),
+});

package/schemas/client/index.ts

@@ -3,3 +3,5 @@ export * from './client-individual-profile.schema';
 export * from './client-legal-profile.schema';
 export * from './client-marking.schema';
 export * from './client-debt.schema';
+export * from './client-responsible-assignment.schema';
+export * from './client-responsible-assignment-result.schema';