Tema
O PRD e as tarefas
O PRD é o documento do produto: diz o que cada tela faz, para quem e com quais regras. Ele começa curto, no entendimento, e cresce a cada validação. As telas mostram como fica. É da versão validada do PRD que saem as tarefas.
Como o PRD cresce
O PRD fica num arquivo em docs/prd/ do repositório do projeto e entra por PR (pull request, o pedido para incorporar uma mudança ao projeto). O modelo é o docs/prd/TEMPLATE.md do tjes-base-web, e cada projeto tem a sua cópia no mesmo lugar.
- No entendimento, o líder técnico e a equipe escrevem o PRD inicial com a área: objetivo, quem usa, as tarefas da pessoa usuária e as regras já conhecidas.
- Nas validações, o PRD ganha o que foi decidido. As decisões de tela não são copiadas: o PRD traz o link da issue "Validação de telas".
- Na consolidação, o PRD recebe os fluxos, as telas, as regras, os estados e os critérios de aceite combinados, com os links dos protótipos validados.
| Parte | O que leva | Quando entra |
|---|---|---|
| Cabeçalho | O entregável e uma linha "Versão validada" por validação: data, issue da validação e commit | No começo; a linha, a cada validação |
| Objetivo | O problema que o conjunto resolve, em uma ou duas frases | No entendimento |
| Quem usa | Os perfis de pessoa usuária e o que cada um pode fazer | No entendimento |
| Tarefas da pessoa usuária | O que ela precisa fazer, em poucas linhas | No entendimento |
| Regras | As regras de negócio, com exemplos | No entendimento, e cresce depois |
| Fluxos | Os passos de cada tarefa, do começo ao fim | Na consolidação |
| Telas | Os links das imagens e dos protótipos validados, com a versão e a issue da validação (veja Mockups) | Na consolidação |
| Estados | O que a tela mostra carregando, sem dados, com erro, sem permissão e na confirmação, como nos Padrões de tela | Na consolidação |
| Critérios de aceite | O que a área vai conferir na entrega | Na consolidação |
O PRD só traz o que foi combinado com a área ou está nas telas validadas. Uma mudança depois da validação passa de novo pela Validação.
Cada validação é um commit
Quando uma validação fecha, a atualização do PRD entra por PR. O commit da main que ela gera é a versão validada. Use o link do arquivo naquela versão. No GitHub, abra o arquivo e aperte a tecla y: o endereço troca main pelo código do commit, no formato blob/<commit>/docs/prd/<conjunto>.md.
- A tarefa aponta para o PRD nesse commit, e não para a
main. Se o PRD mudar no meio do trabalho, o dev continua com a versão que foi validada. - O commit só existe depois do merge. O link dele vai no comentário que fecha a issue da validação e entra na linha "Versão validada" do PRD no pull request seguinte.
Do PRD às tarefas
O líder técnico e a equipe montam as tarefas no quadro do projeto:
- Entregável: a issue mãe, o que é conferido, aceito e pago.
- Funcionalidades: as sub-issues do entregável, o que a pessoa usuária consegue fazer.
- Dependências: cada issue diz por quais está bloqueada e quais bloqueia. Assim o quadro mostra o que dá para começar agora e o que espera outra tarefa.
Cada funcionalidade traz o link do entregável, da tela e da parte do PRD que ela constrói, no commit validado. Na conferência, a issue "Conferência da entrega" confere os critérios de aceite do PRD.
No piloto
No P19 e no P20, as tarefas vieram das reuniões, antes das telas. Quando o PRD de cada conjunto for validado, elas serão revistas contra ele.