pp/73_RotasMVP.gs at main · te-df/pp

656 lines (567 loc) · 19.9 KB
 * @file 73_RotasMVP.gs
 * @description Sistema MVP de Otimização de Rotas com Google Maps API
 * @version 1.0.0
 * @author Sis
8000
tema TE-DF-PP
 * @since 2024-12-25
 * FUNCIONALIDADES:
 * - Otimização de rotas usando Google Directions API
 * - Análise de eficiência de rotas
 * - Detecção de sobreposições
 * - Sugestões de melhorias
 * - Integração com relatórios IA
// ============================================================================
// ROTASMVP - NAMESPACE PRINCIPAL
// ============================================================================
var RotasMVP = (function() {
  'use strict';
   * Obtém API Key do Google Maps
   * @private
  function _getApiKey() {
      var props = PropertiesService.getScriptProperties();
      return props.getProperty('GOOGLE_MAPS_API_KEY') || null;
    } catch(e) {
      Logger.log('[RotasMVP] Erro ao obter API Key: ' + e.message);
      return null;
   * Verifica se API está configurada
   * @return {Object} { disponivel, mensagem }
  function verificarAPI() {
    var apiKey = _getApiKey();
    return {
      disponivel: !!apiKey,
      mensagem: apiKey ? 'API Google Maps configurada' : 'API Key não configurada. Configure GOOGLE_MAPS_API_KEY nas propriedades do script.'
  // ============================================================================
  // FUNÇÕES DE OTIMIZAÇÃO
  // ============================================================================
   * Otimiza uma rota específica
   * @param {string} idRota - ID da rota
   * @return {Object} Resultado da otimização
  function otimizarRota(idRota) {
      Logger.log('[RotasMVP] Otimizando rota: ' + idRota);
      // Verifica API
      var apiStatus = verificarAPI();
      if (!apiStatus.disponivel) {
        return { success: false, error: apiStatus.mensagem };
      // Usa GeocodingService se disponível
      if (typeof otimizarOrdemEmbarque === 'function') {
        return otimizarOrdemEmbarque(idRota);
      // Fallback: busca dados e calcula manualmente
      var rota = _buscarRota(idRota);
      if (!rota) {
        return { success: false, error: 'Rota não encontrada: ' + idRota };
      var alunos = _buscarAlunosDaRota(idRota);
      if (!alunos || alunos.length === 0) {
        return { success: false, error: 'Nenhum aluno encontrado na rota' };
      // Calcula rota otimizada
      var resultado = _calcularRotaOtimizada(rota, alunos);
      return resultado;
    } catch(e) {
      Logger.log('[RotasMVP] Erro em otimizarRota: ' + e.message);
      return { success: false, error: e.message };
   * Otimiza todas as rotas ativas
   * @return {Object} Resumo da otimização
  function otimizarTodasRotas() {
      Logger.log('[RotasMVP] Iniciando otimização de todas as rotas...');
      var apiStatus = verificarAPI();
      if (!apiStatus.disponivel) {
        return { success: false, error: apiStatus.mensagem };
      // Usa função existente se disponível
      if (typeof recalcularTodasRotas === 'function') {
        return recalcularTodasRotas();
      var rotas = _buscarRotasAtivas();
      var resultados = {
        success: true,
        total: rotas.length,
        otimizadas: 0,
        erros: [],
        economiaTotal: { km: 0, minutos: 0 }
      rotas.forEach(function(rota) {
        var resultado = otimizarRota(rota.ID);
        if (resultado.success) {
          resultados.otimizadas++;
          if (resultado.economia) {
            resultados.economiaTotal.km += resultado.economia.km || 0;
            resultados.economiaTotal.minutos += resultado.economia.minutos || 0;
        } else {
          resultados.erros.push({ rota: rota.ID, erro: resultado.error });
      Logger.log('[RotasMVP] Otimização concluída: ' + resultados.otimizadas + '/' + resultados.total);
      retu
8000
rn resultados;
    } catch(e) {
      Logger.log('[RotasMVP] Erro em otimizarTodasRotas: ' + e.message);
      return { success: false, error: e.message };
  // ============================================================================
  // ANÁLISE DE ROTAS
  // ============================================================================
   * Analisa eficiência de uma rota
   * @param {string} idRota - ID da rota
   * @return {Object} Análise detalhada
  function analisarRota(idRota) {
      var rota = _buscarRota(idRota);
      if (!rota) {
        return { success: false, error: 'Rota não encontrada' };
      var alunos = _buscarAlunosDaRota(idRota);
      var frequencias = _buscarFrequenciasRota(idRota, 30); // Últimos 30 dias
      // Calcula métricas
      var analise = {
        success: true,
        rota: {
          id: rota.ID,
          nome: rota.Nome_Rota || rota.Nome || rota.ID,
          origem: rota.Origem,
          destino: rota.Destino,
          distanciaKm: parseFloat(rota.Distancia_Km) || 0,
          duracaoMin: parseInt(rota.Duracao_Estimada_Min) || 0
        alunos: {
          total: alunos.length,
          ativos: alunos.filter(function(a) { return a.Status_Ativo === 'Ativo'; }).length,
          comCoordenadas: alunos.filter(function(a) { return a.Ponto_Embarque_Lat; }).length
        frequencia: _calcularMetricasFrequencia(frequencias),
        eficiencia: _calcularEficiencia(rota, alunos, frequencias),
        sugestoes: []
      // Gera sugestões
      analise.sugestoes = _gerarSugestoes(analise);
      return analise;
    } catch(e) {
      Logger.log('[RotasMVP] Erro em analisarRota: ' + e.message);
      return { success: false, error: e.message };
   * Analisa todas as rotas e gera relatório
   * @return {Object} Relatório completo
  function analisarTodasRotas() {
      var rotas = _buscarRotasAtivas();
      var analises = [];
      var resumo = {
        totalRotas: rotas.length,
        totalAlunos: 0,
        distanciaTotalKm: 0,
        duracaoTotalMin: 0,
        eficienciaMedia: 0,
        rotasCriticas: 0,
        rotasOtimas: 0
      rotas.forEach(function(rota) {
        var analise = analisarRota(rota.ID);
        if (analise.success) {
          analises.push(analise);
          resumo.totalAlunos += analise.alunos.total;
          resumo.distanciaTotalKm += analise.rota.distanciaKm;
          resumo.duracaoTotalMin += analise.rota.duracaoMin;
          if (analise.eficiencia.score < 50) resumo.rotasCriticas++;
          if (analise.eficiencia.score >= 80) resumo.rotasOtimas++;
      if (analises.length > 0) {
        var somaEficiencia = analises.reduce(function(sum, a) { return sum + a.eficiencia.score; }, 0);
        resumo.eficienciaMedia = Math.round(somaEficiencia / analises.length);
      return {
        success: true,
        resumo: resumo,
        rotas: analises,
        timestamp: new Date().toISOString()
    } catch(e) {
      Logger.log('[RotasMVP] Erro em analisarTodasRotas: ' + e.message);
      return { success: false, error: e.message };
   * Detecta rotas com sobreposição
   * @return {Object} Rotas sobrepostas
  function detectarSobreposicoes() {
      var rotas = _buscarRotasAtivas();
      var sobreposicoes = [];
      // Compara cada par de rotas
      for (var i = 0; i < rotas.length; i++) {
        for (var j = i + 1; j < rotas.length; j++) {
          var rota1 = rotas[i];
          var rota2 = rotas[j];
          // Verifica se têm mesma origem ou destino
          var mesmaOrigem = _enderecosSimilares(rota1.Origem, rota2.Origem);
          var mesmoDestino = _enderecosSimilares(rota1.Destino, rota2.Destino);
          var mesmoTurno = rota1.Turno === rota2.Turno;
          if ((mesmaOrigem || mesmoDestino) && mesmoTurno) {
            sobreposicoes.push({
              rota1: { id: rota1.ID, nome: rota1.Nome_Rota || rota1.ID },
              rota2: { id: rota2.ID, nome: rota2.Nome_Rota || rota2.ID },
              tipo: mesmaOrigem && mesmoDestino ? 'total' : 'parcial',
              turno: rota1.Turno,
              sugestao: 'Considerar unificação das rotas para otimizar recursos'
      return {
        success: true,
        total: sobreposicoes.length,
        sobreposicoes: sobreposicoes
    } catch(e) {
      Logger.log('[RotasMVP] Erro em detectarSobreposicoes: ' + e.message);
      return { success: false, error: e.message };
  // ============================================================================
  // FUNÇÕES AUXILIARES PRIVADAS
  // ============================================================================
  function _buscarRota(idRota) {
      if (typeof handleCRUD === 'function') {
        var result = handleCRUD('Rotas', 'read', idRota, null);
        if (result.success && result.data) {
          return Array.isArray(result.data) ? result.data[0] : result.data;
      // Fallback direto
      var ss = SpreadsheetApp.getActiveSpreadsheet();
      var sheet = ss.getSheetByName('Rotas');
      if (!sheet) return null;
      var data = sheet.getDataRange().getValues();
      var headers = data[0];
      var idCol = headers.indexOf('ID');
      for (var i = 1; i < data.length; i++) {
        if (data[i][idCol] === idRota) {
          var rota = {};
          headers.forEach(function(h, j) { rota[h] = data[i][j]; });
          return rota;
      return null;
    } catch(e) {
      return null;
  function _buscarRotasAtivas() {
      if (typeof handleCRUD === 'function') {
        var result = handleCRUD('Rotas', 'read', null, { Status: 'Ativa' });
        if (result.success && result.data) {
          return Array.isArray(result.data) ? result.data : [result.data];
      // Fallback
      var ss = SpreadsheetApp.getActiveSpreadsheet();
      var sheet = ss.getSheetByName('Rotas');
      if (!sheet) return [];
      var data = sheet.getDataRange().getValues();
      var headers = data[0];
      var rotas = [];
      for (var i = 1; i < data.length; i++) {
        var rota = {};
        headers.forEach(function(h, j) { rota[h] = data[i][j]; });
        if (rota.Status === 'Ativa' || !rota.Status) {
          rotas.push(rota);
      return rotas;
    } catch(e) {
      return [];
  function _buscarAlunosDaRota(idRota) {
      if (typeof handleCRUD === 'function') {
        var result = handleCRUD('Alunos', 'read', null, { ID_Rota: idRota });
        if (result.success && result.data) {
          return Array.isArray(result.data) ? result.data : [result.data];
      // Fallback
      var ss = SpreadsheetApp.getActiveSpreadsheet();
      var sheet = ss.getSheetByName('Alunos');
      if (!sheet) return [];
      var data = sheet.getDataRange().getValues();
      var headers = data[0];
      var rotaCol = headers.indexOf('ID_Rota');
      var alunos = [];
      for (var i = 1; i < data.length; i++) {
        if (data[i][rotaCol] === idRota) {
          var aluno = {};
          headers.forEach(function(h, j) { aluno[h] = data[i][j]; });
          alunos.push(aluno);
      return alunos;
    } catch(e) {
      return [];
  function _buscarFrequenciasRota(idRota, dias) {
      var dataLimite = new Date();
      dataLimite.setDate(dataLimite.getDate() - dias);
      var ss = SpreadsheetApp.getActiveSpreadsheet();
      var sheet = ss.getSheetByName('Frequencia');
      if (!sheet || sheet.getLastRow() <= 1) return [];
      var data = sheet.getDataRange().getValues();
      var headers = data[0];
      var rotaCol = headers.indexOf('ID_Rota');
      var dataCol = headers.indexOf('Data');
      var statusCol = headers.indexOf('Status_Presenca') !== -1 ? headers.indexOf('Status_Presenca') : headers.indexOf('Status');
      var frequencias = [];
      for (var i = 1; i < data.length; i++) {
        if (data[i][rotaCol] === idRota) {
          var dataFreq = data[i][dataCol];
          if (dataFreq instanceof Date && dataFreq >= dataLimite) {
            frequencias.push({
              data: dataFreq,
              status: data[i][statusCol]
      return frequencias;
    } catch(e) {
      return [];
  function _calcularMetricasFrequencia(frequencias) {
    if (!frequencias || frequencias.length === 0) {
      return { total: 0, presentes: 0, ausentes: 0, taxaPresenca: 0 };
    var presentes = frequencias.filter(function(f) {
      var status = String(f.status).toLowerCase();
      return status === 'p' || status === 'presente' || status === 'presença';
    }).length;
    return {
      total: frequencias.length,
      presentes: presentes,
      ausentes: frequencias.length - presentes,
      taxaPresenca: Math.round((presentes / frequencias.length) * 100)
  function _calcularEficiencia(rota, alunos, frequencias) {
    var score = 100;
    var fatores = [];
    // Fator 1: Ocupação (alunos vs capacidade)
    var capacidade = parseInt(rota.Capacidade) || 40;
    var ocupacao = (alunos.length / capacidade) * 100;
    if (ocupacao < 50) {
      score -= 20;
      fatores.push('Baixa ocupação (' + Math.round(ocupacao) + '%)');
    } else if (ocupacao > 100) {
      score -= 30;
      fatores.push('Superlotação (' + Math.round(ocupacao) + '%)');
    // Fator 2: Taxa de presença
    var metricas = _calcularMetricasFrequencia(frequencias);
    if (metricas.taxaPresenca < 70) {
      score -= 15;
      fatores.push('Baixa frequência (' + metricas.taxaPresenca + '%)');
    // Fator 3: Alunos sem coordenadas
    var semCoordenadas = alunos.filter(function(a) { return !a.Ponto_Embarque_Lat; }).length;
    if (semCoordenadas > 0) {
      var percentSem = (semCoordenadas / alunos.length) * 100;
      if (percentSem > 30) {
        score -= 10;
        fatores.push(semCoordenadas + ' alunos sem coordenadas');
    // Fator 4: Distância por aluno
    var distancia = parseFloat(rota.Distancia_Km) || 0;
    if (distancia > 0 && alunos.length > 0) {
      var kmPorAluno = distancia / alunos.length;
      if (kmPorAluno > 5) {
        score -= 10;
        fatores.push('Alta distância por aluno (' + kmPorAluno.toFixed(1) + ' km)');
    return {
      score: Math.max(0, score),
      nivel: score >= 80 ? 'Ótimo' : score >= 60 ? 'Bom' : score >= 40 ? 'Regular' : 'Crítico',
      fatores: fatores
  function _gerarSugestoes(analise) {
    var sugestoes = [];
    if (analise.eficiencia.score < 60) {
      sugestoes.push({
        tipo: 'otimizacao',
        prioridade: 'alta',
        descricao: 'Rota com eficiência baixa. Recomenda-se otimização urgente.'
    if (analise.alunos.comCoordenadas < analise.alunos.total) {
      var faltando = analise.alunos.total - analise.alunos.comCoordenadas;
      sugestoes.push({
        tipo: 'dados',
        prioridade: 'media',
        descricao: 'Cadastrar coordenadas de embarque para ' + faltando + ' aluno(s).'
    if (analise.frequencia.taxaPresenca < 70) {
      sugestoes.push({
        tipo: 'frequencia',
        prioridade: 'media',
        descricao: 'Taxa de presença baixa (' + analise.frequencia.taxaPresenca + '%). Verificar motivos de ausência.'
    var ocupacao = (analise.alunos.total / 40) * 100;
    if (ocupacao < 50) {
      sugestoes.push({
        tipo: 'capacidade',
        prioridade: 'baixa',
        descricao: 'Rota com baixa ocupação. Considerar unificação com outra rota.'
    return sugestoes;
  function _calcularRotaOtimizada(rota, alunos) {
    var apiKey = _getApiKey();
    if (!apiKey) {
      return { success: false, error: 'API Key não configurada' };
    // Filtra alunos com coordenadas
    var waypoints = alunos
      .filter(function(a) { return a.Ponto_Embarque_Lat && a.Ponto_Embarque_Lng; })
      .map(function(a) {
        return a.Ponto_Embarque_Lat + ',' + a.Ponto_Embarque_Lng;
    if (waypoints.length === 0) {
      return { success: false, error: 'Nenhum aluno com coordenadas' };
    // Monta URL da API
    var origem = rota.Origem_Lat && rota.Origem_Lng ? 
                 rota.Origem_Lat + ',' + rota.Origem_Lng : 
                 encodeURIComponent(rota.Origem || 'Brasília, DF');
    var destino = rota.Destino_Lat && rota.Destino_Lng ?
                  rota.Destino_Lat + ',' + rota.Destino_Lng :
                  encodeURIComponent(rota.Destino || 'Brasília, DF');
    var url = 'https://maps.googleapis.com/maps/api/directions/json?' +
              'origin=' + origem +
              '&destination=' + destino +
              '&waypoints=optimize:true|' + waypoints.join('|') +
              '&key=' + apiKey +
              '&language=pt-BR';
      var response = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
      var json = JSON.parse(response.getContentText());
      if (json.status === 'OK' && json.routes && json.routes.length > 0) {
        var route = json.routes[0];
        var totalDistancia = 0;
        var totalDuracao = 0;
        route.legs.forEach(function(leg) {
          totalDistancia += leg.distance.value;
          totalDuracao += leg.duration.value;
        });
        return {
          success: true,
          distanciaKm: (totalDistancia / 1000).toFixed(2),
          duracaoMin: Math.ceil(totalDuracao / 60),
          ordemOtimizada: route.waypoint_order,
          polyline: route.overview_polyline.points
      return { success: false, error: 'API retornou: ' + json.status };
    } catch(e) {
      return { success: false, error: 'Erro na chamada API: ' + e.message };
  function _enderecosSimilares(end1, end2) {
    if (!end1 || !end2) return false;
    var e1 = String(end1).toLowerCase().replace(/[^a-z0-9]/g, '');
    var e2 = String(end2).toLowerCase().replace(/[^a-z0-9]/g, '');
    return e1 === e2 || e1.indexOf(e2) !== -1 || e2.indexOf(e1) !== -1;
  // ============================================================================
  // API PÚBLICA
  // ============================================================================
    // Verificação
    verificarAPI: verificarAPI,
    // Otimização
    otimizarRota: otimizarRota,
    otimizarTodasRotas: otimizarTodasRotas,
    // Análise
    analisarRota: analisarRota,
    analisarTodasRotas: analisarTodasRotas,
    detectarSobreposicoes: detectarSobreposicoes,
    // Alias para compatibilidade
    sugerirOtimizacao: analisarRota,
    detectarSobreposicao: detectarSobreposicoes
// ============================================================================
// FUNÇÕES GLOBAIS PARA FRONTEND
// ============================================================================
 * Otimiza rota específica (chamada do frontend)
function otimizarRotaMVP(idRota) {
  return RotasMVP.otimizarRota(idRota);
 * Otimiza todas as rotas (chamada do frontend)
function otimizarTodasRotasMVP() {
  return RotasMVP.otimizarTodasRotas();
 * Analisa rota específica (chamada do frontend)
function analisarRotaMVP(idRota) {
  return RotasMVP.analisarRota(idRota);
 * Analisa todas as rotas (chamada do frontend)
function analisarTodasRotasMVP() {
  return RotasMVP.analisarTodasRotas();
 * Detecta sobreposições (chamada do frontend)
function detectarSobreposicoesMVP() {
  return RotasMVP.detectarSobreposicoes();
 * Verifica status da API (chamada do frontend)
function verificarAPIRotas() {
  return RotasMVP.verificarAPI();
FilesExpand file tree

73_RotasMVP.gs

Latest commit

History

73_RotasMVP.gs

File metadata and controls
