Refatoracao de qualidade de codigo

- Mover logica de routes.py para RankingMapper na camada de aplicacao
- Consolidar funcoes mesclar_periodos e anos_completos_periodos em periodo.py
- Extrair RankingCache para modulo separado em infrastructure/cache
- Substituir todos os print() por logging adequado
- Corrigir exception handlers genericos para tipos especificos
- Remover classe Atuacao e atributo atuacoes_raw nao utilizados
- Documentar status dos scripts utilitarios

backend/src/application/jobs/processar_ranking.py

@@ -1,8 +1,11 @@
 import json
+import logging
 from datetime import datetime
 from typing import Optional, Dict, Any
 
 from ...infrastructure.elasticsearch.client import ElasticsearchClient
+
+logger = logging.getLogger(__name__)
 from ...infrastructure.oracle.client import OracleClient
 from ...infrastructure.oracle.ranking_repository import RankingOracleRepository
 from ...infrastructure.repositories.consultor_repository_impl import ConsultorRepositoryImpl
@@ -87,8 +90,8 @@ class ProcessarRankingJob:
 
             except Exception as e:
                 import traceback
-                print(f"AVISO: Erro ao processar consultor {doc.get('id')}: {e}")
-                print(f"Traceback: {traceback.format_exc()}")
+                logger.warning(f"Erro ao processar consultor {doc.get('id')}: {e}")
+                logger.debug(f"Traceback: {traceback.format_exc()}")
                 continue
 
         if consultores_para_inserir: