Forem: Sofia de Alcantara

JIRA - Padrões de Escrita de Issues

Sofia de Alcantara — Wed, 18 Sep 2024 20:18:11 +0000

Objetivo do Documento: Detalhar como a escrita de Epics, User Stories e Subtasks no Jira devem se feita, tomando como base a documentação de Análise. Como exemplo, usaremos os Casos de Uso "Cadastrar Resolução", "Cadastrar Modalidade" e "Cadastrar Nível".*

Quais são os tipos de itens (issues) no Jira?

O Jira tem diferentes tipos de itens para categorização do trabalho. Como issues default, nessa ordem de hierarquia, temos:

Epic: Representa um grande volume de trabalho. Correspondem aos Casos de Uso.
User Story (US): Representa um requisito expresso, comumente a partir da perspectiva do usuário. Seu objetivo é articular como um recurso de software pode gerar valor para o cliente. Correspondem aos Eventos dos Casos de Uso.
Subtask: Representa a divisão mais granular do trabalho necessário para concluir um item padrão.

O que são itens vinculados?

Além da relação pai-filho entre itens, também é existem as dependências entre as tarefas. Essa associação pode ser representada com facilidade no Jira ao vincular itens. As associações prontas para uso são:

bloqueia/é bloqueado por
clona/é clonado por
duplica/é duplicado por
Relacionado a

Sendo as dependências 1 e 4 as de maior interesse. Todos os itens vinculados são exibidos em cada item. Isso torna mais fácil para as equipes navegar entre o trabalho conectado e exibir as dependências.

O que são itens pai e filho?

Pai e filho são termos que descrevem um tipo de relacionamento entre itens:

Um item pai é um item que fica um nível acima de outro item, por exemplo, uma US composta de subtarefas.
Um item filho é um item que fica um nível abaixo de outro item, por exemplo, uma US que pertence a um Epic.

O relacionamento entre pai e filho não se limita a tipos de itens específicos. Em vez disso, qualquer tipo de item pode ser um item de pai e filho. A única exceção são as subtarefas, que só podem ser um item filho, já que não há nenhum tipo de item abaixo dela na hierarquia.

Exemplo de Construção de Tarefas

Tomando como base a documentação "Especificação de Análise – Módulo Cadastro de Modalidades de Bolsas", veja os casos de usos que serão utilizados como exemplo:

ID	Caso de Uso	Eventos
UC01	Controlar Modalidade de Bolsa	Listar Modalidade, Incluir Modalidade, Criar Versão de Modalidade, Alterar Versão da Modalidade, Ativar Versão da Modalidade, Consultar Modalidade, Excluir Versão de Modalidade, Desativar Modalidade
UC02	Cadastrar Resolução	Listar Resolução, Incluir Resolução, Alterar Resolução, Consultar Resolução, Excluir Resolução
UC03	Cadastrar Nível de Bolsa	Listar Nível, Incluir Nível, Alterar Nível, Consultar Nível, Excluir Nível

Atente-se as correspondências: Casos de Usos tornam-se Epics, que são comuns a todas as equipes.
Já os Eventos dos Casos de Uso tornam-se Histórias de Usuário;

As subtarefas são específicas para cada time (FrontEnd, BackEnd, Design, Análise, etc...) e devemos utilizar a propriedade "Categorias" para indicar o time responsável pela subtarefa em questão. Veja o exemplo abaixo:

WIP: analisando o trabalho em progresso | Métricas Ágeis, Parte 1

Sofia de Alcantara — Fri, 22 Mar 2024 18:22:29 +0000

“Metrificar é o primeiro passo para o controle e eventualmente para a melhoria. Se você não consegue medir algo, você não consegue entendê-lo. Se você não consegue capturá-lo, você não consegue controlá-lo. Se você não consegue controlá-lo, você não consegue melhorá-lo”. - H. James Harrington

É assim que o livro Métricas Ágeis: Obtenha melhores resultados em sua equipe de autoria de Raphael Donaire Albino inicia. Esse artigo tem por objetivo compartilhar minhas principais percepções acerca das informações trazidas pelo autor, compartilhando sobre o conceito de WIP (Work In Progress) descrito no Capítulo 2 do livro citado.

Métricas: o que são e pra que servem?

Em um contexto de desenvolvimento de software, métricas referem-se a medidas quantitativas ou qualitativas que são usadas para avaliar diferentes aspectos do processo de desenvolvimento, do produto em si ou da equipe de desenvolvimento. Essas métricas são utilizadas para entender, monitorar e melhorar diversos aspectos do ciclo de vida do software. O autor destaca como atributos de uma boa métrica de negócio as seguintes características:

Comparabilidade

Uma boa métrica de negócio deve ser comparável.

Isso significa que você deve ser capaz de comparar os valores da métrica em diferentes períodos, como semana passada, mês passado, ano anterior, etc. Essa comparação permite entender se as conversões estão crescendo ou diminuindo ao longo do tempo, fornecendo insights valiosos sobre o desempenho do negócio.

Compreensibilidade

As métricas de negócio devem ser compreensíveis para todos os envolvidos. Todos na equipe devem ser capazes de compreender o que a métrica representa.

Relevância

As métricas de negócio devem ser relevantes para o comportamento e as atividades do negócio. Se uma métrica muda e você não entende por que mudou ou o que fazer com essa informação, então você pode ter uma métrica ruim. As boas métricas devem ser capazes de orientar ações e decisões, fornecendo insights claros sobre o desempenho do negócio.

Por fim, uma boa métrica de negócio deve ser uma relação ou taxa, em vez de um número absoluto. Por exemplo, em vez de apenas fornecer a quantidade total de usuários, é mais útil fornecer a porcentagem de usuários ativos diários. Razões e taxas são comparativas, o que ajuda na tomada de decisões informadas.

WIP: Work In Progress

A sigla em inglês WIP significa trabalho em progresso e corresponde a nível de processo, toda e qualquer unidade de trabalho parcialmente finalizada que localiza-se em diferentes pontos do fluxo de desenvolvimento.

"Para um item de trabalho deixar de contar como WIP, é necessário determinar um ponto de saída do processo que pode ser definido como a entrega de uma correção a um usuário final, ou a aprovação de uma funcionalidade por parte do gestor de produto. [...] O ponto de saída de um sistema Scrum nada mais é do que o trabalho aprovado na cerimônia de Review."

Vantagens do controle de WIP

Assim, podemos pontuar algumas vantagens obtidas ao medir e controlar o WIP do time, sendo elas:

Controle de sobrecarga: Evita que a equipe assuma mais trabalho do que pode gerenciar simultaneamente.
Identificação de gargalos: Ajuda a equipe a localizar e resolver bloqueios que impedem o progresso do trabalho.
Foco na entrega: Mantém a equipe concentrada em concluir tarefas antes de iniciar novas, aumentando a eficiência.
Melhoria da previsibilidade: Permite uma melhor estimativa do tempo necessário para concluir iterações futuras.
Otimização do tempo de ciclo: Ajuda a reduzir o tempo necessário para concluir e entregar funcionalidades, melhorando a eficácia do desenvolvimento.
Priorização eficaz: Facilita a priorização de trabalho com base na capacidade da equipe, garantindo a entrega de valor de forma consistente.

Fonte: Leanguru

Independente da forma a ser implementado o WIP, é de suma importância que os limites em cada etapa do fluxo sejam definidos após um acompanhamento durante um conjunto de sprints. Isso permite que a equipe compreenda melhor a capacidade de trabalho de cada etapa, identifique gargalos e ajuste os limites de acordo com a capacidade real do time.

Em resumo, medir e controlar o Work In Progress (WIP) é essencial para garantir eficiência, qualidade e previsibilidade no desenvolvimento de software. Ao adotar métricas claras e compreensíveis, como o WIP, o time pode identificar e superar obstáculos, mantendo o foco na entrega de valor aos clientes.

Tutorial: Utilizando o Clockify para medir a produtividade do time

Sofia de Alcantara — Thu, 14 Mar 2024 17:38:50 +0000

Introdução

Esse artigo tem por objetivo apresentar as principais funcionalidades da ferramenta Clockify e como utilizá-la visando aprimorar os registros de produtividade do time.

Integrando o Clockify com o Jira

A integração entre as duas ferramentas é simples e o plug-in Clockify para Jira está disponível nos aplicativos Jira para Web, Android, iOS, bem como aplicativos desktop macOS. Vamos aos passos:

Instale o aplicativo Clockify no Jira Cloud

Baixe o aplicativo no Atlassian Marketplace (certifique-se de ter instalado o aplicativo desenvolvido por CAKE.com).
Clique no botão Obter agora e selecione Nuvem.
Escolha um site na lista suspensa onde você deseja instalar o aplicativo e clique no botão Instalar aplicativo app.

Chave de API

A primeira vez que você clicar no botão do cronômetro Clockify, será solicitada a chave de API do Clockify. Essa chave é usada para conectar sua conta Clockify à sua conta Jira.

Faça login na sua conta Clockify e vá para a página Configurações de Perfil (ou clique no link Obter chave de API na sua questão do Jira e você será redirecionado automaticamente para as configurações do perfil Clockify).
Na parte inferior desta página, clique no botão Gerar para gerar sua chave de API.
Copie a sua chave para o campo de chave de API em sua questão do Jira.

Depois de inserir a chave, ela não será solicitada novamente. No entanto, se você, em algum momento, gerar uma nova chave de API para sua conta Clockify, precisará atualizá-la para corresponder à do JIRA também, redefinindo-a.

Time

Agora, é necessário adicionar os membros da equipe.

Convidando membros

Somente administradores podem convidar novos usuários para um workspace. Para isso, você deve:

Clique em Team na barra lateral principal à esquerda.
Clique em Add member no canto superior direito.
Digite o e-mail da pessoa que você deseja convidar.
Clique em Add. Se desejar convidar vários usuários de uma vez, insira os e-mails nos campos designados, um abaixo do outro, ou copie e cole a lista de e-mails. No plano gratuito, você pode inserir até 5 e-mail ao mesmo tempo (mas pode convidar um número ilimitado de usuários no total).

Grupos

O Clockify também permite a criação de grupos, que você pode definir por exemplo a partir das alocações dos membros no seu projeto (existe a funcionalidade de Roles - cargos, em inglês -, mas só está disponível em planos pagos). Além disso, para realizar edições no time, é necessário o papel de administrador do projeto.

Rastreando o tempo das tarefas

Ao clicar no cronômetro do Clockify, você poderá escolher entre o modo de cronômetro e o manual, que você pode usar para rastrear seu tempo.

Modo de cronômetro

Certifique-se de estar na guia Cronômetro e poderá iniciá-lo. Quando terminar, clique no botão Parar e sua entrada de tempo será registrada. Se você tiver vários espaços de trabalho (workspaces) no Clockify, poderá selecionar o espaço de trabalho desejado antes de iniciar o cronômetro no Jira. É importante atentar-se a esse detalhe, uma vez que se registradas no local errado, as horas "se perdem" dificultando o registro das métricas de produtividade.

O cronômetro sincroniza com sua conta Clockify em todos os dispositivos e pode ser interrompido no Jira ou em qualquer aplicativo Clockify (navegador, celular ou desktop).

Se você começar a rastrear o tempo em outro ticket do Jira sem interromper o cronômetro anterior, o cronômetro da primeira questão será interrompido e salvo automaticamente e um novo cronômetro para a segunda questão será iniciado.

Modo manual

Se você esquecer de iniciar o cronômetro ou preferir preencher todas as suas horas de trabalho de uma só vez, poderá usar o modo manual. Certifique-se de estar na guia Manual e insira o tempo que você trabalhou na entrada de horas. Quando terminar, clique no botão Adicionar tempo e sua entrada de hora será registrada. Se você tiver vários espaços de trabalho no Clockify, poderá selecionar o espaço de trabalho desejado antes de adicionar a entrada de tempo.

O que é registrado no Clockify?

Quando o cronômetro iniciar, o Clockify selecionará automaticamente o nome do problema, a tarefa, o projeto e a etiqueta do Jira se existirem questões correspondentes no Clockify.

Se não houver projeto, tarefa ou tag do Jira correspondente ao Clockify, a integração poderá criá-lo automaticamente no Clockify. Para fazer isso, o usuário deve ter permissão para criar projetos, tarefas e tags no Clockify. Essas permissões podem ser configuradas nas configurações do espaço de trabalho.

Descrição – O Clockify pegará o número da chave e o nome da issue do Jira como uma descrição de entrada de tempo.
Projeto – seu projeto no Jira será selecionado como um projeto no Clockify.
Tarefa – a chave do problema do Jira onde você iniciou o cronômetro será selecionada como uma tarefa (subprojeto) no Clockify. Você pode alterar manualmente a tarefa na qual está trabalhando diretamente no Jira clicando no nome da tarefa e selecionando-a no menu suspenso. O rastreamento de tempo em subtasks no Jira será rotulada no Clockify como Subtarefa.
Etiquetas/Tags – correspondem aos tipos de questões (bug/tarefa/história) e etiquetas no Jira. Você pode adicionar mais etiquetas à sua entrada de tempo diretamente do Jira.

As informações sobre um Epic ou uma Sprint não serão registradas, no entanto, se você rastrear o tempo diretamente em um Epic no Jira, isso criará uma entrada de tempo no Clockify com a etiqueta Epic. Para que a integração escolha o projeto/tarefa/etiqueta correto, ele deve existir no Clockify ou você deve definir as permissões corretas nas configurações do espaço de trabalho no Clockify e garantir que todos os usuários possam criar novos projetos/tarefas/etiquetas.

Registro de trabalho

Quando você parar o cronômetro, a entrada será salva no Clockify e o registro de tempo será criado no log de trabalho do Jira (campo de tempo gasto). O registro de trabalho exibe uma linha do tempo de cada entrada registrada por todos para essa questão.

Se você editar/excluir uma entrada de tempo do registro de trabalho do Jira, observe que isso não será sincronizado com o Clockify, o que significa que uma entrada de tempo no Clockify não será atualizada/excluída. Da mesma forma, se você editar/excluir uma entrada de tempo no Clockify, essas alterações não aparecerão no Jira. Somente as entradas de tempo interrompidas em issues do Jira serão adicionadas ao registro de trabalho.

Relatórios

É possível visualizar as métricas de formas diversas. A aba Dashboard apresenta o tempo semanal total trabalhado, bem como as métricas do seu time. É importante atentar-se aos filtros disponíveis, não só na view de Dashboard como as seguintes.

Exportando relatórios

É possível exportar os dados e realizar o download de relatórios nos formatos PDF, CSV e Excel. O arquivo exportado pode conter os seguintes detalhes de entrada de tempo: projeto, cliente, descrição, tarefa, usuário, e-mail, tags, status faturável, data de início, hora de início, data de término, hora de término, duração (incluindo durante a noite), etc. Um arquivo PDF pode conter até 3.000 linhas.

Para uma exportação completa (com todas as entradas de tempo), vá para Detaild report, escolha o intervalo de datas mais longo e exporte os resultados. Você pode usar este arquivo para backup pessoal ou para importar entradas para outro espaço de trabalho do Clockify ou algum outro aplicativo.

Para exportar um relatório:

Vá para o relatório que deseja exportar.
Clique em Exportar.
Escolha o formato e o relatório será salvo automaticamente no seu computador.

Summary

Pela aba Summary, é possível compartilhar, printar e exportar para PDF ou Excel os dados de trabalho. Aqui também é possível utilizar filtros.

Quero registrar uma tarefa que não está presente no Jira, o que faço?

Em alguns casos, será necessário registrar tarefas que não estão disponíveis no backlog Jira. Você deve seguir os seguintes passos:

Vá até a aba Projects.
Acesse o projeto desejado clicando em seu nome. Uma tela parecida com essa será apresentada:

Para adicionar uma tarefa, basta escrevê-la no campo "Add new task" e clicar no botão ADD. Ela será salva automaticamente como uma tarefa do projeto em questão (no exemplo, seria salva como uma tarefa do workspace Slave One SCRUM).

Salva, a tarefa é apresentada também na aba Time Tracker onde pode ser editada. Vale ressaltar que a task fica disponível para todos do time, sendo possível o registro da atividade por mais de um membro.

Automatização no Jira: um guia básico

Sofia de Alcantara — Thu, 07 Mar 2024 21:00:22 +0000

Introdução

Este artigo visa fornecer insights sobre a automação de processos no Jira, bem como apresentar a integração da ferramenta com o GitLab. Os dados levantados levam coma base minha participação no projeto piloto Slave One, do LEDS, onde tive a oportunidade de explorar e implementar estratégias de automação que otimizaram a gestão do projeto.

Automação: pra que serve?

A automação tem como objetivo principal simplificar e agilizar processos repetitivos dentro de um projeto. Aplicando a automação em tarefas manuais, é possível reduzir erros, aumentar a produtividade da equipe e liberar recursos humanos para atividades mais estratégicas e de maior valor agregado. No contexto da gestão de projetos no Jira, a automação pode ser empregada para uma variedade de finalidades, tais como:

Automatizar fluxos de trabalho: Configurar regras de automação para mover automaticamente as tarefas de um estágio para outro do processo, com base em determinados eventos ou condições.
Atribuição de tarefas: Automatizar a atribuição de tarefas com base em critérios predefinidos, como especialidade ou carga de trabalho do membro da equipe.
Atualização de campos: Automatizar a atualização de campos específicos de uma tarefa quando determinadas ações são realizadas, economizando tempo e garantindo a consistência dos dados.
Integração com outras ferramentas: Automatizar a sincronização de informações entre o Jira e outras ferramentas utilizadas pela equipe, como o GitLab, garantindo uma colaboração eficiente e integrada.

Elementos das regras de automação

As regras de automação levam em consideração três principais elementos: acionadores/triggers que ativam a regra, condições/conditions que refinam a regra e ações/actions que realizam tarefas no seu site. No Jira, há templates que você pode utilizar para iniciar a automação do seu projeto. Acesse a biblioteca de templates do Jira aqui.

Acionadores (triggers)

Acionadores são o ponta pé de qualquer regra de automação. É a partir deles que a regra é iniciada e alguns deles podem ser configurados para inicialização manual com base em uma condição definida ou agendada. Veja a lista de acionadores disponíveis aqui.

Condições (conditions)

As condições, por sua vez, permitem que você reduza o escopo da sua regra. Se uma condição não for atendida, a execução da regra vai ser interrompida e nenhuma ação que segue a condição vai ser realizada. Veja a lista de acionadores disponíveis aqui.

Ações

Por fim, as ações implementam a regra, permitindo que você realize diversas tarefas, como editar um item, enviar uma notificação ou criar subtarefas. Veja a lista de ações aqui. Para entender melhor a definição de outros elementos igualmente importantes na automação como Ramificação, Agente da Regra, Status da Regra e Log de Auditoria, leia o overview do feito pelo Jira aqui.

Automações implementadas no Slave One

De acordo com as necessidades do projeto Slave One, foram criadas algumas automações. Você pode duplicá-las no seu projeto acessando Project settings -> Automation -> Create rule. Algumas foram criadas a partir de templates, então não deixe de conferir a biblioteca de templates do Jira. Vamos aos exemplos:

Fechar itens duplicados
Marca a história ou tarefa como "Concluído" quando todas as subtasks estão concluídas
Marca a história ou tarefa como "Em progresso" quando pelo menos uma subtask está em andamento
Quando todas as histórias estão concluídas, o Epic pai a elas relacionado também é marcado como "Concluído"

Integração com o GitLab

Também é possível automatizar regras que auxiliem no processo de desenvolvimento, integrando o Jira com ferramentas de gerenciamento de código-fonte como o GitLab. Para integrar ambas as ferramentas, leias as instruções aqui. Como regras de automação ligadas a ações no GitLab, temos as seguintes:

Quando um commit é feito, o item é movido para "Em progresso"
Quando um item é movido para "Em progresso", uma branch no GitLab é criada

Conclusão

A automação quando utilizada da forma correta, pode ser uma grande aliada no seu projeto, impulsionando a produtividade do time ao simplificar processos. Espero que esse tutorial te ajude a implementar uma gestão mais eficiente por aí ;)

Links úteis

Tutorial: Utilizando ferramentas Low Code em Equipe Distribuída

Sofia de Alcantara — Fri, 02 Feb 2024 14:07:23 +0000

Introdução

Youngling, bem-vindo!

Esse documento contém dicas de uso das ferramentas low code AppSmith, Strap.io e Quant-UX no contexto de equipe distribuída, ou seja, que trabalha de forma total ou parcialmente remota. Vamos? :)

Quant-UX

"O Quant UX é uma plataforma de análise de dados e pesquisa de experiência do usuário que permite às empresas e profissionais de tecnologia obterem insights valiosos sobre a usabilidade e a satisfação dos usuários em relação aos seus produtos e serviços." Similarmente ao Figma, o Quant-UX permite a criação de interfaces, compartilhamento e testes de protótipos interativos. Vamos então aos prós e contras da ferramenta para uso colaborativo:

Prós

Acessibilidade Remota: Como Quant-UX é uma ferramenta baseada na web, ela é acessível de qualquer lugar, sem necessidade de instalação de programas específicos.
Feedback Instantâneo: É possível trabalhar de forma colaborativa, o que permite que a equipe receba feedback instantâneo sobre designs e protótipos, essencial para iteração rápida em projetos ágeis.

Contras

Curva de Aprendizado: Para equipes novas na ferramenta, pode haver uma curva de aprendizado significativa, especialmente para membros menos familiarizados com ferramentas de UX baseadas na web.
Colaboração em Tempo Real Ineficiente: Apesar de viabilizar o compartilhamento do projeto com diversos membros da equipe, a funcionalidade de colaboração simultânea é ineficiente. Ao tentar modificar o projeto simultaneamente, o time tende a enfrentar bugs, onde componentes desaparecem, telas travam e o progresso feito por um membro é perdido quando outro colega da equipe seleciona a opção "Undo" (desfazer).
Importação de telas do Figma: O Quant-UX permite que o projeto receba telas importadas do Figma. Entretanto, é importante saber que ao serem importadas, as telas se comportam como imagens! Assim, os componentes do Figma (peças reutilizáveis que podem ser aplicadas em várias instâncias dentro de um projeto) não irão funcionar no Quant-UX. Dessa forma, recomenda-se que o time utilize o Quant-UX desde a primeira etapa de prototipação para evitar retrabalhos.

Colaborando Simultaneamente: como fazer?

Como descrito no tópico anterior, as modificações coletivas em tempo real no Quant-UX podem não funcionar corretamente. É importante ressaltar que quanto maior o número de pessoas modificando o protótipo na ferramenta , mais erros tendem a surgir. Assim, o time pode se organizar e dividir as tarefas de prototipação para evitar os bugs já citados, tentando limitar as modificações simultâneas a duas pessoas da equipe. Faça testes! :)

AppSmith

Ainda no contexto de prototipação low code colaborativo, o AppSmith te permite conectar várias fontes de dados, criar páginas de aplicativos e personalizar facilmente seus componentes para atender às suas necessidades específicas. A ferramenta se comportou bem para uso colaborativo simultâneo. O ponto negativo da ferramenta encontra-se na curva de aprendizado significativa: o AppSmith envolve conceitos de JavaScript e integrações com banco de dados, o que pode frustrar equipes que não possuam conhecimento técnico mais sólido.

Strap.io

Por fim, o Strap.io "é uma ferramenta que visa facilitar a criação de serviços REST através de um painel administrativo totalmente funcional." Infelizmente, a ferramenta não permite o uso colaborativo, sendo necessário a instalação de ferramentas terceiras como Docker e Postman API. Assim, a curva de aprendizagem pode ser alta principalmente para times que não dominam conteinerização e desenvolvimento e uso de APIs.

Recomenda-se que uma pessoa do time fique responsável por vez, de executar as tarefas, sempre informando a equipe das modificações feitas naquela versão. Após isso, subir a aplicação para o GitHub/GitLab.

Concluindo + Tutoriais Úteis

Além das dicas citadas ao longo do texto, você também pode encontrar fatos úteis nos seguintes materiais:

Criando um CRUD com Appsmith, Strap.io e MySQL: Playlist no YouTube| Tutorial | Repositório do Projeto;
Uso do AppSmith;
Tutoriais de Docker | LEDS

Esperamos que esse tutorial te ajude a implementar uma gestão mais eficiente no seu projeto e precisando de ajuda, contate outros Younglings (alunos membros do LEDS)! A força está em você ;)