@floristcloud/api-lib 1.2.107 → 1.2.108

package/build/commands/client/create-client.command.js

@@ -4,6 +4,7 @@ exports.CreateClientContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
 const client_status_enum_1 = require("../../enum/client-status.enum");
+const client_contract_status_enum_1 = require("../../enum/client-contract-status.enum");
 const client_type_enum_1 = require("../../enum/client-type.enum");
 const CreateClientRequestSchema = zod_1.z.object({
     name: zod_1.z.string(),
@@ -15,6 +16,7 @@ const CreateClientRequestSchema = zod_1.z.object({
     isCommon: zod_1.z.coerce.boolean(),
     contractNumber: zod_1.z.string().nullable().optional(),
     contractDate: zod_1.z.coerce.date().nullable().optional(),
+    contractStatus: zod_1.z.nativeEnum(client_contract_status_enum_1.ClientContractStatusEnum).optional(),
     address: zod_1.z.string().nullable().optional(),
     city: zod_1.z.string().nullable().optional(),
     code: zod_1.z.string().nullable().optional(),

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

@@ -4,6 +4,7 @@ exports.GetClientListContractQuery = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
 const client_status_enum_1 = require("../../enum/client-status.enum");
+const client_contract_status_enum_1 = require("../../enum/client-contract-status.enum");
 const client_type_enum_1 = require("../../enum/client-type.enum");
 const GetClientListRequestSchema = zod_1.z.object({
     page: zod_1.z.string().transform(val => Number(val) || 1),
@@ -19,6 +20,13 @@ const GetClientListRequestSchema = zod_1.z.object({
         .string()
         .optional()
         .transform(val => (val === 'true' ? true : val === 'false' || val === '' ? false : undefined)),
+    contractStatus: zod_1.z.nativeEnum(client_contract_status_enum_1.ClientContractStatusEnum).optional(),
+    // Feeds the "Contracts" tab: a client counts as having a contract record when a number or a date
+    // is filled in, or the contract status has been moved off NONE.
+    hasContractRecord: zod_1.z
+        .string()
+        .optional()
+        .transform(val => (val === 'true' ? true : val === 'false' ? false : undefined)),
 });
 const GetClientListResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/client/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./get-client-list.query"), exports);
 __exportStar(require("./get-client-debt-list.query"), exports);
 __exportStar(require("./create-client.command"), exports);
 __exportStar(require("./update-client.command"), exports);
+__exportStar(require("./update-client-contract-data.command"), exports);
 __exportStar(require("./delete-client.command"), exports);
 __exportStar(require("./get-client-calculate.query"), exports);
 __exportStar(require("./set-balance-calculate-client.command"), exports);

package/build/commands/client/update-client-contract-data.command.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateClientContractDataContractCommand = void 0;
+const zod_1 = require("zod");
+const schemas_1 = require("../../schemas");
+const client_contract_status_enum_1 = require("../../enum/client-contract-status.enum");
+// Narrow, partial counterpart of UpdateClientContract: touches only the contract fields, so a
+// one-click status change cannot overwrite the rest of the client with a stale snapshot.
+const UpdateClientContractDataRequestSchema = zod_1.z.object({
+    contractNumber: zod_1.z.string().nullable().optional(),
+    contractDate: zod_1.z.coerce.date().nullable().optional(),
+    contractStatus: zod_1.z.nativeEnum(client_contract_status_enum_1.ClientContractStatusEnum).optional(),
+});
+const UpdateClientContractDataResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: schemas_1.ClientSchema.nullable(),
+});
+var UpdateClientContractDataContractCommand;
+(function (UpdateClientContractDataContractCommand) {
+    UpdateClientContractDataContractCommand.RequestSchema = UpdateClientContractDataRequestSchema;
+    UpdateClientContractDataContractCommand.ResponseSchema = UpdateClientContractDataResponseSchema;
+})(UpdateClientContractDataContractCommand || (exports.UpdateClientContractDataContractCommand = UpdateClientContractDataContractCommand = {}));

package/build/commands/client/update-client.command.js

@@ -4,6 +4,7 @@ exports.UpdateClientContractCommand = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
 const client_status_enum_1 = require("../../enum/client-status.enum");
+const client_contract_status_enum_1 = require("../../enum/client-contract-status.enum");
 const client_type_enum_1 = require("../../enum/client-type.enum");
 const UpdateClientRequestSchema = zod_1.z.object({
     name: zod_1.z.string(),
@@ -15,6 +16,7 @@ const UpdateClientRequestSchema = zod_1.z.object({
     type: zod_1.z.nativeEnum(client_type_enum_1.ClientTypeEnum),
     contractNumber: zod_1.z.string().nullable(),
     contractDate: zod_1.z.coerce.date().nullable(),
+    contractStatus: zod_1.z.nativeEnum(client_contract_status_enum_1.ClientContractStatusEnum).optional(),
     address: zod_1.z.string().nullable().optional(),
     city: zod_1.z.string().nullable().optional(),
     code: zod_1.z.string().nullable().optional(),

package/build/commands/money-account/get-money-account-by-criteria.query.js

@@ -3,10 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetMoneyAccountByCriteriaContractQuery = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
-const GetMoneyAccountByCriteriaRequestSchema = zod_1.z.object({});
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
+const GetMoneyAccountByCriteriaRequestSchema = zod_1.z.object({
+    // Опционально: посчитать остаток каждого счёта одним агрегатом вместо отдельного
+    // GET /transaction/sum/:moneyAccountUUID на каждый счёт. Описание видит и MCP-каталог.
+    withBalance: query_boolean_helper_1.queryBooleanSchema.describe('Pass "true" to include the current balance of every money account, instead of calling transaction/sum per account.'),
+});
 const GetMoneyAccountByCriteriaResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
-    data: schemas_1.MoneyAccountSchema.array(),
+    data: schemas_1.MoneyAccountWithBalanceSchema.array(),
 });
 var GetMoneyAccountByCriteriaContractQuery;
 (function (GetMoneyAccountByCriteriaContractQuery) {

package/build/commands/money-account/get-money-account-list.query.js

@@ -3,14 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetMoneyAccountListContractQuery = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
 const GetMoneyAccountListRequestSchema = zod_1.z.object({
     page: zod_1.z.string().transform(val => Number(val) || 1),
     count: zod_1.z.string().transform(val => Number(val) || 10),
+    // Опционально: посчитать остаток каждого счёта одним агрегатом вместо отдельного
+    // GET /transaction/sum/:moneyAccountUUID на каждый счёт. Описание видит и MCP-каталог.
+    withBalance: query_boolean_helper_1.queryBooleanSchema.describe('Pass "true" to include the current balance of every money account, instead of calling transaction/sum per account.'),
 });
 const GetMoneyAccountListResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: zod_1.z.object({
-        list: zod_1.z.array(schemas_1.MoneyAccountSchema),
+        list: zod_1.z.array(schemas_1.MoneyAccountWithBalanceSchema),
         total: zod_1.z.number(),
     }),
 });

package/build/commands/report/export-inventory-stock.query.js

@@ -2,28 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExportInventoryStockContractQuery = void 0;
 const zod_1 = require("zod");
+const inventory_stock_category_item_schema_1 = require("../../schemas/report/inventory-stock-category-item.schema");
+const inventory_stock_detailed_item_schema_1 = require("../../schemas/report/inventory-stock-detailed-item.schema");
 const ExportInventoryStockRequestSchema = zod_1.z.object({
     categoryUUID: zod_1.z.uuid().optional(), // Фильтр по категории
     detailed: zod_1.z.coerce.boolean().optional().default(false), // Флаг для детализации (группировка по name, size, grower)
 });
-// Ответ для обычного отчета (по категориям)
-const CategoryStockItemSchema = zod_1.z.object({
-    categoryUUID: zod_1.z.string(),
-    categoryName: zod_1.z.string(),
-    balance: zod_1.z.number(),
-});
-// Ответ для детализированного отчета (с группировкой по name, size, grower)
-const DetailedStockItemSchema = zod_1.z.object({
-    categoryUUID: zod_1.z.string(),
-    categoryName: zod_1.z.string(),
-    name: zod_1.z.string(),
-    color: zod_1.z.string().nullable(),
-    size: zod_1.z.string().nullable(),
-    grower: zod_1.z.string().nullable(),
-    balance: zod_1.z.number(),
-});
+// Строки живут в schemas/report — их же отдаёт JSON-эндпоинт report/inventory/stock, форма ответа общая.
 const ExportInventoryStockResponseSchema = zod_1.z.object({
-    data: zod_1.z.array(zod_1.z.union([CategoryStockItemSchema, DetailedStockItemSchema])),
+    data: zod_1.z.array(zod_1.z.union([inventory_stock_category_item_schema_1.InventoryStockCategoryItemSchema, inventory_stock_detailed_item_schema_1.InventoryStockDetailedItemSchema])),
 });
 var ExportInventoryStockContractQuery;
 (function (ExportInventoryStockContractQuery) {

package/build/commands/report/export-inventory-turnover.query.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExportInventoryTurnoverContractQuery = void 0;
 const zod_1 = require("zod");
 const date_helper_1 = require("../../helpers/date.helper");
+const inventory_turnover_category_item_schema_1 = require("../../schemas/report/inventory-turnover-category-item.schema");
+const inventory_turnover_detailed_item_schema_1 = require("../../schemas/report/inventory-turnover-detailed-item.schema");
 const ExportInventoryTurnoverRequestSchema = zod_1.z
     .object({
     startDate: zod_1.z.coerce.date().optional(),
@@ -20,34 +22,9 @@ const ExportInventoryTurnoverRequestSchema = zod_1.z
     message: 'validation.dateRange',
     path: ['endDate', 'startDate'],
 });
-// Ответ для обычного отчета (по категориям)
-const CategoryTurnoverItemSchema = zod_1.z.object({
-    categoryUUID: zod_1.z.string(),
-    categoryName: zod_1.z.string(),
-    initialBalance: zod_1.z.number(), // начальный остаток
-    receipts: zod_1.z.number(), // приходы
-    sales: zod_1.z.number(), // продажи
-    currentBalance: zod_1.z.number(), // текущий остаток
-    daysInStock: zod_1.z.number(), // дни в наличии на складе
-    turnoverRate: zod_1.z.number(), // коэффициент оборачиваемости
-});
-// Ответ для детализированного отчета (с группировкой по name, size, grower)
-const DetailedTurnoverItemSchema = zod_1.z.object({
-    categoryUUID: zod_1.z.string(),
-    categoryName: zod_1.z.string(),
-    name: zod_1.z.string(),
-    color: zod_1.z.string().nullable(),
-    size: zod_1.z.string().nullable(),
-    grower: zod_1.z.string().nullable(), // производитель
-    initialBalance: zod_1.z.number(), // начальный остаток
-    receipts: zod_1.z.number(), // приходы
-    sales: zod_1.z.number(), // продажи
-    currentBalance: zod_1.z.number(), // текущий остаток
-    daysInStock: zod_1.z.number(), // дни в наличии на складе
-    turnoverRate: zod_1.z.number(), // коэффициент оборачиваемости
-});
+// Строки живут в schemas/report — их же отдаёт JSON-эндпоинт report/inventory/turnover, форма ответа общая.
 const ExportInventoryTurnoverResponseSchema = zod_1.z.object({
-    data: zod_1.z.array(zod_1.z.union([CategoryTurnoverItemSchema, DetailedTurnoverItemSchema])),
+    data: zod_1.z.array(zod_1.z.union([inventory_turnover_category_item_schema_1.InventoryTurnoverCategoryItemSchema, inventory_turnover_detailed_item_schema_1.InventoryTurnoverDetailedItemSchema])),
 });
 var ExportInventoryTurnoverContractQuery;
 (function (ExportInventoryTurnoverContractQuery) {

package/build/commands/report/get-inventory-stock.query.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetInventoryStockContractQuery = void 0;
+const zod_1 = require("zod");
+const pagination_helper_1 = require("../../helpers/pagination.helper");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
+const inventory_stock_category_item_schema_1 = require("../../schemas/report/inventory-stock-category-item.schema");
+const inventory_stock_detailed_item_schema_1 = require("../../schemas/report/inventory-stock-detailed-item.schema");
+const GetInventoryStockRequestSchema = zod_1.z
+    .object({
+    categoryUUID: zod_1.z.uuid().optional().describe('Keep only the products of this category.'),
+    detailed: query_boolean_helper_1.queryBooleanSchema.describe('Pass "true" to group rows by product name / size / grower instead of by category only.'),
+    // Пагинация по строкам отчёта. Без count лимит не накладывается — отдаём весь отчёт,
+    // а page без count отклоняется: иначе листание молча возвращало бы одну и ту же выдачу.
+    page: zod_1.z.coerce.number().int().positive().optional().describe('1-based page number, requires "count".'),
+    count: zod_1.z.coerce.number().int().positive().optional().describe('Rows per page. Without it the whole report is returned.'),
+})
+    .refine(pagination_helper_1.isPageAccompaniedByCount, {
+    message: 'validation.pageRequiresCount',
+    path: ['page'],
+});
+const GetInventoryStockResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        list: zod_1.z.array(zod_1.z.union([inventory_stock_category_item_schema_1.InventoryStockCategoryItemSchema, inventory_stock_detailed_item_schema_1.InventoryStockDetailedItemSchema])),
+        // Число строк во всём отчёте — не размер страницы.
+        total: zod_1.z.number(),
+    }),
+});
+var GetInventoryStockContractQuery;
+(function (GetInventoryStockContractQuery) {
+    GetInventoryStockContractQuery.RequestSchema = GetInventoryStockRequestSchema;
+    GetInventoryStockContractQuery.ResponseSchema = GetInventoryStockResponseSchema;
+})(GetInventoryStockContractQuery || (exports.GetInventoryStockContractQuery = GetInventoryStockContractQuery = {}));

package/build/commands/report/get-inventory-turnover.query.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetInventoryTurnoverContractQuery = void 0;
+const zod_1 = require("zod");
+const date_helper_1 = require("../../helpers/date.helper");
+const pagination_helper_1 = require("../../helpers/pagination.helper");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
+const inventory_turnover_category_item_schema_1 = require("../../schemas/report/inventory-turnover-category-item.schema");
+const inventory_turnover_detailed_item_schema_1 = require("../../schemas/report/inventory-turnover-detailed-item.schema");
+const GetInventoryTurnoverRequestSchema = zod_1.z
+    .object({
+    // Даты обязательны: без периода оборачиваемость не считается (в отличие от export/*, где
+    // отсутствие дат приводило к ошибке уже внутри сервиса).
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+    categoryUUID: zod_1.z.uuid().optional().describe('Keep only the products of this category.'),
+    detailed: query_boolean_helper_1.queryBooleanSchema.describe('Pass "true" to group rows by product name / size / grower instead of by category only.'),
+    // Пагинация по строкам отчёта. Без count лимит не накладывается — отдаём весь отчёт,
+    // а page без count отклоняется: иначе листание молча возвращало бы одну и ту же выдачу.
+    page: zod_1.z.coerce.number().int().positive().optional().describe('1-based page number, requires "count".'),
+    count: zod_1.z.coerce.number().int().positive().optional().describe('Rows per page. Without it the whole report is returned.'),
+})
+    .refine(value => (0, date_helper_1.dateRangeCheck)(value.startDate, value.endDate), {
+    message: 'validation.dateRange',
+    path: ['endDate', 'startDate'],
+})
+    .refine(pagination_helper_1.isPageAccompaniedByCount, {
+    message: 'validation.pageRequiresCount',
+    path: ['page'],
+});
+const GetInventoryTurnoverResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        list: zod_1.z.array(zod_1.z.union([inventory_turnover_category_item_schema_1.InventoryTurnoverCategoryItemSchema, inventory_turnover_detailed_item_schema_1.InventoryTurnoverDetailedItemSchema])),
+        // Число строк во всём отчёте — не размер страницы.
+        total: zod_1.z.number(),
+    }),
+});
+var GetInventoryTurnoverContractQuery;
+(function (GetInventoryTurnoverContractQuery) {
+    GetInventoryTurnoverContractQuery.RequestSchema = GetInventoryTurnoverRequestSchema;
+    GetInventoryTurnoverContractQuery.ResponseSchema = GetInventoryTurnoverResponseSchema;
+})(GetInventoryTurnoverContractQuery || (exports.GetInventoryTurnoverContractQuery = GetInventoryTurnoverContractQuery = {}));

package/build/commands/report/get-report-by-client-weeks.query.js

@@ -3,12 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetReportByClientWeeksContractQuery = void 0;
 const zod_1 = require("zod");
 const date_helper_1 = require("../../helpers/date.helper");
+const pagination_helper_1 = require("../../helpers/pagination.helper");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
 const schemas_1 = require("../../schemas");
 const GetReportByClientWeeksRequestSchema = zod_1.z
     .object({
     startDate: zod_1.z.coerce.date(),
     endDate: zod_1.z.coerce.date(),
     responsibleUserUUID: zod_1.z.string().optional(),
+    // Отчёт — это матрица «неделя × клиент», поэтому по умолчанию отдаёт строку и на нулевые недели.
+    // Флаг оставляет только недели с заказами: то, что обычно и нужно, и на порядок меньше данных.
+    onlyWithOrders: query_boolean_helper_1.queryBooleanSchema,
+    // Фильтр по группе клиента (client."group") — дешёвый, применяется до CROSS JOIN недель.
+    clientGroup: zod_1.z.string().optional(),
+    // Пагинация по строкам матрицы. Без count лимит не накладывается — поведение по умолчанию
+    // прежнее, а page без count отклоняется: иначе листание молча возвращало бы одну и ту же выдачу.
+    page: zod_1.z.coerce.number().int().positive().optional(),
+    count: zod_1.z.coerce.number().int().positive().optional(),
 })
     .refine(value => {
     const { startDate, endDate } = value;
@@ -19,10 +30,18 @@ const GetReportByClientWeeksRequestSchema = zod_1.z
 }, {
     message: 'validation.dateRange',
     path: ['endDate', 'startDate'],
+})
+    .refine(pagination_helper_1.isPageAccompaniedByCount, {
+    message: 'validation.pageRequiresCount',
+    path: ['page'],
 });
 const GetReportGroupByClientResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: zod_1.z.array(schemas_1.ClientByWeeksSchema),
+    // `total` лежит РЯДОМ с data, а не внутри неё: панель читает `data` как плоский массив строк,
+    // и обёртка `{ list, total }` (как в остальных пагинируемых отчётах) сломала бы ей рендер.
+    // Без total последняя страница неотличима от полной выдачи.
+    total: zod_1.z.number().describe('Rows in the whole report, before "page"/"count" are applied.'),
 });
 var GetReportByClientWeeksContractQuery;
 (function (GetReportByClientWeeksContractQuery) {

package/build/commands/report/get-report-group-by-client.query.js

@@ -2,11 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetReportGroupByClientContactQuery = void 0;
 const zod_1 = require("zod");
+const enum_1 = require("../../enum");
 const date_helper_1 = require("../../helpers/date.helper");
 const GetReportGroupByClientRequestSchema = zod_1.z
     .object({
-    startDate: zod_1.z.coerce.date().transform(val => (val ? (0, date_helper_1.setStartDay)(val) : val)),
-    endDate: zod_1.z.coerce.date().transform(val => (val ? (0, date_helper_1.setEndDay)(val) : val)),
+    // Даты приходят «сырым» днём — раскладку в полуинтервал [start, endExclusive) делает сервис
+    // в таймзоне компании, как в cash-flow. Прежний setStartDay/setEndDay в UTC разворачивал день
+    // второй раз, и в таймзоне с плюсовым сдвигом конец периода уезжал на сутки вперёд.
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+    // Сортировка НЕ имеет значения по умолчанию: без явного sortBy/sortOrder строки отдаются
+    // в том порядке, в каком их вернул отчёт (панель рендерит map в порядке ключей, и тихая
+    // пересортировка меняла бы ей вид таблицы). Исключение — limit: он срезает хвост, что без
+    // сортировки бессмысленно, поэтому при limit применяется порядок «по прибыли, убывание».
+    sortBy: zod_1.z
+        .nativeEnum(enum_1.ReportSortByEnum)
+        .optional()
+        .describe('Sort metric. Without it (and without "limit") rows keep the report order.'),
+    sortOrder: zod_1.z.nativeEnum(enum_1.OrderByEnum).optional().describe('Sort direction. Defaults to "desc" once sorting applies.'),
+    // Без значения — ограничения нет: панель по-прежнему получает все строки.
+    limit: zod_1.z.coerce.number().int().positive().optional().describe('Keep only the top N rows; implies sorting by gross profit desc.'),
 })
     .refine(value => {
     const { startDate, endDate } = value;
@@ -38,6 +53,10 @@ const GetReportGroupByClientResponseSchema = zod_1.z.object({
             grossProfit: zod_1.z.number(),
             marginality: zod_1.z.number(),
         })),
+        // Аддитивно к прежней форме: число клиентов во ВСЁМ отчёте до усечения и применённый limit.
+        // Без них усечённый ответ неотличим от полного.
+        total: zod_1.z.number().describe('Client rows in the whole report, before "limit".'),
+        limit: zod_1.z.number().optional().describe('Row limit that actually cut rows off. Absent when the response is complete.'),
     }),
 });
 var GetReportGroupByClientContactQuery;

package/build/commands/report/get-report-group-by-position.query.js

@@ -8,8 +8,22 @@ const GetReportGroupByPositionRequestSchema = zod_1.z
     .object({
     type: zod_1.z.nativeEnum(enum_1.PositionReportTypeEnum).default(enum_1.PositionReportTypeEnum.PRODUCT),
     categoryUUID: zod_1.z.string().optional(),
-    startDate: zod_1.z.coerce.date().transform(val => (val ? (0, date_helper_1.setStartDay)(val) : val)),
-    endDate: zod_1.z.coerce.date().transform(val => (val ? (0, date_helper_1.setEndDay)(val) : val)),
+    // Даты приходят «сырым» днём — раскладку в полуинтервал [start, endExclusive) делает сервис
+    // в таймзоне компании, как в cash-flow. Прежний setStartDay/setEndDay в UTC разворачивал день
+    // второй раз, и в таймзоне с плюсовым сдвигом конец периода уезжал на сутки вперёд.
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+    // Сортировка НЕ имеет значения по умолчанию: без явного sortBy/sortOrder строки отдаются
+    // в том порядке, в каком их вернул отчёт (панель рендерит map в порядке ключей, и тихая
+    // пересортировка меняла бы ей вид таблицы). Исключение — limit: он срезает хвост, что без
+    // сортировки бессмысленно, поэтому при limit применяется порядок «по прибыли, убывание».
+    sortBy: zod_1.z
+        .nativeEnum(enum_1.ReportSortByEnum)
+        .optional()
+        .describe('Sort metric. Without it (and without "limit") rows keep the report order.'),
+    sortOrder: zod_1.z.nativeEnum(enum_1.OrderByEnum).optional().describe('Sort direction. Defaults to "desc" once sorting applies.'),
+    // Без значения — ограничения нет: панель по-прежнему получает все строки.
+    limit: zod_1.z.coerce.number().int().positive().optional().describe('Keep only the top N rows; implies sorting by gross profit desc.'),
 })
     .refine(value => {
     const { startDate, endDate } = value;
@@ -59,6 +73,11 @@ const GetReportGroupByPositionResponseSchema = zod_1.z.object({
             marginality: zod_1.z.number(),
         }))
             .optional(),
+        // Аддитивно к прежней форме: отчёт отдаёт ЛИБО категории, ЛИБО товары (при categoryUUID),
+        // поэтому total относится к той группировке, что вернулась. Вместе с limit это единственный
+        // способ отличить усечённый ответ от полного.
+        total: zod_1.z.number().describe('Rows in the whole report (of the returned grouping), before "limit".'),
+        limit: zod_1.z.number().optional().describe('Row limit that actually cut rows off. Absent when the response is complete.'),
     }),
 });
 var GetReportGroupByPositionContractQuery;

package/build/commands/report/get-sales-by-client.query.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSalesByClientContractQuery = void 0;
+const zod_1 = require("zod");
+const enum_1 = require("../../enum");
+const date_helper_1 = require("../../helpers/date.helper");
+const pagination_helper_1 = require("../../helpers/pagination.helper");
+const sales_by_client_row_schema_1 = require("../../schemas/report/sales-by-client-row.schema");
+const GetSalesByClientRequestSchema = zod_1.z
+    .object({
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+    // По умолчанию самые прибыльные клиенты сверху, чтобы count срезал хвост, а не топ.
+    sortBy: zod_1.z.nativeEnum(enum_1.ReportSortByEnum).optional().default(enum_1.ReportSortByEnum.GROSS_PROFIT),
+    sortOrder: zod_1.z.nativeEnum(enum_1.OrderByEnum).optional().default(enum_1.OrderByEnum.DESC),
+    // Пагинация по строкам отчёта. Без count лимит не накладывается — отдаём всех клиентов,
+    // а page без count отклоняется: иначе листание молча возвращало бы одну и ту же выдачу.
+    page: zod_1.z.coerce.number().int().positive().optional().describe('1-based page number, requires "count".'),
+    count: zod_1.z.coerce.number().int().positive().optional().describe('Rows per page. Without it every client row is returned.'),
+})
+    .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'],
+})
+    .refine(pagination_helper_1.isPageAccompaniedByCount, {
+    message: 'validation.pageRequiresCount',
+    path: ['page'],
+});
+const GetSalesByClientResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        list: zod_1.z.array(sales_by_client_row_schema_1.SalesByClientRowSchema),
+        // Число клиентов во всём отчёте — не размер страницы.
+        total: zod_1.z.number(),
+    }),
+});
+var GetSalesByClientContractQuery;
+(function (GetSalesByClientContractQuery) {
+    GetSalesByClientContractQuery.RequestSchema = GetSalesByClientRequestSchema;
+    GetSalesByClientContractQuery.ResponseSchema = GetSalesByClientResponseSchema;
+})(GetSalesByClientContractQuery || (exports.GetSalesByClientContractQuery = GetSalesByClientContractQuery = {}));

package/build/commands/report/index.js

@@ -28,3 +28,6 @@ __exportStar(require("./export-client-statement.query"), exports);
 __exportStar(require("./get-report-by-client-weeks.query"), exports);
 __exportStar(require("./get-daily-orders-summary.query"), exports);
 __exportStar(require("./get-cash-flow.query"), exports);
+__exportStar(require("./get-inventory-stock.query"), exports);
+__exportStar(require("./get-inventory-turnover.query"), exports);
+__exportStar(require("./get-sales-by-client.query"), exports);

package/build/commands/settings/get-company-profile.query.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCompanyProfileContractQuery = void 0;
+const zod_1 = require("zod");
+/**
+ * Company-level facts every panel role may read: who the company is, how it is named, which time
+ * zone its calendar days are counted in and which currency its figures are in. `companyUUID` is
+ * echoed so a caller can prove the profile belongs to its own tenant — the ADMIN-only
+ * `settings/for-admin` answer carries no such marker and cannot be cross-checked.
+ */
+const CompanyProfileSchema = zod_1.z.object({
+    companyUUID: zod_1.z.string(),
+    companyName: zod_1.z.string().nullable(),
+    timeZone: zod_1.z.string().nullable(),
+    currency: zod_1.z.string().nullable(),
+});
+const GetCompanyProfileResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: CompanyProfileSchema,
+});
+var GetCompanyProfileContractQuery;
+(function (GetCompanyProfileContractQuery) {
+    GetCompanyProfileContractQuery.ResponseSchema = GetCompanyProfileResponseSchema;
+})(GetCompanyProfileContractQuery || (exports.GetCompanyProfileContractQuery = GetCompanyProfileContractQuery = {}));

package/build/commands/settings/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./get-settings.query"), exports);
 __exportStar(require("./update-settings.command"), exports);
 __exportStar(require("./get-settings-for-admin.query"), exports);
+__exportStar(require("./get-company-profile.query"), exports);

package/build/enum/client-contract-status.enum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientContractStatusEnum = void 0;
+var ClientContractStatusEnum;
+(function (ClientContractStatusEnum) {
+    ClientContractStatusEnum["NONE"] = "NONE";
+    ClientContractStatusEnum["REQUIRED"] = "REQUIRED";
+    ClientContractStatusEnum["PREPARED"] = "PREPARED";
+    ClientContractStatusEnum["SENT"] = "SENT";
+    ClientContractStatusEnum["SIGNED"] = "SIGNED";
+    ClientContractStatusEnum["EXPIRED"] = "EXPIRED";
+    ClientContractStatusEnum["TERMINATED"] = "TERMINATED";
+})(ClientContractStatusEnum || (exports.ClientContractStatusEnum = ClientContractStatusEnum = {}));

package/build/enum/index.js

@@ -52,6 +52,7 @@ __exportStar(require("./order-distribute-status-list"), exports);
 __exportStar(require("./order-active-status-list"), exports);
 __exportStar(require("./order-price-correction-skipped-status-list"), exports);
 __exportStar(require("./client-status.enum"), exports);
+__exportStar(require("./client-contract-status.enum"), exports);
 __exportStar(require("./client-type.enum"), exports);
 __exportStar(require("./consignment-distribution-validation-status.enum"), exports);
 __exportStar(require("./consignment-distribution-validation-type.enum"), exports);
@@ -111,3 +112,5 @@ __exportStar(require("./legal-identifier-field.enum"), exports);
 __exportStar(require("./permission-key.enum"), exports);
 __exportStar(require("./cash-flow-item-status.enum"), exports);
 __exportStar(require("./payment-invoice-status.enum"), exports);
+__exportStar(require("./order-by.enum"), exports);
+__exportStar(require("./report-sort-by.enum"), exports);

package/build/enum/report-sort-by.enum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportSortByEnum = void 0;
+/**
+ * Метрика сортировки для отчётов-группировок (по позициям и по клиентам).
+ * Значения совпадают с именами полей ответа, чтобы клиент мог сортировать «по тому, что видит».
+ */
+var ReportSortByEnum;
+(function (ReportSortByEnum) {
+    ReportSortByEnum["GROSS_PROFIT"] = "grossProfit";
+    ReportSortByEnum["TOTAL_SALES"] = "totalSales";
+    ReportSortByEnum["SOLD_UNITS"] = "soldUnits";
+})(ReportSortByEnum || (exports.ReportSortByEnum = ReportSortByEnum = {}));

package/build/helpers/index.js

@@ -15,3 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./date.helper"), exports);
+__exportStar(require("./pagination.helper"), exports);
+__exportStar(require("./query-boolean.helper"), exports);

package/build/helpers/pagination.helper.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPageAccompaniedByCount = void 0;
+/**
+ * `page` имеет смысл только вместе с `count`.
+ *
+ * Раньше `page` без `count` молча игнорировался и отчёт отдавался целиком: агент, листающий
+ * страницы, бесконечно получал одну и ту же выдачу и не мог отличить это от «страниц больше нет».
+ * Поэтому неполная пара отклоняется валидацией — единообразно во всех постраничных отчётах.
+ */
+const isPageAccompaniedByCount = (value) => value.page === undefined || value.count !== undefined;
+exports.isPageAccompaniedByCount = isPageAccompaniedByCount;

package/build/helpers/query-boolean.helper.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryBooleanSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Boolean-флаг, приходящий в query-строке.
+ *
+ * Не `z.coerce.boolean()`: в query всегда приходит текст, а `Boolean('false') === true` —
+ * такой флаг невозможно выключить явным значением. Принимаем `true` / `1` как включение,
+ * всё остальное — выключение. По умолчанию флаг выключен, чтобы поведение без параметра не менялось.
+ */
+exports.queryBooleanSchema = zod_1.z
+    .union([zod_1.z.boolean(), zod_1.z.string()])
+    .optional()
+    .default(false)
+    .transform(value => (typeof value === 'boolean' ? value : value === 'true' || value === '1'));

package/build/schemas/client/client.schema.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientExtendedListSchema = exports.ClientExtendedSchema = exports.ClientSchema = void 0;
 const zod_1 = require("zod");
 const client_status_enum_1 = require("../../enum/client-status.enum");
+const client_contract_status_enum_1 = require("../../enum/client-contract-status.enum");
 const client_type_enum_1 = require("../../enum/client-type.enum");
 const user_schema_1 = require("../user/user.schema");
 const client_individual_profile_schema_1 = require("./client-individual-profile.schema");
@@ -19,6 +20,7 @@ exports.ClientSchema = zod_1.z.object({
     isCommon: zod_1.z.boolean(),
     contractNumber: zod_1.z.string().nullable(),
     contractDate: zod_1.z.date().nullable(),
+    contractStatus: zod_1.z.nativeEnum(client_contract_status_enum_1.ClientContractStatusEnum),
     address: zod_1.z.string().nullable(),
     city: zod_1.z.string().nullable(),
     code: zod_1.z.string().nullable(),

package/build/schemas/index.js

@@ -38,6 +38,7 @@ __exportStar(require("./product-image/product-image.schema"), exports);
 __exportStar(require("./settings/settings.schema"), exports);
 __exportStar(require("./payment-invoice/payment-invoice.schema"), exports);
 __exportStar(require("./money-account/money-account.schema"), exports);
+__exportStar(require("./money-account/money-account-with-balance.schema"), exports);
 __exportStar(require("./domain/domain.schema"), exports);
 __exportStar(require("./category/category.schema"), exports);
 __exportStar(require("./branch/branch.schema"), exports);
@@ -68,6 +69,12 @@ __exportStar(require("./consignment/consignment-distribution-validation.schema")
 __exportStar(require("./product-image-template/product-image-template.schema"), exports);
 __exportStar(require("./report/client-statement.schema"), exports);
 __exportStar(require("./report/client-by-weeks.schema"), exports);
+__exportStar(require("./report/inventory-stock-category-item.schema"), exports);
+__exportStar(require("./report/inventory-stock-detailed-item.schema"), exports);
+__exportStar(require("./report/inventory-turnover-category-item.schema"), exports);
+__exportStar(require("./report/inventory-turnover-detailed-item.schema"), exports);
+__exportStar(require("./report/sales-by-client-top-item.schema"), exports);
+__exportStar(require("./report/sales-by-client-row.schema"), exports);
 __exportStar(require("./action-log/index"), exports);
 __exportStar(require("./delivery-route/delivery-route.schema"), exports);
 __exportStar(require("./product/product-multiplicity-option.schema"), exports);