Projeto Final

Data de entrega da proposta inicial do projeto: 12/05/2024, via Blackboard

Data de entrega: 28/05/2024, via GitHub (o endereço deve ser enviado no Blackboard)

Grupos: duplas ou trios. O critério de avaliação muda conforme o tamanho da equipe.

Objetivo do Projeto

Desenvolvimento de um jogo de computador em Python 3 usando recursos da biblioteca PyGame, dentre outras. O programa deverá ser interativo, permitindo um ou mais jogadores interagirem em um jogo com objetivo bem definido. O desenvolvimento deverá ser feito em grupos de 2 ou 3 alunos, usando o Git como sistema de versionamento. O tema do jogo é livre, contudo, a proposta deve ser previamente discutida com o professor.

O objetivo é colocar em prática o que você aprendeu sobre programação com Python e desenvolver mais suas habilidades de aprender a aprender e de trabalhar em uma equipe autogerenciada de software. Por esse motivo, será necessário que você utilize funcionalidades que não vimos em nenhuma aula.

Entrega

Envie no BlackBoard (não perca o prazo):

1. O endereço do seu repositório GitHub (faça isso logo no início do projeto);
2. Formulário com a proposta inicial do projeto (pode mudar um pouco depois, mas é importante definir uma direção);

O professor irá clonar o código presente no GitHub ao final do dia de entrega (assim, se o repositório for privado, adicione o professor como colaborador). O repositório deverá conter um arquivo README.md com, no mínimo, o seguinte conteúdo:

1. Título do projeto;
2. Nomes dos membros do seu grupo;
3. Explicação de como rodar o jogo;
4. Endereço de um vídeo curto apresentando o seu jogo (você pode colocar o vídeo onde preferir: YouTube, Vimeo, etc. mas o professor precisa ter acesso através do link). Esse vídeo (pode ser alguns poucos segundos) deve mostrar o seu projeto funcionando.

Recomendamos que vocês também incluam no README.md uma descrição do seu projeto, como instalar as dependências (se usar alguma biblioteca adicional, como o PyGame) e como executar o programa. Esses pontos não são obrigatórios, mas são recomendados em qualquer projeto.

Aviso

Os projetos serão examinados com fontes da internet e os projetos de outros alunos. Se você se basear em algum código da Internet, deixe claro de onde pegou e dê os créditos. É normal você buscar exemplos na internet para entender como funciona uma ferramenta, o que não é aceitável é copiar longos trechos de código e não dar crédito. Se forem poucas linhas, 3 ou 4 por exemplo, você não precisa referenciar, se for muito mais que isso, diga de onde pegou. Já usar projetos de colegas ou tutoriais é mais crítico, não copie código de outras pessoas, é sempre saudável conversar para ter e dar ajuda, mas não pegar código pronto.

Existe um documento no Blackboard (Orientações sobre integridade intelectual em atividades de programação) com mais detalhes. Se tiver alguma dúvida pergunte para o seu professor.

Caso você utilize um trecho de código da internet, adicione um comentário no seu código: Código extraído de https://endereco.de.onde.voce.pegou.o.codigo.com.br.

Plugins de IA generativa (IAg)

Neste projeto, pode-se utilizar ferramentas e plugins de IA generativa (IAg) desde que você entenda o que foi criado e indique claramente no projeto.

• Ao utilizar ferramentas de Inteligência Artificial, é de sua responsabilidade entender o que foi gerado e como isso se relaciona com o seu projeto.
• NÃO é responsabilidade do professor te explicar o que foi gerado pela IAg.
• Bugs gerados por ferramentas de IA a princípio devem ser resolvidos pelos membros do grupo recorrendo também a IA. Dúvidas relacionadas a problemas gerados por IA ficarão para o final da fila de dúvidas e atendidos quando houver disponibilidade.

Quando utilizar a IAg, deve-se seguir a Política de Regime Disciplinar Discente e as seguintes diretrizes:

• Utilize a ferramenta institucional de IAg disponibilizada pelo Insper. Acesse a ferramenta:.
• Cite todo o material gerado pela IAg e explique como ele foi usado. Escreva um pequeno parágrafo ao final explicando como a IAg foi usada, e inclua a sua interação com a IAg no Anexo.
• Verifique criticamente as informações geradas pela IAg, pois podem conter alucinações, erros e/ou viés e estereótipos.

Caso haja o uso de código gerado por essas ferramentas, é necessário indicar a fonte. Para isso, adicione uma explicação ao arquivo READMD.md do repositório detalhando o quanto foi gerado por IA. (ex.: "A função desenha_sprint foi 100% retirada deste link http://abcxyzxyzzyz ") ou "a função calcula_mapa foi 90% gerada por IA e o histórico do chatGPT está exportado no link http://xyzxyzzyz ".

• Ferramentas de sugestão de código (ex.: Github Copilot) - Caso utilize ferramentas de sugestão de código, como o Github copilot, você pode aceitar linhas e até loops sem precisar dar crédito. Entretanto, a partir do nível de funções e classes é importante colocar um comentário # feito com CoPilot

Nota

O projeto é necessariamente EM GRUPO, é um requisito apresentado no iníco do curso que DEVE ser cumprido. No caso de algum aluno não encontrar um grupo ao tempo do início, então, o professor irá sortear os alunos sem grupo entre os grupo já estabelecidos, até 3 alunos por grupo. Trabalhos individuais serão zerados.

A nota do projeto será dada pelo seguinte critério:

• Se a equipe obteve conceito I ou D em algum objetivo de aprendizado, o conceito final será dado pelo menor conceito obtido. Por exemplo: se todas as features foram implementadas, e o código está impecável, mas um aluno fez tudo (conforme evidenciado no git), a nota será D (ou até mesmo I).
• Se todos os conceitos forem iguais ou superiores a C, o conceito final será obtido pela média ponderada dos conceitos obtidos para os objetivos de aprendizado: \(\(0.25 * Objetivo 1 + 0.5 * Objetivo 2 + 0.25 * Objetivo 3\)\)

Rubrica

A tabela a seguir apresenta os requisitos esperados e seus respectivos conceitos associados para os 3 objetivos de aprendizagem.

Objetivo 1: Desenvolver programas de computador

Objetivo 2: Identificar e programar estratégias computacionais de resolução de problemas práticos

Objetivo 3: Atuar em uma equipe de desenvolvimento de software

Cronograma para o conceito B no Objetivo 2

Esta é uma sugestão de organização para o projeto de vocês. Lembrem-se que um dos objetivos é trabalhar em uma equipe autogerenciada de desenvolvimento de software. Assim, vocês devem se organizar da maneira que acharem melhor. A sugestão abaixo é mais um guia para saberem se estão atrasados (será difícil atingir o conceito B fazendo muito menos do que isso), em dia, ou avançados (buscando o conceito A).

• Até 12/05: handout de PyGame concluído, projeto definido e uma primeira tela com interações iniciais funcionando (sem animações, apenas imagens estáticas se movendo pela tela). Por exemplo, em um jogo de plataforma isso significaria mover o personagem com o teclado e fazer ele perder vida/morrer ao encostar em um inimigo;
• Até 16/05: mecânica básica do jogo concluída e início da implementação de outras telas e recursos sonoros;
• Até 20/05: mecânica do jogo concluída (incluindo recursos interativos adicionais, como power-ups, vidas, movimentação dos inimigos - caso se aplique) e navegação entre telas funcionando;
• Até 23/05: projeto concluído com os requisitos do conceito B.

Exemplo

Cada projeto possui um nível diferente de dificuldade. Por exemplo, é esperado que um jogo com implementação mais simples seja mais bem finalizado do que um jogo com uma lógica mais complexa. Por esse motivo, a lista abaixo deve ser considerada apenas como um guia do que é esperado no jogo ao final do semestre, mas é importante que você converse com os professores para entender melhor as expectativas para o seu projeto:

• Tela de menu/início de jogo e tela de final de jogo;
• Múltiplas fases;
• Contagem de pontuação e/ou vida;
• Algum tipo de animação;
• Algum tipo de efeito sonoro/fundo musical;
• Outros detalhes específicos de cada jogo (exemplos: inimigos que seguem o jogador, power-ups, telas de instrução, telas de história, botão de pause, ...)