@hed-hog/finance 0.0.318 → 0.0.319

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/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/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.319",
   "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-locale": "0.0.14",
-    "@hed-hog/tag": "0.0.318",
+    "@hed-hog/api": "0.0.8",
     "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/contact": "0.0.319",
+    "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/tag": "0.0.319",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/api": "0.0.6",
-    "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/core": "0.0.318"
+    "@hed-hog/core": "0.0.319",
+    "@hed-hog/api-types": "0.0.1"
   },
   "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/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/finance-bank-accounts.controller.ts

@@ -1,4 +1,5 @@
 import { Role, User } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
 import {
   Body,
   Controller,
@@ -19,8 +20,8 @@ export class FinanceBankAccountsController {
   constructor(private readonly financeService: FinanceService) {}
 
   @Get('bank-accounts')
-  async listBankAccounts() {
-    return this.financeService.listBankAccounts();
+  async listBankAccounts(@Pagination() paginationParams: PaginationDTO) {
+    return this.financeService.listBankAccounts(paginationParams);
   }
 
   @Post('bank-accounts')

package/src/finance-installments.controller.ts

@@ -1,6 +1,6 @@
 import { Role, User } from '@hed-hog/api';
 import { Locale } from '@hed-hog/api-locale';
-import { Pagination } from '@hed-hog/api-pagination';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
 import {
     Body,
     Controller,
@@ -30,12 +30,15 @@ export class FinanceInstallmentsController {
 
   @Get('accounts-payable/installments')
   async listAccountsPayableInstallments(
-    @Pagination() paginationParams,
+    @Pagination() paginationParams: PaginationDTO,
     @Query('status') status?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
   ) {
     return this.financeService.listAccountsPayableInstallments(
       paginationParams,
       status,
+      { from, to },
     );
   }
 
@@ -201,12 +204,15 @@ export class FinanceInstallmentsController {
 
   @Get('accounts-receivable/installments')
   async listAccountsReceivableInstallments(
-    @Pagination() paginationParams,
+    @Pagination() paginationParams: PaginationDTO,
     @Query('status') status?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
   ) {
     return this.financeService.listAccountsReceivableInstallments(
       paginationParams,
       status,
+      { from, to },
     );
   }
 

package/src/finance-statements.controller.ts

@@ -1,10 +1,15 @@
 import { Role, User } from '@hed-hog/api';
 import { Locale } from '@hed-hog/api-locale';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
 import {
   BadRequestException,
   Body,
   Controller,
+  Delete,
   Get,
+  Param,
+  ParseIntPipe,
+  Patch,
   Post,
   Query,
   Res,
@@ -15,6 +20,8 @@ import { FileInterceptor } from '@nestjs/platform-express';
 import { Response } from 'express';
 import { CreateBankReconciliationDto } from './dto/create-bank-reconciliation.dto';
 import { CreateBankStatementAdjustmentDto } from './dto/create-bank-statement-adjustment.dto';
+import { CreateBankStatementEntryDto } from './dto/create-bank-statement-entry.dto';
+import { UpdateBankStatementEntryDto } from './dto/update-bank-statement-entry.dto';
 import { FinanceService } from './finance.service';
 
 @Role()
@@ -24,16 +31,21 @@ export class FinanceStatementsController {
 
   @Get('statements')
   async listBankStatements(
+    @Pagination() paginationParams: PaginationDTO,
     @Query('bank_account_id') bankAccountId?: string,
     @Query('search') search?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
   ) {
     const parsedBankAccountId = bankAccountId
       ? Number.parseInt(bankAccountId, 10)
       : undefined;
 
     return this.financeService.listBankStatements(
+      paginationParams,
       Number.isNaN(parsedBankAccountId) ? undefined : parsedBankAccountId,
       search,
+      { from, to },
     );
   }
 
@@ -68,6 +80,8 @@ export class FinanceStatementsController {
     @Query('bank_account_id') bankAccountId: string,
     @Res({ passthrough: true }) response: Response,
     @Query('search') search?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
   ) {
     const parsedBankAccountId = Number.parseInt(bankAccountId, 10);
 
@@ -78,6 +92,7 @@ export class FinanceStatementsController {
     const { csv, fileName } = await this.financeService.exportBankStatementsCsv(
       parsedBankAccountId,
       search,
+      { from, to },
     );
 
     response.setHeader('Content-Type', 'text/csv; charset=utf-8');
@@ -118,4 +133,29 @@ export class FinanceStatementsController {
   ) {
     return this.financeService.createBankStatementAdjustment(data, user?.id);
   }
+
+  @Post('statements')
+  async createBankStatementEntry(
+    @Body() data: CreateBankStatementEntryDto,
+    @User() user,
+  ) {
+    return this.financeService.createBankStatementEntry(data, user?.id);
+  }
+
+  @Patch('statements/:id')
+  async updateBankStatementEntry(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data: UpdateBankStatementEntryDto,
+    @User() user,
+  ) {
+    return this.financeService.updateBankStatementEntry(id, data, user?.id);
+  }
+
+  @Delete('statements/:id')
+  async deleteBankStatementEntry(
+    @Param('id', ParseIntPipe) id: number,
+    @User() user,
+  ) {
+    return this.financeService.deleteBankStatementEntry(id, user?.id);
+  }
 }

package/src/finance-transfers.controller.ts

@@ -1,4 +1,5 @@
 import { Role, User } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
 import { Body, Controller, Get, Post, Query } from '@nestjs/common';
 import { CreateTransferDto } from './dto/create-transfer.dto';
 import { FinanceService } from './finance.service';
@@ -10,12 +11,17 @@ export class FinanceTransfersController {
 
   @Get('transfers')
   async listTransfers(
+    @Pagination() paginationParams: PaginationDTO,
     @Query('search') search?: string,
     @Query('bank_account_id') bankAccountId?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
   ) {
-    return this.financeService.listTransfers({
+    return this.financeService.listTransfers(paginationParams, {
       search,
       bank_account_id: bankAccountId,
+      from,
+      to,
     });
   }