Skip to content

anne-cgm/study-scheduler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StudyScheduler

Aplicação desktop desenvolvida com JavaFX que permite organizar tarefas acadêmicas, acompanhar prazos e filtrar atividades de forma simples, objetiva e funcional.

Descrição do Problema Real

A organização acadêmica é um desafio constante para muitos estudantes. A dificuldade em visualizar prioridades, prazos e demandas pode gerar sensação de sobrecarga, perda de foco e queda de produtividade.

Embora existam ferramentas amplas de produtividade, como o Notion, muitas vezes elas oferecem múltiplas funcionalidades que acabam tornando o ambiente mais complexo do que necessário para quem deseja apenas organizar tarefas, provas, trabalhos e prazos de entrega de forma objetiva.

A ausência de uma ferramenta simples, focada exclusivamente na organização de atividades acadêmicas com filtros claros e visualização direta das pendências, evidencia uma necessidade prática e recorrente no cotidiano estudantil.

Proposta da Solução

O StudyScheduler foi desenvolvido como uma solução enxuta e direcionada à organização de tarefas de estudo. A aplicação oferece um ambiente simples, focado exclusivamente no cadastro, acompanhamento e filtragem de atividades acadêmicas.

Ao priorizar clareza, objetividade e usabilidade, o sistema permite que o usuário visualize rapidamente suas tarefas pendentes e concluídas, organize prazos e mantenha o controle sobre suas demandas acadêmicas sem distrações ou funcionalidades excessivas.

A proposta central é transformar a organização em um processo direto e funcional, contribuindo para maior produtividade, previsibilidade e redução da sobrecarga mental associada à desorganização.

Público-Alvo

  • Estudantes do ensino médio
  • Universitários
  • Pessoas em preparação para provas, vestibulares, concursos
  • Qualquer pessoa que deseje organizar tarefas de estudo

Funcionalidades Principais

  • Cadastro de tarefas
  • Visualização da lista de tarefas
  • Marcar tarefas como concluídas
  • Filtrar tarefas (pendentes, concluídas ou atrasadas)
  • Interface gráfica intuitiva
Captura de tela 2026-04-10 135321

Tecnologias Utilizadas

  • Java 21 - linguagem principal do projeto
  • JavaFX 21 – criação da interface gráfica
  • Maven – gerenciamento de dependências e build
  • JUnit 5 – testes automatizados
  • Checkstyle – análise estática / lint
  • GitHub Actions – integração contínua e CI

Instruções de Instalação

1 - Instalar o Java 21

O projeto foi desenvolvido em Java 21, então essa versão é necessária.

  • Como verificar se você já tem Java:
  1. Windows: pressione Win + R, digite cmd e aperte Enter / macOS/Linux: abra o aplicativo “Terminal”
  2. Digite:
    java -version.
  • O resultado esperado é algo como: java version "21"
  • Caso não apareça, acesse o site e baixe o instalador para o seu sistema:
  1. Windows: .exe
  2. macOS: .dmg
  3. Linux: .tar.gz ou gerenciador de pacotes
  • Execute o instalador e siga os passos padrão (Next → Next → Finish)
  • Após instalar, feche e abra o terminal novamente e rode: java -version

2 - Instalar o Git

O Git é necessário para baixar o projeto.

  • Para verificar se já tem:
    git --version
  • Se não tiver, baixe aqui. Instale com as opções padrão

3 - Clonar o projeto

  • Existem duas formas de baixar o projeto: pelo Terminal ou pelo Git Bash (Windows)
  1. Terminal: Navegue até a pasta onde deseja salvar o projeto. Exemplo: cd bootcamp
  2. Git Bash: Entre na pasta onde deseja salvar o projeto e clique com o botão direito do mouse. Escolha a opção “Mostrar mais opções” e depois em “Open Git Bash here”
  • Digite o comando abaixo e copie o link https://github.com/anne-cgm/study-scheduler.git daqui, ou pelo link fornecido ao clicar no botão verde "code" acima do repositório no GitHub:
    git clone
  • Resultado esperado: uma pasta chamada "study-scheduler" será criada com todos os arquivos do projeto dentro da pasta escolhida

4 - Baixar dependências e compilar o projeto

É preciso baixar todas as bibliotecas necessárias (JavaFX, JUnit, etc.), compilar o código, executar os testes e gerar o arquivo .jar.

  • Entre na pasta do projeto dentro do terminal (cd study-scheduler) e digite:
  1. Windows:
    mvnw.cmd clean install
  2. macOS/Linux:
    ./mvnw clean install
  • Se tudo der certo, você verá: BUILD SUCCESS
  • Possíveis problemas:
  1. “java não reconhecido”: Java não instalado corretamente
  2. erro de permissão no Linux/macOS: rode:
    chmod +x mvnw

5 - Verificar se o projeto foi compilado

  • Após o build, verifique se existe o arquivo "studyscheduler-1.0.0.jar" dentro da pasta: "target". Isso significa que o projeto foi compilado com sucesso.

Instruções de Execução

  • Ainda na pasta do projeto, dentro do terminal, digite:
  1. Windows:
    mvnw.cmd javafx:run
  2. macOS/Linux:
    ./mvnw javafx:run
  • O que vai acontecer?
  1. O Maven vai iniciar o JavaFX
  2. A aplicação será carregada
  3. A janela do StudyScheduler será exibida
  • Problemas comuns:
  1. “java não reconhecido”: Java não instalado corretamente
  2. erro de permissão (Linux/macOS):
    chmod +x mvnw
  3. erro relacionado a JavaFX: rode novamente:
    mvnw.cmd clean install

Instruções para Rodar os Testes

  • Execute no terminal, dentro da pasta do projeto:
  1. Windows:
    mvnw.cmd test
  2. macOS/Linux:
    ./mvnw test
  • O que vai acontecer?
  1. O Maven vai procurar arquivos na pasta: src/test/java
  2. Vai compilar os testes
  3. Vai executar cada teste automaticamente
  • Resultado esperado: aparecerá algo como: Tests run: 5, Failures: 0 BUILD SUCCESS
  • Caso apareça "FAILURE", indica que alguma funcionalidade não está funcionando como esperado
  • O que está sendo testado?
  1. Criação de tarefas
  2. Marcar tarefa como concluída
  3. Verificar se tarefa está atrasada
  4. Comportamento com data nula

Instruções para Rodar o Lint

  • Comandos:
  1. Windows:
    mvnw.cmd checkstyle:check
  2. macOS/Linux:
    ./mvnw checkstyle:check
  • O que vai acontecer:
  1. O Maven analisa todo o código do projeto
  2. Verifica se está seguindo padrões de escrita, organização e boas práticas definidos
  3. Mostra avisos ou problemas no terminal
  • Resultado esperado: BUILD SUCCESS
  • Caso haja algo fora do padrão, vai listar arquivos e linhas com problemas. Exemplo: Line 10: Missing a Javadoc comment
  • Obs.: Esses avisos não impedem o projeto de funcionar, apenas servem para melhorar a qualidade do código

Versão Atual

1.0.0 – versão inicial funcional (MAJOR.MINOR.PATCH)

Autor

Anne Caroline Gonçalves de Mesquita

Link do Repositório Público

https://github.com/anne-cgm/study-scheduler

About

A desktop study planner built with JavaFX that allows students to manage tasks, deadlines, filters, and progress in a clean and modern interface.

Topics

Resources

Stars

Watchers

Forks

Packages