"use client";
import Link from "next/link";
import { Card } from "@/components/ui/card";
import { CheckCircle, Warning } from "@/lib/ui/icons";
import type { LeadStage } from "@/lib/agent-engine/agent/lead-state";
import type { EvolutionPayload } from "@/lib/ai/evolution/aggregate";
import { ROTULO_DO_PASSO } from "@/lib/leads/agent-mapping";
/**
* Cada lacuna vira UMA frase que diz o problema e o conserto — número sem ação é
* o "dado que não muda decisão" que a doutrina do sistema vivo proíbe.
*
* Duas honestidades que o texto tem que carregar, porque o dado tem:
* 1. "não encontrou nada" CONTÉM "quase encontrou" — o agregador conta o quase-
* acerto dentro do mesmo laço das buscas sem resultado. Somar os dois como se
* fossem problemas separados infla a lacuna; por isso o segundo item começa
* com "Destas".
* 2. lista vazia NÃO é boa notícia por si. Cada frase de elogio é uma afirmação
* sobre uma fonte diferente e só sai com a evidência daquela fonte — ver o
* docblock de `boaNoticia`, que é onde a regra vive.
*/
/**
* Os passos do atendimento em português de dono de negócio.
*
* ⚠️ VÊM DE `ROTULO_DO_PASSO`, e este arquivo NÃO tem a sua própria tradução.
* A tela que conserta a lacuna (Funis) lista os passos por esses mesmos nomes; se
* cada lado traduzisse o enum à sua maneira, o dono da clínica leria "entendendo
* o que ele precisa" aqui, clicaria no botão e procuraria essa linha numa tela
* que a chama "Em qualificação". Um nome por coisa é o que faz o botão levar a
* algum lugar reconhecível.
*/
function nomeiaPassos(steps: string[]): string {
return steps.map((s) => ROTULO_DO_PASSO[s as LeadStage] ?? s).join(", ");
}
function plural(n: number, um: string, muitos: string): string {
return n === 1 ? um : muitos;
}
interface Lacuna {
chave: string;
texto: string;
href?: string;
cta?: string;
}
/**
* ⚠️ A PROMESSA "VOCÊ MESMO ESCOLHE" NÃO VALE PARA GANHO E PERDA.
*
* A tela de destino só oferece etapa de fechamento para «Ganho» e de perda para
* «Perdido» (é o CHECK da 0084), e `is_won`/`is_lost` não são escritos por tela
* nenhuma do produto. Num funil sem essas etapas, o usuário clica num botão que
* promete que ele resolve e recebe "quem montou o funil precisa marcar". A
* ressalva sai apenas quando um desses dois passos está na lacuna — anexá-la
* sempre seria ruído no caso comum.
*/
function ressalvaDeFechamento(steps: string[]): string {
const fechamento = steps.filter((s) => s === "won" || s === "lost");
if (fechamento.length === 0) return "";
const nomes = fechamento.map((s) => `«${ROTULO_DO_PASSO[s as LeadStage]}»`).join(" e ");
return (
` ${nomes} ${plural(fechamento.length, "é exceção", "são exceção")}: ${plural(fechamento.length, "ele só pode apontar", "eles só podem apontar")} ` +
`para a etapa de fechamento ou de perda do funil. Se o seu funil não tem essas etapas, isso é com quem instalou o sistema.`
);
}
export function montaLacunas(gaps: EvolutionPayload["gaps"]): Lacuna[] {
const out: Lacuna[] = [];
for (const p of gaps.unmapped_agent_steps) {
out.push({
chave: `unmapped-${p.pipeline_name}`,
// ⚠️ Este item NÃO afirma defeito, e isso é deliberado. A migration 0084 diz
// com todas as letras que um passo sem etapa é estado LEGÍTIMO ("Em separação"
// e "Pós-venda" não correspondem a passo nenhum do agente, e forçar mapeamento
// seria inventar semântica que o tenant não declarou). Escrever "conserte isto"
// mandaria o dono da clínica arrumar um funil que já está certo. O texto conta
// a CONSEQUÊNCIA e devolve a decisão para quem conhece o próprio negócio.
texto:
`No funil "${p.pipeline_name}", ${p.steps.length} ${plural(p.steps.length, "passo do atendimento não tem", "passos do atendimento não têm")} ` +
// "card" e não "cartão": é o nome que a tela do conserto usa na opção
// «Não mover o card». Um objeto, um nome — senão o usuário lê sobre
// "cartão" aqui e procura essa palavra lá.
`etapa correspondente: ${nomeiaPassos(p.steps)}. Quando o agente chega em um desses passos, o card do cliente ` +
`não se move — ele fica onde está. Às vezes isso é proposital: nem todo funil precisa de uma etapa para cada passo. ` +
`Mas se você esperava ver esses clientes andarem sozinhos no quadro, é aqui que falta o vínculo — e você mesmo ` +
`escolhe, passo a passo, para qual etapa o card vai.` +
ressalvaDeFechamento(p.steps),
// ⚠️ ESTE LINK É O QUE FECHA O CICLO. Antes ele apontava para o quadro com o
// verbo "Ver", porque não existia lugar nenhum no produto para escrever
// `agent_stage_hint` — o painel relatava uma lacuna e parava aí. Agora leva
// à tela que a conserta, e o verbo diz o que se faz lá.
href: "/app/settings/tenant/pipelines",
cta: "Escolher a etapa de cada passo",
});
}
if (gaps.knowledge_empty > 0) {
out.push({
chave: "knowledge-empty",
texto:
`${gaps.knowledge_empty} ${plural(gaps.knowledge_empty, "pergunta de cliente não encontrou", "perguntas de clientes não encontraram")} ` +
`resposta nos seus materiais. São os assuntos que ainda faltam escrever — cada um deles é uma conversa em que o ` +
`agente teve que improvisar ou passar adiante.`,
href: "/app/ai/knowledge/sources",
cta: "Abrir a base de conhecimento",
});
}
if (gaps.knowledge_near_misses > 0) {
out.push({
chave: "knowledge-near",
texto:
`Destas, ${gaps.knowledge_near_misses} ${plural(gaps.knowledge_near_misses, "chegou perto", "chegaram perto")}: ` +
`havia material parecido, mas não parecido o bastante para o agente arriscar usar. Aqui o conteúdo provavelmente ` +
`já existe — só está escrito com palavras diferentes das que o cliente usa. Vale reescrever esses materiais com as ` +
`perguntas do jeito que chegam.`,
href: "/app/ai/knowledge/sources",
cta: "Abrir a base de conhecimento",
});
}
if (gaps.router_no_match > 0) {
out.push({
chave: "router-no-match",
texto:
`Em ${gaps.router_no_match} ${plural(gaps.router_no_match, "conversa", "conversas")} o agente não soube para qual ` +
`atendimento encaminhar e usou o atendimento padrão. Se isso se repete, falta cadastrar esse assunto no roteador ` +
`do seu número.`,
href: "/app/ai/routers",
cta: "Abrir os roteadores",
});
}
if (gaps.router_failed > 0) {
out.push({
chave: "router-failed",
texto:
`Em ${gaps.router_failed} ${plural(gaps.router_failed, "conversa a leitura falhou", "conversas a leitura falhou")} ` +
`por problema técnico, e ela caiu no atendimento padrão. Isso não é configuração: é a IA que não respondeu na hora. ` +
`Se o número for alto, vale conferir a conexão com o provedor de IA.`,
href: "/app/ai/credentials",
cta: "Conferir a conexão de IA",
});
}
return out;
}
/**
* A boa notícia é feita de TRÊS afirmações independentes, e cada uma precisa da
* sua própria evidência:
* • "toda pergunta encontrou resposta" ← só vale se houve busca na base;
* • "toda conversa achou para onde ir" ← só vale se houve decisão de rota;
* • "todo passo tem etapa que o recebe" ← só vale se EXISTE funil. A lacuna
* deriva das linhas de `crm_stages`: zero funis ⇒ zero lacunas, e o elogio
* seria sobre funis que não existem. E como o instalador não provisiona
* funil nenhum, esse é justamente o estado de instalação fresca.
*
* Um guarda único autorizaria as três com a evidência de uma: um tenant com
* roteador configurado e base VAZIA tem decisões > 0 e a tela afirmaria "toda
* pergunta encontrou resposta nos seus materiais" tendo havido ZERO perguntas.
* O guarda tem que ter o tamanho da afirmação.
*/
export function boaNoticia(buscas: number, decisoes: number, funis: number): string {
const partes: string[] = [];
if (buscas > 0) partes.push("toda pergunta encontrou resposta nos seus materiais");
if (decisoes > 0) partes.push("toda conversa achou para onde ir");
if (funis > 0) partes.push("todo passo do atendimento tem uma etapa do funil que o recebe");
const faltando: string[] = [];
if (buscas === 0) faltando.push("ninguém consultou sua base de conhecimento");
if (decisoes === 0) faltando.push("nenhuma conversa foi encaminhada");
if (funis === 0) faltando.push("você ainda não tem nenhum funil montado");
// Nenhuma evidência: a tela não tem o que elogiar, e dizer "nada travando"
// seco seria elogio. Abre pelo motivo, não pela boa notícia.
if (partes.length === 0) {
return `Ainda não dá para dizer se algo está travando: ${faltando.join(", ")}. Volte aqui depois que seu agente tiver atendido.`;
}
const frase = `Nada travando neste período: ${partes.join(", ")}.`;
if (faltando.length === 0) return frase;
return `${frase} Uma ressalva: ${faltando.join(", ")} — sobre isso não dá para dizer nem que está bem nem que está mal.`;
}
export function EvolutionGaps({
gaps,
buscas,
decisoes,
}: {
gaps: EvolutionPayload["gaps"];
/** Consultas à base no período — evidência da 1ª afirmação de `boaNoticia`. */
buscas: number;
/** Decisões de encaminhamento no período — evidência da 2ª afirmação. */
decisoes: number;
}) {
const lacunas = montaLacunas(gaps);
if (lacunas.length === 0) {
return (