11. Rastreabilidade¶
A rastreabilidade aqui é memória suficiente: a equipe mantém só os vínculos que respondem às perguntas do projeto. O que é vigente, de onde veio, o que condiciona, como se avalia, quando entra e o que mudou. Esta página define os tipos de vínculo e onde cada um é mantido. Os vínculos de cada requisito ficam na ficha dele, no catálogo.
11.1 Estrutura do escopo¶
Problema (1.4)
└─ Objetivos específicos OE1–OE6 (2.2)
└─ Características de produto CP1–CP7 (2.3)
└─ Catálogo integrado (8): um registro por RF
├─ RNFs (8.1) ............. aplicam-se ao RF
├─ Regras de negócio (8.2) . condicionam o RF
├─ Critérios de aceitação .. avaliam o RF (dentro da ficha)
├─ Dependências ............ outros RFs (dentro da ficha)
└─ Decisões e evidências ... explicam mudanças (histórico, atas)
Atributos: prioridade · entrega (MVP, release, sprint) · situação
11.2 Tipos de vínculo¶
| Vínculo | Liga | Onde é mantido | Pergunta que responde |
|---|---|---|---|
| Problema → objetivo | Problema identificado e OE | Tabela 11.3, nesta página | Por que o produto existe? |
| Objetivo → característica | OE e CP | 2.3 Características de produto | Que capacidade atende cada objetivo? |
| Característica → requisito | CP e RF | Ficha do RF, campo Origem | De onde veio este requisito? |
| Requisito → RNF | RF e RNF | Ficha do RF, campo Condições (os gerais valem para todos) | Que qualidade ele precisa ter? |
| Requisito → regra | RF e RN | Ficha do RF, campo Condições | Que regra condiciona o comportamento? |
| Requisito → critério | RF e CA | Dentro da ficha, campo Critérios | Como saber se está pronto e aceito? |
| Requisito → requisito | Dependência | Ficha do RF, campo Condições: Depende de (escrito pela equipe) e Necessário para (gerado a partir dos Depende de) | O que precisa vir antes? O que é afetado se este mudar? |
| Requisito → entrega | RF, MVP, release e sprint | Ficha do RF, campo Entrega | Quando entra? |
| Decisão → requisito | Ata ou refinamento e RF | Linha do Histórico (código MUD-…, fonte) e nota na Evolução da ficha, com link para essa linha |
Por que mudou? |
| Critério → evidência | CA e teste ou validação | DoD e Evidências | Como sabemos que foi cumprido? |
Cada vínculo é mantido em um só lugar. As páginas de RNFs e de regras não listam os RFs que as
aplicam, para não criar uma segunda cópia que precise ser atualizada. O Necessário para é o
inverso do Depende de e não é editado à mão: depois de mudar uma dependência, rode
python scripts/catalogo.py atualizar. Antes de cada publicação do site, python scripts/catalogo.py verificar
confere se os dois lados batem e se alguma nota de Evolução cita critérios de outro requisito.
11.3 Do problema às características de produto¶
| Problema identificado (1.4) | Objetivo Específico (2.2) | Característica de Produto (2.3) |
|---|---|---|
| Doações de itens anotadas em cadernos e, por falta de tempo, nem sempre registradas | OE2 | CP2 – Registro de doações de itens |
| Não existe relatório organizado do que foi recebido e distribuído | OE5 | CP6 – Relatórios e indicadores de impacto |
| A prestação de contas aos parceiros depende da memória das coordenadoras | OE5 | CP6 – Relatórios e indicadores de impacto |
| O cadastro das famílias fica em um computador da sede, sem ligação com a presença e as doações | OE3 | CP3 – Cadastro de famílias e participantes; CP4 – Inscrição em atividades |
| A chamada é feita em papel e a regra de faltas depende de conferência manual | OE4 (parcial no MVP) | CP5 – Chamada digital e controle de frequência. O MVP abre a chamada, registra e justifica faltas, corrige e consulta a frequência (RF27 a RF31); a sinalização de quem passou do limite de faltas (RF32) fica para depois do MVP |
| A Sacola Verde não registra quem foi atendido em cada distribuição | OE2 (parcial) | CP2 – a saída de itens para a família fica registrada no RF10; o sistema de senhas ficou fora do escopo (seção 15, Unidade 1) |
| A comunidade não sabe quais atividades estão ativas, suspensas ou dependem de doação | OE1 | CP1 – Portal institucional e agenda de atividades |
| Informações institucionais e vagas dependem de Instagram, panfletos e grupos de WhatsApp | OE1 | CP1 – Portal institucional e agenda de atividades |
| Tratamento de dados pessoais de famílias em vulnerabilidade (efeito emergente, seção 3) | OE6 | CP7 – Perfis de acesso e proteção de dados |
Da característica ao requisito, use o filtro do catálogo: CP1 · CP2 · CP3 · CP4 · CP5 · CP6 · CP7.
11.4 Exemplo: percorrendo o RF09¶
| Pergunta | Resposta | Onde |
|---|---|---|
| Que problema resolve? | Doações anotadas em cadernos e nem sempre registradas | Tabela 11.3 |
| Que objetivo e característica? | OE2 · CP2 – Registro de doações de itens | Ficha do RF09, Origem |
| O que declara? | Permitir que Voluntário ou Coordenação registrem a entrada de itens doados | Ficha, Declaração vigente |
| O que condiciona? | RNF01 (até três passos), RNF07 (proteção dos dados do doador), RNF19 (histórico de alterações), RN02 (unidade da categoria) | Ficha, Condições |
| Como se avalia? | CA-RF09-01 a CA-RF09-06 | Ficha, Critérios |
| Quando entra? | MVP, release R1, Sprint 6 | Ficha, Entrega |
| Como se comprova? | Evidência prevista (o RF09 ainda está em andamento): teste automatizado no CI e teste com uma voluntária, sem ajuda | DoD, exemplo 13.5 |
11.5 Quando revisar os vínculos¶
| Momento | Cuidado com o escopo | Evidência suficiente |
|---|---|---|
| Planejamento da sprint | Conferir seleção, confirmação e dependências | Fichas com situação atual |
| Após uma decisão | Atualizar conteúdo, atributos e vínculos afetados | Decisão registrada no histórico e na ficha |
| Revisão da sprint | Incorporar os efeitos do feedback e comunicar | Encaminhamentos e atualizações registrados |
| Fechamento da entrega | Preservar a referência e distinguir pendências | Versão identificada do conjunto |
Uma mudança não é feita só no ponto em que surgiu: a equipe confere os elementos relacionados (regra, critério, mensagem de interface, fluxo e entrega) e atualiza o que foi afetado.