ClienteController.gs

/**
 * ClienteController.gs
 * Controlador para operações com clientes (CRM básico)
 */

function criarCliente(dados) {
  if (!dados.nome || dados.nome.trim().length === 0) {
    return { sucesso: false, mensagem: 'Nome é obrigatório' };
  }
  
  if (dados.email && !validarEmail(dados.email)) {
    return { sucesso: false, mensagem: 'Email inválido' };
  }
  
  try {
    const clienteId = gerarIdUnico();
    
    const novoCliente = {
      id: clienteId,
      nome: dados.nome,
      email: dados.email || '',
      telefone: dados.telefone || '',
      tipo: dados.tipo || 'varejo',
      endereco: dados.endereco || '',
      data_cadastro: formatarDataBR(new Date())
    };
    
    inserirObjeto(SHEET_NAMES.CLIENTES, novoCliente);
    
    registrarAuditoria(dados.usuario_id, 'CRIAR_CLIENTE', `Cliente ${dados.nome} criado`);
    
    return { sucesso: true, mensagem: 'Cliente criado com sucesso', clienteId: clienteId };
  } catch (erro) {
    tratarErro(erro, 'criarCliente');
    return { sucesso: false, mensagem: 'Erro ao criar cliente' };
  }
}

function listarClientes(filtros = {}) {
  const clientes = obterTodosOsDadosComoObjetos(SHEET_NAMES.CLIENTES);
  
  let resultado = clientes;
  
  if (filtros.tipo) {
    resultado = resultado.filter(c => c.tipo === filtros.tipo);
  }
  
  if (filtros.nome) {
    resultado = resultado.filter(c => c.nome.toLowerCase().includes(filtros.nome.toLowerCase()));
  }
  
  return resultado;
}

function obterCliente(clienteId) {
  return buscarUmPorColuna(SHEET_NAMES.CLIENTES, 'id', clienteId);
}

function atualizarCliente(clienteId, dados) {
  try {
    const cliente = obterCliente(clienteId);
    if (!cliente) {
      return { sucesso: false, mensagem: 'Cliente não encontrado' };
    }
    
    if (dados.email && !validarEmail(dados.email)) {
      return { sucesso: false, mensagem: 'Email inválido' };
    }
    
    atualizarPorCriterios(SHEET_NAMES.CLIENTES, { id: clienteId }, dados);
    
    return { sucesso: true, mensagem: 'Cliente atualizado com sucesso' };
  } catch (erro) {
    tratarErro(erro, 'atualizarCliente');
    return { sucesso: false, mensagem: 'Erro ao atualizar cliente' };
  }
}

function deletarCliente(clienteId) {
  try {
    const cliente = obterCliente(clienteId);
    if (!cliente) {
      return { sucesso: false, mensagem: 'Cliente não encontrado' };
    }
    
    deletarPorCriterios(SHEET_NAMES.CLIENTES, { id: clienteId });
    
    return { sucesso: true, mensagem: 'Cliente deletado com sucesso' };
  } catch (erro) {
    tratarErro(erro, 'deletarCliente');
    return { sucesso: false, mensagem: 'Erro ao deletar cliente' };
  }
}

/**
 * Obtém histórico de vendas de um cliente
 * @param {string} clienteId - ID do cliente
 * @returns {Array} Array de vendas
 */
function obterHistoricoVendas(clienteId) {
  return listarVendas({ cliente_id: clienteId });
}

/**
 * Calcula valor total gasto por um cliente
 * @param {string} clienteId - ID do cliente
 * @returns {number} Valor total
 */
function calcularValorTotalCliente(clienteId) {
  const vendas = obterHistoricoVendas(clienteId);
  return vendas.reduce((acc, v) => acc + parseFloat(v.total), 0);
}

/**
 * Calcula número de compras de um cliente
 * @param {string} clienteId - ID do cliente
 * @returns {number} Número de compras
 */
function calcularNumeroComprasCliente(clienteId) {
  return obterHistoricoVendas(clienteId).length;
}

/**
 * Identifica clientes VIP (maior valor gasto)
 * @param {number} limite - Número de clientes a retornar
 * @returns {Array} Array com clientes VIP
 */
function identificarClientesVIP(limite = 10) {
  const clientes = obterTodosOsDadosComoObjetos(SHEET_NAMES.CLIENTES);
  
  const clientesComValor = clientes.map(c => ({
    ...c,
    valor_total: calcularValorTotalCliente(c.id),
    numero_compras: calcularNumeroComprasCliente(c.id)
  }));
  
  return clientesComValor
    .sort((a, b) => b.valor_total - a.valor_total)
    .slice(0, limite);
}

/**
 * Calcula valor médio de compra por cliente
 * @returns {number} Valor médio
 */
function calcularValorMedioCliente() {
  const clientes = obterTodosOsDadosComoObjetos(SHEET_NAMES.CLIENTES);
  
  if (clientes.length === 0) return 0;
  
  let valorTotal = 0;
  clientes.forEach(c => {
    valorTotal += calcularValorTotalCliente(c.id);
  });
  
  return valorTotal / clientes.length;
}

/**
 * Segmenta clientes por tipo
 * @returns {Object} { tipo: quantidade }
 */
function segmentarClientesPorTipo() {
  const clientes = obterTodosOsDadosComoObjetos(SHEET_NAMES.CLIENTES);
  const resultado = {};
  
  clientes.forEach(c => {
    if (!resultado[c.tipo]) {
      resultado[c.tipo] = 0;
    }
    resultado[c.tipo]++;
  });
  
  return resultado;
}

/**
 * Identifica clientes inativos (sem compras há X dias)
 * @param {number} diasSemCompra - Dias sem compra
 * @returns {Array} Array com clientes inativos
 */
function identificarClientesInativos(diasSemCompra = 90) {
  const clientes = obterTodosOsDadosComoObjetos(SHEET_NAMES.CLIENTES);
  const inativos = [];
  
  clientes.forEach(c => {
    const vendas = obterHistoricoVendas(c.id);
    
    if (vendas.length === 0) {
      inativos.push(c);
    } else {
      const ultimaVenda = vendas[vendas.length - 1];
      const diasDesdeUltimaVenda = calcularDiasEntreDatas(
        parsearDataBR(ultimaVenda.data_venda),
        new Date()
      );
      
      if (diasDesdeUltimaVenda > diasSemCompra) {
        inativos.push({
          ...c,
          dias_sem_compra: diasDesdeUltimaVenda
        });
      }
    }
  });
  
  return inativos;
}