Estamos de volta, Bunkers!

Visto que nesta semana ocorreram os conselhos de classe nós não tivemos aula em alguns dias e em outros apenas de forma remota ou com carga reduzida, nós conseguimos focar um pouco mais no projeto realizando ajustes na aplicação e documentação conforme haviam sido levantados por nós e pelos professores a partir das entregas do bimestre e da PoC.

Decidimos então que durante essa semana trabalharíamos nestes ajustes e para a próxima iniciaremos uma nova sprint, trabalhando em outras histórias de usuário dos épicos de Gestão de Perguntas e Gestão de Respostas, além de finalizar a história de autenticação de usuários e iniciar o épico de Gestão de Eventos, visando a próxima entrega que já seria uma versão inicial do projeto. 

Falando sobre os ajustes na documentação, adicionamos o Heroku no desenho da arquitetura, criamos uma sessão para descartes/mudanças, criamos os QR Codes dos links do deploy e enviamos o código inicial da documentação no SVN. 

No front-end da aplicação, confirmamos a criptografia e passamos as URLs para análise no SSLabs (o front-end recebeu notas A e a API, notas A+), arrumamos o deploy da aplicação Web (estudando também novas plataformas para ter um plano B), ajustamos as rotas do react-router-dom, adicionamos as requisições da API e o redux. Já no Back-end, foi adicionado o cadastro de tag, a busca de perguntas por id, verificações de usuário para algumas requisições, implementação do cargo de administrador na API, totalizador de curtidas na pergunta e de respostas na pergunta, além da inclusão dos primeiros testes unitários. Foram alteradas as URI das requisições e a API agora faz uso do Swagger 3 para a documentação, com autenticação na própria interface.

As tarefas realizadas por cada componente da equipe durante a semana foram:

• Anaí e Julia - Realizaram os ajustes e configurações na documentação
  
• Jamilli - Arrumou o deploy da aplicação Web, ajustou as rotas e iniciou a captura de token de usuário via JWT.
  
• José - Adicionou as requisições faltantes da API no front-end e o redux.
  
• Kaiky - Adicionou os ajustes e alterações no back-end e banco de dados. 

Por: Julia Romualdo

Segundo a bíblia do Ivan, o vídeo do Gource deve cumprir as seguintes configurações:

• Alterar os userid do repositório por nomes dos participantes;
• Colocar uma imagem distinta e especifica para cada usuário;
• Utilizar opção –key;
• Utilizar as opções de caption para registrar as principais mudanças feitas no repositório;
• Os vídeos devem ter no máximo 1 minuto para cada bimestre; 

 Borá lá trabalhar!

1. Instalação

Para instalar o Gource é só clicar aqui (pode confiar que não é vírus).

Use este tutorial encontrado no YouTube para instalar o ffmpeg, ele serve para converter o vídeo em .mp4, vamos entender isso melhor mais pra frente.

✋ É importante que você verifique se as variáveis de ambiente estão devidamente configuradas, caso contrário o terminal irá reclamar quando você começar a rodar os comandos.

2. Testando 1, 2, 3 

Clone o repositório SVN da sua equipe e cole na área de trabalho ou em uma pasta de fácil acesso, faça o passo a passo localmente, nunca dentro do repositório oficial da disciplina.

Abra o terminal local ou cmd → para isso, aperte SHIFT + Botão direito do mouse e vá até a opção "Abrir o PowerShell aqui" ou "Abrir janela de comando aqui".

Digite gource e aperte Enter

Apareceu um vídeozinho?????? 

Boooa, o Gource foi instalado corretamente, mas como alegria de Ifiano dura pouco, aperte ESC para sair pois ainda faltam os requisitos da bíblia.

 3. Alterando o log

Vamos precisar criar um log, para isso execute o seguinte comando usando o nome da sua equipe:

--output-custom-log BunkaBytes

Após executar o comando, volte na pasta clonada e veja que um arquivo foi criado.

Abra este arquivo em um editor de texto de sua preferência e altere o prontuário correspondente a cada componente da equipe por seu primeiro nome, então vamos disso:

1649709679|sp1234567|A|/A2022-PDS-SEG/Bunka_Bytes/Documentos/AnaliseProjetosAnteriores.pdf
1649709679|sp7654321|A|/A2022-PDS-SEG/Bunka_Bytes/Documento/IFriends_PropostaInicial.pdf

Para isso:

1649709679|Anai|A|/A2022-PDS-SEG/Bunka_Bytes/Documentos/AnaliseProjetosAnteriores.pdf
1649709679|Jose|A|/A2022-PDS-SEG/Bunka_Bytes/Documento/IFriends_PropostaInicial.pdf

 ✋ Dica: No bloco de notas padrão do Windows, use o Ctrl+H para localizar e substituir as linhas mais rápido.

Não é obrigatório, mas para você que prefere ir verificando se as coisas estão acontecendo certinho conforme estão sendo desenvolvidas, rode o seguinte comando para começar a ver a mágica acontecendo - lembre-se de que é com o nome da sua equipe:

 gource BunkaBytes

4. Colocando vossos belos rostos no vídeo

Crie uma pasta "Imagens", "Avatares" ou algo do tipo dentro do seu repositório clonado e coloque dentro dela uma foto correspondente a cada membro da equipe, recomendamos que utilizem o formato png ou jpeg. O nome da imagem deve ser idêntico ao nome que foi inserido anteriormente no log. 

Execute o seguinte código para verificar se funcionou:

gource --output-custom-log BunkaBytes --key --user-dir Imagens

5. Criando o Caption

Crie um arquivo de caption, nele deve constar os commits mais importantes dos que estão no log, porém ao invés do nome do arquivo, após o pipe ( | ) descreva o que foi feito, exemplo:

    1651981117|Jose|M|/A2022-PDS-SEG/Bunka_Bytes/Desenvolvimento

6. Gerando o vídeo

 Não existe um tempo padrão ou pré-definido pelo Gource, o ideal é você utilizar as flags e ir testando, as que utilizamos são:

--caption-duration 5 → define o tempo para cada caption

--max-file-lag 5 → define o tempo máximo para cada caption

Para gerar o vídeo em si, nós basicamente vamos juntar todos os comandos e flags já citados aqui, ficando mais ou menos assim:

gource BunkaBytes --key --user-image-dir Imagens --caption-file caption --caption-duration 5 --max-file-flag 5 -o gource.ppm 

 ✋ Atenção: veja o vídeo rodando até o final, espere que a janela feche automaticamente, caso você pressione ESC e saia antes da execução terminar, o vídeo será gerado até aquele momento apenas.

7. Convertendo para mp4

Aqui entra a parte do ffmpeg, é fundamental que ele esteja instalado e com as variáveis de ambiente devidamente configuradas, caso contrário não irá funcionar. Mas se tudo estiver certinho basta digitar o seguinte comando:

ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i gource.ppm -vcodec libx264 -preset medium -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 gource.mp4

8. Conclusão

Volte até a pasta e veja que o vídeo estará convertido em .mp4 e você pode visualiza-lo com qualquer reprodutor de vídeo.

E prontinho! o vídeo está pronto e já pode ser publicado no YouTube.

Um dos primeiros itens necessários para iniciar os trabalhos na disciplina de PDS é  que "após a criação da pasta no repositório Subversion um arquivo equipe.yaml deve ser criado com os dados da equipe e projeto de acordo com modelo no repositório". Estes dados nada mais são do que aqueles existentes na página Blogs de Trabalhos do Dicas Ivan, mas para que os trabalhos criados sejam expostos nesta página é preciso seguir alguns critérios na criação do arquivo, e o primeiro deles é a utilização de um validador de arquivos com extensão .yaml, isto é, o yamllint.

Diante da dificuldade de alguns colegas em validar o arquivo e após fazer algumas pesquisas sobre o validador, percebi que a maior parte dos conteúdos sobre o assunto está em inglês e, arquivos dessa natureza possuem muitas especificações minuciosas para serem validadas, e muitas vezes a documentação do yamllint não as deixa tão claras ao leitor. Por isso, resolvi compartilhar um pouco do que entendi sobre o processo de validação do arquivo, o que inclui a instalação do validador, erros comuns após a validação e a espera até que o projeto apareça na página de Blogs de Trabalhos.

 Estamos de volta, Bunkers!

Podendo respirar um pouco mais após a intensa semana de entrega de atividades que tivemos durante a semana passada, iniciamos os trabalhos novamente com a reunião de retrospectiva referente a entrega da PoC, com isso chegamos as seguintes conclusões: do que foi bom, consideramos a entrega da API completa;  para o que foi ruim, por outro lado, consideramos a falta de tempo, pois por mais que soubéssemos como desenvolver um requisito, como a internacionalização ou o vídeo de demonstração, não sobrou tempo para fazer; e por último, outro problema, enfrentado não apenas por nossa equipe mas de maneira geral na turma, foi a incerteza e a definição errada que construimos sobre a PoC a partir de experiências anteriores, por isso percebemos que não conseguimos definir o que seria extremamente essencial para essa entrega e pode ser que tenhamos focado mais em coisas adicionais do que no principal. Assim, como plano de ação escolhemos que precisamos definir melhor o que é simples e objetivo para nossas entregas, para evitar que tenhamos confusões desnecessárias que acabem dificultando a entregarmos o que era necessário.

Os professores também realizaram alguns apontamentos a partir das nossas entregas relativas do primeiro bimestres, para que possamos realizar os alinhamentos necessários, tais como: representar o Heroku na arquitetura, postar os vídeos da apresentação da PoC no YouTube, realizar commits com mais frequência e enviar os arquivos do LaTeX que estamos usando no Overleaf.

Além disso, os professores separaram uma parte da aula para assistirmos a alguns projetos dos alunos da turma 231 em PJI, e permitiram que fizemos apontamentos e sugestões para os colegas sobre suas ideias.

Tendo realizado esses dois momentos de alinhamento, a equipe documentou tudo, organizou as tarefas e ajustes que deveriam ser realizados durante a semana e partimos para os ajustes. Conseguimos enviar e ajustar o que faltava para o primeiro bimestre, como a questão do Gource, e ainda incluímos alguns requisitos que faltavam na aplicação e na API (como a inclusão do Swagger UI e criptografia da autenticação). Como a próxima semana será de conselhos de classe, a equipe espera poder trabalhar mais no projeto e dar continuidade no desenvolvimento do mesmo, além de reavaliarmos o que for necessário de acordo com os demais feedbacks dos professores (que ainda serão feitos sobre a PoC).

Por: Julia Romualdo e Jamilli Gioielli

 Estamos de volta, Bunkers!

 Estamos de volta, Bunkers!

Esta semana devido a problemas na infraestrutura do encanamento do campus IFSP não tivemos aulas de maneira presencial e poucos professores ministraram no formato EaD, aproveitamos então o plantão de segunda-feira com os orientadores para alinharmos o fluxo de usuário e o protótipo para a PoC. No decorrer da semana utilizamos os horários que seriam destinados às aulas para realizarmos as tarefas de desenvolvimento da PoC (desenvolvimento, documentação e apresentação), para isto a equipe ficou organizada da seguinte maneira:

• Anaí - Realizar ajustes finais no prototipo e ajustar a documentação.
  
• Jamilli e José - Configurar o ambiente e desenvolver o Front-End.
• Julia - Realizar ajustes na documentação e gerar vídeo do Gource.
• Kaiky - Configurar o ambiente e desenvolver Back-End e Banco de Dados.
  

Para a próxima semana a equipe tem como objetivo apresentar a Prova de Conceito e realizar reunião retrospectiva sobre o desenvolvimento da PoC.

Por: Julia Romualdo

 Estamos de volta, Bunkers!

Iniciamos esta semana validando com os professores as atividades que a equipe esteve realizando desde a semana passada, fomos orientados quanto a melhor organização dos tópicos do documento, a remover algumas histórias dos épicos para a PoC, - pois alguns pontos estavam fugindo da ideia da PoC, que é provar que o conceito principal, ou seja, o fluxo principal da aplicação está funcionando -, a realizar a entrega do épico de Gestão de Eventos, na PoC, apenas se sobrar tempo, ajustar o diagrama de entidade relacionamento e o diagrama de casos de uso. Aproveitamos este momento ainda em aula para iniciar as configurações do Gource, pensando em futuras entregas da disciplina.

Devido ao final de bimestre, a equipe esteve ocupada com as atividades de outras disciplinas e não conversou muito durante esta semana, mas os componentes continuaram no desenvolvimento - visando o termino - das atividades propostas na semana passada, organizadas da seguinte forma:

• Anaí -  Terminar a prototipagem das telas.
  
• Kaiky e José - Realizar os ajustes na modelagem de dados.
• Jamilli - Terminar a prototipagem das telas e ajustar os tópicos de gerenciamento e metodologias da documentação.
  
• Julia - Adicionar os apêndices na documentação e pesquisar sobre o Gource.

Para a próxima semana a equipe tem como objetivo desenvolver a Prova de Conceito e a documentação relacionada a mesma.

Por: Julia Romualdo

 Estamos de volta, Bunkers!

Nesta semana, iniciamos a aula de segunda-feira de forma bem produtiva, pois conversamos bastante com os orientadores a respeito das próximas sprints a serem planejadas e executadas pela equipe. Assim partimos para a criação do backlog do produto com o uso das histórias de usuário, depois definimos as tarefas da semana já nos planejando para os três épicos a serem elaborados para a entrega da Prova de Conceito, sendo eles: Gestão de Perguntas, Gestão de respostas e Gestão de Eventos.

Além disso, aproveitamos o feriado de Tiradentes para nos reunirmos através da plataforma Discord, com o objetivo de terminar a definição das histórias de usuário, neste momento muitos pontos sutis sobre a aplicação, que poderiam se tornar inimigos da equipe futuramente, foram levantados e anotados para discutir com os professores. Também votamos por meio do Planning Poker - descrito pela metodologia Scrum - para entendermos sobre uma estimativa de esforço para que cada história seja concluída. Junto a isso, também podemos elencar alguns requisitos não funcionais e regras de negócio.

Desta forma, as tarefas realizadas pela equipe durante esta semana foram organizadas da seguinte forma:

• Anaí e Jamilli - Iniciar a prototipagem das telas.
• Kaiky e José - Iniciar a modelagem de dados.
• Julia Romualdo - Iniciar os ajustes na documentação.

Para a próxima semana, além de dar início as tarefas da sprint, a equipe tem o objetivo de terminar as tarefas de planejamento e apresenta-las aos orientadores para que possamos esclarecer dúvidas e saber os pontos a serem melhorados.

 Por: Julia Romualdo

 Estamos de volta, Bunkers!

Iniciamos esta semana com a apresentação da proposta inicial da comunidade IFriends aos nossos professores e colegas de classe, dos quais recebemos orientações e feedbacks. Neste mesmo cenário, também participamos da apresentação das outras equipes e compartilhamos nossos feedbacks aos mesmos.

Após a apresentação, a equipe se reuniu na biblioteca do IFSP para realizar uma retrospectiva, com o objetivo de avaliar o funcionamento da equipe durante a intensa semana de trabalhos que tivemos para realizar a entrega da proposta inicial. Aproveitamos este momento, para decidir os pontos a serem melhorados na apresentação para realizarmos a gravação e entrega do vídeo da proposta e também ajustamos alguns pontos que faltavam ser encaixados sobre as tecnologias que serão utilizadas no projeto.

Além disso, aproveitamos o feriado para revisar alguns conceitos que tínhamos dúvidas e procurar possíveis melhorias para nossa apresentação e documentação. Uma das coisas que percebemos era que ainda precisávamos validar o arquivo equipe.yaml no yamllint, já que ele não estava sendo refletido na página de Blogs de Trabalhos, por isso aproveitamos para ajustá-lo de acordo com os apontamentos que foram dados pelo validador.

De todo modo, a equipe tem como meta para a próxima semana a atualização das fontes do projeto de acordo com o feedback que será dado pelos demais colegas e pelos professores após a apresentação da proposta. Além disso, pretendemos postar o vídeo da proposta - já com as melhorias - e também entregar nossas avaliações sobre as demais equipes.

Por isso, contamos com os feriados para adiantar o máximo de atividades possíveis e já pensar em alguns itens de backlog para que possamos iniciar a primeira sprint com o cronograma do projeto já bem definido. Pensando nisso também, a equipe não se dividiu como na semana anterior para a execução das tarefas, já que neste primeiro feriado focaremos juntos em tratar das melhorias, estudar as tecnologias propostas e trabalhar no planejamento do projeto.

Por: Julia Romualdo e Jamilli Gioielli

 Estamos de volta, Bunkers!

No inicio desta semana, realizamos a pesquisa de viabilidade da nossa proposta inicial da comunidade, para isto, elaboramos um formulário via Google Forms, que ficou disponível para receber respostas de segunda-feira (04/04) à sexta-feira (08/04) e todos os integrantes da equipe ficaram responsáveis por enviar o endereço de compartilhamento - link - nos grupos de WhatsApp para os alunos da instituição - público-alvo da nossa proposta - respondessem a dez perguntas e compartilharem algumas experiências como alunos do IFSP que ajudassem a equipe a compreender se a proposta era ou não viável.

Ainda nesta semana, recebemos dos professores as orientações para apresentação da proposta inicial, juntamente com a entrega da documentação e estudo de dois projetos anteriores. Para realização desta tarefa, durante a semana a equipe se organizou da seguinte forma:

• Anaí - Criou branchmarketing para a aplicação e estudou o projeto WebLab.
  
• Jamilli - Organizou as atividades a serem realizadas pela equipe e estruturou as documentações.
• José - Estudou as tecnologias a serem utilizadas no projeto e também do projeto Monitorando.
• Julia -  Compilou dados da pesquisa de viabilidade de proposta e estudou o  projeto Monitorando.
• Kaiky - Estudou as tecnologias a serem utilizadas no projeto e também do projeto WebLab.

Estamos de volta, Bunkers!

Nesta semana, trabalhamos na viabilidade da nossa proposta. Em aula, discutimos com os professores as funcionalidades que a comunidade pode ter, encontramos uma solução para validar os alunos cadastrados nela, enviando um e-mail de confirmação apenas ao e-mail institucional, que é de posse dos alunos, garantindo assim que os usuários sejam apenas alunos do instituto e por fim, falamos também sobre uma segunda proposta da equipe, que os professores gostaram bastante e deram forte impulso em desenvolve-la por atingir um grupo maior de usuários e ser algo que todos precisam cotidianamente, que é um sistema baseado em controlar gastos e auxiliar na organização financeira.

Entretanto, optamos por continuar com a comunidade, a qual batizamos com o nome: IFriends, principalmente porque é mais próximo da nossa realidade como alunos do instituto e por não termos experiência em desenvolvimento de aplicações mobile, o modelo que enxergamos ser o ideal para a criação da segunda proposta. E como análise prática da viabilidade do IFriends, elaboramos um formulário, via Google Forms, para no início da próxima semana, enviarmos aos nossos colegas e alunos do instituto com o intuito de investigar se eles fariam uso da comunidade.

Falando agora sobre a nossa organização como equipe, ainda estamos nos adaptando com nossos horários entre estudos, trabalho e locomoção, então nosso foco será realizar reuniões rápidas e objetivas principalmente nos horários disponíveis antes das aulas começarem.

Resumo das atividades de cada membro da equipe:

• Anaí - Elaborou a criação do formulário da pesquisa de viabilidade.
  
• Jamilli - Organizou as atividades a serem realizadas pela equipe.
• José, Julia e Kaiky - Trabalharam em melhorias de layout e postagens do blog.

Por: Julia Romualdo

Estamos de volta, leitor!

No início dessa semana, voltamos às atividades presenciais e tivemos um primeiro contato com a disciplina neste formato. A partir daí, separamos as 5 ideias que mais se destacaram do nosso Brainstorm da semana anterior e as compartilhamos com os professores. Recebemos algumas sugestões sobre a ideia de comunidade e nos foi recomendado documentar as ideias para enviar no ambiente do Moodle da disciplina. 

Tendo isso em vista, precisamos nos reunir durante os próximos dias para passar a construção dos nossos pensamentos em formato textual e explicativo. Entretanto, enfrentamos algumas dificuldades nesse sentido, estando a maioria delas em torno do curto tempo que temos entre trabalho e escola para fazer as reuniões. Tentamos conversar na hora anterior às aulas, mas percebemos que faltava apenas documentar melhor o que havíamos conversado. Não foi possível realizar isto na escola devido aos problemas de conexão de rede, então optamos por fazermos aos poucos durante a semana e nos reunirmos depois da aula, via Discord, para revisar o conteúdo. De todo modo, conseguimos fazer a entrega das duas tarefas da semana no Moodle.

Nossos objetivos para próxima semana são: definir a proposta para o projeto com base no feedback dos professores e planejar melhor nossos dias e horários para reuniões.

Por:  Jamilli Gioielli