@floristcloud/api-lib 1.2.167 → 1.2.168

package/build/constant/discount-rules-pricing-type-list.constant.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISCOUNT_RULES_PRICING_TYPE_LIST = void 0;
+const discount_rules_type_enum_1 = require("../enum/discount-rules-type.enum");
+/**
+ * Правила ценообразования: задают цену клиента целиком, а не уменьшают её.
+ *
+ * Цена от себестоимости или от прайса плюс наценка. Если у клиента есть такое правило, скидки к нему не
+ * применяются, и больше одного действующего правила ценообразования на клиента быть не может.
+ */
+exports.DISCOUNT_RULES_PRICING_TYPE_LIST = [
+    discount_rules_type_enum_1.DiscountRulesTypeEnum.COST_PLUS_MARKUP,
+    discount_rules_type_enum_1.DiscountRulesTypeEnum.PRICE_PLUS_MARKUP,
+];

package/build/constant/error.js

@@ -1363,6 +1363,17 @@ exports.ERRORS = {
         message: 'Too many products for a single consignment discount operation',
         httpCode: 400,
     },
+    DISCOUNT_RULES_PRICING_RULE_CONFLICT: {
+        code: 'DR007',
+        message: 'A client can have only one active pricing rule',
+        httpCode: 409,
+    },
+    // Не дождались транзакционной блокировки правил ценообразования компании (lock_timeout).
+    DISCOUNT_RULES_PRICING_RULE_LOCK_BUSY: {
+        code: 'DR008',
+        message: 'Pricing rules of this company are being changed right now, try again',
+        httpCode: 409,
+    },
     DISCOUNT_RULES_NOT_FOUND: { code: 'DR010', message: 'Discount-rules not found', httpCode: 404 },
     // ACTION LOG
     ACTION_LOG_NOT_CREATED: { code: 'ALG001', message: 'Failed to create action-log', httpCode: 500 },

package/build/constant/index.js

@@ -31,3 +31,4 @@ __exportStar(require("./product-image-merge.constant"), exports);
 __exportStar(require("./client-group-actions.constant"), exports);
 __exportStar(require("./standing-order-positions.constant"), exports);
 __exportStar(require("./order-external-number.constant"), exports);
+__exportStar(require("./discount-rules-pricing-type-list.constant"), exports);

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

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

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

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

package/build/schemas/discount-rules/discount-rules.schema.js

@@ -22,10 +22,9 @@ exports.discountRulesModeSchema = zod_1.z.discriminatedUnion('typeDiscount', [di
 /**
  * Итог применения правила к товару — то, что уезжает клиенту в `discountDataList`.
  *
- * От схемы ввода отличается ровно одной веткой: TARGET_PRICE несёт уже посчитанную цену, а не
- * величину скидки. Так работает правило от себестоимости: считать цену на клиенте нечем — там нет
- * ни себестоимости, ни права её видеть. Ветка живёт только в выдаче: задать TARGET_PRICE при
- * создании правила нельзя, `discountRulesModeSchema` его не принимает.
+ * Ветка TARGET_PRICE больше не отдаётся: правило от себестоимости стало правилом ценообразования и
+ * задаёт цену клиента (`price`, `clientPrice`), а не вариант скидки. Ветка оставлена, чтобы не ломать
+ * клиентов, которые её разбирают.
  */
 exports.discountPriceOutcomeSchema = zod_1.z.discriminatedUnion('typeDiscount', [
     discountPercentModeSchema,
@@ -61,18 +60,29 @@ const DiscountRulesQuantityBasedDataSchema = zod_1.z
 const DiscountRulesItemDiscountDataSchema = exports.discountRulesModeSchema;
 const DiscountRulesDiscountProhibitedDataSchema = zod_1.z.object({}).default({});
 /**
- * Наценка к себестоимости: цена клиента = себестоимость + наценка.
+ * Наценка правила ценообразования: процент или сумма на единицу.
  *
- * Три отличия от режима скидки, и все намеренные:
- * — только вверх, знака у величины нет: продажу ниже себестоимости правилом не задают;
- * — ноль допустим (`markupValue: 0` — продаём по себестоимости), поэтому FIXED берёт
- *   `NonNegativeMoneySchema`, а не `PositiveMoneySchema`;
+ * Отличия от режима скидки намеренные:
+ * — только вверх, знака у величины нет;
+ * — ноль допустим (цена ровно равна источнику), поэтому FIXED берёт `NonNegativeMoneySchema`;
  * — у процента нет верхней границы: наценка в 150 % законна, в отличие от скидки в 150 %.
  */
+const pricingMarkupPercentSchema = zod_1.z.object({ typeMarkup: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.PERCENT), markupValue: zod_1.z.number().min(0) });
+const pricingMarkupFixedSchema = zod_1.z.object({ typeMarkup: zod_1.z.literal(enum_1.DiscountRulesModeTypeEnum.FIXED), markupValue: non_negative_money_schema_1.NonNegativeMoneySchema });
+/**
+ * Потолок «не выше прайса» есть только у цены от себестоимости: цена от прайса с наценкой выше
+ * прайса по определению. Поле необязательное, и отсутствие значит разное: при создании — потолка
+ * нет, при правке — оставить как было. Так старая панель, которая флага не знает, не снимает потолок
+ * у правил, которым его проставила миграция.
+ */
+const costPlusCapShape = { isCappedByPrice: zod_1.z.boolean().optional() };
+/** Цена клиента = себестоимость + наценка. */
 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 }),
+    pricingMarkupPercentSchema.extend(costPlusCapShape),
+    pricingMarkupFixedSchema.extend(costPlusCapShape),
 ]);
+/** Цена клиента = цена позиции (фасовки, если она выбрана) + наценка. */
+const DiscountRulesPricePlusMarkupDataSchema = zod_1.z.discriminatedUnion('typeMarkup', [pricingMarkupPercentSchema, pricingMarkupFixedSchema]);
 exports.DiscountRulesTypeSchema = zod_1.z.discriminatedUnion('type', [
     zod_1.z.object({
         type: zod_1.z.literal(enum_1.DiscountRulesTypeEnum.PERSONAL_DISCOUNT),
@@ -98,6 +108,10 @@ exports.DiscountRulesTypeSchema = zod_1.z.discriminatedUnion('type', [
         type: zod_1.z.literal(enum_1.DiscountRulesTypeEnum.COST_PLUS_MARKUP),
         data: DiscountRulesCostPlusMarkupDataSchema,
     }),
+    zod_1.z.object({
+        type: zod_1.z.literal(enum_1.DiscountRulesTypeEnum.PRICE_PLUS_MARKUP),
+        data: DiscountRulesPricePlusMarkupDataSchema,
+    }),
 ]);
 exports.DiscountRulesBaseSchema = zod_1.z.object({
     uuid: zod_1.z.string(),

package/build/schemas/discount-rules/product-discount-price-data.schema.js

@@ -5,9 +5,18 @@ const zod_1 = require("zod");
 const money_schema_1 = require("../money.schema");
 const product_discount_price_item_schema_1 = require("./product-discount-price-item.schema");
 const product_discount_price_multiplicity_option_schema_1 = require("./product-discount-price-multiplicity-option.schema");
+/**
+ * Две базы рядом, и это намеренно. `price` / `optionPrice` — прайс, одинаковый для всех.
+ * `clientPrice` / `clientOptionPrice` — цена этого клиента до скидок: у клиента с правилом
+ * ценообразования (от себестоимости или от прайса с наценкой) это цена по правилу, у остальных — тот
+ * же прайс. Скидки считаются от прайса и только у клиентов без правила ценообразования: у клиента с
+ * таким правилом скидок нет, списки вариантов пусты. Цену позиции без скидки берите из `clientPrice`,
+ * а не из `price`: иначе цена по правилу потеряется.
+ */
 exports.ProductDiscountPriceDataSchema = zod_1.z.object({
     productUUID: zod_1.z.string(),
     price: money_schema_1.MoneySchema,
+    clientPrice: money_schema_1.MoneySchema,
     priceWithBestDiscount: money_schema_1.MoneySchema.nullable(),
     multiplicityOptions: product_discount_price_multiplicity_option_schema_1.ProductDiscountPriceMultiplicityOptionSchema.array(),
     /**

package/build/schemas/discount-rules/product-discount-price-multiplicity-option.schema.js

@@ -7,6 +7,8 @@ const product_discount_price_item_schema_1 = require("./product-discount-price-i
 exports.ProductDiscountPriceMultiplicityOptionSchema = zod_1.z.object({
     uuid: zod_1.z.string(),
     optionPrice: money_schema_1.MoneySchema.nullable(),
+    /** `null` ровно тогда, когда `null` у `optionPrice`: своей цены у фасовки нет, база — `clientPrice`. */
+    clientOptionPrice: money_schema_1.MoneySchema.nullable(),
     optionPriceWithDiscount: money_schema_1.MoneySchema.nullable(),
     isDiscountApplicable: zod_1.z.boolean(),
     /**

package/build/schemas/order-product/price-correction-analyze-item.schema.js

@@ -34,6 +34,12 @@ exports.PriceCorrectionAnalyzeItemSchema = zod_1.z.object({
     // Разницы могут быть отрицательными — цена корректируется в обе стороны, поэтому без ограничения знака.
     priceDifferenceWithoutDiscount: money_schema_1.MoneySchema,
     priceDifferenceWithDiscount: money_schema_1.MoneySchema,
+    /**
+     * У клиента действует правило ценообразования (от себестоимости или от прайса с наценкой).
+     * Его цена — `newPriceWithDiscount`; «без скидок» для него означает прайс, то есть снятие наценки.
+     * Сотруднику стоит показать это до применения.
+     */
+    hasPricingRule: zod_1.z.boolean(),
     isSkipped: zod_1.z.boolean(),
     skipReason: error_message_schema_1.ErrorMessageSchema.optional(),
 });

package/constant/discount-rules-pricing-type-list.constant.ts

@@ -0,0 +1,12 @@
+import { DiscountRulesTypeEnum } from '../enum/discount-rules-type.enum';
+
+/**
+ * Правила ценообразования: задают цену клиента целиком, а не уменьшают её.
+ *
+ * Цена от себестоимости или от прайса плюс наценка. Если у клиента есть такое правило, скидки к нему не
+ * применяются, и больше одного действующего правила ценообразования на клиента быть не может.
+ */
+export const DISCOUNT_RULES_PRICING_TYPE_LIST: DiscountRulesTypeEnum[] = [
+    DiscountRulesTypeEnum.COST_PLUS_MARKUP,
+    DiscountRulesTypeEnum.PRICE_PLUS_MARKUP,
+];

package/constant/error.ts

@@ -1406,6 +1406,17 @@ export const ERRORS = {
         message: 'Too many products for a single consignment discount operation',
         httpCode: 400,
     },
+    DISCOUNT_RULES_PRICING_RULE_CONFLICT: {
+        code: 'DR007',
+        message: 'A client can have only one active pricing rule',
+        httpCode: 409,
+    },
+    // Не дождались транзакционной блокировки правил ценообразования компании (lock_timeout).
+    DISCOUNT_RULES_PRICING_RULE_LOCK_BUSY: {
+        code: 'DR008',
+        message: 'Pricing rules of this company are being changed right now, try again',
+        httpCode: 409,
+    },
     DISCOUNT_RULES_NOT_FOUND: { code: 'DR010', message: 'Discount-rules not found', httpCode: 404 },
 
     // ACTION LOG

package/constant/index.ts

@@ -15,3 +15,4 @@ export * from './product-image-merge.constant';
 export * from './client-group-actions.constant';
 export * from './standing-order-positions.constant';
 export * from './order-external-number.constant';
+export * from './discount-rules-pricing-type-list.constant';

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

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

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

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

package/package.json

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

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

@@ -23,10 +23,9 @@ export const discountRulesModeSchema = z.discriminatedUnion('typeDiscount', [dis
 /**
  * Итог применения правила к товару — то, что уезжает клиенту в `discountDataList`.
  *
- * От схемы ввода отличается ровно одной веткой: TARGET_PRICE несёт уже посчитанную цену, а не
- * величину скидки. Так работает правило от себестоимости: считать цену на клиенте нечем — там нет
- * ни себестоимости, ни права её видеть. Ветка живёт только в выдаче: задать TARGET_PRICE при
- * создании правила нельзя, `discountRulesModeSchema` его не принимает.
+ * Ветка TARGET_PRICE больше не отдаётся: правило от себестоимости стало правилом ценообразования и
+ * задаёт цену клиента (`price`, `clientPrice`), а не вариант скидки. Ветка оставлена, чтобы не ломать
+ * клиентов, которые её разбирают.
  */
 export const discountPriceOutcomeSchema = z.discriminatedUnion('typeDiscount', [
     discountPercentModeSchema,
@@ -68,19 +67,33 @@ const DiscountRulesItemDiscountDataSchema = discountRulesModeSchema;
 const DiscountRulesDiscountProhibitedDataSchema = z.object({}).default({});
 
 /**
- * Наценка к себестоимости: цена клиента = себестоимость + наценка.
+ * Наценка правила ценообразования: процент или сумма на единицу.
  *
- * Три отличия от режима скидки, и все намеренные:
- * — только вверх, знака у величины нет: продажу ниже себестоимости правилом не задают;
- * — ноль допустим (`markupValue: 0` — продаём по себестоимости), поэтому FIXED берёт
- *   `NonNegativeMoneySchema`, а не `PositiveMoneySchema`;
+ * Отличия от режима скидки намеренные:
+ * — только вверх, знака у величины нет;
+ * — ноль допустим (цена ровно равна источнику), поэтому FIXED берёт `NonNegativeMoneySchema`;
  * — у процента нет верхней границы: наценка в 150 % законна, в отличие от скидки в 150 %.
  */
+const pricingMarkupPercentSchema = z.object({ typeMarkup: z.literal(DiscountRulesModeTypeEnum.PERCENT), markupValue: z.number().min(0) });
+const pricingMarkupFixedSchema = z.object({ typeMarkup: z.literal(DiscountRulesModeTypeEnum.FIXED), markupValue: NonNegativeMoneySchema });
+
+/**
+ * Потолок «не выше прайса» есть только у цены от себестоимости: цена от прайса с наценкой выше
+ * прайса по определению. Поле необязательное, и отсутствие значит разное: при создании — потолка
+ * нет, при правке — оставить как было. Так старая панель, которая флага не знает, не снимает потолок
+ * у правил, которым его проставила миграция.
+ */
+const costPlusCapShape = { isCappedByPrice: z.boolean().optional() };
+
+/** Цена клиента = себестоимость + наценка. */
 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 }),
+    pricingMarkupPercentSchema.extend(costPlusCapShape),
+    pricingMarkupFixedSchema.extend(costPlusCapShape),
 ]);
 
+/** Цена клиента = цена позиции (фасовки, если она выбрана) + наценка. */
+const DiscountRulesPricePlusMarkupDataSchema = z.discriminatedUnion('typeMarkup', [pricingMarkupPercentSchema, pricingMarkupFixedSchema]);
+
 export const DiscountRulesTypeSchema = z.discriminatedUnion('type', [
     z.object({
         type: z.literal(DiscountRulesTypeEnum.PERSONAL_DISCOUNT),
@@ -106,6 +119,10 @@ export const DiscountRulesTypeSchema = z.discriminatedUnion('type', [
         type: z.literal(DiscountRulesTypeEnum.COST_PLUS_MARKUP),
         data: DiscountRulesCostPlusMarkupDataSchema,
     }),
+    z.object({
+        type: z.literal(DiscountRulesTypeEnum.PRICE_PLUS_MARKUP),
+        data: DiscountRulesPricePlusMarkupDataSchema,
+    }),
 ]);
 
 export const DiscountRulesBaseSchema = z.object({

package/schemas/discount-rules/product-discount-price-data.schema.ts

@@ -3,9 +3,18 @@ import { MoneySchema } from '../money.schema';
 import { ProductDiscountPriceItemSchema } from './product-discount-price-item.schema';
 import { ProductDiscountPriceMultiplicityOptionSchema } from './product-discount-price-multiplicity-option.schema';
 
+/**
+ * Две базы рядом, и это намеренно. `price` / `optionPrice` — прайс, одинаковый для всех.
+ * `clientPrice` / `clientOptionPrice` — цена этого клиента до скидок: у клиента с правилом
+ * ценообразования (от себестоимости или от прайса с наценкой) это цена по правилу, у остальных — тот
+ * же прайс. Скидки считаются от прайса и только у клиентов без правила ценообразования: у клиента с
+ * таким правилом скидок нет, списки вариантов пусты. Цену позиции без скидки берите из `clientPrice`,
+ * а не из `price`: иначе цена по правилу потеряется.
+ */
 export const ProductDiscountPriceDataSchema = z.object({
     productUUID: z.string(),
     price: MoneySchema,
+    clientPrice: MoneySchema,
     priceWithBestDiscount: MoneySchema.nullable(),
     multiplicityOptions: ProductDiscountPriceMultiplicityOptionSchema.array(),
     /**

package/schemas/discount-rules/product-discount-price-multiplicity-option.schema.ts

@@ -5,6 +5,8 @@ import { ProductDiscountPriceItemSchema } from './product-discount-price-item.sc
 export const ProductDiscountPriceMultiplicityOptionSchema = z.object({
     uuid: z.string(),
     optionPrice: MoneySchema.nullable(),
+    /** `null` ровно тогда, когда `null` у `optionPrice`: своей цены у фасовки нет, база — `clientPrice`. */
+    clientOptionPrice: MoneySchema.nullable(),
     optionPriceWithDiscount: MoneySchema.nullable(),
     isDiscountApplicable: z.boolean(),
     /**

package/schemas/order-product/price-correction-analyze-item.schema.ts

@@ -37,6 +37,13 @@ export const PriceCorrectionAnalyzeItemSchema = z.object({
     priceDifferenceWithoutDiscount: MoneySchema,
     priceDifferenceWithDiscount: MoneySchema,
 
+    /**
+     * У клиента действует правило ценообразования (от себестоимости или от прайса с наценкой).
+     * Его цена — `newPriceWithDiscount`; «без скидок» для него означает прайс, то есть снятие наценки.
+     * Сотруднику стоит показать это до применения.
+     */
+    hasPricingRule: z.boolean(),
+
     isSkipped: z.boolean(),
     skipReason: ErrorMessageSchema.optional(),
 });