@hed-hog/finance 0.0.299 → 0.0.301

package/src/finance.contract-activated.subscriber.ts

@@ -0,0 +1,780 @@
+import { PrismaService } from '@hed-hog/api-prisma';
+import {
+    IntegrationDeveloperApiService,
+    LinkType,
+} from '@hed-hog/core';
+import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
+import { FinanceService } from './finance.service';
+
+type ContractFinanceEventPayload = {
+  contractId?: number | string | null;
+  proposalId?: number | null;
+  personId?: number | null;
+  locale?: string | null;
+  correlationId?: string | null;
+  sourceEntityType?: string | null;
+  sourceEntityId?: string | null;
+  sourceEntity?: string | null;
+  sourceId?: string | null;
+  source_module?: string | null;
+  source_entity?: string | null;
+  source_id?: string | null;
+  activatedByUserId?: number | null;
+  signedByUserId?: number | null;
+  contract?: {
+    code?: string | null;
+    name?: string | null;
+    description?: string | null;
+    contractCategory?: string | null;
+    contractType?: string | null;
+    billingModel?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+    signedAt?: string | null;
+    effectiveDate?: string | null;
+    financialTerms?: Array<{
+      label?: string | null;
+      termType?: string | null;
+      amount?: number | null;
+      recurrence?: string | null;
+      dueDay?: number | null;
+      notes?: string | null;
+    }>;
+  } | null;
+  person?: {
+    id?: number | null;
+    name?: string | null;
+  } | null;
+  receivable?: {
+    personId?: number | null;
+    totalAmount?: number | null;
+    documentNumber?: string | null;
+    description?: string | null;
+    financeCategoryId?: number | null;
+    costCenterId?: number | null;
+    installments?: Array<{
+      id?: number | string | null;
+      installmentNumber?: number | null;
+      installment_number?: number | null;
+      numero?: number | null;
+      dueDate?: string | null;
+      due_date?: string | null;
+      vencimento?: string | null;
+      amount?: number | null;
+      valor?: number | null;
+    }>;
+  } | null;
+};
+
+@Injectable()
+export class FinanceContractActivatedSubscriber implements OnModuleInit {
+  private readonly logger = new Logger(FinanceContractActivatedSubscriber.name);
+
+  constructor(
+    private readonly integrationApi: IntegrationDeveloperApiService,
+    private readonly financeService: FinanceService,
+    private readonly prisma: PrismaService,
+  ) {}
+
+  onModuleInit(): void {
+    const handler = async (event: any) => {
+      const payload = (event.payload || {}) as ContractFinanceEventPayload;
+      const sourceEntityType =
+        String(
+          payload.sourceEntityType ||
+            payload.sourceEntity ||
+            payload.source_entity ||
+            event.aggregateType ||
+            '',
+        ).trim() || 'contract';
+      const sourceEntityId =
+        String(
+          payload.sourceEntityId ||
+            payload.sourceId ||
+            payload.source_id ||
+            payload.contractId ||
+            event.aggregateId ||
+            '',
+        ).trim() || String(event.aggregateId || '').trim();
+
+      if (!sourceEntityId) {
+        throw new Error(
+          `Missing contract aggregate id for ${event.eventName}.`,
+        );
+      }
+
+      const locale = String(payload.locale || '').trim() || 'en';
+      const correlationId =
+        String(payload.correlationId || `contract:${sourceEntityId}`).trim() ||
+        `contract:${sourceEntityId}`;
+      const personId = Number(
+        payload.receivable?.personId ?? payload.personId ?? payload.person?.id,
+      );
+
+      if (!Number.isInteger(personId) || personId <= 0) {
+        this.logger.warn(
+          `Skipping finance generation for ${sourceEntityType}:${sourceEntityId} because no personId was provided.`,
+        );
+        return;
+      }
+
+      const installments = this.buildInstallments(payload);
+      if (installments.length === 0) {
+        this.logger.warn(
+          `Skipping finance generation for ${sourceEntityType}:${sourceEntityId} because no installments could be derived.`,
+        );
+        return;
+      }
+
+      const totalAmount = Number(
+        installments
+          .reduce(
+            (sum, installment) => sum + Number(installment.amount || 0),
+            0,
+          )
+          .toFixed(2),
+      );
+      const titleType = this.resolveTitleType(
+        payload.contract?.contractCategory,
+        payload.contract?.contractType,
+      );
+      const documentNumber =
+        String(
+          payload.receivable?.documentNumber ||
+            payload.contract?.code ||
+            `CONTRACT-${sourceEntityId}`,
+        ).trim() || `CONTRACT-${sourceEntityId}`;
+      const description =
+        String(
+          payload.receivable?.description ||
+            payload.contract?.name ||
+            payload.contract?.description ||
+            documentNumber,
+        ).trim() || documentNumber;
+      const actorUserId =
+        Number(payload.activatedByUserId ?? payload.signedByUserId ?? 0) ||
+        undefined;
+
+      const existingLinks = await this.integrationApi.findLinksBySource({
+        module: event.sourceModule,
+        entityType: sourceEntityType,
+        entityId: sourceEntityId,
+      });
+
+      const existingTitleLink = existingLinks.find(
+        (link) =>
+          link.targetModule === 'finance' &&
+          link.targetEntityType === 'financial_title',
+      );
+
+      const createPayload = {
+        person_id: personId,
+        document_number: documentNumber,
+        due_date: installments[0].due_date,
+        total_amount: totalAmount,
+        description,
+        finance_category_id: payload.receivable?.financeCategoryId ?? undefined,
+        cost_center_id: payload.receivable?.costCenterId ?? undefined,
+        installments,
+      };
+
+      let createdTitle = existingTitleLink?.targetEntityId
+        ? await this.loadGeneratedTitleById(existingTitleLink.targetEntityId)
+        : null;
+
+      if (!createdTitle) {
+        createdTitle = await this.findRecoverableTitle({
+          personId,
+          titleType,
+          documentNumber,
+          totalAmount,
+        });
+
+        if (createdTitle) {
+          this.logger.warn(
+            `Recovered existing ${titleType} title ${createdTitle.id} for ${sourceEntityType}:${sourceEntityId} after a partial integration write.`,
+          );
+        }
+      }
+
+      if (!createdTitle) {
+        createdTitle =
+          titleType === 'payable'
+            ? await this.financeService.createAccountsPayableTitle(
+                createPayload,
+                locale,
+                actorUserId,
+              )
+            : await this.financeService.createAccountsReceivableTitle(
+                createPayload,
+                locale,
+                actorUserId,
+              );
+      }
+
+      const targetEntityId = String(createdTitle?.id || '').trim();
+      if (!targetEntityId) {
+        throw new Error('Could not resolve created financial title id.');
+      }
+
+      const createdInstallments = this.extractCreatedInstallments(createdTitle);
+
+      await this.ensureContractFinanceLinks({
+        event,
+        existingLinks,
+        sourceEntityType,
+        sourceEntityId,
+        correlationId,
+        titleType,
+        targetEntityId,
+        documentNumber,
+        totalAmount,
+        personId,
+        contractCode: payload.contract?.code ?? null,
+        createdInstallments,
+      });
+
+      this.logger.log(
+        `Generated ${titleType} title ${targetEntityId} with ${createdInstallments.length || installments.length} installments from ${event.eventName} for ${sourceEntityType}:${sourceEntityId}`,
+      );
+
+      await this.publishCreatedEvent({
+        event,
+        payload,
+        sourceEntityType,
+        sourceEntityId,
+        correlationId,
+        titleType,
+        targetEntityId,
+        documentNumber,
+        totalAmount,
+        locale,
+        createdInstallments,
+        fallbackInstallments: installments,
+      });
+    };
+
+    this.integrationApi.subscribeMany([
+      {
+        eventName: 'operations.contract.signed',
+        consumerName: 'finance.contract-signing',
+        priority: 5,
+        handler,
+      },
+      {
+        eventName: 'operations.contract.activated',
+        consumerName: 'finance.contract-activation',
+        priority: 0,
+        handler,
+      },
+    ]);
+  }
+
+  private async publishCreatedEvent(params: {
+    event: any;
+    payload: ContractFinanceEventPayload;
+    sourceEntityType: string;
+    sourceEntityId: string;
+    correlationId: string;
+    titleType: 'payable' | 'receivable';
+    targetEntityId: string;
+    documentNumber: string;
+    totalAmount: number;
+    locale: string;
+    createdInstallments: Array<{
+      id: string;
+      installment_number: number;
+      due_date: string;
+      amount: number;
+    }>;
+    fallbackInstallments: Array<{
+      installment_number: number;
+      due_date: string;
+      amount: number;
+    }>;
+  }) {
+    const {
+      event,
+      payload,
+      sourceEntityType,
+      sourceEntityId,
+      correlationId,
+      titleType,
+      targetEntityId,
+      documentNumber,
+      totalAmount,
+      locale,
+      createdInstallments,
+      fallbackInstallments,
+    } = params;
+    const successEventName =
+      titleType === 'payable'
+        ? 'finance.payable.created_from_contract'
+        : 'finance.receivable.created_from_contract';
+
+    const recentEvents = await (this.prisma as any).outbox_event.findMany({
+      where: {
+        event_name: successEventName,
+        source_module: 'finance',
+        aggregate_type: 'financial_title',
+        aggregate_id: targetEntityId,
+      },
+      select: {
+        status: true,
+        payload: true,
+      },
+      orderBy: {
+        id: 'desc',
+      },
+      take: 10,
+    });
+
+    const alreadyQueued = recentEvents.some(
+      (queuedEvent: any) =>
+        queuedEvent?.payload?.correlationId === correlationId &&
+        queuedEvent?.payload?.triggerEvent === event.eventName &&
+        !['failed', 'dead_letter'].includes(
+          String(queuedEvent?.status || ''),
+        ),
+    );
+
+    if (alreadyQueued) {
+      this.logger.debug(
+        `Skipping duplicate ${successEventName} publication for ${sourceEntityType}:${sourceEntityId}`,
+      );
+      return;
+    }
+
+    const emittedInstallments =
+      createdInstallments.length > 0
+        ? createdInstallments
+        : fallbackInstallments.map((installment) => ({
+            id: '',
+            installment_number: installment.installment_number,
+            due_date: installment.due_date,
+            amount: installment.amount,
+          }));
+
+    try {
+      await this.integrationApi.publishEvent({
+        eventName: successEventName,
+        sourceModule: 'finance',
+        aggregateType: 'financial_title',
+        aggregateId: targetEntityId,
+        payload: {
+          correlationId,
+          contractId: payload.contractId ?? sourceEntityId,
+          proposalId: payload.proposalId ?? null,
+          personId:
+            Number(
+              payload.receivable?.personId ?? payload.personId ?? payload.person?.id,
+            ) || null,
+          locale,
+          generatedAt: new Date().toISOString(),
+          triggerEvent: event.eventName,
+          sourceModule: event.sourceModule,
+          sourceEntity: sourceEntityType,
+          sourceId: sourceEntityId,
+          source_module: event.sourceModule,
+          source_entity: sourceEntityType,
+          source_id: sourceEntityId,
+          financialTitle: {
+            id: targetEntityId,
+            titleType,
+            documentNumber,
+            totalAmount,
+            installmentCount: emittedInstallments.length,
+          },
+          installments: emittedInstallments,
+          contract: {
+            code: payload.contract?.code ?? null,
+            name: payload.contract?.name ?? null,
+            contractCategory: payload.contract?.contractCategory ?? null,
+            contractType: payload.contract?.contractType ?? null,
+            billingModel: payload.contract?.billingModel ?? null,
+            startDate: payload.contract?.startDate ?? null,
+            endDate: payload.contract?.endDate ?? null,
+            signedAt: payload.contract?.signedAt ?? null,
+            effectiveDate: payload.contract?.effectiveDate ?? null,
+          },
+        },
+        metadata: {
+          producer: 'finance',
+          correlationId,
+          triggerEvent: event.eventName,
+          titleType,
+          documentNumber,
+          totalAmount,
+          installmentCount: emittedInstallments.length,
+          sourceModule: event.sourceModule,
+          sourceEntity: sourceEntityType,
+          sourceId: sourceEntityId,
+        },
+      });
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.stack || error.message : String(error);
+      this.logger.error(
+        `Failed to queue ${successEventName} for ${sourceEntityType}:${sourceEntityId}`,
+        errorMessage,
+      );
+    }
+  }
+
+  private resolveTitleType(
+    contractCategory?: string | null,
+    contractType?: string | null,
+  ): 'payable' | 'receivable' {
+    if (
+      ['employee', 'contractor', 'supplier', 'vendor', 'internal'].includes(
+        String(contractCategory || ''),
+      ) ||
+      ['clt', 'pj', 'freelancer_agreement'].includes(
+        String(contractType || ''),
+      )
+    ) {
+      return 'payable';
+    }
+
+    return 'receivable';
+  }
+
+  private buildInstallments(payload: ContractFinanceEventPayload) {
+    const explicitInstallments = Array.isArray(payload?.receivable?.installments)
+      ? payload.receivable.installments
+          .map((installment: any) => ({
+            installment_number: Number(
+              installment.installmentNumber ||
+                installment.installment_number ||
+                installment.numero ||
+                0,
+            ),
+            due_date: this.formatDate(
+              this.toDate(
+                installment.dueDate ||
+                  installment.due_date ||
+                  installment.vencimento,
+              ) || new Date(),
+            ),
+            amount: Number(
+              Number(installment.amount ?? installment.valor ?? 0).toFixed(2),
+            ),
+          }))
+          .filter(
+            (installment: any) =>
+              installment.amount > 0 && !!installment.due_date,
+          )
+      : [];
+
+    if (explicitInstallments.length > 0) {
+      return explicitInstallments.map((installment: any, index: number) => ({
+        installment_number: installment.installment_number || index + 1,
+        due_date: installment.due_date,
+        amount: installment.amount,
+      }));
+    }
+
+    const baseDate =
+      this.toDate(payload?.contract?.effectiveDate) ||
+      this.toDate(payload?.contract?.signedAt) ||
+      this.toDate(payload?.contract?.startDate) ||
+      new Date();
+    const endDate = this.toDate(payload?.contract?.endDate);
+    const financialTerms = Array.isArray(payload?.contract?.financialTerms)
+      ? payload.contract?.financialTerms || []
+      : [];
+
+    const installments: Array<{
+      installment_number: number;
+      due_date: string;
+      amount: number;
+    }> = [];
+
+    for (const term of financialTerms) {
+      const amount = Number(term?.amount || 0);
+      if (!Number.isFinite(amount) || amount <= 0) {
+        continue;
+      }
+
+      const recurrence = String(term?.recurrence || 'one_time');
+      const dueDay = Number(term?.dueDay || 0);
+      const firstDueDate = this.resolveDueDate(baseDate, dueDay);
+      const stepMonths =
+        recurrence === 'monthly'
+          ? 1
+          : recurrence === 'quarterly'
+            ? 3
+            : recurrence === 'yearly'
+              ? 12
+              : 0;
+
+      if (stepMonths === 0 || !endDate) {
+        installments.push({
+          installment_number: installments.length + 1,
+          due_date: this.formatDate(firstDueDate),
+          amount: Number(amount.toFixed(2)),
+        });
+        continue;
+      }
+
+      let cursor = new Date(firstDueDate);
+      let guard = 0;
+      while (cursor <= endDate && guard < 60) {
+        installments.push({
+          installment_number: installments.length + 1,
+          due_date: this.formatDate(cursor),
+          amount: Number(amount.toFixed(2)),
+        });
+        cursor = this.addMonths(cursor, stepMonths, dueDay);
+        guard += 1;
+      }
+    }
+
+    if (installments.length === 0) {
+      const fallbackAmount = Number(payload?.receivable?.totalAmount || 0);
+      if (Number.isFinite(fallbackAmount) && fallbackAmount > 0) {
+        installments.push({
+          installment_number: 1,
+          due_date: this.formatDate(this.resolveDueDate(baseDate, 0)),
+          amount: Number(fallbackAmount.toFixed(2)),
+        });
+      }
+    }
+
+    return installments;
+  }
+
+  private async ensureContractFinanceLinks(params: {
+    event: any;
+    existingLinks: any[];
+    sourceEntityType: string;
+    sourceEntityId: string;
+    correlationId: string;
+    titleType: 'payable' | 'receivable';
+    targetEntityId: string;
+    documentNumber: string;
+    totalAmount: number;
+    personId: number;
+    contractCode?: string | null;
+    createdInstallments: Array<{
+      id: string;
+      installment_number: number;
+      due_date: string;
+      amount: number;
+    }>;
+  }) {
+    const {
+      event,
+      existingLinks,
+      sourceEntityType,
+      sourceEntityId,
+      correlationId,
+      titleType,
+      targetEntityId,
+      documentNumber,
+      totalAmount,
+      personId,
+      contractCode,
+      createdInstallments,
+    } = params;
+    const existingKeys = new Set(
+      (existingLinks || []).map(
+        (link) =>
+          `${link.targetModule}:${link.targetEntityType}:${link.targetEntityId}`,
+      ),
+    );
+
+    const titleKey = `finance:financial_title:${targetEntityId}`;
+    if (!existingKeys.has(titleKey)) {
+      await this.integrationApi.createLink({
+        sourceModule: event.sourceModule,
+        sourceEntityType,
+        sourceEntityId,
+        targetModule: 'finance',
+        targetEntityType: 'financial_title',
+        targetEntityId,
+        linkType: LinkType.REFERENCE,
+        metadata: {
+          eventName: event.eventName,
+          correlationId,
+          titleType,
+          documentNumber,
+          totalAmount,
+          installmentCount: createdInstallments.length,
+          personId,
+          contractCode: contractCode ?? null,
+          sourceModule: event.sourceModule,
+          sourceEntity: sourceEntityType,
+          sourceId: sourceEntityId,
+          source_module: event.sourceModule,
+          source_entity: sourceEntityType,
+          source_id: sourceEntityId,
+        },
+      });
+      existingKeys.add(titleKey);
+    }
+
+    for (const installment of createdInstallments) {
+      if (!installment.id) {
+        continue;
+      }
+
+      const installmentKey = `finance:financial_installment:${installment.id}`;
+      if (existingKeys.has(installmentKey)) {
+        continue;
+      }
+
+      await this.integrationApi.createLink({
+        sourceModule: event.sourceModule,
+        sourceEntityType,
+        sourceEntityId,
+        targetModule: 'finance',
+        targetEntityType: 'financial_installment',
+        targetEntityId: installment.id,
+        linkType: LinkType.REFERENCE,
+        metadata: {
+          eventName: event.eventName,
+          correlationId,
+          titleId: targetEntityId,
+          installmentNumber: installment.installment_number,
+          dueDate: installment.due_date,
+          amount: installment.amount,
+          sourceModule: event.sourceModule,
+          sourceEntity: sourceEntityType,
+          sourceId: sourceEntityId,
+          source_module: event.sourceModule,
+          source_entity: sourceEntityType,
+          source_id: sourceEntityId,
+        },
+      });
+      existingKeys.add(installmentKey);
+    }
+  }
+
+  private async loadGeneratedTitleById(titleId: string) {
+    const normalizedId = Number(titleId || 0);
+
+    if (!Number.isInteger(normalizedId) || normalizedId <= 0) {
+      return null;
+    }
+
+    return (this.prisma as any).financial_title.findFirst({
+      where: {
+        id: normalizedId,
+      },
+      include: {
+        financial_installment: {
+          orderBy: {
+            installment_number: 'asc',
+          },
+        },
+      },
+    });
+  }
+
+  private async findRecoverableTitle(params: {
+    personId: number;
+    titleType: 'payable' | 'receivable';
+    documentNumber: string;
+    totalAmount: number;
+  }) {
+    const expectedAmountCents = Math.round(Number(params.totalAmount || 0) * 100);
+
+    if (expectedAmountCents <= 0) {
+      return null;
+    }
+
+    return (this.prisma as any).financial_title.findFirst({
+      where: {
+        person_id: params.personId,
+        title_type: params.titleType,
+        document_number: params.documentNumber,
+        total_amount_cents: expectedAmountCents,
+      },
+      orderBy: {
+        id: 'desc',
+      },
+      include: {
+        financial_installment: {
+          orderBy: {
+            installment_number: 'asc',
+          },
+        },
+      },
+    });
+  }
+
+  private extractCreatedInstallments(createdTitle: any) {
+    if (Array.isArray(createdTitle?.parcelas)) {
+      return createdTitle.parcelas
+        .map((installment: any) => ({
+          id: String(installment.id || '').trim(),
+          installment_number: Number(
+            installment.numero || installment.installment_number || 0,
+          ),
+          due_date: String(
+            installment.vencimento || installment.due_date || '',
+          ).trim(),
+          amount: Number(installment.valor ?? installment.amount ?? 0),
+        }))
+        .filter((installment) => installment.id);
+    }
+
+    return Array.isArray(createdTitle?.financial_installment)
+      ? createdTitle.financial_installment
+          .map((installment: any) => ({
+            id: String(installment.id || '').trim(),
+            installment_number: Number(installment.installment_number || 0),
+            due_date: this.formatDate(this.toDate(installment.due_date) || new Date()),
+            amount: Number(
+              (Number(installment.amount_cents || 0) / 100).toFixed(2),
+            ),
+          }))
+          .filter((installment) => installment.id)
+      : [];
+  }
+
+  private toDate(value?: string | Date | null) {
+    if (!value) {
+      return null;
+    }
+
+    if (value instanceof Date) {
+      return Number.isNaN(value.getTime()) ? null : new Date(value.getTime());
+    }
+
+    const normalized = String(value).trim();
+    const dateOnlyMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(normalized);
+
+    if (dateOnlyMatch) {
+      const [, year, month, day] = dateOnlyMatch;
+      return new Date(
+        Date.UTC(Number(year), Number(month) - 1, Number(day), 12, 0, 0),
+      );
+    }
+
+    const parsed = new Date(normalized);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+
+  private resolveDueDate(baseDate: Date, dueDay?: number) {
+    const resolved = new Date(baseDate.getTime());
+    if (Number.isInteger(dueDay) && dueDay > 0 && dueDay <= 28) {
+      resolved.setUTCDate(dueDay);
+    }
+    return resolved;
+  }
+
+  private addMonths(date: Date, months: number, dueDay?: number) {
+    const resolved = new Date(date.getTime());
+    resolved.setUTCMonth(resolved.getUTCMonth() + months);
+    if (Number.isInteger(dueDay) && dueDay > 0 && dueDay <= 28) {
+      resolved.setUTCDate(dueDay);
+    }
+    return resolved;
+  }
+
+  private formatDate(date: Date) {
+    return date.toISOString().slice(0, 10);
+  }
+}