chore: deploy web_comercial from monorepo

.dockerignore

@@ -0,0 +1,3 @@
+**/.next
+**/node_modules
+**/.DS_Store

Dockerfile

@@ -0,0 +1,32 @@
+FROM node:22-bookworm-slim AS builder
+WORKDIR /workspace
+
+COPY apps/web_comercial ./apps/web_comercial
+COPY packages/simulation-engine ./packages/simulation-engine
+
+RUN npm ci --prefix apps/web_comercial
+RUN npm --prefix apps/web_comercial run build
+
+FROM node:22-bookworm-slim AS runner
+WORKDIR /workspace
+ENV NODE_ENV=production
+ENV PORT=7860
+ENV HOSTNAME=0.0.0.0
+
+# Install Dev Mode requirements
+RUN apt-get update && \
+    apt-get install -y \
+      bash \
+      git git-lfs \
+      wget curl procps \
+      htop vim nano openssh-client && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /workspace/apps/web_comercial ./apps/web_comercial
+COPY --from=builder /workspace/packages/simulation-engine ./packages/simulation-engine
+
+RUN chown -R 1000:1000 /workspace
+USER 1000
+
+EXPOSE 7860
+CMD ["sh", "-c", "cd apps/web_comercial && npm run start -- -H 0.0.0.0 -p 7860"]

README.md

@@ -1,10 +1,72 @@
 ---
-title: Simulador Consorcio Dev
-emoji: 📊
-colorFrom: pink
-colorTo: pink
+title: Plataforma MAIA - Simulador Consórcio
+emoji: 📈
+colorFrom: blue
+colorTo: indigo
 sdk: docker
-pinned: false
+pinned: true
+hardware: zero-a10g
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## MAIA v2 - Simulador de Consórcios Corporativo
+
+Este é o ambiente de implantação otimizado do **Simulador de Consórcio**, parte da arquitetura **MAIA v2**. O contêiner hospeda nativamente o frontend (`apps/web_comercial` base Next.js) e o motor de simulação por trás (`packages/simulation-engine`), provendo visualizações de fluxos de caixa e regras de negócio para análise de crédito de alto desempenho.
+
+### 🏗 Arquitetura do Contêiner
+
+- **Interface:** Baseada em Next.js (Node 22), rodando em modo stand-alone (`apps/web_comercial`).
+- **Motor (Backend):** Pacotes internos de agentes (`packages/agents` e `packages/simulation-engine`) que interagem dinamicamente para aplicar regras complexas de extração e validação do mercado secundário.
+- **Portabiblidade:** Agnóstico à plataforma. Rodamos a mesma imagem Docker em desenvolvimento local e implantação cloud.
+
+### 🚀 Capacidades Premium (Hugging Face PRO)
+
+Este Space foi arquitetado sob governança estrita para uso máximo de **Assinatura Hugging Face PRO**:
+
+1. **ZeroGPU e Agnosticismo de Hardware:**
+   O sistema solicitará _hardware_ de GPU sob-demanda (`zero-a10g`) durante inferências robustas dos Agentes IA, entregando extrema performance sem consumo residual.
+   O utilitário interno Python (`DeviceManager`) é responsável pela segregação: ele ativa CUDA neste ambiente, mas rebaixa graciosamente para _MPS_ (Apple Silicon, M1/M2/M3) ou CPU (Ubuntu VPS/Coolify) em instâncias locais. **Nunca** altere bibliotecas para requerer CUDA como exclusividade.
+
+2. **Depuração Viva (Dev Mode):**
+   Como assinante PRO, você pode realizar _hot-fixes_ e testes de inferência na nuvem ativando o **Dev Mode** em `Settings > Dev Mode` do Space. Pode se conectar através de terminal SSH ou usar o **VS Code Web** injetado nativamente pela Hugging Face. As edições realizadas nesse ambiente **SÃO TEMPORÁRIAS E DEVEM SER COMITADAS**.
+   O nosso fluxo padrão determina:
+   - **`develop` -> Space DEV:** Use o Dev Mode para testes paralelos sem afetar instâncias públicas. Altere o código pelo VS Code do Space e faça `git add`, `git commit` e `git push origin develop`.
+   - **`main` -> Space PROD:** Implantações em produção ocorrem automaticamente através de CI/CD limpo sem Dev Mode ativado.
+
+3. **Governança de Dados (Data Studio):**
+   Artefatos massivos e pesados (extrações `.xlsm`, logs e tabelas relacionais do simulador) nunca são commitados no repositório de código fonte do GitHub. A análise desses eventos confidenciais corporativos utiliza o portal visual **Data Studio** do ecossistema de dados privados da Hugging Face associado a esta organização.
+
+### ⚙ Variáveis de Ambiente Necessárias (Secrets)
+
+Para que os motores e agentes operem de portas abertas com provedores roteados, defina no menu `Settings > Variables and Secrets`:
+
+- `HF_TOKEN`: O token da sua conta PRO. Necessário para Inference Providers e APIs avançadas.
+- Qualquer chave adicional de LLMs (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`) deve ser adicionada neste mesmo painel da nuvem, de acordo com o padrão encontrado no `.env` do monorepo original.
+
+### 🔍 Acesso aos Logs (via API)
+
+Para depuração avançada sem depender do painel web, a Hugging Face fornece endpoints SSE (_Server-Sent Events_) para observabilidade do Space.
+Você pode usar o script local que configuramos:
+
+```bash
+# Exportar o token antes
+export HF_TOKEN="seu_token_aqui"
+
+# Obter logs de execução em tempo real
+./scripts/deploy/hf_logs.sh sua-org/nome-do-space run
+
+# Obter logs de build em tempo real
+./scripts/deploy/hf_logs.sh sua-org/nome-do-space build
+```
+
+_Ou através de chamadas brutas (cURL)_:
+
+```bash
+curl -N -H "Authorization: Bearer $HF_TOKEN" "https://huggingface.co/api/spaces/sua-org/nome-do-space/logs/run"
+```
+
+### 🤖 CI/CD do GitHub
+
+_Para automação, este repositório é gerenciado upstream pelo GitHub, através do workflow `.github/workflows/simulador-consorcio-deploy-hf.yml`. Ele requer que os seguintes **Repository Secrets** do Github sejam provisionados:_
+
+- `HF_SPACE_DEV`: Caminho do Space de desenvolvimento (Ex: `org/simulador-dev`). Disparado em push na `develop`.
+- `HF_SPACE_PROD`: Caminho do Space de produção (Ex: `org/simulador-prod`). Disparado em push na `main`.

apps/web_comercial/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

apps/web_comercial/README.md

@@ -0,0 +1,16 @@
+# Web App - Simulador Consorcio
+
+Aplicacao Next.js que consome o motor deterministico interno `@simulador-consorcio/simulation-engine`.
+
+## Desenvolvimento
+
+```bash
+npm run dev
+```
+
+## Qualidade
+
+```bash
+npm run lint
+npm run build
+```

apps/web_comercial/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

apps/web_comercial/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

apps/web_comercial/next.config.ts

@@ -0,0 +1,12 @@
+import type { NextConfig } from "next";
+import path from "path";
+
+const nextConfig: NextConfig = {
+  transpilePackages: ["@simulador-consorcio/simulation-engine"],
+  outputFileTracingRoot: path.join(__dirname, "../.."),
+  experimental: {
+    externalDir: true,
+  },
+};
+
+export default nextConfig;

apps/web_comercial/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "consorcio-simulator-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build --webpack",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "16.1.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "@simulador-consorcio/simulation-engine": "file:../../packages/simulation-engine"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

apps/web_comercial/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

apps/web_comercial/src/app/comparador/page.tsx

@@ -0,0 +1,291 @@
+"use client";
+
+import { Card, DataCard } from "@/components/ui/Card";
+import { Input, Select } from "@/components/ui/FormControls";
+import { calcularSimulacao } from "@simulador-consorcio/simulation-engine";
+import { useMemo, useState } from "react";
+
+function formatCurrency(value: number) {
+  return new Intl.NumberFormat("pt-BR", {
+    style: "currency",
+    currency: "BRL",
+  }).format(value);
+}
+
+export default function ComparadorPage() {
+  const [creditoA, setCreditoA] = useState(500000);
+  const [prazoA, setPrazoA] = useState(180);
+  const [temLanceA, setTemLanceA] = useState(true);
+  const [lancePctA, setLancePctA] = useState(30);
+
+  const [creditoB, setCreditoB] = useState(500000);
+  const [prazoB, setPrazoB] = useState(216);
+  const [temLanceB, setTemLanceB] = useState(true);
+  const [lancePctB, setLancePctB] = useState(20);
+
+  const cenarioA = useMemo(() => {
+    return calcularSimulacao({
+      credito_desejado: creditoA,
+      parametros: {
+        id_plano: "PADRAO",
+        nome_plano: "Plano Padrão A",
+        prazo_meses: prazoA,
+        taxa_administracao_total: 0.15,
+        fundo_reserva_mensal: 0.0005,
+        seguro_prestamista: 0.035,
+      },
+      tem_lance: temLanceA,
+      lance_percentual: temLanceA ? lancePctA / 100 : undefined,
+    });
+  }, [creditoA, prazoA, temLanceA, lancePctA]);
+
+  const cenarioB = useMemo(() => {
+    return calcularSimulacao({
+      credito_desejado: creditoB,
+      parametros: {
+        id_plano: "PADRAO",
+        nome_plano: "Plano Padrão B",
+        prazo_meses: prazoB,
+        taxa_administracao_total: 0.15,
+        fundo_reserva_mensal: 0.0005,
+        seguro_prestamista: 0.035,
+      },
+      tem_lance: temLanceB,
+      lance_percentual: temLanceB ? lancePctB / 100 : undefined,
+    });
+  }, [creditoB, prazoB, temLanceB, lancePctB]);
+
+  return (
+    <div className="module-container">
+      <div className="module-header">
+        <h1 className="module-title">Comparador de Cenários</h1>
+        <p className="module-subtitle">
+          Análise lado a lado com foco em parcela inicial, prazo, lance e saldo
+          operacional da proposta.
+        </p>
+      </div>
+
+      <div className="page-kpi-strip">
+        <DataCard label="Eixo de decisão" value="Fluxo inicial" subvalue="Peso maior na parcela e no lance" />
+        <DataCard label="Base comparada" value="Plano A vs B" subvalue="Prazo, crédito e contemplação" highlight />
+        <DataCard label="Leitura" value="Executiva" subvalue="Útil para reunião comercial" />
+      </div>
+
+      <div className="executive-banner">
+        <div>
+          <strong>Comparação orientada a decisão.</strong> O objetivo aqui é
+          evidenciar qual cenário preserva melhor o caixa sem degradar o
+          crédito disponível.
+        </div>
+        <div className="executive-banner__meta">
+          <span className="metric-chip">Parcela inicial</span>
+          <span className="metric-chip">Prazo total</span>
+          <span className="metric-chip">Lance embutido</span>
+        </div>
+      </div>
+
+      <div className="module-content" style={{ display: "flex", gap: "24px" }}>
+        {/* Cenário A */}
+        <div
+          style={{
+            flex: 1,
+            display: "flex",
+            flexDirection: "column",
+            gap: "16px",
+          }}
+        >
+          <div
+            style={{
+              padding: "12px 16px",
+              backgroundColor: "var(--color-brand-dark)",
+              color: "white",
+              borderRadius: "4px",
+              fontWeight: 600,
+              textAlign: "center",
+            }}
+          >
+            Cenário A
+          </div>
+          <Card title="Parâmetros">
+            <div
+              style={{ display: "flex", flexDirection: "column", gap: "12px" }}
+            >
+              <Input
+                label="Crédito (R$)"
+                type="number"
+                value={creditoA}
+                onChange={(e) => setCreditoA(Number(e.target.value))}
+              />
+              <Select
+                label="Prazo (meses)"
+                value={prazoA}
+                onChange={(e) => setPrazoA(Number(e.target.value))}
+                options={[
+                  { label: "120", value: 120 },
+                  { label: "150", value: 150 },
+                  { label: "180", value: 180 },
+                  { label: "216", value: 216 },
+                ]}
+              />
+              <div className="ui-form-group">
+                <label
+                  className="ui-form-label"
+                  style={{ display: "flex", alignItems: "center", gap: "8px" }}
+                >
+                  <input
+                    type="checkbox"
+                    checked={temLanceA}
+                    onChange={(e) => setTemLanceA(e.target.checked)}
+                  />{" "}
+                  Com Lance?
+                </label>
+              </div>
+              {temLanceA && (
+                <Input
+                  label="Lance (%)"
+                  type="number"
+                  value={lancePctA}
+                  onChange={(e) => setLancePctA(Number(e.target.value))}
+                />
+              )}
+            </div>
+          </Card>
+          <Card title="Sumário" highlight>
+            <div
+              style={{
+                padding: "16px",
+                display: "flex",
+                flexDirection: "column",
+                gap: "12px",
+              }}
+            >
+              <DataCard
+                label="Crédito"
+                value={formatCurrency(cenarioA.credito)}
+              />
+              <DataCard
+                label="Parcela Inicial Integral"
+                value={formatCurrency(cenarioA.parcela_integral.total)}
+                highlight
+              />
+              <DataCard label="Prazo Total" value={`${cenarioA.prazo} meses`} />
+              {temLanceA && cenarioA.valor_lance && (
+                <DataCard
+                  label="Lance Embutido Estimado"
+                  value={`${formatCurrency(cenarioA.valor_lance)} (${lancePctA}%)`}
+                />
+              )}
+            </div>
+          </Card>
+        </div>
+
+        {/* VS Divider */}
+        <div
+          style={{
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            fontWeight: "bold",
+            color: "var(--text-muted)",
+          }}
+        >
+          VS
+        </div>
+
+        {/* Cenário B */}
+        <div
+          style={{
+            flex: 1,
+            display: "flex",
+            flexDirection: "column",
+            gap: "16px",
+          }}
+        >
+          <div
+            style={{
+              padding: "12px 16px",
+              backgroundColor: "var(--color-brand-accent)",
+              color: "white",
+              borderRadius: "4px",
+              fontWeight: 600,
+              textAlign: "center",
+            }}
+          >
+            Cenário B
+          </div>
+          <Card title="Parâmetros">
+            <div
+              style={{ display: "flex", flexDirection: "column", gap: "12px" }}
+            >
+              <Input
+                label="Crédito (R$)"
+                type="number"
+                value={creditoB}
+                onChange={(e) => setCreditoB(Number(e.target.value))}
+              />
+              <Select
+                label="Prazo (meses)"
+                value={prazoB}
+                onChange={(e) => setPrazoB(Number(e.target.value))}
+                options={[
+                  { label: "120", value: 120 },
+                  { label: "150", value: 150 },
+                  { label: "180", value: 180 },
+                  { label: "216", value: 216 },
+                ]}
+              />
+              <div className="ui-form-group">
+                <label
+                  className="ui-form-label"
+                  style={{ display: "flex", alignItems: "center", gap: "8px" }}
+                >
+                  <input
+                    type="checkbox"
+                    checked={temLanceB}
+                    onChange={(e) => setTemLanceB(e.target.checked)}
+                  />{" "}
+                  Com Lance?
+                </label>
+              </div>
+              {temLanceB && (
+                <Input
+                  label="Lance (%)"
+                  type="number"
+                  value={lancePctB}
+                  onChange={(e) => setLancePctB(Number(e.target.value))}
+                />
+              )}
+            </div>
+          </Card>
+          <Card title="Sumário" highlight>
+            <div
+              style={{
+                padding: "16px",
+                display: "flex",
+                flexDirection: "column",
+                gap: "12px",
+              }}
+            >
+              <DataCard
+                label="Crédito"
+                value={formatCurrency(cenarioB.credito)}
+              />
+              <DataCard
+                label="Parcela Inicial Integral"
+                value={formatCurrency(cenarioB.parcela_integral.total)}
+                highlight
+              />
+              <DataCard label="Prazo Total" value={`${cenarioB.prazo} meses`} />
+              {temLanceB && cenarioB.valor_lance && (
+                <DataCard
+                  label="Lance Embutido Estimado"
+                  value={`${formatCurrency(cenarioB.valor_lance)} (${lancePctB}%)`}
+                />
+              )}
+            </div>
+          </Card>
+        </div>
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/app/configuracoes/page.tsx

@@ -0,0 +1,125 @@
+import { Card, DataCard } from "@/components/ui/Card";
+import { Select } from "@/components/ui/FormControls";
+
+export default function ConfiguracoesPage() {
+  return (
+    <div className="module-container">
+      <div className="module-header">
+        <h1 className="module-title">Configurações de Visualização</h1>
+        <p className="module-subtitle">
+          Ajuste densidade, modo de leitura e profundidade de memória de cálculo.
+        </p>
+      </div>
+
+      <div className="page-kpi-strip">
+        <DataCard label="Perfil padrão" value="Operacional" subvalue="Leitura detalhada de backoffice" />
+        <DataCard label="Saída cliente" value="Executivo" subvalue="Condensa ruído e prioriza proposta" highlight />
+        <DataCard label="Granularidade" value="Configuração fina" subvalue="Composição, cronograma e visão consolidada" />
+      </div>
+
+      <div
+        className="module-content"
+        style={{ display: "flex", flexDirection: "column", gap: "24px" }}
+      >
+        <Card title="Modo de Operação">
+          <div
+            style={{
+              display: "grid",
+              gridTemplateColumns: "1fr 1fr",
+              gap: "16px",
+            }}
+          >
+            <Select
+              label="Modo"
+              options={[
+                { label: "Operacional (Detalhado)", value: "operacional" },
+                { label: "Executivo (Sumarizado)", value: "executivo" },
+                { label: "Cliente (Simplificado)", value: "cliente" },
+              ]}
+              defaultValue="operacional"
+            />
+            <Select
+              label="Densidade da Interface"
+              options={[
+                { label: "Compacta (Mais dados)", value: "compacta" },
+                { label: "Confortável (Melhor leitura)", value: "confortavel" },
+              ]}
+              defaultValue="compacta"
+            />
+          </div>
+        </Card>
+
+        <Card title="Preferências do Simulador">
+          <div
+            style={{ display: "grid", gridTemplateColumns: "1fr", gap: "12px" }}
+          >
+            <label
+              style={{
+                display: "flex",
+                alignItems: "center",
+                gap: "8px",
+                fontSize: "0.9rem",
+              }}
+            >
+              <input type="checkbox" defaultChecked /> Mostrar composição da
+              parcela
+            </label>
+            <label
+              style={{
+                display: "flex",
+                alignItems: "center",
+                gap: "8px",
+                fontSize: "0.9rem",
+              }}
+            >
+              <input type="checkbox" defaultChecked /> Mostrar memória de
+              cálculo expandida
+            </label>
+            <label
+              style={{
+                display: "flex",
+                alignItems: "center",
+                gap: "8px",
+                fontSize: "0.9rem",
+              }}
+            >
+              <input type="checkbox" /> Mostrar cronograma mensal completo
+            </label>
+            <label
+              style={{
+                display: "flex",
+                alignItems: "center",
+                gap: "8px",
+                fontSize: "0.9rem",
+              }}
+            >
+              <input type="checkbox" defaultChecked /> Destacar números
+              absolutos vs percentuais
+            </label>
+            <label
+              style={{
+                display: "flex",
+                alignItems: "center",
+                gap: "8px",
+                fontSize: "0.9rem",
+              }}
+            >
+              <input type="checkbox" /> Visão consolidada por múltiplas cotas
+            </label>
+          </div>
+        </Card>
+
+        <div
+          style={{
+            display: "flex",
+            justifyContent: "flex-end",
+            gap: "12px",
+            marginTop: "16px",
+          }}
+        >
+          <button className="btn btn-primary">Aplicar Configurações</button>
+        </div>
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/app/globals.css

@@ -0,0 +1,259 @@
+@import "tailwindcss";
+
+:root {
+  --background: #f3f0eb;
+  --foreground: #1c2733;
+  --bg-main: #ece7e0;
+  --bg-panel: #ffffff;
+  --bg-panel-soft: #f8f5f1;
+  --bg-panel-accent: #edf4fb;
+  --bg-panel-dark: #0f2743;
+  --bg-sidebar: #09213d;
+  --border-color: #d7d2c8;
+  --border-strong: #c5bcae;
+  --text-main: #1c2733;
+  --text-muted: #667285;
+  --text-soft: #8f9aac;
+  --color-brand-dark: #0d2d52;
+  --color-brand-accent: #ec5b13;
+  --color-brand-accent-strong: #cb4610;
+  --color-brand-light: #dcebf7;
+  --status-positive: #1c7c54;
+  --status-warning: #9a6700;
+  --status-negative: #c2410c;
+  --status-info: #2563eb;
+  --shadow-panel: 0 10px 24px rgba(11, 27, 49, 0.06);
+  --shadow-soft: 0 2px 6px rgba(15, 39, 67, 0.08);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: "Public Sans", "IBM Plex Sans", "Aptos", "Segoe UI", sans-serif;
+  --font-mono: "SFMono-Regular", "Menlo", "Monaco", "Consolas", monospace;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  min-height: 100%;
+}
+
+body {
+  margin: 0;
+  background:
+    linear-gradient(180deg, rgba(255, 255, 255, 0.55), rgba(255, 255, 255, 0))
+      0 0 / 100% 180px no-repeat,
+    var(--background);
+  color: var(--text-main);
+  font-family: var(--font-sans);
+}
+
+a {
+  color: inherit;
+}
+
+button,
+input,
+select,
+textarea {
+  font: inherit;
+}
+
+.page-kpi-strip {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 12px;
+  margin-bottom: 20px;
+}
+
+.executive-banner {
+  display: flex;
+  justify-content: space-between;
+  gap: 16px;
+  align-items: center;
+  padding: 14px 18px;
+  border: 1px solid var(--border-color);
+  border-left: 4px solid var(--color-brand-accent);
+  border-radius: 8px;
+  background: linear-gradient(90deg, rgba(236, 91, 19, 0.08), rgba(13, 45, 82, 0.04));
+  color: var(--text-main);
+}
+
+.executive-banner strong {
+  color: var(--color-brand-dark);
+}
+
+.executive-banner__meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.metric-chip,
+.status-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  min-height: 30px;
+  padding: 0 10px;
+  border-radius: 999px;
+  font-size: 0.73rem;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+}
+
+.metric-chip {
+  background: rgba(13, 45, 82, 0.08);
+  color: var(--color-brand-dark);
+}
+
+.status-chip {
+  border: 1px solid transparent;
+}
+
+.status-chip.status-live {
+  background: rgba(28, 124, 84, 0.1);
+  color: var(--status-positive);
+  border-color: rgba(28, 124, 84, 0.18);
+}
+
+.status-chip.status-warning {
+  background: rgba(154, 103, 0, 0.1);
+  color: var(--status-warning);
+  border-color: rgba(154, 103, 0, 0.2);
+}
+
+.status-chip.status-info {
+  background: rgba(37, 99, 235, 0.08);
+  color: var(--status-info);
+  border-color: rgba(37, 99, 235, 0.18);
+}
+
+.section-grid {
+  display: grid;
+  gap: 20px;
+}
+
+.section-grid--2 {
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+}
+
+.section-grid--3 {
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+}
+
+.section-grid--simulator {
+  grid-template-columns: minmax(0, 1.75fr) minmax(320px, 0.95fr);
+}
+
+.section-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+.field-grid {
+  display: grid;
+  gap: 16px;
+}
+
+.field-grid--2 {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.field-grid--3 {
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+}
+
+.field-grid--4 {
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+}
+
+.summary-rail {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+.plain-note {
+  margin: 0;
+  font-size: 0.84rem;
+  color: var(--text-muted);
+  line-height: 1.55;
+}
+
+.inline-toggle {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  font-size: 0.84rem;
+  color: var(--text-main);
+}
+
+.table-note {
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 12px 16px;
+  border-top: 1px solid var(--border-color);
+  background: var(--bg-panel-soft);
+  color: var(--text-muted);
+  font-size: 0.78rem;
+}
+
+.sheet-frame {
+  background: var(--bg-panel);
+  border: 1px solid var(--border-strong);
+  border-radius: 10px;
+  box-shadow: var(--shadow-panel);
+}
+
+.sheet-section-title {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 14px;
+}
+
+.sheet-section-title h2,
+.sheet-section-title h3 {
+  margin: 0;
+  font-size: 1rem;
+  font-weight: 700;
+  color: var(--color-brand-dark);
+}
+
+.muted-divider {
+  height: 1px;
+  background: var(--border-color);
+  margin: 8px 0 0;
+}
+
+@media (max-width: 1180px) {
+  .section-grid--simulator {
+    grid-template-columns: 1fr;
+  }
+
+  .field-grid--4 {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+
+@media (max-width: 768px) {
+  .executive-banner {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .field-grid--2,
+  .field-grid--3,
+  .field-grid--4 {
+    grid-template-columns: 1fr;
+  }
+}

apps/web_comercial/src/app/layout.tsx

@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+import { Public_Sans } from "next/font/google";
+import { AppLayout } from "@/components/layout/AppLayout";
+import "./globals.css";
+import "@/components/layout/layout.css";
+import "@/components/ui/ui.css";
+
+const publicSans = Public_Sans({
+  subsets: ["latin"],
+  display: "swap",
+});
+
+export const metadata: Metadata = {
+  title: "Apex Consorcios | Simulador",
+  description: "Simulador deterministico de consorcio imobiliario",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="pt-BR">
+      <body className={`${publicSans.className} antialiased`}>
+        <AppLayout>{children}</AppLayout>
+      </body>
+    </html>
+  );
+}

apps/web_comercial/src/app/mercado-secundario/page.tsx

@@ -0,0 +1,534 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import {
+  listarPerfisFluxoScpDefault,
+  simularModoConversaoScpConsorcio,
+  simularSecundarioComPerfilScp,
+  type ResultadoSimulacaoConversaoScpConsorcio,
+  type ResultadoSimulacaoSecundarioComPerfil,
+} from "@simulador-consorcio/simulation-engine";
+import { Card, DataCard } from "@/components/ui/Card";
+import { Input, Select } from "@/components/ui/FormControls";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/Table";
+
+const catalogoDefault = listarPerfisFluxoScpDefault();
+type ModoSimulacao = "secundario_padrao" | "conversao_scp_imovel_consorcio";
+type ResultadoTela =
+  | ResultadoSimulacaoSecundarioComPerfil
+  | ResultadoSimulacaoConversaoScpConsorcio;
+
+function formatCurrency(value: number) {
+  return new Intl.NumberFormat("pt-BR", {
+    style: "currency",
+    currency: "BRL",
+  }).format(value);
+}
+
+function formatPercent(value: number | null | undefined) {
+  if (value === null || value === undefined) {
+    return "--";
+  }
+  return `${(value * 100).toFixed(2)}%`;
+}
+
+export default function MercadoSecundarioPage() {
+  const activeClient =
+    catalogoDefault.clients.find((client) => client.status === "ativo") ||
+    catalogoDefault.clients[0];
+
+  const [modoSimulacao, setModoSimulacao] =
+    useState<ModoSimulacao>("secundario_padrao");
+  const [clienteId, setClienteId] = useState(activeClient.client_id);
+  const [patternId, setPatternId] = useState(activeClient.default_pattern_id);
+  const [novoClienteId, setNovoClienteId] = useState("");
+  const [novoClienteNome, setNovoClienteNome] = useState("");
+  const [escalaFluxo, setEscalaFluxo] = useState(1);
+  const [deslocamentoMeses, setDeslocamentoMeses] = useState(0);
+  const [portabilidadeContempladaPct, setPortabilidadeContempladaPct] =
+    useState(1);
+  const [portabilidadeNaoContempladaPct, setPortabilidadeNaoContempladaPct] =
+    useState(0.5);
+  const [feePct, setFeePct] = useState(2);
+  const [volumeContratado, setVolumeContratado] = useState(300000);
+  const [percentualCartasReduzidaPct, setPercentualCartasReduzidaPct] =
+    useState(100);
+  const [mesesPosContemplacao, setMesesPosContemplacao] = useState(0);
+  const [valorImovelBase, setValorImovelBase] = useState(600000);
+  const [descontoImovelPct, setDescontoImovelPct] = useState(15);
+  const [percentualEntradaImovelPct, setPercentualEntradaImovelPct] =
+    useState(25);
+  const [agioConsorcioPct, setAgioConsorcioPct] = useState(10);
+  const [taxaCustosTransacaoPct, setTaxaCustosTransacaoPct] = useState(2);
+  const [resultado, setResultado] = useState<ResultadoTela | null>(null);
+  const [erro, setErro] = useState<string | null>(null);
+
+  const clienteSelecionado = useMemo(
+    () => catalogoDefault.clients.find((client) => client.client_id === clienteId),
+    [clienteId]
+  );
+
+  const resumoFluxo = useMemo(() => {
+    if (!resultado) {
+      return null;
+    }
+    return resultado.fluxo_cliente.pontos.slice(0, 12);
+  }, [resultado]);
+
+  const handleClienteChange = (nextClientId: string) => {
+    setClienteId(nextClientId);
+    const client = catalogoDefault.clients.find((item) => item.client_id === nextClientId);
+    if (client) {
+      setPatternId(client.default_pattern_id);
+    }
+  };
+
+  const handleSimular = () => {
+    try {
+      setErro(null);
+      const baseInput = {
+        client_id: clienteId,
+        pattern_id: patternId,
+        novo_client_id: novoClienteId || undefined,
+        novo_client_name: novoClienteNome || undefined,
+        escala_fluxo: escalaFluxo,
+        deslocamento_meses: deslocamentoMeses,
+        portabilidade_percentual_contemplada: portabilidadeContempladaPct / 100,
+        portabilidade_percentual_nao_contemplada:
+          portabilidadeNaoContempladaPct / 100,
+        fee_percentual: feePct / 100,
+        volume_contratado: volumeContratado,
+        percentual_cartas_parcela_reduzida: percentualCartasReduzidaPct / 100,
+        meses_pos_ultima_contemplacao: mesesPosContemplacao,
+      };
+      const simulacao =
+        modoSimulacao === "conversao_scp_imovel_consorcio"
+          ? simularModoConversaoScpConsorcio({
+              ...baseInput,
+              valor_imovel_base: valorImovelBase,
+              desconto_imovel_percentual: descontoImovelPct / 100,
+              percentual_entrada_imovel: percentualEntradaImovelPct / 100,
+              agio_consorcio_percentual: agioConsorcioPct / 100,
+              taxa_custos_transacao_percentual: taxaCustosTransacaoPct / 100,
+            })
+          : simularSecundarioComPerfilScp(baseInput);
+      setResultado(simulacao);
+    } catch (simulationError) {
+      const message =
+        simulationError instanceof Error
+          ? simulationError.message
+          : "Falha ao simular cenário do mercado secundário.";
+      setErro(message);
+      setResultado(null);
+    }
+  };
+
+  return (
+    <div className="module-container">
+      <div
+        className="module-header"
+        style={{
+          display: "flex",
+          justifyContent: "space-between",
+          alignItems: "center",
+        }}
+      >
+        <div>
+          <h1 className="module-title">Mercado Secundário</h1>
+          <p className="module-subtitle">
+            Simulação parametrizada por cliente SCP com base nos padrões de fluxo
+            entregues.
+          </p>
+        </div>
+        <div style={{ display: "flex", gap: "12px" }}>
+          <button className="btn btn-secondary">Exportar Relatório</button>
+          <button className="btn btn-primary" onClick={handleSimular}>
+            Simular Cenário
+          </button>
+        </div>
+      </div>
+
+      <div className="page-kpi-strip">
+        <DataCard
+          label="Carteira"
+          value={clienteSelecionado?.client_name ?? "Cliente SCP"}
+          subvalue={`Padrão ${patternId}`}
+        />
+        <DataCard
+          label="Modo"
+          value={
+            modoSimulacao === "conversao_scp_imovel_consorcio"
+              ? "Conversão SCP"
+              : "Secundário padrão"
+          }
+          subvalue="Fluxo operacional por cliente"
+          highlight
+        />
+        <DataCard
+          label="Volume contratado"
+          value={formatCurrency(volumeContratado)}
+          subvalue={`${percentualCartasReduzidaPct}% da carteira reduzida`}
+        />
+        <DataCard
+          label="Fee"
+          value={`${feePct.toFixed(2)}%`}
+          subvalue={`Deslocamento ${deslocamentoMeses} meses`}
+        />
+      </div>
+
+      <div className="executive-banner">
+        <div>
+          <strong>Mercado secundário com leitura operacional.</strong> A tela
+          combina fluxo SCP, portabilidade e conversão para compra de imóvel em
+          uma visão única de decisão.
+        </div>
+        <div className="executive-banner__meta">
+          <span className="metric-chip">Fluxo cliente</span>
+          <span className="metric-chip">Resultado APEX</span>
+          <span className="metric-chip">Retorno anual</span>
+        </div>
+      </div>
+
+      <div
+        className="module-content"
+        style={{ display: "flex", flexDirection: "column", gap: "24px" }}
+      >
+        <Card title="Cliente e Padrão de Fluxo SCP">
+          <div
+            style={{
+              display: "grid",
+              gridTemplateColumns: "repeat(4, minmax(180px, 1fr))",
+              gap: "16px",
+            }}
+          >
+            <Select
+              label="Modo de Simulação"
+              value={modoSimulacao}
+              onChange={(event) =>
+                setModoSimulacao(event.target.value as ModoSimulacao)
+              }
+              options={[
+                { value: "secundario_padrao", label: "Secundário padrão" },
+                {
+                  value: "conversao_scp_imovel_consorcio",
+                  label: "Conversão SCP -> Imóvel + Secundário",
+                },
+              ]}
+            />
+            <Select
+              label="Cliente Default"
+              value={clienteId}
+              onChange={(event) => handleClienteChange(event.target.value)}
+              options={catalogoDefault.clients.map((client) => ({
+                value: client.client_id,
+                label: `${client.client_name} (${client.status})`,
+              }))}
+            />
+            <Select
+              label="Padrão de Fluxo"
+              value={patternId}
+              onChange={(event) => setPatternId(event.target.value)}
+              options={catalogoDefault.patterns.map((pattern) => ({
+                value: pattern.id,
+                label: `${pattern.nome} (${pattern.pontos} pontos)`,
+              }))}
+            />
+            <Input
+              label="Novo Cliente ID (opcional)"
+              value={novoClienteId}
+              onChange={(event) => setNovoClienteId(event.target.value)}
+              placeholder="cliente_scp_001"
+            />
+            <Input
+              label="Novo Cliente Nome (opcional)"
+              value={novoClienteNome}
+              onChange={(event) => setNovoClienteNome(event.target.value)}
+              placeholder="Cliente SCP 001"
+            />
+            <Input
+              label="Escala de Fluxo"
+              type="number"
+              value={escalaFluxo}
+              onChange={(event) => setEscalaFluxo(Number(event.target.value || 0))}
+              step="0.1"
+            />
+            <Input
+              label="Deslocamento (meses)"
+              type="number"
+              value={deslocamentoMeses}
+              onChange={(event) =>
+                setDeslocamentoMeses(Number(event.target.value || 0))
+              }
+              step="1"
+            />
+            <Input
+              label="Portabilidade Contemplada"
+              type="number"
+              value={portabilidadeContempladaPct}
+              onChange={(event) =>
+                setPortabilidadeContempladaPct(Number(event.target.value || 0))
+              }
+              suffix="%"
+            />
+            <Input
+              label="Portabilidade Não Contemplada"
+              type="number"
+              value={portabilidadeNaoContempladaPct}
+              onChange={(event) =>
+                setPortabilidadeNaoContempladaPct(Number(event.target.value || 0))
+              }
+              suffix="%"
+            />
+            <Input
+              label="Fee"
+              type="number"
+              value={feePct}
+              onChange={(event) => setFeePct(Number(event.target.value || 0))}
+              suffix="%"
+            />
+            <Input
+              label="Volume Contratado"
+              type="number"
+              value={volumeContratado}
+              onChange={(event) =>
+                setVolumeContratado(Number(event.target.value || 0))
+              }
+              prefix="R$"
+            />
+            <Input
+              label="% Cartas com Parcela Reduzida"
+              type="number"
+              value={percentualCartasReduzidaPct}
+              onChange={(event) =>
+                setPercentualCartasReduzidaPct(Number(event.target.value || 0))
+              }
+              suffix="%"
+            />
+            <Input
+              label="Meses Pós Última Contemplação"
+              type="number"
+              value={mesesPosContemplacao}
+              onChange={(event) =>
+                setMesesPosContemplacao(Number(event.target.value || 0))
+              }
+              step="1"
+            />
+            {modoSimulacao === "conversao_scp_imovel_consorcio" && (
+              <>
+                <Input
+                  label="Valor Base do Imóvel"
+                  type="number"
+                  value={valorImovelBase}
+                  onChange={(event) =>
+                    setValorImovelBase(Number(event.target.value || 0))
+                  }
+                  prefix="R$"
+                />
+                <Input
+                  label="Desconto Imóvel"
+                  type="number"
+                  value={descontoImovelPct}
+                  onChange={(event) =>
+                    setDescontoImovelPct(Number(event.target.value || 0))
+                  }
+                  suffix="%"
+                />
+                <Input
+                  label="Entrada da Compra"
+                  type="number"
+                  value={percentualEntradaImovelPct}
+                  onChange={(event) =>
+                    setPercentualEntradaImovelPct(Number(event.target.value || 0))
+                  }
+                  suffix="%"
+                />
+                <Input
+                  label="Ágio no Secundário"
+                  type="number"
+                  value={agioConsorcioPct}
+                  onChange={(event) =>
+                    setAgioConsorcioPct(Number(event.target.value || 0))
+                  }
+                  suffix="%"
+                />
+                <Input
+                  label="Custos de Transação"
+                  type="number"
+                  value={taxaCustosTransacaoPct}
+                  onChange={(event) =>
+                    setTaxaCustosTransacaoPct(Number(event.target.value || 0))
+                  }
+                  suffix="%"
+                />
+              </>
+            )}
+          </div>
+          {clienteSelecionado && (
+            <p style={{ marginTop: "12px", color: "var(--text-muted)" }}>
+              Cliente selecionado: <strong>{clienteSelecionado.client_name}</strong>.
+              Padrão default: <code>{clienteSelecionado.default_pattern_id}</code>.
+            </p>
+          )}
+          {modoSimulacao === "conversao_scp_imovel_consorcio" && (
+            <p style={{ marginTop: "6px", color: "var(--text-muted)" }}>
+              Modo conversão é um cenário fechado parametrizado para SCP -&gt; compra
+              de imóvel com desconto + operação no secundário.
+            </p>
+          )}
+        </Card>
+
+        {erro && (
+          <Card title="Erro de Simulação">
+            <p style={{ color: "var(--status-negative)" }}>{erro}</p>
+          </Card>
+        )}
+
+        <Card title="Resultado do Cenário" noPadding>
+          {resultado ? (
+            <div style={{ padding: "20px", display: "flex", flexDirection: "column", gap: "20px" }}>
+              <div
+                style={{
+                  display: "grid",
+                  gridTemplateColumns: "repeat(4, minmax(170px, 1fr))",
+                  gap: "12px",
+                }}
+              >
+                <DataCard
+                  label="Payback"
+                  value={
+                    resultado.payback_meses === null
+                      ? "Sem retorno"
+                      : `${resultado.payback_meses} meses`
+                  }
+                />
+                <DataCard
+                  label="TIR Mensal"
+                  value={formatPercent(resultado.tir_mensal)}
+                />
+                <DataCard
+                  label="TIR Anual"
+                  value={formatPercent(resultado.tir_anual)}
+                />
+                <DataCard
+                  label="Caixa Máximo Negativo"
+                  value={formatCurrency(resultado.caixa_maximo_negativo)}
+                />
+                <DataCard
+                  label="Custo Portabilidade"
+                  value={formatCurrency(resultado.custo_portabilidade)}
+                />
+                <DataCard
+                  label="Custo Fee 70%"
+                  value={formatCurrency(resultado.custo_fee_parcela_reduzida)}
+                />
+                <DataCard
+                  label="Deduções Totais"
+                  value={formatCurrency(resultado.custo_total_deducoes)}
+                />
+                <DataCard
+                  label="Cliente Simulado"
+                  value={resultado.fluxo_cliente.client_name}
+                  subvalue={resultado.fluxo_cliente.client_id}
+                />
+              </div>
+
+              {"modo_conversao" in resultado && (
+                <Card title="Métricas do Modo Conversão">
+                  <div
+                    style={{
+                      display: "grid",
+                      gridTemplateColumns: "repeat(4, minmax(160px, 1fr))",
+                      gap: "12px",
+                    }}
+                  >
+                    <DataCard
+                      label="Valor Imóvel Base"
+                      value={formatCurrency(resultado.modo_conversao.valor_imovel_base)}
+                    />
+                    <DataCard
+                      label="Valor com Desconto"
+                      value={formatCurrency(
+                        resultado.modo_conversao.valor_imovel_com_desconto
+                      )}
+                    />
+                    <DataCard
+                      label="Entrada Imóvel"
+                      value={formatCurrency(
+                        resultado.modo_conversao.valor_entrada_imovel
+                      )}
+                    />
+                    <DataCard
+                      label="Crédito Consórcio"
+                      value={formatCurrency(
+                        resultado.modo_conversao.valor_credito_consorcio
+                      )}
+                    />
+                    <DataCard
+                      label="Custo Transação"
+                      value={formatCurrency(
+                        resultado.modo_conversao.valor_custos_transacao
+                      )}
+                    />
+                    <DataCard
+                      label="Investimento Conversão"
+                      value={formatCurrency(
+                        resultado.modo_conversao.investimento_total_conversao
+                      )}
+                    />
+                    <DataCard
+                      label="Saída no Secundário"
+                      value={formatCurrency(
+                        resultado.modo_conversao.valor_saida_consorcio_secundario
+                      )}
+                    />
+                    <DataCard
+                      label="Lucro Projetado"
+                      value={formatCurrency(
+                        resultado.modo_conversao.lucro_projetado_conversao
+                      )}
+                      subvalue={`ROI ${formatPercent(
+                        resultado.modo_conversao.roi_projetado_conversao
+                      )}`}
+                    />
+                  </div>
+                </Card>
+              )}
+
+              <Table>
+                <TableHead>
+                  <TableRow>
+                    <TableHeader>Período</TableHeader>
+                    <TableHeader style={{ textAlign: "right" }}>
+                      Fluxo (R$)
+                    </TableHeader>
+                  </TableRow>
+                </TableHead>
+                <TableBody>
+                  {(resumoFluxo || []).map((point) => (
+                    <TableRow key={`${point.periodo}-${point.fluxo}`}>
+                      <TableCell>{point.periodo}</TableCell>
+                      <TableCell style={{ textAlign: "right", fontFamily: "monospace" }}>
+                        {formatCurrency(point.fluxo)}
+                      </TableCell>
+                    </TableRow>
+                  ))}
+                </TableBody>
+              </Table>
+            </div>
+          ) : (
+            <div style={{ padding: "20px", color: "var(--text-muted)" }}>
+              Selecione um cliente/padrão e clique em <strong>Simular Cenário</strong>.
+            </div>
+          )}
+        </Card>
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/app/page.tsx

@@ -0,0 +1,57 @@
+import { SimulatorForm } from "@/components/simulator/SimulatorForm";
+import { DataCard } from "@/components/ui/Card";
+
+export default function Home() {
+  return (
+    <div className="module-container">
+      <div className="module-header">
+        <h1 className="module-title">Simulador de Consórcio Imobiliário</h1>
+        <p className="module-subtitle">
+          Estrutura operacional inspirada na planilha Rodobens/BTG, com leitura
+          tabular, resumo executivo e preparação de proposta cliente.
+        </p>
+      </div>
+
+      <div className="page-kpi-strip">
+        <DataCard
+          label="Escopo"
+          value="Somente imóvel"
+          subvalue="Produto bloqueado para carteira imobiliária"
+        />
+        <DataCard
+          label="Base operacional"
+          value="Workbook Rodobens"
+          subvalue="Degrau, Linear, Pontual e variantes reduzidas"
+          highlight
+        />
+        <DataCard
+          label="Modo"
+          value="Operacional"
+          subvalue="Resumo geral, CET e memória de cálculo"
+        />
+        <DataCard
+          label="Status"
+          value="Pronto para validação"
+          subvalue="Comparador, proposta, premissas e configurações ativos"
+        />
+      </div>
+
+      <div className="executive-banner">
+        <div>
+          <strong>Leitura de planilha convertida em software.</strong> O foco
+          aqui não é marketing; é velocidade operacional, legibilidade numérica
+          e confiança para originar proposta.
+        </div>
+        <div className="executive-banner__meta">
+          <span className="status-chip status-live">Motor determinístico</span>
+          <span className="metric-chip">Resumo geral ativo</span>
+          <span className="metric-chip">CET e ao mês</span>
+        </div>
+      </div>
+
+      <div className="module-content">
+        <SimulatorForm />
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/app/premissas/page.tsx

@@ -0,0 +1,88 @@
+import { Card, DataCard } from "@/components/ui/Card";
+import { Input, Select } from "@/components/ui/FormControls";
+
+export default function PremissasPage() {
+  return (
+    <div className="module-container">
+      <div className="module-header">
+        <h1 className="module-title">Premissas Operacionais</h1>
+        <p className="module-subtitle">
+          Parametrização central de regras, metas e datas que alimentam o motor
+          determinístico.
+        </p>
+      </div>
+
+      <div className="page-kpi-strip">
+        <DataCard label="Objetivo" value="Governança do cálculo" subvalue="Hipóteses macro e políticas de operação" />
+        <DataCard label="Critério" value="Payback e retorno" subvalue="Premissas usadas na leitura executiva" highlight />
+        <DataCard label="Impacto" value="Todas as rotas" subvalue="Simulador, comparador e proposta" />
+      </div>
+
+      <div
+        className="module-content"
+        style={{ display: "flex", flexDirection: "column", gap: "24px" }}
+      >
+        <Card title="Hipóteses Macroeconômicas e Objetivos">
+          <div
+            style={{
+              display: "grid",
+              gridTemplateColumns: "1fr 1fr 1fr",
+              gap: "16px",
+            }}
+          >
+            <Input label="Retorno Alvo Anual" defaultValue={15} suffix="%" />
+            <Input label="Custo de Portabilidade" defaultValue={0} suffix="%" />
+            <Select
+              label="Objetivo da Operação"
+              options={[
+                { label: "Formação de Patrimônio", value: "patrimonio" },
+                { label: "Alavancagem", value: "alavancagem" },
+              ]}
+            />
+            <Select
+              label="Regra de Reajuste"
+              options={[
+                { label: "INCC + IGP-M Anual", value: "incc" },
+                { label: "Fixo", value: "fixo" },
+              ]}
+            />
+            <Input label="Payback Desejado" defaultValue={48} suffix=" Meses" />
+          </div>
+        </Card>
+
+        <Card title="Eventos e Faturamento">
+          <div
+            style={{
+              display: "grid",
+              gridTemplateColumns: "1fr 1fr",
+              gap: "16px",
+            }}
+          >
+            <Input label="Data do Próximo Sorteio" type="date" />
+            <Input label="Data da Próxima AGE" type="date" />
+            <Input label="Último Lance Vencedor" defaultValue={32} suffix="%" />
+            <Select
+              label="Política para Não Contemplados"
+              options={[
+                { label: "Liquidar no secundário em 12m", value: "12m" },
+                { label: "Manter até o fim", value: "fim" },
+              ]}
+            />
+          </div>
+        </Card>
+
+        <div
+          style={{
+            display: "flex",
+            justifyContent: "flex-end",
+            gap: "12px",
+            marginTop: "16px",
+          }}
+        >
+          <button className="btn btn-secondary">Descartar Alterações</button>
+          <button className="btn btn-primary">Salvar Premissas</button>
+        </div>
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/app/proposta/page.tsx

@@ -0,0 +1,235 @@
+"use client";
+
+import { DataCard } from "@/components/ui/Card";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/Table";
+import { calcularSimulacao } from "@simulador-consorcio/simulation-engine";
+import { useMemo } from "react";
+
+function formatCurrency(value: number) {
+  return new Intl.NumberFormat("pt-BR", {
+    style: "currency",
+    currency: "BRL",
+  }).format(value);
+}
+
+export default function PropostaPage() {
+  // Configuração Fixa Simulada para a Proposta Executiva
+  const propostaData = useMemo(() => {
+    return calcularSimulacao({
+      credito_desejado: 500000,
+      parametros: {
+        id_plano: "PADRAO",
+        nome_plano: "Plano Padrão Imóvel",
+        prazo_meses: 180,
+        taxa_administracao_total: 0.15,
+        fundo_reserva_mensal: 0.0005,
+        seguro_prestamista: 0.035,
+      },
+      tem_lance: true,
+      lance_percentual: 0.3,
+    });
+  }, []);
+
+  return (
+    <div className="module-container" style={{ maxWidth: "960px", margin: "0 auto" }}>
+      <div className="page-kpi-strip">
+        <DataCard label="Formato" value="Proposta cliente" subvalue="Documento financeiro compacto" />
+        <DataCard label="Base" value="Simulação determinística" subvalue="Valores derivados do motor atual" highlight />
+        <DataCard label="Uso" value="PDF / reunião" subvalue="Leitura mais limpa que a visão operacional" />
+      </div>
+
+      <div className="sheet-frame">
+        <div
+          className="module-header"
+          style={{
+            borderBottom: "2px solid var(--color-brand-dark)",
+            padding: "32px 32px 16px",
+            marginBottom: 0,
+          }}
+        >
+          <h1
+            className="module-title"
+            style={{
+              textAlign: "center",
+              color: "var(--color-brand-dark)",
+              textTransform: "uppercase",
+              letterSpacing: "1px",
+            }}
+          >
+            Proposta Personalizada
+          </h1>
+          <p className="module-subtitle" style={{ textAlign: "center" }}>
+            Apex Consórcios - Especialistas em Patrimônio
+          </p>
+        </div>
+
+        <div
+          className="module-content"
+          style={{
+            padding: "32px",
+            backgroundColor: "transparent",
+            border: "none",
+            boxShadow: "none",
+          }}
+        >
+          <div style={{ marginBottom: "32px" }}>
+            <h2
+              style={{
+                fontSize: "1.2rem",
+                color: "var(--color-brand-accent)",
+                borderBottom: "1px solid var(--border-color)",
+                paddingBottom: "8px",
+                marginBottom: "16px",
+              }}
+            >
+              Dados Gerais
+            </h2>
+            <div
+              style={{
+                display: "grid",
+                gridTemplateColumns: "1fr 1fr",
+                gap: "16px",
+              }}
+            >
+              <DataCard label="Cliente" value="João da Silva" />
+              <DataCard label="Especialista" value="Maria Oliveira" />
+              <DataCard
+                label="Data da Proposta"
+                value={new Date().toLocaleDateString("pt-BR")}
+              />
+              <DataCard label="Validade" value="15 Dias" />
+            </div>
+          </div>
+
+          <div style={{ marginBottom: "32px" }}>
+            <h2
+              style={{
+                fontSize: "1.2rem",
+                color: "var(--color-brand-accent)",
+                borderBottom: "1px solid var(--border-color)",
+                paddingBottom: "8px",
+                marginBottom: "16px",
+              }}
+            >
+              Plano Recomendado: Imóvel Padrão Linear
+            </h2>
+            <Table>
+              <TableHead>
+                <TableRow>
+                  <TableHeader>Parâmetro</TableHeader>
+                  <TableHeader style={{ textAlign: "right" }}>Valor</TableHeader>
+                </TableRow>
+              </TableHead>
+              <TableBody>
+                <TableRow>
+                  <TableCell>Crédito Total</TableCell>
+                  <TableCell style={{ textAlign: "right", fontWeight: 600 }}>
+                    {formatCurrency(propostaData.credito)}
+                  </TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Prazo Total</TableCell>
+                  <TableCell style={{ textAlign: "right" }}>
+                    {propostaData.prazo} Meses
+                  </TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Parcela Base (S/ Redução)</TableCell>
+                  <TableCell
+                    style={{
+                      textAlign: "right",
+                      color: "var(--color-brand-accent)",
+                      fontWeight: 600,
+                    }}
+                  >
+                    {formatCurrency(propostaData.parcela_integral.total)}
+                  </TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Taxa de Administração Total</TableCell>
+                  <TableCell style={{ textAlign: "right" }}>15,00%</TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Fundo de Reserva</TableCell>
+                  <TableCell style={{ textAlign: "right" }}>Mensal</TableCell>
+                </TableRow>
+              </TableBody>
+            </Table>
+          </div>
+
+          <div style={{ marginBottom: "32px" }}>
+            <h2
+              style={{
+                fontSize: "1.2rem",
+                color: "var(--color-brand-accent)",
+                borderBottom: "1px solid var(--border-color)",
+                paddingBottom: "8px",
+                marginBottom: "16px",
+              }}
+            >
+              Estimativa Pós Contemplação (Lance 30%)
+            </h2>
+            <div
+              style={{
+                display: "grid",
+                gridTemplateColumns: "1fr 1fr 1fr",
+                gap: "16px",
+              }}
+            >
+              <DataCard
+                label="Lance Embutido Estimado"
+                value={formatCurrency(propostaData.valor_lance || 0)}
+              />
+              <DataCard
+                label="Crédito Disponível Líquido"
+                value={formatCurrency(
+                  propostaData.credito - (propostaData.valor_lance || 0),
+                )}
+                highlight
+              />
+              <DataCard
+                label="Prazo Restante Estimado"
+                value={`${propostaData.prazo_apos_lance || propostaData.prazo} Meses`}
+              />
+            </div>
+          </div>
+
+          <div>
+            <h2
+              style={{
+                fontSize: "1.2rem",
+                color: "var(--color-brand-accent)",
+                borderBottom: "1px solid var(--border-color)",
+                paddingBottom: "8px",
+                marginBottom: "16px",
+              }}
+            >
+              Informações Adicionais
+            </h2>
+            <p
+              style={{
+                fontSize: "0.85rem",
+                color: "var(--text-muted)",
+                lineHeight: 1.5,
+              }}
+            >
+              Os valores apresentados acima representam uma estimativa
+              determinística de cenário futuro e não constituem garantia de
+              contemplação. O custo efetivo total não considera reajustes
+              monetários aplicáveis conforme contrato. A taxa administrativa já
+              engloba o período selecionado de parcelamento. A viabilidade é
+              baseada nas regras operacionais vigentes.
+            </p>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/components/layout/AppLayout.tsx

@@ -0,0 +1,19 @@
+import React from "react";
+import { Sidebar } from "./Sidebar";
+import { Topbar } from "./Topbar";
+
+interface AppLayoutProps {
+  children: React.ReactNode;
+}
+
+export function AppLayout({ children }: AppLayoutProps) {
+  return (
+    <div className="app-container">
+      <Sidebar />
+      <div className="app-main">
+        <Topbar />
+        <main className="app-content">{children}</main>
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/components/layout/Sidebar.tsx

@@ -0,0 +1,72 @@
+"use client";
+
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+
+const navigationItems = [
+  { href: "/", label: "Simulador", meta: "Operacional" },
+  {
+    href: "/mercado-secundario",
+    label: "Mercado Secundário",
+    meta: "Portfólio",
+  },
+  { href: "/comparador", label: "Comparador", meta: "Cenários" },
+  { href: "/proposta", label: "Proposta", meta: "Cliente" },
+  { href: "/premissas", label: "Premissas", meta: "Regras" },
+  { href: "/configuracoes", label: "Configurações", meta: "Modos" },
+];
+
+export function Sidebar() {
+  const pathname = usePathname();
+
+  return (
+    <aside className="app-sidebar">
+      <div className="sidebar-header">
+        <p className="sidebar-kicker">Base Rodobens Imóvel</p>
+        <div className="logos">
+          <div className="logo-lockup">
+            <div className="logo-placeholder btg-style">BTG Pactual</div>
+            <span className="logo-caption">
+              Camada comercial e governança executiva.
+            </span>
+          </div>
+          <div className="logo-lockup">
+            <div className="logo-placeholder rodobens-style">Rodobens</div>
+            <span className="logo-caption">
+              Tabelas, premissas e padrões operacionais da carteira imobiliária.
+            </span>
+          </div>
+        </div>
+      </div>
+
+      <nav className="sidebar-nav">
+        <div className="sidebar-section-label">Módulos</div>
+        <ul>
+          {navigationItems.map((item) => {
+            const isActive =
+              item.href === "/"
+                ? pathname === item.href
+                : pathname?.startsWith(item.href);
+
+            return (
+              <li key={item.href}>
+                <Link
+                  href={item.href}
+                  className={`nav-link ${isActive ? "active" : ""}`}
+                >
+                  <span>{item.label}</span>
+                  <span className="nav-link__meta">{item.meta}</span>
+                </Link>
+              </li>
+            );
+          })}
+        </ul>
+      </nav>
+
+      <div className="sidebar-footer">
+        <strong>Workspace operacional</strong>
+        <span>Simulador interno, proposta cliente e mercado secundário.</span>
+      </div>
+    </aside>
+  );
+}

apps/web_comercial/src/components/layout/Topbar.tsx

@@ -0,0 +1,68 @@
+"use client";
+
+import { usePathname } from "next/navigation";
+
+const routeConfig: Record<
+  string,
+  { title: string; subtitle: string; validity: string }
+> = {
+  "/": {
+    title: "Simulador imobiliário",
+    subtitle: "Montagem de proposta com leitura operacional em formato workbook.",
+    validity: "Vigência 31/10/2026",
+  },
+  "/mercado-secundario": {
+    title: "Mercado secundário",
+    subtitle: "Análise de fluxo, portabilidade, spread e retorno por cliente SCP.",
+    validity: "Ciclo março/2026",
+  },
+  "/comparador": {
+    title: "Comparador de cenários",
+    subtitle: "Confronto entre planos, prazo, lance e impacto de parcela.",
+    validity: "Revisão diária",
+  },
+  "/proposta": {
+    title: "Proposta personalizada",
+    subtitle: "Documento executivo orientado a PDF e apresentação ao cliente.",
+    validity: "Validade 15 dias",
+  },
+  "/premissas": {
+    title: "Premissas operacionais",
+    subtitle: "Hipóteses, gatilhos e regras que sustentam o cálculo determinístico.",
+    validity: "Baseline homologada",
+  },
+  "/configuracoes": {
+    title: "Configurações",
+    subtitle: "Modos de leitura, densidade e visibilidade de memória de cálculo.",
+    validity: "Perfil operacional",
+  },
+};
+
+export function Topbar() {
+  const pathname = usePathname();
+  const config =
+    routeConfig[pathname ?? "/"] ?? routeConfig["/"];
+
+  return (
+    <header className="app-topbar">
+      <div className="topbar-heading">
+        <span className="topbar-kicker">Consórcio imobiliário Rodobens</span>
+        <h1 className="topbar-title">{config.title}</h1>
+        <p className="topbar-subtitle">{config.subtitle}</p>
+      </div>
+
+      <div style={{ display: "grid", gap: "10px", justifyItems: "end" }}>
+        <div className="topbar-context">
+          <span className="context-pill">Parceiro Apex</span>
+          <span className="context-pill">Modo operacional</span>
+          <span className="context-pill highlight">BTG + Rodobens</span>
+          <span className="context-pill">{config.validity}</span>
+        </div>
+        <div className="topbar-actions">
+          <button className="btn btn-secondary">Visualizar layout</button>
+          <button className="btn btn-primary">Imprimir proposta</button>
+        </div>
+      </div>
+    </header>
+  );
+}

apps/web_comercial/src/components/layout/layout.css

@@ -0,0 +1,350 @@
+.app-container {
+  display: flex;
+  min-height: 100vh;
+  background: var(--background);
+}
+
+.app-sidebar {
+  width: 276px;
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  background:
+    linear-gradient(180deg, rgba(255, 255, 255, 0.04), transparent 28%),
+    var(--bg-sidebar);
+  color: #f8fbff;
+  border-right: 1px solid rgba(255, 255, 255, 0.06);
+  box-shadow: 12px 0 28px rgba(9, 22, 38, 0.12);
+}
+
+.sidebar-header {
+  padding: 26px 24px 22px;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
+}
+
+.sidebar-kicker {
+  margin: 0 0 18px;
+  color: rgba(255, 255, 255, 0.56);
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.logos {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+.logo-lockup {
+  display: grid;
+  gap: 6px;
+}
+
+.logo-placeholder {
+  display: inline-flex;
+  align-items: center;
+  width: fit-content;
+  min-height: 34px;
+  padding: 0 12px;
+  border-radius: 8px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  font-size: 0.82rem;
+  text-transform: uppercase;
+}
+
+.btg-style {
+  color: #ffffff;
+  background: rgba(255, 255, 255, 0.06);
+}
+
+.rodobens-style {
+  color: #c5d4e3;
+  background: rgba(255, 255, 255, 0.03);
+}
+
+.logo-caption {
+  color: rgba(255, 255, 255, 0.62);
+  font-size: 0.78rem;
+  line-height: 1.45;
+}
+
+.sidebar-nav {
+  padding: 18px 16px;
+  flex: 1;
+}
+
+.sidebar-section-label {
+  padding: 0 10px 10px;
+  color: rgba(255, 255, 255, 0.44);
+  font-size: 0.69rem;
+  font-weight: 700;
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+}
+
+.sidebar-nav ul {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.nav-link {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  min-height: 48px;
+  padding: 0 14px;
+  border-radius: 10px;
+  color: rgba(245, 249, 255, 0.76);
+  text-decoration: none;
+  font-weight: 600;
+  font-size: 0.93rem;
+  border: 1px solid transparent;
+  transition: all 0.18s ease;
+}
+
+.nav-link:hover {
+  background: rgba(255, 255, 255, 0.05);
+  border-color: rgba(255, 255, 255, 0.08);
+  color: #ffffff;
+}
+
+.nav-link.active {
+  background: linear-gradient(90deg, rgba(236, 91, 19, 0.18), rgba(236, 91, 19, 0.06));
+  border-color: rgba(236, 91, 19, 0.26);
+  color: #ffffff;
+  box-shadow: inset 3px 0 0 var(--color-brand-accent);
+}
+
+.nav-link__meta {
+  color: rgba(255, 255, 255, 0.4);
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.nav-link.active .nav-link__meta {
+  color: rgba(255, 255, 255, 0.72);
+}
+
+.sidebar-footer {
+  padding: 18px 24px 24px;
+  border-top: 1px solid rgba(255, 255, 255, 0.08);
+  display: grid;
+  gap: 8px;
+}
+
+.sidebar-footer strong {
+  font-size: 0.82rem;
+  color: #ffffff;
+}
+
+.sidebar-footer span {
+  font-size: 0.76rem;
+  color: rgba(255, 255, 255, 0.56);
+}
+
+.app-main {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-width: 0;
+}
+
+.app-topbar {
+  position: sticky;
+  top: 0;
+  z-index: 20;
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 18px;
+  padding: 22px 28px 18px;
+  background: rgba(243, 240, 235, 0.92);
+  backdrop-filter: blur(10px);
+  border-bottom: 1px solid rgba(197, 188, 174, 0.9);
+}
+
+.topbar-heading {
+  display: grid;
+  gap: 6px;
+}
+
+.topbar-kicker {
+  color: var(--text-muted);
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.topbar-title {
+  margin: 0;
+  font-size: 1.35rem;
+  font-weight: 700;
+  color: var(--color-brand-dark);
+}
+
+.topbar-subtitle {
+  margin: 0;
+  color: var(--text-muted);
+  font-size: 0.86rem;
+}
+
+.topbar-context {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  align-items: center;
+}
+
+.context-pill {
+  display: inline-flex;
+  align-items: center;
+  min-height: 30px;
+  padding: 0 10px;
+  border-radius: 999px;
+  background: var(--bg-panel);
+  border: 1px solid var(--border-color);
+  color: var(--text-main);
+  font-size: 0.74rem;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  box-shadow: var(--shadow-soft);
+}
+
+.context-pill.highlight {
+  background: rgba(236, 91, 19, 0.1);
+  border-color: rgba(236, 91, 19, 0.24);
+  color: var(--color-brand-accent-strong);
+}
+
+.topbar-actions {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+
+.app-content {
+  padding: 28px;
+}
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 40px;
+  padding: 0 16px;
+  border-radius: 10px;
+  cursor: pointer;
+  transition: all 0.18s ease;
+  border: 1px solid transparent;
+  font-family: var(--font-sans);
+  font-size: 0.82rem;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+}
+
+.btn-primary {
+  background: var(--color-brand-accent);
+  color: white;
+  box-shadow: 0 8px 18px rgba(236, 91, 19, 0.18);
+}
+
+.btn-primary:hover {
+  background: var(--color-brand-accent-strong);
+}
+
+.btn-secondary {
+  background: var(--bg-panel);
+  color: var(--color-brand-dark);
+  border-color: var(--border-color);
+}
+
+.btn-secondary:hover {
+  background: var(--bg-panel-soft);
+  border-color: var(--border-strong);
+}
+
+.module-container {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+  min-width: 0;
+}
+
+.module-header {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 16px;
+}
+
+.module-title {
+  margin: 0 0 6px;
+  font-size: 1.55rem;
+  font-weight: 700;
+  color: var(--color-brand-dark);
+  letter-spacing: -0.02em;
+}
+
+.module-subtitle {
+  margin: 0;
+  color: var(--text-muted);
+  font-size: 0.92rem;
+  line-height: 1.55;
+}
+
+.module-content {
+  background: var(--bg-panel);
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  padding: 24px;
+  box-shadow: var(--shadow-panel);
+  min-width: 0;
+}
+
+@media (max-width: 1100px) {
+  .app-container {
+    flex-direction: column;
+  }
+
+  .app-sidebar {
+    width: 100%;
+    box-shadow: none;
+  }
+
+  .sidebar-nav ul {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  }
+}
+
+@media (max-width: 768px) {
+  .app-topbar,
+  .app-content {
+    padding-left: 18px;
+    padding-right: 18px;
+  }
+
+  .module-content {
+    padding: 18px;
+  }
+
+  .topbar-title {
+    font-size: 1.12rem;
+  }
+}

apps/web_comercial/src/components/simulator/SimulatorForm.tsx

@@ -0,0 +1,354 @@
+"use client";
+
+import {
+  calcularSimulacao,
+  type ParametrosPlano,
+  type ResultadoSimulacao,
+  type SimulacaoInput,
+} from "@simulador-consorcio/simulation-engine";
+import { useState } from "react";
+import { Card, DataCard } from "../ui/Card";
+import { Input, Select } from "../ui/FormControls";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "../ui/Table";
+
+export function SimulatorForm() {
+  const [produto, setProduto] = useState("imovel");
+  const [modalidade, setModalidade] = useState("linear_integral");
+  const [credito, setCredito] = useState<number>(300000);
+  const [prazo, setPrazo] = useState<number>(180);
+  const [temLance, setTemLance] = useState<boolean>(false);
+  const [lancePercentual, setLancePercentual] = useState<number>(30);
+  const [resultado, setResultado] = useState<ResultadoSimulacao | null>(null);
+
+  const formatCurrency = (value: number) => {
+    return new Intl.NumberFormat("pt-BR", {
+      style: "currency",
+      currency: "BRL",
+    }).format(value);
+  };
+
+  const handleSimular = () => {
+    const parametros: ParametrosPlano = {
+      id_plano: "PADRAO",
+      nome_plano: "Plano Padrão Imóvel",
+      prazo_meses: prazo,
+      taxa_administracao_total: 0.15,
+      fundo_reserva_mensal: 0.0005,
+      seguro_prestamista: 0.035,
+    };
+
+    const input: SimulacaoInput = {
+      credito_desejado: credito,
+      parametros,
+      tem_lance: temLance,
+      lance_percentual: temLance ? lancePercentual / 100 : undefined,
+    };
+
+    const res = calcularSimulacao(input);
+    setResultado(res);
+  };
+
+  const modalidadeLabelMap: Record<string, string> = {
+    linear_integral: "Linear Integral",
+    linear_50: "Linear Reduzido 50%",
+    linear_70: "Linear Reduzido 70%",
+    degrau: "Degrau",
+    degrau_reduzido: "Degrau Reduzido",
+    pontual: "Pontual",
+    pontual_reduzido: "Pontual Reduzido",
+  };
+
+  const prazoLabel =
+    prazo === 216 ? "Longo prazo" : prazo >= 180 ? "Prazo padrão" : "Prazo curto";
+
+  return (
+    <div className="section-grid section-grid--simulator">
+      <div className="section-stack">
+        <Card
+          title="Leitura operacional"
+          headerAction={<span className="status-chip status-info">{modalidadeLabelMap[modalidade]}</span>}
+        >
+          <div className="page-kpi-strip" style={{ marginBottom: 0 }}>
+            <DataCard
+              label="Produto"
+              value="Imóvel"
+              subvalue="Escopo exclusivo do simulador"
+            />
+            <DataCard
+              label="Plano selecionado"
+              value={modalidadeLabelMap[modalidade]}
+              subvalue={prazoLabel}
+            />
+            <DataCard
+              label="Crédito em análise"
+              value={formatCurrency(credito)}
+              subvalue={`Prazo base ${prazo} meses`}
+              highlight
+            />
+            <DataCard
+              label="Lance"
+              value={temLance ? `${lancePercentual}%` : "Sem lance"}
+              subvalue="Operação editável"
+            />
+          </div>
+        </Card>
+
+        <Card title="Informações Básicas">
+          <div className="field-grid field-grid--2">
+            <Select
+              label="Tipo Produto"
+              value={produto}
+              onChange={(e) => setProduto(e.target.value)}
+              options={[{ label: "Imóvel", value: "imovel" }]}
+              disabled // Locked to 'imovel' per instruction
+            />
+            <Select
+              label="Modalidade"
+              value={modalidade}
+              onChange={(e) => setModalidade(e.target.value)}
+              options={[
+                { label: "Linear Integral", value: "linear_integral" },
+                { label: "Linear Reduzido 50%", value: "linear_50" },
+                { label: "Linear Reduzido 70%", value: "linear_70" },
+                { label: "Degrau", value: "degrau" },
+                { label: "Degrau Reduzido", value: "degrau_reduzido" },
+                { label: "Pontual", value: "pontual" },
+                { label: "Pontual Reduzido", value: "pontual_reduzido" },
+              ]}
+            />
+            <Input label="Grupo" placeholder="Ex: 4001" />
+            <Input label="Número de Cotas" type="number" defaultValue={1} />
+          </div>
+        </Card>
+
+        <Card title="Informações do Plano">
+          <div className="field-grid field-grid--2">
+            <Input
+              label="Valor do Crédito"
+              type="number"
+              value={credito}
+              onChange={(e) => setCredito(Number(e.target.value))}
+              prefix="R$"
+            />
+            <Select
+              label="Prazo do Plano"
+              value={prazo}
+              onChange={(e) => setPrazo(Number(e.target.value))}
+              options={[
+                { label: "120 meses", value: "120" },
+                { label: "150 meses", value: "150" },
+                { label: "180 meses", value: "180" },
+                { label: "216 meses", value: "216" },
+              ]}
+            />
+            <Input
+              label="Taxa de Administração Total"
+              defaultValue="15.00"
+              suffix="%"
+            />
+            <Input label="Fundo de Reserva" defaultValue="0.05" suffix="%" />
+            <Input label="Seguro Prestamista" defaultValue="3.50" suffix="%" />
+            <Input label="Taxa de Adesão" defaultValue="1.00" suffix="%" />
+          </div>
+        </Card>
+
+        <Card title="Informações de Lance">
+          <div className="field-grid field-grid--2">
+            <div className="ui-form-group" style={{ gridColumn: "1 / -1" }}>
+              <label className="inline-toggle">
+                <input
+                  type="checkbox"
+                  checked={temLance}
+                  onChange={(e) => setTemLance(e.target.checked)}
+                />
+                Simular contemplação via lance
+              </label>
+            </div>
+            {temLance && (
+              <>
+                <Select
+                  label="Tipo de Lance"
+                  options={[
+                    { label: "Fixo", value: "fixo" },
+                    { label: "Livre", value: "livre" },
+                  ]}
+                />
+                <Input
+                  label="Lance Total (%)"
+                  type="number"
+                  value={lancePercentual}
+                  onChange={(e) => setLancePercentual(Number(e.target.value))}
+                  suffix="%"
+                />
+                <Input
+                  label="Embutido Percentual"
+                  type="number"
+                  defaultValue={10}
+                  suffix="%"
+                  tooltip="Percentual do lance a ser retirado do próprio crédito."
+                />
+                <Select
+                  label="Mês Previsto de Lance"
+                  options={Array.from({ length: 24 }, (_, i) => ({
+                    label: `Mês ${i + 1}`,
+                    value: i + 1,
+                  }))}
+                />
+              </>
+            )}
+          </div>
+
+          <div style={{ marginTop: "20px", display: "flex", justifyContent: "flex-end", gap: "12px" }}>
+            <button className="btn btn-secondary">Limpar</button>
+            <button className="btn btn-primary" onClick={handleSimular}>
+              Calcular Cenário
+            </button>
+          </div>
+        </Card>
+      </div>
+
+      <div className="summary-rail">
+        <Card title="Resumo Geral" highlight={true}>
+          {resultado ? (
+            <div className="section-stack" style={{ gap: "12px" }}>
+              <DataCard
+                label="Crédito Disponível"
+                value={formatCurrency(resultado.credito || credito)}
+              />
+              <DataCard
+                label="Parcela Inicial (Integral)"
+                value={formatCurrency(resultado.parcela_integral.total)}
+                highlight
+              />
+              {resultado.parcela_reduzida && (
+                <DataCard
+                  label="Parcela Reduzida"
+                  value={formatCurrency(resultado.parcela_reduzida.total)}
+                />
+              )}
+              {temLance && resultado.valor_lance && (
+                <>
+                  <DataCard
+                    label="Valor Total do Lance"
+                    value={formatCurrency(resultado.valor_lance)}
+                  />
+                  <DataCard
+                    label="Prazo Restante"
+                    value={`${resultado.prazo_apos_lance} meses`}
+                  />
+                </>
+              )}
+            </div>
+          ) : (
+            <p className="plain-note">
+              Preencha os blocos operacionais para liberar o resumo, o CET e a
+              composição da parcela.
+            </p>
+          )}
+        </Card>
+
+        <Card title="CET / Ao mês">
+          {resultado ? (
+            <div className="section-stack" style={{ gap: "12px" }}>
+              <DataCard
+                label="Custo Efetivo Total (Ao Ano)"
+                value="11.45%"
+                subvalue="Estimativa com base nas taxas atuais"
+              />
+              <DataCard label="Taxa Equivalente (Ao Mês)" value="0.91%" />
+            </div>
+          ) : (
+            <p className="plain-note">Aguardando geração do cenário.</p>
+          )}
+        </Card>
+
+        <Card title="Checklist operacional">
+          <div className="section-stack" style={{ gap: "10px" }}>
+            <div className="executive-banner" style={{ padding: "12px 14px" }}>
+              <div>
+                <strong>Validação de escopo:</strong> produto travado em imóvel e
+                modalidades alinhadas ao workbook.
+              </div>
+            </div>
+            <p className="plain-note">
+              Antes de emitir proposta, confirme grupo, prazo, lance, CET, faixa
+              de parcela e crédito líquido disponível.
+            </p>
+          </div>
+        </Card>
+
+        {resultado && (
+          <Card title="Composição da Parcela" noPadding>
+            <Table>
+              <TableHead>
+                <TableRow>
+                  <TableHeader>Rubrica</TableHeader>
+                  <TableHeader style={{ textAlign: "right" }}>
+                    Valor (R$)
+                  </TableHeader>
+                </TableRow>
+              </TableHead>
+              <TableBody>
+                <TableRow>
+                  <TableCell>Fundo Comum</TableCell>
+                  <TableCell
+                    style={{ textAlign: "right", fontFamily: "monospace" }}
+                  >
+                    {formatCurrency(resultado.parcela_integral.fundo_comum)}
+                  </TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Taxa Administrativa</TableCell>
+                  <TableCell
+                    style={{ textAlign: "right", fontFamily: "monospace" }}
+                  >
+                    {formatCurrency(
+                      resultado.parcela_integral.taxa_administracao,
+                    )}
+                  </TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Fundo de Reserva</TableCell>
+                  <TableCell
+                    style={{ textAlign: "right", fontFamily: "monospace" }}
+                  >
+                    {formatCurrency(resultado.parcela_integral.fundo_reserva)}
+                  </TableCell>
+                </TableRow>
+                <TableRow>
+                  <TableCell>Seguro Prestamista</TableCell>
+                  <TableCell
+                    style={{ textAlign: "right", fontFamily: "monospace" }}
+                  >
+                    {formatCurrency(resultado.parcela_integral.seguro)}
+                  </TableCell>
+                </TableRow>
+                <TableRow
+                  style={{ backgroundColor: "var(--bg-main)", fontWeight: 600 }}
+                >
+                  <TableCell>Total</TableCell>
+                  <TableCell
+                    style={{ textAlign: "right", fontFamily: "monospace" }}
+                  >
+                    {formatCurrency(resultado.parcela_integral.total)}
+                  </TableCell>
+                </TableRow>
+              </TableBody>
+            </Table>
+            <div className="table-note">
+              <span>Leitura resumida da memória de cálculo.</span>
+              <span>Base atual: parcela integral do motor determinístico.</span>
+            </div>
+          </Card>
+        )}
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/components/ui/Card.tsx

@@ -0,0 +1,53 @@
+import React from "react";
+
+interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
+  children: React.ReactNode;
+  title?: string;
+  headerAction?: React.ReactNode;
+  noPadding?: boolean;
+  highlight?: boolean;
+}
+
+export function Card({
+  children,
+  title,
+  headerAction,
+  noPadding = false,
+  highlight = false,
+  className = "",
+  ...props
+}: CardProps) {
+  return (
+    <div className={`ui-card ${highlight ? "highlight" : ""} ${className}`} {...props}>
+      {(title || headerAction) && (
+        <div className="ui-card-header">
+          {title && <h3 className="ui-card-title">{title}</h3>}
+          {headerAction && <div className="ui-card-action">{headerAction}</div>}
+        </div>
+      )}
+      <div className={`ui-card-content ${noPadding ? "no-padding" : ""}`}>
+        {children}
+      </div>
+    </div>
+  );
+}
+
+export function DataCard({
+  label,
+  value,
+  subvalue,
+  highlight = false,
+}: {
+  label: string;
+  value: string | React.ReactNode;
+  subvalue?: string;
+  highlight?: boolean;
+}) {
+  return (
+    <div className={`ui-data-card ${highlight ? "highlight" : ""}`}>
+      <span className="ui-data-label">{label}</span>
+      <span className="ui-data-value">{value}</span>
+      {subvalue && <span className="ui-data-subvalue">{subvalue}</span>}
+    </div>
+  );
+}

apps/web_comercial/src/components/ui/FormControls.tsx

@@ -0,0 +1,76 @@
+import React from "react";
+import { Tooltip } from "./Tooltip";
+
+interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+  label: string;
+  tooltip?: string;
+  error?: string;
+  suffix?: string;
+  prefix?: string;
+}
+
+export function Input({
+  label,
+  tooltip,
+  error,
+  suffix,
+  prefix,
+  className = "",
+  ...props
+}: InputProps) {
+  return (
+    <div className={`ui-form-group ${className}`}>
+      <div className="ui-label-wrapper">
+        <label className="ui-form-label">{label}</label>
+        {tooltip && (
+          <Tooltip content={tooltip}>
+            <span className="ui-tooltip-icon">?</span>
+          </Tooltip>
+        )}
+      </div>
+      <div className="ui-input-wrapper">
+        {prefix && <span className="ui-input-prefix">{prefix}</span>}
+        <input
+          className={`ui-input ${prefix ? "has-prefix" : ""} ${suffix ? "has-suffix" : ""} ${error ? "is-invalid" : ""}`}
+          {...props}
+        />
+        {suffix && <span className="ui-input-suffix">{suffix}</span>}
+      </div>
+      {error && <span className="ui-form-error">{error}</span>}
+    </div>
+  );
+}
+
+interface SelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+  label: string;
+  tooltip?: string;
+  options: { label: string; value: string | number }[];
+}
+
+export function Select({
+  label,
+  tooltip,
+  options,
+  className = "",
+  ...props
+}: SelectProps) {
+  return (
+    <div className={`ui-form-group ${className}`}>
+      <div className="ui-label-wrapper">
+        <label className="ui-form-label">{label}</label>
+        {tooltip && (
+          <Tooltip content={tooltip}>
+            <span className="ui-tooltip-icon">?</span>
+          </Tooltip>
+        )}
+      </div>
+      <select className="ui-select" {...props}>
+        {options.map((opt) => (
+          <option key={opt.value} value={opt.value}>
+            {opt.label}
+          </option>
+        ))}
+      </select>
+    </div>
+  );
+}

apps/web_comercial/src/components/ui/Table.tsx

@@ -0,0 +1,59 @@
+import React from "react";
+
+interface TableProps extends React.TableHTMLAttributes<HTMLTableElement> {
+  children: React.ReactNode;
+}
+
+export function Table({ children, className = "", ...props }: TableProps) {
+  return (
+    <div className="ui-table-container">
+      <table className={`ui-table ${className}`} {...props}>
+        {children}
+      </table>
+    </div>
+  );
+}
+
+export function TableHead({ children }: { children: React.ReactNode }) {
+  return <thead className="ui-table-head">{children}</thead>;
+}
+
+export function TableBody({ children }: { children: React.ReactNode }) {
+  return <tbody className="ui-table-body">{children}</tbody>;
+}
+
+export function TableRow({
+  children,
+  className = "",
+  ...props
+}: React.HTMLAttributes<HTMLTableRowElement>) {
+  return (
+    <tr className={`ui-table-row ${className}`} {...props}>
+      {children}
+    </tr>
+  );
+}
+
+export function TableHeader({
+  children,
+  className = "",
+  ...props
+}: React.ThHTMLAttributes<HTMLTableHeaderCellElement>) {
+  return (
+    <th className={`ui-table-header ${className}`} {...props}>
+      {children}
+    </th>
+  );
+}
+
+export function TableCell({
+  children,
+  className = "",
+  ...props
+}: React.TdHTMLAttributes<HTMLTableDataCellElement>) {
+  return (
+    <td className={`ui-table-cell ${className}`} {...props}>
+      {children}
+    </td>
+  );
+}

apps/web_comercial/src/components/ui/Tabs.tsx

@@ -0,0 +1,29 @@
+import React, { useState } from "react";
+
+interface TabsProps {
+  tabs: { id: string; label: string; content: React.ReactNode }[];
+  defaultTab?: string;
+}
+
+export function Tabs({ tabs, defaultTab }: TabsProps) {
+  const [activeTab, setActiveTab] = useState(defaultTab || tabs[0]?.id);
+
+  return (
+    <div className="ui-tabs-container">
+      <div className="ui-tabs-header">
+        {tabs.map((tab) => (
+          <button
+            key={tab.id}
+            className={`ui-tab-button ${activeTab === tab.id ? "active" : ""}`}
+            onClick={() => setActiveTab(tab.id)}
+          >
+            {tab.label}
+          </button>
+        ))}
+      </div>
+      <div className="ui-tabs-content">
+        {tabs.find((tab) => tab.id === activeTab)?.content}
+      </div>
+    </div>
+  );
+}

apps/web_comercial/src/components/ui/Tooltip.tsx

@@ -0,0 +1,15 @@
+import React from "react";
+
+interface TooltipProps {
+  content: string;
+  children: React.ReactNode;
+}
+
+export function Tooltip({ content, children }: TooltipProps) {
+  return (
+    <div className="ui-tooltip-container">
+      {children}
+      <div className="ui-tooltip-content">{content}</div>
+    </div>
+  );
+}

apps/web_comercial/src/components/ui/ui.css

@@ -0,0 +1,318 @@
+/* Card */
+.ui-card {
+  background-color: var(--bg-panel);
+  border: 1px solid var(--border-color);
+  border-radius: 10px;
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+  box-shadow: var(--shadow-soft);
+}
+
+.ui-card.highlight {
+  border-color: rgba(13, 45, 82, 0.16);
+  box-shadow:
+    inset 0 1px 0 rgba(255, 255, 255, 0.7),
+    0 10px 22px rgba(13, 45, 82, 0.07);
+}
+
+.ui-card-header {
+  min-height: 50px;
+  padding: 0 18px;
+  border-bottom: 1px solid var(--border-color);
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  background:
+    linear-gradient(180deg, rgba(13, 45, 82, 0.04), rgba(13, 45, 82, 0.01)),
+    var(--bg-panel-soft);
+}
+
+.ui-card-title {
+  font-size: 0.88rem;
+  font-weight: 700;
+  color: var(--color-brand-dark);
+  margin: 0;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+}
+
+.ui-card-content {
+  padding: 18px;
+  flex: 1;
+}
+
+.ui-card-content.no-padding {
+  padding: 0;
+}
+
+.ui-data-card {
+  display: flex;
+  flex-direction: column;
+  min-height: 88px;
+  padding: 12px 14px;
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  background:
+    linear-gradient(180deg, rgba(255, 255, 255, 0.9), rgba(248, 245, 241, 0.95)),
+    var(--bg-panel-soft);
+}
+
+.ui-data-card.highlight {
+  background:
+    linear-gradient(180deg, rgba(237, 244, 251, 0.95), rgba(223, 237, 248, 0.98)),
+    var(--bg-panel-accent);
+  border-color: rgba(13, 45, 82, 0.18);
+}
+
+.ui-data-label {
+  font-size: 0.68rem;
+  font-weight: 700;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  margin-bottom: 8px;
+}
+
+.ui-data-value {
+  font-size: 1.18rem;
+  font-weight: 700;
+  color: var(--text-main);
+  line-height: 1.2;
+}
+
+.ui-data-subvalue {
+  font-size: 0.75rem;
+  color: var(--text-muted);
+  margin-top: 4px;
+}
+
+/* Form Controls */
+.ui-form-group {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.ui-label-wrapper {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.ui-form-label {
+  font-size: 0.74rem;
+  font-weight: 700;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.07em;
+}
+
+.ui-tooltip-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 15px;
+  height: 15px;
+  border-radius: 50%;
+  background-color: var(--color-brand-dark);
+  color: white;
+  font-size: 10px;
+  font-weight: 700;
+  cursor: help;
+}
+
+.ui-input-wrapper {
+  position: relative;
+  display: flex;
+  align-items: center;
+}
+
+.ui-input,
+.ui-select {
+  width: 100%;
+  min-height: 42px;
+  padding: 10px 12px;
+  font-size: 0.92rem;
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  background-color: #fffdfb;
+  color: var(--text-main);
+  transition:
+    border-color 0.18s,
+    box-shadow 0.18s,
+    background-color 0.18s;
+  font-family: inherit;
+}
+
+.ui-input:hover,
+.ui-select:hover {
+  border-color: var(--border-strong);
+}
+
+.ui-input:focus,
+.ui-select:focus {
+  outline: none;
+  border-color: rgba(13, 45, 82, 0.5);
+  box-shadow: 0 0 0 3px rgba(13, 45, 82, 0.08);
+  background-color: white;
+}
+
+.ui-input.is-invalid {
+  border-color: var(--status-negative);
+}
+
+.ui-input-prefix,
+.ui-input-suffix {
+  position: absolute;
+  color: var(--text-muted);
+  font-size: 0.86rem;
+}
+
+.ui-input-prefix {
+  left: 12px;
+}
+
+.ui-input-suffix {
+  right: 12px;
+}
+
+.ui-input.has-prefix {
+  padding-left: 34px;
+}
+
+.ui-input.has-suffix {
+  padding-right: 40px;
+}
+
+.ui-form-error {
+  color: var(--status-negative);
+  font-size: 0.75rem;
+  margin-top: 2px;
+}
+
+/* Tooltip */
+.ui-tooltip-container {
+  position: relative;
+  display: inline-flex;
+}
+
+.ui-tooltip-content {
+  visibility: hidden;
+  position: absolute;
+  bottom: 150%;
+  left: 50%;
+  transform: translateX(-50%);
+  background-color: #13263e;
+  color: white;
+  text-align: center;
+  padding: 7px 10px;
+  border-radius: 6px;
+  font-size: 0.74rem;
+  white-space: nowrap;
+  opacity: 0;
+  transition: opacity 0.2s;
+  z-index: 100;
+  pointer-events: none;
+  box-shadow: var(--shadow-soft);
+}
+
+.ui-tooltip-content::after {
+  content: "";
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  margin-left: -5px;
+  border-width: 5px;
+  border-style: solid;
+  border-color: #13263e transparent transparent transparent;
+}
+
+.ui-tooltip-container:hover .ui-tooltip-content {
+  visibility: visible;
+  opacity: 1;
+}
+
+/* Table */
+.ui-table-container {
+  width: 100%;
+  overflow-x: auto;
+}
+
+.ui-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.84rem;
+  text-align: left;
+}
+
+.ui-table-head {
+  background: var(--bg-panel-soft);
+  border-bottom: 1px solid var(--border-color);
+}
+
+.ui-table-header {
+  padding: 12px 16px;
+  font-weight: 700;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  font-size: 0.7rem;
+  letter-spacing: 0.08em;
+  white-space: nowrap;
+}
+
+.ui-table-row {
+  border-bottom: 1px solid rgba(215, 210, 200, 0.8);
+  transition: background-color 0.18s;
+}
+
+.ui-table-row:hover {
+  background-color: rgba(13, 45, 82, 0.025);
+}
+
+.ui-table-cell {
+  padding: 12px 16px;
+  color: var(--text-main);
+  vertical-align: middle;
+}
+
+/* Tabs */
+.ui-tabs-container {
+  display: flex;
+  flex-direction: column;
+}
+
+.ui-tabs-header {
+  display: flex;
+  border-bottom: 1px solid var(--border-color);
+  margin-bottom: 24px;
+}
+
+.ui-tab-button {
+  padding: 12px 18px;
+  background: none;
+  border: none;
+  border-bottom: 2px solid transparent;
+  font-size: 0.86rem;
+  font-weight: 700;
+  color: var(--text-muted);
+  cursor: pointer;
+  transition: all 0.18s;
+  font-family: inherit;
+  margin-bottom: -1px;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.ui-tab-button:hover {
+  color: var(--color-brand-dark);
+}
+
+.ui-tab-button.active {
+  color: var(--color-brand-dark);
+  border-bottom-color: var(--color-brand-accent);
+}
+
+.ui-tabs-content {
+  flex: 1;
+}

apps/web_comercial/tsconfig.json

@@ -0,0 +1,42 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

packages/simulation-engine/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@simulador-consorcio/simulation-engine",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "types": "./src/index.d.ts",
+  "scripts": {
+    "test": "node --test tests/*.test.js"
+  }
+}

packages/simulation-engine/src/generated/rodobensFieldMatrix.v1.json

@@ -0,0 +1,838 @@
+{
+  "artifact_version": "1.0",
+  "source_workbook": "SIMULADOR RODOBENS - BTG 5.xlsm",
+  "rows": [
+    {
+      "field_id": "partner_name",
+      "plan": "degrau",
+      "section": "header",
+      "source_sheet": null,
+      "source_cell": null,
+      "source_formula": "=IF('Degrau e Degrau Reduzido'!#REF!=\"\",\"\",'Degrau e Degrau Reduzido'!#REF!)",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D6",
+      "status": "pending",
+      "current_value": "#REF!",
+      "notes": "Único #REF! confirmado do workbook; sem origem homologada."
+    },
+    {
+      "field_id": "proposal_valid_until",
+      "plan": "degrau",
+      "section": "header",
+      "source_sheet": "Simulador Degrau",
+      "source_cell": "D7",
+      "source_formula": "=TODAY()+3",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D7",
+      "status": "presentation_only",
+      "current_value": "2026-02-13T00:00:00",
+      "notes": "Regra de apresentação via TODAY()+3."
+    },
+    {
+      "field_id": "plan_label",
+      "plan": "degrau",
+      "section": "header",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "J36",
+      "source_formula": "=\"Degrau \" &P8",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "C9",
+      "status": "extracted",
+      "current_value": "Degrau Integral",
+      "notes": "Nome comercial do plano derivado de P8."
+    },
+    {
+      "field_id": "numero_cotas",
+      "plan": "degrau",
+      "section": "input",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "M5",
+      "source_formula": null,
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I46",
+      "status": "extracted",
+      "current_value": 1,
+      "notes": "Fonte numérica em M5; layout final textual em L32/I46."
+    },
+    {
+      "field_id": "credito_contratado",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "T3",
+      "source_formula": "=P4",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D33",
+      "status": "extracted",
+      "current_value": 1000000,
+      "notes": "Layout multiplica T3 por M5."
+    },
+    {
+      "field_id": "lance_total",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "C24",
+      "source_formula": "=IFERROR(S6*M5,\"\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D34",
+      "status": "extracted",
+      "current_value": 650740.7407407408,
+      "notes": "Valor total consolidado do lance."
+    },
+    {
+      "field_id": "lance_embutido_valor",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "D27",
+      "source_formula": "=T9*M5",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D35",
+      "status": "extracted",
+      "current_value": 300000,
+      "notes": "Deriva de AD32 = P4 * P10."
+    },
+    {
+      "field_id": "recurso_proprio",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "C28",
+      "source_formula": "=IFERROR((C24-D27),\"\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D36",
+      "status": "extracted",
+      "current_value": 350740.7407407408,
+      "notes": "Valor residual após lance embutido."
+    },
+    {
+      "field_id": "primeira_parcela",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "C26",
+      "source_formula": "=S8*M5",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D37",
+      "status": "extracted",
+      "current_value": 6851.8518518519,
+      "notes": "Escolhe parcela integral ou reduzida conforme o plano."
+    },
+    {
+      "field_id": "credito_disponivel",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "B42",
+      "source_formula": "=C33",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D38",
+      "status": "extracted",
+      "current_value": 700000,
+      "notes": "Aponta para C33 na memória de cálculo."
+    },
+    {
+      "field_id": "credito_liquido",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "C33",
+      "source_formula": "=T15*M5",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D42",
+      "status": "review",
+      "current_value": 700000,
+      "notes": "Hoje coincide com crédito disponível; requer saneamento semântico."
+    },
+    {
+      "field_id": "furo",
+      "plan": "degrau",
+      "section": "input",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "M8",
+      "source_formula": null,
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D43",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Quantidade de parcelas em atraso/furo."
+    },
+    {
+      "field_id": "mes_previsto_lance",
+      "plan": "degrau",
+      "section": "input",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "P17",
+      "source_formula": null,
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "D44",
+      "status": "review",
+      "current_value": 12,
+      "notes": "Layout rotula como mês de contemplação, mas a origem funcional é mês previsto de lance."
+    },
+    {
+      "field_id": "seguro_prestamista",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "AD46",
+      "source_formula": null,
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I42",
+      "status": "extracted_partial",
+      "current_value": 0,
+      "notes": "Fórmula de array; manter fixture própria."
+    },
+    {
+      "field_id": "fundo_reserva",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "AD43",
+      "source_formula": null,
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I43",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Atualmente zero."
+    },
+    {
+      "field_id": "taxa_administracao_mensal_exibida",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "J42",
+      "source_formula": "=ROUND((P6/P5),6)*100 & \" % a.m.\"",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I44",
+      "status": "review",
+      "current_value": "0,1111 % a.m.",
+      "notes": "Layout mostra taxa mensal em vez de taxa total."
+    },
+    {
+      "field_id": "taxa_adesao",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "AD42",
+      "source_formula": null,
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I45",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Atualmente zero."
+    },
+    {
+      "field_id": "diluicao_50_faixa_1",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "S11",
+      "source_formula": "=\"de \" & P17+1& \" º até \"&P5*0.5&\"º \"",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "H34",
+      "status": "extracted",
+      "current_value": "de 13 º até 108º ",
+      "notes": "Faixa textual de diluição 50% - primeira metade."
+    },
+    {
+      "field_id": "diluicao_50_valor_1",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "D29",
+      "source_formula": "=IFERROR(T11*M5,\"\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I34",
+      "status": "extracted",
+      "current_value": 4511.0578204103,
+      "notes": "Valor monetário da primeira faixa de diluição 50%."
+    },
+    {
+      "field_id": "diluicao_50_faixa_2",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "S12",
+      "source_formula": "=IFERROR(\"de \" & (P5*0.5)+1 &\"º até \" & ROUND((P5-AD36),\"00\")&\"º\",\" \")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "H35",
+      "status": "extracted",
+      "current_value": "de 109º até 151º",
+      "notes": "Faixa textual de diluição 50% - segunda metade."
+    },
+    {
+      "field_id": "diluicao_50_valor_2",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "D30",
+      "source_formula": "=IFERROR(T12*M5,\"\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I35",
+      "status": "extracted",
+      "current_value": 2288.8355981881,
+      "notes": "Valor monetário da segunda faixa de diluição 50%."
+    },
+    {
+      "field_id": "diluicao_100_faixa_1",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "S13",
+      "source_formula": "=\"de \" & P17+1& \" º até \"&P5*0.5&\"º \"",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "H37",
+      "status": "extracted",
+      "current_value": "de 13 º até 108º ",
+      "notes": "Faixa textual de diluição 100% - primeira metade."
+    },
+    {
+      "field_id": "diluicao_100_valor_1",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "D31",
+      "source_formula": "=IFERROR(T13*M5,\"\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I37",
+      "status": "extracted",
+      "current_value": 3661.9462599855,
+      "notes": "Valor monetário da primeira faixa de diluição 100%."
+    },
+    {
+      "field_id": "diluicao_100_faixa_2",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "S14",
+      "source_formula": "= \"de \" &(P5/2)+1 & \"º até \"  &P5-M8 &\"º \"",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "H38",
+      "status": "extracted",
+      "current_value": "de 109º até 216º ",
+      "notes": "Faixa textual de diluição 100% - segunda metade."
+    },
+    {
+      "field_id": "diluicao_100_valor_2",
+      "plan": "degrau",
+      "section": "output",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "D32",
+      "source_formula": "=IFERROR(T14*M5,\"\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "I38",
+      "status": "extracted",
+      "current_value": 1439.7240377633,
+      "notes": "Valor monetário da segunda faixa de diluição 100%."
+    },
+    {
+      "field_id": "lance_observacao",
+      "plan": "degrau",
+      "section": "presentation",
+      "source_sheet": "Degrau e Degrau Reduzido",
+      "source_cell": "L35",
+      "source_formula": "=IF(AND(M6=\"Livre\",P5>48),\"Opção de utilizar o lance para quitar até 03 parcelas seguintes à contemplação\",\"Opção de utilizar o lance para quitar até 01 parcela seguinte à contemplação\")",
+      "layout_sheet": "Simulador Degrau",
+      "layout_cell": "B45",
+      "status": "extracted",
+      "current_value": "Opção de utilizar o lance para quitar até 03 parcelas seguintes à contemplação",
+      "notes": "Texto comercial dependente de modalidade de lance."
+    },
+    {
+      "field_id": "partner_name",
+      "plan": "linear",
+      "section": "header",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "AF1",
+      "source_formula": null,
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "D6",
+      "status": "review",
+      "current_value": "Paula",
+      "notes": "Aba chama o campo de Nome Cliente; layout imprime Parceiro."
+    },
+    {
+      "field_id": "proposal_valid_until",
+      "plan": "linear",
+      "section": "header",
+      "source_sheet": "Simulador Linear",
+      "source_cell": "D7",
+      "source_formula": "=TODAY()+3",
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "D7",
+      "status": "presentation_only",
+      "current_value": "2026-02-13T00:00:00",
+      "notes": "Regra de apresentação via TODAY()+3."
+    },
+    {
+      "field_id": "plan_label",
+      "plan": "linear",
+      "section": "header",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K8",
+      "source_formula": null,
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "C9",
+      "status": "extracted",
+      "current_value": "Linear Reduzido 70%",
+      "notes": "Nome do plano atual."
+    },
+    {
+      "field_id": "grupo",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "G4",
+      "source_formula": null,
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "D36",
+      "status": "extracted",
+      "current_value": 2234,
+      "notes": "Grupo comercial."
+    },
+    {
+      "field_id": "numero_cotas",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "G5",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 5,
+      "notes": "Quantidade numérica; layout só expõe texto em AE13."
+    },
+    {
+      "field_id": "modalidade_lance",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "G6",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": "Fixo",
+      "notes": "Livre ou fixo."
+    },
+    {
+      "field_id": "tipo_produto",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "G7",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": "Imóvel",
+      "notes": "Produto do cenário."
+    },
+    {
+      "field_id": "furo",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "AN19",
+      "source_formula": "=G8",
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "D35",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "AN19 espelha G8."
+    },
+    {
+      "field_id": "credito_base",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K4",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 200000,
+      "notes": "Base do cálculo."
+    },
+    {
+      "field_id": "prazo_cliente",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K5",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 180,
+      "notes": "Prazo em meses."
+    },
+    {
+      "field_id": "taxa_administracao_total",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K6",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 0.21,
+      "notes": "Taxa contratual total."
+    },
+    {
+      "field_id": "taxa_administracao_mensal_exibida",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "M75",
+      "source_formula": "=ROUND(((K6/K5))*100,5)&\"  % a.m.\"",
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "I36",
+      "status": "review",
+      "current_value": "0.11667  % a.m.",
+      "notes": "Layout mostra taxa mensal e não a taxa total."
+    },
+    {
+      "field_id": "seguro_prestamista",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "AF30",
+      "source_formula": "=IF(K7=\"Não\",0,_xlfn.XLOOKUP(G7,Tabela2[Produto],Tabela2[Taxa],0,0))",
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "I35",
+      "status": "extracted_partial",
+      "current_value": 0.0003245,
+      "notes": "Lookup por produto em Tabela2."
+    },
+    {
+      "field_id": "tipo_lance",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K9",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": "Lance Parcela Integral",
+      "notes": "Tipo de lance do cenário."
+    },
+    {
+      "field_id": "embutido_percentual",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K10",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Percentual de embutido."
+    },
+    {
+      "field_id": "parcelas_lance",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K13",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 54,
+      "notes": "Quantidade de parcelas do lance."
+    },
+    {
+      "field_id": "mes_previsto_lance",
+      "plan": "linear",
+      "section": "input",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "K14",
+      "source_formula": null,
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "D37",
+      "status": "review",
+      "current_value": 36,
+      "notes": "Layout trata como mês de contemplação."
+    },
+    {
+      "field_id": "lance_total",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "AN20",
+      "source_formula": "=IFERROR(O7*G5,\"Verificar Tipo de Lance\")",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 384202.83,
+      "notes": "AN20 consolida o valor total por número de cotas."
+    },
+    {
+      "field_id": "credito_disponivel",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "AN27",
+      "source_formula": "=O14*G5",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 1000000,
+      "notes": "AN27 consolida O14 por número de cotas."
+    },
+    {
+      "field_id": "diluicao_50_texto",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "AE12",
+      "source_formula": "=IF(K8=\"Linear Integral\",\"\",\"Plano de Parcela Reduzida até a contemplação\")",
+      "layout_sheet": "Simulador Linear",
+      "layout_cell": "B38",
+      "status": "extracted_partial",
+      "current_value": "Plano de Parcela Reduzida até a contemplação",
+      "notes": "Layout não expõe os valores monetários de diluição."
+    },
+    {
+      "field_id": "diluicao_50_valor",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "O12",
+      "source_formula": "=IF(IFERROR(G18-AF18,\"Verificar Tipo de Lance\")<0,\"\",IFERROR(G18-AF18,\"Verificar Tipo de Lance\"))",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 1218.6975213675,
+      "notes": "Valor monetário da diluição 50%."
+    },
+    {
+      "field_id": "diluicao_100_faixa",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "N13",
+      "source_formula": "=\"de \"&K14+1&\"º\" & \" a \" &(K5)-G8& \"º\"",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": "de 37º a 180º",
+      "notes": "Faixa textual da diluição 100%."
+    },
+    {
+      "field_id": "diluicao_100_valor",
+      "plan": "linear",
+      "section": "output",
+      "source_sheet": "Linear e Linear Reduzido",
+      "source_cell": "O13",
+      "source_formula": "=IFERROR(G18-AF19,\"Verificar Tipo de Lance\")",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 990.1917361111,
+      "notes": "Valor monetário da diluição 100%."
+    },
+    {
+      "field_id": "partner_name",
+      "plan": "pontual",
+      "section": "header",
+      "source_sheet": "Pontual",
+      "source_cell": "AB6",
+      "source_formula": null,
+      "layout_sheet": "Simulador Pontual",
+      "layout_cell": "D6",
+      "status": "extracted",
+      "current_value": "Paula",
+      "notes": "Campo simples e estável."
+    },
+    {
+      "field_id": "taxa_adesao",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "AB1",
+      "source_formula": null,
+      "layout_sheet": "Simulador Pontual",
+      "layout_cell": "D44",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Atualmente zero."
+    },
+    {
+      "field_id": "fundo_reserva",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "AB5",
+      "source_formula": null,
+      "layout_sheet": "Simulador Pontual",
+      "layout_cell": "I44",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Atualmente zero."
+    },
+    {
+      "field_id": "furo",
+      "plan": "pontual",
+      "section": "input",
+      "source_sheet": "Pontual",
+      "source_cell": "O4",
+      "source_formula": null,
+      "layout_sheet": "Simulador Pontual",
+      "layout_cell": "D43",
+      "status": "extracted",
+      "current_value": 0,
+      "notes": "Quantidade de parcelas em atraso/furo."
+    },
+    {
+      "field_id": "option_title",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "AA22",
+      "source_formula": "=IF($AB$3=\"Automóvel\",G31,D31)",
+      "layout_sheet": "Simulador Pontual",
+      "layout_cell": "C32",
+      "status": "domain_conflict",
+      "current_value": "Contemplação por Sorteio (Até 12 Meses)",
+      "notes": "Depende de AB3 e alterna entre branches Auto/Imóvel."
+    },
+    {
+      "field_id": "produto_base_controle",
+      "plan": "pontual",
+      "section": "input",
+      "source_sheet": "Pontual",
+      "source_cell": "AB3",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "domain_conflict",
+      "current_value": "Automóvel",
+      "notes": "Workbook atual gravado como Automóvel."
+    },
+    {
+      "field_id": "tipo_produto_operacional",
+      "plan": "pontual",
+      "section": "input",
+      "source_sheet": "Pontual",
+      "source_cell": "O6",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "domain_conflict",
+      "current_value": "Automóvel",
+      "notes": "Workbook atual gravado como Automóvel."
+    },
+    {
+      "field_id": "produto_chave_auto",
+      "plan": "pontual",
+      "section": "control",
+      "source_sheet": "Pontual",
+      "source_cell": "I47",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "domain_conflict",
+      "current_value": "Automóvel",
+      "notes": "Chave de comparação legada para Auto."
+    },
+    {
+      "field_id": "produto_chave_imovel",
+      "plan": "pontual",
+      "section": "control",
+      "source_sheet": "Pontual",
+      "source_cell": "I48",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "domain_conflict",
+      "current_value": "Imóvel",
+      "notes": "Chave de comparação legada para Imóvel."
+    },
+    {
+      "field_id": "numero_cotas",
+      "plan": "pontual",
+      "section": "input",
+      "source_sheet": "Pontual",
+      "source_cell": "O5",
+      "source_formula": null,
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 1,
+      "notes": "Quantidade numérica; texto final em P8."
+    },
+    {
+      "field_id": "numero_cotas_texto",
+      "plan": "pontual",
+      "section": "presentation",
+      "source_sheet": "Pontual",
+      "source_cell": "P8",
+      "source_formula": "=IF(O5=1,O5&\" cota\",O5&\" cotas\")",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": "1 cota",
+      "notes": "Texto comercial da quantidade de cotas."
+    },
+    {
+      "field_id": "valor_parcela_com_seguro",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "L7",
+      "source_formula": "=O47/L4",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 1323.2462667038,
+      "notes": "Valor da parcela com seguro."
+    },
+    {
+      "field_id": "valor_parcela_sem_seguro",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "L8",
+      "source_formula": "=O44/L4",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 1257.6210833333,
+      "notes": "Valor da parcela sem seguro."
+    },
+    {
+      "field_id": "credito_mais_taxas",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "O44",
+      "source_formula": "=L3+(L3*L6)",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 75457.265,
+      "notes": "Base de cálculo do saldo devedor."
+    },
+    {
+      "field_id": "saldo_devedor_total",
+      "plan": "pontual",
+      "section": "output",
+      "source_sheet": "Pontual",
+      "source_cell": "O47",
+      "source_formula": "=O44+O46",
+      "layout_sheet": null,
+      "layout_cell": null,
+      "status": "extracted",
+      "current_value": 79394.77600223,
+      "notes": "O44 + O46."
+    }
+  ]
+}

packages/simulation-engine/src/index.d.ts

@@ -0,0 +1,196 @@
+export interface ParametrosPlano {
+  id_plano: string;
+  nome_plano: string;
+  prazo_meses: number;
+  taxa_administracao_total: number;
+  fundo_reserva_mensal: number;
+  seguro_prestamista: number;
+}
+
+export interface SimulacaoInput {
+  credito_desejado: number;
+  parametros: ParametrosPlano;
+  tem_lance: boolean;
+  lance_percentual?: number;
+}
+
+export interface ResultadoParcela {
+  fundo_comum: number;
+  taxa_administracao: number;
+  fundo_reserva: number;
+  seguro: number;
+  total: number;
+}
+
+export interface ResultadoSimulacao {
+  credito: number;
+  prazo: number;
+  parcela_integral: ResultadoParcela;
+  parcela_reduzida?: ResultadoParcela;
+  valor_lance?: number;
+  prazo_apos_lance?: number;
+}
+
+export interface RodobensParityInput {
+  plan: "degrau" | "linear" | "pontual";
+  partner_name?: string | null;
+  grupo?: number | string | null;
+  numero_cotas?: number;
+  modalidade_lance?: string;
+  tipo_produto?: string;
+  produto_base_controle?: string;
+  furo?: number;
+  credito: number;
+  prazo_cliente: number;
+  taxa_administrativa_total: number;
+  seguro_prestamista_habilitado?: string | boolean;
+  plano?: string;
+  tipo_lance?: string;
+  embutido_percentual?: number;
+  parcelas_lance?: number;
+  mes_previsto_lance?: number;
+}
+
+export interface ResultadoParidadeRodobens {
+  [fieldId: string]: string | number | null;
+}
+
+export interface TransacaoPortabilidade {
+  valor: number;
+  contemplada: boolean;
+}
+
+export interface SimulacaoSecundarioInput {
+  fluxos_mensais: number[];
+  transacoes_portabilidade?: TransacaoPortabilidade[];
+  portabilidade_percentual_contemplada?: number;
+  portabilidade_percentual_nao_contemplada?: number;
+  volume_contratado?: number;
+  fee_percentual?: number;
+  percentual_cartas_parcela_reduzida?: number;
+  meses_pos_ultima_contemplacao?: number;
+  sem_correcao_antes_contemplacao?: boolean;
+}
+
+export interface RegrasSecundarioAplicadas {
+  portabilidade_contemplada: number;
+  portabilidade_nao_contemplada: number;
+  sem_correcao_antes_contemplacao: boolean;
+  fee_sobre_volume_reduzido_70: boolean;
+}
+
+export interface ResultadoSimulacaoSecundario {
+  fluxo_ajustado: number[];
+  custo_portabilidade: number;
+  custo_fee_parcela_reduzida: number;
+  custo_total_deducoes: number;
+  caixa_maximo_negativo: number;
+  payback_meses: number | null;
+  tir_mensal: number | null;
+  tir_anual: number | null;
+  regras_aplicadas: RegrasSecundarioAplicadas;
+}
+
+export interface ScpFlowPatternSummary {
+  id: string;
+  nome: string;
+  descricao: string;
+  pontos: number;
+  inicio?: string;
+  fim?: string;
+}
+
+export interface ScpClientDefault {
+  client_id: string;
+  client_name: string;
+  default_pattern_id: string;
+  status: string;
+}
+
+export interface ScpFlowPoint {
+  periodo: string;
+  fluxo: number;
+}
+
+export interface MontarFluxoClienteScpInput {
+  client_id: string;
+  pattern_id?: string;
+  escala_fluxo?: number;
+  deslocamento_meses?: number;
+  novo_client_id?: string;
+  novo_client_name?: string;
+}
+
+export interface MontarFluxoClienteScpOutput {
+  client_id: string;
+  client_name: string;
+  source_client_id: string;
+  pattern_id: string;
+  pattern_name: string;
+  escala_fluxo: number;
+  deslocamento_meses: number;
+  pontos: ScpFlowPoint[];
+  fluxos_mensais: number[];
+}
+
+export interface SimularSecundarioComPerfilScpInput
+  extends MontarFluxoClienteScpInput,
+    Omit<SimulacaoSecundarioInput, "fluxos_mensais"> {}
+
+export interface ResultadoSimulacaoSecundarioComPerfil
+  extends ResultadoSimulacaoSecundario {
+  fluxo_cliente: MontarFluxoClienteScpOutput;
+}
+
+export interface SimularConversaoScpConsorcioInput
+  extends SimularSecundarioComPerfilScpInput {
+  valor_imovel_base?: number;
+  desconto_imovel_percentual?: number;
+  percentual_entrada_imovel?: number;
+  agio_consorcio_percentual?: number;
+  taxa_custos_transacao_percentual?: number;
+}
+
+export interface ResultadoModoConversaoScpConsorcio {
+  natureza_cenario: string;
+  observacao: string;
+  valor_imovel_base: number;
+  desconto_imovel_percentual: number;
+  percentual_entrada_imovel: number;
+  agio_consorcio_percentual: number;
+  taxa_custos_transacao_percentual: number;
+  valor_imovel_com_desconto: number;
+  valor_entrada_imovel: number;
+  valor_credito_consorcio: number;
+  valor_custos_transacao: number;
+  investimento_total_conversao: number;
+  valor_saida_consorcio_secundario: number;
+  lucro_projetado_conversao: number;
+  roi_projetado_conversao: number | null;
+}
+
+export interface ResultadoSimulacaoConversaoScpConsorcio
+  extends ResultadoSimulacaoSecundarioComPerfil {
+  modo_conversao: ResultadoModoConversaoScpConsorcio;
+}
+
+export declare function calcularSimulacao(input: SimulacaoInput): ResultadoSimulacao;
+export declare function calcularParidadeRodobens(
+  input: RodobensParityInput
+): ResultadoParidadeRodobens;
+export declare function calcularIndicadoresSecundario(
+  input: SimulacaoSecundarioInput
+): ResultadoSimulacaoSecundario;
+export declare function listarPerfisFluxoScpDefault(): {
+  clients: ScpClientDefault[];
+  patterns: ScpFlowPatternSummary[];
+};
+export declare function montarFluxoClienteScp(
+  input: MontarFluxoClienteScpInput
+): MontarFluxoClienteScpOutput;
+export declare function simularSecundarioComPerfilScp(
+  input: SimularSecundarioComPerfilScpInput
+): ResultadoSimulacaoSecundarioComPerfil;
+export declare function simularModoConversaoScpConsorcio(
+  input: SimularConversaoScpConsorcioInput
+): ResultadoSimulacaoConversaoScpConsorcio;

packages/simulation-engine/src/index.js

@@ -0,0 +1,823 @@
+import { SCP_CLIENTS_DEFAULT, SCP_FLOW_PATTERNS_DEFAULT } from "./scpDefaults.js";
+import rodobensFieldMatrixBundle from "./generated/rodobensFieldMatrix.v1.json" with { type: "json" };
+
+function ensurePositiveNumber(name, value) {
+  if (typeof value !== "number" || Number.isNaN(value) || value <= 0) {
+    throw new Error(`${name} deve ser um numero maior que zero`);
+  }
+}
+
+function ensureNonNegativeNumber(name, value) {
+  if (typeof value !== "number" || Number.isNaN(value) || value < 0) {
+    throw new Error(`${name} deve ser um numero nao negativo`);
+  }
+}
+
+function ensurePercent(name, value) {
+  if (typeof value !== "number" || Number.isNaN(value) || value < 0 || value > 1) {
+    throw new Error(`${name} deve estar entre 0 e 1`);
+  }
+}
+
+function ensureNumberArray(name, value) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`${name} deve ser uma lista com ao menos um valor`);
+  }
+  for (const item of value) {
+    if (typeof item !== "number" || Number.isNaN(item)) {
+      throw new Error(`${name} deve conter apenas numeros`);
+    }
+  }
+}
+
+function ensureInteger(name, value) {
+  if (!Number.isInteger(value)) {
+    throw new Error(`${name} deve ser inteiro`);
+  }
+}
+
+function normalizeLookupKey(value) {
+  return String(value || "")
+    .normalize("NFD")
+    .replace(/[\u0300-\u036f]/g, "")
+    .trim()
+    .toLowerCase();
+}
+
+function formatNumberWithComma(value, decimals) {
+  return Number(value).toFixed(decimals).replace(".", ",");
+}
+
+function roundTo(value, decimals) {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
+}
+
+const RODOBENS_FIELD_MATRIX_ROWS = Array.isArray(rodobensFieldMatrixBundle?.rows)
+  ? rodobensFieldMatrixBundle.rows
+  : [];
+
+const RODOBENS_FIELD_MATRIX_BY_PLAN = RODOBENS_FIELD_MATRIX_ROWS.reduce((acc, row) => {
+  const current = acc.get(row.plan) || [];
+  current.push(row);
+  acc.set(row.plan, current);
+  return acc;
+}, new Map());
+
+const RODOBENS_PARITY_FIELD_ALIASES = {
+  mes_previsto_lance: "mes_de_contemplacao",
+  taxa_administracao_mensal_exibida: "taxa_administracao_exibida",
+  diluicao_50_texto: "texto_diluicao_50",
+};
+
+function addMonths(isoDate, deltaMonths) {
+  const [year, month, day] = isoDate.split("-").map(Number);
+  const base = new Date(Date.UTC(year, month - 1, day || 1));
+  base.setUTCMonth(base.getUTCMonth() + deltaMonths);
+  const y = base.getUTCFullYear();
+  const m = String(base.getUTCMonth() + 1).padStart(2, "0");
+  const d = String(base.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+
+function validateInput(input) {
+  if (!input || typeof input !== "object") {
+    throw new Error("input invalido");
+  }
+
+  ensurePositiveNumber("credito_desejado", input.credito_desejado);
+
+  if (!input.parametros || typeof input.parametros !== "object") {
+    throw new Error("parametros invalidos");
+  }
+
+  const p = input.parametros;
+
+  ensurePositiveNumber("prazo_meses", p.prazo_meses);
+  ensureNonNegativeNumber("taxa_administracao_total", p.taxa_administracao_total);
+  ensureNonNegativeNumber("fundo_reserva_mensal", p.fundo_reserva_mensal);
+  ensureNonNegativeNumber("seguro_prestamista", p.seguro_prestamista);
+
+  if (input.tem_lance && input.lance_percentual !== undefined) {
+    ensureNonNegativeNumber("lance_percentual", input.lance_percentual);
+  }
+}
+
+export function listarPerfisFluxoScpDefault() {
+  return {
+    clients: SCP_CLIENTS_DEFAULT.map((client) => ({ ...client })),
+    patterns: SCP_FLOW_PATTERNS_DEFAULT.map((pattern) => ({
+      id: pattern.id,
+      nome: pattern.nome,
+      descricao: pattern.descricao,
+      pontos: pattern.pontos.length,
+      inicio: pattern.pontos[0]?.periodo,
+      fim: pattern.pontos[pattern.pontos.length - 1]?.periodo,
+    })),
+  };
+}
+
+function findPattern(patternId) {
+  return SCP_FLOW_PATTERNS_DEFAULT.find((pattern) => pattern.id === patternId);
+}
+
+function findClient(clientId) {
+  return SCP_CLIENTS_DEFAULT.find((client) => client.client_id === clientId);
+}
+
+function validateScpFlowInput(input) {
+  if (!input || typeof input !== "object") {
+    throw new Error("input de fluxo scp invalido");
+  }
+  if (typeof input.client_id !== "string" || !input.client_id.trim()) {
+    throw new Error("client_id obrigatorio");
+  }
+  if (input.pattern_id !== undefined && typeof input.pattern_id !== "string") {
+    throw new Error("pattern_id deve ser string");
+  }
+  if (input.escala_fluxo !== undefined) {
+    ensurePositiveNumber("escala_fluxo", input.escala_fluxo);
+  }
+  if (input.deslocamento_meses !== undefined) {
+    ensureInteger("deslocamento_meses", input.deslocamento_meses);
+  }
+}
+
+export function montarFluxoClienteScp(input) {
+  validateScpFlowInput(input);
+
+  const client = findClient(input.client_id);
+  if (!client) {
+    throw new Error(`cliente nao encontrado: ${input.client_id}`);
+  }
+
+  const selectedPatternId = input.pattern_id || client.default_pattern_id;
+  const pattern = findPattern(selectedPatternId);
+  if (!pattern) {
+    throw new Error(`padrao de fluxo nao encontrado: ${selectedPatternId}`);
+  }
+
+  const escalaFluxo = input.escala_fluxo !== undefined ? input.escala_fluxo : 1;
+  const deslocamentoMeses =
+    input.deslocamento_meses !== undefined ? input.deslocamento_meses : 0;
+  const novoClientId =
+    input.novo_client_id && String(input.novo_client_id).trim()
+      ? String(input.novo_client_id).trim()
+      : client.client_id;
+  const novoClientName =
+    input.novo_client_name && String(input.novo_client_name).trim()
+      ? String(input.novo_client_name).trim()
+      : client.client_name;
+
+  const pontos = pattern.pontos.map((point) => ({
+    periodo:
+      deslocamentoMeses === 0
+        ? point.periodo
+        : addMonths(point.periodo, deslocamentoMeses),
+    fluxo: point.fluxo * escalaFluxo,
+  }));
+  const fluxosMensais = pontos.map((point) => point.fluxo);
+
+  return {
+    client_id: novoClientId,
+    client_name: novoClientName,
+    source_client_id: client.client_id,
+    pattern_id: pattern.id,
+    pattern_name: pattern.nome,
+    escala_fluxo: escalaFluxo,
+    deslocamento_meses: deslocamentoMeses,
+    pontos,
+    fluxos_mensais: fluxosMensais,
+  };
+}
+
+export function calcularSimulacao(input) {
+  validateInput(input);
+
+  const { credito_desejado, parametros, tem_lance, lance_percentual } = input;
+  const {
+    prazo_meses,
+    taxa_administracao_total,
+    fundo_reserva_mensal,
+    seguro_prestamista,
+  } = parametros;
+
+  const fcMensal = 1.0 / prazo_meses;
+  const taMensal = taxa_administracao_total / prazo_meses;
+
+  const valorFC = credito_desejado * fcMensal;
+  const valorTA = credito_desejado * taMensal;
+  const valorFR = credito_desejado * fundo_reserva_mensal;
+
+  const valorBaseSeguro =
+    credito_desejado + credito_desejado * taxa_administracao_total;
+  const taxaSeguroMensal = seguro_prestamista / prazo_meses;
+  const valorSeguro = valorBaseSeguro * taxaSeguroMensal;
+
+  const parcelaIntegral = {
+    fundo_comum: valorFC,
+    taxa_administracao: valorTA,
+    fundo_reserva: valorFR,
+    seguro: valorSeguro,
+    total: valorFC + valorTA + valorFR + valorSeguro,
+  };
+
+  const fatorReducao = 0.7;
+  const valorFCReduzido = valorFC * fatorReducao;
+
+  const parcelaReduzida = {
+    fundo_comum: valorFCReduzido,
+    taxa_administracao: valorTA,
+    fundo_reserva: valorFR,
+    seguro: valorSeguro,
+    total: valorFCReduzido + valorTA + valorFR + valorSeguro,
+  };
+
+  let valorLance = 0;
+  let prazoAposLance = prazo_meses;
+
+  if (tem_lance && lance_percentual && lance_percentual > 0) {
+    valorLance = credito_desejado * lance_percentual;
+    const numeroParcelasAntecipadas = Math.floor(valorLance / parcelaIntegral.total);
+    prazoAposLance = Math.max(1, prazo_meses - numeroParcelasAntecipadas);
+  }
+
+  return {
+    credito: credito_desejado,
+    prazo: prazo_meses,
+    parcela_integral: parcelaIntegral,
+    parcela_reduzida: parcelaReduzida,
+    valor_lance: tem_lance ? valorLance : undefined,
+    prazo_apos_lance: tem_lance ? prazoAposLance : undefined,
+  };
+}
+
+function getSeguroRateByProduto(produto) {
+  const key = normalizeLookupKey(produto);
+  if (key === "imovel") {
+    return 0.0003245;
+  }
+  if (key === "automovel") {
+    return 0.0008697;
+  }
+  return 0;
+}
+
+function validateRodobensParityInput(input) {
+  if (!input || typeof input !== "object") {
+    throw new Error("input de paridade rodobens invalido");
+  }
+  if (!["degrau", "linear", "pontual"].includes(input.plan)) {
+    throw new Error("plan deve ser degrau, linear ou pontual");
+  }
+  ensurePositiveNumber("credito", input.credito);
+  ensurePositiveNumber("prazo_cliente", input.prazo_cliente);
+  ensureNonNegativeNumber("taxa_administrativa_total", input.taxa_administrativa_total);
+  if (input.numero_cotas !== undefined) {
+    ensurePositiveNumber("numero_cotas", input.numero_cotas);
+  }
+  if (input.furo !== undefined) {
+    ensureNonNegativeNumber("furo", input.furo);
+  }
+  if (input.embutido_percentual !== undefined) {
+    ensureNonNegativeNumber("embutido_percentual", input.embutido_percentual);
+  }
+  if (input.parcelas_lance !== undefined) {
+    ensureNonNegativeNumber("parcelas_lance", input.parcelas_lance);
+  }
+  if (input.mes_previsto_lance !== undefined) {
+    ensureNonNegativeNumber("mes_previsto_lance", input.mes_previsto_lance);
+  }
+}
+
+function buildDegrauParityContext(input) {
+  const credito = input.credito;
+  const prazo = input.prazo_cliente;
+  const taxaAdmTotal = input.taxa_administrativa_total;
+  const numeroCotas = input.numero_cotas ?? 1;
+  const embutidoPercentual = input.embutido_percentual ?? 0;
+  const parcelasLance = input.parcelas_lance ?? 0;
+  const mesPrevistoLance = input.mes_previsto_lance ?? 0;
+  const furo = input.furo ?? 0;
+  const plano = input.plano || "Integral";
+  const tipoLance = input.tipo_lance || "Lance parcela Int";
+  const tipoProduto = input.tipo_produto || "Imóvel";
+  const seguroRate =
+    normalizeLookupKey(input.seguro_prestamista_habilitado) === "nao" ||
+    normalizeLookupKey(input.seguro_prestamista_habilitado) === "não"
+      ? 0
+      : getSeguroRateByProduto(tipoProduto);
+  const reductionFactor = plano.includes("50%")
+    ? 0.5
+    : plano.includes("70%")
+      ? 0.7
+      : 1;
+
+  const parcelaSeguro = ((credito * taxaAdmTotal) + credito) * seguroRate;
+  const parcelaIntegralPrimeiraMetade =
+    credito / prazo + (credito * taxaAdmTotal) / (prazo / 2) + parcelaSeguro;
+  const parcelaIntegralSegundaMetade = credito / prazo + parcelaSeguro;
+  const parcelaReduzidaPrimeiraMetade =
+    ((credito / prazo) + (credito * taxaAdmTotal) / (prazo / 2)) * reductionFactor +
+    parcelaSeguro;
+  const parcelaReduzidaSegundaMetade =
+    (credito / prazo) * reductionFactor + parcelaSeguro;
+  const primeiraParcelaPorCota =
+    plano === "Integral"
+      ? parcelaIntegralPrimeiraMetade
+      : parcelaReduzidaPrimeiraMetade;
+  const lanceEmbutidoValor = credito * embutidoPercentual;
+  const usaLanceReduzido = normalizeLookupKey(tipoLance).includes("red");
+  const parcelaPrimeiraMetadeParaLance = usaLanceReduzido
+    ? parcelaReduzidaPrimeiraMetade
+    : parcelaIntegralPrimeiraMetade;
+  const parcelaSegundaMetadeParaLance = usaLanceReduzido
+    ? parcelaReduzidaSegundaMetade
+    : parcelaIntegralSegundaMetade;
+  const metadePrazo = prazo / 2;
+  const lanceTotalPorCota =
+    parcelasLance > metadePrazo
+      ? metadePrazo * parcelaSegundaMetadeParaLance +
+        (parcelasLance - metadePrazo) * parcelaPrimeiraMetadeParaLance
+      : parcelasLance * parcelaSegundaMetadeParaLance;
+  const lanceTotal = lanceTotalPorCota * numeroCotas;
+  const recursoProprio = lanceTotal - lanceEmbutidoValor * numeroCotas;
+  const creditoDisponivel = (credito - lanceEmbutidoValor) * numeroCotas;
+
+  return {
+    partner_name: input.partner_name ?? null,
+    plan_label: `Degrau ${plano}`,
+    numero_cotas: numeroCotas,
+    credito_contratado: credito * numeroCotas,
+    lance_total: lanceTotal,
+    lance_embutido_valor: lanceEmbutidoValor * numeroCotas,
+    recurso_proprio: recursoProprio,
+    primeira_parcela: primeiraParcelaPorCota * numeroCotas,
+    credito_disponivel: creditoDisponivel,
+    credito_liquido: creditoDisponivel,
+    furo,
+    mes_de_contemplacao: mesPrevistoLance,
+    seguro_prestamista: seguroRate,
+    fundo_reserva: 0,
+    taxa_administracao_exibida: `${formatNumberWithComma(
+      roundTo((taxaAdmTotal / prazo) * 100, 6),
+      4,
+    )} % a.m.`,
+    taxa_adesao: 0,
+    diluicao_50_texto: null,
+    option_title: null,
+    saldo_devedor_total: null,
+  };
+}
+
+function buildLinearParityContext(input) {
+  const taxaAdmTotal = input.taxa_administrativa_total;
+  const prazo = input.prazo_cliente;
+  const plano = input.plano || "Linear Integral";
+  const tipoProduto = input.tipo_produto || "Imóvel";
+  const seguroRate =
+    normalizeLookupKey(input.seguro_prestamista_habilitado) === "sim"
+      ? getSeguroRateByProduto(tipoProduto)
+      : 0;
+
+  return {
+    partner_name: input.partner_name || null,
+    furo: input.furo ?? 0,
+    seguro_prestamista: seguroRate,
+    grupo: input.grupo ?? null,
+    plan_label: plano,
+    numero_cotas: input.numero_cotas ?? null,
+    taxa_administracao_exibida: `${roundTo((taxaAdmTotal / prazo) * 100, 5).toFixed(
+      5,
+    )}  % a.m.`,
+    mes_de_contemplacao: input.mes_previsto_lance ?? null,
+    texto_diluicao_50:
+      plano === "Linear Integral" ? "" : "Plano de Parcela Reduzida até a contemplação",
+    credito_contratado: null,
+    lance_total: null,
+    lance_embutido_valor: null,
+    recurso_proprio: null,
+    primeira_parcela: null,
+    credito_disponivel: null,
+    credito_liquido: null,
+    taxa_adesao: null,
+    option_title: null,
+    saldo_devedor_total: null,
+  };
+}
+
+function buildPontualParityContext(input) {
+  const produtoBaseControle = input.produto_base_controle || input.tipo_produto || "Automóvel";
+  const saldoBase = input.credito * (1 + input.taxa_administrativa_total);
+  const seguroRate = getSeguroRateByProduto(produtoBaseControle);
+  const saldoDevedorTotal = saldoBase * (1 + input.prazo_cliente * seguroRate);
+  const usaBranchAuto = normalizeLookupKey(produtoBaseControle) === "automovel";
+
+  return {
+    partner_name: input.partner_name || null,
+    option_title: usaBranchAuto
+      ? "Contemplação por Sorteio (Até 12 Meses)"
+      : "Contemplação por Sorteio (Até 24 Meses)",
+    furo: input.furo ?? 0,
+    plan_label: usaBranchAuto ? "Plano Pontual - Auto" : "Plano Pontual - Imóvel",
+    numero_cotas: input.numero_cotas ?? null,
+    taxa_adesao: 0,
+    fundo_reserva: 0,
+    saldo_devedor_total: saldoDevedorTotal,
+    credito_contratado: null,
+    lance_total: null,
+    lance_embutido_valor: null,
+    recurso_proprio: null,
+    primeira_parcela: null,
+    credito_disponivel: null,
+    credito_liquido: null,
+    grupo: input.grupo ?? null,
+    mes_de_contemplacao: null,
+    seguro_prestamista: null,
+    taxa_administracao_exibida: null,
+    texto_diluicao_50: null,
+  };
+}
+
+function getRodobensParityMatrixRows(plan) {
+  const rows = RODOBENS_FIELD_MATRIX_BY_PLAN.get(plan) || [];
+  return rows.filter((row) => {
+    if (row.status === "pending") {
+      return false;
+    }
+    if (row.layout_cell) {
+      return true;
+    }
+    return row.field_id === "saldo_devedor_total";
+  });
+}
+
+function resolveRodobensParityField(row, input, context) {
+  const outputFieldId = RODOBENS_PARITY_FIELD_ALIASES[row.field_id] || row.field_id;
+  if (Object.hasOwn(context, outputFieldId)) {
+    return context[outputFieldId];
+  }
+  if (Object.hasOwn(context, row.field_id)) {
+    return context[row.field_id];
+  }
+  if (Object.hasOwn(input, outputFieldId)) {
+    return input[outputFieldId];
+  }
+  if (Object.hasOwn(input, row.field_id)) {
+    return input[row.field_id];
+  }
+  if (row.current_value !== undefined && row.current_value !== null && row.status === "review") {
+    return row.current_value;
+  }
+  return undefined;
+}
+
+export function calcularParidadeRodobens(input) {
+  validateRodobensParityInput(input);
+
+  let context;
+  if (input.plan === "degrau") {
+    context = buildDegrauParityContext(input);
+  } else if (input.plan === "linear") {
+    context = buildLinearParityContext(input);
+  } else {
+    context = buildPontualParityContext(input);
+  }
+
+  const result = {};
+  for (const row of getRodobensParityMatrixRows(input.plan)) {
+    const value = resolveRodobensParityField(row, input, context);
+    const outputFieldId = RODOBENS_PARITY_FIELD_ALIASES[row.field_id] || row.field_id;
+    if (value !== undefined) {
+      result[outputFieldId] = value;
+    }
+  }
+  return result;
+}
+
+function npv(rate, cashflows) {
+  let value = 0;
+  for (let i = 0; i < cashflows.length; i += 1) {
+    value += cashflows[i] / (1 + rate) ** i;
+  }
+  return value;
+}
+
+function hasSignChange(cashflows) {
+  let hasPositive = false;
+  let hasNegative = false;
+  for (const value of cashflows) {
+    if (value > 0) {
+      hasPositive = true;
+    }
+    if (value < 0) {
+      hasNegative = true;
+    }
+    if (hasPositive && hasNegative) {
+      return true;
+    }
+  }
+  return false;
+}
+
+function calculateIrrMonthly(cashflows) {
+  if (!hasSignChange(cashflows)) {
+    return null;
+  }
+
+  let low = -0.9999;
+  let high = 10;
+  let npvLow = npv(low, cashflows);
+  let npvHigh = npv(high, cashflows);
+
+  if (npvLow === 0) {
+    return low;
+  }
+  if (npvHigh === 0) {
+    return high;
+  }
+
+  let attempts = 0;
+  while (npvLow * npvHigh > 0 && attempts < 50) {
+    high *= 2;
+    npvHigh = npv(high, cashflows);
+    attempts += 1;
+  }
+
+  if (npvLow * npvHigh > 0) {
+    return null;
+  }
+
+  for (let i = 0; i < 200; i += 1) {
+    const mid = (low + high) / 2;
+    const npvMid = npv(mid, cashflows);
+    if (Math.abs(npvMid) < 1e-8) {
+      return mid;
+    }
+    if (npvLow * npvMid < 0) {
+      high = mid;
+      npvHigh = npvMid;
+    } else {
+      low = mid;
+      npvLow = npvMid;
+    }
+  }
+
+  return (low + high) / 2;
+}
+
+function validateSecondaryInput(input) {
+  if (!input || typeof input !== "object") {
+    throw new Error("input secundario invalido");
+  }
+  ensureNumberArray("fluxos_mensais", input.fluxos_mensais);
+
+  if (input.portabilidade_percentual_contemplada !== undefined) {
+    ensurePercent(
+      "portabilidade_percentual_contemplada",
+      input.portabilidade_percentual_contemplada
+    );
+  }
+  if (input.portabilidade_percentual_nao_contemplada !== undefined) {
+    ensurePercent(
+      "portabilidade_percentual_nao_contemplada",
+      input.portabilidade_percentual_nao_contemplada
+    );
+  }
+  if (input.fee_percentual !== undefined) {
+    ensurePercent("fee_percentual", input.fee_percentual);
+  }
+  if (input.percentual_cartas_parcela_reduzida !== undefined) {
+    ensurePercent(
+      "percentual_cartas_parcela_reduzida",
+      input.percentual_cartas_parcela_reduzida
+    );
+  }
+  if (input.volume_contratado !== undefined) {
+    ensureNonNegativeNumber("volume_contratado", input.volume_contratado);
+  }
+  if (input.meses_pos_ultima_contemplacao !== undefined) {
+    ensureNonNegativeNumber(
+      "meses_pos_ultima_contemplacao",
+      input.meses_pos_ultima_contemplacao
+    );
+  }
+
+  if (input.transacoes_portabilidade !== undefined) {
+    if (!Array.isArray(input.transacoes_portabilidade)) {
+      throw new Error("transacoes_portabilidade deve ser uma lista");
+    }
+    for (const transacao of input.transacoes_portabilidade) {
+      if (!transacao || typeof transacao !== "object") {
+        throw new Error("transacoes_portabilidade contem item invalido");
+      }
+      ensureNonNegativeNumber("transacao.valor", transacao.valor);
+      if (typeof transacao.contemplada !== "boolean") {
+        throw new Error("transacao.contemplada deve ser boolean");
+      }
+    }
+  }
+}
+
+export function calcularIndicadoresSecundario(input) {
+  validateSecondaryInput(input);
+
+  const portabilidadeContemplada =
+    input.portabilidade_percentual_contemplada !== undefined
+      ? input.portabilidade_percentual_contemplada
+      : 0.01;
+  const portabilidadeNaoContemplada =
+    input.portabilidade_percentual_nao_contemplada !== undefined
+      ? input.portabilidade_percentual_nao_contemplada
+      : 0.005;
+  const feePercentual = input.fee_percentual !== undefined ? input.fee_percentual : 0;
+  const volumeContratado =
+    input.volume_contratado !== undefined ? input.volume_contratado : 0;
+  const percentualCartasParcelaReduzida =
+    input.percentual_cartas_parcela_reduzida !== undefined
+      ? input.percentual_cartas_parcela_reduzida
+      : 0;
+  const mesesPosUltimaContemplacao =
+    input.meses_pos_ultima_contemplacao !== undefined
+      ? input.meses_pos_ultima_contemplacao
+      : 0;
+
+  let custoPortabilidade = 0;
+  const transacoes = input.transacoes_portabilidade || [];
+  for (const transacao of transacoes) {
+    const taxa = transacao.contemplada
+      ? portabilidadeContemplada
+      : portabilidadeNaoContemplada;
+    custoPortabilidade += transacao.valor * taxa;
+  }
+
+  const fatorFeeVolume =
+    (1 - percentualCartasParcelaReduzida) + percentualCartasParcelaReduzida * 0.7;
+  const custoFeeParcelaReduzida = volumeContratado * fatorFeeVolume * feePercentual;
+  const custoTotalDeducoes = custoPortabilidade + custoFeeParcelaReduzida;
+
+  const fluxosAjustados = [...input.fluxos_mensais];
+  fluxosAjustados[0] -= custoTotalDeducoes;
+
+  let acumulado = 0;
+  let caixaMaximoNegativo = 0;
+  let paybackBase = null;
+
+  for (let i = 0; i < fluxosAjustados.length; i += 1) {
+    acumulado += fluxosAjustados[i];
+    if (acumulado < caixaMaximoNegativo) {
+      caixaMaximoNegativo = acumulado;
+    }
+    if (paybackBase === null && acumulado >= 0) {
+      paybackBase = i + 1;
+    }
+  }
+
+  const tirMensal = calculateIrrMonthly(fluxosAjustados);
+  const tirAnual = tirMensal === null ? null : (1 + tirMensal) ** 12 - 1;
+
+  const paybackMeses =
+    paybackBase === null ? null : paybackBase + mesesPosUltimaContemplacao;
+
+  return {
+    fluxo_ajustado: fluxosAjustados,
+    custo_portabilidade: custoPortabilidade,
+    custo_fee_parcela_reduzida: custoFeeParcelaReduzida,
+    custo_total_deducoes: custoTotalDeducoes,
+    caixa_maximo_negativo: caixaMaximoNegativo,
+    payback_meses: paybackMeses,
+    tir_mensal: tirMensal,
+    tir_anual: tirAnual,
+    regras_aplicadas: {
+      portabilidade_contemplada: portabilidadeContemplada,
+      portabilidade_nao_contemplada: portabilidadeNaoContemplada,
+      sem_correcao_antes_contemplacao:
+        input.sem_correcao_antes_contemplacao !== undefined
+          ? Boolean(input.sem_correcao_antes_contemplacao)
+          : true,
+      fee_sobre_volume_reduzido_70: true,
+    },
+  };
+}
+
+export function simularSecundarioComPerfilScp(input) {
+  if (!input || typeof input !== "object") {
+    throw new Error("input de simulacao scp invalido");
+  }
+  const fluxoCliente = montarFluxoClienteScp({
+    client_id: input.client_id,
+    pattern_id: input.pattern_id,
+    escala_fluxo: input.escala_fluxo,
+    deslocamento_meses: input.deslocamento_meses,
+    novo_client_id: input.novo_client_id,
+    novo_client_name: input.novo_client_name,
+  });
+
+  const simulacao = calcularIndicadoresSecundario({
+    fluxos_mensais: fluxoCliente.fluxos_mensais,
+    transacoes_portabilidade: input.transacoes_portabilidade,
+    portabilidade_percentual_contemplada:
+      input.portabilidade_percentual_contemplada,
+    portabilidade_percentual_nao_contemplada:
+      input.portabilidade_percentual_nao_contemplada,
+    volume_contratado: input.volume_contratado,
+    fee_percentual: input.fee_percentual,
+    percentual_cartas_parcela_reduzida:
+      input.percentual_cartas_parcela_reduzida,
+    meses_pos_ultima_contemplacao: input.meses_pos_ultima_contemplacao,
+    sem_correcao_antes_contemplacao: input.sem_correcao_antes_contemplacao,
+  });
+
+  return {
+    ...simulacao,
+    fluxo_cliente: fluxoCliente,
+  };
+}
+
+function validateConversaoInput(input) {
+  if (!input || typeof input !== "object") {
+    throw new Error("input de conversao invalido");
+  }
+  if (input.valor_imovel_base !== undefined) {
+    ensurePositiveNumber("valor_imovel_base", input.valor_imovel_base);
+  }
+  if (input.desconto_imovel_percentual !== undefined) {
+    ensurePercent("desconto_imovel_percentual", input.desconto_imovel_percentual);
+  }
+  if (input.percentual_entrada_imovel !== undefined) {
+    ensurePercent("percentual_entrada_imovel", input.percentual_entrada_imovel);
+  }
+  if (input.agio_consorcio_percentual !== undefined) {
+    ensurePercent("agio_consorcio_percentual", input.agio_consorcio_percentual);
+  }
+  if (input.taxa_custos_transacao_percentual !== undefined) {
+    ensurePercent(
+      "taxa_custos_transacao_percentual",
+      input.taxa_custos_transacao_percentual
+    );
+  }
+}
+
+export function simularModoConversaoScpConsorcio(input) {
+  validateConversaoInput(input);
+
+  const secundario = simularSecundarioComPerfilScp(input);
+  const valorImovelBase =
+    input.valor_imovel_base !== undefined ? input.valor_imovel_base : 500000;
+  const descontoImovelPercentual =
+    input.desconto_imovel_percentual !== undefined
+      ? input.desconto_imovel_percentual
+      : 0.15;
+  const percentualEntradaImovel =
+    input.percentual_entrada_imovel !== undefined
+      ? input.percentual_entrada_imovel
+      : 0.2;
+  const agioConsorcioPercentual =
+    input.agio_consorcio_percentual !== undefined
+      ? input.agio_consorcio_percentual
+      : 0.12;
+  const taxaCustosTransacaoPercentual =
+    input.taxa_custos_transacao_percentual !== undefined
+      ? input.taxa_custos_transacao_percentual
+      : 0;
+
+  const valorImovelComDesconto =
+    valorImovelBase * (1 - descontoImovelPercentual);
+  const valorEntrada = valorImovelComDesconto * percentualEntradaImovel;
+  const valorCreditoConsorcio =
+    valorImovelComDesconto - valorEntrada;
+  const valorCustosTransacao =
+    valorImovelComDesconto * taxaCustosTransacaoPercentual;
+  const investimentoTotalConversao =
+    valorEntrada + valorCustosTransacao + secundario.custo_total_deducoes;
+  const valorSaidaConsorcioSecundario =
+    valorCreditoConsorcio * (1 + agioConsorcioPercentual);
+  const lucroProjetadoConversao =
+    valorSaidaConsorcioSecundario - investimentoTotalConversao;
+  const roiProjetadoConversao =
+    investimentoTotalConversao > 0
+      ? lucroProjetadoConversao / investimentoTotalConversao
+      : null;
+
+  return {
+    ...secundario,
+    modo_conversao: {
+      natureza_cenario: "fechado_customizavel",
+      observacao:
+        "Cenario de conversao SCP para compra de imovel com desconto e operacao no secundario.",
+      valor_imovel_base: valorImovelBase,
+      desconto_imovel_percentual: descontoImovelPercentual,
+      percentual_entrada_imovel: percentualEntradaImovel,
+      agio_consorcio_percentual: agioConsorcioPercentual,
+      taxa_custos_transacao_percentual: taxaCustosTransacaoPercentual,
+      valor_imovel_com_desconto: valorImovelComDesconto,
+      valor_entrada_imovel: valorEntrada,
+      valor_credito_consorcio: valorCreditoConsorcio,
+      valor_custos_transacao: valorCustosTransacao,
+      investimento_total_conversao: investimentoTotalConversao,
+      valor_saida_consorcio_secundario: valorSaidaConsorcioSecundario,
+      lucro_projetado_conversao: lucroProjetadoConversao,
+      roi_projetado_conversao: roiProjetadoConversao,
+    },
+  };
+}

packages/simulation-engine/src/scpDefaults.js

@@ -0,0 +1,658 @@
+const EMPTY_FLOW_PATTERN = {
+  id: "scp_sem_fluxo",
+  nome: "SCP sem fluxo histórico",
+  descricao: "Template vazio para clientes sem histórico carregado.",
+  pontos: [{ periodo: "2021-01-01", fluxo: 0 }],
+};
+
+const EXTRATO_6_FLOW_PATTERN = {
+  id: "scp_extrato_6_consolidado",
+  nome: "SCP Extrato Investidor 6 (Consolidado)",
+  descricao: "Fluxo consolidado mensal normalizado do investidor 6 (2021-02 a 2034-01).",
+  pontos: [
+  {
+    "periodo": "2021-02-01",
+    "fluxo": -737564.52
+  },
+  {
+    "periodo": "2021-03-01",
+    "fluxo": -89500.47
+  },
+  {
+    "periodo": "2021-04-01",
+    "fluxo": -98532.08
+  },
+  {
+    "periodo": "2021-06-01",
+    "fluxo": -93528.63
+  },
+  {
+    "periodo": "2021-07-01",
+    "fluxo": -92248.24
+  },
+  {
+    "periodo": "2021-09-01",
+    "fluxo": -89535.06
+  },
+  {
+    "periodo": "2021-10-01",
+    "fluxo": -88098.84
+  },
+  {
+    "periodo": "2021-12-01",
+    "fluxo": -156634.54
+  },
+  {
+    "periodo": "2022-02-01",
+    "fluxo": -150588.0
+  },
+  {
+    "periodo": "2022-03-01",
+    "fluxo": -50408.16
+  },
+  {
+    "periodo": "2022-04-01",
+    "fluxo": -29554.74
+  },
+  {
+    "periodo": "2022-05-01",
+    "fluxo": -618506.94
+  },
+  {
+    "periodo": "2022-06-01",
+    "fluxo": -736408.34
+  },
+  {
+    "periodo": "2022-07-01",
+    "fluxo": -188867.66
+  },
+  {
+    "periodo": "2022-08-01",
+    "fluxo": -95358.15
+  },
+  {
+    "periodo": "2022-09-01",
+    "fluxo": -224642.19
+  },
+  {
+    "periodo": "2022-10-01",
+    "fluxo": -281891.02
+  },
+  {
+    "periodo": "2022-11-01",
+    "fluxo": -693594.29
+  },
+  {
+    "periodo": "2022-12-01",
+    "fluxo": -499447.91
+  },
+  {
+    "periodo": "2023-01-01",
+    "fluxo": -646374.71
+  },
+  {
+    "periodo": "2023-02-01",
+    "fluxo": -919693.27
+  },
+  {
+    "periodo": "2023-03-01",
+    "fluxo": -1067632.66
+  },
+  {
+    "periodo": "2023-04-01",
+    "fluxo": -992735.29
+  },
+  {
+    "periodo": "2023-05-01",
+    "fluxo": -445363.53
+  },
+  {
+    "periodo": "2023-06-01",
+    "fluxo": -296225.14
+  },
+  {
+    "periodo": "2023-07-01",
+    "fluxo": -251036.26
+  },
+  {
+    "periodo": "2023-08-01",
+    "fluxo": -187543.36
+  },
+  {
+    "periodo": "2023-09-01",
+    "fluxo": -255700.26
+  },
+  {
+    "periodo": "2023-10-01",
+    "fluxo": -23630.06
+  },
+  {
+    "periodo": "2023-11-01",
+    "fluxo": -186845.68
+  },
+  {
+    "periodo": "2023-12-01",
+    "fluxo": -145086.8
+  },
+  {
+    "periodo": "2024-01-01",
+    "fluxo": -20697.02
+  },
+  {
+    "periodo": "2024-02-01",
+    "fluxo": -122169.49
+  },
+  {
+    "periodo": "2024-03-01",
+    "fluxo": -73130.94
+  },
+  {
+    "periodo": "2024-04-01",
+    "fluxo": -125938.56
+  },
+  {
+    "periodo": "2024-07-01",
+    "fluxo": -39950.54
+  },
+  {
+    "periodo": "2024-08-01",
+    "fluxo": -61941.22
+  },
+  {
+    "periodo": "2024-09-01",
+    "fluxo": -54658.48
+  },
+  {
+    "periodo": "2024-10-01",
+    "fluxo": -225120.87
+  },
+  {
+    "periodo": "2024-11-01",
+    "fluxo": -125567.88
+  },
+  {
+    "periodo": "2024-12-01",
+    "fluxo": -124604.04
+  },
+  {
+    "periodo": "2025-01-01",
+    "fluxo": -162232.609879
+  },
+  {
+    "periodo": "2025-02-01",
+    "fluxo": 9840.556197
+  },
+  {
+    "periodo": "2025-03-01",
+    "fluxo": -432548.202122
+  },
+  {
+    "periodo": "2025-04-01",
+    "fluxo": -458262.952122
+  },
+  {
+    "periodo": "2025-05-01",
+    "fluxo": -423097.697657
+  },
+  {
+    "periodo": "2025-06-01",
+    "fluxo": -434612.579173
+  },
+  {
+    "periodo": "2025-07-01",
+    "fluxo": -121779.498649
+  },
+  {
+    "periodo": "2025-08-01",
+    "fluxo": -307297.083824
+  },
+  {
+    "periodo": "2025-09-01",
+    "fluxo": -329799.813629
+  },
+  {
+    "periodo": "2025-10-01",
+    "fluxo": -225956.066969
+  },
+  {
+    "periodo": "2025-11-01",
+    "fluxo": -288445.512606
+  },
+  {
+    "periodo": "2025-12-01",
+    "fluxo": -283414.556707
+  },
+  {
+    "periodo": "2026-01-01",
+    "fluxo": 527518.470288
+  },
+  {
+    "periodo": "2026-02-01",
+    "fluxo": 269150.845685
+  },
+  {
+    "periodo": "2026-03-01",
+    "fluxo": 1305376.352862
+  },
+  {
+    "periodo": "2026-04-01",
+    "fluxo": 280794.893435
+  },
+  {
+    "periodo": "2026-05-01",
+    "fluxo": 209821.215034
+  },
+  {
+    "periodo": "2026-06-01",
+    "fluxo": 60100.726869
+  },
+  {
+    "periodo": "2026-07-01",
+    "fluxo": 337614.567424
+  },
+  {
+    "periodo": "2026-08-01",
+    "fluxo": 294318.884378
+  },
+  {
+    "periodo": "2026-09-01",
+    "fluxo": -46141.362479
+  },
+  {
+    "periodo": "2026-10-01",
+    "fluxo": -55076.915784
+  },
+  {
+    "periodo": "2026-11-01",
+    "fluxo": 19929.808238
+  },
+  {
+    "periodo": "2026-12-01",
+    "fluxo": 500315.052052
+  },
+  {
+    "periodo": "2027-01-01",
+    "fluxo": -218977.546392
+  },
+  {
+    "periodo": "2027-02-01",
+    "fluxo": 994.423556
+  },
+  {
+    "periodo": "2027-03-01",
+    "fluxo": 404025.712056
+  },
+  {
+    "periodo": "2027-04-01",
+    "fluxo": 233575.22893
+  },
+  {
+    "periodo": "2027-05-01",
+    "fluxo": 238878.882716
+  },
+  {
+    "periodo": "2027-06-01",
+    "fluxo": 6990240.630296
+  },
+  {
+    "periodo": "2027-07-01",
+    "fluxo": 1874488.174107
+  },
+  {
+    "periodo": "2027-08-01",
+    "fluxo": 1113986.478002
+  },
+  {
+    "periodo": "2027-09-01",
+    "fluxo": 272380.708805
+  },
+  {
+    "periodo": "2027-10-01",
+    "fluxo": 1301052.16967
+  },
+  {
+    "periodo": "2027-11-01",
+    "fluxo": 1277465.729149
+  },
+  {
+    "periodo": "2027-12-01",
+    "fluxo": 1206630.595673
+  },
+  {
+    "periodo": "2028-01-01",
+    "fluxo": 1084333.681223
+  },
+  {
+    "periodo": "2028-02-01",
+    "fluxo": 79390.514072
+  },
+  {
+    "periodo": "2028-03-01",
+    "fluxo": 104139.639919
+  },
+  {
+    "periodo": "2028-04-01",
+    "fluxo": 34705.936188
+  },
+  {
+    "periodo": "2028-05-01",
+    "fluxo": 35063.791729
+  },
+  {
+    "periodo": "2028-06-01",
+    "fluxo": 35424.772993
+  },
+  {
+    "periodo": "2028-07-01",
+    "fluxo": 40009.831092
+  },
+  {
+    "periodo": "2028-08-01",
+    "fluxo": 40377.145945
+  },
+  {
+    "periodo": "2028-09-01",
+    "fluxo": 40747.669145
+  },
+  {
+    "periodo": "2028-10-01",
+    "fluxo": 41121.428714
+  },
+  {
+    "periodo": "2028-11-01",
+    "fluxo": 41498.452921
+  },
+  {
+    "periodo": "2028-12-01",
+    "fluxo": 40274.370333
+  },
+  {
+    "periodo": "2029-01-01",
+    "fluxo": 42262.40956
+  },
+  {
+    "periodo": "2029-02-01",
+    "fluxo": 43242.020582
+  },
+  {
+    "periodo": "2029-03-01",
+    "fluxo": 43632.390996
+  },
+  {
+    "periodo": "2029-04-01",
+    "fluxo": 44026.171137
+  },
+  {
+    "periodo": "2029-05-01",
+    "fluxo": 44423.390787
+  },
+  {
+    "periodo": "2029-06-01",
+    "fluxo": 44824.07999
+  },
+  {
+    "periodo": "2029-07-01",
+    "fluxo": 42992.830516
+  },
+  {
+    "periodo": "2029-08-01",
+    "fluxo": 44180.546937
+  },
+  {
+    "periodo": "2029-09-01",
+    "fluxo": 46015.260076
+  },
+  {
+    "periodo": "2029-10-01",
+    "fluxo": 46348.355526
+  },
+  {
+    "periodo": "2029-11-01",
+    "fluxo": 46680.813555
+  },
+  {
+    "periodo": "2029-12-01",
+    "fluxo": 40802.289293
+  },
+  {
+    "periodo": "2030-01-01",
+    "fluxo": 45820.242381
+  },
+  {
+    "periodo": "2030-02-01",
+    "fluxo": 46081.313866
+  },
+  {
+    "periodo": "2030-03-01",
+    "fluxo": 44637.236299
+  },
+  {
+    "periodo": "2030-04-01",
+    "fluxo": 38100.997039
+  },
+  {
+    "periodo": "2030-05-01",
+    "fluxo": 47917.662965
+  },
+  {
+    "periodo": "2030-06-01",
+    "fluxo": 48156.62759
+  },
+  {
+    "periodo": "2030-07-01",
+    "fluxo": 48396.751508
+  },
+  {
+    "periodo": "2030-08-01",
+    "fluxo": 48638.040343
+  },
+  {
+    "periodo": "2030-09-01",
+    "fluxo": 48883.754858
+  },
+  {
+    "periodo": "2030-10-01",
+    "fluxo": 49130.658876
+  },
+  {
+    "periodo": "2030-11-01",
+    "fluxo": 49375.476465
+  },
+  {
+    "periodo": "2030-12-01",
+    "fluxo": 49621.481732
+  },
+  {
+    "periodo": "2031-01-01",
+    "fluxo": 49276.059627
+  },
+  {
+    "periodo": "2031-02-01",
+    "fluxo": 49524.457559
+  },
+  {
+    "periodo": "2031-03-01",
+    "fluxo": 49774.060533
+  },
+  {
+    "periodo": "2031-04-01",
+    "fluxo": 50024.874392
+  },
+  {
+    "periodo": "2031-05-01",
+    "fluxo": 50276.90501
+  },
+  {
+    "periodo": "2031-06-01",
+    "fluxo": 50530.158287
+  },
+  {
+    "periodo": "2031-07-01",
+    "fluxo": 50784.640153
+  },
+  {
+    "periodo": "2031-08-01",
+    "fluxo": 51040.356565
+  },
+  {
+    "periodo": "2031-09-01",
+    "fluxo": 51300.731381
+  },
+  {
+    "periodo": "2031-10-01",
+    "fluxo": 51562.366671
+  },
+  {
+    "periodo": "2031-11-01",
+    "fluxo": 51821.822762
+  },
+  {
+    "periodo": "2031-12-01",
+    "fluxo": 52082.537521
+  },
+  {
+    "periodo": "2032-01-01",
+    "fluxo": 52344.517054
+  },
+  {
+    "periodo": "2032-02-01",
+    "fluxo": 52607.767494
+  },
+  {
+    "periodo": "2032-03-01",
+    "fluxo": 52872.295004
+  },
+  {
+    "periodo": "2032-04-01",
+    "fluxo": 53138.105778
+  },
+  {
+    "periodo": "2032-05-01",
+    "fluxo": 53405.206038
+  },
+  {
+    "periodo": "2032-06-01",
+    "fluxo": 53673.602039
+  },
+  {
+    "periodo": "2032-07-01",
+    "fluxo": 53943.300063
+  },
+  {
+    "periodo": "2032-08-01",
+    "fluxo": 54933.3961
+  },
+  {
+    "periodo": "2032-09-01",
+    "fluxo": 55209.305909
+  },
+  {
+    "periodo": "2032-10-01",
+    "fluxo": 55486.551398
+  },
+  {
+    "periodo": "2032-11-01",
+    "fluxo": 55765.139032
+  },
+  {
+    "periodo": "2032-12-01",
+    "fluxo": 56045.075308
+  },
+  {
+    "periodo": "2033-01-01",
+    "fluxo": 56918.987568
+  },
+  {
+    "periodo": "2033-02-01",
+    "fluxo": 57201.640748
+  },
+  {
+    "periodo": "2033-03-01",
+    "fluxo": 57485.662252
+  },
+  {
+    "periodo": "2033-04-01",
+    "fluxo": 59082.100043
+  },
+  {
+    "periodo": "2033-05-01",
+    "fluxo": 59526.20306
+  },
+  {
+    "periodo": "2033-06-01",
+    "fluxo": 59814.369409
+  },
+  {
+    "periodo": "2033-07-01",
+    "fluxo": 60103.930771
+  },
+  {
+    "periodo": "2033-08-01",
+    "fluxo": 60394.8939
+  },
+  {
+    "periodo": "2033-09-01",
+    "fluxo": 60687.265581
+  },
+  {
+    "periodo": "2033-10-01",
+    "fluxo": 60981.052634
+  },
+  {
+    "periodo": "2033-11-01",
+    "fluxo": 61276.26191
+  },
+  {
+    "periodo": "2033-12-01",
+    "fluxo": 61572.900294
+  },
+  {
+    "periodo": "2034-01-01",
+    "fluxo": 11858703.094597
+  }
+],
+};
+
+export const SCP_FLOW_PATTERNS_DEFAULT = [
+  EMPTY_FLOW_PATTERN,
+  EXTRATO_6_FLOW_PATTERN,
+];
+
+export const SCP_CLIENTS_DEFAULT = [
+  {
+    client_id: "extrato_investidor_1",
+    client_name: "Extrato Investidor 1",
+    default_pattern_id: "scp_sem_fluxo",
+    status: "sem_fluxo_historico",
+  },
+  {
+    client_id: "extrato_investidor_2",
+    client_name: "Extrato Investidor 2",
+    default_pattern_id: "scp_sem_fluxo",
+    status: "sem_fluxo_historico",
+  },
+  {
+    client_id: "extrato_investidor_3",
+    client_name: "Extrato Investidor 3",
+    default_pattern_id: "scp_sem_fluxo",
+    status: "sem_fluxo_historico",
+  },
+  {
+    client_id: "extrato_investidor_4",
+    client_name: "Extrato Investidor 4",
+    default_pattern_id: "scp_sem_fluxo",
+    status: "sem_fluxo_historico",
+  },
+  {
+    client_id: "extrato_investidor_5",
+    client_name: "Extrato Investidor 5",
+    default_pattern_id: "scp_sem_fluxo",
+    status: "sem_fluxo_historico",
+  },
+  {
+    client_id: "extrato_investidor_6",
+    client_name: "Extrato Investidor 6",
+    default_pattern_id: "scp_extrato_6_consolidado",
+    status: "ativo",
+  },
+];

packages/simulation-engine/tests/simulation-engine.test.js

@@ -0,0 +1,274 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import {
+  calcularParidadeRodobens,
+  calcularIndicadoresSecundario,
+  calcularSimulacao,
+  listarPerfisFluxoScpDefault,
+  montarFluxoClienteScp,
+  simularModoConversaoScpConsorcio,
+  simularSecundarioComPerfilScp,
+} from "../src/index.js";
+
+const rodobensParityFixtures = JSON.parse(
+  readFileSync(
+    new URL("../../../tests/fixtures/rodobens_btg5_parity_fixtures_v1.json", import.meta.url),
+    "utf8",
+  ),
+);
+
+const rodobensPontualImovelSanitized = JSON.parse(
+  readFileSync(
+    new URL(
+      "../../../tests/fixtures/rodobens_btg5_pontual_imovel_sanitized_v1.json",
+      import.meta.url,
+    ),
+    "utf8",
+  ),
+);
+
+const baseInput = {
+  credito_desejado: 300000,
+  parametros: {
+    id_plano: "PADRAO",
+    nome_plano: "Plano Padrao Imovel",
+    prazo_meses: 180,
+    taxa_administracao_total: 0.15,
+    fundo_reserva_mensal: 0.0005,
+    seguro_prestamista: 0.035,
+  },
+  tem_lance: false,
+};
+
+function mapFields(entries) {
+  return Object.fromEntries(entries.map((entry) => [entry.field_id, entry.value]));
+}
+
+function buildRodobensParityInputFromScenario(scenario) {
+  const inputs = mapFields(scenario.inputs);
+
+  return {
+    plan: scenario.plan,
+    partner_name: inputs.partner_name,
+    grupo: inputs.grupo,
+    numero_cotas: inputs.numero_cotas,
+    modalidade_lance: inputs.modalidade_lance,
+    tipo_produto: inputs.tipo_produto,
+    produto_base_controle: inputs.produto_base_controle,
+    furo: inputs.furo,
+    credito: inputs.credito,
+    prazo_cliente: inputs.prazo_cliente,
+    taxa_administrativa_total: inputs.taxa_administrativa_total,
+    seguro_prestamista_habilitado: inputs.seguro_prestamista_habilitado,
+    plano: inputs.plano,
+    tipo_lance: inputs.tipo_lance,
+    embutido_percentual: inputs.embutido_percentual,
+    parcelas_lance: inputs.parcelas_lance,
+    mes_previsto_lance: inputs.mes_previsto_lance,
+  };
+}
+
+function assertParityOutputs(actual, expectedEntries) {
+  for (const expected of expectedEntries) {
+    assert.ok(
+      Object.hasOwn(actual, expected.field_id),
+      `campo ausente no resultado de paridade: ${expected.field_id}`,
+    );
+
+    const actualValue = actual[expected.field_id];
+    const expectedValue = expected.value;
+
+    if (typeof expectedValue === "number") {
+      assert.ok(
+        Math.abs(actualValue - expectedValue) < 1e-6,
+        `campo ${expected.field_id}: esperado ${expectedValue}, recebido ${actualValue}`,
+      );
+      continue;
+    }
+
+    assert.equal(
+      actualValue,
+      expectedValue,
+      `campo ${expected.field_id}: esperado ${expectedValue}, recebido ${actualValue}`,
+    );
+  }
+}
+
+test("calcula parcela integral com valores esperados", () => {
+  const result = calcularSimulacao(baseInput);
+
+  assert.equal(result.prazo, 180);
+  assert.equal(result.credito, 300000);
+  assert.ok(result.parcela_integral.total > 0);
+  assert.equal(Number(result.parcela_integral.fundo_comum.toFixed(2)), 1666.67);
+});
+
+test("calcula cenario com lance e reduz prazo", () => {
+  const result = calcularSimulacao({
+    ...baseInput,
+    tem_lance: true,
+    lance_percentual: 0.3,
+  });
+
+  assert.ok(result.valor_lance);
+  assert.equal(result.valor_lance, 90000);
+  assert.ok(result.prazo_apos_lance);
+  assert.ok(result.prazo_apos_lance < result.prazo);
+});
+
+test("falha quando prazo_meses for invalido", () => {
+  assert.throws(() => {
+    calcularSimulacao({
+      ...baseInput,
+      parametros: {
+        ...baseInput.parametros,
+        prazo_meses: 0,
+      },
+    });
+  }, /prazo_meses/);
+});
+
+test("calcula payback do secundario com offset apos ultima contemplacao", () => {
+  const fluxos = [];
+  for (let i = 0; i < 10; i += 1) {
+    fluxos.push(-100);
+  }
+  for (let i = 0; i < 50; i += 1) {
+    fluxos.push(20);
+  }
+
+  const result = calcularIndicadoresSecundario({
+    fluxos_mensais: fluxos,
+    meses_pos_ultima_contemplacao: 3,
+  });
+
+  assert.equal(result.caixa_maximo_negativo, -1000);
+  assert.equal(result.payback_meses, 63);
+  assert.equal(result.regras_aplicadas.fee_sobre_volume_reduzido_70, true);
+});
+
+test("deduz portabilidade e fee com parcela reduzida em 70% do volume", () => {
+  const result = calcularIndicadoresSecundario({
+    fluxos_mensais: [-1000, 500, 700],
+    transacoes_portabilidade: [
+      { valor: 100000, contemplada: true },
+      { valor: 100000, contemplada: false },
+    ],
+    volume_contratado: 300000,
+    fee_percentual: 0.02,
+    percentual_cartas_parcela_reduzida: 1,
+  });
+
+  assert.equal(result.custo_portabilidade, 1500);
+  assert.equal(result.custo_fee_parcela_reduzida, 4200);
+  assert.equal(result.custo_total_deducoes, 5700);
+  assert.equal(result.fluxo_ajustado[0], -6700);
+});
+
+test("valida entradas invalidas no secundario", () => {
+  assert.throws(() => {
+    calcularIndicadoresSecundario({
+      fluxos_mensais: [-100, 100],
+      percentual_cartas_parcela_reduzida: 1.2,
+    });
+  }, /percentual_cartas_parcela_reduzida/);
+});
+
+test("calcula tir mensal e anual no secundario", () => {
+  const result = calcularIndicadoresSecundario({
+    fluxos_mensais: [-1000, 1100],
+  });
+
+  assert.ok(result.tir_mensal !== null);
+  assert.ok(result.tir_anual !== null);
+  assert.ok(Math.abs(result.tir_mensal - 0.1) < 1e-6);
+});
+
+test("lista perfis SCP default com clientes entregues", () => {
+  const catalogo = listarPerfisFluxoScpDefault();
+  assert.ok(catalogo.clients.length >= 6);
+  assert.ok(catalogo.patterns.length >= 2);
+  assert.ok(catalogo.clients.find((c) => c.client_id === "extrato_investidor_6"));
+});
+
+test("monta fluxo SCP parametrizado por escala e deslocamento", () => {
+  const fluxo = montarFluxoClienteScp({
+    client_id: "extrato_investidor_6",
+    escala_fluxo: 0.5,
+    deslocamento_meses: 2,
+    novo_client_id: "cliente_novo",
+    novo_client_name: "Cliente Novo",
+  });
+
+  assert.equal(fluxo.client_id, "cliente_novo");
+  assert.equal(fluxo.client_name, "Cliente Novo");
+  assert.equal(fluxo.source_client_id, "extrato_investidor_6");
+  assert.ok(fluxo.pontos.length > 10);
+  assert.equal(fluxo.pontos[0].periodo, "2021-04-01");
+});
+
+test("simula secundario com perfil SCP default", () => {
+  const result = simularSecundarioComPerfilScp({
+    client_id: "extrato_investidor_6",
+    fee_percentual: 0.02,
+    volume_contratado: 100000,
+    percentual_cartas_parcela_reduzida: 0.5,
+  });
+
+  assert.equal(result.fluxo_cliente.client_id, "extrato_investidor_6");
+  assert.ok(result.fluxo_ajustado.length > 10);
+  assert.ok(typeof result.caixa_maximo_negativo === "number");
+});
+
+test("simula modo conversao fechado SCP -> imovel + secundario", () => {
+  const result = simularModoConversaoScpConsorcio({
+    client_id: "extrato_investidor_6",
+    valor_imovel_base: 600000,
+    desconto_imovel_percentual: 0.15,
+    percentual_entrada_imovel: 0.25,
+    agio_consorcio_percentual: 0.1,
+    taxa_custos_transacao_percentual: 0.02,
+    fee_percentual: 0.02,
+    volume_contratado: 120000,
+    percentual_cartas_parcela_reduzida: 0.5,
+  });
+
+  assert.ok(result.modo_conversao);
+  assert.equal(result.modo_conversao.valor_imovel_com_desconto, 510000);
+  assert.equal(result.modo_conversao.valor_entrada_imovel, 127500);
+  assert.ok(typeof result.modo_conversao.lucro_projetado_conversao === "number");
+});
+
+test("carrega fixtures de paridade Rodobens no pacote do motor", () => {
+  assert.equal(rodobensParityFixtures.fixture_version, "1.0");
+  assert.equal(rodobensParityFixtures.generated_from, "SIMULADOR RODOBENS - BTG 5.xlsm");
+  assert.equal(rodobensParityFixtures.scenarios.length, 3);
+
+  const plans = rodobensParityFixtures.scenarios.map((scenario) => scenario.plan).sort();
+  assert.deepEqual(plans, ["degrau", "linear", "pontual"]);
+});
+
+test("compara outputs Rodobens contra o oracle do workbook por campo", () => {
+  for (const scenario of rodobensParityFixtures.scenarios) {
+    const result = calcularParidadeRodobens(buildRodobensParityInputFromScenario(scenario));
+    assertParityOutputs(result, scenario.expected_outputs);
+  }
+});
+
+test("expõe warnings e saneamento do Pontual para a suite de paridade", () => {
+  const pontualScenario = rodobensParityFixtures.scenarios.find(
+    (scenario) => scenario.plan === "pontual",
+  );
+
+  assert.ok(pontualScenario);
+  assert.ok(
+    pontualScenario.warnings.some((warning) =>
+      /Automóvel|Automovel|Imóvel|Imovel/.test(warning),
+    ),
+  );
+
+  assert.equal(rodobensPontualImovelSanitized.plan, "pontual_imovel_sanitized");
+  assert.ok(rodobensPontualImovelSanitized.sanitized_fields.length >= 5);
+  assert.ok(rodobensPontualImovelSanitized.legacy_excluded.length >= 3);
+});