@floristcloud/api-lib 1.2.139 → 1.2.141

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/commands/report/get-user-activity-timeline.query.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUserActivityTimelineContractQuery = void 0;
+const zod_1 = require("zod");
+const user_activity_section_enum_1 = require("../../enum/user-activity-section.enum");
+const date_helper_1 = require("../../helpers/date.helper");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
+const user_activity_timeline_row_schema_1 = require("../../schemas/report/user-activity-timeline-row.schema");
+const DEFAULT_PAGE = 1;
+// Верхняя граница страницы: page × count должно помещаться в int4 OFFSET, а лента длиннее
+// MAX_PAGE × MAX_COUNT строк за период невозможна.
+const MAX_PAGE = 10000;
+const DEFAULT_COUNT = 50;
+const MAX_COUNT = 500;
+// Лента действий одного сотрудника за период, в хронологическом порядке.
+//
+// Пагинация обязательная: у активного сотрудника за день до нескольких тысяч строк, поэтому
+// page/count всегда применяются — со значениями по умолчанию, если не переданы.
+const GetUserActivityTimelineRequestSchema = zod_1.z
+    .object({
+    userUUID: zod_1.z.uuid(),
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+    section: zod_1.z.nativeEnum(user_activity_section_enum_1.UserActivitySectionEnum).optional().describe('Keep only the rows of this section.'),
+    // «Добавление позиции в заказ» — самый частый тип строк (тысячи в день). По умолчанию
+    // выключен, чтобы не забивать ленту; в сводке позиции считаются всегда (positionsAdded).
+    includeOrderProductRows: query_boolean_helper_1.queryBooleanSchema.describe('Pass "true" to include "position added to order" rows.'),
+    page: zod_1.z.coerce.number().int().positive().max(MAX_PAGE).default(DEFAULT_PAGE),
+    count: zod_1.z.coerce.number().int().positive().max(MAX_COUNT).default(DEFAULT_COUNT),
+})
+    .refine(value => (0, date_helper_1.dateRangeCheck)(value.startDate, value.endDate), {
+    message: 'validation.dateRange',
+    path: ['endDate', 'startDate'],
+})
+    .refine(value => (0, date_helper_1.isStatementPeriodWithinLimit)(value.startDate, value.endDate), {
+    message: 'validation.reportPeriodMax',
+    path: ['endDate', 'startDate'],
+});
+const GetUserActivityTimelineResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        list: zod_1.z.array(user_activity_timeline_row_schema_1.UserActivityTimelineRowSchema),
+        // Число строк во всей ленте за период — не размер страницы.
+        total: zod_1.z.number(),
+    }),
+});
+var GetUserActivityTimelineContractQuery;
+(function (GetUserActivityTimelineContractQuery) {
+    GetUserActivityTimelineContractQuery.RequestSchema = GetUserActivityTimelineRequestSchema;
+    GetUserActivityTimelineContractQuery.ResponseSchema = GetUserActivityTimelineResponseSchema;
+})(GetUserActivityTimelineContractQuery || (exports.GetUserActivityTimelineContractQuery = GetUserActivityTimelineContractQuery = {}));

package/build/commands/report/get-user-activity.query.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUserActivityContractQuery = void 0;
+const zod_1 = require("zod");
+const date_helper_1 = require("../../helpers/date.helper");
+const user_activity_summary_row_schema_1 = require("../../schemas/report/user-activity-summary-row.schema");
+// Сводка «Активность сотрудников»: строка на каждого активного сотрудника компании за период.
+// Период — календарные даты, разворачиваются в границы суток таймзоны компании на бэке.
+const GetUserActivityRequestSchema = zod_1.z
+    .object({
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+})
+    .refine(value => (0, date_helper_1.dateRangeCheck)(value.startDate, value.endDate), {
+    message: 'validation.dateRange',
+    path: ['endDate', 'startDate'],
+})
+    .refine(value => (0, date_helper_1.isStatementPeriodWithinLimit)(value.startDate, value.endDate), {
+    message: 'validation.reportPeriodMax',
+    path: ['endDate', 'startDate'],
+});
+const GetUserActivityResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.array(user_activity_summary_row_schema_1.UserActivitySummaryRowSchema),
+});
+var GetUserActivityContractQuery;
+(function (GetUserActivityContractQuery) {
+    GetUserActivityContractQuery.RequestSchema = GetUserActivityRequestSchema;
+    GetUserActivityContractQuery.ResponseSchema = GetUserActivityResponseSchema;
+})(GetUserActivityContractQuery || (exports.GetUserActivityContractQuery = GetUserActivityContractQuery = {}));

package/build/commands/report/index.js

@@ -32,3 +32,5 @@ __exportStar(require("./get-write-off-summary.query"), exports);
 __exportStar(require("./get-inventory-stock.query"), exports);
 __exportStar(require("./get-inventory-turnover.query"), exports);
 __exportStar(require("./get-sales-by-client.query"), exports);
+__exportStar(require("./get-user-activity.query"), exports);
+__exportStar(require("./get-user-activity-timeline.query"), exports);

package/build/enum/action-log-type.enum.js

@@ -14,6 +14,10 @@ var ActionLogTypeEnum;
     ActionLogTypeEnum["MERGE_ORDER"] = "MERGE_ORDER";
     ActionLogTypeEnum["ADD_PAYMENT"] = "ADD_PAYMENT";
     ActionLogTypeEnum["DELETE_PAYMENT"] = "DELETE_PAYMENT";
+    // Применение банковского платежа к клиенту: та же форма payload, что у ADD_PAYMENT.
+    ActionLogTypeEnum["APPLY_BANK_PAYMENT"] = "APPLY_BANK_PAYMENT";
+    // Импорт выписки: одна агрегатная запись на пакет, а не строка на платёж.
+    ActionLogTypeEnum["IMPORT_TRANSACTIONS"] = "IMPORT_TRANSACTIONS";
     ActionLogTypeEnum["CREATE_PREORDER"] = "CREATE_PREORDER";
     ActionLogTypeEnum["DELETE_PREORDER"] = "DELETE_PREORDER";
     ActionLogTypeEnum["DELETE_PREORDER_ITEM"] = "DELETE_PREORDER_ITEM";

package/build/enum/index.js

@@ -129,3 +129,6 @@ __exportStar(require("./normalization-target.enum"), exports);
 __exportStar(require("./normalization-value-state.enum"), exports);
 __exportStar(require("./normalization-decision-action.enum"), exports);
 __exportStar(require("./product-image-duplicate-mode.enum"), exports);
+__exportStar(require("./user-activity-section.enum"), exports);
+__exportStar(require("./user-activity-action-type.enum"), exports);
+__exportStar(require("./user-activity-source.enum"), exports);

package/build/enum/user-activity-action-type.enum.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivityActionTypeEnum = void 0;
+// Тип строки ленты активности сотрудника.
+//
+// Значения журнальных типов совпадают со строками ActionLogTypeEnum — фронт может использовать
+// одну и ту же локализацию. Сверх журнала есть синтетические типы: действия, которых в журнале
+// нет и которые восстанавливаются из самих таблиц (создание заказа, добавление позиции, списание,
+// документы, смены). CREATE_ORDER здесь именно синтетический: в журнал этот тип никогда не пишется.
+var UserActivityActionTypeEnum;
+(function (UserActivityActionTypeEnum) {
+    // Заказы
+    UserActivityActionTypeEnum["CREATE_ORDER"] = "CREATE_ORDER";
+    UserActivityActionTypeEnum["ADD_ORDER_ITEM"] = "ADD_ORDER_ITEM";
+    UserActivityActionTypeEnum["UPDATE_ORDER_STATUS"] = "UPDATE_ORDER_STATUS";
+    UserActivityActionTypeEnum["DELETE_ORDER"] = "DELETE_ORDER";
+    UserActivityActionTypeEnum["DELETE_ORDER_ITEM"] = "DELETE_ORDER_ITEM";
+    UserActivityActionTypeEnum["UPDATE_ORDER_ITEM"] = "UPDATE_ORDER_ITEM";
+    UserActivityActionTypeEnum["VERIFY_ORDER_ITEM"] = "VERIFY_ORDER_ITEM";
+    UserActivityActionTypeEnum["MOVE_ORDER_ITEM"] = "MOVE_ORDER_ITEM";
+    UserActivityActionTypeEnum["MERGE_ORDER"] = "MERGE_ORDER";
+    // Деньги
+    UserActivityActionTypeEnum["ADD_PAYMENT"] = "ADD_PAYMENT";
+    UserActivityActionTypeEnum["DELETE_PAYMENT"] = "DELETE_PAYMENT";
+    UserActivityActionTypeEnum["APPLY_BANK_PAYMENT"] = "APPLY_BANK_PAYMENT";
+    UserActivityActionTypeEnum["IMPORT_TRANSACTIONS"] = "IMPORT_TRANSACTIONS";
+    // Предзаказы
+    UserActivityActionTypeEnum["CREATE_PREORDER"] = "CREATE_PREORDER";
+    UserActivityActionTypeEnum["DELETE_PREORDER"] = "DELETE_PREORDER";
+    UserActivityActionTypeEnum["UPDATE_PREORDER_ITEM"] = "UPDATE_PREORDER_ITEM";
+    UserActivityActionTypeEnum["DELETE_PREORDER_ITEM"] = "DELETE_PREORDER_ITEM";
+    // Поставки
+    UserActivityActionTypeEnum["UPDATE_CONSIGNMENT_ITEM"] = "UPDATE_CONSIGNMENT_ITEM";
+    UserActivityActionTypeEnum["CREATE_CONSIGNMENT_ITEMS"] = "CREATE_CONSIGNMENT_ITEMS";
+    UserActivityActionTypeEnum["DELETE_CONSIGNMENT_ITEMS"] = "DELETE_CONSIGNMENT_ITEMS";
+    UserActivityActionTypeEnum["GROUP_UPDATE_CONSIGNMENT_ITEMS"] = "GROUP_UPDATE_CONSIGNMENT_ITEMS";
+    UserActivityActionTypeEnum["TRANSFER_CONSIGNMENT_ITEMS"] = "TRANSFER_CONSIGNMENT_ITEMS";
+    // Списания
+    UserActivityActionTypeEnum["CREATE_WRITE_OFF"] = "CREATE_WRITE_OFF";
+    // Документы
+    UserActivityActionTypeEnum["CREATE_PAYMENT_INVOICE"] = "CREATE_PAYMENT_INVOICE";
+    UserActivityActionTypeEnum["CREATE_TRANSFER_DOCUMENT"] = "CREATE_TRANSFER_DOCUMENT";
+    // Смены
+    UserActivityActionTypeEnum["CHECK_IN"] = "CHECK_IN";
+    UserActivityActionTypeEnum["CHECK_OUT"] = "CHECK_OUT";
+})(UserActivityActionTypeEnum || (exports.UserActivityActionTypeEnum = UserActivityActionTypeEnum = {}));

package/build/enum/user-activity-section.enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivitySectionEnum = void 0;
+// Разделы отчёта «Активность сотрудников»: фиксированный набор, по нему режется и сводка (bySection),
+// и лента (фильтр section). Каталожные операции (нормализация атрибутов, слияние картинок) в отчёт
+// не входят — это обслуживание справочника, а не работа с клиентом за день.
+var UserActivitySectionEnum;
+(function (UserActivitySectionEnum) {
+    UserActivitySectionEnum["ORDERS"] = "ORDERS";
+    UserActivitySectionEnum["MONEY"] = "MONEY";
+    UserActivitySectionEnum["PRE_ORDERS"] = "PRE_ORDERS";
+    UserActivitySectionEnum["CONSIGNMENTS"] = "CONSIGNMENTS";
+    UserActivitySectionEnum["WRITE_OFFS"] = "WRITE_OFFS";
+    UserActivitySectionEnum["DOCUMENTS"] = "DOCUMENTS";
+    UserActivitySectionEnum["SHIFTS"] = "SHIFTS";
+})(UserActivitySectionEnum || (exports.UserActivitySectionEnum = UserActivitySectionEnum = {}));

package/build/enum/user-activity-source.enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivitySourceEnum = void 0;
+// Откуда взята строка ленты: из журнала действий (action_log) или восстановлена из таблицы сущности.
+// Деньги — только журнал: ручные, банковские платежи и импорт пишутся туда, история дозаписана миграцией.
+//
+// Каждый источник несёт ТОЧНЫЙ момент события (created_at, applied_at, check_in_at, check_out_at),
+// поэтому признака точности времени в строке нет. Единственный приблизительный источник —
+// подтверждение позиции по order_product.updated_at — не используется: то же действие есть в журнале
+// с точным временем.
+var UserActivitySourceEnum;
+(function (UserActivitySourceEnum) {
+    UserActivitySourceEnum["JOURNAL"] = "JOURNAL";
+    UserActivitySourceEnum["ORDER"] = "ORDER";
+    UserActivitySourceEnum["ORDER_PRODUCT"] = "ORDER_PRODUCT";
+    UserActivitySourceEnum["WRITE_OFF"] = "WRITE_OFF";
+    UserActivitySourceEnum["PAYMENT_INVOICE"] = "PAYMENT_INVOICE";
+    UserActivitySourceEnum["TRANSFER_DOCUMENT"] = "TRANSFER_DOCUMENT";
+    UserActivitySourceEnum["WORK_SESSION"] = "WORK_SESSION";
+})(UserActivitySourceEnum || (exports.UserActivitySourceEnum = UserActivitySourceEnum = {}));

package/build/enum/userRole.enum.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.USER_PANEL_ROLE_LIST = exports.UserPanelRoleEnum = exports.UserRoleEnum = void 0;
+exports.CLIENT_SCOPE_BYPASS_ROLE_LIST = exports.USER_PANEL_ROLE_LIST = exports.UserPanelRoleEnum = exports.UserRoleEnum = void 0;
 var UserRoleEnum;
 (function (UserRoleEnum) {
     UserRoleEnum["ADMIN"] = "ADMIN";
@@ -23,3 +23,11 @@ exports.USER_PANEL_ROLE_LIST = [
     UserRoleEnum.EMPLOYEE,
     UserRoleEnum.WAREHOUSE_EMPLOYEE,
 ];
+/**
+ * Roles that always see and manage every client of the company, regardless of the employee client scope
+ * mode: ADMIN / MANAGER by rank, WAREHOUSE_EMPLOYEE because warehouse work spans all clients. Shared by
+ * EmployeeClientScopeService (read and write scoping) and by ClientResponsibleGuard, which applies the
+ * same list itself — the guard protects routes where a missing role check would expose client details,
+ * so it does not delegate the decision.
+ */
+exports.CLIENT_SCOPE_BYPASS_ROLE_LIST = [UserRoleEnum.ADMIN, UserRoleEnum.MANAGER, UserRoleEnum.WAREHOUSE_EMPLOYEE];

package/build/schemas/action-log/action-log-payload.schema.js

@@ -22,6 +22,7 @@ const group_update_consignment_items_action_log_schema_1 = require("./group-upda
 const transfer_consignment_items_action_log_schema_1 = require("./transfer-consignment-items-action-log.schema");
 const normalize_attributes_action_log_schema_1 = require("./normalize-attributes-action-log.schema");
 const merge_product_images_action_log_schema_1 = require("./merge-product-images-action-log.schema");
+const import_transactions_action_log_schema_1 = require("./import-transactions-action-log.schema");
 exports.ActionLogPayloadSchema = zod_1.z.union([
     order_delete_action_log_payload_schema_1.OrderDeleteActionLogPayloadSchema,
     order_merge_action_log_schema_1.OrderMergeActionLogSchema,
@@ -43,5 +44,6 @@ exports.ActionLogPayloadSchema = zod_1.z.union([
     transfer_consignment_items_action_log_schema_1.TransferConsignmentItemsActionLogSchema,
     normalize_attributes_action_log_schema_1.NormalizeAttributesActionLogSchema,
     merge_product_images_action_log_schema_1.MergeProductImagesActionLogSchema,
+    import_transactions_action_log_schema_1.ImportTransactionsActionLogSchema,
     zod_1.z.null(),
 ]);

package/build/schemas/action-log/action-log.schema.js

@@ -22,6 +22,9 @@ const consignment_items_create_action_log_schema_1 = require("./consignment-item
 const consignment_items_delete_action_log_schema_1 = require("./consignment-items-delete-action-log.schema");
 const group_update_consignment_items_action_log_schema_1 = require("./group-update-consignment-items-action-log.schema");
 const transfer_consignment_items_action_log_schema_1 = require("./transfer-consignment-items-action-log.schema");
+const normalize_attributes_action_log_schema_1 = require("./normalize-attributes-action-log.schema");
+const merge_product_images_action_log_schema_1 = require("./merge-product-images-action-log.schema");
+const import_transactions_action_log_schema_1 = require("./import-transactions-action-log.schema");
 const BaseActionFields = zod_1.z.object({
     uuid: zod_1.z.string(),
     companyUUID: zod_1.z.string(),
@@ -150,7 +153,34 @@ exports.ActionLogSchema = zod_1.z.discriminatedUnion('actionType', [
         payload: transfer_consignment_items_action_log_schema_1.TransferConsignmentItemsActionLogSchema,
     })
         .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.NORMALIZE_ATTRIBUTES),
+        payload: normalize_attributes_action_log_schema_1.NormalizeAttributesActionLogSchema,
+    })
+        .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.MERGE_PRODUCT_IMAGES),
+        payload: merge_product_images_action_log_schema_1.MergeProductImagesActionLogSchema,
+    })
+        .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.APPLY_BANK_PAYMENT),
+        payload: transaction_add_action_log_schema_1.TransactionAddActionLogSchema,
+    })
+        .merge(BaseActionFields),
+    zod_1.z
+        .object({
+        actionType: zod_1.z.literal(enum_1.ActionLogTypeEnum.IMPORT_TRANSACTIONS),
+        payload: import_transactions_action_log_schema_1.ImportTransactionsActionLogSchema,
+    })
+        .merge(BaseActionFields),
 ]);
+// Именно Record, а не массив: пустой массив присваивается `T[]` при любом T и ничего не ловит.
+const assertEveryActionTypeIsCovered = {};
+void assertEveryActionTypeIsCovered;
 exports.CreateActionLogSchema = zod_1.z.object({
     actionType: zod_1.z.nativeEnum(enum_1.ActionLogTypeEnum),
     entityUUID: zod_1.z.string(),

package/build/schemas/action-log/import-transactions-action-log.schema.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportTransactionsActionLogSchema = void 0;
+const zod_1 = require("zod");
+const action_log_money_schema_1 = require("./action-log-money.schema");
+// Импорт выписки — одна агрегатная запись на пакет: сколько платежей создано, приход и расход
+// отдельно (в одном файле бывают оба направления), даты операций и uuid созданных транзакций —
+// по ним пакет восстановим, хотя у самой записи сущности нет. Построчный лог был бы шумом.
+exports.ImportTransactionsActionLogSchema = zod_1.z.object({
+    count: zod_1.z.coerce.number(),
+    incomeAmount: action_log_money_schema_1.ActionLogMoneySchema,
+    expenseAmount: action_log_money_schema_1.ActionLogMoneySchema,
+    dateFrom: zod_1.z.coerce.date().nullable(),
+    dateTo: zod_1.z.coerce.date().nullable(),
+    transactionUUIDs: zod_1.z.array(zod_1.z.string()),
+});

package/build/schemas/action-log/index.js

@@ -38,3 +38,4 @@ __exportStar(require("./consignment-items-delete-action-log.schema"), exports);
 __exportStar(require("./group-update-consignment-items-action-log.schema"), exports);
 __exportStar(require("./transfer-consignment-items-action-log.schema"), exports);
 __exportStar(require("./action-log-money.schema"), exports);
+__exportStar(require("./import-transactions-action-log.schema"), exports);

package/build/schemas/action-log/order-product-move-action-log.schema.js

@@ -8,4 +8,5 @@ exports.OrderProductMoveActionLogSchema = zod_1.z.object({
     orderProductUUID: zod_1.z.string(),
     productUUID: zod_1.z.string(),
     quantity: zod_1.z.coerce.number(),
+    destinationOrderProductUUID: zod_1.z.string().nullable().optional(),
 });

package/build/schemas/index.js

@@ -109,3 +109,6 @@ __exportStar(require("./attribute-normalization/normalization-value.schema"), ex
 __exportStar(require("./attribute-normalization/normalization-summary.schema"), exports);
 __exportStar(require("./attribute-normalization/normalization-decision.schema"), exports);
 __exportStar(require("./attribute-normalization/product-image-duplicate-forecast.schema"), exports);
+__exportStar(require("./report/user-activity-by-section.schema"), exports);
+__exportStar(require("./report/user-activity-summary-row.schema"), exports);
+__exportStar(require("./report/user-activity-timeline-row.schema"), exports);

package/build/schemas/report/user-activity-by-section.schema.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivityBySectionSchema = void 0;
+const zod_1 = require("zod");
+// Счётчики действий по разделам отчёта «Активность сотрудников». Набор ключей фиксированный —
+// панель рисует таблицу с постоянными колонками, а не map по типам действий.
+//
+// Каждый счётчик, кроме смен, равен числу строк ленты того же раздела за тот же период — по цифре
+// можно провалиться и увидеть ровно столько строк. Исключений два, оба намеренные: `shifts` считает
+// СМЕНЫ (начатые в периоде), а лента показывает приход и уход отдельными строками, поэтому строк
+// там больше; и позиции заказов в счётчики не входят вовсе — они отдельным полем positionsAdded,
+// потому что лента по умолчанию их не показывает.
+exports.UserActivityBySectionSchema = zod_1.z.object({
+    orders: zod_1.z.number(),
+    money: zod_1.z.number(),
+    preOrders: zod_1.z.number(),
+    consignments: zod_1.z.number(),
+    writeOffs: zod_1.z.number(),
+    documents: zod_1.z.number(),
+    shifts: zod_1.z.number(),
+});

package/build/schemas/report/user-activity-summary-row.schema.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivitySummaryRowSchema = void 0;
+const zod_1 = require("zod");
+const money_schema_1 = require("../money.schema");
+const user_activity_by_section_schema_1 = require("./user-activity-by-section.schema");
+// Строка сводки: один сотрудник за период. Сотрудники без действий тоже присутствуют — с нулями:
+// «кто ничего не делал» и есть половина ценности сводки.
+exports.UserActivitySummaryRowSchema = zod_1.z.object({
+    userUUID: zod_1.z.string(),
+    userName: zod_1.z.string(),
+    // Сумма разделов БЕЗ смен: приход и уход — рамка дня, а не работа.
+    actionsTotal: zod_1.z.number(),
+    bySection: user_activity_by_section_schema_1.UserActivityBySectionSchema,
+    ordersCreated: zod_1.z.number(),
+    // Принятые сотрудником деньги за период: только приход (INCOME, PREPAYMENT) по ручным и
+    // банковским платежам из журнала. Расход и возврат — действия, но не сумма; пакет импорта
+    // выписки — тоже действие без суммы (он не «принят» сотрудником).
+    paymentsAmount: money_schema_1.MoneySchema,
+    positionsAdded: zod_1.z.number(),
+    // Первое и последнее действие за период. Смены не считаются (это рамка дня), а добавление позиций
+    // считается: сотрудник, который весь день собирал заказы, показывает actionsTotal 0 при непустых
+    // отметках — его работа целиком в positionsAdded.
+    firstActionAt: zod_1.z.date().nullable(),
+    lastActionAt: zod_1.z.date().nullable(),
+    // Часы смен, закрытых в периоде (как у строки CHECK_OUT в ленте); null — ни одна смена в периоде не закрыта.
+    workHours: zod_1.z.number().nullable(),
+});

package/build/schemas/report/user-activity-timeline-row.schema.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivityTimelineRowSchema = void 0;
+const zod_1 = require("zod");
+const user_activity_action_type_enum_1 = require("../../enum/user-activity-action-type.enum");
+const user_activity_section_enum_1 = require("../../enum/user-activity-section.enum");
+const user_activity_source_enum_1 = require("../../enum/user-activity-source.enum");
+const money_schema_1 = require("../money.schema");
+// Строка ленты активности сотрудника. Текст действия (action, details) рендерит сервер на языке
+// компании — панель показывает его как есть. Клиент, номер заказа, сумма и количество вынесены в
+// отдельные колонки, в details остаётся то, что в колонки не ложится (товар, статусы, причина).
+//
+// Телефон клиента здесь намеренно НЕ отдаётся: строка описывает действие сотрудника, клиент в ней
+// нужен для опознания и уже опознан парой clientUUID + clientName — карточку с контактами панель
+// открывает по uuid. Отчёт, где телефон это рабочий инструмент, — отдельный (/report/sales/clients).
+exports.UserActivityTimelineRowSchema = zod_1.z.object({
+    at: zod_1.z.date(),
+    section: zod_1.z.nativeEnum(user_activity_section_enum_1.UserActivitySectionEnum),
+    actionType: zod_1.z.nativeEnum(user_activity_action_type_enum_1.UserActivityActionTypeEnum),
+    action: zod_1.z.string(),
+    clientUUID: zod_1.z.string().nullable(),
+    clientName: zod_1.z.string().nullable(),
+    orderId: zod_1.z.number().nullable(),
+    amount: money_schema_1.MoneySchema.nullable(),
+    quantity: zod_1.z.number().nullable(),
+    details: zod_1.z.string().nullable(),
+    source: zod_1.z.nativeEnum(user_activity_source_enum_1.UserActivitySourceEnum),
+    entityUUID: zod_1.z.string(),
+});

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/commands/report/get-user-activity-timeline.query.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { UserActivitySectionEnum } from '../../enum/user-activity-section.enum';
+import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
+import { queryBooleanSchema } from '../../helpers/query-boolean.helper';
+import { UserActivityTimelineRowSchema } from '../../schemas/report/user-activity-timeline-row.schema';
+
+const DEFAULT_PAGE = 1;
+// Верхняя граница страницы: page × count должно помещаться в int4 OFFSET, а лента длиннее
+// MAX_PAGE × MAX_COUNT строк за период невозможна.
+const MAX_PAGE = 10000;
+const DEFAULT_COUNT = 50;
+const MAX_COUNT = 500;
+
+// Лента действий одного сотрудника за период, в хронологическом порядке.
+//
+// Пагинация обязательная: у активного сотрудника за день до нескольких тысяч строк, поэтому
+// page/count всегда применяются — со значениями по умолчанию, если не переданы.
+const GetUserActivityTimelineRequestSchema = z
+    .object({
+        userUUID: z.uuid(),
+        startDate: z.coerce.date(),
+        endDate: z.coerce.date(),
+        section: z.nativeEnum(UserActivitySectionEnum).optional().describe('Keep only the rows of this section.'),
+        // «Добавление позиции в заказ» — самый частый тип строк (тысячи в день). По умолчанию
+        // выключен, чтобы не забивать ленту; в сводке позиции считаются всегда (positionsAdded).
+        includeOrderProductRows: queryBooleanSchema.describe('Pass "true" to include "position added to order" rows.'),
+        page: z.coerce.number().int().positive().max(MAX_PAGE).default(DEFAULT_PAGE),
+        count: z.coerce.number().int().positive().max(MAX_COUNT).default(DEFAULT_COUNT),
+    })
+    .refine(value => dateRangeCheck(value.startDate, value.endDate), {
+        message: 'validation.dateRange',
+        path: ['endDate', 'startDate'],
+    })
+    .refine(value => isStatementPeriodWithinLimit(value.startDate, value.endDate), {
+        message: 'validation.reportPeriodMax',
+        path: ['endDate', 'startDate'],
+    });
+
+const GetUserActivityTimelineResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        list: z.array(UserActivityTimelineRowSchema),
+        // Число строк во всей ленте за период — не размер страницы.
+        total: z.number(),
+    }),
+});
+
+export namespace GetUserActivityTimelineContractQuery {
+    export const RequestSchema = GetUserActivityTimelineRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetUserActivityTimelineResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/report/get-user-activity.query.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
+import { UserActivitySummaryRowSchema } from '../../schemas/report/user-activity-summary-row.schema';
+
+// Сводка «Активность сотрудников»: строка на каждого активного сотрудника компании за период.
+// Период — календарные даты, разворачиваются в границы суток таймзоны компании на бэке.
+const GetUserActivityRequestSchema = z
+    .object({
+        startDate: z.coerce.date(),
+        endDate: z.coerce.date(),
+    })
+    .refine(value => dateRangeCheck(value.startDate, value.endDate), {
+        message: 'validation.dateRange',
+        path: ['endDate', 'startDate'],
+    })
+    .refine(value => isStatementPeriodWithinLimit(value.startDate, value.endDate), {
+        message: 'validation.reportPeriodMax',
+        path: ['endDate', 'startDate'],
+    });
+
+const GetUserActivityResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.array(UserActivitySummaryRowSchema),
+});
+
+export namespace GetUserActivityContractQuery {
+    export const RequestSchema = GetUserActivityRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetUserActivityResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/report/index.ts

@@ -16,3 +16,5 @@ export * from './get-write-off-summary.query';
 export * from './get-inventory-stock.query';
 export * from './get-inventory-turnover.query';
 export * from './get-sales-by-client.query';
+export * from './get-user-activity.query';
+export * from './get-user-activity-timeline.query';

package/enum/action-log-type.enum.ts

@@ -10,6 +10,10 @@ export enum ActionLogTypeEnum {
     MERGE_ORDER = 'MERGE_ORDER',
     ADD_PAYMENT = 'ADD_PAYMENT',
     DELETE_PAYMENT = 'DELETE_PAYMENT',
+    // Применение банковского платежа к клиенту: та же форма payload, что у ADD_PAYMENT.
+    APPLY_BANK_PAYMENT = 'APPLY_BANK_PAYMENT',
+    // Импорт выписки: одна агрегатная запись на пакет, а не строка на платёж.
+    IMPORT_TRANSACTIONS = 'IMPORT_TRANSACTIONS',
     CREATE_PREORDER = 'CREATE_PREORDER',
     DELETE_PREORDER = 'DELETE_PREORDER',
     DELETE_PREORDER_ITEM = 'DELETE_PREORDER_ITEM',

package/enum/index.ts

@@ -113,3 +113,6 @@ export * from './normalization-target.enum';
 export * from './normalization-value-state.enum';
 export * from './normalization-decision-action.enum';
 export * from './product-image-duplicate-mode.enum';
+export * from './user-activity-section.enum';
+export * from './user-activity-action-type.enum';
+export * from './user-activity-source.enum';

package/enum/user-activity-action-type.enum.ts

@@ -0,0 +1,42 @@
+// Тип строки ленты активности сотрудника.
+//
+// Значения журнальных типов совпадают со строками ActionLogTypeEnum — фронт может использовать
+// одну и ту же локализацию. Сверх журнала есть синтетические типы: действия, которых в журнале
+// нет и которые восстанавливаются из самих таблиц (создание заказа, добавление позиции, списание,
+// документы, смены). CREATE_ORDER здесь именно синтетический: в журнал этот тип никогда не пишется.
+export enum UserActivityActionTypeEnum {
+    // Заказы
+    CREATE_ORDER = 'CREATE_ORDER',
+    ADD_ORDER_ITEM = 'ADD_ORDER_ITEM',
+    UPDATE_ORDER_STATUS = 'UPDATE_ORDER_STATUS',
+    DELETE_ORDER = 'DELETE_ORDER',
+    DELETE_ORDER_ITEM = 'DELETE_ORDER_ITEM',
+    UPDATE_ORDER_ITEM = 'UPDATE_ORDER_ITEM',
+    VERIFY_ORDER_ITEM = 'VERIFY_ORDER_ITEM',
+    MOVE_ORDER_ITEM = 'MOVE_ORDER_ITEM',
+    MERGE_ORDER = 'MERGE_ORDER',
+    // Деньги
+    ADD_PAYMENT = 'ADD_PAYMENT',
+    DELETE_PAYMENT = 'DELETE_PAYMENT',
+    APPLY_BANK_PAYMENT = 'APPLY_BANK_PAYMENT',
+    IMPORT_TRANSACTIONS = 'IMPORT_TRANSACTIONS',
+    // Предзаказы
+    CREATE_PREORDER = 'CREATE_PREORDER',
+    DELETE_PREORDER = 'DELETE_PREORDER',
+    UPDATE_PREORDER_ITEM = 'UPDATE_PREORDER_ITEM',
+    DELETE_PREORDER_ITEM = 'DELETE_PREORDER_ITEM',
+    // Поставки
+    UPDATE_CONSIGNMENT_ITEM = 'UPDATE_CONSIGNMENT_ITEM',
+    CREATE_CONSIGNMENT_ITEMS = 'CREATE_CONSIGNMENT_ITEMS',
+    DELETE_CONSIGNMENT_ITEMS = 'DELETE_CONSIGNMENT_ITEMS',
+    GROUP_UPDATE_CONSIGNMENT_ITEMS = 'GROUP_UPDATE_CONSIGNMENT_ITEMS',
+    TRANSFER_CONSIGNMENT_ITEMS = 'TRANSFER_CONSIGNMENT_ITEMS',
+    // Списания
+    CREATE_WRITE_OFF = 'CREATE_WRITE_OFF',
+    // Документы
+    CREATE_PAYMENT_INVOICE = 'CREATE_PAYMENT_INVOICE',
+    CREATE_TRANSFER_DOCUMENT = 'CREATE_TRANSFER_DOCUMENT',
+    // Смены
+    CHECK_IN = 'CHECK_IN',
+    CHECK_OUT = 'CHECK_OUT',
+}

package/enum/user-activity-section.enum.ts

@@ -0,0 +1,12 @@
+// Разделы отчёта «Активность сотрудников»: фиксированный набор, по нему режется и сводка (bySection),
+// и лента (фильтр section). Каталожные операции (нормализация атрибутов, слияние картинок) в отчёт
+// не входят — это обслуживание справочника, а не работа с клиентом за день.
+export enum UserActivitySectionEnum {
+    ORDERS = 'ORDERS',
+    MONEY = 'MONEY',
+    PRE_ORDERS = 'PRE_ORDERS',
+    CONSIGNMENTS = 'CONSIGNMENTS',
+    WRITE_OFFS = 'WRITE_OFFS',
+    DOCUMENTS = 'DOCUMENTS',
+    SHIFTS = 'SHIFTS',
+}

package/enum/user-activity-source.enum.ts

@@ -0,0 +1,16 @@
+// Откуда взята строка ленты: из журнала действий (action_log) или восстановлена из таблицы сущности.
+// Деньги — только журнал: ручные, банковские платежи и импорт пишутся туда, история дозаписана миграцией.
+//
+// Каждый источник несёт ТОЧНЫЙ момент события (created_at, applied_at, check_in_at, check_out_at),
+// поэтому признака точности времени в строке нет. Единственный приблизительный источник —
+// подтверждение позиции по order_product.updated_at — не используется: то же действие есть в журнале
+// с точным временем.
+export enum UserActivitySourceEnum {
+    JOURNAL = 'JOURNAL',
+    ORDER = 'ORDER',
+    ORDER_PRODUCT = 'ORDER_PRODUCT',
+    WRITE_OFF = 'WRITE_OFF',
+    PAYMENT_INVOICE = 'PAYMENT_INVOICE',
+    TRANSFER_DOCUMENT = 'TRANSFER_DOCUMENT',
+    WORK_SESSION = 'WORK_SESSION',
+}

package/enum/userRole.enum.ts

@@ -20,3 +20,12 @@ export const USER_PANEL_ROLE_LIST: UserRoleEnum[] = [
     UserRoleEnum.EMPLOYEE,
     UserRoleEnum.WAREHOUSE_EMPLOYEE,
 ];
+
+/**
+ * Roles that always see and manage every client of the company, regardless of the employee client scope
+ * mode: ADMIN / MANAGER by rank, WAREHOUSE_EMPLOYEE because warehouse work spans all clients. Shared by
+ * EmployeeClientScopeService (read and write scoping) and by ClientResponsibleGuard, which applies the
+ * same list itself — the guard protects routes where a missing role check would expose client details,
+ * so it does not delegate the decision.
+ */
+export const CLIENT_SCOPE_BYPASS_ROLE_LIST: UserRoleEnum[] = [UserRoleEnum.ADMIN, UserRoleEnum.MANAGER, UserRoleEnum.WAREHOUSE_EMPLOYEE];

package/package.json

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

package/schemas/action-log/action-log-payload.schema.ts

@@ -19,6 +19,7 @@ import { GroupUpdateConsignmentItemsActionLogSchema } from './group-update-consi
 import { TransferConsignmentItemsActionLogSchema } from './transfer-consignment-items-action-log.schema';
 import { NormalizeAttributesActionLogSchema } from './normalize-attributes-action-log.schema';
 import { MergeProductImagesActionLogSchema } from './merge-product-images-action-log.schema';
+import { ImportTransactionsActionLogSchema } from './import-transactions-action-log.schema';
 
 export const ActionLogPayloadSchema = z.union([
     OrderDeleteActionLogPayloadSchema,
@@ -41,5 +42,6 @@ export const ActionLogPayloadSchema = z.union([
     TransferConsignmentItemsActionLogSchema,
     NormalizeAttributesActionLogSchema,
     MergeProductImagesActionLogSchema,
+    ImportTransactionsActionLogSchema,
     z.null(),
 ]);

package/schemas/action-log/action-log.schema.ts

@@ -19,6 +19,9 @@ import { ConsignmentItemsCreateActionLogSchema } from './consignment-items-creat
 import { ConsignmentItemsDeleteActionLogSchema } from './consignment-items-delete-action-log.schema';
 import { GroupUpdateConsignmentItemsActionLogSchema } from './group-update-consignment-items-action-log.schema';
 import { TransferConsignmentItemsActionLogSchema } from './transfer-consignment-items-action-log.schema';
+import { NormalizeAttributesActionLogSchema } from './normalize-attributes-action-log.schema';
+import { MergeProductImagesActionLogSchema } from './merge-product-images-action-log.schema';
+import { ImportTransactionsActionLogSchema } from './import-transactions-action-log.schema';
 
 const BaseActionFields = z.object({
     uuid: z.string(),
@@ -149,8 +152,40 @@ export const ActionLogSchema = z.discriminatedUnion('actionType', [
             payload: TransferConsignmentItemsActionLogSchema,
         })
         .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.NORMALIZE_ATTRIBUTES),
+            payload: NormalizeAttributesActionLogSchema,
+        })
+        .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.MERGE_PRODUCT_IMAGES),
+            payload: MergeProductImagesActionLogSchema,
+        })
+        .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.APPLY_BANK_PAYMENT),
+            payload: TransactionAddActionLogSchema,
+        })
+        .merge(BaseActionFields),
+    z
+        .object({
+            actionType: z.literal(ActionLogTypeEnum.IMPORT_TRANSACTIONS),
+            payload: ImportTransactionsActionLogSchema,
+        })
+        .merge(BaseActionFields),
 ]);
 
+// Забытый в союзе тип роняет ZodError-ом всю страницу истории, а не одну строку: ActionLogResponseModel
+// парсит каждую запись этой схемой. Так уже случалось с NORMALIZE_ATTRIBUTES и MERGE_PRODUCT_IMAGES,
+// поэтому пропуск обязан ломать компиляцию.
+type UncoveredActionLogType = Exclude<ActionLogTypeEnum, z.infer<typeof ActionLogSchema>['actionType']>;
+// Именно Record, а не массив: пустой массив присваивается `T[]` при любом T и ничего не ловит.
+const assertEveryActionTypeIsCovered: Record<UncoveredActionLogType, true> = {};
+void assertEveryActionTypeIsCovered;
+
 export const CreateActionLogSchema = z.object({
     actionType: z.nativeEnum(ActionLogTypeEnum),
     entityUUID: z.string(),

package/schemas/action-log/import-transactions-action-log.schema.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { ActionLogMoneySchema } from './action-log-money.schema';
+
+// Импорт выписки — одна агрегатная запись на пакет: сколько платежей создано, приход и расход
+// отдельно (в одном файле бывают оба направления), даты операций и uuid созданных транзакций —
+// по ним пакет восстановим, хотя у самой записи сущности нет. Построчный лог был бы шумом.
+export const ImportTransactionsActionLogSchema = z.object({
+    count: z.coerce.number(),
+    incomeAmount: ActionLogMoneySchema,
+    expenseAmount: ActionLogMoneySchema,
+    dateFrom: z.coerce.date().nullable(),
+    dateTo: z.coerce.date().nullable(),
+    transactionUUIDs: z.array(z.string()),
+});

package/schemas/action-log/index.ts

@@ -22,3 +22,4 @@ export * from './consignment-items-delete-action-log.schema';
 export * from './group-update-consignment-items-action-log.schema';
 export * from './transfer-consignment-items-action-log.schema';
 export * from './action-log-money.schema';
+export * from './import-transactions-action-log.schema';

package/schemas/action-log/order-product-move-action-log.schema.ts

@@ -6,4 +6,5 @@ export const OrderProductMoveActionLogSchema = z.object({
     orderProductUUID: z.string(),
     productUUID: z.string(),
     quantity: z.coerce.number(),
+    destinationOrderProductUUID: z.string().nullable().optional(),
 });

package/schemas/index.ts

@@ -93,3 +93,6 @@ export * from './attribute-normalization/normalization-value.schema';
 export * from './attribute-normalization/normalization-summary.schema';
 export * from './attribute-normalization/normalization-decision.schema';
 export * from './attribute-normalization/product-image-duplicate-forecast.schema';
+export * from './report/user-activity-by-section.schema';
+export * from './report/user-activity-summary-row.schema';
+export * from './report/user-activity-timeline-row.schema';

package/schemas/report/user-activity-by-section.schema.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+
+// Счётчики действий по разделам отчёта «Активность сотрудников». Набор ключей фиксированный —
+// панель рисует таблицу с постоянными колонками, а не map по типам действий.
+//
+// Каждый счётчик, кроме смен, равен числу строк ленты того же раздела за тот же период — по цифре
+// можно провалиться и увидеть ровно столько строк. Исключений два, оба намеренные: `shifts` считает
+// СМЕНЫ (начатые в периоде), а лента показывает приход и уход отдельными строками, поэтому строк
+// там больше; и позиции заказов в счётчики не входят вовсе — они отдельным полем positionsAdded,
+// потому что лента по умолчанию их не показывает.
+export const UserActivityBySectionSchema = z.object({
+    orders: z.number(),
+    money: z.number(),
+    preOrders: z.number(),
+    consignments: z.number(),
+    writeOffs: z.number(),
+    documents: z.number(),
+    shifts: z.number(),
+});

package/schemas/report/user-activity-summary-row.schema.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
+import { UserActivityBySectionSchema } from './user-activity-by-section.schema';
+
+// Строка сводки: один сотрудник за период. Сотрудники без действий тоже присутствуют — с нулями:
+// «кто ничего не делал» и есть половина ценности сводки.
+export const UserActivitySummaryRowSchema = z.object({
+    userUUID: z.string(),
+    userName: z.string(),
+    // Сумма разделов БЕЗ смен: приход и уход — рамка дня, а не работа.
+    actionsTotal: z.number(),
+    bySection: UserActivityBySectionSchema,
+    ordersCreated: z.number(),
+    // Принятые сотрудником деньги за период: только приход (INCOME, PREPAYMENT) по ручным и
+    // банковским платежам из журнала. Расход и возврат — действия, но не сумма; пакет импорта
+    // выписки — тоже действие без суммы (он не «принят» сотрудником).
+    paymentsAmount: MoneySchema,
+    positionsAdded: z.number(),
+    // Первое и последнее действие за период. Смены не считаются (это рамка дня), а добавление позиций
+    // считается: сотрудник, который весь день собирал заказы, показывает actionsTotal 0 при непустых
+    // отметках — его работа целиком в positionsAdded.
+    firstActionAt: z.date().nullable(),
+    lastActionAt: z.date().nullable(),
+    // Часы смен, закрытых в периоде (как у строки CHECK_OUT в ленте); null — ни одна смена в периоде не закрыта.
+    workHours: z.number().nullable(),
+});

package/schemas/report/user-activity-timeline-row.schema.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { UserActivityActionTypeEnum } from '../../enum/user-activity-action-type.enum';
+import { UserActivitySectionEnum } from '../../enum/user-activity-section.enum';
+import { UserActivitySourceEnum } from '../../enum/user-activity-source.enum';
+import { MoneySchema } from '../money.schema';
+
+// Строка ленты активности сотрудника. Текст действия (action, details) рендерит сервер на языке
+// компании — панель показывает его как есть. Клиент, номер заказа, сумма и количество вынесены в
+// отдельные колонки, в details остаётся то, что в колонки не ложится (товар, статусы, причина).
+//
+// Телефон клиента здесь намеренно НЕ отдаётся: строка описывает действие сотрудника, клиент в ней
+// нужен для опознания и уже опознан парой clientUUID + clientName — карточку с контактами панель
+// открывает по uuid. Отчёт, где телефон это рабочий инструмент, — отдельный (/report/sales/clients).
+export const UserActivityTimelineRowSchema = z.object({
+    at: z.date(),
+    section: z.nativeEnum(UserActivitySectionEnum),
+    actionType: z.nativeEnum(UserActivityActionTypeEnum),
+    action: z.string(),
+    clientUUID: z.string().nullable(),
+    clientName: z.string().nullable(),
+    orderId: z.number().nullable(),
+    amount: MoneySchema.nullable(),
+    quantity: z.number().nullable(),
+    details: z.string().nullable(),
+    source: z.nativeEnum(UserActivitySourceEnum),
+    entityUUID: z.string(),
+});