@hed-hog/finance 0.0.322 → 0.0.326

package/hedhog/data/integration_event_catalog.yaml

@@ -0,0 +1,274 @@
+- slug: finance.payable.created_from_contract
+  name: Finance payable created from contract
+  module: finance
+  aggregate_type: financial_title
+  description: Disparado quando um título de contas a pagar é criado a partir de um contrato ativado.
+  status: active
+  payload_schema:
+    correlationId:
+      type: string
+      description: ID de correlação para rastreamento entre eventos
+    contractId:
+      type: number
+      description: ID do contrato de origem
+    proposalId:
+      type: number
+      nullable: true
+      description: ID da proposta de origem (quando aplicável)
+    personId:
+      type: number
+      description: ID da pessoa (fornecedor/credor)
+    financialTitle:
+      type: object
+      description: Dados do título financeiro criado
+    installments:
+      type: array
+      description: Lista de parcelas geradas
+    contract:
+      type: object
+      description: Dados do contrato de origem
+  metadata_schema: null
+
+- slug: finance.receivable.created_from_contract
+  name: Finance receivable created from contract
+  module: finance
+  aggregate_type: financial_title
+  description: Disparado quando um título de contas a receber é criado a partir de um contrato ativado.
+  status: active
+  payload_schema:
+    correlationId:
+      type: string
+      description: ID de correlação para rastreamento entre eventos
+    contractId:
+      type: number
+      description: ID do contrato de origem
+    proposalId:
+      type: number
+      nullable: true
+      description: ID da proposta de origem (quando aplicável)
+    personId:
+      type: number
+      description: ID da pessoa (cliente/devedor)
+    financialTitle:
+      type: object
+      description: Dados do título financeiro criado
+    installments:
+      type: array
+      description: Lista de parcelas geradas
+    contract:
+      type: object
+      description: Dados do contrato de origem
+  metadata_schema: null
+
+- slug: finance.payable.created
+  name: Finance payable created
+  module: finance
+  aggregate_type: financial_title
+  description: Disparado quando um título a pagar é criado manualmente.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do título a pagar criado
+    personId:
+      type: number
+      description: ID da pessoa (fornecedor/credor)
+    totalAmount:
+      type: number
+      description: Valor total do título
+    dueDate:
+      type: string
+      format: date-time
+      description: Data de vencimento
+    status:
+      type: string
+      description: Status do título
+  metadata_schema: null
+
+- slug: finance.payable.updated
+  name: Finance payable updated
+  module: finance
+  aggregate_type: financial_title
+  description: Disparado quando um título a pagar é atualizado.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do título atualizado
+    status:
+      type: string
+      nullable: true
+      description: Novo status do título
+    totalAmount:
+      type: number
+      nullable: true
+      description: Novo valor total
+  metadata_schema: null
+
+- slug: finance.receivable.created
+  name: Finance receivable created
+  module: finance
+  aggregate_type: financial_title
+  description: Disparado quando um título a receber é criado manualmente.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do título a receber criado
+    personId:
+      type: number
+      description: ID da pessoa (cliente/devedor)
+    totalAmount:
+      type: number
+      description: Valor total do título
+    dueDate:
+      type: string
+      format: date-time
+      description: Data de vencimento
+    status:
+      type: string
+      description: Status do título
+  metadata_schema: null
+
+- slug: finance.receivable.updated
+  name: Finance receivable updated
+  module: finance
+  aggregate_type: financial_title
+  description: Disparado quando um título a receber é atualizado.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do título atualizado
+    status:
+      type: string
+      nullable: true
+      description: Novo status do título
+    totalAmount:
+      type: number
+      nullable: true
+      description: Novo valor total
+  metadata_schema: null
+
+- slug: finance.bank_account.created
+  name: Finance bank account created
+  module: finance
+  aggregate_type: bank_account
+  description: Disparado quando uma conta bancária é criada.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID da conta bancária criada
+    name:
+      type: string
+      description: Nome da conta bancária
+    bankCode:
+      type: string
+      nullable: true
+      description: Código do banco
+    accountNumber:
+      type: string
+      nullable: true
+      description: Número da conta
+  metadata_schema: null
+
+- slug: finance.bank_account.updated
+  name: Finance bank account updated
+  module: finance
+  aggregate_type: bank_account
+  description: Disparado quando uma conta bancária é atualizada.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID da conta bancária atualizada
+    name:
+      type: string
+      nullable: true
+      description: Novo nome da conta
+  metadata_schema: null
+
+- slug: finance.bank_account.deleted
+  name: Finance bank account deleted
+  module: finance
+  aggregate_type: bank_account
+  description: Disparado quando uma conta bancária é excluída.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID da conta bancária excluída
+  metadata_schema: null
+
+- slug: finance.cost_center.created
+  name: Finance cost center created
+  module: finance
+  aggregate_type: cost_center
+  description: Disparado quando um centro de custo é criado.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do centro de custo criado
+    name:
+      type: string
+      description: Nome do centro de custo
+    code:
+      type: string
+      nullable: true
+      description: Código do centro de custo
+  metadata_schema: null
+
+- slug: finance.cost_center.updated
+  name: Finance cost center updated
+  module: finance
+  aggregate_type: cost_center
+  description: Disparado quando um centro de custo é atualizado.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do centro de custo atualizado
+    name:
+      type: string
+      nullable: true
+      description: Novo nome do centro de custo
+  metadata_schema: null
+
+- slug: finance.cost_center.deleted
+  name: Finance cost center deleted
+  module: finance
+  aggregate_type: cost_center
+  description: Disparado quando um centro de custo é excluído.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID do centro de custo excluído
+  metadata_schema: null
+
+- slug: finance.transfer.created
+  name: Finance transfer created
+  module: finance
+  aggregate_type: transfer
+  description: Disparado quando uma transferência entre contas é registrada.
+  status: active
+  payload_schema:
+    id:
+      type: number
+      description: ID da transferência criada
+    fromAccountId:
+      type: number
+      description: ID da conta de origem
+    toAccountId:
+      type: number
+      description: ID da conta de destino
+    amount:
+      type: number
+      description: Valor transferido
+    transferDate:
+      type: string
+      format: date-time
+      description: Data da transferência
+  metadata_schema: null

package/hedhog/frontend/app/administration/categories/page.tsx.ejs

@@ -300,7 +300,7 @@ function CategoriaSheet({
 
   return (
     <Sheet open={open} onOpenChange={handleOpenChange}>
-      <SheetContent className="w-full sm:max-w-lg">
+      <SheetContent className="w-full overflow-y-auto sm:max-w-lg">
         <SheetHeader>
           <SheetTitle>
             {editing ? t('sheet.editTitle') : t('sheet.newTitle')}

package/hedhog/frontend/app/administration/cost-centers/page.tsx.ejs

@@ -216,7 +216,7 @@ function CentroCustoSheet({
 
   return (
     <Sheet open={open} onOpenChange={handleOpenChange}>
-      <SheetContent className="w-full sm:max-w-lg">
+      <SheetContent className="w-full overflow-y-auto sm:max-w-lg">
         <SheetHeader>
           <SheetTitle>
             {editingCostCenter ? t('sheet.editTitle') : t('sheet.newTitle')}

package/hedhog/frontend/app/administration/currencies/page.tsx.ejs

@@ -225,7 +225,7 @@ function CurrencySheet({
 
   return (
     <Sheet open={open} onOpenChange={handleOpenChange}>
-      <SheetContent className="w-full sm:max-w-lg">
+      <SheetContent className="w-full overflow-y-auto sm:max-w-lg">
         <SheetHeader>
           <SheetTitle>
             {editingCurrency ? t('sheet.editTitle') : t('sheet.newTitle')}

package/hedhog/frontend/app/administration/period-close/page.tsx.ejs

@@ -212,7 +212,7 @@ function ClosePeriodSheet({
         onOpenChange(nextOpen);
       }}
     >
-      <SheetContent className="w-full sm:max-w-lg">
+      <SheetContent className="w-full overflow-y-auto sm:max-w-lg">
         <SheetHeader>
           <SheetTitle>{t('sheet.title')}</SheetTitle>
           <SheetDescription>{t('sheet.description')}</SheetDescription>

package/hedhog/frontend/app/cash-and-banks/bank-accounts/page.tsx.ejs

@@ -37,7 +37,6 @@ import {
 import { Input } from '@/components/ui/input';
 import { InputMoney } from '@/components/ui/input-money';
 import { KpiCardsGrid } from '@/components/ui/kpi-cards-grid';
-import { Money } from '@/components/ui/money';
 import {
   Select,
   SelectContent,
@@ -105,6 +104,13 @@ type Currency = {
   ativo: boolean;
 };
 
+type BankAccountCurrency = {
+  id: string;
+  code: string;
+  symbol: string;
+  name: string;
+};
+
 type BankAccount = {
   id: string;
   codigo: string;
@@ -115,7 +121,7 @@ type BankAccount = {
   tipo: 'corrente' | 'poupanca' | 'investimento' | 'caixa';
   logoFileId: number | null;
   currencyId: number | null;
-  currency: Currency | null;
+  currency: BankAccountCurrency | null;
   saldoAtual: number;
   saldoConciliado: number;
   ativo: boolean;
@@ -147,6 +153,14 @@ type BankAccountDraftPayload = {
 
 const BANK_ACCOUNT_FORM_DRAFT_STORAGE_KEY = 'finance-bank-account-form-draft';
 
+function formatCurrency(value: number, currencyCode: string, locale: string) {
+  const localeTag = locale.startsWith('pt') ? 'pt-BR' : 'en-US';
+  return new Intl.NumberFormat(localeTag, {
+    style: 'currency',
+    currency: currencyCode,
+  }).format(value);
+}
+
 function BankAccountLogo({
   account,
   icon: Icon,
@@ -1049,40 +1063,52 @@ export default function ContasBancariasPage() {
     caixa: { label: t('types.caixa'), icon: Wallet },
   };
 
-  const saldoTotal = accounts
-    .filter((c) => c.ativo)
-    .reduce((acc, c) => acc + c.saldoAtual, 0);
-
-  const saldoConciliadoTotal = accounts
-    .filter((c) => c.ativo)
-    .reduce((acc, c) => acc + c.saldoConciliado, 0);
   const activeAccountsCount = accounts.filter((c) => c.ativo).length;
   const inactiveAccountsCount = accounts.length - activeAccountsCount;
-  const summaryCards = [
-    {
-      key: 'balance',
-      title: t('cards.totalBalance'),
-      value: <Money value={saldoTotal} />,
-      description: t('cards.activeAccounts', {
-        count: activeAccountsCount,
-      }),
-      icon: Landmark,
-      layout: 'compact' as const,
-    },
-    {
-      key: 'reconciled',
-      title: t('cards.reconciledBalance'),
-      value: <Money value={saldoConciliadoTotal} />,
-      description: `${t('cards.difference')}: ${new Intl.NumberFormat(
-        currentLocaleCode === 'pt' ? 'pt-BR' : 'en-US',
+
+  // Group active account balances by currency (accounts without currency default to BRL)
+  const balanceByCurrency = accounts
+    .filter((c) => c.ativo)
+    .reduce<
+      Record<
+        string,
         {
-          style: 'currency',
-          currency: 'BRL',
+          total: number;
+          reconciled: number;
+          symbol: string;
+          code: string;
+          name: string;
+          count: number;
         }
-      ).format(saldoTotal - saldoConciliadoTotal)}`,
-      icon: RefreshCw,
+      >
+    >((acc, c) => {
+      const code = c.currency?.code ?? 'BRL';
+      const symbol = c.currency?.symbol ?? 'R$';
+      const name = c.currency?.name ?? 'Real Brasileiro';
+      if (!acc[code]) {
+        acc[code] = { total: 0, reconciled: 0, symbol, code, name, count: 0 };
+      }
+      acc[code].total += c.saldoAtual;
+      acc[code].reconciled += c.saldoConciliado;
+      acc[code].count += 1;
+      return acc;
+    }, {});
+
+  const currencyGroups = Object.values(balanceByCurrency);
+
+  const summaryCards = [
+    ...currencyGroups.map((g) => ({
+      key: `balance-${g.code}`,
+      title: `${t('cards.totalBalance')} (${g.code})`,
+      value: (
+        <span className="tabular-nums">
+          {formatCurrency(g.total, g.code, currentLocaleCode)}
+        </span>
+      ),
+      description: `${t('cards.reconciledBalance')}: ${formatCurrency(g.reconciled, g.code, currentLocaleCode)}`,
+      icon: Landmark,
       layout: 'compact' as const,
-    },
+    })),
     {
       key: 'accounts',
       title: t('cards.accountsOverview'),
@@ -1175,7 +1201,10 @@ export default function ContasBancariasPage() {
         </AlertDialogContent>
       </AlertDialog>
 
-      <KpiCardsGrid items={summaryCards} columns={3} />
+      <KpiCardsGrid
+        items={summaryCards}
+        columns={Math.min(summaryCards.length, 4) as 2 | 3 | 4}
+      />
 
       <FinancePageSection variant="flat" contentClassName="p-0">
         {accounts.length > 0 ? (
@@ -1236,15 +1265,25 @@ export default function ContasBancariasPage() {
                         <p className="text-sm text-muted-foreground">
                           {t('accountCard.currentBalance')}
                         </p>
-                        <p className="text-2xl font-bold">
-                          <Money value={conta.saldoAtual} />
+                        <p className="text-2xl font-bold tabular-nums">
+                          {formatCurrency(
+                            conta.saldoAtual,
+                            conta.currency?.code ?? 'BRL',
+                            currentLocaleCode
+                          )}
                         </p>
                       </div>
                       <div className="flex items-center justify-between text-sm">
                         <span className="text-muted-foreground">
                           {t('accountCard.reconciledBalance')}
                         </span>
-                        <Money value={conta.saldoConciliado} />
+                        <span className="tabular-nums">
+                          {formatCurrency(
+                            conta.saldoConciliado,
+                            conta.currency?.code ?? 'BRL',
+                            currentLocaleCode
+                          )}
+                        </span>
                       </div>
                       {diferenca !== 0 ? (
                         <div className="flex items-center justify-between text-sm">
@@ -1253,10 +1292,17 @@ export default function ContasBancariasPage() {
                           </span>
                           <span
                             className={
-                              diferenca > 0 ? 'text-green-600' : 'text-red-600'
+                              diferenca > 0
+                                ? 'tabular-nums text-green-600'
+                                : 'tabular-nums text-red-600'
                             }
                           >
-                            <Money value={diferenca} showSign />
+                            {diferenca > 0 ? '+' : '-'}
+                            {formatCurrency(
+                              Math.abs(diferenca),
+                              conta.currency?.code ?? 'BRL',
+                              currentLocaleCode
+                            )}
                           </span>
                         </div>
                       ) : null}

package/hedhog/frontend/widgets/bank-reconciliation-status.tsx.ejs

@@ -30,6 +30,7 @@ interface FinanceData {
     saldoAtual?: number | null;
     saldoConciliado?: number | null;
     ativo?: boolean | null;
+    currency?: { code: string; symbol: string } | null;
   }>;
 }
 
@@ -68,13 +69,22 @@ export default function BankReconciliationStatus({
       difference: Math.abs(
         Number(account.saldoAtual || 0) - Number(account.saldoConciliado || 0)
       ),
+      currencyCode: account.currency?.code ?? 'BRL',
+      currencySymbol: account.currency?.symbol ?? 'R$',
     }))
     .sort((a, b) => b.difference - a.difference);
 
-  const totalDifference = accountDiffs.reduce(
-    (acc, account) => acc + account.difference,
-    0
-  );
+  // Group differences by currency — never mix different currencies in a single total
+  const differencesByCurrency = accountDiffs.reduce<
+    Record<string, { total: number; symbol: string }>
+  >((acc, account) => {
+    const code = account.currencyCode;
+    if (!acc[code]) {
+      acc[code] = { total: 0, symbol: account.currencySymbol };
+    }
+    acc[code].total += account.difference;
+    return acc;
+  }, {});
 
   return (
     <WidgetWrapper
@@ -109,9 +119,20 @@ export default function BankReconciliationStatus({
             <p className="text-[11px] font-medium uppercase tracking-[0.18em] text-muted-foreground">
               {t('bankReconciliation.difference')}
             </p>
-            <p className="text-lg font-semibold text-foreground">
-              <Money value={totalDifference} />
-            </p>
+            {Object.entries(differencesByCurrency).length > 0 ? (
+              Object.entries(differencesByCurrency).map(([code, entry]) => (
+                <p key={code} className="text-lg font-semibold text-foreground tabular-nums">
+                  {new Intl.NumberFormat('pt-BR', {
+                    style: 'currency',
+                    currency: code,
+                  }).format(entry.total)}
+                </p>
+              ))
+            ) : (
+              <p className="text-lg font-semibold text-foreground tabular-nums">
+                <Money value={0} />
+              </p>
+            )}
           </div>
 
           <div className="space-y-2">
@@ -123,8 +144,11 @@ export default function BankReconciliationStatus({
                 <span className="truncate pr-3 text-sm text-foreground">
                   {account.name}
                 </span>
-                <span className="text-sm font-medium text-muted-foreground">
-                  <Money value={account.difference} />
+                <span className="text-sm font-medium text-muted-foreground tabular-nums">
+                  {new Intl.NumberFormat('pt-BR', {
+                    style: 'currency',
+                    currency: account.currencyCode,
+                  }).format(account.difference)}
                 </span>
               </div>
             ))}

package/hedhog/frontend/widgets/cash-balance-kpi.tsx.ejs

@@ -14,6 +14,10 @@ interface CashBalanceKpiProps {
 interface FinanceData {
   kpis?: {
     saldoCaixa: number;
+    saldoCaixaPorMoeda?: Record<
+      string,
+      { total: number; reconciled: number; symbol: string; name: string }
+    >;
   };
 }
 
@@ -29,11 +33,11 @@ export default function CashBalanceKpi({
       queryKey: 'finance-kpi-cash-balance',
     });
 
-  const value = data?.kpis?.saldoCaixa ?? 0;
-  const formatted = new Intl.NumberFormat('pt-BR', {
-    style: 'currency',
-    currency: 'BRL',
-  }).format(value);
+  const saldoCaixaPorMoeda = data?.kpis?.saldoCaixaPorMoeda ?? {};
+  const currencyEntries = Object.entries(saldoCaixaPorMoeda);
+  // Fallback to the legacy single-value when the new field is absent
+  const legacyValue = data?.kpis?.saldoCaixa ?? 0;
+  const hasCurrencyBreakdown = currencyEntries.length > 0;
 
   return (
     <WidgetWrapper
@@ -48,13 +52,30 @@ export default function CashBalanceKpi({
           <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg bg-emerald-100/80">
             <Wallet className="h-4.5 w-4.5 text-emerald-600" />
           </div>
-          <div className="flex min-w-0 flex-1 flex-col justify-center">
+          <div className="flex min-w-0 flex-1 flex-col justify-center gap-0.5">
             <span className="text-[9px] font-semibold uppercase tracking-[0.18em] text-muted-foreground">
               {t('kpis.cashBalance.title')}
             </span>
-            <span className="truncate text-base font-bold leading-none tracking-tight text-foreground sm:text-lg">
-              {formatted}
-            </span>
+            {hasCurrencyBreakdown ? (
+              currencyEntries.map(([code, entry]) => (
+                <span
+                  key={code}
+                  className="truncate text-base font-bold leading-none tracking-tight text-foreground sm:text-lg"
+                >
+                  {new Intl.NumberFormat('pt-BR', {
+                    style: 'currency',
+                    currency: code,
+                  }).format(entry.total)}
+                </span>
+              ))
+            ) : (
+              <span className="truncate text-base font-bold leading-none tracking-tight text-foreground sm:text-lg">
+                {new Intl.NumberFormat('pt-BR', {
+                  style: 'currency',
+                  currency: 'BRL',
+                }).format(legacyValue)}
+              </span>
+            )}
             <span className="truncate text-[9px] text-muted-foreground">
               {t('kpis.cashBalance.description')}
             </span>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.322",
+  "version": "0.0.326",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,14 +9,14 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/api": "0.0.8",
+    "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/contact": "0.0.326",
+    "@hed-hog/tag": "0.0.326",
+    "@hed-hog/api": "0.0.8",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/core": "0.0.322",
-    "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/contact": "0.0.322",
-    "@hed-hog/api-prisma": "0.0.6",
-    "@hed-hog/tag": "0.0.322"
+    "@hed-hog/core": "0.0.326",
+    "@hed-hog/api-types": "0.0.1"
   },
   "exports": {
     ".": {