@floristcloud/api-lib 1.2.127 → 1.2.129

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/discount-rules-mode-type.enum.js

@@ -5,4 +5,13 @@ var DiscountRulesModeTypeEnum;
 (function (DiscountRulesModeTypeEnum) {
     DiscountRulesModeTypeEnum["FIXED"] = "FIXED";
     DiscountRulesModeTypeEnum["PERCENT"] = "PERCENT";
+    /**
+     * Готовая цена, а не величина скидки.
+     *
+     * Значение вычисляемое: его выставляет правило `COST_PLUS_MARKUP`, посчитав цену от
+     * себестоимости товара. Задать его снаружи нельзя — схема ввода правила
+     * (`discountRulesModeSchema`) знает только FIXED и PERCENT, а схема выдачи
+     * (`discountPriceOutcomeSchema`) — все три.
+     */
+    DiscountRulesModeTypeEnum["TARGET_PRICE"] = "TARGET_PRICE";
 })(DiscountRulesModeTypeEnum || (exports.DiscountRulesModeTypeEnum = DiscountRulesModeTypeEnum = {}));

package/build/enum/discount-rules-type.enum.js

@@ -8,4 +8,5 @@ var DiscountRulesTypeEnum;
     DiscountRulesTypeEnum["QUANTITY_BASED"] = "QUANTITY_BASED";
     DiscountRulesTypeEnum["ITEM_DISCOUNT"] = "ITEM_DISCOUNT";
     DiscountRulesTypeEnum["DISCOUNT_PROHIBITED"] = "DISCOUNT_PROHIBITED";
+    DiscountRulesTypeEnum["COST_PLUS_MARKUP"] = "COST_PLUS_MARKUP";
 })(DiscountRulesTypeEnum || (exports.DiscountRulesTypeEnum = DiscountRulesTypeEnum = {}));

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/build/schemas/discount-rules/discount-rules.schema.js

@@ -1,19 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DiscountRulesExtendedSchema = exports.DiscountRulesSplitQuantityForClientSchema = exports.DiscountRulesSplitQuantityResponseSchema = exports.DiscountRulesSplitQuantitySchema = exports.DiscountRulesBaseExtendedSchema = exports.DiscountRulesListSchema = exports.UpdateDiscountRulesSchema = exports.CreateDiscountRulesSchema = exports.DiscountRulesSchema = exports.DiscountRulesBaseSchema = exports.DiscountRulesTypeSchema = exports.discountRulesModeSchema = void 0;
+exports.DiscountRulesExtendedSchema = exports.DiscountRulesSplitQuantityForClientSchema = exports.DiscountRulesSplitQuantityResponseSchema = exports.DiscountRulesSplitQuantitySchema = exports.DiscountRulesBaseExtendedSchema = exports.DiscountRulesListSchema = exports.UpdateDiscountRulesSchema = exports.CreateDiscountRulesSchema = exports.DiscountRulesSchema = exports.DiscountRulesBaseSchema = exports.DiscountRulesTypeSchema = exports.discountPriceOutcomeSchema = exports.discountRulesModeSchema = void 0;
 const zod_1 = require("zod");
 const enum_1 = require("../../enum");
 const client_1 = require("../client");
 const product_schema_1 = require("../product/product.schema");
 const money_schema_1 = require("../money.schema");
+const non_negative_money_schema_1 = require("../non-negative-money.schema");
 const positive_money_schema_1 = require("../positive-money.schema");
 // PERCENT — это процент, а не деньги: остаётся числом 0..100. FIXED — денежная величина, едет строкой.
-exports.discountRulesModeSchema = zod_1.z.discriminatedUnion('typeDiscount', [
-    zod_1.z.object({ typeDiscount: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.PERCENT), discountValue: zod_1.z.number().min(0).max(100) }),
+const discountPercentModeSchema = zod_1.z.object({
+    typeDiscount: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.PERCENT),
+    discountValue: zod_1.z.number().min(0).max(100),
+});
+const discountFixedModeSchema = zod_1.z.object({
+    typeDiscount: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.FIXED),
+    // Строго положительная сумма: минус отсекаем по знаку строки, нули вида "0" / "0.00" — сравнением.
+    discountValue: positive_money_schema_1.PositiveMoneySchema,
+});
+exports.discountRulesModeSchema = zod_1.z.discriminatedUnion('typeDiscount', [discountPercentModeSchema, discountFixedModeSchema]);
+/**
+ * Итог применения правила к товару — то, что уезжает клиенту в `discountDataList`.
+ *
+ * От схемы ввода отличается ровно одной веткой: TARGET_PRICE несёт уже посчитанную цену, а не
+ * величину скидки. Так работает правило от себестоимости: считать цену на клиенте нечем — там нет
+ * ни себестоимости, ни права её видеть. Ветка живёт только в выдаче: задать TARGET_PRICE при
+ * создании правила нельзя, `discountRulesModeSchema` его не принимает.
+ */
+exports.discountPriceOutcomeSchema = zod_1.z.discriminatedUnion('typeDiscount', [
+    discountPercentModeSchema,
+    discountFixedModeSchema,
     zod_1.z.object({
-        typeDiscount: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.FIXED),
-        // Строго положительная сумма: минус отсекаем по знаку строки, нули вида "0" / "0.00" — сравнением.
-        discountValue: positive_money_schema_1.PositiveMoneySchema,
+        typeDiscount: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.TARGET_PRICE),
+        // Ноль допустим: себестоимость может быть нулевой, а наценка — нулевой по условию правила.
+        targetPrice: non_negative_money_schema_1.NonNegativeMoneySchema,
     }),
 ]);
 // Rules schemas other data
@@ -40,6 +60,19 @@ const DiscountRulesQuantityBasedDataSchema = zod_1.z
     .and(exports.discountRulesModeSchema);
 const DiscountRulesItemDiscountDataSchema = exports.discountRulesModeSchema;
 const DiscountRulesDiscountProhibitedDataSchema = zod_1.z.object({}).default({});
+/**
+ * Наценка к себестоимости: цена клиента = себестоимость + наценка.
+ *
+ * Три отличия от режима скидки, и все намеренные:
+ * — только вверх, знака у величины нет: продажу ниже себестоимости правилом не задают;
+ * — ноль допустим (`markupValue: 0` — продаём по себестоимости), поэтому FIXED берёт
+ *   `NonNegativeMoneySchema`, а не `PositiveMoneySchema`;
+ * — у процента нет верхней границы: наценка в 150 % законна, в отличие от скидки в 150 %.
+ */
+const DiscountRulesCostPlusMarkupDataSchema = zod_1.z.discriminatedUnion('typeMarkup', [
+    zod_1.z.object({ typeMarkup: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.PERCENT), markupValue: zod_1.z.number().min(0) }),
+    zod_1.z.object({ typeMarkup: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.FIXED), markupValue: non_negative_money_schema_1.NonNegativeMoneySchema }),
+]);
 exports.DiscountRulesTypeSchema = zod_1.z.discriminatedUnion('type', [
     zod_1.z.object({
         type: zod_1.z.literal(enum_1.DiscountRulesTypeEnum.PERSONAL_DISCOUNT),
@@ -61,6 +94,10 @@ exports.DiscountRulesTypeSchema = zod_1.z.discriminatedUnion('type', [
         type: zod_1.z.literal(enum_1.DiscountRulesTypeEnum.DISCOUNT_PROHIBITED),
         data: DiscountRulesDiscountProhibitedDataSchema,
     }),
+    zod_1.z.object({
+        type: zod_1.z.literal(enum_1.DiscountRulesTypeEnum.COST_PLUS_MARKUP),
+        data: DiscountRulesCostPlusMarkupDataSchema,
+    }),
 ]);
 exports.DiscountRulesBaseSchema = zod_1.z.object({
     uuid: zod_1.z.string(),

package/build/schemas/product/product.schema.js

@@ -95,7 +95,7 @@ exports.ProductExtendedForClientSchema = exports.ProductForClientSchema.merge(zo
         .object({
         discountRulesUUID: zod_1.z.string(),
         type: zod_1.z.nativeEnum(enum_1.DiscountRulesTypeEnum),
-        discountValueData: discount_rules_schema_1.discountRulesModeSchema,
+        discountValueData: discount_rules_schema_1.discountPriceOutcomeSchema,
         priceWithDiscount: money_schema_1.MoneySchema,
         multipleQuantity: zod_1.z.number().optional(),
     })

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/discount-rules-mode-type.enum.ts

@@ -1,4 +1,13 @@
 export enum DiscountRulesModeTypeEnum {
     FIXED = 'FIXED',
     PERCENT = 'PERCENT',
+    /**
+     * Готовая цена, а не величина скидки.
+     *
+     * Значение вычисляемое: его выставляет правило `COST_PLUS_MARKUP`, посчитав цену от
+     * себестоимости товара. Задать его снаружи нельзя — схема ввода правила
+     * (`discountRulesModeSchema`) знает только FIXED и PERCENT, а схема выдачи
+     * (`discountPriceOutcomeSchema`) — все три.
+     */
+    TARGET_PRICE = 'TARGET_PRICE',
 }

package/enum/discount-rules-type.enum.ts

@@ -4,4 +4,5 @@ export enum DiscountRulesTypeEnum {
     QUANTITY_BASED = 'QUANTITY_BASED',
     ITEM_DISCOUNT = 'ITEM_DISCOUNT',
     DISCOUNT_PROHIBITED = 'DISCOUNT_PROHIBITED',
+    COST_PLUS_MARKUP = 'COST_PLUS_MARKUP',
 }

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.127",
+    "version": "1.2.129",
     "description": "",
     "main": "./build/index.js",
     "scripts": {

package/schemas/discount-rules/discount-rules.schema.ts

@@ -3,15 +3,38 @@ import { DiscountRulesTypeEnum, DiscountRulesApplyTypeEnum, DiscountRulesStatusE
 import { ClientSchema } from '../client';
 import { ProductSchema } from '../product/product.schema';
 import { MoneySchema } from '../money.schema';
+import { NonNegativeMoneySchema } from '../non-negative-money.schema';
 import { PositiveMoneySchema } from '../positive-money.schema';
 
 // PERCENT — это процент, а не деньги: остаётся числом 0..100. FIXED — денежная величина, едет строкой.
-export const discountRulesModeSchema = z.discriminatedUnion('typeDiscount', [
-    z.object({ typeDiscount: z.literal(DiscountRulesModeTypeEnum.PERCENT), discountValue: z.number().min(0).max(100) }),
+const discountPercentModeSchema = z.object({
+    typeDiscount: z.literal(DiscountRulesModeTypeEnum.PERCENT),
+    discountValue: z.number().min(0).max(100),
+});
+
+const discountFixedModeSchema = z.object({
+    typeDiscount: z.literal(DiscountRulesModeTypeEnum.FIXED),
+    // Строго положительная сумма: минус отсекаем по знаку строки, нули вида "0" / "0.00" — сравнением.
+    discountValue: PositiveMoneySchema,
+});
+
+export const discountRulesModeSchema = z.discriminatedUnion('typeDiscount', [discountPercentModeSchema, discountFixedModeSchema]);
+
+/**
+ * Итог применения правила к товару — то, что уезжает клиенту в `discountDataList`.
+ *
+ * От схемы ввода отличается ровно одной веткой: TARGET_PRICE несёт уже посчитанную цену, а не
+ * величину скидки. Так работает правило от себестоимости: считать цену на клиенте нечем — там нет
+ * ни себестоимости, ни права её видеть. Ветка живёт только в выдаче: задать TARGET_PRICE при
+ * создании правила нельзя, `discountRulesModeSchema` его не принимает.
+ */
+export const discountPriceOutcomeSchema = z.discriminatedUnion('typeDiscount', [
+    discountPercentModeSchema,
+    discountFixedModeSchema,
     z.object({
-        typeDiscount: z.literal(DiscountRulesModeTypeEnum.FIXED),
-        // Строго положительная сумма: минус отсекаем по знаку строки, нули вида "0" / "0.00" — сравнением.
-        discountValue: PositiveMoneySchema,
+        typeDiscount: z.literal(DiscountRulesModeTypeEnum.TARGET_PRICE),
+        // Ноль допустим: себестоимость может быть нулевой, а наценка — нулевой по условию правила.
+        targetPrice: NonNegativeMoneySchema,
     }),
 ]);
 
@@ -44,6 +67,20 @@ const DiscountRulesItemDiscountDataSchema = discountRulesModeSchema;
 
 const DiscountRulesDiscountProhibitedDataSchema = z.object({}).default({});
 
+/**
+ * Наценка к себестоимости: цена клиента = себестоимость + наценка.
+ *
+ * Три отличия от режима скидки, и все намеренные:
+ * — только вверх, знака у величины нет: продажу ниже себестоимости правилом не задают;
+ * — ноль допустим (`markupValue: 0` — продаём по себестоимости), поэтому FIXED берёт
+ *   `NonNegativeMoneySchema`, а не `PositiveMoneySchema`;
+ * — у процента нет верхней границы: наценка в 150 % законна, в отличие от скидки в 150 %.
+ */
+const DiscountRulesCostPlusMarkupDataSchema = z.discriminatedUnion('typeMarkup', [
+    z.object({ typeMarkup: z.literal(DiscountRulesModeTypeEnum.PERCENT), markupValue: z.number().min(0) }),
+    z.object({ typeMarkup: z.literal(DiscountRulesModeTypeEnum.FIXED), markupValue: NonNegativeMoneySchema }),
+]);
+
 export const DiscountRulesTypeSchema = z.discriminatedUnion('type', [
     z.object({
         type: z.literal(DiscountRulesTypeEnum.PERSONAL_DISCOUNT),
@@ -65,6 +102,10 @@ export const DiscountRulesTypeSchema = z.discriminatedUnion('type', [
         type: z.literal(DiscountRulesTypeEnum.DISCOUNT_PROHIBITED),
         data: DiscountRulesDiscountProhibitedDataSchema,
     }),
+    z.object({
+        type: z.literal(DiscountRulesTypeEnum.COST_PLUS_MARKUP),
+        data: DiscountRulesCostPlusMarkupDataSchema,
+    }),
 ]);
 
 export const DiscountRulesBaseSchema = z.object({

package/schemas/product/product.schema.ts

@@ -4,7 +4,7 @@ import { CategorySchema } from '../category/category.schema';
 import { TypeSchema } from '../type/type.schema';
 import { ConsignmentSchema } from '../consignment/consignment.schema';
 import { DiscountRulesTypeEnum, ProductMarkEnum, SalesUnitEnum } from '../../enum';
-import { discountRulesModeSchema } from '../discount-rules/discount-rules.schema';
+import { discountPriceOutcomeSchema } from '../discount-rules/discount-rules.schema';
 import { ProductMultiplicityOptionSchema } from '../..';
 import { ProductMultiplicityOptionForClientSchema } from './product-multiplicity-option-for-client.schema';
 import { MoneySchema } from '../money.schema';
@@ -102,7 +102,7 @@ export const ProductExtendedForClientSchema = ProductForClientSchema.merge(
             .object({
                 discountRulesUUID: z.string(),
                 type: z.nativeEnum(DiscountRulesTypeEnum),
-                discountValueData: discountRulesModeSchema,
+                discountValueData: discountPriceOutcomeSchema,
                 priceWithDiscount: MoneySchema,
                 multipleQuantity: z.number().optional(),
             })