/**
 * O catálogo de módulos instaláveis (ADR-0002, D3).
 *
 * Não há uma segunda lista para divergir da real: `fn_modulo_instalar` só aceita um slug cuja
 * `fn_<slug>_provisionar()` EXISTE no banco (`to_regprocedure`), e é essa checagem que decide
 * de verdade. Este array é só a vitrine — nome e descrição para a tela do administrador da
 * instalação escolher o que instalar. Um módulo aqui sem provisionadora no banco falharia com
 * `extension_module_unknown` ao tentar instalar, nunca silenciosamente.
 */
export interface ModuloCatalogo {
  slug: string;
  nome: string;
  descricao: string;
}

export const CATALOGO_DE_MODULOS: readonly ModuloCatalogo[] = [
  {
    slug: "cadencias",
    nome: "Cadências de e-mail",
    descricao: "Sequências de e-mail por negócio, com envio pela instalação, descadastro e abertura somente com consentimento. Contribuição de Marcelo (@lmarceloc), PR #1738.",
  },
  {
    slug: "honorarios",
    nome: "Honorários (advocacia)",
    descricao:
      "Contrato de honorários (fixo, êxito ou misto) e o calendário de parcelas, ligado ao caixa " +
      "do núcleo. Para escritórios de advocacia que cobram por caso.",
  },
  {
    // #1907 item 4 — sem esta linha `service.ts:84` recusava o slug fora do
    // catálogo (`extension_module_unknown`) e não havia como instalar a
    // comanda em lugar nenhum: as telas e as rotas ficariam mortas para
    // sempre, mesmo com a provisionadora pronta.
    slug: "financeiro",
    // As cinco tabelas da comanda nascem SÓ onde o módulo é instalado (ADR-0002
    // D2/D3). O texto abaixo é o que quem administra lê em `/admin/modulos`.
    nome: "Comandas",
    descricao:
      "A comanda do atendimento: itens, forma de pagamento, comissões e fidelidade. O caixa " +
      "continua no sistema mesmo sem este módulo. Toda instalação anterior a esta versão " +
      "continua com Comandas ligada.",
  },
  {
    slug: "lista_de_espera",
    nome: "Lista de espera da agenda",
    descricao:
      "Quando um horário abre, a vaga é oferecida a uma pessoa por vez, entre quem aceitou ser " +
      "avisado. Cada empresa escolhe os prazos da oferta antes de ligar.",
  },
  {
    // #3611: volta ao catálogo junto com a tela de gestão (#3636) — antes dela,
    // instalar daria uma tabela que ninguém conseguia abrir.
    slug: "ouvidoria",
    nome: "Ouvidoria",
    descricao:
      "Registro de manifestações (reclamações, denúncias, elogios, sugestões) com protocolo " +
      "próprio, leitura restrita a administradores e sem cartão no funil. Quem não instala " +
      "o módulo não carrega a tabela.",
  },
];

export function moduloDoCatalogo(slug: string): ModuloCatalogo | undefined {
  return CATALOGO_DE_MODULOS.find((m) => m.slug === slug);
}