utils/

Este diretório centraliza módulos com funcionalidades auxiliares e reutilizáveis que dão suporte à lógica principal do projeto. A organização visa separar as responsabilidades em subdiretórios coesos.

Conteúdo

/apis: Contém os scripts responsáveis pela comunicação com APIs externas.
- gemini.py: Gerencia as chamadas para a API do Google Gemini, incluindo a formatação da entrada e o tratamento da resposta.
- gsheets.py: Abstrai a lógica de conexão e escrita de dados em planilhas do Google Sheets.
/report: Agrupa todos os módulos necessários para o processamento de dados e a geração do relatório final em PDF.
- icf_categories.py: Define as categorias da Classificação Internacional de Funcionalidade (CIF) através de uma Enum, centralizando códigos, rótulos e cores.
- dataframe_creation.py: Processa a resposta textual do modelo de linguagem para extrair e estruturar os dados em DataFrames do Pandas.
- graph_creation.py: Utiliza os DataFrames para criar os gráficos (pizza, barras e treemap) com a biblioteca Plotly.
- pdf_creation.py: Monta o arquivo PDF final, organizando o texto, as tabelas e os gráficos gerados.
- report_creation.py: Orquestra todo o fluxo de geração de relatório, chamando as funções dos outros módulos na ordem correta.
prompts.py: Armazena as instruções (prompts) detalhadas e estruturadas que são enviadas para o modelo de linguagem.