@hed-hog/finance 0.0.297 → 0.0.299

package/hedhog/data/dashboard_component.yaml

@@ -0,0 +1,87 @@
+- slug: cash-balance-kpi
+  library_slug: finance
+  width: 2
+  height: 2
+  name:
+    en: Cash Balance
+    pt: Saldo em Caixa
+  description:
+    en: Shows the current company cash balance.
+    pt: Mostra o saldo atual de caixa da empresa.
+
+- slug: payable-30d-kpi
+  library_slug: finance
+  width: 2
+  height: 2
+  name:
+    en: Payables 30 Days
+    pt: A Pagar 30 Dias
+  description:
+    en: Shows payables due in 30 days and the 7-day subtotal.
+    pt: Mostra contas a pagar em 30 dias e o subtotal de 7 dias.
+
+- slug: receivable-30d-kpi
+  library_slug: finance
+  width: 2
+  height: 2
+  name:
+    en: Receivables 30 Days
+    pt: A Receber 30 Dias
+  description:
+    en: Shows receivables due in 30 days and the 7-day subtotal.
+    pt: Mostra contas a receber em 30 dias e o subtotal de 7 dias.
+
+- slug: default-kpi
+  library_slug: finance
+  width: 2
+  height: 2
+  name:
+    en: Default Amount
+    pt: Inadimplencia
+  description:
+    en: Shows the current default amount.
+    pt: Mostra o valor atual de inadimplencia.
+
+- slug: cash-flow-chart
+  library_slug: finance
+  width: 6
+  height: 5
+  name:
+    en: Cash Flow Chart
+    pt: Grafico de Fluxo de Caixa
+  description:
+    en: Compares predicted and realized cash flow.
+    pt: Compara o fluxo de caixa previsto e realizado.
+
+- slug: financial-alerts
+  library_slug: finance
+  width: 3
+  height: 4
+  name:
+    en: Financial Alerts
+    pt: Alertas Financeiros
+  description:
+    en: Highlights overdue items, pending reconciliation and open period.
+    pt: Destaca titulos vencidos, conciliacao pendente e periodo aberto.
+
+- slug: upcoming-payable
+  library_slug: finance
+  width: 3
+  height: 4
+  name:
+    en: Upcoming Payables
+    pt: Proximos A Pagar
+  description:
+    en: Lists upcoming payable due dates.
+    pt: Lista os proximos vencimentos a pagar.
+
+- slug: upcoming-receivable
+  library_slug: finance
+  width: 3
+  height: 4
+  name:
+    en: Upcoming Receivables
+    pt: Proximos A Receber
+  description:
+    en: Lists upcoming receivable due dates.
+    pt: Lista os proximos vencimentos a receber.

package/hedhog/data/dashboard_component_role.yaml

@@ -0,0 +1,48 @@
+- component_id:
+    where:
+      slug: cash-balance-kpi
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: payable-30d-kpi
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: receivable-30d-kpi
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: default-kpi
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: cash-flow-chart
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: financial-alerts
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: upcoming-payable
+  role_id:
+    where:
+      slug: admin-finance
+- component_id:
+    where:
+      slug: upcoming-receivable
+  role_id:
+    where:
+      slug: admin-finance

package/hedhog/frontend/widgets/alerts.tsx.ejs

@@ -0,0 +1,108 @@
+'use client';
+
+import { Badge } from '@/components/ui/badge';
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { AlertTriangle } from 'lucide-react';
+import { useLocale, useTranslations } from 'next-intl';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface FinanceData {
+  titulosPagar?: Array<{
+    status: string;
+    parcelas: Array<{ status: string }>;
+  }>;
+  extratos?: Array<{
+    statusConciliacao: string;
+  }>;
+  periodoAberto?: {
+    inicio?: string | null;
+  } | null;
+}
+
+interface AlertsProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+export default function Alerts({ widget, onRemove }: AlertsProps) {
+  const t = useTranslations('finance.DashboardPage');
+  const locale = useLocale();
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-alerts',
+    });
+
+  const approvedPayables = (data?.titulosPagar || []).filter(
+    (titulo) => titulo.status !== 'rascunho' && titulo.status !== 'cancelado'
+  );
+
+  const overdue = approvedPayables.filter((titulo) =>
+    titulo.parcelas.some((p) => p.status === 'vencido')
+  ).length;
+
+  const pendingReconciliation = (data?.extratos || []).filter(
+    (e) => e.statusConciliacao === 'pendente'
+  ).length;
+
+  const periodBase = data?.periodoAberto?.inicio
+    ? new Date(data.periodoAberto.inicio)
+    : new Date();
+  const month = new Intl.DateTimeFormat(locale, { month: 'long' }).format(
+    periodBase
+  );
+  const currentPeriod = `${month.charAt(0).toUpperCase()}${month.slice(1)}/${periodBase.getFullYear()}`;
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('alerts.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full">
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2 text-base">
+            <AlertTriangle className="h-4 w-4 text-yellow-500" />
+            {t('alerts.title')}
+          </CardTitle>
+        </CardHeader>
+        <CardContent>
+          <div className="space-y-3">
+            {overdue > 0 && (
+              <div className="flex items-center justify-between rounded-lg bg-red-50 p-3">
+                <span className="text-sm">{t('alerts.overdueTitles')}</span>
+                <Badge variant="destructive">{overdue}</Badge>
+              </div>
+            )}
+            {pendingReconciliation > 0 && (
+              <div className="flex items-center justify-between rounded-lg bg-yellow-50 p-3">
+                <span className="text-sm">
+                  {t('alerts.pendingReconciliation')}
+                </span>
+                <Badge
+                  variant="outline"
+                  className="border-yellow-500 text-yellow-700"
+                >
+                  {pendingReconciliation}
+                </Badge>
+              </div>
+            )}
+            <div className="flex items-center justify-between rounded-lg bg-blue-50 p-3">
+              <span className="text-sm">{t('alerts.openPeriod')}</span>
+              <Badge
+                variant="outline"
+                className="border-blue-500 text-blue-700"
+              >
+                {currentPeriod}
+              </Badge>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

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

@@ -0,0 +1,66 @@
+'use client';
+
+import { Card, CardContent } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { Wallet } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface CashBalanceKpiProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface FinanceData {
+  kpis?: {
+    saldoCaixa: number;
+  };
+}
+
+export default function CashBalanceKpi({
+  widget,
+  onRemove,
+}: CashBalanceKpiProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-kpi-cash-balance',
+    });
+
+  const value = data?.kpis?.saldoCaixa ?? 0;
+  const formatted = new Intl.NumberFormat('pt-BR', {
+    style: 'currency',
+    currency: 'BRL',
+  }).format(value);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('kpis.cashBalance.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full overflow-hidden transition-all duration-300 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-3 p-4">
+          <div className="flex h-11 w-11 shrink-0 items-center justify-center rounded-xl bg-emerald-50">
+            <Wallet className="h-5 w-5 text-emerald-600" />
+          </div>
+          <div className="flex min-w-0 flex-col">
+            <span className="text-[10px] font-medium uppercase tracking-wider text-muted-foreground">
+              {t('kpis.cashBalance.title')}
+            </span>
+            <span className="truncate text-lg font-bold tracking-tight text-foreground">
+              {formatted}
+            </span>
+            <span className="text-[10px] text-muted-foreground">
+              {t('kpis.cashBalance.description')}
+            </span>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/cash-flow-chart.tsx.ejs

@@ -0,0 +1,122 @@
+'use client';
+
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { useTranslations } from 'next-intl';
+import {
+  CartesianGrid,
+  Legend,
+  Line,
+  LineChart,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis,
+} from 'recharts';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface CashFlowPoint {
+  data: string;
+  saldoPrevisto: number;
+  saldoRealizado: number;
+}
+
+interface FinanceData {
+  fluxoCaixaPrevisto?: CashFlowPoint[];
+}
+
+interface CashFlowChartProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+export default function CashFlowChart({
+  widget,
+  onRemove,
+}: CashFlowChartProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-cash-flow-chart',
+    });
+
+  const chartData = (data?.fluxoCaixaPrevisto || []).map((item) => ({
+    ...item,
+    data: new Date(item.data).toLocaleDateString('pt-BR', {
+      day: '2-digit',
+      month: '2-digit',
+    }),
+  }));
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('cashFlow.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full flex flex-col">
+        <CardHeader className="pb-2">
+          <CardTitle className="text-base">{t('cashFlow.title')}</CardTitle>
+          <CardDescription>{t('cashFlow.description')}</CardDescription>
+        </CardHeader>
+        <CardContent className="flex-1 pt-0">
+          <div className="h-[280px] w-full">
+            <ResponsiveContainer width="100%" height="100%">
+              <LineChart data={chartData}>
+                <CartesianGrid strokeDasharray="3 3" className="stroke-muted" />
+                <XAxis
+                  dataKey="data"
+                  tick={{ fontSize: 12 }}
+                  tickLine={false}
+                  axisLine={false}
+                />
+                <YAxis
+                  tick={{ fontSize: 12 }}
+                  tickLine={false}
+                  axisLine={false}
+                  tickFormatter={(value) => `${(value / 1000).toFixed(0)}k`}
+                />
+                <Tooltip
+                  formatter={(value: number) =>
+                    new Intl.NumberFormat('pt-BR', {
+                      style: 'currency',
+                      currency: 'BRL',
+                    }).format(value)
+                  }
+                />
+                <Legend />
+                <Line
+                  type="monotone"
+                  dataKey="saldoPrevisto"
+                  name={t('chart.predicted')}
+                  stroke="hsl(var(--primary))"
+                  strokeWidth={2}
+                  dot={false}
+                />
+                <Line
+                  type="monotone"
+                  dataKey="saldoRealizado"
+                  name={t('chart.actual')}
+                  stroke="hsl(var(--chart-2))"
+                  strokeWidth={2}
+                  dot={false}
+                  connectNulls
+                />
+              </LineChart>
+            </ResponsiveContainer>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/default-kpi.tsx.ejs

@@ -0,0 +1,63 @@
+'use client';
+
+import { Card, CardContent } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { AlertTriangle } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface DefaultKpiProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface FinanceData {
+  kpis?: {
+    inadimplencia: number;
+  };
+}
+
+export default function DefaultKpi({ widget, onRemove }: DefaultKpiProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-kpi-default',
+    });
+
+  const value = data?.kpis?.inadimplencia ?? 0;
+  const formatted = new Intl.NumberFormat('pt-BR', {
+    style: 'currency',
+    currency: 'BRL',
+  }).format(value);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('kpis.default.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full overflow-hidden transition-all duration-300 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-3 p-4">
+          <div className="flex h-11 w-11 shrink-0 items-center justify-center rounded-xl bg-amber-50">
+            <AlertTriangle className="h-5 w-5 text-amber-600" />
+          </div>
+          <div className="flex min-w-0 flex-col">
+            <span className="text-[10px] font-medium uppercase tracking-wider text-muted-foreground">
+              {t('kpis.default.title')}
+            </span>
+            <span className="truncate text-lg font-bold tracking-tight text-foreground">
+              {formatted}
+            </span>
+            <span className="text-[10px] text-muted-foreground">
+              {t('kpis.default.description')}
+            </span>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/payable-30d-kpi.tsx.ejs

@@ -0,0 +1,73 @@
+'use client';
+
+import { Card, CardContent } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { TrendingDown } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface Payable30dKpiProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface FinanceData {
+  kpis?: {
+    aPagar30dias: number;
+    aPagar7dias: number;
+  };
+}
+
+export default function Payable30dKpi({
+  widget,
+  onRemove,
+}: Payable30dKpiProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-kpi-payable-30d',
+    });
+
+  const value = data?.kpis?.aPagar30dias ?? 0;
+  const sevenDays = data?.kpis?.aPagar7dias ?? 0;
+  const formatted = new Intl.NumberFormat('pt-BR', {
+    style: 'currency',
+    currency: 'BRL',
+  }).format(value);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('kpis.payable30.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full overflow-hidden transition-all duration-300 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-3 p-4">
+          <div className="flex h-11 w-11 shrink-0 items-center justify-center rounded-xl bg-red-50">
+            <TrendingDown className="h-5 w-5 text-red-600" />
+          </div>
+          <div className="flex min-w-0 flex-col">
+            <span className="text-[10px] font-medium uppercase tracking-wider text-muted-foreground">
+              {t('kpis.payable30.title')}
+            </span>
+            <span className="truncate text-lg font-bold tracking-tight text-foreground">
+              {formatted}
+            </span>
+            <span className="text-[10px] text-muted-foreground">
+              {t('kpis.payable30.sevenDays', {
+                value: new Intl.NumberFormat('pt-BR', {
+                  style: 'currency',
+                  currency: 'BRL',
+                }).format(sevenDays),
+              })}
+            </span>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/receivable-30d-kpi.tsx.ejs

@@ -0,0 +1,73 @@
+'use client';
+
+import { Card, CardContent } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { TrendingUp } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface Receivable30dKpiProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface FinanceData {
+  kpis?: {
+    aReceber30dias: number;
+    aReceber7dias: number;
+  };
+}
+
+export default function Receivable30dKpi({
+  widget,
+  onRemove,
+}: Receivable30dKpiProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-kpi-receivable-30d',
+    });
+
+  const value = data?.kpis?.aReceber30dias ?? 0;
+  const sevenDays = data?.kpis?.aReceber7dias ?? 0;
+  const formatted = new Intl.NumberFormat('pt-BR', {
+    style: 'currency',
+    currency: 'BRL',
+  }).format(value);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('kpis.receivable30.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full overflow-hidden transition-all duration-300 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-3 p-4">
+          <div className="flex h-11 w-11 shrink-0 items-center justify-center rounded-xl bg-green-50">
+            <TrendingUp className="h-5 w-5 text-green-600" />
+          </div>
+          <div className="flex min-w-0 flex-col">
+            <span className="text-[10px] font-medium uppercase tracking-wider text-muted-foreground">
+              {t('kpis.receivable30.title')}
+            </span>
+            <span className="truncate text-lg font-bold tracking-tight text-foreground">
+              {formatted}
+            </span>
+            <span className="text-[10px] text-muted-foreground">
+              {t('kpis.receivable30.sevenDays', {
+                value: new Intl.NumberFormat('pt-BR', {
+                  style: 'currency',
+                  currency: 'BRL',
+                }).format(sevenDays),
+              })}
+            </span>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/upcoming-payable.tsx.ejs

@@ -0,0 +1,123 @@
+'use client';
+
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { Money } from '@/components/ui/money';
+import { StatusBadge } from '@/components/ui/status-badge';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { ArrowDownRight } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import Link from 'next/link';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface FinanceData {
+  titulosPagar?: Array<{
+    id: string;
+    status: string;
+    documento: string;
+    fornecedorId?: string;
+    parcelas: Array<{
+      status: string;
+      vencimento: string;
+      valor: number;
+    }>;
+  }>;
+  pessoas?: Array<{
+    id: string;
+    nome: string;
+  }>;
+}
+
+interface UpcomingPayableProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+function formatDate(value: string) {
+  return new Date(value).toLocaleDateString('pt-BR');
+}
+
+export default function UpcomingPayable({
+  widget,
+  onRemove,
+}: UpcomingPayableProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-upcoming-payable',
+    });
+
+  const getPersonById = (id?: string) =>
+    (data?.pessoas || []).find((p) => p.id === id);
+
+  const approvedPayables = (data?.titulosPagar || []).filter(
+    (titulo) => titulo.status !== 'rascunho' && titulo.status !== 'cancelado'
+  );
+
+  const rows = approvedPayables
+    .flatMap((titulo) =>
+      titulo.parcelas
+        .filter((p) => p.status === 'aberto' || p.status === 'vencido')
+        .map((parcela) => ({
+          tituloId: titulo.id,
+          documento: titulo.documento,
+          person: getPersonById(titulo.fornecedorId)?.nome || '',
+          dueDate: parcela.vencimento,
+          value: parcela.valor,
+          status: parcela.status,
+        }))
+    )
+    .slice(0, 3);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('upcoming.payable')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full">
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2 text-base">
+            <ArrowDownRight className="h-4 w-4 text-red-500" />
+            {t('upcoming.payable')}
+          </CardTitle>
+          <CardDescription>{t('upcoming.nextDueDates')}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <div className="space-y-4">
+            {rows.map((item, index) => (
+              <Link
+                key={index}
+                href={`/finance/accounts-payable/installments/${item.tituloId}`}
+                className="-m-2 flex cursor-pointer items-center justify-between rounded-md p-2 transition-colors hover:bg-muted/50 active:bg-muted"
+              >
+                <div className="space-y-1">
+                  <p className="text-sm font-medium">{item.documento}</p>
+                  <p className="text-xs text-muted-foreground">{item.person}</p>
+                </div>
+                <div className="text-right">
+                  <p className="text-sm font-medium">
+                    <Money value={item.value} />
+                  </p>
+                  <p className="text-xs text-muted-foreground">
+                    {formatDate(item.dueDate)}
+                  </p>
+                </div>
+                <StatusBadge status={item.status as any} />
+              </Link>
+            ))}
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/upcoming-receivable.tsx.ejs

@@ -0,0 +1,118 @@
+'use client';
+
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { Money } from '@/components/ui/money';
+import { StatusBadge } from '@/components/ui/status-badge';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { ArrowUpRight } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import Link from 'next/link';
+import { WidgetWrapper } from '../widget-wrapper';
+
+interface FinanceData {
+  titulosReceber?: Array<{
+    id: string;
+    documento: string;
+    clienteId?: string;
+    parcelas: Array<{
+      status: string;
+      vencimento: string;
+      valor: number;
+    }>;
+  }>;
+  pessoas?: Array<{
+    id: string;
+    nome: string;
+  }>;
+}
+
+interface UpcomingReceivableProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+function formatDate(value: string) {
+  return new Date(value).toLocaleDateString('pt-BR');
+}
+
+export default function UpcomingReceivable({
+  widget,
+  onRemove,
+}: UpcomingReceivableProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-upcoming-receivable',
+    });
+
+  const getPersonById = (id?: string) =>
+    (data?.pessoas || []).find((p) => p.id === id);
+
+  const rows = (data?.titulosReceber || [])
+    .flatMap((titulo) =>
+      titulo.parcelas
+        .filter((p) => p.status === 'aberto' || p.status === 'vencido')
+        .map((parcela) => ({
+          tituloId: titulo.id,
+          documento: titulo.documento,
+          person: getPersonById(titulo.clienteId)?.nome || '',
+          dueDate: parcela.vencimento,
+          value: parcela.valor,
+          status: parcela.status,
+        }))
+    )
+    .slice(0, 3);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('upcoming.receivable')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full">
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2 text-base">
+            <ArrowUpRight className="h-4 w-4 text-green-500" />
+            {t('upcoming.receivable')}
+          </CardTitle>
+          <CardDescription>{t('upcoming.nextDueDates')}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <div className="space-y-4">
+            {rows.map((item, index) => (
+              <Link
+                key={index}
+                href={`/finance/accounts-receivable/installments/${item.tituloId}`}
+                className="-m-2 flex cursor-pointer items-center justify-between rounded-md p-2 transition-colors hover:bg-muted/50 active:bg-muted"
+              >
+                <div className="space-y-1">
+                  <p className="text-sm font-medium">{item.documento}</p>
+                  <p className="text-xs text-muted-foreground">{item.person}</p>
+                </div>
+                <div className="text-right">
+                  <p className="text-sm font-medium">
+                    <Money value={item.value} />
+                  </p>
+                  <p className="text-xs text-muted-foreground">
+                    {formatDate(item.dueDate)}
+                  </p>
+                </div>
+                <StatusBadge status={item.status as any} />
+              </Link>
+            ))}
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/package.json

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