@hed-hog/finance 0.0.261 → 0.0.266

package/hedhog/data/route.yaml

@@ -7,6 +7,15 @@
       - where:
           slug: admin-finance
 
+- url: /finance/scenarios/:cenario
+  method: PATCH
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-finance
+
 - url: /finance/accounts-payable/installments
   method: GET
   relations:

package/hedhog/data/setting_group.yaml

@@ -0,0 +1,152 @@
+- slug: financeiro
+  icon: chart-line
+  name:
+    en: Financial
+    pt: Financeiro
+  description:
+    en: Forecast and scenario settings for finance planning.
+    pt: Configurações de projeção e cenários para o planejamento financeiro.
+  relations:
+    setting:
+      - slug: finance-default-scenario
+        type: string
+        component: combobox
+        name:
+          en: Default Scenario
+          pt: Cenário Padrão
+        description:
+          en: Default scenario used in cash flow forecast screens.
+          pt: Cenário padrão utilizado nas telas de previsão de fluxo de caixa.
+        value: base
+        user_override: false
+        relations:
+          setting_list:
+            - value: base
+              order: 0
+            - value: pessimista
+              order: 1
+            - value: otimista
+              order: 2
+      - slug: finance-default-horizon-days
+        type: number
+        component: combobox
+        name:
+          en: Default Forecast Horizon (Days)
+          pt: Horizonte Padrão da Previsão (Dias)
+        description:
+          en: Default forecast period in days.
+          pt: Período padrão da previsão em dias.
+        value: 90
+        user_override: false
+        relations:
+          setting_list:
+            - value: 30
+              order: 0
+            - value: 60
+              order: 1
+            - value: 90
+              order: 2
+            - value: 180
+              order: 3
+            - value: 365
+              order: 4
+      - slug: finance-scenario-base-average-delay-days
+        type: number
+        component: input-number
+        name:
+          en: Base Scenario Average Delay (Days)
+          pt: Atraso Médio no Cenário Base (Dias)
+        description:
+          en: Average receivable delay in days for base scenario.
+          pt: Atraso médio de recebimento em dias para o cenário base.
+        value: 5
+        user_override: false
+      - slug: finance-scenario-base-default-rate-percent
+        type: number
+        component: input-number
+        name:
+          en: Base Scenario Default Rate (%)
+          pt: Taxa de Inadimplência no Cenário Base (%)
+        description:
+          en: Expected default rate for base scenario.
+          pt: Taxa esperada de inadimplência para o cenário base.
+        value: 3
+        user_override: false
+      - slug: finance-scenario-base-revenue-growth-percent
+        type: number
+        component: input-number
+        name:
+          en: Base Scenario Revenue Growth (%)
+          pt: Crescimento de Receita no Cenário Base (%)
+        description:
+          en: Expected revenue growth for base scenario.
+          pt: Crescimento esperado da receita para o cenário base.
+        value: 5
+        user_override: false
+      - slug: finance-scenario-pessimistic-average-delay-days
+        type: number
+        component: input-number
+        name:
+          en: Pessimistic Scenario Average Delay (Days)
+          pt: Atraso Médio no Cenário Pessimista (Dias)
+        description:
+          en: Average receivable delay in days for pessimistic scenario.
+          pt: Atraso médio de recebimento em dias para o cenário pessimista.
+        value: 12
+        user_override: false
+      - slug: finance-scenario-pessimistic-default-rate-percent
+        type: number
+        component: input-number
+        name:
+          en: Pessimistic Scenario Default Rate (%)
+          pt: Taxa de Inadimplência no Cenário Pessimista (%)
+        description:
+          en: Expected default rate for pessimistic scenario.
+          pt: Taxa esperada de inadimplência para o cenário pessimista.
+        value: 6
+        user_override: false
+      - slug: finance-scenario-pessimistic-revenue-growth-percent
+        type: number
+        component: input-number
+        name:
+          en: Pessimistic Scenario Revenue Growth (%)
+          pt: Crescimento de Receita no Cenário Pessimista (%)
+        description:
+          en: Expected revenue growth for pessimistic scenario.
+          pt: Crescimento esperado da receita para o cenário pessimista.
+        value: -5
+        user_override: false
+      - slug: finance-scenario-optimistic-average-delay-days
+        type: number
+        component: input-number
+        name:
+          en: Optimistic Scenario Average Delay (Days)
+          pt: Atraso Médio no Cenário Otimista (Dias)
+        description:
+          en: Average receivable delay in days for optimistic scenario.
+          pt: Atraso médio de recebimento em dias para o cenário otimista.
+        value: 2
+        user_override: false
+      - slug: finance-scenario-optimistic-default-rate-percent
+        type: number
+        component: input-number
+        name:
+          en: Optimistic Scenario Default Rate (%)
+          pt: Taxa de Inadimplência no Cenário Otimista (%)
+        description:
+          en: Expected default rate for optimistic scenario.
+          pt: Taxa esperada de inadimplência para o cenário otimista.
+        value: 1.5
+        user_override: false
+      - slug: finance-scenario-optimistic-revenue-growth-percent
+        type: number
+        component: input-number
+        name:
+          en: Optimistic Scenario Revenue Growth (%)
+          pt: Crescimento de Receita no Cenário Otimista (%)
+        description:
+          en: Expected revenue growth for optimistic scenario.
+          pt: Crescimento esperado da receita para o cenário otimista.
+        value: 10
+        user_override: false
+   

package/hedhog/frontend/app/_lib/use-finance-data.ts.ejs

@@ -3,6 +3,8 @@
 import { useApp, useQuery } from '@hed-hog/next-app-provider';
 
 type FinanceData = {
+  defaultScenario?: 'base' | 'pessimista' | 'otimista';
+  defaultHorizonDays?: number;
   kpis: {
     saldoCaixa: number;
     aPagar30dias: number;
@@ -36,7 +38,14 @@ type FinanceData = {
   } | null;
 };
 
+type FinanceDataFilters = {
+  horizonteDias?: number;
+  cenario?: 'base' | 'pessimista' | 'otimista';
+};
+
 const EMPTY_FINANCE_DATA: FinanceData = {
+  defaultScenario: 'base',
+  defaultHorizonDays: 90,
   kpis: {
     saldoCaixa: 0,
     aPagar30dias: 0,
@@ -67,17 +76,36 @@ const EMPTY_FINANCE_DATA: FinanceData = {
   periodoAberto: null,
 };
 
-export function useFinanceData() {
+export function useFinanceData(filters?: FinanceDataFilters) {
   const { request } = useApp();
 
+  const horizonteDias = filters?.horizonteDias;
+  const cenario = filters?.cenario;
+  const query = new URLSearchParams();
+
+  if (typeof horizonteDias === 'number' && Number.isFinite(horizonteDias)) {
+    query.set('horizonte', String(horizonteDias));
+  }
+
+  if (cenario) {
+    query.set('cenario', cenario);
+  }
+
+  const querySuffix = query.toString();
+  const url = querySuffix ? `/finance/data?${querySuffix}` : '/finance/data';
+
   return useQuery<FinanceData>({
-    queryKey: ['finance-data'],
+    queryKey: [
+      'finance-data',
+      horizonteDias ?? 'default',
+      cenario ?? 'default',
+    ],
     staleTime: 0,
     refetchOnMount: 'always',
     queryFn: async () => {
       try {
         const response = await request({
-          url: '/finance/data',
+          url,
           method: 'GET',
         });
 

package/hedhog/frontend/app/planning/cash-flow-forecast/page.tsx.ejs

@@ -26,7 +26,13 @@ import {
   TableRow,
 } from '@/components/ui/table';
 import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs';
-import { Download, TrendingDown, TrendingUp, Wallet } from 'lucide-react';
+import {
+  Download,
+  Loader2,
+  TrendingDown,
+  TrendingUp,
+  Wallet,
+} from 'lucide-react';
 import { useTranslations } from 'next-intl';
 import { useState } from 'react';
 import {
@@ -44,11 +50,20 @@ import { useFinanceData } from '../../_lib/use-finance-data';
 
 export default function FluxoCaixaPage() {
   const t = useTranslations('finance.CashFlowForecastPage');
-  const { data } = useFinanceData();
-  const { fluxoCaixaPrevisto, kpis, entradasPrevistas, saidasPrevistas } = data;
 
-  const [horizonte, setHorizonte] = useState('90');
-  const [cenario, setCenario] = useState('base');
+  const [horizonte, setHorizonte] = useState<string | null>(null);
+  const [cenario, setCenario] = useState<
+    'base' | 'pessimista' | 'otimista' | null
+  >(null);
+
+  const { data, isFetching } = useFinanceData({
+    horizonteDias: horizonte ? Number(horizonte) : undefined,
+    cenario: cenario || undefined,
+  });
+
+  const { fluxoCaixaPrevisto, kpis, entradasPrevistas, saidasPrevistas } = data;
+  const selectedHorizon = horizonte || String(data.defaultHorizonDays || 90);
+  const selectedScenario = cenario || data.defaultScenario || 'base';
 
   const chartData = fluxoCaixaPrevisto.map((item) => ({
     ...item,
@@ -78,7 +93,11 @@ export default function FluxoCaixaPage() {
       />
 
       <div className="flex flex-col gap-4 sm:flex-row sm:items-center">
-        <Select value={horizonte} onValueChange={setHorizonte}>
+        <Select
+          value={selectedHorizon}
+          onValueChange={setHorizonte}
+          disabled={isFetching}
+        >
           <SelectTrigger className="w-[180px]">
             <SelectValue placeholder={t('filters.horizon')} />
           </SelectTrigger>
@@ -90,7 +109,13 @@ export default function FluxoCaixaPage() {
             <SelectItem value="365">{t('filters.days365')}</SelectItem>
           </SelectContent>
         </Select>
-        <Select value={cenario} onValueChange={setCenario}>
+        <Select
+          value={selectedScenario}
+          onValueChange={(value) =>
+            setCenario(value as 'base' | 'pessimista' | 'otimista')
+          }
+          disabled={isFetching}
+        >
           <SelectTrigger className="w-[180px]">
             <SelectValue placeholder={t('filters.scenario')} />
           </SelectTrigger>
@@ -104,6 +129,12 @@ export default function FluxoCaixaPage() {
             </SelectItem>
           </SelectContent>
         </Select>
+        {isFetching ? (
+          <div className="text-muted-foreground flex items-center gap-2 text-sm">
+            <Loader2 className="h-4 w-4 animate-spin" />
+            Atualizando dados...
+          </div>
+        ) : null}
       </div>
 
       <div className="grid gap-4 md:grid-cols-4">

package/hedhog/frontend/app/planning/receivables-calendar/page.tsx.ejs

@@ -46,6 +46,8 @@ export default function RecebiveisPage() {
   const totalBruto = recebiveis.reduce((acc, r) => acc + r.bruto, 0);
   const totalTaxas = recebiveis.reduce((acc, r) => acc + r.taxas, 0);
   const totalLiquido = recebiveis.reduce((acc, r) => acc + r.liquido, 0);
+  const taxasPercentual =
+    totalBruto > 0 ? ((totalTaxas / totalBruto) * 100).toFixed(2) : '0.00';
 
   return (
     <Page>
@@ -88,7 +90,7 @@ export default function RecebiveisPage() {
             </div>
             <p className="text-xs text-muted-foreground">
               {t('cards.percentOfGross', {
-                percent: ((totalTaxas / totalBruto) * 100).toFixed(2),
+                percent: taxasPercentual,
               })}
             </p>
           </CardContent>

package/hedhog/frontend/app/planning/scenarios/page.tsx.ejs

@@ -13,30 +13,58 @@ import {
 import { Label } from '@/components/ui/label';
 import { Money } from '@/components/ui/money';
 import { Slider } from '@/components/ui/slider';
+import { useApp } from '@hed-hog/next-app-provider';
 import {
   Check,
   Lightbulb,
+  Loader2,
   Target,
   TrendingDown,
   TrendingUp,
 } from 'lucide-react';
 import { useTranslations } from 'next-intl';
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
 import { formatarMoeda } from '../../_lib/formatters';
 import { useFinanceData } from '../../_lib/use-finance-data';
 
 export default function CenariosPage() {
   const t = useTranslations('finance.ScenariosPage');
-  const { data } = useFinanceData();
+  const { request, showToastHandler } = useApp();
+  const { data, isFetching, refetch } = useFinanceData();
   const { cenarios, kpis } = data;
 
-  const [cenarioAtivo, setCenarioAtivo] = useState('1');
+  const [cenarioAtivo, setCenarioAtivo] = useState('base');
+  const [isSaving, setIsSaving] = useState(false);
   const [premissas, setPremissas] = useState({
     atrasoMedio: 5,
     taxaInadimplencia: 3,
     crescimentoReceita: 5,
   });
 
+  useEffect(() => {
+    if (!cenarios?.length) {
+      return;
+    }
+
+    const selected = cenarios.find((c) => c.id === cenarioAtivo);
+    if (selected) {
+      return;
+    }
+
+    const defaultScenario = cenarios.find((c) => c.padrao) || cenarios[0];
+
+    if (!defaultScenario) {
+      return;
+    }
+
+    setCenarioAtivo(defaultScenario.id);
+    setPremissas({
+      atrasoMedio: defaultScenario.atrasoMedio,
+      taxaInadimplencia: defaultScenario.taxaInadimplencia,
+      crescimentoReceita: defaultScenario.crescimentoReceita,
+    });
+  }, [cenarios, cenarioAtivo]);
+
   const cenarioSelecionado = cenarios.find((c) => c.id === cenarioAtivo);
 
   const impactoSaldo =
@@ -184,6 +212,7 @@ export default function CenariosPage() {
                 </div>
                 <Slider
                   value={[premissas.atrasoMedio]}
+                  disabled={isSaving || isFetching}
                   onValueChange={([value]) =>
                     setPremissas({
                       ...premissas,
@@ -204,6 +233,7 @@ export default function CenariosPage() {
                 </div>
                 <Slider
                   value={[premissas.taxaInadimplencia]}
+                  disabled={isSaving || isFetching}
                   onValueChange={([value]) =>
                     setPremissas({
                       ...premissas,
@@ -231,6 +261,7 @@ export default function CenariosPage() {
                 </div>
                 <Slider
                   value={[premissas.crescimentoReceita + 10]} // Offset para permitir valores negativos
+                  disabled={isSaving || isFetching}
                   onValueChange={([value]) =>
                     setPremissas({
                       ...premissas,
@@ -247,6 +278,7 @@ export default function CenariosPage() {
             <div className="flex justify-end gap-2 pt-4">
               <Button
                 variant="outline"
+                disabled={isSaving || isFetching || !cenarioSelecionado}
                 onClick={() => {
                   if (cenarioSelecionado) {
                     setPremissas({
@@ -259,7 +291,45 @@ export default function CenariosPage() {
               >
                 {t('assumptions.restore')}
               </Button>
-              <Button>{t('assumptions.apply')}</Button>
+              <Button
+                disabled={isSaving || isFetching || !cenarioSelecionado}
+                onClick={async () => {
+                  if (!cenarioSelecionado || isSaving) {
+                    return;
+                  }
+
+                  try {
+                    setIsSaving(true);
+
+                    await request({
+                      url: `/finance/scenarios/${cenarioSelecionado.id}`,
+                      method: 'PATCH',
+                      data: {
+                        atrasoMedio: premissas.atrasoMedio,
+                        taxaInadimplencia: premissas.taxaInadimplencia,
+                        crescimentoReceita: premissas.crescimentoReceita,
+                        setAsDefault: true,
+                      },
+                    });
+
+                    await refetch();
+                    showToastHandler?.('success', 'Cenário salvo com sucesso');
+                  } catch {
+                    showToastHandler?.('error', 'Erro ao salvar cenário');
+                  } finally {
+                    setIsSaving(false);
+                  }
+                }}
+              >
+                {isSaving ? (
+                  <>
+                    <Loader2 className="mr-2 h-4 w-4 animate-spin" />
+                    {t('assumptions.apply')}
+                  </>
+                ) : (
+                  t('assumptions.apply')
+                )}
+              </Button>
             </div>
           </CardContent>
         </Card>