@floristcloud/api-lib 1.2.131 → 1.2.132

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

@@ -3,12 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PreOrderProductInfoSchema = void 0;
 const zod_1 = require("zod");
 const action_log_money_schema_1 = require("./action-log-money.schema");
+/**
+ * Снимок позиции предзаказа в журнале аудита.
+ *
+ * `name` и `price` — nullable: у позиции предзаказа наименование и цена появляются не сразу
+ * (в БД `pre_order_product.name` и `price` тоже nullable), и журнал фиксирует позицию такой,
+ * какой она была на момент события. Записи с `null` уже лежат в `action_log.payload`.
+ */
 exports.PreOrderProductInfoSchema = zod_1.z.object({
     preOrderUUID: zod_1.z.string(),
     preOrderProductUUID: zod_1.z.string(),
-    name: zod_1.z.string(),
+    name: zod_1.z.string().nullable(),
     categoryName: zod_1.z.string().nullable(),
     quantity: zod_1.z.coerce.number(),
-    price: action_log_money_schema_1.ActionLogMoneySchema,
+    price: action_log_money_schema_1.ActionLogMoneySchema.nullable(),
     comment: zod_1.z.string().nullable(),
 });

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

@@ -7,6 +7,7 @@ const action_log_money_schema_1 = require("./action-log-money.schema");
 exports.PreOrderProductUpdateActionLogSchema = zod_1.z.object({
     preOrderProduct: pre_order_product_info_schema_1.PreOrderProductInfoSchema,
     newQuantity: zod_1.z.coerce.number(),
-    newPrice: action_log_money_schema_1.ActionLogMoneySchema,
+    // Цену позиции предзаказа можно снять — новое значение бывает null, см. PreOrderProductInfoSchema.
+    newPrice: action_log_money_schema_1.ActionLogMoneySchema.nullable(),
     newComment: zod_1.z.string().nullable(),
 });

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

@@ -91,6 +91,23 @@ exports.ProductExtendedForClientSchema = exports.ProductForClientSchema.merge(zo
         isInStock: zod_1.z.boolean(),
     }),
     multiplicityOptions: zod_1.z.array(product_multiplicity_option_for_client_schema_1.ProductMultiplicityOptionForClientSchema).optional(),
+    /**
+     * Правила клиента, снижающие **базовую цену товара**, — и только они.
+     *
+     * Правило, оставляющее цену как есть, в список не попадает: это не скидка, а «скидка» с
+     * той же ценой рядом. Так выходит у правила от себестоимости, когда «себестоимость +
+     * наценка» вышла выше прайса, и у скидки в 0 %. Отбор общий с панелью
+     * (`GetProductDiscountPriceContractQuery`) — правила отбираются одинаково.
+     *
+     * Список считается от базовой цены товара, поэтому пустой список **не означает**, что у
+     * клиента нет скидочных цен по этому товару вовсе: у кратности своя база, и правило может
+     * снижать цену фасовки, не снижая цену штуки. Цена каждой фасовки — в её собственных
+     * `optionPriceWithDiscount` и `isDiscountApplicable`, там результат уже посчитан от нужной
+     * базы. Пример: прайс 50, фасовка 80, «себестоимость + наценка» 60 — список пуст, а
+     * фасовка идёт по 60.
+     *
+     * Порядок не зафиксирован — лучшую цену базового тарифа берите из `priceWithBestDiscount`.
+     */
     discountDataList: zod_1.z
         .object({
         discountRulesUUID: zod_1.z.string(),

package/package.json

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

package/schemas/action-log/pre-order-product-info.schema.ts

@@ -1,12 +1,19 @@
 import { z } from 'zod';
 import { ActionLogMoneySchema } from './action-log-money.schema';
 
+/**
+ * Снимок позиции предзаказа в журнале аудита.
+ *
+ * `name` и `price` — nullable: у позиции предзаказа наименование и цена появляются не сразу
+ * (в БД `pre_order_product.name` и `price` тоже nullable), и журнал фиксирует позицию такой,
+ * какой она была на момент события. Записи с `null` уже лежат в `action_log.payload`.
+ */
 export const PreOrderProductInfoSchema = z.object({
     preOrderUUID: z.string(),
     preOrderProductUUID: z.string(),
-    name: z.string(),
+    name: z.string().nullable(),
     categoryName: z.string().nullable(),
     quantity: z.coerce.number(),
-    price: ActionLogMoneySchema,
+    price: ActionLogMoneySchema.nullable(),
     comment: z.string().nullable(),
 });

package/schemas/action-log/pre-order-product-update-action-log.schema.ts

@@ -5,6 +5,7 @@ import { ActionLogMoneySchema } from './action-log-money.schema';
 export const PreOrderProductUpdateActionLogSchema = z.object({
     preOrderProduct: PreOrderProductInfoSchema,
     newQuantity: z.coerce.number(),
-    newPrice: ActionLogMoneySchema,
+    // Цену позиции предзаказа можно снять — новое значение бывает null, см. PreOrderProductInfoSchema.
+    newPrice: ActionLogMoneySchema.nullable(),
     newComment: z.string().nullable(),
 });

package/schemas/product/product.schema.ts

@@ -98,6 +98,23 @@ export const ProductExtendedForClientSchema = ProductForClientSchema.merge(
             isInStock: z.boolean(),
         }),
         multiplicityOptions: z.array(ProductMultiplicityOptionForClientSchema).optional(),
+        /**
+         * Правила клиента, снижающие **базовую цену товара**, — и только они.
+         *
+         * Правило, оставляющее цену как есть, в список не попадает: это не скидка, а «скидка» с
+         * той же ценой рядом. Так выходит у правила от себестоимости, когда «себестоимость +
+         * наценка» вышла выше прайса, и у скидки в 0 %. Отбор общий с панелью
+         * (`GetProductDiscountPriceContractQuery`) — правила отбираются одинаково.
+         *
+         * Список считается от базовой цены товара, поэтому пустой список **не означает**, что у
+         * клиента нет скидочных цен по этому товару вовсе: у кратности своя база, и правило может
+         * снижать цену фасовки, не снижая цену штуки. Цена каждой фасовки — в её собственных
+         * `optionPriceWithDiscount` и `isDiscountApplicable`, там результат уже посчитан от нужной
+         * базы. Пример: прайс 50, фасовка 80, «себестоимость + наценка» 60 — список пуст, а
+         * фасовка идёт по 60.
+         *
+         * Порядок не зафиксирован — лучшую цену базового тарифа берите из `priceWithBestDiscount`.
+         */
         discountDataList: z
             .object({
                 discountRulesUUID: z.string(),