@hed-hog/finance 0.0.318 → 0.0.321

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

@@ -1,8 +1,9 @@
 'use client';
 
 import { FinancePageSection } from '@/app/(app)/(libraries)/finance/_components/finance-layout';
-import { Page, PageHeader } from '@/components/entity-list';
+import { Page, PageHeader, PaginationFooter } from '@/components/entity-list';
 import { Button } from '@/components/ui/button';
+import { DateRangePicker } from '@/components/ui/date-range-picker';
 import { FilterBar } from '@/components/ui/filter-bar';
 import {
   Form,
@@ -68,6 +69,19 @@ type Transfer = {
   descricao: string;
 };
 
+type PaginatedTransfersResponse = {
+  data: Transfer[];
+  total: number;
+  page: number;
+  pageSize: number;
+  prev: number | null;
+  next: number | null;
+  lastPage: number;
+  summary?: {
+    totalTransferido?: number;
+  };
+};
+
 type TransferDraftPayload = {
   values: TransferFormValues;
 };
@@ -244,7 +258,7 @@ function NovaTransferenciaSheet({
                   <FormLabel>{t('fields.sourceAccount')}</FormLabel>
                   <Select value={field.value} onValueChange={field.onChange}>
                     <FormControl>
-                      <SelectTrigger>
+                      <SelectTrigger className="w-full">
                         <SelectValue placeholder={t('common.select')} />
                       </SelectTrigger>
                     </FormControl>
@@ -269,7 +283,7 @@ function NovaTransferenciaSheet({
                   <FormLabel>{t('fields.destinationAccount')}</FormLabel>
                   <Select value={field.value} onValueChange={field.onChange}>
                     <FormControl>
-                      <SelectTrigger>
+                      <SelectTrigger className="w-full">
                         <SelectValue placeholder={t('common.select')} />
                       </SelectTrigger>
                     </FormControl>
@@ -373,6 +387,10 @@ export default function TransferenciasPage() {
   const [search, setSearch] = useState('');
   const [debouncedSearch, setDebouncedSearch] = useState('');
   const [accountFilter, setAccountFilter] = useState('all');
+  const [fromDate, setFromDate] = useState('');
+  const [toDate, setToDate] = useState('');
+  const [page, setPage] = useState(1);
+  const pageSize = 10;
 
   useEffect(() => {
     const timeoutId = window.setTimeout(() => {
@@ -391,48 +409,98 @@ export default function TransferenciasPage() {
         const response = await request({
           url: '/finance/bank-accounts',
           method: 'GET',
+          params: {
+            page: 1,
+            pageSize: 100,
+          },
         });
 
-        return (response?.data || []) as BankAccount[];
+        const payload = response?.data as
+          | { data?: BankAccount[] }
+          | BankAccount[]
+          | undefined;
+
+        return (
+          Array.isArray(payload) ? payload : payload?.data || []
+        ) as BankAccount[];
       },
     });
 
-  const { data: transferencias = [], refetch: refetchTransferencias } =
-    useQuery<Transfer[]>({
-      queryKey: ['finance-transfers', debouncedSearch, accountFilter],
+  const { data: transferenciasResponse, refetch: refetchTransferencias } =
+    useQuery<PaginatedTransfersResponse>({
+      queryKey: [
+        'finance-transfers',
+        debouncedSearch,
+        accountFilter,
+        fromDate,
+        toDate,
+        page,
+        pageSize,
+      ],
       queryFn: async () => {
-        const params = new URLSearchParams();
+        const params: Record<string, string | number> = {
+          page,
+          pageSize,
+        };
 
         const trimmedSearch = debouncedSearch.trim();
         if (trimmedSearch) {
-          params.set('search', trimmedSearch);
+          params.search = trimmedSearch;
         }
 
         if (accountFilter !== 'all') {
-          params.set('bank_account_id', accountFilter);
+          params.bank_account_id = accountFilter;
+        }
+
+        if (fromDate) {
+          params.from = fromDate;
+        }
+
+        if (toDate) {
+          params.to = toDate;
         }
 
-        const query = params.toString();
         const response = await request({
-          url: query ? `/finance/transfers?${query}` : '/finance/transfers',
+          url: '/finance/transfers',
           method: 'GET',
+          params,
         });
 
-        return (response?.data || []) as Transfer[];
+        return (response?.data || {
+          data: [],
+          total: 0,
+          page,
+          pageSize,
+          prev: null,
+          next: null,
+          lastPage: 1,
+          summary: {
+            totalTransferido: 0,
+          },
+        }) as PaginatedTransfersResponse;
       },
+      placeholderData: (old) => old,
     });
 
+  useEffect(() => {
+    setPage(1);
+  }, [debouncedSearch, accountFilter, fromDate, toDate]);
+
   const handleTransferCreated = async () => {
     await Promise.all([refetchTransferencias(), refetchContasBancarias()]);
   };
 
-  const totalTransferido = transferencias.reduce((acc, t) => acc + t.valor, 0);
+  const transferencias = transferenciasResponse?.data ?? [];
+  const totalTransferencias = transferenciasResponse?.total ?? 0;
+  const totalTransferido =
+    transferenciasResponse?.summary?.totalTransferido ??
+    transferencias.reduce((acc, transfer) => acc + transfer.valor, 0);
   const summaryCards = [
     {
       key: 'transferred',
       title: t('cards.totalTransferred'),
       value: <Money value={totalTransferido} />,
-      description: t('cards.transferCount', { count: transferencias.length }),
+      description: t('cards.transferCount', { count: totalTransferencias }),
       icon: ArrowRight,
       layout: 'compact' as const,
       iconContainerClassName: 'bg-blue-500/10 text-blue-700',
@@ -488,6 +556,14 @@ export default function TransferenciasPage() {
             onSearchChange={setSearch}
           />
         </div>
+
+        <DateRangePicker
+          fromDate={fromDate}
+          toDate={toDate}
+          onFromDateChange={setFromDate}
+          onToDateChange={setToDate}
+          defaultPreset="thisMonth"
+        />
       </div>
 
       <KpiCardsGrid items={summaryCards} columns={2} />
@@ -550,6 +626,16 @@ export default function TransferenciasPage() {
             </TableBody>
           </Table>
         </div>
+        <div className="border-t border-border/50 px-4 py-4 sm:px-6">
+          <PaginationFooter
+            currentPage={page}
+            pageSize={pageSize}
+            totalItems={totalTransferencias}
+            onPageChange={setPage}
+            onPageSizeChange={() => undefined}
+            pageSizeOptions={[10]}
+          />
+        </div>
       </FinancePageSection>
     </Page>
   );

package/hedhog/frontend/messages/en.json

@@ -1868,5 +1868,63 @@
       },
       "empty": "No expenses found for selected filters"
     }
+  },
+  "AdminCurrenciesPage": {
+    "common": {
+      "cancel": "Cancel",
+      "save": "Save"
+    },
+    "messages": {
+      "createSuccess": "Currency created successfully",
+      "createError": "Error creating currency",
+      "updateSuccess": "Currency updated successfully",
+      "updateError": "Error updating currency",
+      "deleteSuccess": "Currency deactivated successfully",
+      "deleteError": "Error deactivating currency"
+    },
+    "header": {
+      "title": "Currencies",
+      "description": "Manage currencies used in bank accounts and financial transactions"
+    },
+    "breadcrumbs": {
+      "finance": "Finance",
+      "administration": "Administration",
+      "current": "Currencies"
+    },
+    "actions": {
+      "newCurrency": "New currency"
+    },
+    "sheet": {
+      "newTitle": "New currency",
+      "editTitle": "Edit currency",
+      "newDescription": "Register a new currency with its ISO code and symbol.",
+      "editDescription": "Update the currency information.",
+      "fields": {
+        "code": "ISO Code",
+        "codePlaceholder": "Ex.: BRL",
+        "name": "Name",
+        "namePlaceholder": "Ex.: Brazilian Real",
+        "symbol": "Symbol",
+        "symbolPlaceholder": "Ex.: R$"
+      },
+      "validation": {
+        "codeRequired": "ISO code is required",
+        "codeMaxLength": "ISO code must have at most 3 characters",
+        "nameRequired": "Name is required",
+        "symbolRequired": "Symbol is required"
+      }
+    },
+    "table": {
+      "empty": "No currencies found.",
+      "status": {
+        "active": "Active",
+        "inactive": "Inactive"
+      }
+    },
+    "deleteDialog": {
+      "title": "Deactivate currency",
+      "description": "Do you really want to deactivate this currency?",
+      "confirm": "Deactivate"
+    }
   }
 }

package/hedhog/frontend/messages/pt.json

@@ -1868,5 +1868,63 @@
       },
       "empty": "Nenhum gasto encontrado para os filtros selecionados"
     }
+  },
+  "AdminCurrenciesPage": {
+    "common": {
+      "cancel": "Cancelar",
+      "save": "Salvar"
+    },
+    "messages": {
+      "createSuccess": "Moeda cadastrada com sucesso",
+      "createError": "Erro ao cadastrar moeda",
+      "updateSuccess": "Moeda atualizada com sucesso",
+      "updateError": "Erro ao atualizar moeda",
+      "deleteSuccess": "Moeda inativada com sucesso",
+      "deleteError": "Erro ao inativar moeda"
+    },
+    "header": {
+      "title": "Moedas",
+      "description": "Gerencie as moedas utilizadas em contas bancárias e transações financeiras"
+    },
+    "breadcrumbs": {
+      "finance": "Financeiro",
+      "administration": "Administração",
+      "current": "Moedas"
+    },
+    "actions": {
+      "newCurrency": "Nova moeda"
+    },
+    "sheet": {
+      "newTitle": "Nova moeda",
+      "editTitle": "Editar moeda",
+      "newDescription": "Cadastre uma nova moeda com seu código ISO e símbolo.",
+      "editDescription": "Atualize as informações da moeda.",
+      "fields": {
+        "code": "Código ISO",
+        "codePlaceholder": "Ex.: BRL",
+        "name": "Nome",
+        "namePlaceholder": "Ex.: Real Brasileiro",
+        "symbol": "Símbolo",
+        "symbolPlaceholder": "Ex.: R$"
+      },
+      "validation": {
+        "codeRequired": "Código ISO é obrigatório",
+        "codeMaxLength": "Código ISO deve ter no máximo 3 caracteres",
+        "nameRequired": "Nome é obrigatório",
+        "symbolRequired": "Símbolo é obrigatório"
+      }
+    },
+    "table": {
+      "empty": "Nenhuma moeda encontrada.",
+      "status": {
+        "active": "Ativa",
+        "inactive": "Inativa"
+      }
+    },
+    "deleteDialog": {
+      "title": "Inativar moeda",
+      "description": "Deseja realmente inativar esta moeda?",
+      "confirm": "Inativar"
+    }
   }
 }

package/hedhog/table/bank_account.yaml

@@ -22,6 +22,13 @@ columns:
     type: varchar
     length: 34
     isNullable: true
+  - name: currency_id
+    type: fk
+    isNullable: true
+    references:
+      table: currency
+      column: id
+      onDelete: SET NULL
   - name: account_type
     type: enum
     values: [checking, savings, investment, cash, other]
@@ -42,4 +49,5 @@ indices:
   - columns: [code]
     isUnique: true
   - columns: [logo_file_id]
+  - columns: [currency_id]
   - columns: [status]

package/hedhog/table/bank_statement_line.yaml

@@ -21,7 +21,7 @@ columns:
   - name: posted_date
     type: datetime
   - name: amount_cents
-    type: int
+    type: bigint
   - name: description
     type: text
   - name: status

package/hedhog/table/cashflow_projection.yaml

@@ -13,7 +13,7 @@ columns:
     type: enum
     values: [inflow, outflow, net]
   - name: amount_cents
-    type: int
+    type: bigint
   - name: notes
     type: text
     isNullable: true

package/hedhog/table/currency.yaml

@@ -0,0 +1,21 @@
+columns:
+  - type: pk
+  - name: code
+    type: varchar
+    length: 3
+  - name: name
+    type: varchar
+    length: 100
+  - name: symbol
+    type: varchar
+    length: 10
+  - name: status
+    type: enum
+    values: [active, inactive]
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [code]
+    isUnique: true
+  - columns: [status]

package/hedhog/table/financial_installment.yaml

@@ -14,9 +14,9 @@ columns:
   - name: due_date
     type: datetime
   - name: amount_cents
-    type: int
+    type: bigint
   - name: open_amount_cents
-    type: int
+    type: bigint
   - name: status
     type: enum
     values: [open, partial, settled, canceled, overdue]

package/hedhog/table/financial_title.yaml

@@ -27,7 +27,7 @@ columns:
     type: datetime
     isNullable: true
   - name: total_amount_cents
-    type: int
+    type: bigint
   - name: finance_category_id
     type: fk
     isNullable: true

package/hedhog/table/installment_allocation.yaml

@@ -15,7 +15,7 @@ columns:
       onDelete: RESTRICT
       onUpdate: CASCADE
   - name: allocated_amount_cents
-    type: int
+    type: bigint
   - type: created_at
   - type: updated_at
 

package/hedhog/table/receivable_schedule.yaml

@@ -18,7 +18,7 @@ columns:
   - name: expected_date
     type: datetime
   - name: amount_cents
-    type: int
+    type: bigint
   - name: description
     type: text
     isNullable: true

package/hedhog/table/settlement.yaml

@@ -37,7 +37,7 @@ columns:
   - name: settled_at
     type: datetime
   - name: amount_cents
-    type: int
+    type: bigint
   - name: description
     type: text
     isNullable: true

package/hedhog/table/settlement_allocation.yaml

@@ -15,18 +15,18 @@ columns:
       onDelete: RESTRICT
       onUpdate: CASCADE
   - name: allocated_amount_cents
-    type: int
+    type: bigint
   - name: amount_cents
-    type: int
+    type: bigint
     isNullable: true
   - name: discount_cents
-    type: int
+    type: bigint
     default: 0
   - name: interest_cents
-    type: int
+    type: bigint
     default: 0
   - name: penalty_cents
-    type: int
+    type: bigint
     default: 0
   - type: created_at
   - type: updated_at

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.318",
+  "version": "0.0.321",
   "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/contact": "0.0.318",
+    "@hed-hog/api": "0.0.8",
     "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/tag": "0.0.318",
-    "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/contact": "0.0.321",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/api": "0.0.6",
+    "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/core": "0.0.318"
+    "@hed-hog/tag": "0.0.321",
+    "@hed-hog/core": "0.0.321"
   },
   "exports": {
     ".": {

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

@@ -1,5 +1,12 @@
 import { getLocaleText } from '@hed-hog/api-locale';
-import { IsInt, IsNumber, IsOptional, IsString, Min } from 'class-validator';
+import {
+  IsDateString,
+  IsInt,
+  IsNumber,
+  IsOptional,
+  IsString,
+  Min,
+} from 'class-validator';
 
 export class CreateBankAccountDto {
   @IsString({
@@ -52,4 +59,14 @@ export class CreateBankAccountDto {
     message: (args) => getLocaleText('validation.initialBalanceMin', args.value),
   })
   initial_balance?: number;
+
+  @IsOptional()
+  @IsDateString(
+    {},
+    {
+      message: (args) =>
+        getLocaleText('validation.dateMustBeDateString', args.value),
+    },
+  )
+  start_date?: string;
 }

package/src/dto/create-bank-statement-entry.dto.ts

@@ -0,0 +1,50 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import {
+  IsDateString,
+  IsIn,
+  IsInt,
+  IsNumber,
+  IsString,
+  Min,
+} from 'class-validator';
+
+export class CreateBankStatementEntryDto {
+  @IsInt({
+    message: (args) => getLocaleText('validation.idMustBeInteger', args.value),
+  })
+  bank_account_id: number;
+
+  @IsDateString(
+    {},
+    {
+      message: (args) =>
+        getLocaleText('validation.dateMustBeDateString', args.value),
+    },
+  )
+  date: string;
+
+  @IsString({
+    message: (args) =>
+      getLocaleText('validation.descriptionMustBeString', args.value),
+  })
+  description: string;
+
+  @IsNumber(
+    {},
+    {
+      message: (args) => getLocaleText('validation.amountMustBeNumber', args.value),
+    },
+  )
+  @Min(0.01, {
+    message: (args) => getLocaleText('validation.amountGreaterThanZero', args.value),
+  })
+  amount: number;
+
+  @IsString({
+    message: (args) => getLocaleText('validation.typeMustBeString', args.value),
+  })
+  @IsIn(['entrada', 'saida'], {
+    message: (args) => getLocaleText('validation.typeIsNotValid', args.value),
+  })
+  type: 'entrada' | 'saida';
+}

package/src/dto/create-currency.dto.ts

@@ -0,0 +1,21 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsString, Length } from 'class-validator';
+
+export class CreateCurrencyDto {
+  @IsString({
+    message: (args) => getLocaleText('validation.codeMustBeString', args.value),
+  })
+  @Length(1, 3)
+  code: string;
+
+  @IsString({
+    message: (args) => getLocaleText('validation.nameMustBeString', args.value),
+  })
+  name: string;
+
+  @IsString({
+    message: (args) =>
+      getLocaleText('validation.symbolMustBeString', args.value),
+  })
+  symbol: string;
+}

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

@@ -1,5 +1,5 @@
 import { getLocaleText } from '@hed-hog/api-locale';
-import { IsInt, IsOptional, IsString } from 'class-validator';
+import { IsDateString, IsInt, IsOptional, IsString } from 'class-validator';
 
 export class UpdateBankAccountDto {
   @IsOptional()
@@ -48,4 +48,14 @@ export class UpdateBankAccountDto {
       getLocaleText('validation.statusMustBeString', args.value),
   })
   status?: 'active' | 'inactive';
+
+  @IsOptional()
+  @IsDateString(
+    {},
+    {
+      message: (args) =>
+        getLocaleText('validation.dateMustBeDateString', args.value),
+    },
+  )
+  start_date?: string;
 }

package/src/dto/update-bank-statement-entry.dto.ts

@@ -0,0 +1,31 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsDateString, IsNumber, IsOptional, IsString, Min } from 'class-validator';
+
+export class UpdateBankStatementEntryDto {
+  @IsOptional()
+  @IsNumber(
+    {},
+    {
+      message: (args) => getLocaleText('validation.amountMustBeNumber', args.value),
+    },
+  )
+  @Min(0.01, {
+    message: (args) => getLocaleText('validation.amountGreaterThanZero', args.value),
+  })
+  amount?: number;
+
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.descriptionMustBeString', args.value),
+  })
+  description?: string;
+
+  @IsOptional()
+  @IsDateString(
+    {},
+    {
+      message: (args) => getLocaleText('validation.dateMustBeDateString', args.value),
+    },
+  )
+  date?: string;
+}

package/src/dto/update-currency.dto.ts

@@ -0,0 +1,31 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsOptional, IsString, Length } from 'class-validator';
+
+export class UpdateCurrencyDto {
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.codeMustBeString', args.value),
+  })
+  @Length(1, 3)
+  code?: string;
+
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.nameMustBeString', args.value),
+  })
+  name?: string;
+
+  @IsOptional()
+  @IsString({
+    message: (args) =>
+      getLocaleText('validation.symbolMustBeString', args.value),
+  })
+  symbol?: string;
+
+  @IsOptional()
+  @IsString({
+    message: (args) =>
+      getLocaleText('validation.statusMustBeString', args.value),
+  })
+  status?: 'active' | 'inactive';
+}