Processo de Desenvolvimento no PJE
Conteúdo |
Público-alvo
As instruções a seguir se destinam aos tribunais criadores de demandas, priorizadores e às fábricas de desenvolvimento e de homologação do PJe.
Foi criada uma apresentação sobre o processo de desenvolvimento adotado para o PJe Nacional, que pode ser acessada aqui.
Criação das demandas
Nesta etapa a necessidade do tribunal é transformada em demanda no sistema gerenciador de demanda (Jira);
As demandas podem ser criadas tanto pelos tribunais, quanto por qualquer pessoa participante dos times envolvidos no desenvolvimento do PJe;
Antes da criação da demanda, deve-se fazer uma pesquisa preliminar no Jira em busca de demandas já relacionadas, demandas duplicadas ou até de informações de configuração para resolver a necessidade do tribunal;
Foi configurado no próprio Jira, no momento da criação da demanda, um template com informações mínimas para auxiliar tanto a equipe de desenvolvimento e de requisitos, quanto a equipe de revisão e a de homologação. A descrição da issue deve ser considerada a documentação da demanda.
Em média são criadas 6 demandas por dia* no Jira:
2 bugs / 3 defeitos / 1 melhoria
- Dados do dia 1/3/16, com base nos últimos 6 meses
Priorização das demandas
A classificação das demandas depende da prioridade dos tribunais, da complexidade das demandas e da sua criticidade;
A prioridade dos tribunais é informada no e-mail prioridade@cnj.jus.br e pode ser visualizada de forma consolidada no link: https://goo.gl/tiHR4c;
As demandas classificadas ganham uma ordem de classificação que pode ser verificada no campo Bussiness Value, a partir deste campo as demandas são ordenadas e ficam na fila para serem encaminhadas a uma das fábricas de desenvolvimento dos tribunais participantes do PJe Nacional.
- Demandas que estão nesta etapa podem ser vistas no seguinte filtro (Jira):
**Adm2.59 Classificar (backlog)
Fábricas de desenvolvimento do PJe
Atualmente o PJe tem as seguinte fábricas de desenvolvimento em atuação, responsáveis por desenvolver as demandas do PJe Nacional que serão instaladas em todos os tribunais:
- CNJ
- TJDFT
- TJMG
- TSE
- TJCE - em implantação
- TJRO - em implantação
Padrões de desenvolvimento
Os desenvolvedores devem seguir os seguintes procedimentos para o PJe: Desenvolvedor
Fábricas de homologação do PJe
Atualmente o PJe tem as seguinte fábricas em atuação, responsáveis por homologar as demandas do PJe Nacional que serão instaladas em todos os tribunais:
- CNJ - composta por pessoas do próprio CNJ;
- TJPR - em implantação;
- TJRO - em implantação.
Procedimento para homologação das demandas
Planejamento de testes
Nesta etapa são criados e documentados os cenários de teste, para isso utiliza-se:
- a descrição da própria demanda no Jira;
- a documentação das regras de negócio hoje disponíveis na wiki do projeto;
- o próprio Jira, em demandas relacionadas;
- e principalmente a experiência e documentação dos cenários de teste das equipes de teste do projeto.
Os cenários devem conter tanto os caminhos “felizes” para o teste da demanda, quanto os caminhos alternativos;
Os cenários criados para teste são incluídos em uma sub-tarefa da demanda que está sendo testada, para auxiliar às pessoas que venham a testá-la ou que venham a corrigir defeitos relatados na solução.
Execução de testes
Para a execução dos testes, a fábrica de testes do tribunal deverá montar um ambiente de testes com as últimas atualizações do branch master do projeto PJe;
Os cenários devem ser executados um-a-um e o resultado de cada cenário deve ser reportado e filmado (ex. de aplicativo de filmagem: www.screencast-o-matic.com);
Ao final deste processo deve-se incluir uma sub-tarefa à demanda principal que está sendo homologada, esta sub-tarefa deve ser do tipo "Execução de testes" e deve ser adicionada à demanda a lista de cenários testados, dos resultados obtidos (se aprovado ou se reprovado) e o filme dos testes executados;
Se houver algum cenário reprovado a demanda deverá ser devolvida para o desenvolver fazer os ajustes necessários, pela transição (do Jira) “Reprovar solução”;
Se todos os cenários forem aprovados a demanda deverá ser encaminhada para a próxima etapa (Integração), pela transição “Aprovar solução”.
Segue o que deve ser feito, tanto à issue principal, quanto à issue de sub-tarefa de execução de testes:
************************************************************************************************************* PREENCHIMENTO DA ISSUE PRINCIPAL ************************************************************************************************************* Prezados, demanda verificada e homologada para versão X.X.X. <Ambiente de homologação do CNJ>. Cenários testados e evidências encontram-se na subtask PJEII-XXXXX. Atenciosamente, <Nome do analista de teste> <Nome da fábrica de testes (TJRO, TJPR, CNJ, ...)>
************************************************************************************************************* PREENCHIMENTO DA SUBTASK DA ISSUE DE EXECUÇÃO DE TESTE ************************************************************************************************************* Prezados, foram testados os seguintes cenários: 1. Pré-condição: N/A *1.1. Cenário:* Verificar/Testar... *1.2. Perfil:* *1.3. Resultado:* APROVADO/REPROVADO *1.4. Evidência:* [XXXXX_EVIDENCIA_DE_TESTE_DDMMAAAA_HHMM]_NOME_DO_VIDEO.mp4 Ambiente: <http://vanadiod09:8180/pjecnj> Branch: X.X.X.x 00/00/0000 - 00:00 Versão: X.X.X Anexo evidência[s] do[s] teste[s] realizado[s]. Atenciosamente, <Nome do analista de teste> <Nome da fábrica de testes (TJRO, TJPR, CNJ, ...)>
Procedimento de homologação no ambiente do tribunal
Segue os procedimentos que devem ser adotados pela fábrica de testes do tribunal para homologar uma issue:
1. A issue principal deve ser tramitada para o status de “Aguardando Homologação Negocial” para “Homologação Negocial” quando for iniciado o teste da mesma. • Caso a issue seja “Reprovada”, tramitar a issue principal para “Rejeitado pela homologação Negocial” com a resolução igual a “Não Resolvido”. • Caso contrário, tramitar a issue para “Fechado” e com a resolução “Resolvido”. 2. Deve ser criada uma subtask do tipo “Execução de teste” vinculada a issue principal. (Ex.: PJEII-22535) 3. Os cenário de testes levantados, devem seguir o template “Template de preenchimento de issue de execucao de teste.txt”. 4. O nome das evidências de testes, devem seguir o padrão definido na Wikipje, [XXXXX_EVIDENCIA_DE_TESTE_DDMMAAAA_HHMM]_NOME_DO_VIDEO.mp4. 5. O nome das evidências de erro, devem seguir o padrão definido na Wikipje, [XXXXX_ERRO]_NOME_DO_VIDEO.txt. 6. Os defeitos detectados na homologação, devem seguir o template “Template de abertura de issue no jira.txt”. • Caso o defeito seja desestabilização da versão, reportar no projeto “PJE-VERSAO_1.7.2”. • Caso contrário, reportar no PJEII.
A issue deve ser homologada no ambiente do tribunal. Não temos ambiente de homologação disponibilizado pra fora, desta forma, o ambiente deve ser informado, se 1° ou 2° graus.
Homologação (negocial)
Consideramos a homologação de uma versão como um projeto e tendo isso em mente buscamos estabelecer as três dimensões principais para seu acompanhamento: custo x tempo x escopo.
- Quanto ao tempo, buscamos estabelecer o tempo do projeto de homologação em 3 a 4 semanas, para que seja possível que o tribunal tenha entregas periódicas e constantes e consiga se programar para evoluir as versões;
- Quanto ao custo, como o tempo é curto, consideramos esta uma dimensão fixa e dependente das equipes dos tribunais que disponibilizam as fábricas de homologação;
- Desta forma, como temos duas dimensões (relativamente) fixas o escopo torna-se a única dimensão gerenciável e para isso buscamos criar critérios objetivos para a seleção do escopo do projeto de homologação, assim:
- As demandas a serem homologadas devem estar desenvolvidas até o momento da definição do escopo da versão (todas as demandas já desenvolvidas podem ser vistas neste filtro: **Adm8.21 Escopo (testar-master - priorizado));
- Deve ser verificada a ordem de prioridade solicitada pelos tribunais (informação consolidada aqui https://goo.gl/tiHR4c e foi repassada via e-mail prioridadepje@cnj.jus.br);
- Deve ser avaliada a complexidade da demanda para ser integrada na versão, esta informação é dada principalmente pela quantidade de alterações feitas pelo desenvolvedor e pode ser identificada no GIT (http://git.cnj.jus.br/pje/pje/merge_requests);
- complexidade e tempo para homologação, esta informação é gerada pela equipe responsável pela homologação, neste momento é verificada a quantidade de regras de negócio envolvidas e cenários que devem ser verificados para a homologação da demanda.
- Com base nesses critérios são identificadas as demandas que “cabem” no projeto de homologação da versão e quanto mais pessoas temos para homologar a versão, maior é a capacidade do projeto em homologar mais demandas.
Procedimento para homologar as demandas
1. A issue principal deve ser tramitada para o status de “Aguardando Homologação Negocial” para “Homologação Negocial” quando for iniciado o teste da mesma;
• Caso a issue seja “Reprovada”, tramitar a issue principal para “Rejeitado pela homologação Negocial” com a resolução igual a “Não Resolvido";
• Caso contrário, tramitar a issue para “Fechado” e com a resolução “Resolvido”.
2. Deve ser criada uma subtask do tipo “Execução de teste” vinculada a issue principal. (Ex.: PJEII-22535)
3. Os cenário de testes levantados, devem seguir o template “Template de preenchimento de issue de execucao de teste.txt”.
4. O nome das evidências de testes, devem seguir o padrão definido na Wikipje, [XXXXX_EVIDENCIA_DE_TESTE_DDMMAAAA_HHMM]_NOME_DO_VIDEO.mp4.
5. O nome das evidências de erro, devem seguir o padrão definido na Wikipje, [XXXXX_ERRO]_NOME_DO_VIDEO.txt.
6. Os defeitos detectados na homologação, devem seguir o template “Template de abertura de issue no jira.txt”.
• Caso o defeito seja desestabilização da versão, reportar no projeto “PJE-VERSAO_1.7.2”.
• Caso contrário, reportar no PJEII.
Versionamento
A próxima versão do sistema e as versões já lançadas podem ser vistas aqui: Versões
