README.md

Script em Python para Geração de Relatório em PDF 💬🟩

⚈ Acerca do Programa

Esse programa tem como intuito gerar um relatório em pdf a partir da leitura de arquivos .csv como os exemplos indicados nos arquivos cliente_1.csv, cliente_2.csv, e cliente_3.csv. Esses arquivos foram gerados no 4yousee manager como relatórios detalhados, considerando que cada um é um relatório de uma conta, ou de um cliente.

Para mais informações, ler a documentação Como extrair um relatório de Auditoria de Veiculação dos meus players? (Relatório detalhado)

A seguinte imagem apresenta um exemplo de como é o relatório, seu cover e uma das páginas com os dados dos playlogs por data.

⚈ Requisitos

• Baixar os arquivos em .csv referente aos clientes/contas que deseja. Deve ter ao menos um. O recomendável é selecionar nesse relatório detalhado os conteúdos e players que você espera considerar no relatório final, além de selecionar o intervalo de datas.

• Substituir os arquivos :

  • logo.png: Essa é a logo que aparece no header de cada página e no footer.
  • logo_2: Essa é a logo que aparece no cover.
  • background_cover.png: Imagem do cover.

• Cria arquivo data_report_001.py baseado nas seguintes orientações:

  PASTA = 'data_report_001'  # Nome da Pasta onde se encontram os arquivos .csv e o próprio arquivo data_report_001.py
  NOME_EMPRESA = "Minha Empresa de Midia"  # Nome da empresa que emite o relatório
  NOME_FANTASIA = "FORÇA MIDIA"   # Nome de fantasia da empresa que emite o relatório
  CNPJ_EMPRESA = "XX.XXX.XXX/XXXX-XX "  # CNPJ da empresa que emite o relatório
  ENDERECO_EMPRESA = "Av. Alfonso Pena, 1500, Xº andar - \nCentro - Cidade/MG"  # Endereço da empresa que emite o relatório
  TELEFONE_EMPRESA = "+55 11 9 5987-2598"  # Telefone da empresa que emite o relatório
  CLIENTE = "NOME DO CLIENTE"  # O cliente usualmente é a agencia que solicitou o relatório
  DATA_INICIAL = "20-12-2021"  # Data inicial para considerar os playlogs dos conteúdos
  DATA_FINAL = "31-12-2021" # Data inicial para considerar os playlogs dos conteúdos
  # Se o relatório (.csv) vem com playlogs de datas fora da DATA_INICIAL e DATA_FINAL, não vai ser considerado pelo programa.
  CLIENTES = {'cliente_1': {  # nome do cliente, esse nome deve ser igual ao arquivo .csv
                            'conteudos': [571, 570],  # (Lista de inteiros) Conteúdos a serem considerados para o relatório. O programa soma o total de playlogs dos conteudos
                            'players': [   # (Lista de Dict) Cada dicionário corresponde a um player
                                        {'id': 3, 'endereco': 'Endereço do Player', 'insercoes': 700},   # id do conteúdo no 4yousee manager,
                                        {'id': 7, 'endereco': 'Endereço do Player', 'insercoes': 700},   # endereço do player (localização)
                                        {'id': 8, 'endereco': 'Endereço do Player', 'insercoes': 700},   # e inserções, ou seja, quanto é o esperado 
                                        {'id': 16, 'endereco': 'Endereço do Player', 'insercoes': 700},  # no período de tempo para esse player.
                                        {'id': 17, 'endereco': 'Endereço do Player', 'insercoes': 700}   
                                      ],
                          }
              }

⚈ Como é o fluxo de funcionamento do 4YouSee Sensors

Assim que existir os arquivos indicados nos requisitos, e instalar as librarias através do comando python -m pip install -r requirements.txt, você pode executar o programa main.py e o resultado, o pdf irá ser gerado na pasta data_report_001.

Em caso você queira gerar outro pdf com outros dados, com outros clientes e informações distintas ao relatório 001, você pode criar uma pasta data_report_002 com o arquivo data_report_002.py dentro de aquela pasta. Logo, será necessário mudar a linha 235 do main.py, para que aponte para a nova pasta.