@floristcloud/api-lib 1.2.101 → 1.2.103

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateCashFlowItemContractCommand = void 0;
+const zod_1 = require("zod");
+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(),
+});
+const CreateCashFlowItemResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: schemas_1.CashFlowItemSchema.nullable(),
+});
+var CreateCashFlowItemContractCommand;
+(function (CreateCashFlowItemContractCommand) {
+    CreateCashFlowItemContractCommand.RequestSchema = CreateCashFlowItemRequestSchema;
+    CreateCashFlowItemContractCommand.ResponseSchema = CreateCashFlowItemResponseSchema;
+})(CreateCashFlowItemContractCommand || (exports.CreateCashFlowItemContractCommand = CreateCashFlowItemContractCommand = {}));

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteCashFlowItemContractCommand = void 0;
+const zod_1 = require("zod");
+const delete_data_response_schema_1 = require("../../schemas/delete-data-response.schema");
+const DeleteCashFlowItemRequestSchema = zod_1.z.object({});
+const DeleteCashFlowItemResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: delete_data_response_schema_1.DeleteDataResponseSchema,
+});
+var DeleteCashFlowItemContractCommand;
+(function (DeleteCashFlowItemContractCommand) {
+    DeleteCashFlowItemContractCommand.RequestSchema = DeleteCashFlowItemRequestSchema;
+    DeleteCashFlowItemContractCommand.ResponseSchema = DeleteCashFlowItemResponseSchema;
+})(DeleteCashFlowItemContractCommand || (exports.DeleteCashFlowItemContractCommand = DeleteCashFlowItemContractCommand = {}));

package/build/commands/cash-flow-item/get-cash-flow-item-list.query.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCashFlowItemListContractQuery = void 0;
+const zod_1 = require("zod");
+const schemas_1 = require("../../schemas");
+const cash_flow_item_status_enum_1 = require("../../enum/cash-flow-item-status.enum");
+const GetCashFlowItemListRequestSchema = zod_1.z.object({
+    status: zod_1.z.nativeEnum(cash_flow_item_status_enum_1.CashFlowItemStatusEnum).optional(),
+});
+const GetCashFlowItemListResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: schemas_1.CashFlowItemSchema.array(),
+});
+var GetCashFlowItemListContractQuery;
+(function (GetCashFlowItemListContractQuery) {
+    GetCashFlowItemListContractQuery.RequestSchema = GetCashFlowItemListRequestSchema;
+    GetCashFlowItemListContractQuery.ResponseSchema = GetCashFlowItemListResponseSchema;
+})(GetCashFlowItemListContractQuery || (exports.GetCashFlowItemListContractQuery = GetCashFlowItemListContractQuery = {}));

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCashFlowItemContractQuery = void 0;
+const zod_1 = require("zod");
+const schemas_1 = require("../../schemas");
+const GetCashFlowItemResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: schemas_1.CashFlowItemSchema.nullable(),
+});
+var GetCashFlowItemContractQuery;
+(function (GetCashFlowItemContractQuery) {
+    GetCashFlowItemContractQuery.ResponseSchema = GetCashFlowItemResponseSchema;
+})(GetCashFlowItemContractQuery || (exports.GetCashFlowItemContractQuery = GetCashFlowItemContractQuery = {}));

package/build/commands/cash-flow-item/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-cash-flow-item.command"), exports);
+__exportStar(require("./update-cash-flow-item.command"), exports);
+__exportStar(require("./delete-cash-flow-item.command"), exports);
+__exportStar(require("./get-cash-flow-item.query"), exports);
+__exportStar(require("./get-cash-flow-item-list.query"), exports);

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateCashFlowItemContractCommand = void 0;
+const zod_1 = require("zod");
+const schemas_1 = require("../../schemas");
+const cash_flow_item_status_enum_1 = require("../../enum/cash-flow-item-status.enum");
+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(),
+});
+const UpdateCashFlowItemResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: schemas_1.CashFlowItemSchema.nullable(),
+});
+var UpdateCashFlowItemContractCommand;
+(function (UpdateCashFlowItemContractCommand) {
+    UpdateCashFlowItemContractCommand.RequestSchema = UpdateCashFlowItemRequestSchema;
+    UpdateCashFlowItemContractCommand.ResponseSchema = UpdateCashFlowItemResponseSchema;
+})(UpdateCashFlowItemContractCommand || (exports.UpdateCashFlowItemContractCommand = UpdateCashFlowItemContractCommand = {}));

package/build/commands/index.js

@@ -18,6 +18,7 @@ exports.ValidateWsTicketS2SContractQuery = exports.CreateWsTicketContractCommand
 __exportStar(require("./access-policy"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./branch"), exports);
+__exportStar(require("./cash-flow-item"), exports);
 __exportStar(require("./category"), exports);
 __exportStar(require("./category-alias"), exports);
 __exportStar(require("./category-template"), exports);

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

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCashFlowContractQuery = void 0;
+const zod_1 = require("zod");
+const date_helper_1 = require("../../helpers/date.helper");
+const GetCashFlowRequestSchema = zod_1.z
+    .object({
+    startDate: zod_1.z.coerce.date(),
+    endDate: zod_1.z.coerce.date(),
+    moneyAccountUUID: zod_1.z.string().optional(),
+    // Разбивка оборотов по месяцам внутри периода.
+    // Не z.coerce.boolean(): в query-строке приходит текст, и Boolean('false') === true —
+    // флаг было бы невозможно выключить явным значением.
+    withMonthBreakdown: zod_1.z
+        .union([zod_1.z.boolean(), zod_1.z.string()])
+        .optional()
+        .default(false)
+        .transform(value => (typeof value === 'boolean' ? value : value === 'true' || value === '1')),
+})
+    .refine(value => (0, date_helper_1.dateRangeCheck)(value.startDate, value.endDate), {
+    message: 'validation.dateRange',
+    path: ['endDate', 'startDate'],
+})
+    .refine(value => (0, date_helper_1.isStatementPeriodWithinLimit)(value.startDate, value.endDate), {
+    message: 'validation.reportPeriodMax',
+    path: ['endDate', 'startDate'],
+});
+const CashFlowItemRowSchema = zod_1.z.object({
+    // null — строка "Без статьи": платежи, которым статью ещё не проставили.
+    cashFlowItemUUID: zod_1.z.string().nullable(),
+    cashFlowItemName: zod_1.z.string().nullable(),
+    income: zod_1.z.number(),
+    expense: zod_1.z.number(),
+    transactionCount: zod_1.z.number(),
+});
+const CashFlowMonthRowSchema = CashFlowItemRowSchema.extend({
+    month: zod_1.z.string(),
+});
+const GetCashFlowResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        byItem: CashFlowItemRowSchema.array(),
+        byMonth: CashFlowMonthRowSchema.array(),
+        totals: zod_1.z.object({
+            income: zod_1.z.number(),
+            expense: zod_1.z.number(),
+            total: zod_1.z.number(),
+        }),
+    }),
+});
+var GetCashFlowContractQuery;
+(function (GetCashFlowContractQuery) {
+    GetCashFlowContractQuery.RequestSchema = GetCashFlowRequestSchema;
+    GetCashFlowContractQuery.ResponseSchema = GetCashFlowResponseSchema;
+})(GetCashFlowContractQuery || (exports.GetCashFlowContractQuery = GetCashFlowContractQuery = {}));

package/build/commands/report/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./export-inventory-turnover.query"), exports);
 __exportStar(require("./export-client-statement.query"), exports);
 __exportStar(require("./get-report-by-client-weeks.query"), exports);
 __exportStar(require("./get-daily-orders-summary.query"), exports);
+__exportStar(require("./get-cash-flow.query"), exports);

package/build/commands/transaction/assign-cash-flow-item-to-transactions.command.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignCashFlowItemToTransactionsContractCommand = void 0;
+const zod_1 = require("zod");
+const AssignCashFlowItemToTransactionsRequestSchema = zod_1.z.object({
+    transactionUUIDs: zod_1.z.uuid().array().min(1).max(500),
+    // null снимает статью с выбранных платежей.
+    cashFlowItemUUID: zod_1.z.uuid().nullable(),
+});
+const AssignCashFlowItemToTransactionsResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        updated: zod_1.z.number(),
+    }),
+});
+var AssignCashFlowItemToTransactionsContractCommand;
+(function (AssignCashFlowItemToTransactionsContractCommand) {
+    AssignCashFlowItemToTransactionsContractCommand.RequestSchema = AssignCashFlowItemToTransactionsRequestSchema;
+    AssignCashFlowItemToTransactionsContractCommand.ResponseSchema = AssignCashFlowItemToTransactionsResponseSchema;
+})(AssignCashFlowItemToTransactionsContractCommand || (exports.AssignCashFlowItemToTransactionsContractCommand = AssignCashFlowItemToTransactionsContractCommand = {}));

package/build/commands/transaction/create-transaction.command.js

@@ -12,6 +12,8 @@ const CreateTransactionRequestSchema = schemas_1.TransactionSchema.pick({
     type: true,
 }).extend({
     createdAt: zod_1.z.coerce.date().optional(),
+    // Статья необязательна: система помогает разметить расходы, а не требует этого при оплате.
+    cashFlowItemUUID: zod_1.z.uuid().nullable().optional(),
 });
 const CreateTransactionResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/transaction/export-transactions.command.js

@@ -12,6 +12,7 @@ const ExportTransactionsRequestSchema = zod_1.z
     moneyAccountUUID: zod_1.z.string().optional(),
     clientUUID: zod_1.z.string().optional(),
     orderUUID: zod_1.z.string().optional(),
+    cashFlowItemUUID: zod_1.z.string().optional(),
 })
     .refine(value => {
     const { startDate, endDate } = value;

package/build/commands/transaction/get-transaction-list.query.js

@@ -15,6 +15,7 @@ const GetTransactionListRequestSchema = zod_1.z
     moneyAccountUUID: zod_1.z.string().optional(),
     clientUUID: zod_1.z.string().optional(),
     orderUUID: zod_1.z.string().optional(),
+    cashFlowItemUUID: zod_1.z.string().optional(),
     searchQuery: zod_1.z.string().optional(),
 })
     .refine(value => {

package/build/commands/transaction/get-transaction-summary.query.js

@@ -12,6 +12,7 @@ const GetTransactionSummaryRequestSchema = zod_1.z
     moneyAccountUUID: zod_1.z.string().optional(),
     clientUUID: zod_1.z.string().optional(),
     orderUUID: zod_1.z.string().optional(),
+    cashFlowItemUUID: zod_1.z.string().optional(),
     searchQuery: zod_1.z.string().optional(),
 })
     .refine(value => {

package/build/commands/transaction/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./get-transaction-summary.query"), exports);
 __exportStar(require("./generate-pre-payment-check.command"), exports);
 __exportStar(require("./apply-prepayment-transaction.command"), exports);
 __exportStar(require("./import-transaction.command"), exports);
+__exportStar(require("./assign-cash-flow-item-to-transactions.command"), exports);

package/build/commands/transaction/update-transaction.command.js

@@ -7,6 +7,8 @@ const UpdateTransactionRequestSchema = schemas_1.TransactionSchema.pick({
     comment: true,
 }).extend({
     createdAt: zod_1.z.coerce.date(),
+    // Проставить/сменить статью можно задним числом — основной способ разметки расходов.
+    cashFlowItemUUID: zod_1.z.uuid().nullable().optional(),
 });
 const UpdateTransactionResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/constant/error.js

@@ -1367,4 +1367,26 @@ exports.ERRORS = {
     CONSIGNMENT_TRANSFER_ACCEPT_FAILED: { code: 'CTR013', message: 'Failed to accept consignment transfer request', httpCode: 500 },
     ACCESS_POLICY_FETCH_FAILED: { code: 'AP001', message: 'Error when retrieving the access policy', httpCode: 500 },
     ACCESS_POLICY_NOT_UPDATED: { code: 'AP002', message: 'Failed to update the access policy', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_CREATED: { code: 'CFI001', message: 'Failed to create cash flow item', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_UPDATED: { code: 'CFI002', message: 'Failed to update cash flow item', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_DELETED: { code: 'CFI003', message: 'Failed to delete cash flow item', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_FOUND: { code: 'CFI004', message: 'The cash flow item with the specified UUID was not found', httpCode: 404 },
+    CASH_FLOW_ITEM_FETCH_FAILED: { code: 'CFI005', message: 'Error when retrieving cash flow items', httpCode: 500 },
+    CASH_FLOW_ITEM_WITH_SAME_NAME_ALREADY_EXISTS: {
+        code: 'CFI006',
+        message: 'The cash flow item with the specified name already exists',
+        httpCode: 400,
+    },
+    CASH_FLOW_ITEM_IN_USE: {
+        code: 'CFI007',
+        message: 'The cash flow item is referenced by transactions and cannot be deleted, archive it instead',
+        httpCode: 409,
+    },
+    CASH_FLOW_ITEM_IS_ARCHIVED: { code: 'CFI008', message: 'The cash flow item is archived', httpCode: 400 },
+    CASH_FLOW_REPORT_FAILED: { code: 'CFI009', message: 'Failed to build cash flow report', httpCode: 500 },
+    TRANSACTIONS_CASH_FLOW_ITEM_NOT_ASSIGNED: {
+        code: 'CFI010',
+        message: 'Failed to assign cash flow item to transactions',
+        httpCode: 500,
+    },
 };

package/build/enum/cash-flow-item-status.enum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CashFlowItemStatusEnum = void 0;
+var CashFlowItemStatusEnum;
+(function (CashFlowItemStatusEnum) {
+    CashFlowItemStatusEnum["ACTIVE"] = "ACTIVE";
+    CashFlowItemStatusEnum["ARCHIVE"] = "ARCHIVE";
+})(CashFlowItemStatusEnum || (exports.CashFlowItemStatusEnum = CashFlowItemStatusEnum = {}));

package/build/enum/index.js

@@ -109,3 +109,4 @@ __exportStar(require("./consignment-transfer-request-status.enum"), exports);
 __exportStar(require("./consignment-transfer-direction.enum"), exports);
 __exportStar(require("./legal-identifier-field.enum"), exports);
 __exportStar(require("./permission-key.enum"), exports);
+__exportStar(require("./cash-flow-item-status.enum"), exports);

package/build/enum/permission-key.enum.js

@@ -13,6 +13,14 @@ var PermissionKeyEnum;
     PermissionKeyEnum["COST_VIEW"] = "cost.view";
     // Consignment-level financial totals: total cost + profit (итоги по поставке).
     PermissionKeyEnum["CONSIGNMENT_FINANCIALS_VIEW"] = "consignment.financials.view";
+    PermissionKeyEnum["PAGE_ORDER_VIEW"] = "page.order.view";
+    PermissionKeyEnum["PAGE_STOCK_VIEW"] = "page.stock.view";
+    PermissionKeyEnum["PAGE_CLIENTS_VIEW"] = "page.clients.view";
+    PermissionKeyEnum["PAGE_PAYMENTS_VIEW"] = "page.payments.view";
+    PermissionKeyEnum["PAGE_CATEGORIES_VIEW"] = "page.categories.view";
+    PermissionKeyEnum["PAGE_PRE_ORDERS_VIEW"] = "page.pre_orders.view";
+    PermissionKeyEnum["PAGE_REPORT_VIEW"] = "page.report.view";
+    PermissionKeyEnum["PAGE_STAFF_VIEW"] = "page.staff.view";
 })(PermissionKeyEnum || (exports.PermissionKeyEnum = PermissionKeyEnum = {}));
 exports.PERMISSION_KEY_LIST = [
     PermissionKeyEnum.PRODUCT_VIEW,
@@ -23,4 +31,12 @@ exports.PERMISSION_KEY_LIST = [
     PermissionKeyEnum.CONSIGNMENT_DELETE,
     PermissionKeyEnum.COST_VIEW,
     PermissionKeyEnum.CONSIGNMENT_FINANCIALS_VIEW,
+    PermissionKeyEnum.PAGE_ORDER_VIEW,
+    PermissionKeyEnum.PAGE_STOCK_VIEW,
+    PermissionKeyEnum.PAGE_CLIENTS_VIEW,
+    PermissionKeyEnum.PAGE_PAYMENTS_VIEW,
+    PermissionKeyEnum.PAGE_CATEGORIES_VIEW,
+    PermissionKeyEnum.PAGE_PRE_ORDERS_VIEW,
+    PermissionKeyEnum.PAGE_REPORT_VIEW,
+    PermissionKeyEnum.PAGE_STAFF_VIEW,
 ];

package/build/enum/transaction-import-entity-property.enum.js

@@ -13,4 +13,5 @@ var TransactionImportEntityPropertyEnum;
     TransactionImportEntityPropertyEnum["TYPE"] = "type";
     TransactionImportEntityPropertyEnum["DATE"] = "date";
     TransactionImportEntityPropertyEnum["COMMENT"] = "comment";
+    TransactionImportEntityPropertyEnum["CASH_FLOW_ITEM"] = "cashFlowItem";
 })(TransactionImportEntityPropertyEnum || (exports.TransactionImportEntityPropertyEnum = TransactionImportEntityPropertyEnum = {}));

package/build/enum/transaction-import-errors.enum.js

@@ -9,5 +9,7 @@ var TransactionImportErrorsEnum;
     TransactionImportErrorsEnum["CLIENT_AMBIGUOUS"] = "CLIENT_AMBIGUOUS";
     TransactionImportErrorsEnum["MONEY_ACCOUNT_NOT_FOUND"] = "MONEY_ACCOUNT_NOT_FOUND";
     TransactionImportErrorsEnum["MONEY_ACCOUNT_AMBIGUOUS"] = "MONEY_ACCOUNT_AMBIGUOUS";
+    TransactionImportErrorsEnum["CASH_FLOW_ITEM_NOT_FOUND"] = "CASH_FLOW_ITEM_NOT_FOUND";
+    TransactionImportErrorsEnum["CASH_FLOW_ITEM_AMBIGUOUS"] = "CASH_FLOW_ITEM_AMBIGUOUS";
     TransactionImportErrorsEnum["CREATE_FAILED"] = "CREATE_FAILED";
 })(TransactionImportErrorsEnum || (exports.TransactionImportErrorsEnum = TransactionImportErrorsEnum = {}));

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CashFlowItemSchema = void 0;
+const zod_1 = require("zod");
+const cash_flow_item_status_enum_1 = require("../../enum/cash-flow-item-status.enum");
+exports.CashFlowItemSchema = zod_1.z.object({
+    uuid: zod_1.z.uuid(),
+    companyUUID: zod_1.z.string(),
+    name: zod_1.z.string(),
+    status: zod_1.z.nativeEnum(cash_flow_item_status_enum_1.CashFlowItemStatusEnum),
+    sortOrder: zod_1.z.number(),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});

package/build/schemas/index.js

@@ -32,6 +32,7 @@ __exportStar(require("./order-product/price-correction-analyze-item.schema"), ex
 __exportStar(require("./order-product/price-correction-execute-result-item.schema"), exports);
 __exportStar(require("./transaction/transaction.schema"), exports);
 __exportStar(require("./transaction/transaction-list.schema"), exports);
+__exportStar(require("./cash-flow-item/cash-flow-item.schema"), exports);
 __exportStar(require("./file"), exports);
 __exportStar(require("./product-image/product-image.schema"), exports);
 __exportStar(require("./settings/settings.schema"), exports);

package/build/schemas/transaction/transaction.schema.js

@@ -15,6 +15,7 @@ exports.TransactionSchema = zod_1.z.object({
     orderUUID: zod_1.z.string().nullable(),
     type: zod_1.z.nativeEnum(enum_1.TransactionTypeEnum),
     createdByUserUUID: zod_1.z.string(),
+    cashFlowItemUUID: zod_1.z.string().nullable(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
     deletedAt: zod_1.z.date().nullable(),

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

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { CashFlowItemSchema } from '../../schemas';
+
+const CreateCashFlowItemRequestSchema = z.object({
+    name: z.string().trim().min(1).max(255),
+    sortOrder: z.coerce.number().int().optional(),
+});
+
+const CreateCashFlowItemResponseSchema = z.object({
+    message: z.string().optional(),
+    data: CashFlowItemSchema.nullable(),
+});
+
+export namespace CreateCashFlowItemContractCommand {
+    export const RequestSchema = CreateCashFlowItemRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = CreateCashFlowItemResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

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

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { DeleteDataResponseSchema } from '../../schemas/delete-data-response.schema';
+
+const DeleteCashFlowItemRequestSchema = z.object({});
+
+const DeleteCashFlowItemResponseSchema = z.object({
+    message: z.string().optional(),
+    data: DeleteDataResponseSchema,
+});
+
+export namespace DeleteCashFlowItemContractCommand {
+    export const RequestSchema = DeleteCashFlowItemRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = DeleteCashFlowItemResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/cash-flow-item/get-cash-flow-item-list.query.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { CashFlowItemSchema } from '../../schemas';
+import { CashFlowItemStatusEnum } from '../../enum/cash-flow-item-status.enum';
+
+const GetCashFlowItemListRequestSchema = z.object({
+    status: z.nativeEnum(CashFlowItemStatusEnum).optional(),
+});
+
+const GetCashFlowItemListResponseSchema = z.object({
+    message: z.string().optional(),
+    data: CashFlowItemSchema.array(),
+});
+
+export namespace GetCashFlowItemListContractQuery {
+    export const RequestSchema = GetCashFlowItemListRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetCashFlowItemListResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

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

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { CashFlowItemSchema } from '../../schemas';
+
+const GetCashFlowItemResponseSchema = z.object({
+    message: z.string().optional(),
+    data: CashFlowItemSchema.nullable(),
+});
+
+export namespace GetCashFlowItemContractQuery {
+    export const ResponseSchema = GetCashFlowItemResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/cash-flow-item/index.ts

@@ -0,0 +1,5 @@
+export * from './create-cash-flow-item.command';
+export * from './update-cash-flow-item.command';
+export * from './delete-cash-flow-item.command';
+export * from './get-cash-flow-item.query';
+export * from './get-cash-flow-item-list.query';

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { CashFlowItemSchema } from '../../schemas';
+import { CashFlowItemStatusEnum } from '../../enum/cash-flow-item-status.enum';
+
+const UpdateCashFlowItemRequestSchema = z.object({
+    name: z.string().trim().min(1).max(255).optional(),
+    status: z.nativeEnum(CashFlowItemStatusEnum).optional(),
+    sortOrder: z.coerce.number().int().optional(),
+});
+
+const UpdateCashFlowItemResponseSchema = z.object({
+    message: z.string().optional(),
+    data: CashFlowItemSchema.nullable(),
+});
+
+export namespace UpdateCashFlowItemContractCommand {
+    export const RequestSchema = UpdateCashFlowItemRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = UpdateCashFlowItemResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/index.ts

@@ -1,6 +1,7 @@
 export * from './access-policy';
 export * from './auth';
 export * from './branch';
+export * from './cash-flow-item';
 export * from './category';
 export * from './category-alias';
 export * from './category-template';

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
+
+const GetCashFlowRequestSchema = z
+    .object({
+        startDate: z.coerce.date(),
+        endDate: z.coerce.date(),
+        moneyAccountUUID: z.string().optional(),
+        // Разбивка оборотов по месяцам внутри периода.
+        // Не z.coerce.boolean(): в query-строке приходит текст, и Boolean('false') === true —
+        // флаг было бы невозможно выключить явным значением.
+        withMonthBreakdown: z
+            .union([z.boolean(), z.string()])
+            .optional()
+            .default(false)
+            .transform(value => (typeof value === 'boolean' ? value : value === 'true' || value === '1')),
+    })
+    .refine(value => dateRangeCheck(value.startDate, value.endDate), {
+        message: 'validation.dateRange',
+        path: ['endDate', 'startDate'],
+    })
+    .refine(value => isStatementPeriodWithinLimit(value.startDate, value.endDate), {
+        message: 'validation.reportPeriodMax',
+        path: ['endDate', 'startDate'],
+    });
+
+const CashFlowItemRowSchema = z.object({
+    // null — строка "Без статьи": платежи, которым статью ещё не проставили.
+    cashFlowItemUUID: z.string().nullable(),
+    cashFlowItemName: z.string().nullable(),
+    income: z.number(),
+    expense: z.number(),
+    transactionCount: z.number(),
+});
+
+const CashFlowMonthRowSchema = CashFlowItemRowSchema.extend({
+    month: z.string(),
+});
+
+const GetCashFlowResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        byItem: CashFlowItemRowSchema.array(),
+        byMonth: CashFlowMonthRowSchema.array(),
+        totals: z.object({
+            income: z.number(),
+            expense: z.number(),
+            total: z.number(),
+        }),
+    }),
+});
+
+export namespace GetCashFlowContractQuery {
+    export const RequestSchema = GetCashFlowRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetCashFlowResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/report/index.ts

@@ -11,3 +11,4 @@ export * from './export-inventory-turnover.query';
 export * from './export-client-statement.query';
 export * from './get-report-by-client-weeks.query';
 export * from './get-daily-orders-summary.query';
+export * from './get-cash-flow.query';

package/commands/transaction/assign-cash-flow-item-to-transactions.command.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+
+const AssignCashFlowItemToTransactionsRequestSchema = z.object({
+    transactionUUIDs: z.uuid().array().min(1).max(500),
+    // null снимает статью с выбранных платежей.
+    cashFlowItemUUID: z.uuid().nullable(),
+});
+
+const AssignCashFlowItemToTransactionsResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        updated: z.number(),
+    }),
+});
+
+export namespace AssignCashFlowItemToTransactionsContractCommand {
+    export const RequestSchema = AssignCashFlowItemToTransactionsRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = AssignCashFlowItemToTransactionsResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

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

@@ -10,6 +10,8 @@ const CreateTransactionRequestSchema = TransactionSchema.pick({
     type: true,
 }).extend({
     createdAt: z.coerce.date().optional(),
+    // Статья необязательна: система помогает разметить расходы, а не требует этого при оплате.
+    cashFlowItemUUID: z.uuid().nullable().optional(),
 });
 
 const CreateTransactionResponseSchema = z.object({

package/commands/transaction/export-transactions.command.ts

@@ -10,6 +10,7 @@ const ExportTransactionsRequestSchema = z
         moneyAccountUUID: z.string().optional(),
         clientUUID: z.string().optional(),
         orderUUID: z.string().optional(),
+        cashFlowItemUUID: z.string().optional(),
     })
     .refine(
         value => {

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

@@ -13,6 +13,7 @@ const GetTransactionListRequestSchema = z
         moneyAccountUUID: z.string().optional(),
         clientUUID: z.string().optional(),
         orderUUID: z.string().optional(),
+        cashFlowItemUUID: z.string().optional(),
         searchQuery: z.string().optional(),
     })
     .refine(

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

@@ -10,6 +10,7 @@ const GetTransactionSummaryRequestSchema = z
         moneyAccountUUID: z.string().optional(),
         clientUUID: z.string().optional(),
         orderUUID: z.string().optional(),
+        cashFlowItemUUID: z.string().optional(),
         searchQuery: z.string().optional(),
     })
     .refine(

package/commands/transaction/index.ts

@@ -11,3 +11,4 @@ export * from './get-transaction-summary.query';
 export * from './generate-pre-payment-check.command';
 export * from './apply-prepayment-transaction.command';
 export * from './import-transaction.command';
+export * from './assign-cash-flow-item-to-transactions.command';

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

@@ -5,6 +5,8 @@ const UpdateTransactionRequestSchema = TransactionSchema.pick({
     comment: true,
 }).extend({
     createdAt: z.coerce.date(),
+    // Проставить/сменить статью можно задним числом — основной способ разметки расходов.
+    cashFlowItemUUID: z.uuid().nullable().optional(),
 });
 
 const UpdateTransactionResponseSchema = z.object({

package/constant/error.ts

@@ -1435,4 +1435,26 @@ export const ERRORS = {
     CONSIGNMENT_TRANSFER_ACCEPT_FAILED: { code: 'CTR013', message: 'Failed to accept consignment transfer request', httpCode: 500 },
     ACCESS_POLICY_FETCH_FAILED: { code: 'AP001', message: 'Error when retrieving the access policy', httpCode: 500 },
     ACCESS_POLICY_NOT_UPDATED: { code: 'AP002', message: 'Failed to update the access policy', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_CREATED: { code: 'CFI001', message: 'Failed to create cash flow item', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_UPDATED: { code: 'CFI002', message: 'Failed to update cash flow item', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_DELETED: { code: 'CFI003', message: 'Failed to delete cash flow item', httpCode: 500 },
+    CASH_FLOW_ITEM_NOT_FOUND: { code: 'CFI004', message: 'The cash flow item with the specified UUID was not found', httpCode: 404 },
+    CASH_FLOW_ITEM_FETCH_FAILED: { code: 'CFI005', message: 'Error when retrieving cash flow items', httpCode: 500 },
+    CASH_FLOW_ITEM_WITH_SAME_NAME_ALREADY_EXISTS: {
+        code: 'CFI006',
+        message: 'The cash flow item with the specified name already exists',
+        httpCode: 400,
+    },
+    CASH_FLOW_ITEM_IN_USE: {
+        code: 'CFI007',
+        message: 'The cash flow item is referenced by transactions and cannot be deleted, archive it instead',
+        httpCode: 409,
+    },
+    CASH_FLOW_ITEM_IS_ARCHIVED: { code: 'CFI008', message: 'The cash flow item is archived', httpCode: 400 },
+    CASH_FLOW_REPORT_FAILED: { code: 'CFI009', message: 'Failed to build cash flow report', httpCode: 500 },
+    TRANSACTIONS_CASH_FLOW_ITEM_NOT_ASSIGNED: {
+        code: 'CFI010',
+        message: 'Failed to assign cash flow item to transactions',
+        httpCode: 500,
+    },
 } as const;

package/enum/cash-flow-item-status.enum.ts

@@ -0,0 +1,4 @@
+export enum CashFlowItemStatusEnum {
+    ACTIVE = 'ACTIVE',
+    ARCHIVE = 'ARCHIVE',
+}

package/enum/index.ts

@@ -93,3 +93,4 @@ export * from './consignment-transfer-request-status.enum';
 export * from './consignment-transfer-direction.enum';
 export * from './legal-identifier-field.enum';
 export * from './permission-key.enum';
+export * from './cash-flow-item-status.enum';

package/enum/permission-key.enum.ts

@@ -9,6 +9,14 @@ export enum PermissionKeyEnum {
     COST_VIEW = 'cost.view',
     // Consignment-level financial totals: total cost + profit (итоги по поставке).
     CONSIGNMENT_FINANCIALS_VIEW = 'consignment.financials.view',
+    PAGE_ORDER_VIEW = 'page.order.view',
+    PAGE_STOCK_VIEW = 'page.stock.view',
+    PAGE_CLIENTS_VIEW = 'page.clients.view',
+    PAGE_PAYMENTS_VIEW = 'page.payments.view',
+    PAGE_CATEGORIES_VIEW = 'page.categories.view',
+    PAGE_PRE_ORDERS_VIEW = 'page.pre_orders.view',
+    PAGE_REPORT_VIEW = 'page.report.view',
+    PAGE_STAFF_VIEW = 'page.staff.view',
 }
 
 export const PERMISSION_KEY_LIST: PermissionKeyEnum[] = [
@@ -20,4 +28,12 @@ export const PERMISSION_KEY_LIST: PermissionKeyEnum[] = [
     PermissionKeyEnum.CONSIGNMENT_DELETE,
     PermissionKeyEnum.COST_VIEW,
     PermissionKeyEnum.CONSIGNMENT_FINANCIALS_VIEW,
+    PermissionKeyEnum.PAGE_ORDER_VIEW,
+    PermissionKeyEnum.PAGE_STOCK_VIEW,
+    PermissionKeyEnum.PAGE_CLIENTS_VIEW,
+    PermissionKeyEnum.PAGE_PAYMENTS_VIEW,
+    PermissionKeyEnum.PAGE_CATEGORIES_VIEW,
+    PermissionKeyEnum.PAGE_PRE_ORDERS_VIEW,
+    PermissionKeyEnum.PAGE_REPORT_VIEW,
+    PermissionKeyEnum.PAGE_STAFF_VIEW,
 ];

package/enum/transaction-import-entity-property.enum.ts

@@ -9,4 +9,5 @@ export enum TransactionImportEntityPropertyEnum {
     TYPE = 'type',
     DATE = 'date',
     COMMENT = 'comment',
+    CASH_FLOW_ITEM = 'cashFlowItem',
 }

package/enum/transaction-import-errors.enum.ts

@@ -5,5 +5,7 @@ export enum TransactionImportErrorsEnum {
     CLIENT_AMBIGUOUS = 'CLIENT_AMBIGUOUS',
     MONEY_ACCOUNT_NOT_FOUND = 'MONEY_ACCOUNT_NOT_FOUND',
     MONEY_ACCOUNT_AMBIGUOUS = 'MONEY_ACCOUNT_AMBIGUOUS',
+    CASH_FLOW_ITEM_NOT_FOUND = 'CASH_FLOW_ITEM_NOT_FOUND',
+    CASH_FLOW_ITEM_AMBIGUOUS = 'CASH_FLOW_ITEM_AMBIGUOUS',
     CREATE_FAILED = 'CREATE_FAILED',
 }

package/package.json

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

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

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { CashFlowItemStatusEnum } from '../../enum/cash-flow-item-status.enum';
+
+export const CashFlowItemSchema = z.object({
+    uuid: z.uuid(),
+    companyUUID: z.string(),
+    name: z.string(),
+    status: z.nativeEnum(CashFlowItemStatusEnum),
+    sortOrder: z.number(),
+    createdAt: z.date(),
+    updatedAt: z.date(),
+});

package/schemas/index.ts

@@ -16,6 +16,7 @@ export * from './order-product/price-correction-analyze-item.schema';
 export * from './order-product/price-correction-execute-result-item.schema';
 export * from './transaction/transaction.schema';
 export * from './transaction/transaction-list.schema';
+export * from './cash-flow-item/cash-flow-item.schema';
 export * from './file';
 export * from './product-image/product-image.schema';
 export * from './settings/settings.schema';

package/schemas/transaction/transaction.schema.ts

@@ -17,6 +17,8 @@ export const TransactionSchema = z.object({
     type: z.nativeEnum(TransactionTypeEnum),
     createdByUserUUID: z.string(),
 
+    cashFlowItemUUID: z.string().nullable(),
+
     createdAt: z.date(),
     updatedAt: z.date(),
     deletedAt: z.date().nullable(),