/**
 * GET /api/v1/metrics/metas — a meta do mês e o progresso contra ela
 * (issue #3025, fatia 1).
 *
 * ─── A pergunta que a tela não sabia responder ──────────────────────────────
 * O Desempenho mostrava só o realizado. "Estamos em quantos por cento da meta?"
 * não tinha resposta porque não havia DENOMINADOR: o alvo vivia na cabeça de
 * quem cobra o time. Esta rota lê o alvo cadastrado (`crm_metas`, migration
 * 0756) e conta o realizado na MESMA janela — nunca em janelas diferentes, que
 * fechariam a conta errado na virada do mês.
 *
 * ─── O realizado é "negócio GANHO fechado dentro da janela" ─────────────────
 * `status = 'won'` e `closed_at` em `[from, to)` — o par que a tela chama de
 * venda. Não é `created_at` (o negócio pode ter nascido em julho e fechado em
 * setembro; a venda é de setembro) e não é `value_cents` (somar VALOR é a fatia
 * 2, declarada fora). A leitura é com o client de sessão, então a RLS escopa a
 * organização por si.
 *
 * ─── Contagem por `count` exato, não por linhas ─────────────────────────────
 * `.select("id", { count: "exact", head: true })`: o PostgREST conta no banco e
 * devolve só o número. Trazer as linhas para contar daria 1000 no teto do
 * `max_rows` (`supabase/config.toml`) e um mês com 1.200 vendas apareceria como
 * 1.000 — o truncamento silencioso que a rota de funil documenta em `lerPaginado`.
 *
 * ─── Sem meta NÃO é zero ────────────────────────────────────────────────────
 * Sem linha em `crm_metas`, a resposta sai com `metas: []`, `motivo:
 * "sem_meta"` e uma `explicacao`. Zero significaria "realizou nada", que é uma
 * afirmação FALSA — a empresa pode ter vendido 30 e simplesmente não ter alvo.
 * A explicação sai no idioma de quem pediu (o `t` de sempre), porque quem a
 * escreveu foi o servidor.
 *
 * ─── As duas parcelas do período (fatia 2, item 1, da #3602) ────────────────
 * A meta continua contando VENDAS GANHAS, e valor não entra no percentual. Ao
 * lado dela a rota passa a devolver `valores_do_periodo`: "vendido único"
 * (`value_cents`) e "recorrência nova mensal" (`recurring_value_cents` dos
 * ganhos com `recurring_period = 'monthly'`), SEPARADOS, mais a contagem de
 * negócios com recorrência. Nada é somado entre as duas parcelas — a régua é
 * `lib/metrics/valores-do-periodo.ts`, a mesma que o funil usa. Aditivo e
 * retrocompatível: quem não preenche recorrência recebe zero nos dois números e
 * o resto da resposta é o de antes. Sai mesmo sem meta cadastrada: "não há
 * alvo" não é motivo para esconder quanto entrou no mês.
 *
 * A org vem do cookie validado (`requireRole`), NUNCA do query. Read-only ⇒ sem
 * audit.
 */
import { randomUUID } from "node:crypto";
import { type NextRequest } from "next/server";
import { z } from "zod";

import { fail, ok } from "@/lib/api/wrappers";
import { requireRole } from "@/lib/auth/require-role";
import { traduzir } from "@/lib/i18n/dicionario";
import { type NegocioComValor, separarValoresDoPeriodo } from "@/lib/metrics/valores-do-periodo";
import { lerPaginado } from "@/lib/supabase/pagina";
import { createClient } from "@/lib/supabase/server";

export const dynamic = "force-dynamic";

/** O único indicador desta fatia: quantidade de vendas ganhas. */
const INDICADOR_DA_FATIA = "vendas_ganhas";

const querySchema = z.object({
  from: z.string().datetime({ offset: true }).optional(),
  to: z.string().datetime({ offset: true }).optional(),
});

interface MetaCrua {
  id: string;
  periodo: string;
  indicador: string;
  pipeline_id: string | null;
  alvo: number | string;
}

interface LinhaCrua {
  id: string;
  name: string;
}

/**
 * O 1º dia do mês da janela pedida, como `YYYY-MM-01`.
 *
 * Sai do TEXTO da ISO, não do instante convertido para UTC: a string carrega o
 * fuso de quem pediu (`2026-09-01T00:00:00-03:00`), e é o mês DELE que a meta
 * precisa casar. Converter para UTC faria quem está em UTC+13 pedir setembro e
 * receber a meta de agosto.
 */
function primeiroDiaDoMes(iso: string): string {
  return `${iso.slice(0, 7)}-01`;
}

export async function GET(req: NextRequest): Promise<Response> {
  const requestId = randomUUID();

  // Piso agent: o atendente vê a meta da empresa — é o número que a tela dele
  // mostra. A escrita é que exige manager (policy da tabela + Server Action).
  const authz = await requireRole("agent", { requestId, resource: "metrics" });
  if (!authz.ok) return authz.response;
  const t = (texto: string) => traduzir(texto, authz.user.idioma);
  const { org: activeOrg } = authz;

  const url = new URL(req.url);
  const parsed = querySchema.safeParse({
    from: url.searchParams.get("from") ?? undefined,
    to: url.searchParams.get("to") ?? undefined,
  });
  if (!parsed.success) {
    return fail("validation_failed", t("Query inválida."), 422, {
      details: parsed.error.flatten().fieldErrors as Record<string, unknown>,
      requestId,
    });
  }

  const to = parsed.data.to ? new Date(parsed.data.to) : new Date();
  const from = parsed.data.from
    ? new Date(parsed.data.from)
    : new Date(Date.UTC(to.getUTCFullYear(), to.getUTCMonth(), 1));
  if (from.getTime() >= to.getTime()) {
    return fail("validation_failed", t("Janela inválida: 'from' deve ser anterior a 'to'."), 422, {
      requestId,
    });
  }
  const de = from.toISOString();
  const ate = to.toISOString();
  // O mês vem do TEXTO da janela quando ela foi pedida (a string carrega o fuso
  // de quem pediu); sem `from`, cai no mês corrente do servidor.
  const periodo = parsed.data.from
    ? primeiroDiaDoMes(parsed.data.from)
    : `${de.slice(0, 7)}-01`;

  const supabase = await createClient();
  const orgId = activeOrg.orgId;

  // As metas do MÊS (o da janela) na organização ativa. `pipeline_id is null` é
  // a meta da empresa e vem primeiro; metas por funil (fatia seguinte) também
  // são lidas se existirem — mostrar o que está gravado é mais honesto do que
  // esconder por causa do recorte da fatia.
  const { data: metasCruas, error: erroMetas } = await supabase
    .from("crm_metas")
    .select("id, periodo, indicador, pipeline_id, alvo")
    .eq("organization_id", orgId)
    .eq("periodo", periodo)
    .eq("indicador", INDICADOR_DA_FATIA);
  if (erroMetas) {
    return fail("internal_error", `crm_metas: ${erroMetas.message}`, 500, { requestId });
  }
  const metas = (metasCruas ?? []) as MetaCrua[];

  const funisComMeta = metas.map((m) => m.pipeline_id).filter((p): p is string => Boolean(p));
  let nomesDeFunil = new Map<string, string>();
  if (funisComMeta.length > 0) {
    const { data: funis, error } = await supabase
      .from("crm_pipelines")
      .select("id, name")
      .eq("organization_id", orgId);
    if (error) return fail("internal_error", `crm_pipelines: ${error.message}`, 500, { requestId });
    nomesDeFunil = new Map(((funis ?? []) as LinhaCrua[]).map((f) => [f.id, f.name]));
  }

  const saida: Array<Record<string, unknown>> = [];
  for (const meta of metas) {
    const alvo = Number(meta.alvo);
    // Linha impossível pelo schema (`crm_metas_alvo_positivo`, `alvo > 0`):
    // se chegar aqui, NÃO se inventa percentual nem se mostra 0% — a resposta
    // é uma falha de dados, não uma medida.
    if (!Number.isInteger(alvo) || alvo <= 0) {
      return fail(
        "internal_error",
        `crm_metas: alvo inválido (${String(meta.alvo)}) na meta ${meta.id}`,
        500,
        { requestId },
      );
    }

    let consulta = supabase
      .from("crm_leads")
      .select("id", { count: "exact", head: true })
      .eq("organization_id", orgId)
      .eq("status", "won")
      .gte("closed_at", de)
      .lt("closed_at", ate);
    if (meta.pipeline_id) consulta = consulta.eq("pipeline_id", meta.pipeline_id);

    const { count, error } = await consulta;
    if (error) return fail("internal_error", `crm_leads: ${error.message}`, 500, { requestId });
    const realizado = count ?? 0;

    saida.push({
      id: meta.id,
      escopo: meta.pipeline_id ? "funil" : "empresa",
      pipeline_id: meta.pipeline_id,
      pipeline_nome: meta.pipeline_id ? (nomesDeFunil.get(meta.pipeline_id) ?? null) : null,
      alvo,
      realizado,
      percentual: Math.round((realizado / alvo) * 100),
      // "Quanto falta" nunca é negativo: passar da meta não vira dívida.
      falta: Math.max(0, alvo - realizado),
      atingida: realizado >= alvo,
    });
  }

  // ─── Os ganhos da janela, em LINHAS, para as duas parcelas (#3602) ────────
  //
  // Depois do laço de propósito: a PRIMEIRA leitura de `crm_leads` desta rota
  // continua sendo a contagem `head: true` do realizado, que não traz linha
  // nenhuma e por isso não serve para somar valor. Esta leitura é própria, e é
  // PAGINADA: sem `.range()` o PostgREST corta a resposta em `max_rows` (1000)
  // sem erro nenhum, e um mês com 1.200 vendas apareceria como se fossem 1.000.
  // `truncado` viaja na resposta para ninguém ler um piso como se fosse o total.
  const leituraDeValores = await lerPaginado<NegocioComValor>((inicio, fim, contar) =>
    supabase
      .from("crm_leads")
      .select(
        "status, closed_at, currency, value_cents, recurring_value_cents, recurring_period",
        contar ? { count: "exact" } : undefined,
      )
      .eq("organization_id", orgId)
      .eq("status", "won")
      .gte("closed_at", de)
      .lt("closed_at", ate)
      .order("closed_at", { ascending: false })
      .order("id", { ascending: false })
      .range(inicio, fim),
  );
  if (leituraDeValores.erro) {
    return fail("internal_error", `crm_leads: valores do período: ${leituraDeValores.erro}`, 500, {
      requestId,
    });
  }
  const valoresDoPeriodo = separarValoresDoPeriodo({
    negocios: leituraDeValores.linhas,
    janela: { from: de, to: ate },
    moedaDaOrganizacao: activeOrg.currency ?? null,
    truncado: leituraDeValores.truncado,
  });

  const semMeta = saida.length === 0;

  return ok(
    {
      window: { from: de, to: ate },
      periodo,
      indicador: INDICADOR_DA_FATIA,
      metas: saida,
      // Duas parcelas SEPARADAS (nunca um total): o painel mostra as duas lado
      // a lado, e a org sem recorrência recebe zero nos dois sem nada mudar.
      valores_do_periodo: valoresDoPeriodo,
      motivo: semMeta ? "sem_meta" : null,
      explicacao: semMeta
        ? t(
            "A empresa ainda não definiu a meta deste mês. Quem administra pode cadastrá-la em Configurações › Meta de vendas — a partir daí esta tela mostra o quanto já foi feito e o quanto falta.",
          )
        : null,
    },
    { requestId },
  );
}