@floristcloud/api-lib 1.2.108 → 1.2.110

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-by-client.query.ts

@@ -3,6 +3,7 @@ import { OrderByEnum, ReportSortByEnum } from '../../enum';
 import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
 import { isPageAccompaniedByCount } from '../../helpers/pagination.helper';
 import { SalesByClientRowSchema } from '../../schemas/report/sales-by-client-row.schema';
+import { ReportOrderFilterSchema } from '../../schemas/report/report-order-filter.schema';
 
 const GetSalesByClientRequestSchema = z
     .object({
@@ -16,6 +17,8 @@ const GetSalesByClientRequestSchema = z
         page: z.coerce.number().int().positive().optional().describe('1-based page number, requires "count".'),
         count: z.coerce.number().int().positive().optional().describe('Rows per page. Without it every client row is returned.'),
     })
+    // dateBasis / excludeClientUUID — те же, что у JSON-эндпоинтов отчётов по заказам.
+    .merge(ReportOrderFilterSchema)
     .refine(value => dateRangeCheck(value.startDate, value.endDate), {
         message: 'validation.dateRange',
         path: ['endDate', 'startDate'],

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

@@ -1,6 +1,8 @@
 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
     .object({
@@ -8,6 +10,9 @@ const GetSalesSummaryRequestSchema = z
         endDate: z.coerce.date().optional(),
         periodType: z.nativeEnum(ReportPeriodTypeEnum).default(ReportPeriodTypeEnum.DAY),
     })
+    // dateBasis / excludeClientUUID общие с group-client: обе цифры живут на одном экране и должны
+    // сужаться одинаково.
+    .merge(ReportOrderFilterSchema)
     .refine(
         value => {
             const { startDate, endDate } = value;
@@ -23,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/constant/index.ts

@@ -4,3 +4,4 @@ export * from './error-i18n-key';
 export * from './import.constant';
 export * from './validation-i18n-key';
 export * from './validation-i18n-message';
+export * from './report.constant';

package/constant/report.constant.ts

@@ -0,0 +1,6 @@
+/**
+ * Потолок списка исключаемых из отчёта клиентов. Список едет в query-строке и дальше в SQL
+ * как `= ANY($n::text[])`, поэтому ограничение защищает и от переполнения URL, и от запроса
+ * с массивом в тысячи элементов.
+ */
+export const REPORT_EXCLUDE_CLIENT_LIMIT = 500;

package/enum/index.ts

@@ -98,3 +98,4 @@ export * from './cash-flow-item-status.enum';
 export * from './payment-invoice-status.enum';
 export * from './order-by.enum';
 export * from './report-sort-by.enum';
+export * from './report-order-date-basis.enum';

package/enum/report-order-date-basis.enum.ts

@@ -0,0 +1,14 @@
+/**
+ * Ось периода для отчётов по заказам — ровно одна дата на отчёт.
+ *
+ * CREATED_AT — по дате создания заказа (историческое поведение всех отчётов).
+ * COMPLETED_AT — по дате отгрузки (завершения); заказ, созданный в июне и отгруженный в июле,
+ * попадёт в июль.
+ *
+ * Дизъюнкции («любая из дат») здесь намеренно нет: заказ, созданный в июне и отгруженный в июле,
+ * попал бы в оба месяца, сумма отчётов по месяцам перестала бы сходиться с отчётом за квартал.
+ */
+export enum ReportOrderDateBasisEnum {
+    CREATED_AT = 'CREATED_AT',
+    COMPLETED_AT = 'COMPLETED_AT',
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.108",
+    "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';

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ActionLogMoneySchema } from './action-log-money.schema';
 
 export const OrderInfoSchema = z.object({
     orderUUID: z.string(),
@@ -6,7 +7,7 @@ export const OrderInfoSchema = z.object({
     clientUUID: z.string(),
     clientName: z.string(),
     createdAt: z.coerce.date(),
-    totalCost: z.coerce.number(),
+    totalCost: ActionLogMoneySchema,
     deliveryAddress: z.string().nullable().optional(),
-    deliveryCost: z.coerce.number().nullable().optional(),
+    deliveryCost: ActionLogMoneySchema.nullable().optional(),
 });

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ActionLogMoneySchema } from './action-log-money.schema';
 
 export const OrderProductInfoSchema = z.object({
     orderUUID: z.string(),
@@ -8,7 +9,7 @@ export const OrderProductInfoSchema = z.object({
     categoryUUID: z.string().nullable(),
     categoryName: z.string().nullable(),
     quantity: z.coerce.number(),
-    price: z.coerce.number(),
+    price: ActionLogMoneySchema,
     consignmentUUID: z.string().nullable(),
     consignmentDeliveryDate: z.coerce.date().nullable(),
 });

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

@@ -1,8 +1,9 @@
 import { z } from 'zod';
 import { OrderProductInfoSchema } from './order-product-info.schema';
+import { ActionLogMoneySchema } from './action-log-money.schema';
 
 export const OrderProductUpdateActionLogSchema = z.object({
     orderProduct: OrderProductInfoSchema,
     newQuantity: z.coerce.number(),
-    newPrice: z.coerce.number(),
+    newPrice: ActionLogMoneySchema,
 });

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ActionLogMoneySchema } from './action-log-money.schema';
 
 export const PreOrderProductInfoSchema = z.object({
     preOrderUUID: z.string(),
@@ -6,6 +7,6 @@ export const PreOrderProductInfoSchema = z.object({
     name: z.string(),
     categoryName: z.string().nullable(),
     quantity: z.coerce.number(),
-    price: z.coerce.number(),
+    price: ActionLogMoneySchema,
     comment: z.string().nullable(),
 });

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

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { PreOrderProductInfoSchema } from './pre-order-product-info.schema';
+import { ActionLogMoneySchema } from './action-log-money.schema';
 
 export const PreOrderProductUpdateActionLogSchema = z.object({
     preOrderProduct: PreOrderProductInfoSchema,
     newQuantity: z.coerce.number(),
-    newPrice: z.coerce.number(),
+    newPrice: ActionLogMoneySchema,
     newComment: z.string().nullable(),
 });

package/schemas/action-log/transaction-info.schema.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { TransactionTypeEnum } from '../../enum';
+import { ActionLogMoneySchema } from './action-log-money.schema';
 
 export const TransactionInfoSchema = z.object({
     transactionUUID: z.string(),
     createdAt: z.coerce.date(),
-    amount: z.coerce.number(),
+    amount: ActionLogMoneySchema,
     moneyAccountName: z.string(),
     type: z.nativeEnum(TransactionTypeEnum),
     clientName: z.string().nullable(),

package/schemas/bank-payment/bank-payment.schema.ts

@@ -1,13 +1,14 @@
 import { z } from 'zod';
 import { BankProviderEnum } from '../../enum/bank-provider.enum';
 import { BankPaymentEventStatusEnum } from '../../enum/bank-payment-event-status.enum';
+import { MoneySchema } from '../money.schema';
 
 export const BankPaymentSchema = z.object({
     uuid: z.uuid(),
     provider: z.nativeEnum(BankProviderEnum),
     externalEventId: z.string(),
     accountNumber: z.string(),
-    amount: z.coerce.number(),
+    amount: MoneySchema,
     currency: z.string(),
     purpose: z.string(),
     status: z.nativeEnum(BankPaymentEventStatusEnum),

package/schemas/client/client-debt.schema.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
 
 export const ClientDebtItemSchema = z.object({
     clientUUID: z.uuid(),
@@ -7,11 +8,13 @@ export const ClientDebtItemSchema = z.object({
     group: z.string().nullable(),
     city: z.string().nullable(),
     responsibleUserName: z.string().nullable(),
-    currentBalance: z.number(),
-    transactionNet: z.number(),
-    completedOrdersBalance: z.number(),
-    completedOrdersBalanceWithDelay: z.number(),
-    nonCompletedBalance: z.number(),
+    currentBalance: MoneySchema,
+    // Знаковые величины: сальдо транзакций и остатки по заказам законно уходят в минус
+    // (переплата клиента, возврат), поэтому ограничения на знак здесь нет и быть не должно.
+    transactionNet: MoneySchema,
+    completedOrdersBalance: MoneySchema,
+    completedOrdersBalanceWithDelay: MoneySchema,
+    nonCompletedBalance: MoneySchema,
     hasOverdueDebt: z.boolean().nullable(),
 });
 

package/schemas/client/client.schema.ts

@@ -7,6 +7,7 @@ import { ClientIndividualProfileSchema } from './client-individual-profile.schem
 import { ClientLegalProfileSchema } from './client-legal-profile.schema';
 import { DiscountRulesSchema } from '../discount-rules/discount-rules.schema';
 import { ClientMarkingSchema } from './client-marking.schema';
+import { MoneySchema } from '../money.schema';
 
 export const ClientSchema = z.object({
     uuid: z.uuid(),
@@ -29,7 +30,7 @@ export const ClientSchema = z.object({
     comment: z.string().nullable(),
     paymentGraceDaysAfterCompletion: z.number().nullable(),
 
-    balance: z.number(),
+    balance: MoneySchema,
 
     deletedAt: z.date().nullable(),
     createdAt: z.date(),

package/schemas/consignment/consignment.schema.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { ConsignmentImportSchemaRelationEntityPropertyEnum, ConsignmentStatusEnum, ConsingmentImportErrorsEnum } from '../../enum';
 import { ClientSchema } from '../client';
+import { MoneySchema } from '../money.schema';
 
 export const ConsignmentSchema = z.object({
     uuid: z.uuid(),
@@ -20,25 +21,25 @@ export const ConsignmentSchema = z.object({
 
 export const ConsignmentWithStatisticForListSchema = ConsignmentSchema.extend({
     statistic: z.object({
-        totalCostPrice: z.number(),
+        totalCostPrice: MoneySchema,
         currentProductBalance: z.number(),
-        currentCostPrice: z.number(),
+        currentCostPrice: MoneySchema,
         totalProductQuantity: z.number(),
-        totalSellings: z.number(),
-        totalApprovedWriteOffSellings: z.number(),
+        totalSellings: MoneySchema,
+        totalApprovedWriteOffSellings: MoneySchema,
     }),
 });
 
 export const ConsignmentWithStatisticSchema = ConsignmentSchema.extend({
     statistic: z.object({
-        totalCostPrice: z.number(),
+        totalCostPrice: MoneySchema,
         currentProductBalance: z.number(),
-        currentCostPrice: z.number(),
+        currentCostPrice: MoneySchema,
         totalProductQuantity: z.number(),
-        totalSellings: z.number(),
+        totalSellings: MoneySchema,
         writeOffQuantity: z.number(),
-        writeOffCostPrice: z.number(),
-        writeOffCostPriceByOrderProduct: z.number(),
+        writeOffCostPrice: MoneySchema,
+        writeOffCostPriceByOrderProduct: MoneySchema,
     }),
 });
 

package/schemas/consignment-transfer/accept-consignment-transfer.schema.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 import { ConsignmentTransferRequestSchema } from './consignment-transfer-request.schema';
+import { MoneySchema } from '../money.schema';
+import { NonNegativeMoneySchema } from '../non-negative-money.schema';
 
 export const AcceptConsignmentTransferRequestSchema = z
     .object({
@@ -17,7 +19,8 @@ export const AcceptConsignmentTransferRequestSchema = z
                 z.object({
                     itemUUID: z.uuid(),
                     categoryUUID: z.uuid(),
-                    price: z.number().min(0).optional(),
+                    // Отрицательную цену отсекаем по знаку строки — минус и есть признак отрицательности.
+                    price: NonNegativeMoneySchema.optional(),
                 }),
             )
             .min(1),

package/schemas/consignment-transfer/consignment-transfer-request-item.schema.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
 
 export const ConsignmentTransferRequestItemSchema = z.object({
     uuid: z.uuid(),
@@ -6,7 +7,7 @@ export const ConsignmentTransferRequestItemSchema = z.object({
     targetProductUUID: z.uuid().nullable(),
     name: z.string(),
     quantity: z.number().int(),
-    transferPrice: z.number(),
+    transferPrice: MoneySchema,
     categoryName: z.string().nullable(),
     multiplicity: z.number().int(),
     grower: z.string().nullable(),

package/schemas/delivery-route/delivery-route.schema.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { DeliveryRouteStatusEnum, OrderDeliveryStatusEnum, OrderStatusEnum } from '../../enum';
+import { MoneySchema } from '../money.schema';
 
 export const DeliveryRouteSchema = z.object({
     uuid: z.uuid(),
@@ -34,7 +35,7 @@ export const DeliveryRouteWithOrdersSchema = DeliveryRouteSchema.extend({
             orderNumber: z.number(),
             orderStatus: z.nativeEnum(OrderStatusEnum),
             orderCreatedAt: z.coerce.date(),
-            totalCost: z.number(),
+            totalCost: MoneySchema,
             clientName: z.string(),
             clientCity: z.string().nullable(),
             clientAddress: z.string().nullable(),

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

@@ -2,10 +2,17 @@ import { z } from 'zod';
 import { DiscountRulesTypeEnum, DiscountRulesApplyTypeEnum, DiscountRulesStatusEnum, DiscountRulesModeTypeEnum } from '../../enum';
 import { ClientSchema } from '../client';
 import { ProductSchema } from '../product/product.schema';
+import { MoneySchema } from '../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) }),
-    z.object({ typeDiscount: z.literal(DiscountRulesModeTypeEnum.FIXED), discountValue: z.number().positive() }),
+    z.object({
+        typeDiscount: z.literal(DiscountRulesModeTypeEnum.FIXED),
+        // Строго положительная сумма: минус отсекаем по знаку строки, нули вида "0" / "0.00" — сравнением.
+        discountValue: PositiveMoneySchema,
+    }),
 ]);
 
 // Rules schemas other data
@@ -113,7 +120,7 @@ export const DiscountRulesSplitQuantityResponseSchema = z.object({
             productUUID: z.string(),
             quantity: z.number(),
             withDiscount: z.boolean(),
-            price: z.number(),
+            price: MoneySchema,
         })
         .array()
         .nullable(),

package/schemas/index.ts

@@ -77,3 +77,7 @@ export * from './account-deletion-request/account-deletion-request.schema';
 export * from './consignment-transfer';
 export * from './api-error.schema';
 export * from './access-policy';
+export * from './money.schema';
+export * from './non-negative-money.schema';
+export * from './positive-money.schema';
+export * from './report/report-order-filter.schema';

package/schemas/money-account/money-account-with-balance.schema.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { MoneyAccountSchema } from './money-account.schema';
+import { MoneySchema } from '../money.schema';
 
 /**
  * Денежный счёт в ответах списков. `balance` — текущий остаток счёта (приход минус расход),
@@ -7,5 +8,5 @@ import { MoneyAccountSchema } from './money-account.schema';
  * получают ровно прежнюю форму ответа.
  */
 export const MoneyAccountWithBalanceSchema = MoneyAccountSchema.extend({
-    balance: z.number().optional(),
+    balance: MoneySchema.optional(),
 });

package/schemas/money.schema.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+
+/**
+ * Единственное описание денежной величины в контрактах.
+ *
+ * Деньги пересекают границу строкой — точным десятичным представлением, а не float64.
+ * `"8755.48"` доезжает до получателя ровно таким, каким его отправили: ни JSON.parse, ни
+ * арифметика на `number` больше не участвуют в передаче, поэтому двоичный мусор вида
+ * `8755.479000000001` физически неоткуда взяться. Каждая сторона разбирает строку своей
+ * реализацией Decimal: сервер — Prisma.Decimal, клиент — своей библиотекой.
+ *
+ * В `libs/contracts` намеренно НЕТ зависимости от decimal-библиотеки: пакет публикуется как
+ * `@floristcloud/api-lib` и ставится в браузерные бандлы, где лишняя зависимость — это лишние
+ * килобайты и риск конфликта версий с той Decimal-реализацией, которую уже выбрал клиент.
+ * Контракт описывает формат провода, а не арифметику.
+ *
+ * Формат: необязательный минус, целая часть, до двух знаков после точки. Знак минуса —
+ * единственный признак отрицательной величины.
+ *
+ * Сама по себе схема знак не ограничивает: разницы, сальдо и балансы клиентов законно уходят
+ * в минус. Там, где величина не может быть отрицательной или нулевой, берите готовые
+ * `NonNegativeMoneySchema` и `PositiveMoneySchema` — не повторяйте `refine` по месту.
+ * Модификаторы `.optional()` и `.nullable()` работают напрямую.
+ */
+export const MoneySchema = z.string().regex(/^-?\d+(\.\d{1,2})?$/);