/votacao_solutis

Implement a solution using JAVA 8 and SpringBoot

Primary LanguageJava

Desafio Reskilling Java

Apresentação e entrega do Desafio Reskilling Java.

Conteúdo

Pré-requisitos

Estas são as instalações e configurações necessárias para executar o projeto.

Para executar este projeto é necessário instalar:

  • Apache Maven 3.8.5
  • Java 11

  1. Após a instalação é necessário configurar as variaveis de ambiente:

    • JAVA_HOME - Apontando para o local de instalação do Java
    • MAVEN_HOME - Apontando para o local de instalação do Maven
    • PATH - Adicionar "JAVA_HOME\bin" e "MAVEN_HOME\bin"

  2. Após intatalações e configurações verifique se o ambiente está pronto:

    • Execute o seguinte comando no terminal

      java -version

  • Resultado esperado

    • openjdk 11.0.14.1 2022-02-08 LTS
    • OpenJDK Runtime Environment Corretto-11.0.14.10.1 (build 11.0.14.1+10-LTS)
    • OpenJDK Server VM Corretto-11.0.14.10.1 (build 11.0.14.1+10-LTS, mixed mode, emulated-client)

  1. Execute o seguinte comando no terminal:

    mvn -version

  • Resultado esperado

    • Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
    • Maven home: ...\apache-maven-3.8.5
    • Java version: 11.0.14.1

Execução

  1. Clonar repositório git utilizando o comando:

      git clone https://github.com/elayneargollo/votacao_solutis.git

  2. Vá ate a pasta do projeto

      cd votacao_solutis

  3. Install all dependencies

      mvn spring-boot:run

Após a execução a inicialização conseguirá acessar:

Sonarqube

  1. Realize o dowloand no link:

      https://www.sonarqube.org/downloads/

  2. Start o sonar e realize o login:

      - http://localhost:9000 por default
  - login padrao (admin/admin)

  3. Crie um projeto manualmente e escolha um nome para ele

  4. Configure o projeto manualmente inserindo um token válido

  5. Execute a análise do Sonarqube na raiz do projeto seguindo as instruções abaixo:

     - mvn clean verificar sonar:sonar \
 - Dsonar.projectKey=<nomeDoProjeto> \
 - Dsonar.host.url=http://localhost:9000\
 - Dsonar.login=<keyDoProjeto>

Links

GitHub - https://github.com/elayneargollo/votacao_solutis
Swagger - http://localhost:8080/swagger-ui.html#/
Coleção Postman - https://github.com/elayneargollo/votacao_solutis/blob/main/votacao.postman_collection.json
Sonarqube - http://localhost:9000/

Tarefa Principal

Em uma cooperativa, cada associado possui um voto e as decisões são tomadas através de assembleias, por votação. A partir disso, você precisa criar o backend para gerenciar essas sessões de votação. A solução deve atender os seguintes requisitos através de uma API REST:

  • RF1. Cadastrar pauta.

  • RF2. Abrir uma sessão de votação para uma pauta.

    - Cada pauta deve comportar apenas uma sessão de votação
- A sessão de votação deve ficar aberta por um tempo determinado na chamada de abertura ou 1 minuto por padrão

  • RF3. Receber votos dos associados em pautas abertas

    - Os votos são apenas 'Sim'/'Não'
- Cada associado é identificado por um id único e pode votar apenas uma vez por pauta
- Registre a data/hora do voto

  • RF4. Contabilizar os votos e dar o resultado da votação na pauta

    - Exibir vencedor por maioria simples
- Exibir quantidade de votos para cada um dos grupos 'Sim'/'Não'
- Exibir percentual para cada um dos grupos 'Sim'/'Não

  • Para fins de exercício

     - A segurança pode ser abstraída e qualquer chamada para a API pode ser considerada autorizada.
 - Para fins de exercício, você pode cadastrar previamente um conjunto de associados.
 - Implemente testes unitários com ao menos 50% de cobertura de código.
 - Utilize Swagger para documentar sua API.
 - Disponibilize uma coleção do Postman com todos endpoints.
 - Se utilizar um banco de dados diferente do H2, um dockerfile deve ser disponibilizado para o banco de dados.

Tarefa Bônus

  • Tarefa Bônus 1 - Integração com sistemas externos (GET: https://cpf-api-almfelipe.herokuapp.com/cpf/12345678901)
  • Tarefa Bônus 2 - Contabilização automática (A rotina de contabilização deve ser executada a cada minuto)
  • Tarefa Bônus 3 - Mensageria e filas (Kafka, RebbitMQ ou qualquer outra)
  • Tarefa Bônus 4 - Hospede sua API na nuven (Free Tier AWS, Heroku ou outro)
  • Tarefa Bônus 5 - Análise de qualidade do código (Sonarqube)
  • Tarefa Bônus 6 - Versionamento da API

Autora

Feito por Elayne Natália 👋🏽 Entre em contato!

Linkedin Badge