IntroAct

Aline Mendonça Mayerhofer Manhães, Bárbara Alencar de Araujo Pereira e Raony Togneri Gomes

Descrição

O IntroAct, Introcomp Activities, foi idealizado como uma plataforma de atividades complementar e auxiliar ao curso Introcomp, oferecido gratuitamente por alunos da Ufes anualmente, cujo objetivo é democratizar o acesso ao mundo da programação por meio de aulas de Python. Por ser uma plataforma online, o IntroAct possibilita que não somente os alunos do Introcomp sejam beneficiados com tais atividades, mas também qualquer pessoa que queira aprender Python de forma descontraída.

O IntroAct disponibiliza exercícios curtos e objetivos em Python, para tornar o aprendizado constante. O objetivo é ser uma “revisão de bolso” que mantenha conhecimentos essenciais de programação frescos na mente do usuário a todo e qualquer momento que ele quiser, servindo como complemento de um curso mais intensivo, como o Introcomp. As atividades do IntroAct possuem perguntas de múltipla escolha, exercícios de correlação, escrita e preenchimento de lacunas sobre conceitos fundamentais da programação, como estruturas condicionais e loops.

Diagrama de classes do domínio do problema

Ferramentas escolhidas

• Backend: Spring Boot
• Frontend: Bootstrap
• Build: Maven
• Versionamento: Git e GitHub
• Testes: JUnit e Mockito

Frameworks reutilizados

• Spring Boot
• Bootstrap
• Thymeleaf

Como executar o sistema

Requisito

• Java (versão 21)
• Maven:

Baixe pelo site

https://maven.apache.org/download.cgi

Ou, se você tiver Ubuntu, execute o comando

sudo apt install maven

Instruções de Execução

1. Clone o repositório:

git clone https://github.com/barbara-aper/IntroAct.git

2. Entre na pasta do repositório:

cd IntroAct

3. Execute:

mvn spring-boot:run

4. Abra o server no seu navegador com o link para a porta 8080:

http://localhost:8080/

Como gerar a documentação do código

• JavaDoc:

Execute o comando abaixo dentro da pasta que contém o arquivo pom.xml

mvn javadoc:javadoc

Depois, para visualizar a documentação, abra o arquivo index.html

target/site/apidocs/index.html

Como testar o código

• JUnit e Mockito:

Execute o comando abaixo para executar os testes automaticamente

mvn test

Makefile

Para facilitar a execução e funcionamento do sistema, alguns comandos bastante utilizados foram salvos no Makefile.

Primeiramente, lembre-se de instalar o Makefile em seu computador.

Para Linux, execute em seu terminal:

sudo apt-get install make

Uma vez que o Makefile já está instalado, você pode executar os comandos abaixo.

Para executar o sistema:

make run

Para abrir a página web do projeto:

make oppage

Para gerar a documentação do projeto:

make doc

Para abrir a documentação do projeto:

make opdoc

Para executar os testes automáticos do sistema:

make test

Links úteis

1. Figma
2. Proposta de Projeto
3. Github do projeto
4. Vídeo sobre o projeto
5. Página local de testes