@floristcloud/api-lib 1.2.109 → 1.2.110

package/commands/order/webshop/get-order-sales-by-month.query.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { MoneySchema } from '../../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../../schemas/non-negative-money.schema';
 
 const GetOrderSalesByMonthRequestSchema = z.object({
     month: z.coerce.number().int().min(1).max(12),
@@ -6,7 +8,7 @@ const GetOrderSalesByMonthRequestSchema = z.object({
 
 const GetOrderSalesByMonthResponseSchema = z.object({
     message: z.string().optional(),
-    data: z.number(),
+    data: NonNegativeMoneySchema,
 });
 
 export namespace GetOrderSalesByMonthContractQuery {

package/commands/order-product/create-order-product.command.ts

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { OrderProductSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const CreateOrderProductRequestSchema = z.object({
     quantity: z.number(),
-    price: z.number(),
+    price: MoneySchema,
     comment: z.string().nullable(),
     tag: z.string().nullable(),
     isEditable: z.coerce.boolean(),

package/commands/order-product/group/price-valuation-execute.command.ts

@@ -1,11 +1,14 @@
 import { z } from 'zod';
 import { PriceCorrectionExecuteResultItemSchema } from '../../../schemas';
+import { MoneySchema } from '../../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../../schemas/non-negative-money.schema';
 
 const PRICE_VALUATION_BATCH_LIMIT = 50;
 
 const PriceValuationExecuteItemSchema = z.object({
     orderProductUUID: z.string().uuid(),
-    price: z.number().nonnegative(),
+    // Неотрицательность проверяем по знаку строки: минус — единственный признак отрицательной суммы.
+    price: NonNegativeMoneySchema,
 });
 
 const PriceValuationExecuteRequestSchema = z.object({

package/commands/order-product/update-order-product.command.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { OrderProductSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const UpdateOrderProductRequestSchema = z.object({
     productUUID: z.uuid(),
     quantity: z.number(),
-    price: z.number(),
+    price: MoneySchema,
     comment: z.string().nullable(),
     tag: z.string().nullable(),
     isEditable: z.coerce.boolean(),

package/commands/payment-invoice/create-payment-invoice.command.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 import { PaymentInvoiceSchema } from '../../schemas/payment-invoice/payment-invoice.schema';
+import { MoneySchema } from '../../schemas/money.schema';
+import { PositiveMoneySchema } from '../../schemas/positive-money.schema';
 
 // Потолок числа заказов в счёте. Это защита от абсурдного запроса, а не бизнес-правило: счёт за месяц
 // клиенту с ежедневными поставками — это уже 30 строк, поэтому 10-20 отрезали бы живые сценарии.
@@ -15,7 +17,8 @@ const CreatePaymentInvoiceRequestSchema = z
         clientUUID: z.uuid(),
         invoiceDate: z.coerce.date(),
         orderUUIDs: z.uuid().array().max(MAX_INVOICE_ORDER_COUNT).optional(),
-        amount: z.coerce.number().positive().optional(),
+        // Строго положительная сумма: отсекаем минус по знаку строки и нулевые записи вида "0" / "0.00".
+        amount: PositiveMoneySchema.optional(),
     })
     .refine(value => Boolean(value.orderUUIDs?.length) || value.amount !== undefined, {
         message: 'Either orderUUIDs or amount must be provided',

package/commands/payment-invoice/pay-payment-invoice.command.ts

@@ -1,10 +1,13 @@
 import { z } from 'zod';
 import { PaymentInvoiceSchema } from '../../schemas/payment-invoice/payment-invoice.schema';
+import { MoneySchema } from '../../schemas/money.schema';
+import { PositiveMoneySchema } from '../../schemas/positive-money.schema';
 
 // Оплата по счёту. amount не передан — гасим остаток целиком; передан — частичная оплата.
 const PayPaymentInvoiceRequestSchema = z.object({
     moneyAccountUUID: z.uuid(),
-    amount: z.coerce.number().positive().optional(),
+    // Строго положительная сумма: отсекаем минус по знаку строки и нулевые записи вида "0" / "0.00".
+    amount: PositiveMoneySchema.optional(),
     comment: z.string().optional(),
     cashFlowItemUUID: z.uuid().nullable().optional(),
     createdAt: z.coerce.date().optional(),

package/commands/pre-order-collection-item/execute-pre-order-collection-item-update.command.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { ErrorMessageSchema } from '../../schemas/error-message.schema';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const OptionUpdateSchema = z.object({
     title: z.string().nullable().optional(),
     optionMultiplicity: z.number().nullable().optional(),
-    optionPrice: z.number().nullable().optional(),
+    optionPrice: MoneySchema.nullable().optional(),
 });
 
 const PositionUpdateSchema = z.object({
@@ -12,7 +13,7 @@ const PositionUpdateSchema = z.object({
     multiplicity: z.number().nullable().optional(),
     quantity: z.number().nullable().optional(),
     balance: z.number().nullable().optional(),
-    price: z.number().nullable().optional(),
+    price: MoneySchema.nullable().optional(),
     advancedPrice: z.string().nullable().optional(),
     grower: z.string().nullable().optional(),
     size: z.string().nullable().optional(),

package/commands/pre-order-collection-item/multiplicity-option/create-pre-order-collection-item-multiplicity-option.command.ts

@@ -1,10 +1,12 @@
 import { z } from 'zod';
 import { PreOrderCollectionItemMultiplicityOptionSchema } from '../../../schemas';
+import { MoneySchema } from '../../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../../schemas/non-negative-money.schema';
 
 const CreatePreOrderCollectionItemMultiplicityOptionRequestSchema = z.object({
     title: z.string().max(100).nullable().optional(),
     optionMultiplicity: z.coerce.number().int().min(1),
-    optionPrice: z.coerce.number().min(0).nullable().optional(),
+    optionPrice: NonNegativeMoneySchema.nullable().optional(),
     rank: z.coerce.number().int().min(0).default(0).optional(),
 });
 

package/commands/pre-order-collection-item/multiplicity-option/update-pre-order-collection-item-multiplicity-option.command.ts

@@ -1,11 +1,13 @@
 import { z } from 'zod';
 import { PreOrderCollectionItemMultiplicityOptionSchema } from '../../../schemas';
+import { MoneySchema } from '../../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../../schemas/non-negative-money.schema';
 
 const UpdatePreOrderCollectionItemMultiplicityOptionRequestSchema = z
     .object({
         title: z.string().max(100).nullable(),
         optionMultiplicity: z.coerce.number().int().min(1),
-        optionPrice: z.coerce.number().min(0).nullable(),
+        optionPrice: NonNegativeMoneySchema.nullable(),
         rank: z.coerce.number().int().min(0).default(0),
     })
     .partial();

package/commands/product/create-product.command.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { ProductMarkEnum, SalesUnitEnum } from '../../enum';
 import { ProductExtendedForAdminSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const CreateProductRequestSchema = z.object({
     name: z.string(),
@@ -8,8 +9,8 @@ const CreateProductRequestSchema = z.object({
     categoryUUID: z.string(),
     balance: z.number(),
     quantity: z.number(),
-    price: z.number(),
-    costPrice: z.number(),
+    price: MoneySchema,
+    costPrice: MoneySchema,
     multiplicity: z.number(),
     isOpen: z.coerce.boolean(),
 
@@ -20,7 +21,7 @@ const CreateProductRequestSchema = z.object({
     size: z.string().nullable(),
     size2: z.string().nullable(),
     size3: z.string().nullable(),
-    invoicePrice: z.number().nullable(),
+    invoicePrice: MoneySchema.nullable(),
     invoiceNumber: z.string().nullable(),
     imageUUID: z.string().nullable(),
     country: z.string().nullable(),

package/commands/product/group/update-group-product-prices.command.ts

@@ -1,11 +1,12 @@
 import { z } from 'zod';
+import { MoneySchema } from '../../../schemas/money.schema';
 
 const UpdateGroupProductPricesRequestSchema = z.object({
     data: z
         .object({
             productUUID: z.string(),
-            newCost: z.coerce.number(),
-            newPrice: z.coerce.number().optional(),
+            newCost: MoneySchema,
+            newPrice: MoneySchema.optional(),
         })
         .array(),
 });

package/commands/product/group/update-group-product-update-batch.command.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { SalesUnitEnum } from '../../../enum';
 import { ErrorMessageSchema } from '../../../schemas/error-message.schema';
+import { MoneySchema } from '../../../schemas/money.schema';
 
 const UpdateGroupProductUpdateBatchRequestSchema = z.object({
     productUUIDList: z.array(z.string()),
@@ -8,15 +9,15 @@ const UpdateGroupProductUpdateBatchRequestSchema = z.object({
         .object({
             name: z.string(),
             categoryUUID: z.string(),
-            price: z.coerce.number(),
-            costPrice: z.coerce.number(),
+            price: MoneySchema,
+            costPrice: MoneySchema,
             color: z.string().nullable(),
             size: z.string().nullable(),
             multiplicity: z.coerce.number(),
             size2: z.string().nullable(),
             grower: z.string().nullable(),
             country: z.string().nullable(),
-            invoicePrice: z.coerce.number().nullable(),
+            invoicePrice: MoneySchema.nullable(),
             invoiceNumber: z.string().nullable(),
             imageUUID: z.string().nullable(),
             multiplicityDescription: z.string().nullable(),

package/commands/product/multiplicity-option/create-product-multiplicity-option.command.ts

@@ -1,10 +1,12 @@
 import { z } from 'zod';
 import { ProductMultiplicityOptionSchema } from '../../../schemas';
+import { MoneySchema } from '../../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../../schemas/non-negative-money.schema';
 
 const CreateProductMultiplicityOptionRequestSchema = z.object({
     title: z.string().max(100).nullable().optional(),
     optionMultiplicity: z.coerce.number().int().min(1),
-    optionPrice: z.coerce.number().min(0).nullable().optional(),
+    optionPrice: NonNegativeMoneySchema.nullable().optional(),
     rank: z.coerce.number().int().min(0).default(0).optional(),
 });
 

package/commands/product/multiplicity-option/update-product-multiplicity-option.command.ts

@@ -1,11 +1,13 @@
 import { z } from 'zod';
 import { ProductMultiplicityOptionSchema } from '../../../schemas';
+import { MoneySchema } from '../../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../../schemas/non-negative-money.schema';
 
 const UpdateProductMultiplicityOptionRequestSchema = z
     .object({
         title: z.string().max(100).nullable(),
         optionMultiplicity: z.coerce.number().int().min(1),
-        optionPrice: z.coerce.number().min(0).nullable(),
+        optionPrice: NonNegativeMoneySchema.nullable(),
         rank: z.coerce.number().int().min(0).default(0),
     })
     .partial();

package/commands/product/update-product.command.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { ProductMarkEnum, SalesUnitEnum } from '../../enum';
 import { ProductExtendedForAdminSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const UpdateProductRequestSchema = z.object({
     name: z.string(),
@@ -8,8 +9,8 @@ const UpdateProductRequestSchema = z.object({
     categoryUUID: z.string(),
     balance: z.number(),
     quantity: z.number(),
-    price: z.number(),
-    costPrice: z.number(),
+    price: MoneySchema,
+    costPrice: MoneySchema,
     multiplicity: z.number(),
     isOpen: z.coerce.boolean(),
 
@@ -20,7 +21,7 @@ const UpdateProductRequestSchema = z.object({
     size: z.string().nullable(),
     size2: z.string().nullable(),
     size3: z.string().nullable(),
-    invoicePrice: z.number().nullable(),
+    invoicePrice: MoneySchema.nullable(),
     invoiceNumber: z.string().nullable(),
     imageUUID: z.string().nullable(),
     country: z.string().nullable(),

package/commands/report/get-cash-flow.query.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GetCashFlowRequestSchema = z
     .object({
@@ -28,8 +29,8 @@ const CashFlowItemRowSchema = z.object({
     // null — строка "Без статьи": платежи, которым статью ещё не проставили.
     cashFlowItemUUID: z.string().nullable(),
     cashFlowItemName: z.string().nullable(),
-    income: z.number(),
-    expense: z.number(),
+    income: MoneySchema,
+    expense: MoneySchema,
     transactionCount: z.number(),
 });
 
@@ -43,9 +44,11 @@ const GetCashFlowResponseSchema = z.object({
         byItem: CashFlowItemRowSchema.array(),
         byMonth: CashFlowMonthRowSchema.array(),
         totals: z.object({
-            income: z.number(),
-            expense: z.number(),
-            total: z.number(),
+            income: MoneySchema,
+            expense: MoneySchema,
+            // Сальдо (`income - expense`) — знаковая величина, минус здесь легален,
+            // поэтому ограничения на знак нет и быть не должно.
+            total: MoneySchema,
         }),
     }),
 });

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GetDailyOrdersSummaryRequestSchema = z
     .object({
@@ -24,7 +25,7 @@ const UnitsByMeasureSchema = z.object({
 const metricsShape = {
     ordersCreated: z.number(),
     ordersCompleted: z.number(),
-    totalSum: z.number(),
+    totalSum: MoneySchema,
     unitsByMeasure: UnitsByMeasureSchema,
 };
 

package/commands/report/get-report-for-period.query.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { dateRangeCheck } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GetReportForPeriodRequestSchema = z
     .object({
@@ -25,17 +26,17 @@ const GetReportForPeriodResponseSchema = z.object({
     data: z.object({
         totalOrders: z.number(),
         soldUnits: z.number(),
-        totalSales: z.number(),
-        totalCost: z.number(),
+        totalSales: MoneySchema,
+        totalCost: MoneySchema,
         totalUnits: z.number(),
-        totalWriteOff: z.number(),
-        totalWriteOffCost: z.number(),
+        totalWriteOff: z.number(), // количество списанных единиц (SUM по quantity), не деньги
+        totalWriteOffCost: MoneySchema,
         totalWriteOffByOrder: z.number(),
-        totalWriteOffCostByOrder: z.number(),
-        totalVatAmount: z.number(),
-        totalDeliveryCost: z.number(),
-        middlePrice: z.number(),
-        grossProfit: z.number(),
+        totalWriteOffCostByOrder: MoneySchema,
+        totalVatAmount: MoneySchema,
+        totalDeliveryCost: MoneySchema,
+        middlePrice: MoneySchema,
+        grossProfit: MoneySchema,
         marginality: z.number(),
     }),
 });

package/commands/report/get-report-group-by-client.query.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { OrderByEnum, ReportSortByEnum } from '../../enum';
 import { dateRangeCheck } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
 import { ReportOrderFilterSchema } from '../../schemas/report/report-order-filter.schema';
 
 const GetReportGroupByClientRequestSchema = z
@@ -49,16 +50,16 @@ const GetReportGroupByClientResponseSchema = z.object({
                 clientName: z.string(),
                 totalOrders: z.number(),
                 soldUnits: z.number(),
-                totalSales: z.number(),
-                totalSalesCost: z.number(),
-                totalWriteOff: z.number(),
-                totalWriteOffSales: z.number(),
-                totalVatAmount: z.number(),
-                totalDeliveryCost: z.number(),
-                totalServiceAmount: z.number(),
-                totalPayments: z.number(),
-                middlePrice: z.number(),
-                grossProfit: z.number(),
+                totalSales: MoneySchema,
+                totalSalesCost: MoneySchema,
+                totalWriteOff: z.number(), // количество списанных единиц (SUM по quantity), не деньги
+                totalWriteOffSales: MoneySchema, // деньги: SUM(write_off.quantity * order_product.price)
+                totalVatAmount: MoneySchema,
+                totalDeliveryCost: MoneySchema,
+                totalServiceAmount: MoneySchema,
+                totalPayments: MoneySchema,
+                middlePrice: MoneySchema,
+                grossProfit: MoneySchema,
                 marginality: z.number(),
             }),
         ),

package/commands/report/get-report-group-by-position.query.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { OrderByEnum, PositionReportTypeEnum, ReportSortByEnum } from '../../enum';
 import { dateRangeCheck } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GetReportGroupByPositionRequestSchema = z
     .object({
@@ -49,15 +50,15 @@ const GetReportGroupByPositionResponseSchema = z.object({
                         name: z.string(),
                     }),
                     totalOrders: z.number(),
-                    totalSales: z.number(),
+                    totalSales: MoneySchema,
                     soldUnits: z.number(),
-                    totalCost: z.number(),
+                    totalCost: MoneySchema,
                     totalUnits: z.number(),
-                    totalWriteOff: z.number(),
-                    totalWriteOffCost: z.number(),
-                    totalVatAmount: z.number(),
-                    middlePrice: z.number(),
-                    grossProfit: z.number(),
+                    totalWriteOff: z.number(), // количество списанных единиц (SUM по quantity), не деньги
+                    totalWriteOffCost: MoneySchema,
+                    totalVatAmount: MoneySchema,
+                    middlePrice: MoneySchema,
+                    grossProfit: MoneySchema,
                     marginality: z.number(),
                 }),
             )
@@ -69,14 +70,14 @@ const GetReportGroupByPositionResponseSchema = z.object({
                     productKey: z.string(),
                     totalOrders: z.number(),
                     soldUnits: z.number(),
-                    totalSales: z.number(),
-                    totalCost: z.number(),
+                    totalSales: MoneySchema,
+                    totalCost: MoneySchema,
                     totalUnits: z.number(),
-                    totalWriteOff: z.number(),
-                    totalWriteOffCost: z.number(),
-                    totalVatAmount: z.number(),
-                    middlePrice: z.number(),
-                    grossProfit: z.number(),
+                    totalWriteOff: z.number(), // количество списанных единиц (SUM по quantity), не деньги
+                    totalWriteOffCost: MoneySchema,
+                    totalVatAmount: MoneySchema,
+                    middlePrice: MoneySchema,
+                    grossProfit: MoneySchema,
                     marginality: z.number(),
                 }),
             )

package/commands/report/get-sales-summary.query.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { dateRangeCheck } from '../../helpers/date.helper';
 import { ReportPeriodTypeEnum } from '../../enum/report-period-type.enum';
+import { MoneySchema } from '../../schemas/money.schema';
 import { ReportOrderFilterSchema } from '../../schemas/report/report-order-filter.schema';
 
 const GetSalesSummaryRequestSchema = z
@@ -27,27 +28,28 @@ const GetSalesSummaryRequestSchema = z
     );
 
 const SalesSummaryTotalsSchema = z.object({
-    totalRevenue: z.number(),
-    totalRevenueWithDelivery: z.number(),
+    totalRevenue: MoneySchema,
+    totalRevenueWithDelivery: MoneySchema,
     totalOrders: z.number(),
     uniqueClients: z.number(),
     soldUnits: z.number(),
-    avgCheck: z.number(),
-    totalVatAmount: z.number(),
-    totalCost: z.number(),
-    totalDeliveryCost: z.number(),
-    totalServiceAmount: z.number(),
-    totalDiscountAmount: z.number(),
-    grossProfit: z.number(),
+    avgCheck: MoneySchema,
+    totalVatAmount: MoneySchema,
+    totalCost: MoneySchema,
+    totalDeliveryCost: MoneySchema,
+    totalServiceAmount: MoneySchema,
+    // Сумма скидки в деньгах (SUM(order.discount_amount)) — в отличие от процента `discountPercent`
+    totalDiscountAmount: MoneySchema,
+    grossProfit: MoneySchema,
     marginality: z.number(),
 });
 
 const SalesSummarySeriesItemSchema = z.object({
     period: z.string(),
-    revenue: z.number(),
+    revenue: MoneySchema,
     orders: z.number(),
     units: z.number(),
-    avgCheck: z.number(),
+    avgCheck: MoneySchema,
 });
 
 const GetSalesSummaryResponseSchema = z.object({

package/commands/transaction/generate-check-transaction.command.ts

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { DeleteDataResponseSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GenerateCheckTransactionRequestSchema = z.object({
     orderUUID: z.string(),
-    amount: z.coerce.number(),
+    amount: MoneySchema,
 });
 
 const GenerateCheckTransactionResponseSchema = z.object({

package/commands/transaction/generate-pre-payment-check.command.ts

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { DeleteDataResponseSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GeneratePrepaymentCheckRequestSchema = z.object({
     clientUUID: z.string(),
-    amount: z.coerce.number(),
+    amount: MoneySchema,
 });
 
 const GeneratePrepaymentCheckResponseSchema = z.object({

package/commands/transaction/get-sum-transaction-by-money-account.query.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { dateRangeCheck } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GetSumTransactionByMoneyAccountRequestSchema = z
     .object({
@@ -24,7 +25,8 @@ const GetSumTransactionByMoneyAccountRequestSchema = z
 const GetSumTransactionByMoneyAccountResponseSchema = z.object({
     message: z.string().optional(),
     data: z.object({
-        sum: z.number(),
+        // Сальдо по кассе: расход может превысить приход, поэтому знаковых ограничений нет.
+        sum: MoneySchema,
     }),
 });
 

package/commands/transaction/get-transaction-summary.query.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { dateRangeCheck } from '../../helpers/date.helper';
 import { TransactionTypeEnum } from '../../enum';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const GetTransactionSummaryRequestSchema = z
     .object({
@@ -30,9 +31,10 @@ const GetTransactionSummaryRequestSchema = z
 const GetTransactionSummaryResponseSchema = z.object({
     message: z.string().optional(),
     data: z.object({
-        income: z.number(),
-        expense: z.number(),
-        total: z.number(),
+        income: MoneySchema,
+        expense: MoneySchema,
+        // Разница income − expense: минус здесь легитимен, поэтому знаковых ограничений нет.
+        total: MoneySchema,
     }),
 });
 

package/commands/write-off/get-write-off-sum-by-order.query.ts

@@ -1,10 +1,13 @@
 import { z } from 'zod';
+import { MoneySchema } from '../../schemas/money.schema';
+import { NonNegativeMoneySchema } from '../../schemas/non-negative-money.schema';
 
 const GetWriteOffSumByOrderRequestSchema = z.object({});
 
 const GetWriteOffSumByOrderResponseSchema = z.object({
     message: z.string().optional(),
-    data: z.number(),
+    // Сумма списаний (количество × цена позиции) — деньги, отрицательной быть не может.
+    data: NonNegativeMoneySchema,
 });
 
 export namespace GetWriteOffSumByOrderContractQuery {

package/commands/write-off/update-write-off-price.command.ts

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { WriteOffSchema } from '../../schemas';
+import { MoneySchema } from '../../schemas/money.schema';
 
 const UpdateWriteOffPriceRequestSchema = z.object({
     quantity: z.coerce.number(),
-    price: z.coerce.number(),
+    price: MoneySchema,
 });
 
 const UpdateWriteOffPriceResponseSchema = z.object({

package/package.json

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

package/schemas/action-log/action-log-money.schema.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
+
+/**
+ * Денежная величина внутри записи журнала аудита.
+ *
+ * Отличается от обычного `MoneySchema` тем, что принимает ОБА формата: и десятичную строку,
+ * которой деньги пишутся сейчас, и JSON-число, которым они писались раньше.
+ *
+ * Причина в природе самих данных. `action_log.payload` — это неизменяемый журнал: он фиксирует,
+ * что произошло, в том виде, в каком это выглядело на момент события. На проде в нём 265 402
+ * записи с деньгами-числами, разложенными по шести разным формам payload'а на разной глубине
+ * вложенности. Переписать их миграцией мешает и объём, и то, что `jsonb_set` требует конкретный
+ * путь: рекурсивно искать `jsonb_path_exists` умеет, а записывать — нет. Любая форма, не учтённая
+ * в такой миграции, осталась бы непочиненной и роняла бы чтение.
+ *
+ * Но главное — переписывать историю аудита под новую схему неправильно по существу, даже когда
+ * переписывание чисто техническое.
+ *
+ * Поэтому снисходительность живёт здесь и только здесь. Во всех остальных местах, включая JSON-поля
+ * `settings.delivery_pricing_tiers` и `discount_rules.data`, деньги мигрированы в строки, и там
+ * используется строгий `MoneySchema`.
+ *
+ * Новые записи журнала уже пишутся строками: `Decimal.toJSON()` возвращает строку.
+ */
+export const ActionLogMoneySchema = z.union([MoneySchema, z.number().transform(value => value.toFixed(2))]);

package/schemas/action-log/index.ts

@@ -21,3 +21,4 @@ export * from './consignment-items-create-action-log.schema';
 export * from './consignment-items-delete-action-log.schema';
 export * from './group-update-consignment-items-action-log.schema';
 export * from './transfer-consignment-items-action-log.schema';
+export * from './action-log-money.schema';