Atendendo casos #

Objetivo #

O objetivo principal deste documento é resumir a forma de tratamento de Casos registrados no tracker oficial do Demoiselle hospedado em https://sourceforge.net/apps/mantisbt/demoiselle.

Termos #

• Caso (Issue): É um registros no Mantis, que pode ser classificado como um Bug, para defeitos, ou Feature Request, para requisição de novas funcionalidades.
• Comitador: Membros da equipe Demoiselle que tem permissão para tratar um Caso relatado, efetivando alterações em código-fonte.
• Estado (Status) do Caso: Uma das situações possíveis (Anexo I) para um Caso relatado.
• Projeto Mantis: Um dos projetos/subprojetos Demoiselle cadastrados no Mantis.
• Relator: Qualquer usuário do que reporte um Caso no Mantis.
• Responsável: Usuário atribuído ao caso.

Gestão do tratamento de Casos #

No planejamento de cada Sprint de 2 semanas, a equipe Demoiselle deverá efetuar uma análise de todos os Casos novos registrados desde a último Sprint. A equipe irá definir quais Casos serão tratados durante o Sprint, planejando as novas versões que precisão ser geradas, considerando todo o Ecosistema Demoiselle (Framework, Wizard, Component e Sample). Preferencialmente a geração de versões de correção do Bug ou atendimento de Feature Requests devem ser sincronizadas com os finais de Sprint. Casos urgentes que demandem solução imediata podem surgir durante os Sprints. Essas situações serão tratadas pontualmente quando ocorrerem, quando a equipe definirá a estratégia de atuação.

Fluxo de tratamento de Casos #

Analisando os Casos registrados #

Objetivo: Efetuar uma primeira revisão nos Casos para que as informações sejam validadas e, se necessários, modificadas. Ao final desta etapa a equipe deve ser capaz de melhor analisar esforço e complexidade para resolução dos Casos em aberto.

1. Executar Filtro no Mantis, em todos os Projetos, buscando por todos os casos que estão na situação “novo”(new)
2. Analisar Caso a Caso quanto a:
1. Categoria: Verificar se realmente é Bug, Improvment ou Feature Request, caso seja apenas uma dúvida o usuário deve ser instruído a postar sua dúvida no fórum, ou lista.
2. Projeto: Se o Caso está associado ao Projeto Mantis correto, neste caso é necessário mover ao projeto adequado.
3. Gravidade: Reavaliar a gravidade do Caso está compatível.
4. Prioridade: As mais altas devem ser atendidas primeiro.
5. Clareza: Se o relato não estiver claro o suficiente, o Caso deve ser colocado no status Retorno (Feedback) solicitando esclarecimentos do Relator.
6. Duplicidade: Se existe algum relato semelhante já cadastrado, ou atendido em outra versão do projeto, estabelecer a relação entre os casos(situação Fechado(Closed)).
7. Grau de detalhamento: Após esclarecimentos percebesse que o caso precisa ser discutido com mais atenção (situação Admitido(Admited)),
1. Um tópico com o título do caso deve ser criado no fórum(http://sourceforge.net/apps/phpbb/demoiselle) correspondente ao projeto.
2. Notícia vinculada informando o início da discussão
3. Responsável acompanha o fórum registrando cada decisão no caso
4. Conclusão deve ser sintetizada em formato de anotação no próprio caso.
5. Notícia vinculada informando o final da discussão
6. Percebido que se trata de um novo projeto o mesmo deve ser criado no mantis e o caso deve ser migrado.(A Pertinência é avaliada neste momento)
8. Pertinência: Se o Caso de fato é pertinente, e está especificado (situação Confirmado (Confirmed), não sendo pertinente(situação Fechado(Closed)).
9. Previsão de resolução: Ao considerar um caso Confirmado, se possível já deve ser indicada a versão que supostamente deverá tratá-lo. Para isso deve-se utilizar o campo “Previsto para a Versão” (Target Version) disponível na Atualização Avançada (Advanced Update) do Caso. Importante: A Versão Destino deve ter sido previamente cadastrada no gerenciamento do Projeto Mantis correspondente. Até que tenha sido de fato disponibilizada, o campo “Liberada” (Released) deverá estar desmarcado.

Possíveis estados de um Caso nesta fase: Novo (New),Adimitido(Admited), Confirmado (Confirmed), Retorno (Feedback).

Atendendo um Caso #

Objetivo: Dar o devido tratamento aos Casos registrados, de forma a melhorar a qualidade do Demoiselle mantendo controle das alterações efetuadas e dando visibilidade e transparência às evoluções do Demoiselle.

1. Executar Filtro no Mantis, em todos os Projetos, buscando por todos os casos que estão na situação “Comfirmado” (Confirmed)
2. Atribuir o Caso a um dos Comitadores do Demoiselle(situação Atribuido(Atributted))
3. Tratar o Caso de acordo com as práticas definidas pela equipe Demoiselle durante os Sprints
4. Solucionar o Caso colocando na situação Resolvido (Resolved) e indicando no campo “Corrigido na Versão” a versão que efetivamente resolveu o problema.

Possíveis estados de um Caso nesta fase: Atribuído (Assigned), Resolvido (Resolved).

Concluindo um Caso #

Objetivo: Concluir os Casos registrados quando seu tratamento estiver efetivamente concluído e em Produção. Um Caso só será considerado encerrado quando: a) a versão estável que o corrige estiver oficialmente disponível; b) O Caso não foi considerado pertinente ou não demandou alterações de código (ex: Após análise se detectou que o Caso se tratava apenas de uma dúvida; neste caso o Comitador pode fechar o Caso, desde que registre os devidos esclarecimentos para o Relator).

1. Encerrar um Caso colocando-o no estado Fechado (Closed).

Possíveis estados de um Caso nesta fase: Fechado (Closed).

Registro de Mudanças (Change Log) Planejamento (Roadmap) #

O tratamento aqui descrito permitira um controle efetivo das alterações efetivadas no Ecosistema Demoiselle. Duas funcionalidades do Mantis são aqui destacadas:

Registro de Mudanças (Change Log) #

São exibidos aqui todas os Casos efetivamente resolvidos para cada Projeto Mantis / Versão. 
Esta opção é útil para acompanhar a quantidade de Casos resolvidos para cada versão do Demoiselle.

Link: https://sourceforge.net/apps/mantisbt/demoiselle/changelog_page.php

Planejamento (Roadmap) #

São exibidos aqui todas os Casos previstos para serem corrigidos e também os efetivamente resolvidos para cada Projeto Mantis / Versão. 
Esta opção é útil para acompanhar o   percentual de conclusão dos Casos registrados para cada Versão, servindo também como Roadmap para toda a 
comunidade tomar conhecimento dos rumos futuros do Demoiselle.

Link:https://sourceforge.net/apps/mantisbt/demoiselle/roadmap_page.php

Considerações Finais #

O tratamento aqui descrito contempla o fluxo principal de trabalho para as situações imaginadas mais comuns. No surgimento de excepcionalidades, a equipe deverá discutir e definir seu tratamento, incrementando este documento com as novas definições.