Trabalho Prático da Disciplina de Programação e Desenvolvimento de Software 2 (UFMG): Jogo de Uno

Integrantes:

Bruno Lima
Gustavo Lima
Maria Eduarda Sampaio
Pedro Kalil
Raissa Diniz
Raphael Amaral

Professora: Camila Laranjeiras

Em que consiste esse trabalho?

O objetivo deste trabalho é construir um projeto de software de pequeno porte. Nosso grupo escolheu construir um jogo de cartas do tipo UNO, realizando todo o processo de desenvolvimento necessário para um sistema desse porte (análise, projeto e implementação), e aplicando os conceitos e técnicas vistos durante o curso (modelagem, POO, testes unitários, etc). O programa é baseado na linguagem C++, mas também expõe uma API em C para poder ser acessado em dart, no flutter, por meio do dart:ffi (foreign function interface), que provê uma maneira de linkar dinamicamente bibliotecas compartilhadas de C e usa-las como funções nativas em dart.

O jogo Uno é um jogo de cartas lançado pela Mattel e Gameloft no qual o jogador relaciona os números com as cores. O objetivo é ser o primeiro jogador a ficar sem cartas na mão, utilizando-se de todas as regras possíveis para impedir que os outros jogadores façam a mesma coisa.

REGRAS E INFORMAÇÕES GERAIS SOBRE COMO FUNCIONA A NOSSA VERSÃO DO UNO:

O jogo consiste em 4 jogadores, com 7 cartas cada;

Além das clássicas cartas numéricas (0-9) de cores variadas (amarelo, azul, vermelho e verde), essa versão apresenta três tipos de carta especial (em detrimento às cinco do jogo padrão):

1.  Reverso: muda o sentindo da partida, podendo ser horário ou anti-horário;
    
2.  Bloqueio: impede o jogador seguinte ao que lançou a carta de participar nessa rodada;
    
3.  “Come 2”: faz com que o próximo àquele que jogou adicione mais 2 cartas à sua mão. É importante ressaltar que, nesse jogo, essas cartas não são acumulativas, ou seja, um outro “come 2” não pode ser jogado em cima de um previamente lançado de modo a “formar um come 4”;

O jogador não possui a possibilidade de falar “Uno” enquanto joga sua penúltima carta (uma vez que isso implicaria na necessidade da criação de todo um sistema de denúncia para quando isso não acontece, trazendo mais complexidade ao projeto);
O jogo possui bots. Dessa maneira, logo após você fazer a sua jogada, a vez será dada ao bot.

OBS: A interface em que o jogo será jogado será feita no framework flutter, feito pela Google para criar aplicações nativas e usando o pacote de gerenciamento de estado Value Notifier e o renderizador de vetores Vector Drawable.dart, feitos pelo aluno Pedro Morato Kalil.

NOSSO USER STORIES:

~~• Como jogador eu quero acessar meu histórico de partidas para saber como me sai e acompanhar meus resultados e minha evolução no jogo.~~

~~• Como jogador eu quero incrementar a quantidade de jogadores com os quais iniciarei uma partida para tornar a experiência de jogo mais fidedigna.~~

~~• Como jogador eu quero incrementar o nível dos bots com os quais jogarei, para testar a extensão das minhas habilidades.~~

~~• Como jogador eu quero delimitar o tempo para um jogador lançar uma carta para que a partida seja fluida e não seja prejudicada por um usuário “away from the keyboard”.~~

~~• Como jogador eu quero poder alterar os estilos dos elementos visuais, como cartas e plano de fundo, para tornar o jogo mais envolvente e diversificar minhas opções de customização~~

Como jogador, eu quero poder utilizar de, pelo menos, 3 das cartas especiais do UNO, para tornar o jogo mais divertido e mais parecido com o real;
Como jogador, eu quero poder acessar um menu durante a partida, para ter opções como sair, reiniciar, ou ler as regras do jogo sem precisar de quitar a rodada;
Como jogador, eu quero poder jogar com bots, para tornar a minha experiencia mais divertida, dinâmica e competitiva, de modo a testar minhas habilidades;
Como jogador, eu quero poder quitar a partida o momento que eu quiser, de modo a permitir uma jogabilidade mais fluida e leve;
Como jogador, eu quero poder desfrutar de uma interface interativa, de modo a tornar a experiência mais divertida, dinâmica, fácil, realista e visualmente agradável.

DIAGRAMA DE CLASSES:

Link para o Draw.io

COMO COMPILAR O CÓDIGO

make all

BAIXE O APLICATIVO PELO LINK ABAIXO

Link para baixar

CHECK-LIST: O QUE VAI SER AVALIADO NO TRABALHO

Documentação e organização (5 pontos)

 	1.  Detalhamento do projeto

 	2.  Organização dos arquivos e pastas (modularização)

 	3.  Doxygen, comentários, indentação (tabulação).

Funcionamento correto (5 pontos)

Uso correto das boas práticas e dos conceitos de OO (15 pts).

 1.  Abstração, Encapsulamento, Herança (pelo menos 1) e Polimorfismo (pelo menos 1).   
 
 2.  Modularidade e componentes reusáveis (independência)
     
 3.  Tratamento de exceções [link exemplo](https://github.com/flaviovdf/pds2-ufmg/tree/master/exemplos/aula-excecoes]
 
 4.  Preocupações com possíveis fontes de erro (entrada inválida, cenário que não funciona, abertura de arquivo, não consegue alocar memória, etc…)
     
 5. Customizar uma exceção própria do projeto (criar um TAD que herda das exceções nativas do C++)

Testes de unidade (7 pontos)
Participação individual (2 pontos)
Ponto extra para criatividade e adicionais não requisitados (+2 pontos)

KalilDev / uno.cpp