Ciclos unidades e granularidade
Nesta aula
A capacidade orienta a divisão
Uma capacidade descreve algo que uma pessoa consegue realizar: consultar a lista pública de serviços ativos é uma capacidade; criar uma pasta não é. Um ciclo Caracol reúne trabalho suficiente para demonstrar essa capacidade. A unidade é uma porção revisável do trabalho, com finalidade, entrada, resultado e critério próprios. Ela pode envolver mais de um arquivo quando a alteração só faz sentido em conjunto.
Granularidade é o tamanho escolhido para essas porções. Unidades grandes escondem decisões e dificultam localizar falhas. Unidades minúsculas podem fragmentar uma mudança simples e exigir coordenação sem benefício. A pergunta útil é se outra pessoa consegue compreender, verificar e integrar a unidade sem reconstruir todo o projeto.
Separar por departamento não basta. Se uma pessoa entrega dados, outra componentes e outra testes, ainda falta comprovar que o navegador apresenta a lista correta. O ciclo termina por comportamento integrado; a conclusão administrativa das tarefas não substitui essa prova. S01, nas áreas de requisitos, construção e testes, ajuda a distinguir esses trabalhos, sem definir os tamanhos particulares do método Caracol.
Decomposição do primeiro incremento
Considere três registros de exemplo: revisão de texto ativa, diagramação inativa e oficina de escrita ativa. A saída esperada contém dois serviços, sem revelar a diagramação. Além da lista normal, o incremento precisa tratar ausência de serviços ativos e entrada inválida. Cada cenário observa uma parte diferente de REQ-001, REQ-002 e REQ-003.
| Unidade | Entrada e resultado | Aceite local |
|---|---|---|
| Contrato e dados | Registros com id, titulo, descricao e ativo | Campos e tipos documentados; exemplos coerentes |
| Leitura e seleção | Dados válidos para lista de ativos | Resultado exclui os inativos; entrada inválida é sinalizada |
| Apresentação | Lista selecionada para conteúdo visível | Títulos aparecem; estado vazio e erro são distintos |
| Prova integrada | Servidor, dados e página trabalhando juntos | Navegação real confirma os critérios do incremento |
A unidade de apresentação pode ser revisada com dados de teste que respeitam o contrato. Isso permite trabalho paralelo, mas não prova a integração com o arquivo efetivo. A prova do ciclo recompõe o percurso completo. Se o módulo seleciona corretamente e a página mostra todos os registros por engano, as unidades não produziram a capacidade pretendida.
Procedimento de ajuste
- Escreva a capacidade e os cenários observáveis antes de listar arquivos.
- Separe decisões que podem ser verificadas de modo independente e mantenha juntas alterações inseparáveis.
- Para cada unidade, registre entrada, resultado, dependências e evidência local.
- Reserve uma prova do percurso integrado; defina dados conhecidos e resultado esperado.
- Revise a divisão após a primeira execução. Divida uma unidade opaca ou reúna fragmentos que sempre mudam juntos.
Erros e reparos
| Erro | O que impede observar | Reparo correspondente |
|---|---|---|
| Unidade chamada melhorar catálogo | Escopo e conclusão | Nomear comportamento e critério concreto |
| Um item para cada linha de código | Razão da mudança conjunta | Agrupar pela finalidade verificável |
| Integração deixada para publicação | Compatibilidade entre partes | Integrar a cada capacidade pequena e repetir a prova |
Gate do ciclo
O ciclo de listagem avança quando os três cenários de dados têm respostas explícitas, inativos não aparecem e o percurso pelo navegador usa o conjunto de dados previsto. É necessário conservar as evidências locais e a evidência integrada. Se somente a seleção isolada passou, pode-se concluir essa unidade; o ciclo inteiro permanece aberto. O nível M6, desenvolvido no próximo capítulo, depende justamente dessa integração comprovada.
Exercício com solução e rubrica
Dados: o próximo incremento permite procurar serviços por título; busca vazia deve listar todos os ativos; busca sem correspondência deve informar nenhum resultado. Há dois títulos ativos, Revisão de texto e Oficina de escrita, e um inativo, Diagramação. Proponha unidades sem criar uma tarefa para cada elemento visual.
Ver solução comentada
Solução: definir contrato da busca, implementar seleção combinando atividade e termo, ligar o campo à apresentação e verificar o percurso no navegador. Para o termo escrita, o resultado esperado é Oficina de escrita; para Diagramação, nenhum resultado; para termo vazio, os dois ativos. A prova integrada inclui digitação e limpeza do campo, com feedback acessível. Este é um exercício de extensão; não descreve uma função já existente no pacote.
- A divisão conserva a regra de ocultar inativos em todos os cenários.
- Cada unidade tem resultado verificável e uma dependência identificada.
- A solução inclui prova integrada e os três resultados fornecidos.
- É aceitável reunir seleção e contrato numa alteração pequena; não é aceitável declarar o ciclo concluído só porque o campo foi desenhado.
Fontes relacionadas
Consulte os limites e as seções de apoio de cada referência.
S01 S16Tente o exercício antes de consultar a solução. Marque a aula para organizar sua leitura.
A conclusão desta leitura não equivale a certificação ou aceite de um projeto real. Teste os exemplos no escopo indicado e registre as limitações.