Aplicação desktop desenvolvida com JavaFX que permite organizar tarefas acadêmicas, acompanhar prazos e filtrar atividades de forma simples, objetiva e funcional.
- Aplicação Publicada: https://www.jdeploy.com/~study-scheduler-annecgm
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.
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.
O StudyScheduler utiliza integração com a API OpenWeather para exibir informações climáticas em tempo real diretamente na interface da aplicação.
A proposta dessa funcionalidade é agregar contexto ao planejamento de estudos. Condições climáticas podem influenciar produtividade, concentração e organização da rotina. A aplicação utiliza os dados da API para fornecer sugestões rápidas ao usuário, como momentos favoráveis para revisão, leitura ou descanso.
A integração é realizada através de requisições HTTP GET, consumindo dados públicos de clima e exibindo:
- temperatura atual
- condição climática
- mensagens contextuais para estudos
- Estudantes do ensino médio
- Universitários
- Pessoas em preparação para provas, vestibulares, concursos
- Qualquer pessoa que deseje organizar tarefas de estudo
- Cadastro de tarefas
- Edição e remoção de tarefas
- Visualização da lista de tarefas
- Marcar tarefas como concluídas
- Organização automática por prioridade/data
- Filtrar tarefas (todas, concluídas ou atrasadas)
- Persistência de dados
- Integração com API de clima
- Widget climático em tempo real
- Interface gráfica intuitiva
- Menu contextual com clique direito
- Deploy desktop com JDeploy
- Java 21 - linguagem principal do projeto
- JavaFX 21 – criação da interface gráfica
- CSS – estilização da interface
- 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
- OpenWeather API – dados climáticos
- Gson – manipulação de JSON
- JDeploy – publicação desktop
- A aplicação pode ser instalada diretamente através do JDeploy: Study Scheduler
- Ou pode ser instalada e aberta pelo terminal (Windows: pressione Win + R, digite cmd e aperte Enter / macOS/Linux: abra o aplicativo “Terminal”):
O JDeploy utiliza o Node.js para instalar e executar a aplicação.
- Para verificar se você já tem Node.js, digite no terminal:
node -v - Depois digite:
npm -v - O resultado esperado é algo parecido com:
v24.0.0
11.0.0 - Caso não apareça, acesse o site e baixe o instalador para o seu sistema, execute o instalador e siga os passos padrões (Next → Next → Finish)
- Após instalar, feche e abra o terminal novamente e rode:
node -v
npm -v
- No terminal:
npm install -g jdeploy@latest - Resultado esperado: “added packages” sem mensagens de erro
- Execute no terminal:
npm install -g study-scheduler-annecgm - Depois:
study-scheduler - Resultado esperado: A janela do StudyScheduler será exibida na tela
- Problemas comuns:
- comando não reconhecido: feche e abra o terminal novamente
- erro relacionado ao JavaFX: reinstale a aplicação
- erro de permissões no Linux/macOS: execute o terminal como administrador ou utilize sudo
O projeto foi desenvolvido em Java 21, então essa versão é necessária.
- Como verificar se você já tem Java:
- Abra o terminal e 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:
- Windows: .exe
- macOS: .dmg
- 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
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
- Existem duas formas de baixar o projeto: pelo Terminal ou pelo Git Bash (Windows)
- Terminal: Navegue até a pasta onde deseja salvar o projeto. Exemplo: cd bootcamp
- 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
É 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:
- Windows:
mvnw.cmd clean install - macOS/Linux:
./mvnw clean install
- Se tudo der certo, você verá: BUILD SUCCESS
- Possíveis problemas:
- “java não reconhecido”: Java não instalado corretamente
- erro de permissão no Linux/macOS: rode:
chmod +x mvnw
- 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.
- Ainda na pasta do projeto, dentro do terminal, digite:
- Windows:
mvnw.cmd javafx:run - macOS/Linux:
./mvnw javafx:run
- O que vai acontecer?
- O Maven vai iniciar o JavaFX
- A aplicação será carregada
- A janela do StudyScheduler será exibida
- Problemas comuns:
- “java não reconhecido”: Java não instalado corretamente
- erro de permissão (Linux/macOS):
chmod +x mvnw - erro relacionado a JavaFX: rode novamente:
mvnw.cmd clean install
- Execute no terminal, dentro da pasta do projeto:
- Windows:
mvnw.cmd test - macOS/Linux:
./mvnw test
- O que vai acontecer?
- O Maven vai procurar arquivos na pasta: src/test/java
- Vai compilar os testes
- 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?
- Criação de tarefas
- Marcar tarefa como concluída
- Verificar se tarefa está atrasada
- Persistência básica
- Integração com API de clima
- Fluxo de comunicação HTTP
- Comandos:
- Windows:
mvnw.cmd checkstyle:check - macOS/Linux:
./mvnw checkstyle:check
- O que vai acontecer:
- O Maven analisa todo o código do projeto
- Verifica se está seguindo padrões de escrita, organização e boas práticas definidos
- 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
1.0.7 – versão com integração de API climática, reformulação visual da interface e deploy desktop via JDeploy
Anne Caroline Gonçalves de Mesquita