@hed-hog/finance 0.0.300 → 0.0.302

package/dist/finance.contract-activated.subscriber.spec.js

@@ -0,0 +1,302 @@
+"use strict";
+/// <reference types="jest" />
+Object.defineProperty(exports, "__esModule", { value: true });
+const finance_contract_activated_subscriber_1 = require("./finance.contract-activated.subscriber");
+describe('FinanceContractActivatedSubscriber', () => {
+    let integrationApi;
+    let financeService;
+    let prisma;
+    let subscriber;
+    beforeEach(() => {
+        integrationApi = {
+            subscribeMany: jest.fn(),
+            findLinksBySource: jest.fn(),
+            createLink: jest.fn().mockResolvedValue(undefined),
+            publishEvent: jest.fn().mockResolvedValue(undefined),
+        };
+        financeService = {
+            createAccountsReceivableTitle: jest.fn().mockResolvedValue({
+                id: '91',
+                parcelas: [
+                    {
+                        id: '501',
+                        numero: 1,
+                        vencimento: '2025-02-10T00:00:00.000Z',
+                        valor: 1000,
+                    },
+                    {
+                        id: '502',
+                        numero: 2,
+                        vencimento: '2025-03-10T00:00:00.000Z',
+                        valor: 1000,
+                    },
+                    {
+                        id: '503',
+                        numero: 3,
+                        vencimento: '2025-04-10T00:00:00.000Z',
+                        valor: 1000,
+                    },
+                ],
+            }),
+            createAccountsPayableTitle: jest.fn().mockResolvedValue({
+                id: '190',
+                parcelas: [
+                    {
+                        id: '801',
+                        numero: 1,
+                        vencimento: '2025-02-15T00:00:00.000Z',
+                        valor: 450,
+                    },
+                ],
+            }),
+        };
+        prisma = {
+            financial_title: {
+                findFirst: jest.fn().mockResolvedValue(null),
+            },
+            outbox_event: {
+                findMany: jest.fn().mockResolvedValue([]),
+            },
+        };
+        subscriber = new finance_contract_activated_subscriber_1.FinanceContractActivatedSubscriber(integrationApi, financeService, prisma);
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    it('registers handlers for contract signing and activation', () => {
+        subscriber.onModuleInit();
+        const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+        expect(subscriptions).toHaveLength(2);
+        expect(subscriptions.map((entry) => entry.eventName)).toEqual(expect.arrayContaining([
+            'operations.contract.signed',
+            'operations.contract.activated',
+        ]));
+    });
+    it('skips duplicate finance generation when a financial title link already exists', async () => {
+        subscriber.onModuleInit();
+        const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+        const activated = subscriptions.find((entry) => entry.eventName === 'operations.contract.activated');
+        integrationApi.findLinksBySource.mockResolvedValue([
+            {
+                targetModule: 'finance',
+                targetEntityType: 'financial_title',
+                targetEntityId: '91',
+            },
+        ]);
+        await activated.handler({
+            eventName: 'operations.contract.activated',
+            sourceModule: 'operations',
+            aggregateType: 'contract',
+            aggregateId: '77',
+            payload: {
+                contractId: 77,
+            },
+        });
+        expect(financeService.createAccountsReceivableTitle).not.toHaveBeenCalled();
+        expect(financeService.createAccountsPayableTitle).not.toHaveBeenCalled();
+        expect(integrationApi.createLink).not.toHaveBeenCalled();
+        expect(integrationApi.publishEvent).not.toHaveBeenCalled();
+    });
+    it('recovers an existing title when the finance record already exists but the integration link is missing', async () => {
+        subscriber.onModuleInit();
+        const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+        const activated = subscriptions.find((entry) => entry.eventName === 'operations.contract.activated');
+        integrationApi.findLinksBySource.mockResolvedValue([]);
+        prisma.financial_title.findFirst.mockResolvedValue({
+            id: 91,
+            financial_installment: [
+                {
+                    id: 501,
+                    installment_number: 1,
+                    due_date: new Date('2025-02-10T00:00:00.000Z'),
+                    amount_cents: 100000,
+                },
+            ],
+        });
+        await activated.handler({
+            eventName: 'operations.contract.activated',
+            sourceModule: 'operations',
+            aggregateType: 'contract',
+            aggregateId: '77',
+            payload: {
+                contractId: 77,
+                locale: 'en',
+                correlationId: 'contract:77',
+                activatedByUserId: 9,
+                contract: {
+                    code: 'CTR-077',
+                    name: 'Recovered Contract',
+                    contractCategory: 'client',
+                    contractType: 'service_agreement',
+                    effectiveDate: '2025-02-01',
+                    financialTerms: [
+                        {
+                            label: 'Recovered installment',
+                            amount: 1000,
+                            recurrence: 'one_time',
+                        },
+                    ],
+                },
+                receivable: {
+                    personId: 5,
+                    documentNumber: 'CTR-077',
+                    description: 'Recovered Contract',
+                },
+            },
+        });
+        expect(financeService.createAccountsReceivableTitle).not.toHaveBeenCalled();
+        expect(integrationApi.createLink).toHaveBeenCalledWith(expect.objectContaining({
+            targetEntityType: 'financial_title',
+            targetEntityId: '91',
+        }));
+    });
+    it('creates receivable titles, installment links and a finance success event', async () => {
+        subscriber.onModuleInit();
+        const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+        const signed = subscriptions.find((entry) => entry.eventName === 'operations.contract.signed');
+        integrationApi.findLinksBySource.mockResolvedValue([]);
+        await signed.handler({
+            eventName: 'operations.contract.signed',
+            sourceModule: 'operations',
+            aggregateType: 'contract',
+            aggregateId: '77',
+            payload: {
+                contractId: 77,
+                proposalId: 12,
+                locale: 'en',
+                correlationId: 'contract:77',
+                signedByUserId: 9,
+                contract: {
+                    code: 'CTR-077',
+                    name: 'Support Contract',
+                    contractCategory: 'client',
+                    contractType: 'service_agreement',
+                    startDate: '2025-02-01',
+                    endDate: '2025-04-30',
+                    signedAt: '2025-02-01',
+                    effectiveDate: '2025-02-01',
+                    financialTerms: [
+                        {
+                            label: 'Monthly retainer',
+                            amount: 1000,
+                            recurrence: 'monthly',
+                            dueDay: 10,
+                        },
+                    ],
+                },
+                receivable: {
+                    personId: 5,
+                    documentNumber: 'CTR-077',
+                    description: 'Support Contract',
+                },
+            },
+        });
+        expect(financeService.createAccountsReceivableTitle).toHaveBeenCalledWith(expect.objectContaining({
+            person_id: 5,
+            document_number: 'CTR-077',
+            total_amount: 3000,
+            installments: [
+                expect.objectContaining({
+                    installment_number: 1,
+                    due_date: '2025-02-10',
+                    amount: 1000,
+                }),
+                expect.objectContaining({
+                    installment_number: 2,
+                    due_date: '2025-03-10',
+                    amount: 1000,
+                }),
+                expect.objectContaining({
+                    installment_number: 3,
+                    due_date: '2025-04-10',
+                    amount: 1000,
+                }),
+            ],
+        }), 'en', 9);
+        expect(financeService.createAccountsPayableTitle).not.toHaveBeenCalled();
+        expect(integrationApi.createLink).toHaveBeenCalledTimes(4);
+        expect(integrationApi.createLink).toHaveBeenNthCalledWith(1, expect.objectContaining({
+            sourceModule: 'operations',
+            sourceEntityType: 'contract',
+            sourceEntityId: '77',
+            targetModule: 'finance',
+            targetEntityType: 'financial_title',
+            targetEntityId: '91',
+            metadata: expect.objectContaining({
+                eventName: 'operations.contract.signed',
+                titleType: 'receivable',
+                source_module: 'operations',
+                source_entity: 'contract',
+                source_id: '77',
+                installmentCount: 3,
+            }),
+        }));
+        expect(integrationApi.createLink).toHaveBeenNthCalledWith(2, expect.objectContaining({
+            targetEntityType: 'financial_installment',
+            targetEntityId: '501',
+        }));
+        expect(integrationApi.createLink).toHaveBeenNthCalledWith(3, expect.objectContaining({
+            targetEntityType: 'financial_installment',
+            targetEntityId: '502',
+        }));
+        expect(integrationApi.createLink).toHaveBeenNthCalledWith(4, expect.objectContaining({
+            targetEntityType: 'financial_installment',
+            targetEntityId: '503',
+        }));
+        expect(integrationApi.publishEvent).toHaveBeenCalledWith(expect.objectContaining({
+            eventName: 'finance.receivable.created_from_contract',
+            sourceModule: 'finance',
+            aggregateType: 'financial_title',
+            aggregateId: '91',
+            payload: expect.objectContaining({
+                proposalId: 12,
+                source_module: 'operations',
+                source_entity: 'contract',
+                source_id: '77',
+                triggerEvent: 'operations.contract.signed',
+                financialTitle: expect.objectContaining({
+                    id: '91',
+                    titleType: 'receivable',
+                    installmentCount: 3,
+                }),
+            }),
+        }));
+    });
+    it('routes supplier contracts to accounts payable', async () => {
+        subscriber.onModuleInit();
+        const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+        const activated = subscriptions.find((entry) => entry.eventName === 'operations.contract.activated');
+        integrationApi.findLinksBySource.mockResolvedValue([]);
+        await activated.handler({
+            eventName: 'operations.contract.activated',
+            sourceModule: 'operations',
+            aggregateType: 'contract',
+            aggregateId: '88',
+            payload: {
+                contractId: 88,
+                locale: 'en',
+                activatedByUserId: 11,
+                contract: {
+                    code: 'CTR-088',
+                    contractCategory: 'supplier',
+                    contractType: 'service_agreement',
+                    effectiveDate: '2025-02-15',
+                },
+                receivable: {
+                    personId: 14,
+                    totalAmount: 450,
+                    documentNumber: 'CTR-088',
+                    description: 'Supplier onboarding',
+                },
+            },
+        });
+        expect(financeService.createAccountsPayableTitle).toHaveBeenCalledWith(expect.objectContaining({
+            person_id: 14,
+            total_amount: 450,
+        }), 'en', 11);
+        expect(integrationApi.publishEvent).toHaveBeenCalledWith(expect.objectContaining({
+            eventName: 'finance.payable.created_from_contract',
+        }));
+    });
+});
+//# sourceMappingURL=finance.contract-activated.subscriber.spec.js.map

package/dist/finance.contract-activated.subscriber.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance.contract-activated.subscriber.spec.js","sourceRoot":"","sources":["../src/finance.contract-activated.subscriber.spec.ts"],"names":[],"mappings":"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"}

package/dist/finance.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finance.module.d.ts","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":"AAoBA,qBA0Ba,aAAa;CAAG"}
+{"version":3,"file":"finance.module.d.ts","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":"AAqBA,qBA8Ba,aAAa;CAAG"}

package/dist/finance.module.js

@@ -24,6 +24,7 @@ const finance_period_close_controller_1 = require("./finance-period-close.contro
 const finance_reports_controller_1 = require("./finance-reports.controller");
 const finance_statements_controller_1 = require("./finance-statements.controller");
 const finance_transfers_controller_1 = require("./finance-transfers.controller");
+const finance_contract_activated_subscriber_1 = require("./finance.contract-activated.subscriber");
 const finance_integration_example_subscriber_1 = require("./finance.integration-example.subscriber");
 const finance_service_1 = require("./finance.service");
 let FinanceModule = class FinanceModule {
@@ -53,7 +54,11 @@ exports.FinanceModule = FinanceModule = __decorate([
             finance_statements_controller_1.FinanceStatementsController,
             finance_transfers_controller_1.FinanceTransfersController,
         ],
-        providers: [finance_service_1.FinanceService, finance_integration_example_subscriber_1.FinanceIntegrationExampleSubscriber],
+        providers: [
+            finance_service_1.FinanceService,
+            finance_integration_example_subscriber_1.FinanceIntegrationExampleSubscriber,
+            finance_contract_activated_subscriber_1.FinanceContractActivatedSubscriber,
+        ],
         exports: [finance_service_1.FinanceService],
     })
 ], FinanceModule);

package/dist/finance.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"finance.module.js","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,4DAA2D;AAC3D,oDAAmD;AACnD,wCAAwE;AACxE,2CAAoD;AACpD,2CAA8C;AAC9C,mFAA6E;AAC7E,yFAAmF;AACnF,mFAA8E;AAC9E,qFAAgF;AAChF,uFAAiF;AACjF,uEAAkE;AAClE,uFAAkF;AAClF,uFAAiF;AACjF,6EAAwE;AACxE,mFAA8E;AAC9E,iFAA4E;AAC5E,qGAA+F;AAC/F,uDAAmD;AA4B5C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IA1BzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,EAAE;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;YAClC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,eAAQ,CAAC;YAC1B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iBAAU,CAAC;YAC5B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAiB,CAAC;SACpC;QACD,WAAW,EAAE;YACX,0DAA0B;YAC1B,+CAAqB;YACrB,+DAA6B;YAC7B,qDAAwB;YACxB,gEAA6B;YAC7B,2DAA2B;YAC3B,6DAA4B;YAC5B,8DAA4B;YAC5B,8DAA4B;YAC5B,2DAA2B;YAC3B,yDAA0B;SAC3B;QACD,SAAS,EAAE,CAAC,gCAAc,EAAE,4EAAmC,CAAC;QAChE,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}
+{"version":3,"file":"finance.module.js","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,4DAA2D;AAC3D,oDAAmD;AACnD,wCAAwE;AACxE,2CAAoD;AACpD,2CAA8C;AAC9C,mFAA6E;AAC7E,yFAAmF;AACnF,mFAA8E;AAC9E,qFAAgF;AAChF,uFAAiF;AACjF,uEAAkE;AAClE,uFAAkF;AAClF,uFAAiF;AACjF,6EAAwE;AACxE,mFAA8E;AAC9E,iFAA4E;AAC5E,mGAA6F;AAC7F,qGAA+F;AAC/F,uDAAmD;AAgC5C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IA9BzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,EAAE;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;YAClC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,eAAQ,CAAC;YAC1B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iBAAU,CAAC;YAC5B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAiB,CAAC;SACpC;QACD,WAAW,EAAE;YACX,0DAA0B;YAC1B,+CAAqB;YACrB,+DAA6B;YAC7B,qDAAwB;YACxB,gEAA6B;YAC7B,2DAA2B;YAC3B,6DAA4B;YAC5B,8DAA4B;YAC5B,8DAA4B;YAC5B,2DAA2B;YAC3B,yDAA0B;SAC3B;QACD,SAAS,EAAE;YACT,gCAAc;YACd,4EAAmC;YACnC,0EAAkC;SACnC;QACD,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}

package/hedhog/data/menu.yaml

@@ -11,23 +11,6 @@
       - where:
           slug: admin-finance
 
-- menu_id:
-    where:
-      slug: /finance
-  icon: chart-no-axes-combined
-  url: /finance
-  name:
-    en: Overview
-    pt: Visão geral
-  slug: /finance/overview
-  order: 101
-  relations:
-    role:
-      - where:
-          slug: admin
-      - where:
-          slug: admin-finance
-
 - menu_id:
     where:
       slug: /finance

package/hedhog/frontend/app/_components/finance-layout.tsx.ejs

@@ -0,0 +1,108 @@
+'use client';
+
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { cn } from '@/lib/utils';
+import type { ReactNode } from 'react';
+
+type FinancePageSectionProps = {
+  title?: ReactNode;
+  description?: ReactNode;
+  actions?: ReactNode;
+  children: ReactNode;
+  className?: string;
+  contentClassName?: string;
+};
+
+export function FinancePageSection({
+  title,
+  description,
+  actions,
+  children,
+  className,
+  contentClassName,
+}: FinancePageSectionProps) {
+  const hasHeader = title || description || actions;
+
+  return (
+    <Card
+      className={cn(
+        'overflow-hidden border-border/60 py-0 shadow-sm',
+        className
+      )}
+    >
+      {hasHeader ? (
+        <CardHeader className="flex flex-col gap-3 border-b border-border/50 px-5 py-4 sm:flex-row sm:items-start sm:justify-between">
+          <div className="space-y-1">
+            {title ? (
+              <CardTitle className="text-base">{title}</CardTitle>
+            ) : null}
+            {description ? (
+              <CardDescription>{description}</CardDescription>
+            ) : null}
+          </div>
+          {actions ? <div className="shrink-0">{actions}</div> : null}
+        </CardHeader>
+      ) : null}
+      <CardContent className={cn('p-0', contentClassName)}>
+        {children}
+      </CardContent>
+    </Card>
+  );
+}
+
+type FinanceSheetBodyProps = {
+  children: ReactNode;
+  className?: string;
+};
+
+export function FinanceSheetBody({
+  children,
+  className,
+}: FinanceSheetBodyProps) {
+  return (
+    <div
+      className={cn(
+        'flex-1 space-y-5 overflow-y-auto px-4 py-4 sm:px-6 sm:py-5',
+        className
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+type FinanceSheetSectionProps = {
+  title: ReactNode;
+  description?: ReactNode;
+  children: ReactNode;
+  className?: string;
+  contentClassName?: string;
+};
+
+export function FinanceSheetSection({
+  title,
+  description,
+  children,
+  className,
+  contentClassName,
+}: FinanceSheetSectionProps) {
+  return (
+    <section className={cn('', className)}>
+      <div className="mb-4 space-y-1">
+        <h3 className="text-sm font-semibold text-foreground">{title}</h3>
+        {description ? (
+          <p className="text-sm leading-relaxed text-muted-foreground">
+            {description}
+          </p>
+        ) : null}
+      </div>
+      <div className={cn('space-y-4', contentClassName)}>{children}</div>
+    </section>
+  );
+}

package/hedhog/frontend/app/accounts-payable/approvals/page.tsx.ejs

@@ -1,14 +1,11 @@
 'use client';
 
+'use client';
+
+import { FinancePageSection } from '@/app/(app)/(libraries)/finance/_components/finance-layout';
 import { Badge } from '@/components/ui/badge';
 import { Button } from '@/components/ui/button';
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from '@/components/ui/card';
+import { EmptyState, Page, PageHeader } from '@/components/entity-list';
 import {
   Dialog,
   DialogContent,
@@ -18,10 +15,9 @@ import {
   DialogTitle,
   DialogTrigger,
 } from '@/components/ui/dialog';
+import { KpiCardsGrid } from '@/components/ui/kpi-cards-grid';
 import { Label } from '@/components/ui/label';
 import { Money } from '@/components/ui/money';
-
-import { Page, PageHeader } from '@/components/entity-list';
 import {
   Table,
   TableBody,
@@ -212,6 +208,34 @@ export default function AprovacoesPage() {
   };
 
   const totalPendente = aprovacoes.reduce((acc, a) => acc + a.valor, 0);
+  const urgentCount = aprovacoes.filter(
+    (a) => a.urgencia === 'alta' || a.urgencia === 'critica'
+  ).length;
+  const summaryCards = [
+    {
+      key: 'pending',
+      title: t('cards.pending'),
+      value: aprovacoes.length,
+      icon: Clock,
+      layout: 'compact' as const,
+    },
+    {
+      key: 'value',
+      title: t('cards.totalValue'),
+      value: <Money value={totalPendente} />,
+      icon: AlertTriangle,
+      layout: 'compact' as const,
+    },
+    {
+      key: 'urgent',
+      title: t('cards.urgent'),
+      value: urgentCount,
+      icon: AlertTriangle,
+      layout: 'compact' as const,
+      iconContainerClassName: 'bg-orange-500/10 text-orange-700',
+      accentClassName: 'from-orange-500/20 via-amber-500/10 to-transparent',
+    },
+  ];
 
   return (
     <Page>
@@ -225,57 +249,11 @@ export default function AprovacoesPage() {
         ]}
       />
 
-      <div className="grid gap-4 md:grid-cols-3">
-        <Card>
-          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
-            <CardTitle className="text-sm font-medium">
-              {t('cards.pending')}
-            </CardTitle>
-            <Clock className="h-4 w-4 text-muted-foreground" />
-          </CardHeader>
-          <CardContent>
-            <div className="text-2xl font-bold">{aprovacoes.length}</div>
-          </CardContent>
-        </Card>
-        <Card>
-          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
-            <CardTitle className="text-sm font-medium">
-              {t('cards.totalValue')}
-            </CardTitle>
-            <AlertTriangle className="h-4 w-4 text-muted-foreground" />
-          </CardHeader>
-          <CardContent>
-            <div className="text-2xl font-bold">
-              <Money value={totalPendente} />
-            </div>
-          </CardContent>
-        </Card>
-        <Card>
-          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
-            <CardTitle className="text-sm font-medium">
-              {t('cards.urgent')}
-            </CardTitle>
-            <AlertTriangle className="h-4 w-4 text-orange-500" />
-          </CardHeader>
-          <CardContent>
-            <div className="text-2xl font-bold">
-              {
-                aprovacoes.filter(
-                  (a) => a.urgencia === 'alta' || a.urgencia === 'critica'
-                ).length
-              }
-            </div>
-          </CardContent>
-        </Card>
-      </div>
+      <KpiCardsGrid items={summaryCards} columns={3} />
 
-      <Card>
-        <CardHeader>
-          <CardTitle>{t('table.title')}</CardTitle>
-          <CardDescription>{t('table.description')}</CardDescription>
-        </CardHeader>
-        <CardContent>
-          {aprovacoes.length > 0 ? (
+      <FinancePageSection className="border-none shadow-none p-0">
+        {aprovacoes.length > 0 ? (
+          <div className="overflow-x-auto">
             <Table>
               <TableHeader>
                 <TableRow>
@@ -307,7 +285,7 @@ export default function AprovacoesPage() {
                     ] || urgenciaConfig.media;
 
                   return (
-                    <TableRow key={aprovacao.id}>
+                    <TableRow key={aprovacao.id} className="hover:bg-muted/30">
                       <TableCell className="font-medium">
                         {titulo?.documento}
                       </TableCell>
@@ -359,15 +337,19 @@ export default function AprovacoesPage() {
                 })}
               </TableBody>
             </Table>
-          ) : (
-            <div className="flex flex-col items-center justify-center py-12 text-center">
-              <CheckCircle className="h-12 w-12 text-green-500" />
-              <h3 className="mt-4 text-lg font-semibold">{t('empty.title')}</h3>
-              <p className="text-muted-foreground">{t('empty.description')}</p>
-            </div>
-          )}
-        </CardContent>
-      </Card>
+          </div>
+        ) : (
+          <div className="px-4 py-8 sm:px-6">
+            <EmptyState
+              icon={<CheckCircle className="h-12 w-12" />}
+              title={t('empty.title')}
+              description={t('empty.description')}
+              actionLabel={t('empty.refresh')}
+              onAction={() => void refetch()}
+            />
+          </div>
+        )}
+      </FinancePageSection>
     </Page>
   );
 }