@hed-hog/finance 0.0.235 → 0.0.237

package/hedhog/frontend/messages/en.json

@@ -663,6 +663,231 @@
       }
     }
   },
+  "AdminAuditLogsPage": {
+    "header": {
+      "title": "Audit and Logs",
+      "description": "Track actions and authorship of financial records"
+    },
+    "breadcrumbs": {
+      "finance": "Finance",
+      "administration": "Administration",
+      "current": "Audit and Logs"
+    },
+    "card": {
+      "title": "Audit logs",
+      "description": "Text search and filters by action, entity, author, and period."
+    },
+    "filters": {
+      "searchPlaceholder": "Search by action, entity, summary, id or IP",
+      "action": "Action",
+      "allActions": "All actions",
+      "userPlaceholder": "Author (User ID)",
+      "entity": "Entity",
+      "allEntities": "All entities",
+      "clear": "Clear filters"
+    },
+    "table": {
+      "headers": {
+        "date": "Date",
+        "author": "Author",
+        "action": "Action",
+        "entity": "Entity",
+        "record": "Record",
+        "summary": "Summary"
+      },
+      "loading": "Loading logs...",
+      "empty": "No logs found."
+    }
+  },
+  "AdminCategoriesPage": {
+    "common": {
+      "select": "Select",
+      "cancel": "Cancel",
+      "save": "Save"
+    },
+    "messages": {
+      "createSuccess": "Category created successfully",
+      "updateSuccess": "Category updated successfully",
+      "saveError": "Error saving category",
+      "deleteSuccess": "Category deactivated successfully",
+      "deleteError": "Error deactivating category",
+      "moveSuccess": "Category moved successfully",
+      "moveError": "Error moving category"
+    },
+    "header": {
+      "title": "Financial Categories",
+      "description": "Manage categories and subcategories in a tree"
+    },
+    "breadcrumbs": {
+      "finance": "Finance",
+      "administration": "Administration",
+      "current": "Categories"
+    },
+    "card": {
+      "title": "Category structure",
+      "description": "Drag to reorder and move between tree levels."
+    },
+    "actions": {
+      "newCategory": "New category"
+    },
+    "sheet": {
+      "newTitle": "New category",
+      "editTitle": "Edit category",
+      "description": "Organize financial categories and subcategories.",
+      "fields": {
+        "name": "Name",
+        "namePlaceholder": "Ex.: Marketing",
+        "kind": "Kind",
+        "parent": "Parent category",
+        "noParent": "No parent category",
+        "noneRoot": "None (root)"
+      },
+      "validation": {
+        "nameRequired": "Name is required",
+        "kindRequired": "Kind is required"
+      }
+    },
+    "natureOptions": {
+      "receita": "Revenue",
+      "despesa": "Expense",
+      "transferencia": "Transfer",
+      "ajuste": "Adjustment",
+      "outro": "Other"
+    },
+    "table": {
+      "empty": "No categories found.",
+      "status": {
+        "active": "Active",
+        "inactive": "Inactive"
+      }
+    },
+    "deleteDialog": {
+      "title": "Deactivate category",
+      "description": "Do you really want to deactivate this financial category?",
+      "confirm": "Deactivate"
+    }
+  },
+  "AdminCostCentersPage": {
+    "common": {
+      "cancel": "Cancel",
+      "save": "Save"
+    },
+    "messages": {
+      "createSuccess": "Cost center created successfully",
+      "createError": "Error creating cost center",
+      "updateSuccess": "Cost center updated successfully",
+      "updateError": "Error updating cost center",
+      "deleteSuccess": "Cost center deactivated successfully",
+      "deleteError": "Error deactivating cost center"
+    },
+    "header": {
+      "title": "Cost Centers",
+      "description": "Create and maintain finance cost centers"
+    },
+    "breadcrumbs": {
+      "finance": "Finance",
+      "administration": "Administration",
+      "current": "Cost Centers"
+    },
+    "card": {
+      "title": "Cost centers list",
+      "description": "Manage centers used in financial entries."
+    },
+    "actions": {
+      "newCostCenter": "New cost center"
+    },
+    "sheet": {
+      "newTitle": "New cost center",
+      "editTitle": "Edit cost center",
+      "newDescription": "Create a new cost center for financial classification.",
+      "editDescription": "Update the cost center information.",
+      "fields": {
+        "name": "Name",
+        "namePlaceholder": "Ex.: Administrative"
+      },
+      "validation": {
+        "nameRequired": "Name is required"
+      }
+    },
+    "table": {
+      "empty": "No cost centers found.",
+      "code": "Code: {code}",
+      "status": {
+        "active": "Active",
+        "inactive": "Inactive"
+      }
+    },
+    "deleteDialog": {
+      "title": "Deactivate cost center",
+      "description": "Do you really want to deactivate this cost center?",
+      "confirm": "Deactivate"
+    }
+  },
+  "AdminPeriodClosePage": {
+    "common": {
+      "select": "Select",
+      "cancel": "Cancel",
+      "save": "Save"
+    },
+    "messages": {
+      "createSuccess": "Period closed successfully",
+      "createError": "Error closing period"
+    },
+    "status": {
+      "closed": "Closed",
+      "open": "Open"
+    },
+    "header": {
+      "title": "Period Close",
+      "description": "View closed periods, authorship, and close new periods"
+    },
+    "breadcrumbs": {
+      "finance": "Finance",
+      "administration": "Administration",
+      "current": "Period Close"
+    },
+    "card": {
+      "title": "Financial periods",
+      "description": "Search by dates, user, and track who performed each close."
+    },
+    "actions": {
+      "new": "Close period"
+    },
+    "sheet": {
+      "title": "Close new period",
+      "description": "Provide the interval and confirm the financial period close.",
+      "fields": {
+        "startDate": "Start date",
+        "endDate": "End date",
+        "status": "Status",
+        "notes": "Notes",
+        "notesPlaceholder": "Ex.: Monthly finance close"
+      },
+      "validation": {
+        "startRequired": "Start date is required",
+        "endRequired": "End date is required"
+      }
+    },
+    "filters": {
+      "searchPlaceholder": "Search in notes, user or email",
+      "status": "Status",
+      "allStatus": "All statuses",
+      "userPlaceholder": "User (name, email or ID)",
+      "clear": "Clear filters"
+    },
+    "table": {
+      "headers": {
+        "start": "Start period",
+        "end": "End period",
+        "status": "Status",
+        "closedBy": "Closed by",
+        "closedAt": "Close date",
+        "notes": "Notes"
+      },
+      "loading": "Loading periods...",
+      "empty": "No periods found."
+    }
+  },
   "CashFlowForecastPage": {
     "header": {
       "title": "Cash Flow Forecast",

package/hedhog/frontend/messages/pt.json

@@ -663,6 +663,231 @@
       }
     }
   },
+  "AdminAuditLogsPage": {
+    "header": {
+      "title": "Auditoria e Logs",
+      "description": "Acompanhe ações e autoria dos registros financeiros"
+    },
+    "breadcrumbs": {
+      "finance": "Financeiro",
+      "administration": "Administração",
+      "current": "Auditoria e Logs"
+    },
+    "card": {
+      "title": "Logs de auditoria",
+      "description": "Busca textual, filtros por ação, entidade, autor e período."
+    },
+    "filters": {
+      "searchPlaceholder": "Buscar por ação, entidade, resumo, id ou IP",
+      "action": "Ação",
+      "allActions": "Todas as ações",
+      "userPlaceholder": "Autor (ID do usuário)",
+      "entity": "Entidade",
+      "allEntities": "Todas as entidades",
+      "clear": "Limpar filtros"
+    },
+    "table": {
+      "headers": {
+        "date": "Data",
+        "author": "Autor",
+        "action": "Ação",
+        "entity": "Entidade",
+        "record": "Registro",
+        "summary": "Resumo"
+      },
+      "loading": "Carregando logs...",
+      "empty": "Nenhum log encontrado."
+    }
+  },
+  "AdminCategoriesPage": {
+    "common": {
+      "select": "Selecione",
+      "cancel": "Cancelar",
+      "save": "Salvar"
+    },
+    "messages": {
+      "createSuccess": "Categoria criada com sucesso",
+      "updateSuccess": "Categoria atualizada com sucesso",
+      "saveError": "Erro ao salvar categoria",
+      "deleteSuccess": "Categoria inativada com sucesso",
+      "deleteError": "Erro ao inativar categoria",
+      "moveSuccess": "Categoria movida com sucesso",
+      "moveError": "Erro ao mover categoria"
+    },
+    "header": {
+      "title": "Categorias Financeiras",
+      "description": "Gerencie categorias e subcategorias em árvore"
+    },
+    "breadcrumbs": {
+      "finance": "Financeiro",
+      "administration": "Administração",
+      "current": "Categorias"
+    },
+    "card": {
+      "title": "Estrutura de categorias",
+      "description": "Arraste para reordenar e para mover entre níveis da árvore."
+    },
+    "actions": {
+      "newCategory": "Nova categoria"
+    },
+    "sheet": {
+      "newTitle": "Nova categoria",
+      "editTitle": "Editar categoria",
+      "description": "Organize categorias e subcategorias financeiras.",
+      "fields": {
+        "name": "Nome",
+        "namePlaceholder": "Ex.: Marketing",
+        "kind": "Natureza",
+        "parent": "Categoria pai",
+        "noParent": "Sem categoria pai",
+        "noneRoot": "Nenhuma (raiz)"
+      },
+      "validation": {
+        "nameRequired": "Nome é obrigatório",
+        "kindRequired": "Natureza é obrigatória"
+      }
+    },
+    "natureOptions": {
+      "receita": "Receita",
+      "despesa": "Despesa",
+      "transferencia": "Transferência",
+      "ajuste": "Ajuste",
+      "outro": "Outro"
+    },
+    "table": {
+      "empty": "Nenhuma categoria encontrada.",
+      "status": {
+        "active": "Ativa",
+        "inactive": "Inativa"
+      }
+    },
+    "deleteDialog": {
+      "title": "Inativar categoria",
+      "description": "Deseja realmente inativar esta categoria financeira?",
+      "confirm": "Inativar"
+    }
+  },
+  "AdminCostCentersPage": {
+    "common": {
+      "cancel": "Cancelar",
+      "save": "Salvar"
+    },
+    "messages": {
+      "createSuccess": "Centro de custo cadastrado com sucesso",
+      "createError": "Erro ao cadastrar centro de custo",
+      "updateSuccess": "Centro de custo atualizado com sucesso",
+      "updateError": "Erro ao atualizar centro de custo",
+      "deleteSuccess": "Centro de custo inativado com sucesso",
+      "deleteError": "Erro ao inativar centro de custo"
+    },
+    "header": {
+      "title": "Centros de Custo",
+      "description": "Cadastre e mantenha os centros de custo do financeiro"
+    },
+    "breadcrumbs": {
+      "finance": "Financeiro",
+      "administration": "Administração",
+      "current": "Centros de Custo"
+    },
+    "card": {
+      "title": "Lista de centros de custo",
+      "description": "Gerencie os centros utilizados nos lançamentos financeiros."
+    },
+    "actions": {
+      "newCostCenter": "Novo centro de custo"
+    },
+    "sheet": {
+      "newTitle": "Novo centro de custo",
+      "editTitle": "Editar centro de custo",
+      "newDescription": "Cadastre um novo centro de custo para classificação financeira.",
+      "editDescription": "Atualize as informações do centro de custo.",
+      "fields": {
+        "name": "Nome",
+        "namePlaceholder": "Ex.: Administrativo"
+      },
+      "validation": {
+        "nameRequired": "Nome é obrigatório"
+      }
+    },
+    "table": {
+      "empty": "Nenhum centro de custo encontrado.",
+      "code": "Código: {code}",
+      "status": {
+        "active": "Ativo",
+        "inactive": "Inativo"
+      }
+    },
+    "deleteDialog": {
+      "title": "Inativar centro de custo",
+      "description": "Deseja realmente inativar este centro de custo?",
+      "confirm": "Inativar"
+    }
+  },
+  "AdminPeriodClosePage": {
+    "common": {
+      "select": "Selecione",
+      "cancel": "Cancelar",
+      "save": "Salvar"
+    },
+    "messages": {
+      "createSuccess": "Período fechado com sucesso",
+      "createError": "Erro ao fechar período"
+    },
+    "status": {
+      "closed": "Fechado",
+      "open": "Aberto"
+    },
+    "header": {
+      "title": "Fechamento de Período",
+      "description": "Visualize períodos fechados, autoria e feche novos períodos"
+    },
+    "breadcrumbs": {
+      "finance": "Financeiro",
+      "administration": "Administração",
+      "current": "Fechamento de Período"
+    },
+    "card": {
+      "title": "Períodos financeiros",
+      "description": "Pesquise por datas, usuário e acompanhe quem realizou cada fechamento."
+    },
+    "actions": {
+      "new": "Fechar período"
+    },
+    "sheet": {
+      "title": "Fechar novo período",
+      "description": "Informe o intervalo e confirme o fechamento do período financeiro.",
+      "fields": {
+        "startDate": "Data inicial",
+        "endDate": "Data final",
+        "status": "Status",
+        "notes": "Observações",
+        "notesPlaceholder": "Ex.: Fechamento mensal do financeiro"
+      },
+      "validation": {
+        "startRequired": "Data inicial é obrigatória",
+        "endRequired": "Data final é obrigatória"
+      }
+    },
+    "filters": {
+      "searchPlaceholder": "Buscar em observações, usuário ou e-mail",
+      "status": "Status",
+      "allStatus": "Todos os status",
+      "userPlaceholder": "Usuário (nome, e-mail ou ID)",
+      "clear": "Limpar filtros"
+    },
+    "table": {
+      "headers": {
+        "start": "Período inicial",
+        "end": "Período final",
+        "status": "Status",
+        "closedBy": "Fechado por",
+        "closedAt": "Data do fechamento",
+        "notes": "Observações"
+      },
+      "loading": "Carregando períodos...",
+      "empty": "Nenhum período encontrado."
+    }
+  },
   "CashFlowForecastPage": {
     "header": {
       "title": "Fluxo de Caixa Previsto",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.235",
+  "version": "0.0.237",
   "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/api-locale": "0.0.11",
     "@hed-hog/api-prisma": "0.0.4",
+    "@hed-hog/tag": "0.0.237",
     "@hed-hog/api-pagination": "0.0.5",
-    "@hed-hog/tag": "0.0.235",
     "@hed-hog/api-types": "0.0.1",
     "@hed-hog/api": "0.0.3",
-    "@hed-hog/contact": "0.0.235",
-    "@hed-hog/core": "0.0.235"
+    "@hed-hog/contact": "0.0.237",
+    "@hed-hog/core": "0.0.237",
+    "@hed-hog/api-locale": "0.0.11"
   },
   "exports": {
     ".": {

package/src/dto/create-cost-center.dto.ts

@@ -0,0 +1,9 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsString } from 'class-validator';
+
+export class CreateCostCenterDto {
+  @IsString({
+    message: (args) => getLocaleText('validation.nameMustBeString', args.value),
+  })
+  name: string;
+}

package/src/dto/create-finance-category.dto.ts

@@ -0,0 +1,21 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsInt, IsOptional, IsString } from 'class-validator';
+
+export class CreateFinanceCategoryDto {
+  @IsString({
+    message: (args) => getLocaleText('validation.nameMustBeString', args.value),
+  })
+  name: string;
+
+  @IsString({
+    message: (args) => getLocaleText('validation.kindMustBeString', args.value),
+  })
+  kind: string;
+
+  @IsOptional()
+  @IsInt({
+    message: (args) =>
+      getLocaleText('validation.parentIdMustBeNumber', args.value),
+  })
+  parent_id?: number;
+}

package/src/dto/create-period-close.dto.ts

@@ -0,0 +1,34 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsDateString, IsOptional, IsString } from 'class-validator';
+
+export class CreatePeriodCloseDto {
+  @IsDateString(
+    {},
+    {
+      message: (args) =>
+        getLocaleText('validation.periodStartMustBeDate', args.value),
+    },
+  )
+  period_start: string;
+
+  @IsDateString(
+    {},
+    {
+      message: (args) =>
+        getLocaleText('validation.periodEndMustBeDate', args.value),
+    },
+  )
+  period_end: string;
+
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.notesMustBeString', args.value),
+  })
+  notes?: string;
+
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.statusMustBeString', args.value),
+  })
+  status?: 'open' | 'closed';
+}

package/src/dto/move-finance-category.dto.ts

@@ -0,0 +1,18 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsInt, IsOptional } from 'class-validator';
+
+export class MoveFinanceCategoryDto {
+  @IsOptional()
+  @IsInt({
+    message: (args) =>
+      getLocaleText('validation.parentIdMustBeNumber', args.value),
+  })
+  parent_id?: number;
+
+  @IsOptional()
+  @IsInt({
+    message: (args) =>
+      getLocaleText('validation.positionMustBeNumber', args.value),
+  })
+  position?: number;
+}

package/src/dto/update-cost-center.dto.ts

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

package/src/dto/update-finance-category.dto.ts

@@ -0,0 +1,30 @@
+import { getLocaleText } from '@hed-hog/api-locale';
+import { IsInt, IsOptional, IsString } from 'class-validator';
+
+export class UpdateFinanceCategoryDto {
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.nameMustBeString', args.value),
+  })
+  name?: string;
+
+  @IsOptional()
+  @IsString({
+    message: (args) => getLocaleText('validation.kindMustBeString', args.value),
+  })
+  kind?: string;
+
+  @IsOptional()
+  @IsInt({
+    message: (args) =>
+      getLocaleText('validation.parentIdMustBeNumber', args.value),
+  })
+  parent_id?: number;
+
+  @IsOptional()
+  @IsString({
+    message: (args) =>
+      getLocaleText('validation.statusMustBeString', args.value),
+  })
+  status?: 'active' | 'inactive';
+}

package/src/finance-audit-logs.controller.ts

@@ -0,0 +1,30 @@
+import { Role } from '@hed-hog/api';
+import { Pagination } from '@hed-hog/api-pagination';
+import { Controller, Get, Query } from '@nestjs/common';
+import { FinanceService } from './finance.service';
+
+@Role()
+@Controller('finance')
+export class FinanceAuditLogsController {
+  constructor(private readonly financeService: FinanceService) {}
+
+  @Get('audit-logs')
+  async listAuditLogs(
+    @Pagination() paginationParams,
+    @Query('search') search?: string,
+    @Query('action') action?: string,
+    @Query('entity_table') entityTable?: string,
+    @Query('actor_user_id') actorUserId?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
+  ) {
+    return this.financeService.listAuditLogs(paginationParams, {
+      search,
+      action,
+      entity_table: entityTable,
+      actor_user_id: actorUserId,
+      from,
+      to,
+    });
+  }
+}