@hed-hog/finance 0.0.3 → 0.0.224

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

@@ -0,0 +1,321 @@
+'use client';
+
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { Label } from '@/components/ui/label';
+import { Money } from '@/components/ui/money';
+import { PageHeader } from '@/components/ui/page-header';
+import { Slider } from '@/components/ui/slider';
+import {
+  Check,
+  Lightbulb,
+  Target,
+  TrendingDown,
+  TrendingUp,
+} from 'lucide-react';
+import { useState } from 'react';
+import { formatarMoeda } from '../../_lib/formatters';
+import { useFinanceData } from '../../_lib/use-finance-data';
+
+export default function CenariosPage() {
+  const { data } = useFinanceData();
+  const { cenarios, kpis } = data;
+
+  const [cenarioAtivo, setCenarioAtivo] = useState('1');
+  const [premissas, setPremissas] = useState({
+    atrasoMedio: 5,
+    taxaInadimplencia: 3,
+    crescimentoReceita: 5,
+  });
+
+  const cenarioSelecionado = cenarios.find((c) => c.id === cenarioAtivo);
+
+  // Simulação de impacto baseada nas premissas
+  const impactoSaldo =
+    kpis.saldoCaixa * (1 + premissas.crescimentoReceita / 100);
+  const impactoInadimplencia =
+    kpis.inadimplencia * (1 + premissas.taxaInadimplencia / 10);
+
+  return (
+    <div className="space-y-6">
+      <PageHeader
+        title="Cenários"
+        description="Simule diferentes cenários financeiros"
+        breadcrumbs={[
+          { label: 'Planejamento', href: '/finance/planning/cash-flow-forecast' },
+          { label: 'Cenários' },
+        ]}
+      />
+
+      <div className="grid gap-4 md:grid-cols-3">
+        {cenarios.map((cenario) => {
+          const isAtivo = cenario.id === cenarioAtivo;
+          const Icon =
+            cenario.nome === 'Otimista'
+              ? TrendingUp
+              : cenario.nome === 'Pessimista'
+                ? TrendingDown
+                : Target;
+
+          return (
+            <Card
+              key={cenario.id}
+              className={`cursor-pointer transition-all ${
+                isAtivo
+                  ? 'border-primary ring-2 ring-primary/20'
+                  : 'hover:border-muted-foreground/50'
+              }`}
+              onClick={() => {
+                setCenarioAtivo(cenario.id);
+                setPremissas({
+                  atrasoMedio: cenario.atrasoMedio,
+                  taxaInadimplencia: cenario.taxaInadimplencia,
+                  crescimentoReceita: cenario.crescimentoReceita,
+                });
+              }}
+            >
+              <CardHeader>
+                <div className="flex items-center justify-between">
+                  <div className="flex items-center gap-3">
+                    <div
+                      className={`flex h-10 w-10 items-center justify-center rounded-lg ${
+                        cenario.nome === 'Otimista'
+                          ? 'bg-green-100'
+                          : cenario.nome === 'Pessimista'
+                            ? 'bg-red-100'
+                            : 'bg-blue-100'
+                      }`}
+                    >
+                      <Icon
+                        className={`h-5 w-5 ${
+                          cenario.nome === 'Otimista'
+                            ? 'text-green-600'
+                            : cenario.nome === 'Pessimista'
+                              ? 'text-red-600'
+                              : 'text-blue-600'
+                        }`}
+                      />
+                    </div>
+                    <div>
+                      <CardTitle className="text-base">
+                        {cenario.nome}
+                      </CardTitle>
+                      <CardDescription>{cenario.descricao}</CardDescription>
+                    </div>
+                  </div>
+                  {isAtivo && (
+                    <Badge className="bg-primary text-primary-foreground">
+                      <Check className="mr-1 h-3 w-3" />
+                      Ativo
+                    </Badge>
+                  )}
+                </div>
+              </CardHeader>
+              <CardContent>
+                <div className="grid grid-cols-3 gap-4 text-center">
+                  <div>
+                    <p className="text-xs text-muted-foreground">Atraso</p>
+                    <p className="font-semibold">{cenario.atrasoMedio} dias</p>
+                  </div>
+                  <div>
+                    <p className="text-xs text-muted-foreground">
+                      Inadimplência
+                    </p>
+                    <p className="font-semibold">
+                      {cenario.taxaInadimplencia}%
+                    </p>
+                  </div>
+                  <div>
+                    <p className="text-xs text-muted-foreground">Crescimento</p>
+                    <p
+                      className={`font-semibold ${
+                        cenario.crescimentoReceita >= 0
+                          ? 'text-green-600'
+                          : 'text-red-600'
+                      }`}
+                    >
+                      {cenario.crescimentoReceita > 0 && '+'}
+                      {cenario.crescimentoReceita}%
+                    </p>
+                  </div>
+                </div>
+              </CardContent>
+            </Card>
+          );
+        })}
+      </div>
+
+      <div className="grid gap-6 lg:grid-cols-2">
+        <Card>
+          <CardHeader>
+            <CardTitle className="flex items-center gap-2">
+              <Lightbulb className="h-4 w-4" />
+              Editor de Premissas
+            </CardTitle>
+            <CardDescription>
+              Ajuste as premissas do cenário {cenarioSelecionado?.nome}
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-6">
+            <div className="space-y-4">
+              <div className="space-y-2">
+                <div className="flex items-center justify-between">
+                  <Label>Atraso Médio de Recebimento</Label>
+                  <span className="text-sm font-medium">
+                    {premissas.atrasoMedio} dias
+                  </span>
+                </div>
+                <Slider
+                  value={[premissas.atrasoMedio]}
+                  onValueChange={([value]) =>
+                    setPremissas({
+                      ...premissas,
+                      atrasoMedio: value ?? premissas.atrasoMedio,
+                    })
+                  }
+                  max={30}
+                  step={1}
+                />
+              </div>
+
+              <div className="space-y-2">
+                <div className="flex items-center justify-between">
+                  <Label>Taxa de Inadimplência</Label>
+                  <span className="text-sm font-medium">
+                    {premissas.taxaInadimplencia}%
+                  </span>
+                </div>
+                <Slider
+                  value={[premissas.taxaInadimplencia]}
+                  onValueChange={([value]) =>
+                    setPremissas({
+                      ...premissas,
+                      taxaInadimplencia: value ?? premissas.taxaInadimplencia,
+                    })
+                  }
+                  max={15}
+                  step={0.5}
+                />
+              </div>
+
+              <div className="space-y-2">
+                <div className="flex items-center justify-between">
+                  <Label>Crescimento de Receita</Label>
+                  <span
+                    className={`text-sm font-medium ${
+                      premissas.crescimentoReceita >= 0
+                        ? 'text-green-600'
+                        : 'text-red-600'
+                    }`}
+                  >
+                    {premissas.crescimentoReceita > 0 && '+'}
+                    {premissas.crescimentoReceita}%
+                  </span>
+                </div>
+                <Slider
+                  value={[premissas.crescimentoReceita + 10]} // Offset para permitir valores negativos
+                  onValueChange={([value]) =>
+                    setPremissas({
+                      ...premissas,
+                      crescimentoReceita:
+                        (value ?? premissas.crescimentoReceita + 10) - 10,
+                    })
+                  }
+                  max={25}
+                  step={1}
+                />
+              </div>
+            </div>
+
+            <div className="flex justify-end gap-2 pt-4">
+              <Button
+                variant="outline"
+                onClick={() => {
+                  if (cenarioSelecionado) {
+                    setPremissas({
+                      atrasoMedio: cenarioSelecionado.atrasoMedio,
+                      taxaInadimplencia: cenarioSelecionado.taxaInadimplencia,
+                      crescimentoReceita: cenarioSelecionado.crescimentoReceita,
+                    });
+                  }
+                }}
+              >
+                Restaurar
+              </Button>
+              <Button>Aplicar Cenário</Button>
+            </div>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardHeader>
+            <CardTitle>Impacto Projetado</CardTitle>
+            <CardDescription>Resultado das premissas aplicadas</CardDescription>
+          </CardHeader>
+          <CardContent>
+            <div className="space-y-6">
+              <div className="rounded-lg border p-4">
+                <p className="text-sm text-muted-foreground">
+                  Saldo Projetado (30 dias)
+                </p>
+                <p className="text-3xl font-bold">
+                  <Money value={impactoSaldo} />
+                </p>
+                <p
+                  className={`text-sm ${
+                    impactoSaldo >= kpis.saldoCaixa
+                      ? 'text-green-600'
+                      : 'text-red-600'
+                  }`}
+                >
+                  {impactoSaldo >= kpis.saldoCaixa ? '+' : ''}
+                  {formatarMoeda(impactoSaldo - kpis.saldoCaixa)} vs atual
+                </p>
+              </div>
+
+              <div className="rounded-lg border p-4">
+                <p className="text-sm text-muted-foreground">
+                  Inadimplência Projetada
+                </p>
+                <p className="text-3xl font-bold text-red-600">
+                  <Money value={impactoInadimplencia} />
+                </p>
+                <p className="text-sm text-muted-foreground">
+                  {formatarMoeda(impactoInadimplencia - kpis.inadimplencia)} vs
+                  atual
+                </p>
+              </div>
+
+              <div className="rounded-lg border p-4">
+                <p className="text-sm text-muted-foreground">
+                  Fluxo de Caixa Previsto
+                </p>
+                <p
+                  className={`text-3xl font-bold ${
+                    premissas.crescimentoReceita >= 0
+                      ? 'text-green-600'
+                      : 'text-red-600'
+                  }`}
+                >
+                  {premissas.crescimentoReceita >= 0 ? 'Positivo' : 'Negativo'}
+                </p>
+                <p className="text-sm text-muted-foreground">
+                  Com crescimento de {premissas.crescimentoReceita}%
+                </p>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    </div>
+  );
+}
+
+

package/hedhog/query/constraints.sql

@@ -0,0 +1,169 @@
+-- Regras de integridade do módulo financeiro (PostgreSQL)
+-- Script idempotente: pode ser executado mais de uma vez.
+
+-- 1) CHECKs simples de domínio
+DO $$
+BEGIN
+	IF NOT EXISTS (
+		SELECT 1
+		FROM pg_constraint
+		WHERE conname = 'chk_financial_installment_open_amount_non_negative'
+	) THEN
+		ALTER TABLE financial_installment
+			ADD CONSTRAINT chk_financial_installment_open_amount_non_negative
+			CHECK (open_amount_cents >= 0);
+	END IF;
+
+	IF NOT EXISTS (
+		SELECT 1
+		FROM pg_constraint
+		WHERE conname = 'chk_financial_installment_open_amount_lte_amount'
+	) THEN
+		ALTER TABLE financial_installment
+			ADD CONSTRAINT chk_financial_installment_open_amount_lte_amount
+			CHECK (open_amount_cents <= amount_cents);
+	END IF;
+
+	IF NOT EXISTS (
+		SELECT 1
+		FROM pg_constraint
+		WHERE conname = 'chk_period_close_period_end_gte_start'
+	) THEN
+		ALTER TABLE period_close
+			ADD CONSTRAINT chk_period_close_period_end_gte_start
+			CHECK (period_end >= period_start);
+	END IF;
+END $$;
+
+-- 2) Unicidade em tabelas de vínculo N:N
+DO $$
+BEGIN
+	IF NOT EXISTS (
+		SELECT 1
+		FROM pg_constraint
+		WHERE conname = 'uq_financial_installment_tag_installment_tag'
+	) THEN
+		ALTER TABLE financial_installment_tag
+			ADD CONSTRAINT uq_financial_installment_tag_installment_tag
+			UNIQUE (installment_id, tag_id);
+	END IF;
+
+	IF NOT EXISTS (
+		SELECT 1
+		FROM pg_constraint
+		WHERE conname = 'uq_installment_allocation_installment_cost_center'
+	) THEN
+		ALTER TABLE installment_allocation
+			ADD CONSTRAINT uq_installment_allocation_installment_cost_center
+			UNIQUE (installment_id, cost_center_id);
+	END IF;
+
+	IF NOT EXISTS (
+		SELECT 1
+		FROM pg_constraint
+		WHERE conname = 'uq_settlement_allocation_settlement_installment'
+	) THEN
+		ALTER TABLE settlement_allocation
+			ADD CONSTRAINT uq_settlement_allocation_settlement_installment
+			UNIQUE (settlement_id, installment_id);
+	END IF;
+END $$;
+
+-- 3) Política de alocação por parcela (somatórios não podem exceder amount_cents)
+-- settlement_allocation: soma(allocated_amount_cents) por installment_id <= financial_installment.amount_cents
+
+CREATE OR REPLACE FUNCTION fn_check_settlement_allocation_total_per_installment()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	target_installment_id financial_installment.id%TYPE;
+	installment_amount_cents integer;
+	allocated_total_cents bigint;
+BEGIN
+	target_installment_id := COALESCE(NEW.installment_id, OLD.installment_id);
+
+	SELECT fi.amount_cents
+	INTO installment_amount_cents
+	FROM financial_installment fi
+	WHERE fi.id = target_installment_id;
+
+	IF installment_amount_cents IS NULL THEN
+		RETURN NULL;
+	END IF;
+
+	SELECT COALESCE(SUM(sa.allocated_amount_cents), 0)
+	INTO allocated_total_cents
+	FROM settlement_allocation sa
+	WHERE sa.installment_id = target_installment_id;
+
+	IF allocated_total_cents > installment_amount_cents THEN
+		RAISE EXCEPTION
+			'Soma de settlement_allocation (%) excede amount_cents (%) para installment_id=%',
+			allocated_total_cents,
+			installment_amount_cents,
+			target_installment_id;
+	END IF;
+
+	RETURN NULL;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_check_settlement_allocation_total_per_installment
+ON settlement_allocation;
+
+CREATE CONSTRAINT TRIGGER trg_check_settlement_allocation_total_per_installment
+AFTER INSERT OR UPDATE OR DELETE
+ON settlement_allocation
+DEFERRABLE INITIALLY DEFERRED
+FOR EACH ROW
+EXECUTE FUNCTION fn_check_settlement_allocation_total_per_installment();
+
+-- installment_allocation: soma(allocated_amount_cents) por installment_id <= financial_installment.amount_cents
+
+CREATE OR REPLACE FUNCTION fn_check_installment_allocation_total_per_installment()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+AS $$
+DECLARE
+	target_installment_id financial_installment.id%TYPE;
+	installment_amount_cents integer;
+	allocated_total_cents bigint;
+BEGIN
+	target_installment_id := COALESCE(NEW.installment_id, OLD.installment_id);
+
+	SELECT fi.amount_cents
+	INTO installment_amount_cents
+	FROM financial_installment fi
+	WHERE fi.id = target_installment_id;
+
+	IF installment_amount_cents IS NULL THEN
+		RETURN NULL;
+	END IF;
+
+	SELECT COALESCE(SUM(ia.allocated_amount_cents), 0)
+	INTO allocated_total_cents
+	FROM installment_allocation ia
+	WHERE ia.installment_id = target_installment_id;
+
+	IF allocated_total_cents > installment_amount_cents THEN
+		RAISE EXCEPTION
+			'Soma de installment_allocation (%) excede amount_cents (%) para installment_id=%',
+			allocated_total_cents,
+			installment_amount_cents,
+			target_installment_id;
+	END IF;
+
+	RETURN NULL;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_check_installment_allocation_total_per_installment
+ON installment_allocation;
+
+CREATE CONSTRAINT TRIGGER trg_check_installment_allocation_total_per_installment
+AFTER INSERT OR UPDATE OR DELETE
+ON installment_allocation
+DEFERRABLE INITIALLY DEFERRED
+FOR EACH ROW
+EXECUTE FUNCTION fn_check_installment_allocation_total_per_installment();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.3",
+  "version": "0.0.224",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,12 +9,12 @@
     "@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/api-pagination": "0.0.5",
-    "@hed-hog/api-locale": "0.0.11",
     "@hed-hog/api": "0.0.3",
-    "@hed-hog/tag": "0.0.222",
-    "@hed-hog/contact": "0.0.222",
+    "@hed-hog/tag": "0.0.223",
+    "@hed-hog/contact": "0.0.223",
     "@hed-hog/api-types": "0.0.1"
   },
   "exports": {