@floristcloud/api-lib 1.2.126 → 1.2.128

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

@@ -18,6 +18,9 @@ const GetClientDebtListRequestSchema = zod_1.z.object({
     onlyWithDebt: query_boolean_helper_1.queryBooleanSchema,
     onlyOverdue: query_boolean_helper_1.queryBooleanSchema,
     clientUUIDList: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+    // «Долг на дату»: расчёт ведётся ПО КОНЕЦ выбранного дня включительно, сутки разворачивает бэк
+    // по таймзоне компании. Без параметра берётся сальдо «сейчас» — то, что лежит в client.balance.
+    onDate: zod_1.z.coerce.date().optional().describe('Calculate the debt as of the end of this calendar day instead of now.'),
 });
 const GetClientDebtListResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/report/get-daily-orders-summary.query.js

@@ -2,12 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetDailyOrdersSummaryContractQuery = void 0;
 const zod_1 = require("zod");
+const order_status_enum_1 = require("../../enum/order-status.enum");
+const report_order_date_basis_enum_1 = require("../../enum/report-order-date-basis.enum");
 const date_helper_1 = require("../../helpers/date.helper");
 const money_schema_1 = require("../../schemas/money.schema");
 const GetDailyOrdersSummaryRequestSchema = zod_1.z
     .object({
     startDate: zod_1.z.coerce.date(),
     endDate: zod_1.z.coerce.date(),
+    // Ось периода — общая с отчётами продаж, чтобы сводка и отчёт за тот же период не разошлись
+    // в семантике. Дизъюнкции «любая из дат» здесь нет намеренно, см. ReportOrderDateBasisEnum.
+    //
+    // COMPLETED_AT сужает сводку до отгруженных заказов: даты отгрузки у остальных статусов
+    // просто нет. Поэтому на этой оси ordersCompleted равен ordersCreated, а фильтр по любому
+    // статусу кроме COMPLETED даёт нули — на фронте эти два фильтра совмещать не нужно.
+    dateBasis: zod_1.z.nativeEnum(report_order_date_basis_enum_1.ReportOrderDateBasisEnum).default(report_order_date_basis_enum_1.ReportOrderDateBasisEnum.CREATED_AT),
+    // Необязательное сужение по статусу. Принимается и CSV (`?status=NEW,ACCEPTED`), и повтор
+    // параметра — как excludeClientUUID в ReportOrderFilterSchema.
+    //
+    // Служебные статусы здесь НЕ отсеиваются, хотя в сводку они и так не попадают: отсев на
+    // этом слое означал бы «фильтр пуст → фильтра нет», и `?status=TEMPLATE` вернул бы весь
+    // отчёт вместо нулей. Отбрасывает их билдер — там пустой результат остаётся пустым.
+    status: zod_1.z
+        .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
+        .transform(value => (Array.isArray(value) ? value : value.split(',')).map(item => item.trim()).filter(Boolean))
+        .pipe(zod_1.z.array(zod_1.z.nativeEnum(order_status_enum_1.OrderStatusEnum)))
+        .optional(),
 })
     .refine(value => (0, date_helper_1.dateRangeCheck)(value.startDate, value.endDate), {
     message: 'validation.dateRange',
@@ -26,6 +46,9 @@ const metricsShape = {
     ordersCreated: zod_1.z.number(),
     ordersCompleted: zod_1.z.number(),
     totalSum: money_schema_1.MoneySchema,
+    // Часть totalSum по заказам со статусом COMPLETED. На оси COMPLETED_AT равна totalSum:
+    // там весь срез и так отгружен.
+    completedSum: money_schema_1.MoneySchema,
     unitsByMeasure: UnitsByMeasureSchema,
 };
 const DailyOrdersSummaryTotalsSchema = zod_1.z.object(Object.assign({}, metricsShape));

package/build/enum/index.js

@@ -116,6 +116,7 @@ __exportStar(require("./payment-invoice-status.enum"), exports);
 __exportStar(require("./order-by.enum"), exports);
 __exportStar(require("./report-sort-by.enum"), exports);
 __exportStar(require("./report-order-date-basis.enum"), exports);
+__exportStar(require("./report-excluded-order-status-list"), exports);
 __exportStar(require("./invoice-product-field.enum"), exports);
 __exportStar(require("./transfer-document-state.enum"), exports);
 __exportStar(require("./transfer-document-kind.enum"), exports);

package/build/enum/report-excluded-order-status-list.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportExcludedOrderStatusList = void 0;
+const order_status_enum_1 = require("./order-status.enum");
+/**
+ * Служебные статусы заказа: шаблон и заготовка импорта. Это не продажи, поэтому из отчётов по
+ * заказам они выкидываются всегда — в том числе когда пользователь явно фильтрует по статусу.
+ */
+exports.ReportExcludedOrderStatusList = [order_status_enum_1.OrderStatusEnum.TEMPLATE, order_status_enum_1.OrderStatusEnum.IMPORTED];

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

@@ -16,6 +16,9 @@ const GetClientDebtListRequestSchema = z.object({
     onlyWithDebt: queryBooleanSchema,
     onlyOverdue: queryBooleanSchema,
     clientUUIDList: z.array(z.string().uuid()).optional(),
+    // «Долг на дату»: расчёт ведётся ПО КОНЕЦ выбранного дня включительно, сутки разворачивает бэк
+    // по таймзоне компании. Без параметра берётся сальдо «сейчас» — то, что лежит в client.balance.
+    onDate: z.coerce.date().optional().describe('Calculate the debt as of the end of this calendar day instead of now.'),
 });
 
 const GetClientDebtListResponseSchema = z.object({

package/commands/report/get-daily-orders-summary.query.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { OrderStatusEnum } from '../../enum/order-status.enum';
+import { ReportOrderDateBasisEnum } from '../../enum/report-order-date-basis.enum';
 import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
 import { MoneySchema } from '../../schemas/money.schema';
 
@@ -6,6 +8,24 @@ const GetDailyOrdersSummaryRequestSchema = z
     .object({
         startDate: z.coerce.date(),
         endDate: z.coerce.date(),
+        // Ось периода — общая с отчётами продаж, чтобы сводка и отчёт за тот же период не разошлись
+        // в семантике. Дизъюнкции «любая из дат» здесь нет намеренно, см. ReportOrderDateBasisEnum.
+        //
+        // COMPLETED_AT сужает сводку до отгруженных заказов: даты отгрузки у остальных статусов
+        // просто нет. Поэтому на этой оси ordersCompleted равен ordersCreated, а фильтр по любому
+        // статусу кроме COMPLETED даёт нули — на фронте эти два фильтра совмещать не нужно.
+        dateBasis: z.nativeEnum(ReportOrderDateBasisEnum).default(ReportOrderDateBasisEnum.CREATED_AT),
+        // Необязательное сужение по статусу. Принимается и CSV (`?status=NEW,ACCEPTED`), и повтор
+        // параметра — как excludeClientUUID в ReportOrderFilterSchema.
+        //
+        // Служебные статусы здесь НЕ отсеиваются, хотя в сводку они и так не попадают: отсев на
+        // этом слое означал бы «фильтр пуст → фильтра нет», и `?status=TEMPLATE` вернул бы весь
+        // отчёт вместо нулей. Отбрасывает их билдер — там пустой результат остаётся пустым.
+        status: z
+            .union([z.string(), z.array(z.string())])
+            .transform(value => (Array.isArray(value) ? value : value.split(',')).map(item => item.trim()).filter(Boolean))
+            .pipe(z.array(z.nativeEnum(OrderStatusEnum)))
+            .optional(),
     })
     .refine(value => dateRangeCheck(value.startDate, value.endDate), {
         message: 'validation.dateRange',
@@ -26,6 +46,9 @@ const metricsShape = {
     ordersCreated: z.number(),
     ordersCompleted: z.number(),
     totalSum: MoneySchema,
+    // Часть totalSum по заказам со статусом COMPLETED. На оси COMPLETED_AT равна totalSum:
+    // там весь срез и так отгружен.
+    completedSum: MoneySchema,
     unitsByMeasure: UnitsByMeasureSchema,
 };
 

package/enum/index.ts

@@ -100,6 +100,7 @@ export * from './payment-invoice-status.enum';
 export * from './order-by.enum';
 export * from './report-sort-by.enum';
 export * from './report-order-date-basis.enum';
+export * from './report-excluded-order-status-list';
 export * from './invoice-product-field.enum';
 export * from './transfer-document-state.enum';
 export * from './transfer-document-kind.enum';

package/enum/report-excluded-order-status-list.ts

@@ -0,0 +1,7 @@
+import { OrderStatusEnum } from './order-status.enum';
+
+/**
+ * Служебные статусы заказа: шаблон и заготовка импорта. Это не продажи, поэтому из отчётов по
+ * заказам они выкидываются всегда — в том числе когда пользователь явно фильтрует по статусу.
+ */
+export const ReportExcludedOrderStatusList: OrderStatusEnum[] = [OrderStatusEnum.TEMPLATE, OrderStatusEnum.IMPORTED];

package/package.json

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