Exibir código-fonte para Processo de Desenvolvimento no PJE

== 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 [[Mídia:Processo demandas PJe.pdf|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):
[http://www.cnj.jus.br/jira/issues/?filter=16979 **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: [http://www.cnj.jus.br/jira/issues/?filter=19564 **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]]