@hed-hog/finance 0.0.350 → 0.0.351

package/src/finance.service.ts

@@ -6,6 +6,7 @@ import {
 } from '@hed-hog/api-pagination';
 import { PrismaService } from '@hed-hog/api-prisma';
 import { AiService, FileService, IntegrationDeveloperApiService, SettingService } from '@hed-hog/core';
+import { FinanceRealtimeService } from './finance-realtime.service';
 import {
   BadRequestException,
   ConflictException,
@@ -89,6 +90,7 @@ export class FinanceService {
     private readonly fileService: FileService,
     @Inject(forwardRef(() => IntegrationDeveloperApiService))
     private readonly integrationApi: IntegrationDeveloperApiService,
+    private readonly financeRealtime: FinanceRealtimeService,
   ) {}
 
   async getAgentExtractInfoFromFile(
@@ -1501,6 +1503,7 @@ export class FinanceService {
     } as any);
 
     const settings = await this.loadFinancialScenarioSettings();
+    this.financeRealtime.publish({ domain: 'installment', type: 'updated' });
     return {
       success: true,
       cenarios: settings.cenarios,
@@ -2140,6 +2143,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'collection', type: 'created', entityId: personId });
     return {
       id: String(log.id),
       success: true,
@@ -2260,6 +2264,7 @@ export class FinanceService {
       };
     });
 
+    this.financeRealtime.publish({ domain: 'collection', type: 'updated', entityId: personId });
     return {
       success: true,
       titleId: String(created.titleId),
@@ -2749,6 +2754,7 @@ export class FinanceService {
       });
     });
 
+    this.financeRealtime.publish({ domain: 'bank_reconciliation', type: 'deleted', entityId: id });
     return { success: true };
   }
 
@@ -2791,6 +2797,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'tag', type: 'created', entityId: createdTag.id });
     return {
       id: String(createdTag.id),
       nome: createdTag.slug,
@@ -3120,6 +3127,7 @@ export class FinanceService {
       payload: { id: transferResult.id, sourceAccountId, destinationAccountId, amount, date: postedDate.toISOString() },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'transfer', type: 'created' });
     return transferResult;
   }
 
@@ -3729,6 +3737,7 @@ export class FinanceService {
       return line;
     });
 
+    this.financeRealtime.publish({ domain: 'bank_statement', type: 'created' });
     return {
       id: String(created.id),
       contaBancariaId: String(created.bank_account_id),
@@ -3812,6 +3821,7 @@ export class FinanceService {
       });
     });
 
+    this.financeRealtime.publish({ domain: 'bank_statement', type: 'created', entityId: created.bank_account_id });
     return {
       id: String(created.id),
       contaBancariaId: String(created.bank_account_id),
@@ -3915,6 +3925,7 @@ export class FinanceService {
       return result;
     });
 
+    this.financeRealtime.publish({ domain: 'bank_statement', type: 'updated', entityId: id });
     return {
       id: String(updated.id),
       contaBancariaId: String(updated.bank_account_id),
@@ -3932,7 +3943,7 @@ export class FinanceService {
   }
 
   async deleteBankStatementEntry(id: number, userId?: number) {
-    return this.prisma.$transaction(async (tx) => {
+    const result = await this.prisma.$transaction(async (tx) => {
       const statementLine = await tx.bank_statement_line.findUnique({
         where: { id },
         include: {
@@ -3996,6 +4007,8 @@ export class FinanceService {
 
       return { success: true };
     });
+    this.financeRealtime.publish({ domain: 'bank_statement', type: 'deleted', entityId: id });
+    return result;
   }
 
   async importBankStatements(
@@ -4144,6 +4157,7 @@ export class FinanceService {
       return createdStatement;
     });
 
+    this.financeRealtime.publish({ domain: 'bank_statement', type: 'imported', entityId: bankAccountId });
     return {
       statementId: String(statement.id),
       fileId: String(uploadedFile.id),
@@ -4556,6 +4570,7 @@ export class FinanceService {
       payload: { id: createdAccount.id, name, bank: data.bank, accountType: this.mapAccountTypeFromPt(data.type) },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'bank_account', type: 'created', entityId: createdAccount.id });
     return mapped;
   }
 
@@ -4578,6 +4593,7 @@ export class FinanceService {
       payload: { id: created.id, code, name: data.name.trim() },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'cost_center', type: 'created', entityId: created.id });
     return this.mapCostCenterToFront(created);
   }
 
@@ -4596,6 +4612,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'category', type: 'created', entityId: created.id });
     return this.mapFinanceCategoryToFront(created);
   }
 
@@ -4647,6 +4664,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'period_close', type: 'created', entityId: created.id });
     return this.mapPeriodCloseToFront(created);
   }
 
@@ -4702,6 +4720,7 @@ export class FinanceService {
       payload: { id, name: data.description, status: data.status },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'bank_account', type: 'updated', entityId: id });
     return this.mapBankAccountToFront(updatedBankAccount);
   }
 
@@ -4731,6 +4750,7 @@ export class FinanceService {
       payload: { id, name: data.name, status: data.status },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'cost_center', type: 'updated', entityId: id });
     return this.mapCostCenterToFront(updatedCostCenter);
   }
 
@@ -4759,6 +4779,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'category', type: 'updated', entityId: id });
     return this.mapFinanceCategoryToFront(updated);
   }
 
@@ -4808,6 +4829,7 @@ export class FinanceService {
       ),
     );
 
+    this.financeRealtime.publish({ domain: 'category', type: 'moved', entityId: id });
     return { success: true };
   }
 
@@ -4834,6 +4856,7 @@ export class FinanceService {
       payload: { id },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'bank_account', type: 'deleted', entityId: id });
     return { success: true };
   }
 
@@ -4860,6 +4883,7 @@ export class FinanceService {
       payload: { id },
     }).catch(() => null);
 
+    this.financeRealtime.publish({ domain: 'cost_center', type: 'deleted', entityId: id });
     return { success: true };
   }
 
@@ -4899,6 +4923,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'currency', type: 'created', entityId: created.id });
     return {
       id: String(created.id),
       code: created.code,
@@ -4929,6 +4954,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'currency', type: 'updated', entityId: id });
     return {
       id: String(updated.id),
       code: updated.code,
@@ -4954,6 +4980,7 @@ export class FinanceService {
       data: { status: 'inactive' },
     });
 
+    this.financeRealtime.publish({ domain: 'currency', type: 'deleted', entityId: id });
     return { success: true };
   }
 
@@ -4974,6 +5001,7 @@ export class FinanceService {
       },
     });
 
+    this.financeRealtime.publish({ domain: 'category', type: 'deleted', entityId: id });
     return { success: true };
   }
 
@@ -5078,7 +5106,23 @@ export class FinanceService {
     locale: string,
     userId?: number,
   ) {
-    const installments = this.normalizeAndValidateInstallments(data, locale);
+    const rule = data.recurrence_rule;
+    if (rule && !rule.end_date && !rule.max_occurrences) {
+      throw new BadRequestException(
+        getLocaleText('recurrenceEndOrCountRequired', locale, 'Provide end_date or max_occurrences for recurring titles'),
+      );
+    }
+
+    const isRecurring = Boolean(rule);
+    const installments = isRecurring
+      ? this.buildRecurrenceInstallments(
+          data.due_date,
+          rule!.frequency,
+          this.toCents(data.total_amount),
+          rule!.end_date,
+          rule!.max_occurrences,
+        )
+      : this.normalizeAndValidateInstallments(data, locale);
 
     const createdTitleId = await this.prisma.$transaction(async (tx) => {
       const person = await tx.person.findUnique({
@@ -5152,6 +5196,10 @@ export class FinanceService {
         'create title',
       );
 
+      const totalAmountCents = isRecurring
+        ? this.toCents(data.total_amount) * installments.length
+        : this.toCents(data.total_amount);
+
       const title = await tx.financial_title.create({
         data: {
           person_id: data.person_id,
@@ -5163,7 +5211,10 @@ export class FinanceService {
             ? this.parseLocalDate(data.competence_date)
             : null,
           issue_date: data.issue_date ? this.parseLocalDate(data.issue_date) : null,
-          total_amount_cents: this.toCents(data.total_amount),
+          total_amount_cents: totalAmountCents,
+          is_recurring: isRecurring,
+          recurrence_frequency: rule?.frequency ?? null,
+          recurrence_end_date: rule?.end_date ? this.parseLocalDate(rule.end_date) : null,
           finance_category_id: data.finance_category_id,
           created_by_user_id: userId,
         },
@@ -5229,6 +5280,7 @@ export class FinanceService {
     });
 
     const createdTitle = await this.getTitleById(createdTitleId, titleType, locale);
+    this.financeRealtime.publish({ domain: 'installment', type: 'created', entityId: createdTitleId });
     return this.mapTitleToFront(createdTitle, data.payment_channel);
   }
 
@@ -5239,7 +5291,23 @@ export class FinanceService {
     locale: string,
     userId?: number,
   ) {
-    const installments = this.normalizeAndValidateInstallments(data, locale);
+    const rule = data.recurrence_rule;
+    if (rule && !rule.end_date && !rule.max_occurrences) {
+      throw new BadRequestException(
+        getLocaleText('recurrenceEndOrCountRequired', locale, 'Provide end_date or max_occurrences for recurring titles'),
+      );
+    }
+
+    const isRecurring = Boolean(rule);
+    const installments = isRecurring
+      ? this.buildRecurrenceInstallments(
+          data.due_date,
+          rule!.frequency,
+          this.toCents(data.total_amount),
+          rule!.end_date,
+          rule!.max_occurrences,
+        )
+      : this.normalizeAndValidateInstallments(data, locale);
 
     const updatedTitle = await this.prisma.$transaction(async (tx) => {
       const title = await tx.financial_title.findFirst({
@@ -5362,6 +5430,10 @@ export class FinanceService {
         }
       }
 
+      const totalAmountCents = isRecurring
+        ? this.toCents(data.total_amount) * installments.length
+        : this.toCents(data.total_amount);
+
       await tx.financial_title.update({
         where: { id: title.id },
         data: {
@@ -5372,7 +5444,10 @@ export class FinanceService {
             ? this.parseLocalDate(data.competence_date)
             : null,
           issue_date: data.issue_date ? this.parseLocalDate(data.issue_date) : null,
-          total_amount_cents: this.toCents(data.total_amount),
+          total_amount_cents: totalAmountCents,
+          is_recurring: isRecurring,
+          recurrence_frequency: rule?.frequency ?? null,
+          recurrence_end_date: rule?.end_date ? this.parseLocalDate(rule.end_date) : null,
           finance_category_id: data.finance_category_id,
         },
       });
@@ -5478,9 +5553,49 @@ export class FinanceService {
       throw new NotFoundException('Financial title not found');
     }
 
+    this.financeRealtime.publish({ domain: 'installment', type: 'updated', entityId: titleId });
     return this.mapTitleToFront(updatedTitle, data.payment_channel);
   }
 
+  private buildRecurrenceInstallments(
+    startDate: string,
+    frequency: string,
+    amountCents: number,
+    endDate?: string,
+    maxOccurrences?: number,
+  ) {
+    const advance = (date: Date, freq: string): Date => {
+      const next = new Date(date);
+      switch (freq) {
+        case 'weekly':      next.setDate(next.getDate() + 7); break;
+        case 'biweekly':    next.setDate(next.getDate() + 14); break;
+        case 'bimonthly':   next.setMonth(next.getMonth() + 2); break;
+        case 'quarterly':   next.setMonth(next.getMonth() + 3); break;
+        case 'semiannual':  next.setMonth(next.getMonth() + 6); break;
+        case 'annual':      next.setFullYear(next.getFullYear() + 1); break;
+        default:            next.setMonth(next.getMonth() + 1); // monthly
+      }
+      return next;
+    };
+
+    const limit = maxOccurrences ?? 600;
+    const endDateObj = endDate ? this.parseLocalDate(endDate) : null;
+    const installments: { installment_number: number; due_date: string; amount_cents: number }[] = [];
+    let current = this.parseLocalDate(startDate);
+
+    while (installments.length < limit) {
+      if (endDateObj && current > endDateObj) break;
+      installments.push({
+        installment_number: installments.length + 1,
+        due_date: current.toISOString().slice(0, 10),
+        amount_cents: amountCents,
+      });
+      current = advance(current, frequency);
+    }
+
+    return installments;
+  }
+
   private normalizeAndValidateInstallments(
     data: CreateFinancialTitleDto,
     locale: string,
@@ -5619,6 +5734,7 @@ export class FinanceService {
       throw new NotFoundException('Financial title not found');
     }
 
+    this.financeRealtime.publish({ domain: 'installment', type: 'approved', entityId: titleId });
     return this.mapTitleToFront(updatedTitle);
   }
 
@@ -5695,6 +5811,7 @@ export class FinanceService {
       throw new NotFoundException('Financial title not found');
     }
 
+    this.financeRealtime.publish({ domain: 'installment', type: 'rejected', entityId: titleId });
     return this.mapTitleToFront(updatedTitle);
   }
 
@@ -5804,6 +5921,7 @@ export class FinanceService {
       throw new NotFoundException('Financial title not found');
     }
 
+    this.financeRealtime.publish({ domain: 'installment', type: 'canceled', entityId: titleId });
     return this.mapTitleToFront(updatedTitle);
   }
 
@@ -6107,6 +6225,7 @@ export class FinanceService {
         };
       });
 
+      this.financeRealtime.publish({ domain: 'settlement', type: 'settled', entityId: result.settlementId });
       return {
         ...this.mapTitleToFront(result.title),
         settlementId: String(result.settlementId),
@@ -6428,6 +6547,7 @@ export class FinanceService {
       };
     });
 
+    this.financeRealtime.publish({ domain: 'settlement', type: 'reversed', entityId: settlementId });
     return title;
   }
 
@@ -6517,6 +6637,7 @@ export class FinanceService {
     });
 
     const updatedTitle = await this.getTitleById(titleId, titleType, locale);
+    this.financeRealtime.publish({ domain: 'tag', type: 'updated', entityId: titleId });
     return this.mapTitleToFront(updatedTitle);
   }
 
@@ -6868,54 +6989,67 @@ export class FinanceService {
     const tags = [
       ...new Set(
         title.financial_installment
-          .flatMap((installment) => installment.financial_installment_tag)
-          .map((tagRelation) => String(tagRelation.tag_id)),
+          .map((installment) => installment.financial_installment_tag?.tag_id)
+          .filter((tagId) => typeof tagId === 'number')
+          .map((tagId) => String(tagId)),
       ),
     ];
 
-    const channelFromSettlement = title.financial_installment
-      .flatMap((installment) => installment.settlement_allocation)
+    const settlementAllocations = title.financial_installment.flatMap(
+      (installment) =>
+        installment.settlement_allocation
+          ? [installment.settlement_allocation]
+          : [],
+    );
+
+    const channelFromSettlement = settlementAllocations
       .map((allocation) => allocation.settlement?.payment_method?.type)
       .find(Boolean);
 
-    const mappedInstallments = title.financial_installment.map((installment) => ({
-      id: String(installment.id),
-      numero: installment.installment_number,
-      vencimento: installment.due_date.toISOString(),
-      valor: this.fromCents(installment.amount_cents),
-      valorAberto: this.fromCents(installment.open_amount_cents),
-      status: this.mapStatusToPt(
-        this.resolveInstallmentStatus(
-          installment.amount_cents,
-          installment.open_amount_cents,
-          installment.due_date,
-          installment.status,
+    const mappedInstallments = title.financial_installment.map((installment) => {
+      const installmentSettlementAllocations = installment.settlement_allocation
+        ? [installment.settlement_allocation]
+        : [];
+
+      return {
+        id: String(installment.id),
+        numero: installment.installment_number,
+        vencimento: installment.due_date.toISOString(),
+        valor: this.fromCents(installment.amount_cents),
+        valorAberto: this.fromCents(installment.open_amount_cents),
+        status: this.mapStatusToPt(
+          this.resolveInstallmentStatus(
+            installment.amount_cents,
+            installment.open_amount_cents,
+            installment.due_date,
+            installment.status,
+          ),
         ),
-      ),
-      metodoPagamento:
-        this.mapPaymentMethodToPt(
-          installment.settlement_allocation[0]?.settlement?.payment_method?.type,
-        ) || paymentChannelOverride || 'transferencia',
-      liquidacoes: installment.settlement_allocation.map((allocation) => ({
-        id: String(allocation.id),
-        settlementId: allocation.settlement?.id
-          ? String(allocation.settlement.id)
-          : null,
-        data: allocation.settlement?.settled_at?.toISOString(),
-        valor: this.fromCents(allocation.allocated_amount_cents),
-        juros: this.fromCents(allocation.interest_cents || 0),
-        desconto: this.fromCents(allocation.discount_cents || 0),
-        multa: this.fromCents(allocation.penalty_cents || 0),
-        contaBancariaId: allocation.settlement?.bank_account_id
-          ? String(allocation.settlement.bank_account_id)
-          : null,
-        status: allocation.settlement?.status || null,
-        metodo:
+        metodoPagamento:
           this.mapPaymentMethodToPt(
-            allocation.settlement?.payment_method?.type,
-          ) || 'transferencia',
-      })),
-    }));
+            installmentSettlementAllocations[0]?.settlement?.payment_method?.type,
+          ) || paymentChannelOverride || 'transferencia',
+        liquidacoes: installmentSettlementAllocations.map((allocation) => ({
+          id: String(allocation.id),
+          settlementId: allocation.settlement?.id
+            ? String(allocation.settlement.id)
+            : null,
+          data: allocation.settlement?.settled_at?.toISOString(),
+          valor: this.fromCents(allocation.allocated_amount_cents),
+          juros: this.fromCents(allocation.interest_cents || 0),
+          desconto: this.fromCents(allocation.discount_cents || 0),
+          multa: this.fromCents(allocation.penalty_cents || 0),
+          contaBancariaId: allocation.settlement?.bank_account_id
+            ? String(allocation.settlement.bank_account_id)
+            : null,
+          status: allocation.settlement?.status || null,
+          metodo:
+            this.mapPaymentMethodToPt(
+              allocation.settlement?.payment_method?.type,
+            ) || 'transferencia',
+        })),
+      };
+    });
 
     const attachmentDetails = title.financial_title_attachment.map((attachment) => ({
       id: String(attachment.file_id),
@@ -6942,6 +7076,11 @@ export class FinanceService {
         this.mapPaymentMethodToPt(channelFromSettlement) ||
         paymentChannelOverride ||
         'transferencia',
+      isRecurring: title.is_recurring ?? false,
+      recurrenceFrequency: title.recurrence_frequency ?? null,
+      recurrenceEndDate: title.recurrence_end_date
+        ? title.recurrence_end_date.toISOString().slice(0, 10)
+        : null,
       ...(title.title_type === 'payable'
         ? {
             fornecedorId: String(title.person_id),

package/src/mcp-tools/finance-audit-logs.mcp-tools.ts

@@ -0,0 +1,38 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { FinanceService } from '../finance.service';
+
+@Injectable()
+export class FinanceAuditLogsMcpTools {
+  constructor(private readonly financeService: FinanceService) {}
+
+  @McpTool({
+    name: 'finance.audit-logs.list',
+    description: 'Lists finance audit logs with filters and pagination.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        action: { type: 'string', description: 'Action filter' },
+        entity_table: { type: 'string', description: 'Entity table filter' },
+        actor_user_id: { type: 'string', description: 'Actor user id filter' },
+        from: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+        to: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+      },
+    },
+    readOnly: true,
+  })
+  async list(args: Record<string, any>, _context: McpContext): Promise<any> {
+    const { page, pageSize, search, action, entity_table, actor_user_id, from, to } = args;
+    return this.financeService.listAuditLogs({ page, pageSize } as any, {
+      search,
+      action,
+      entity_table,
+      actor_user_id,
+      from,
+      to,
+    });
+  }
+}

package/src/mcp-tools/finance-bank-accounts.mcp-tools.ts

@@ -0,0 +1,76 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { FinanceService } from '../finance.service';
+
+@Injectable()
+export class FinanceBankAccountsMcpTools {
+  constructor(private readonly financeService: FinanceService) {}
+
+  @McpTool({
+    name: 'finance.bank-accounts.list',
+    description: 'Lists bank accounts with pagination.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+    },
+    readOnly: true,
+  })
+  async list(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.financeService.listBankAccounts(args as any);
+  }
+
+  @McpTool({
+    name: 'finance.bank-accounts.create',
+    description: 'Creates a bank account.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank: { type: 'string', description: 'Bank name' },
+        type: { type: 'string', description: 'Account type' },
+        currency_id: { type: 'number', description: 'Currency ID' },
+        opening_balance: { type: 'number', description: 'Opening balance' },
+      },
+      required: ['bank', 'type'],
+    },
+  })
+  async create(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.financeService.createBankAccount(args as any, context.userId);
+  }
+
+  @McpTool({
+    name: 'finance.bank-accounts.update',
+    description: 'Updates an existing bank account.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Bank account ID' },
+        bank: { type: 'string', description: 'Bank name' },
+        type: { type: 'string', description: 'Account type' },
+        currency_id: { type: 'number', description: 'Currency ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async update(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.financeService.updateBankAccount(id, data as any);
+  }
+
+  @McpTool({
+    name: 'finance.bank-accounts.delete',
+    description: 'Deletes a bank account.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Bank account ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async delete(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.financeService.deleteBankAccount(args.id);
+  }
+}