@hed-hog/finance 0.0.299 → 0.0.301

package/hedhog/frontend/widgets/pending-approvals-kpi.tsx.ejs

@@ -0,0 +1,78 @@
+'use client';
+
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
+import { Card, CardContent } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { ClipboardList } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+
+interface PendingApprovalsKpiProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface FinanceData {
+  aprovacoesPendentes?: Array<{
+    valor?: number | null;
+  }>;
+}
+
+export default function PendingApprovalsKpi({
+  widget,
+  onRemove,
+}: PendingApprovalsKpiProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-kpi-pending-approvals',
+    });
+
+  const pendingApprovals = data?.aprovacoesPendentes || [];
+  const count = pendingApprovals.length;
+  const totalValue = pendingApprovals.reduce(
+    (acc, item) => acc + Number(item?.valor || 0),
+    0
+  );
+  const formattedValue = new Intl.NumberFormat('pt-BR', {
+    style: 'currency',
+    currency: 'BRL',
+  }).format(totalValue);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('kpis.pendingApprovals.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full overflow-hidden border-border/60 bg-linear-to-br from-background to-sky-50/50 shadow-sm transition-all duration-300 hover:-translate-y-0.5 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-2.5 p-3">
+          <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg bg-sky-100/80">
+            <ClipboardList className="h-4.5 w-4.5 text-sky-600" />
+          </div>
+          <div className="flex min-w-0 flex-1 flex-col justify-center">
+            <span className="text-[9px] font-semibold uppercase tracking-[0.18em] text-muted-foreground">
+              {t('kpis.pendingApprovals.title')}
+            </span>
+            <div className="flex items-end gap-2">
+              <span className="truncate text-base font-bold leading-none tracking-tight text-foreground sm:text-lg">
+                {count}
+              </span>
+              <span className="mb-0.5 text-[9px] text-muted-foreground">
+                {t('kpis.pendingApprovals.countLabel')}
+              </span>
+            </div>
+            <span className="truncate text-[9px] text-muted-foreground">
+              {t('kpis.pendingApprovals.description', {
+                value: formattedValue,
+              })}
+            </span>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/pending-approvals-list.tsx.ejs

@@ -0,0 +1,147 @@
+'use client';
+
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
+import { Badge } from '@/components/ui/badge';
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { Money } from '@/components/ui/money';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { ClipboardCheck } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import Link from 'next/link';
+
+interface PendingApprovalsListProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface ApprovalItem {
+  id: string;
+  tituloId?: string;
+  valor?: number | null;
+  politica?: string | null;
+  urgencia?: string | null;
+  dataSolicitacao?: string | null;
+}
+
+interface FinanceData {
+  aprovacoesPendentes?: ApprovalItem[];
+}
+
+function formatDate(value?: string | null) {
+  if (!value) return '—';
+
+  const parsed = new Date(value);
+  return Number.isNaN(parsed.getTime())
+    ? '—'
+    : parsed.toLocaleDateString('pt-BR');
+}
+
+export default function PendingApprovalsList({
+  widget,
+  onRemove,
+}: PendingApprovalsListProps) {
+  const t = useTranslations('finance.DashboardPage');
+  const approvalT = useTranslations('finance.PayableApprovalsPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-pending-approvals-list',
+    });
+
+  const rows = [...(data?.aprovacoesPendentes || [])]
+    .sort(
+      (a, b) =>
+        new Date(b?.dataSolicitacao || 0).getTime() -
+        new Date(a?.dataSolicitacao || 0).getTime()
+    )
+    .slice(0, 4);
+
+  const defaultUrgency = {
+    label: approvalT('urgency.medium'),
+    className: 'bg-blue-100 text-blue-700',
+  };
+
+  const urgencyConfig: Record<
+    string,
+    { label: string; className: string }
+  > = {
+    baixa: {
+      label: approvalT('urgency.low'),
+      className: 'bg-slate-100 text-slate-700',
+    },
+    media: defaultUrgency,
+    alta: {
+      label: approvalT('urgency.high'),
+      className: 'bg-orange-100 text-orange-700',
+    },
+    critica: {
+      label: approvalT('urgency.critical'),
+      className: 'bg-red-100 text-red-700',
+    },
+  };
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('approvalQueue.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full">
+        <CardHeader className="pb-2">
+          <CardTitle className="flex items-center gap-2 text-base">
+            <ClipboardCheck className="h-4 w-4 text-sky-600" />
+            {t('approvalQueue.title')}
+          </CardTitle>
+          <CardDescription>{t('approvalQueue.description')}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <div className="space-y-2.5">
+            {rows.map((item) => {
+              const urgency =
+                urgencyConfig[String(item.urgencia || 'media').toLowerCase()] ??
+                defaultUrgency;
+
+              return (
+                <Link
+                  key={item.id}
+                  href="/finance/accounts-payable/approvals"
+                  className="flex cursor-pointer items-center justify-between rounded-md border border-border/60 px-3 py-2 transition-colors hover:bg-muted/50 active:bg-muted"
+                >
+                  <div className="min-w-0 pr-3">
+                    <p className="truncate text-sm font-medium text-foreground">
+                      {item.politica || t('approvalQueue.defaultPolicy')}
+                    </p>
+                    <p className="text-[11px] text-muted-foreground">
+                      {formatDate(item.dataSolicitacao)}
+                    </p>
+                  </div>
+                  <div className="flex items-center gap-2">
+                    <div className="text-right text-sm font-medium text-foreground">
+                      <Money value={Number(item.valor || 0)} />
+                    </div>
+                    <Badge className={urgency.className}>{urgency.label}</Badge>
+                  </div>
+                </Link>
+              );
+            })}
+
+            {rows.length === 0 && (
+              <div className="rounded-md border border-dashed border-border/70 px-3 py-5 text-center text-sm text-muted-foreground">
+                {t('approvalQueue.empty')}
+              </div>
+            )}
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/frontend/widgets/pending-reconciliation-kpi.tsx.ejs

@@ -0,0 +1,84 @@
+'use client';
+
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
+import { Card, CardContent } from '@/components/ui/card';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { ArrowLeftRight } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+
+interface PendingReconciliationKpiProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface FinanceData {
+  extratos?: Array<{
+    statusConciliacao?: string | null;
+  }>;
+  contasBancarias?: Array<{
+    ativo?: boolean | null;
+  }>;
+}
+
+const normalize = (value?: string | null) =>
+  String(value || '')
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase();
+
+export default function PendingReconciliationKpi({
+  widget,
+  onRemove,
+}: PendingReconciliationKpiProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-kpi-pending-reconciliation',
+    });
+
+  const pendingCount = (data?.extratos || []).filter((statement) =>
+    normalize(statement?.statusConciliacao).includes('pend')
+  ).length;
+
+  const activeAccounts = (data?.contasBancarias || []).filter(
+    (account) => account?.ativo !== false
+  ).length;
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('kpis.pendingReconciliation.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full overflow-hidden border-border/60 bg-linear-to-br from-background to-violet-50/50 shadow-sm transition-all duration-300 hover:-translate-y-0.5 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-2.5 p-3">
+          <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg bg-violet-100/80">
+            <ArrowLeftRight className="h-4.5 w-4.5 text-violet-600" />
+          </div>
+          <div className="flex min-w-0 flex-1 flex-col justify-center">
+            <span className="truncate text-[9px] font-semibold uppercase tracking-[0.18em] text-muted-foreground">
+              {t('kpis.pendingReconciliation.title')}
+            </span>
+            <div className="flex items-end gap-2">
+              <span className="truncate text-base font-bold leading-none tracking-tight text-foreground sm:text-lg">
+                {pendingCount}
+              </span>
+              <span className="mb-0.5 truncate text-[9px] text-muted-foreground">
+                {t('kpis.pendingReconciliation.countLabel')}
+              </span>
+            </div>
+            <span className="truncate text-[9px] text-muted-foreground">
+              {t('kpis.pendingReconciliation.description', {
+                value: activeAccounts,
+              })}
+            </span>
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

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

@@ -4,7 +4,7 @@ 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';
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
 
 interface Receivable30dKpiProps {
   widget?: { name?: string };
@@ -45,19 +45,19 @@ export default function Receivable30dKpi({
       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" />
+      <Card className="h-full overflow-hidden border-border/60 bg-linear-to-br from-background to-green-50/50 shadow-sm transition-all duration-300 hover:-translate-y-0.5 hover:shadow-md">
+        <CardContent className="flex h-full items-center gap-2.5 p-3">
+          <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg bg-green-100/80">
+            <TrendingUp className="h-4.5 w-4.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">
+          <div className="flex min-w-0 flex-1 flex-col justify-center">
+            <span className="text-[9px] font-semibold uppercase tracking-[0.18em] text-muted-foreground">
               {t('kpis.receivable30.title')}
             </span>
-            <span className="truncate text-lg font-bold tracking-tight text-foreground">
+            <span className="truncate text-base font-bold leading-none tracking-tight text-foreground sm:text-lg">
               {formatted}
             </span>
-            <span className="text-[10px] text-muted-foreground">
+            <span className="truncate text-[9px] text-muted-foreground">
               {t('kpis.receivable30.sevenDays', {
                 value: new Intl.NumberFormat('pt-BR', {
                   style: 'currency',

package/hedhog/frontend/widgets/receivable-aging-analysis.tsx.ejs

@@ -0,0 +1,163 @@
+'use client';
+
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { Money } from '@/components/ui/money';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { BarChart3 } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+
+interface AgingWidgetProps {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+interface AgingItem {
+  bucket0_30?: number | null;
+  bucket31_60?: number | null;
+  bucket61_90?: number | null;
+  bucket90plus?: number | null;
+  total?: number | null;
+}
+
+interface FinanceData {
+  agingInadimplencia?: AgingItem[];
+}
+
+export default function ReceivableAgingAnalysis({
+  widget,
+  onRemove,
+}: AgingWidgetProps) {
+  const t = useTranslations('finance.DashboardPage');
+
+  const { data, isLoading, isAccessDenied, isError } =
+    useWidgetData<FinanceData>({
+      endpoint: '/finance/data',
+      queryKey: 'finance-receivable-aging-analysis',
+    });
+
+  const agingItems = data?.agingInadimplencia || [];
+
+  const totals = {
+    bucket0to30: agingItems.reduce(
+      (acc, item) => acc + Number(item?.bucket0_30 || 0),
+      0
+    ),
+    bucket31to60: agingItems.reduce(
+      (acc, item) => acc + Number(item?.bucket31_60 || 0),
+      0
+    ),
+    bucket61to90: agingItems.reduce(
+      (acc, item) => acc + Number(item?.bucket61_90 || 0),
+      0
+    ),
+    bucket90plus: agingItems.reduce(
+      (acc, item) => acc + Number(item?.bucket90plus || 0),
+      0
+    ),
+    total: agingItems.reduce((acc, item) => acc + Number(item?.total || 0), 0),
+    clients: agingItems.length,
+  };
+
+  const buckets = [
+    {
+      label: t('aging.range0to30'),
+      value: totals.bucket0to30,
+      colorClass: 'bg-amber-400',
+    },
+    {
+      label: t('aging.range31to60'),
+      value: totals.bucket31to60,
+      colorClass: 'bg-orange-400',
+    },
+    {
+      label: t('aging.range61to90'),
+      value: totals.bucket61to90,
+      colorClass: 'bg-rose-400',
+    },
+    {
+      label: t('aging.range90plus'),
+      value: totals.bucket90plus,
+      colorClass: 'bg-red-500',
+    },
+  ];
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('aging.title')}
+      onRemove={onRemove}
+    >
+      <Card className="flex h-full flex-col overflow-hidden">
+        <CardHeader className="pb-1.5">
+          <CardTitle className="flex items-center gap-2 text-sm font-semibold">
+            <BarChart3 className="h-4 w-4 text-rose-500" />
+            {t('aging.title')}
+          </CardTitle>
+          <CardDescription className="line-clamp-1 text-xs">
+            {t('aging.description')}
+          </CardDescription>
+        </CardHeader>
+        <CardContent className="flex flex-1 flex-col gap-2 overflow-hidden pt-0">
+          <div className="grid grid-cols-2 gap-2 rounded-lg bg-muted/40 p-2.5">
+            <div>
+              <p className="text-[10px] uppercase tracking-[0.16em] text-muted-foreground">
+                {t('aging.totalLabel')}
+              </p>
+              <p className="text-sm font-semibold text-foreground sm:text-base">
+                <Money value={totals.total} />
+              </p>
+            </div>
+            <div>
+              <p className="text-[10px] uppercase tracking-[0.16em] text-muted-foreground">
+                {t('aging.clientsLabel')}
+              </p>
+              <p className="text-sm font-semibold text-foreground sm:text-base">
+                {totals.clients}
+              </p>
+            </div>
+          </div>
+
+          <div className="grid min-h-0 grid-cols-2 gap-2">
+            {buckets.map((bucket) => {
+              const percentage =
+                totals.total > 0 ? (bucket.value / totals.total) * 100 : 0;
+
+              return (
+                <div
+                  key={bucket.label}
+                  className="rounded-md border border-border/60 bg-background/70 p-2"
+                >
+                  <div className="mb-1 flex items-start justify-between gap-2">
+                    <span className="text-[11px] leading-4 text-muted-foreground">
+                      {bucket.label}
+                    </span>
+                    <span className="shrink-0 text-[11px] font-medium text-foreground">
+                      <Money value={bucket.value} />
+                    </span>
+                  </div>
+                  <div className="h-1.5 overflow-hidden rounded-full bg-muted">
+                    <div
+                      className={`h-full rounded-full ${bucket.colorClass}`}
+                      style={{
+                        width: `${Math.max(percentage, bucket.value > 0 ? 8 : 0)}%`,
+                      }}
+                    />
+                  </div>
+                </div>
+              );
+            })}
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

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

@@ -13,7 +13,7 @@ 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';
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
 
 interface FinanceData {
   titulosPagar?: Array<{

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

@@ -13,7 +13,7 @@ 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';
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
 
 interface FinanceData {
   titulosReceber?: Array<{

package/hedhog/table/bank_account.yaml

@@ -25,6 +25,13 @@ columns:
   - name: account_type
     type: enum
     values: [checking, savings, investment, cash, other]
+  - name: logo_file_id
+    type: fk
+    isNullable: true
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
   - name: status
     type: enum
     values: [active, inactive]
@@ -34,4 +41,5 @@ columns:
 indices:
   - columns: [code]
     isUnique: true
+  - columns: [logo_file_id]
   - columns: [status]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.299",
+  "version": "0.0.301",
   "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/api-locale": "0.0.14",
     "@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-locale": "0.0.14",
+    "@hed-hog/core": "0.0.301",
     "@hed-hog/api-prisma": "0.0.6",
-    "@hed-hog/api-types": "0.0.1"
+    "@hed-hog/tag": "0.0.301",
+    "@hed-hog/api-types": "0.0.1",
+    "@hed-hog/contact": "0.0.301"
   },
   "exports": {
     ".": {
@@ -32,6 +32,7 @@
   ],
   "scripts": {
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
+    "test": "jest --config jest.config.ts --runInBand",
     "prebuild": "pnpm --dir ../.. exec ts-node ./scripts/build-dependencies.ts libraries/finance",
     "build": "tsc --project tsconfig.production.json",
     "patch": "pnpm exec ts-node ../../scripts/patch.ts libraries/finance",

package/src/dto/create-bank-account.dto.ts

@@ -1,5 +1,5 @@
 import { getLocaleText } from '@hed-hog/api-locale';
-import { IsNumber, IsOptional, IsString, Min } from 'class-validator';
+import { IsInt, IsNumber, IsOptional, IsString, Min } from 'class-validator';
 
 export class CreateBankAccountDto {
   @IsString({
@@ -34,6 +34,12 @@ export class CreateBankAccountDto {
   })
   description?: string;
 
+  @IsOptional()
+  @IsInt({
+    message: (args) => getLocaleText('validation.idMustBeInteger', args.value),
+  })
+  logo_file_id?: number | null;
+
   @IsOptional()
   @IsNumber(
     {},

package/src/dto/update-bank-account.dto.ts

@@ -1,5 +1,5 @@
 import { getLocaleText } from '@hed-hog/api-locale';
-import { IsOptional, IsString } from 'class-validator';
+import { IsInt, IsOptional, IsString } from 'class-validator';
 
 export class UpdateBankAccountDto {
   @IsOptional()
@@ -36,6 +36,12 @@ export class UpdateBankAccountDto {
   })
   description?: string;
 
+  @IsOptional()
+  @IsInt({
+    message: (args) => getLocaleText('validation.idMustBeInteger', args.value),
+  })
+  logo_file_id?: number | null;
+
   @IsOptional()
   @IsString({
     message: (args) =>