@hed-hog/finance 0.0.261 → 0.0.266

package/hedhog/frontend/messages/pt.json

@@ -1310,6 +1310,188 @@
       "total": "Total"
     }
   },
+  "ActualVsForecastPage": {
+    "header": {
+      "title": "Realizado vs Previsto",
+      "description": "Compare o desempenho realizado com as projeções financeiras"
+    },
+    "breadcrumbs": {
+      "home": "Início",
+      "finance": "Financeiro",
+      "current": "Realizado vs Previsto"
+    },
+    "actions": {
+      "export": "Exportar"
+    },
+    "filters": {
+      "horizon": "Horizonte",
+      "scenario": "Cenário",
+      "days30": "30 dias",
+      "days60": "60 dias",
+      "days90": "90 dias",
+      "days180": "180 dias",
+      "days365": "365 dias"
+    },
+    "scenarios": {
+      "base": "Base",
+      "pessimistic": "Pessimista",
+      "optimistic": "Otimista"
+    },
+    "messages": {
+      "updating": "Atualizando dados..."
+    },
+    "cards": {
+      "totalForecast": "Total Previsto",
+      "totalActual": "Total Realizado",
+      "totalDeviation": "Desvio Total",
+      "accuracy": "Acurácia"
+    },
+    "chart": {
+      "title": "Evolução Realizado vs Previsto",
+      "description": "Comparativo da série temporal entre valores previstos e realizados",
+      "forecastLabel": "Previsto",
+      "actualLabel": "Realizado"
+    },
+    "table": {
+      "title": "Detalhamento por período",
+      "description": "Acompanhe o desvio de cada ponto da projeção",
+      "headers": {
+        "date": "Data",
+        "forecast": "Previsto",
+        "actual": "Realizado",
+        "deviation": "Desvio",
+        "percentDeviation": "% Desvio",
+        "status": "Status"
+      },
+      "empty": "Sem dados para o período selecionado."
+    },
+    "status": {
+      "above": "Acima",
+      "below": "Abaixo",
+      "onTarget": "No alvo"
+    }
+  },
+  "CashPositionReportPage": {
+    "header": {
+      "title": "Posição de Caixa",
+      "description": "Acompanhe saldos e movimentações de caixa por conta"
+    },
+    "breadcrumbs": {
+      "home": "Início",
+      "finance": "Financeiro",
+      "current": "Posição de Caixa"
+    },
+    "actions": {
+      "export": "Exportar"
+    },
+    "filters": {
+      "horizon": "Horizonte",
+      "scenario": "Cenário",
+      "bankAccount": "Conta bancária",
+      "allBankAccounts": "Todas as contas",
+      "days30": "30 dias",
+      "days60": "60 dias",
+      "days90": "90 dias",
+      "days180": "180 dias",
+      "days365": "365 dias"
+    },
+    "scenarios": {
+      "base": "Base",
+      "pessimistic": "Pessimista",
+      "optimistic": "Otimista"
+    },
+    "messages": {
+      "updating": "Atualizando dados..."
+    },
+    "cards": {
+      "currentBalance": "Saldo Atual",
+      "reconciledBalance": "Saldo Conciliado",
+      "inflows": "Entradas",
+      "outflows": "Saídas",
+      "netMovement": "Movimentação Líquida"
+    },
+    "chart": {
+      "title": "Evolução do saldo",
+      "description": "Variação acumulada do saldo no período",
+      "balanceLabel": "Saldo acumulado"
+    },
+    "table": {
+      "title": "Últimas movimentações",
+      "description": "Lançamentos mais recentes conforme filtros aplicados",
+      "headers": {
+        "date": "Data",
+        "description": "Descrição",
+        "type": "Tipo",
+        "value": "Valor"
+      },
+      "empty": "Nenhuma movimentação encontrada."
+    },
+    "types": {
+      "inflow": "Entrada",
+      "outflow": "Saída"
+    }
+  },
+  "AgingDefaultReportPage": {
+    "header": {
+      "title": "Aging de Inadimplência",
+      "description": "Visualize os atrasos de recebíveis por faixa de vencimento"
+    },
+    "breadcrumbs": {
+      "home": "Início",
+      "finance": "Financeiro",
+      "current": "Aging de Inadimplência"
+    },
+    "filters": {
+      "horizon": "Horizonte",
+      "scenario": "Cenário",
+      "days30": "30 dias",
+      "days60": "60 dias",
+      "days90": "90 dias",
+      "days180": "180 dias",
+      "days365": "365 dias"
+    },
+    "scenarios": {
+      "base": "Base",
+      "pessimistic": "Pessimista",
+      "optimistic": "Otimista"
+    },
+    "messages": {
+      "updating": "Atualizando dados..."
+    },
+    "cards": {
+      "totalDefault": "Inadimplência Total",
+      "lateClients": "Clientes em atraso",
+      "over90Days": "Acima de 90 dias",
+      "defaultRate": "Taxa de Inadimplência"
+    },
+    "chart": {
+      "title": "Distribuição por faixa",
+      "description": "Concentração da inadimplência por período de atraso",
+      "range0to30": "0–30 dias",
+      "range31to60": "31–60 dias",
+      "range61to90": "61–90 dias",
+      "range90plus": "> 90 dias"
+    },
+    "table": {
+      "title": "Detalhamento por cliente",
+      "description": "Aging de inadimplência por cliente",
+      "headers": {
+        "client": "Cliente",
+        "range0to30": "0–30 dias",
+        "range31to60": "31–60 dias",
+        "range61to90": "61–90 dias",
+        "range90plus": "> 90 dias",
+        "total": "Total",
+        "risk": "Risco"
+      },
+      "empty": "Nenhum dado de inadimplência encontrado."
+    },
+    "risk": {
+      "high": "Alto",
+      "medium": "Médio",
+      "low": "Baixo"
+    }
+  },
   "ReceivablesCalendarPage": {
     "status": {
       "confirmado": "Confirmado",

package/hedhog/query/triggers-period-close.sql

@@ -0,0 +1,361 @@
+-- Triggers de proteção por período fechado (PostgreSQL)
+-- Script idempotente: pode ser executado múltiplas vezes.
+
+-- ==========================================================
+-- Helpers
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_is_in_closed_period(p_date timestamptz)
+RETURNS boolean
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_exists boolean;
+BEGIN
+	IF p_date IS NULL THEN
+		RETURN FALSE;
+	END IF;
+
+	SELECT EXISTS (
+		SELECT 1
+		FROM period_close pc
+		WHERE pc.status = 'closed'
+			AND p_date >= pc.period_start
+			AND p_date <= pc.period_end
+	)
+	INTO v_exists;
+
+	RETURN COALESCE(v_exists, FALSE);
+END;
+$$;
+
+CREATE OR REPLACE FUNCTION fn_assert_not_in_closed_period(
+	p_date timestamptz,
+	p_entity text,
+	p_operation text
+)
+RETURNS void
+LANGUAGE plpgsql
+AS $$
+BEGIN
+	IF fn_is_in_closed_period(p_date) THEN
+		RAISE EXCEPTION
+			'% blocked: % falls in a closed period',
+			p_operation,
+			p_entity;
+	END IF;
+END;
+$$;
+
+-- ==========================================================
+-- period_close: registro fechado é imutável
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_period_close_immutability()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+BEGIN
+	IF TG_OP = 'UPDATE' THEN
+		IF OLD.status = 'closed' THEN
+			RAISE EXCEPTION
+				'UPDATE blocked: closed period_close id=% is immutable',
+				OLD.id;
+		END IF;
+
+		RETURN NEW;
+	END IF;
+
+	IF TG_OP = 'DELETE' THEN
+		IF OLD.status = 'closed' THEN
+			RAISE EXCEPTION
+				'DELETE blocked: closed period_close id=% is immutable',
+				OLD.id;
+		END IF;
+
+		RETURN OLD;
+	END IF;
+
+	RETURN COALESCE(NEW, OLD);
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_period_close_immutability ON period_close;
+
+CREATE TRIGGER trg_guard_period_close_immutability
+BEFORE UPDATE OR DELETE
+ON period_close
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_period_close_immutability();
+
+-- ==========================================================
+-- financial_title
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_financial_title_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_date timestamptz;
+BEGIN
+	IF TG_OP = 'DELETE' THEN
+		v_date := COALESCE(OLD.competence_date, OLD.issue_date, OLD.created_at);
+		PERFORM fn_assert_not_in_closed_period(v_date, 'financial_title', 'DELETE');
+		RETURN OLD;
+	END IF;
+
+	v_date := COALESCE(NEW.competence_date, NEW.issue_date, NEW.created_at);
+	PERFORM fn_assert_not_in_closed_period(v_date, 'financial_title', TG_OP);
+
+	RETURN NEW;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_financial_title_closed_period ON financial_title;
+
+CREATE TRIGGER trg_guard_financial_title_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON financial_title
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_financial_title_closed_period();
+
+-- ==========================================================
+-- financial_installment
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_financial_installment_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_date timestamptz;
+BEGIN
+	IF TG_OP = 'DELETE' THEN
+		v_date := COALESCE(OLD.competence_date, OLD.due_date, OLD.created_at);
+		PERFORM fn_assert_not_in_closed_period(v_date, 'financial_installment', 'DELETE');
+		RETURN OLD;
+	END IF;
+
+	v_date := COALESCE(NEW.competence_date, NEW.due_date, NEW.created_at);
+	PERFORM fn_assert_not_in_closed_period(v_date, 'financial_installment', TG_OP);
+
+	RETURN NEW;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_financial_installment_closed_period ON financial_installment;
+
+CREATE TRIGGER trg_guard_financial_installment_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON financial_installment
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_financial_installment_closed_period();
+
+-- ==========================================================
+-- settlement
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_settlement_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_date timestamptz;
+BEGIN
+	IF TG_OP = 'DELETE' THEN
+		v_date := COALESCE(OLD.settled_at, OLD.created_at);
+		PERFORM fn_assert_not_in_closed_period(v_date, 'settlement', 'DELETE');
+		RETURN OLD;
+	END IF;
+
+	v_date := COALESCE(NEW.settled_at, NEW.created_at);
+	PERFORM fn_assert_not_in_closed_period(v_date, 'settlement', TG_OP);
+
+	RETURN NEW;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_settlement_closed_period ON settlement;
+
+CREATE TRIGGER trg_guard_settlement_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON settlement
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_settlement_closed_period();
+
+-- ==========================================================
+-- settlement_allocation
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_settlement_allocation_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_settlement_id integer;
+	v_settled_at timestamptz;
+BEGIN
+	v_settlement_id := COALESCE(NEW.settlement_id, OLD.settlement_id);
+
+	SELECT s.settled_at
+	INTO v_settled_at
+	FROM settlement s
+	WHERE s.id = v_settlement_id;
+
+	PERFORM fn_assert_not_in_closed_period(
+		v_settled_at,
+		'settlement_allocation',
+		TG_OP
+	);
+
+	RETURN COALESCE(NEW, OLD);
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_settlement_allocation_closed_period ON settlement_allocation;
+
+CREATE TRIGGER trg_guard_settlement_allocation_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON settlement_allocation
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_settlement_allocation_closed_period();
+
+-- ==========================================================
+-- installment_allocation
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_installment_allocation_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_installment_id integer;
+	v_date timestamptz;
+BEGIN
+	v_installment_id := COALESCE(NEW.installment_id, OLD.installment_id);
+
+	SELECT COALESCE(fi.competence_date, fi.due_date, fi.created_at)
+	INTO v_date
+	FROM financial_installment fi
+	WHERE fi.id = v_installment_id;
+
+	PERFORM fn_assert_not_in_closed_period(
+		v_date,
+		'installment_allocation',
+		TG_OP
+	);
+
+	RETURN COALESCE(NEW, OLD);
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_installment_allocation_closed_period ON installment_allocation;
+
+CREATE TRIGGER trg_guard_installment_allocation_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON installment_allocation
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_installment_allocation_closed_period();
+
+-- ==========================================================
+-- bank_statement
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_bank_statement_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_date timestamptz;
+BEGIN
+	IF TG_OP = 'DELETE' THEN
+		v_date := COALESCE(OLD.period_start, OLD.imported_at, OLD.created_at);
+		PERFORM fn_assert_not_in_closed_period(v_date, 'bank_statement', 'DELETE');
+		RETURN OLD;
+	END IF;
+
+	v_date := COALESCE(NEW.period_start, NEW.imported_at, NEW.created_at);
+	PERFORM fn_assert_not_in_closed_period(v_date, 'bank_statement', TG_OP);
+
+	RETURN NEW;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_bank_statement_closed_period ON bank_statement;
+
+CREATE TRIGGER trg_guard_bank_statement_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON bank_statement
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_bank_statement_closed_period();
+
+-- ==========================================================
+-- bank_statement_line
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_bank_statement_line_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_date timestamptz;
+BEGIN
+	IF TG_OP = 'DELETE' THEN
+		v_date := COALESCE(OLD.posted_date, OLD.created_at);
+		PERFORM fn_assert_not_in_closed_period(v_date, 'bank_statement_line', 'DELETE');
+		RETURN OLD;
+	END IF;
+
+	v_date := COALESCE(NEW.posted_date, NEW.created_at);
+	PERFORM fn_assert_not_in_closed_period(v_date, 'bank_statement_line', TG_OP);
+
+	RETURN NEW;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_bank_statement_line_closed_period ON bank_statement_line;
+
+CREATE TRIGGER trg_guard_bank_statement_line_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON bank_statement_line
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_bank_statement_line_closed_period();
+
+-- ==========================================================
+-- bank_reconciliation
+-- ==========================================================
+
+CREATE OR REPLACE FUNCTION fn_guard_bank_reconciliation_closed_period()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	v_settlement_id integer;
+	v_settled_at timestamptz;
+BEGIN
+	v_settlement_id := COALESCE(NEW.settlement_id, OLD.settlement_id);
+
+	SELECT s.settled_at
+	INTO v_settled_at
+	FROM settlement s
+	WHERE s.id = v_settlement_id;
+
+	PERFORM fn_assert_not_in_closed_period(
+		v_settled_at,
+		'bank_reconciliation',
+		TG_OP
+	);
+
+	RETURN COALESCE(NEW, OLD);
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_guard_bank_reconciliation_closed_period ON bank_reconciliation;
+
+CREATE TRIGGER trg_guard_bank_reconciliation_closed_period
+BEFORE INSERT OR UPDATE OR DELETE
+ON bank_reconciliation
+FOR EACH ROW
+EXECUTE FUNCTION fn_guard_bank_reconciliation_closed_period();
+

package/package.json

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

package/src/dto/update-finance-scenario-settings.dto.ts

@@ -0,0 +1,21 @@
+import { Type } from 'class-transformer';
+import { IsBoolean, IsNumber, IsOptional } from 'class-validator';
+
+export class UpdateFinanceScenarioSettingsDto {
+  @Type(() => Number)
+  @IsNumber()
+  atrasoMedio: number;
+
+  @Type(() => Number)
+  @IsNumber()
+  taxaInadimplencia: number;
+
+  @Type(() => Number)
+  @IsNumber()
+  crescimentoReceita: number;
+
+  @IsOptional()
+  @Type(() => Boolean)
+  @IsBoolean()
+  setAsDefault?: boolean;
+}

package/src/finance-data.controller.ts

@@ -1,5 +1,6 @@
 import { Role } from '@hed-hog/api';
-import { Controller, Get } from '@nestjs/common';
+import { Body, Controller, Get, Param, Patch, Query } from '@nestjs/common';
+import { UpdateFinanceScenarioSettingsDto } from './dto/update-finance-scenario-settings.dto';
 import { FinanceService } from './finance.service';
 
 @Role()
@@ -8,7 +9,21 @@ export class FinanceDataController {
   constructor(private readonly financeService: FinanceService) {}
 
   @Get('data')
-  async getData() {
-    return this.financeService.getData();
+  async getData(
+    @Query('horizonte') horizonte?: string,
+    @Query('cenario') cenario?: string,
+  ) {
+    return this.financeService.getData({
+      horizonteDias: horizonte,
+      cenario,
+    });
+  }
+
+  @Patch('scenarios/:cenario')
+  async updateScenarioSettings(
+    @Param('cenario') cenario: string,
+    @Body() data: UpdateFinanceScenarioSettingsDto,
+  ) {
+    return this.financeService.updateScenarioSettings(cenario, data);
   }
 }