Skip to content

🖥️ Repositório destinado ao projeto de Atividades pro Projetos Integrados realizados na FATEC de São José dos Campos, São Paulo no 1º Semestre do curso de Desenvolvimento de Software Multiplataforma em parceria com a empresa Vanguarda.

Notifications You must be signed in to change notification settings

drisabelles/api-vanguarda-eleitorado

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Generic badge

Fatec Prof Jessen Vidal - São José dos Campos - 1º Semestre DSM


Grupo 3 📊💻

Plataforma para Análise Estatística


- Objetivo do projeto -

Desenvolver uma plataforma no qual os jornalistas da rede de televisão Vanguarda possam acessar informações e dados de eleitores de diferentes regiões da área de abrangência no qual a rede trabalha.


- Descrição do projeto -

O projeto têm como objetivo o desenvolvimento dos alunos do curso de Desenvolvimento de Software Multiplataforma da Fatec de São José dos Campos - Prof Jessen Vidal, na criação de uma plataforma para análise estatística. O trabalho visa a interação dos alunos com o cliente, que é a Rede Vanguarda, no qual os mesmos possuem acesso as regras do projeto que são definidas pelo cliente, para assim atender suas demandas e necessidades.

- Índice -

Sobre a plataforma

Requisitos

Equipe

Ferramentas utilizadas

Entregas

Backlog do projeto

Cronograma


- Sobre a plataforma -

O site desenvolvido têm como meta proporcionar a melhor experiência ao usuário, para que consiga obter informações consistentes e análises utéis referente aos eleitores da região desejada. Para isso, serão utilizadas técnicas de usuabilidade, diferentes filtros e gráficos. Além disso, optamos por um design minimalista e moderno, para o site ser bem intuitivo independente de quem use. O desenvolvimento será de maneira simples afim de que, futuramente, o cliente também possa realizar modificações de acordo com o seu gosto.


- Requisitos - 🖱️

O cliente solicitou que o site deverá possuir os seguintes requisitos:

  • Dados do perfil do eleitorado atual

  • Dados do perfil do eleitorado na última eleição

  • Dados por regiões

  • Visualizar esses dados através de diferentes tipos de gráficos

  • Estrutura e código de fácil entendimento para realizar modificações

  • Documentação para guiar navegação e futuras modificações

  • Possibilidade de exportação das informações para outras plataformas

  • Utilizar Jupyter Notebook para as entregas dos dados


Funcionalidades desenvolvidas:

Tela Inicial

  • Ícones direcionáveis das cinco cidades
  • Hover para destacar e apresentar o nome da cidade no ícone
  • Cabeçalho da página com data, logo do cliente e ícone do menu
  • Menu arrastar no canto superior esquerdo com nome das cidades

Tela da Cidade Selecionada

  • Ícones direcionáveis para as seções de eleitores por prefeito, vereador e região
  • Menu arrastar no canto superior esquerdo com as regiões da cidade
  • Hover para destacar uma região selecionada
  • Exibição das informações específicas referentes a região selecionada

Análise de Dados

  • Definir os filtros
  • Buscar as bases de dados necessárias
  • Fazer o tratamento dos dados
  • Gerar análise estatística dos dados de acordo com perfil do eleitorado
  • Gerar análise estatística dos dados de acordo com as eleições municipais 2020
  • Gerar os gráficos para visualização
  • Visualização na plataforma web
  • Exportação das informações

Documentação

  • Local fonte das bases de dados
  • Explicação sobre as bases de dados
  • Explicação sobre as análises geradas
  • Explicação sobre as ferramentas de dados utilizadas
  • Explicação sobre o desenvolvimento web
  • Explicação sobre as ferramentas utilizadas para o front-end
  • Guia para realizar modificações

- Equipe - 👥


- Ferramentas utilizadas - 🔨

  • Front-end: HTML5, CSS3, Javascript

  • Análise de Dados: Python, Pandas, Plotly, Jupyter Notebook

  • Design: FIGMA


- Entregas - ✅

  • Entrega 1 - 08/03/2021 à 28/03/2021 - Para visualizar a entrega, clique aqui.

  • Entrega 2 - 29/03/2021 à 18/04/2021 - Para visualizar a entrega, clique aqui.

  • Entrega 3 - 26/04/2021 à 16/05/2021 - Para visualizar a entrega, clique aqui.

  • Entrega 4 - 17/05/2021 à 06/06/2021 - Para visualizar a entrega, clique aqui.


- Backlog do projeto - 📑


- Cronograma - 🕧

- Sprint 1 -

Generic badge

- PERÍODO- 📅

  • Entrega 1 - 08/03/2021 à 28/03/2021

- BURN DOWN DA SPRINT- 📈

burndown

burndown_tabela

- ENTREGAS - ✅

backlog

- BACKLOG DA SPRINT- 📑

Definir os filtros ✔️

  • Levantamento dos requisitos

  • Fazer User Stories

    • Exemplo de algumas User Stories desenvolvidas:

    1- "Como um jornalista quero poder navegar entre as regiões do vale do paraíba por que eu quero fazer uma análise geral por região."

    2- "Como jornalista eu quero visualizar a média de homens e mulheres que votaram em cada região para que eu possa utilizar esses dados em minha matéria."

    3- "Como jornalista eu quero visualizar a média de pessoas PNE (portador de necessidades especiais) que participam das eleições de cada região para que eu possa utilizar esses dados em minha matéria."

    4- "Como jornalista eu desejo visualizar gráficos de diferentes tipos como gráficos de barra, de pizza, de rosca, para visualização de dados."

    5- "Como jornalista desejo saber a porcentagem de eleitores justificados na última eleição."

    6- "Como jornalista desejo saber a porcentagem de eleitores faltosos na última eleição."

    7- "Como jornalista gostaria de saber a evolução do número de eleitores."

  • Realizar validação com o cliente

Segundo os requisitos levantados pelo cliente, foi definido os seguintes filtros que serão utilizados para a coleta e extração dos dados:

  • Estado: São Paulo
  • Municípios: São José dos Campos, Taubaté, Jacareí, Pinda e Caraguatatuba
  • Nome Social
  • Faixa Etária
  • Estado Civil
  • Escolaridade
  • Gênero
  • Portadores de Necessidades Especiais
  • Zona Eleitoral
  • Justificativa Eleitoral - Eleições Municipais 2020
  • Eleitores Faltosos - Eleições Municipais 2020
  • Prefeitos Eleitos - Eleições Municipais 2020
  • Vereadores Eleitos - Eleições Municipais 2020
  • Evolução do Eleitorado

Introdução da documentação ✔️

  • Introdução
  • Descrição do site
  • Objetivo
  • Exemplos dos dados a ser utilizados

👉 Para acessar o arquivo da documentação desenvolvida até o momento, basta acessar aqui. | (Caso demore e/ou não carregue o documento, atualize a página)

Wireframe ✔️

  • Definir as informações que precisam ser apresentadas em telas
  • Definir os tipos de telas
  • Definir quantidade de telas
  • Definir organização das telas
  • Fazer protótipo navegável no FIGMA
  • Realizar validação com o cliente
  • Documentar o Wireframe em PDF
  • Fazer video demonstrativo do protótipo navegável

👉 Para acessar as telas em arquivo PDF, basta acessar aqui. | (Caso demore e/ou não carregue o documento, atualize a página)

👉 Para acessar o protótipo navegável em formato FIGMA, basta acessar aqui.

- DEMONSTRAÇÃO DO WIREFRAME- 🎥

gif

👉 Para assistir o video completo com a demonstração do wireframe, acesse aqui.

- Sprint 2 -

Generic badge

- PERÍODO- 📅

  • Entrega 2 - 29/03/2021 à 18/04/2021

- BURN DOWN DA SPRINT- 📈

burndown

burndown_tabela

- ENTREGAS - ✅

backlog

- BACKLOG DA SPRINT- 📑

Tela Inicial:heavy_check_mark:

  • Definir e fazer correções do primeiro protótipo
  • Ícones direcionáveis das cinco cidades
  • Hover para destacar e apresentar o nome da cidade no ícone
  • Cabeçalho da página com data, logo do cliente e ícone do menu
  • Menu arrastar no canto superior esquerdo com nome das cidades

telainicial telainicial

👉 Para acessar todo o código dessa página desenvolvido até o momento, clique aqui. | (Caso demore e/ou não carregue o documento, atualize a página)

Tela da cidade selecionada:heavy_check_mark:

  • Definir e fazer correções do primeiro protótipo
  • Menu arrastar no canto superior esquerdo com as regiões da cidade
  • Hover para destacar e apresentar a região selecionada

telacidade

👉 Para acessar todo o código dessa página desenvolvido até o momento, clique aqui. | (Caso demore e/ou não carregue o documento, atualize a página)

Dados do perfil do eleitorado atual ✔️

  • Definir e buscar bases de dados necessárias

As bases de dados utilizadas nessa sprint podem ser encontradas no seguinte site: Repositório de Dados Eleitorais

  • Definir ferramentas a ser utilizada para realizar a funcionalidade
  • As ferramentas utilizadas nessa sprint foram:

Jupyter Notebook

Python

Biblioteca pandas

  • Definir as User Stories a serem utilizadas
  • Foram selecionadas as seguintes User Stories:

“Como um jornalista, eu quero saber a classificação do eleitorado a partir do estado civil, escolaridade e gênero para que eu obtenha conteúdo para minha matéria.”

“Como um jornalista, eu quero saber a porcentagem de eleitores que utilizam nome social para que eu obtenha conteúdo para minha matéria.”

“Como um jornalista, eu quero saber quais as cidades com eleitorado mais jovem e mais velho”

"Como jornalista eu quero visualizar a média de homens e mulheres que votaram em cada região para que eu possa utilizar esses dados em minha matéria."

"Como jornalista eu quero visualizar a média de pessoas PNE (portador de necessidades especiais) que participam das eleições de cada região para que eu possa utilizar esses dados em minha matéria."

  • Fazer o tratamento dos dados

  • Definir parâmetros

  • Os seguintes parâmetros foram definidos:

É considerado público jovem eleitores entre 16 anos á 29 anos

É considerado público mais velho eleitores entre 60 anos ou mais

Foi considerado os eleitores como um todo, sem a divisão entre voto obrigatório e voto facultativo

  • Aplicar filtros definidos na sprint 1
  • Filtros aplicados nessa sprint:

Estado: São Paulo

Municípios: São José dos Campos, Taubaté, Jacareí, Pinda e Caraguatatuba

Nome Social

Faixa Etária

Estado Civil

Escolaridade

Gênero

Portadores de Necessidades Especiais

print_tela_sjc_grafico_sul_pt1

Zona Eleitoral

  • Gerar análise estatística dos dados de acordo com o perfil do eleitorado
  • As seguintes análises foram feitas de acordo com as informações recolhidas:

A faixa etaria que contém o número de eleitores

O grau de escolaridade entre o maior número de eleitores

O gênero que tem predominancia entre os eleitores

O estado civil que contém o número de eleitores

Número de eleitores com nome social

Número de eleitores Portadores de Necessidades Especiais

Comparação de idade entre as cidades

  • Exemplo das análises feitas:

analise

analise

👉 Para acessar todo o código desenvolvido até o momento, clique aqui. | (Caso demore e/ou não carregue o documento, atualize a página)

⚠️ ATENÇÂO: Esse requisito será puxado para a próxima sprint para serem desenvolvidas as análises por regiões de cada cidade

  • Realizar validação com o cliente

- DEMONSTRAÇÃO DAS TELAS DESENVOLVIDAS:movie_camera:

gif

- Sprint 3 -

Generic badge

- PERÍODO- 📅

  • Entrega 3 - 26/04/2021 à 16/05/2021

- BURNDOWN DA SPRINT- 📈

tarefas

gráfico3

- ENTREGAS - ✅

entrega

- BACKLOG DA SPRINT- 📑

- Gerar os gráficos para visualização:heavy_check_mark:

  • - Implementação dos gráficos

*gerados a partir das análises realizadas na sprint anterior

A faixa etaria que contém o número de eleitores

O grau de escolaridade entre o maior número de eleitores

O gênero que tem predominancia entre os eleitores

O estado civil que contém o número de eleitores

Número de eleitores com nome social

Número de eleitores Portadores de Necessidades Especiais

Comparação de idade entre as cidades

  • demonstração dos gráficos gerados

pt1 pt2 pt3 pt4

  • - Otimização no código para adequar o layout em diferentes monitores e dispositivos.
  • - Otimização geral no código para melhor desempenho em navegadores (Mozilla Firefox)

Todo código que foi otimizado pode ser encontrado aqui

- Visualização na plataforma web:heavy_check_mark:

  • - Integração do jupyter notebook com a aplicação web
  • Integrou-se os gráficos dinâmicos gerados em Jupyter para o html, implemntando o código dos gráficos ao código do arquivo html, permitindo que o usuário interaja com os gráficos.

- Gerar análise estatística dos dados de acordo com perfil do eleitorado::heavy_check_mark:

  • - Conforme citado acima, os dados que foram gerados, estão contidos nos gráficos gerados pelo Jupyter notebook.

As bases de dados utilizadas nessa sprint podem ser encontradas no seguinte site: Repositório de Dados Eleitorais

- DEMONSTRAÇÃO DAS TELAS DESENVOLVIDAS:movie_camera:

gif

- Sprint 4 -

Generic badge

- PERÍODO- 📅

  • Entrega 4 - 17/05/2021 à 06/06/2021

- BURNDOWN DA SPRINT- 📈

tarefas

gráfico3

- ENTREGAS - ✅

entrega

- BACKLOG DA SPRINT- 📑

- Exportação das informações:heavy_check_mark:

  • - Exportação do gráfico em formato PNG através da biblioteca Plotly, utilizada para extração dos gráficos.

Em todos os gráficos contém um ícone com algumas ferramentas. O icone demarcado na imagem abaixo possibilita o download do gráfico em forma PNG.

download

👉 Para acessar os arquivos com os códigos de Front-End desenvolvidos, clique aqui.

- Documentação completa:heavy_check_mark:

  • Local fonte das bases de dados
  • Explicação sobre as bases de dados
  • Explicação sobre as análises geradas
  • Explicação sobre as ferramentas de dados utilizadas
  • Explicação sobre o desenvolvimento web
  • Explicação sobre as ferramentas utilizadas para o front-end
  • Guia para realizar modificações

👉 Para acessar o pdf com a documentação completa, clique aqui. | (Caso demore e/ou não carregue o documento, atualize a página)

- Atualização dos dados e dos gráficos:heavy_check_mark:

Mudança: Foi decidido não dividir as cidades por regiões, trazer apenas os dados da cidades como um todo. Isso ocorreu por conta da dificuldade de se encontrar as divisões regionais das cidades pequenas do vale.

  • Incrementação com os seguintes Municípios:
  • Caçapava
  • Ilhabela
  • São Sebastião
  • Ubatuba
  • Campos do Jordão

👉 Para acessar os arquivos com os gráficos desenvolvidos, clique aqui.

👉 Para acessar o arquivo Jupyter com os códigos das análises feitas em Python, clique aqui.

- DEMONSTRAÇÃO DAS TELAS DESENVOLVIDAS:movie_camera:

gif

About

🖥️ Repositório destinado ao projeto de Atividades pro Projetos Integrados realizados na FATEC de São José dos Campos, São Paulo no 1º Semestre do curso de Desenvolvimento de Software Multiplataforma em parceria com a empresa Vanguarda.

Topics

Resources

Stars

Watchers

Forks

Languages

  • HTML 99.5%
  • Other 0.5%