@floristcloud/api-lib 1.2.114 → 1.2.115

package/build/commands/cash-flow-item/create-cash-flow-item.command.js

@@ -6,6 +6,7 @@ const schemas_1 = require("../../schemas");
 const CreateCashFlowItemRequestSchema = zod_1.z.object({
     name: zod_1.z.string().trim().min(1).max(255),
     sortOrder: zod_1.z.coerce.number().int().optional(),
+    excludeFromReports: zod_1.z.boolean().optional(),
 });
 const CreateCashFlowItemResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/cash-flow-item/update-cash-flow-item.command.js

@@ -8,6 +8,7 @@ const UpdateCashFlowItemRequestSchema = zod_1.z.object({
     name: zod_1.z.string().trim().min(1).max(255).optional(),
     status: zod_1.z.nativeEnum(cash_flow_item_status_enum_1.CashFlowItemStatusEnum).optional(),
     sortOrder: zod_1.z.coerce.number().int().optional(),
+    excludeFromReports: zod_1.z.boolean().optional(),
 });
 const UpdateCashFlowItemResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/report/get-cash-flow.query.js

@@ -32,7 +32,14 @@ const CashFlowItemRowSchema = zod_1.z.object({
     cashFlowItemName: zod_1.z.string().nullable(),
     income: money_schema_1.MoneySchema,
     expense: money_schema_1.MoneySchema,
+    // Часть `expense`, которая является расходом бизнеса: без выплат клиентам и возвратов
+    // предоплат — они двигают баланс клиента, а не прибыль. Для большинства статей совпадает
+    // с `expense`. Флаг статьи здесь НЕ применён: строка со своей суммой видна всегда, а
+    // складывать её или нет — решает `excludeFromReports`.
+    operatingExpense: money_schema_1.MoneySchema,
     transactionCount: zod_1.z.number(),
+    // Копия флага статьи. У строки "Без статьи" всегда false — такие платежи учитываются.
+    excludeFromReports: zod_1.z.boolean(),
 });
 const CashFlowMonthRowSchema = CashFlowItemRowSchema.extend({
     month: zod_1.z.string(),
@@ -48,6 +55,13 @@ const GetCashFlowResponseSchema = zod_1.z.object({
             // Сальдо (`income - expense`) — знаковая величина, минус здесь легален,
             // поэтому ограничения на знак нет и быть не должно.
             total: money_schema_1.MoneySchema,
+            // Расход, который вычитается из прибыли на странице отчётов: сумма `operatingExpense`
+            // по строкам с `excludeFromReports = false`, включая строку "Без статьи".
+            expenseForReports: money_schema_1.MoneySchema,
+            // Часть `expenseForReports` без проставленной статьи — величина "из них", а не слагаемое.
+            expenseWithoutItem: money_schema_1.MoneySchema,
+            // Сколько денег отсекли флагом статьи. Для сноски "мимо отчёта прошло X".
+            excludedExpense: money_schema_1.MoneySchema,
         }),
     }),
 });

package/build/schemas/cash-flow-item/cash-flow-item.schema.js

@@ -9,6 +9,9 @@ exports.CashFlowItemSchema = zod_1.z.object({
     name: zod_1.z.string(),
     status: zod_1.z.nativeEnum(cash_flow_item_status_enum_1.CashFlowItemStatusEnum),
     sortOrder: zod_1.z.number(),
+    // Статья не участвует в расчёте прибыли: перевод между кассами, оплата поставщику (уже сидит
+    // в себестоимости), выплата учредителю. На отчёт ДДС не влияет — там остаются все обороты.
+    excludeFromReports: zod_1.z.boolean(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });

package/commands/cash-flow-item/create-cash-flow-item.command.ts

@@ -4,6 +4,7 @@ import { CashFlowItemSchema } from '../../schemas';
 const CreateCashFlowItemRequestSchema = z.object({
     name: z.string().trim().min(1).max(255),
     sortOrder: z.coerce.number().int().optional(),
+    excludeFromReports: z.boolean().optional(),
 });
 
 const CreateCashFlowItemResponseSchema = z.object({

package/commands/cash-flow-item/update-cash-flow-item.command.ts

@@ -6,6 +6,7 @@ const UpdateCashFlowItemRequestSchema = z.object({
     name: z.string().trim().min(1).max(255).optional(),
     status: z.nativeEnum(CashFlowItemStatusEnum).optional(),
     sortOrder: z.coerce.number().int().optional(),
+    excludeFromReports: z.boolean().optional(),
 });
 
 const UpdateCashFlowItemResponseSchema = z.object({

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

@@ -31,7 +31,14 @@ const CashFlowItemRowSchema = z.object({
     cashFlowItemName: z.string().nullable(),
     income: MoneySchema,
     expense: MoneySchema,
+    // Часть `expense`, которая является расходом бизнеса: без выплат клиентам и возвратов
+    // предоплат — они двигают баланс клиента, а не прибыль. Для большинства статей совпадает
+    // с `expense`. Флаг статьи здесь НЕ применён: строка со своей суммой видна всегда, а
+    // складывать её или нет — решает `excludeFromReports`.
+    operatingExpense: MoneySchema,
     transactionCount: z.number(),
+    // Копия флага статьи. У строки "Без статьи" всегда false — такие платежи учитываются.
+    excludeFromReports: z.boolean(),
 });
 
 const CashFlowMonthRowSchema = CashFlowItemRowSchema.extend({
@@ -49,6 +56,13 @@ const GetCashFlowResponseSchema = z.object({
             // Сальдо (`income - expense`) — знаковая величина, минус здесь легален,
             // поэтому ограничения на знак нет и быть не должно.
             total: MoneySchema,
+            // Расход, который вычитается из прибыли на странице отчётов: сумма `operatingExpense`
+            // по строкам с `excludeFromReports = false`, включая строку "Без статьи".
+            expenseForReports: MoneySchema,
+            // Часть `expenseForReports` без проставленной статьи — величина "из них", а не слагаемое.
+            expenseWithoutItem: MoneySchema,
+            // Сколько денег отсекли флагом статьи. Для сноски "мимо отчёта прошло X".
+            excludedExpense: MoneySchema,
         }),
     }),
 });

package/package.json

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

package/schemas/cash-flow-item/cash-flow-item.schema.ts

@@ -7,6 +7,9 @@ export const CashFlowItemSchema = z.object({
     name: z.string(),
     status: z.nativeEnum(CashFlowItemStatusEnum),
     sortOrder: z.number(),
+    // Статья не участвует в расчёте прибыли: перевод между кассами, оплата поставщику (уже сидит
+    // в себестоимости), выплата учредителю. На отчёт ДДС не влияет — там остаются все обороты.
+    excludeFromReports: z.boolean(),
     createdAt: z.date(),
     updatedAt: z.date(),
 });