MUTARE Project 🐌

Repositório MUTARE - PISI1 - Projetos Interdiciplinares de Sistemas da Informação 1
Desenvolvedores: Laura Cordeiro e Pedro Ailton
Docente Responsável: Cleyton Magalhães

Descrição do projeto:
O Mutare é uma ferramenta segura de gerenciamento consciente de hábitos que busca trazer qualidade de vida, saúde e produtividade na atual era de estímulos incessantes advindos das comodidades das novas tecnologias, que desincentiva a prática de bons hábitos.
A partir da poderosa psicologia do hábito (acertivamente tratada por Charles Duhigg em seu livro "O Poder do Hábito", inspiração para o nosso projeto), criamos um sistema digital capaz de fornecer assistência ao desenvolvimento de hábitos novos (que o sistema também poderá sugerir - como hábitos sustentáveis e cidadãos), correção de maus hábitos e acompanhamento dos hábitos desenvolvidos pelos usuários, junto de um sistema de recompensas, medição de desempenho e mascote.
Esse é o Mutare.

ENTREGAS

• 1VA 28/05/25
• 2VA 23/07/25
• 3VA 30/07/25

FLUXOGRAMAS DOS REQUISITOS FUNCIONAIS

Acesse clicando aqui (Google Drive)

REQUISITOS FUNCIONAIS

1ª VA

RF001 - Menu Cadastro
RF002 - Cadastro de Conta do Usuário ("C" do CRUD)
RF003 - Login
RF004 - Senha Não Visível ao Digitar
RF006 - Menu Principal
RF007 - Configurações: "R", "U" e "D" do CRUD de Conta do Usuário
RF008 - Menu Hábitos
RF009 - Algoritmo de Desempenho do Usuário para Mascote
RF009 - Mascote
RF010 - CRUD Hábitos

2ª VA

RF011 - Sistema de Recompensas(XP) e Níveis
RF012 - Verificação em Duas Etapas por email
RF013 - Recuperar Senha
RF014 - Recomendações Inteligentes

PRINCIPAIS FUNÇÕES DO CÓDIGO

Autenticação de Usuário

• menuInicial(auth): Menu inicial com opções de login e cadastro.
• cadastrarUsuario(self): Cadastro de usuários com validação de e-mail e senha.
• loginUsuario(self): Login seguro com verificação de credenciais e limite de tentativas.
• enviarCodigoAutenticacao(self, destinatario, codigo): Envia um código para a autenticação em dois fatores e recuperação de senha.
• recuperarSenha(self): Realiza o processo de recuperação de senha.

Configurações da Conta

• menuconfiguracoes(self, email, game): Acessa as configurações da conta do usuário.
• visualizarConta(self, email, game): Exibe informações da conta e permite alterações.
• atualizarSenha(self, email): Atualiza a senha com verificação da senha atual.
• excluirConta(self, email): Exclui a conta após dupla confirmação.
• buscarConta(self, email): Recupera dados da conta do usuário logado.

Gerenciamento de Hábitos

• menuHabitos(email, habito, game, rec): Menu com opções de adicionar, editar, deletar ou visualizar hábitos.
• inserirHabito(self, email): Adiciona um novo hábito com nome, frequência, motivação e datas.
• listarHabitos(self): Lista todos os hábitos cadastrados.
• editarHabito(self): Edita um hábito existente.
• deletarHabito(self): Exclui um hábito com base no ID.

Gameficação

• calcularProgresso(self): Exibe barra de progresso para cada hábito com base na frequência (Diária, Semanal, Mensal).
  • Permite adicionar registros conforme a frequência.
  • Garante que não sejam inseridos registros duplicados para o mesmo período.
• atualizarPontos(self): Atualiza os pontos de XP.

Mascote Motivacional

• exibir(self): Mostra um mascote com mensagens motivacionais de acordo com o desempenho do usuário:
  • Desempenho excelente (≥ 80%)
  • Bom (60–79%)
  • Fraco (40–59%)
  • Ruim (< 40%)
  • Sem registros (início)

Recomendações Inteligentes

• inserirHabitoRecomendacao(self, habito_recomendado): Coleta dados do usuário para cadastrar um novo hábito sugerido (nome, frequência, motivação e datas) e insere no banco de dados.
• mostrarRecomendacao(self): Exibe o menu de categorias de hábitos recomendados (Sustentáveis, Saudáveis e Criativos) e direciona para a seleção dos hábitos dentro de cada categoria.
• habitosSustentaveis(self): Exibe hábitos sustentáveis recomendados e permite ao usuário escolher um para adicioná-lo ao sistema.
• habitosSaudaveis(self): Exibe hábitos saudáveis recomendados e permite ao usuário escolher um para adicioná-lo ao sistema.
• habitosCriativos(self): Exibe hábitos criativos recomendados e permite ao usuário escolher um para adicioná-lo ao sistema.

Utilidades

• limparTela(): Limpa a tela do terminal conforme o sistema operacional.
• emailValido(email): Verifica se o e-mail possui domínio permitido (@gmail.com, @ufrpe.br).
• validarSenha(senha): Valida senhas com base em regras de segurança (mín. 1 número, 1 maiúscula).
• inputSenhaAsteriscos(): Entrada de senha com caracteres ocultos no terminal.

TECNOLOGIAS UTILIZADAS

Tecnologias	Utilidade
Python 3.13.5	Linguagem principal de desenvolvimento do sistema.
SQLite 3	Banco de dados leve e embutido para armazenamento local.
Trello	Organização e gerenciamento de tarefas e fluxos do projeto.
Git, GitHub, GitHub Desktop	Controle de versão, hospedagem do repositório e interface visual para commits e sincronização.
Draw.io	Design de fluxogramas.

BIBLIOTECAS

Biblioteca	Utilidade
bcrypt	Criptografia de senhas usando hash seguro.
colorama	Estilização de textos no terminal com cores e efeitos.
datetime	Manipulação e formatação de datas e horários.
os	Interação com o sistema operacional (pastas, arquivos, terminal).
time	Controle de tempo, delays e marcação temporal.
re	Uso de expressões regulares para validações e buscas em texto.
msvcrt	Leitura de teclas pressionadas no terminal (exclusivo para Windows).
dotenv	Carregamento de variáveis de ambiente a partir de um arquivo .env.
random	Geração de números e escolhas aleatórias.
smtplib	Envio de e-mails por meio do protocolo SMTP.

INSTALAÇÃO NECESSÁRIA

pip install colorama bcrypt python-dotenv

Utilizar esse comando na execução no terminal, antes de rodar o programa.