4 · Engenharia de Requisitos

ER conduz, FDD executa

A Engenharia de Requisitos define o quê — as seis atividades canônicas abaixo. O FDD + Kanban define o como — a camada de execução descrita em ER e FDD.

Atividades e Técnicas

Elicitação e Descoberta

Técnica	Como é utilizada
Color Modeling	Workshop visual com o Domain Expert (Otávio) para identificar classes, papéis, eventos e agregados do domínio
Feature Discovery Session	Sessão dedicada que transforma necessidades de negócio brutas em candidatas a feature

Análise e Consenso

Técnica	Como é utilizada
Vertical Slicing	Toda feature é decomposta em fatias UI → API → dado, nunca em camadas técnicas isoladas
INVEST	Checklist de entrada no backlog: Independente, Negociável, Valiosa, Estimável, Pequena, Testável
Matriz Valor × Esforço	Features posicionadas em quadrantes de valor e esforço
Priorização IP = VB / PT	PT = (CX + ES) / 2, escala 1–5; IP ≥ 1,50 alta · 1,00–1,49 média · < 1,00 baixa
Iteration Goal Statement	Frase única, demonstrável e orientada a valor, acordada no Commitment

Declaração

Técnica	Como é utilizada
Feature Card Specification	Formato fixo <ação> <resultado> <objeto> — ex.: "Cadastrar produto SaaS para o portfólio"
Critérios de aceite BDD	Cada feature/issue tem critérios Dado / Quando / Então (parte do DoR)

Representação

Técnica	Como é utilizada
Diagrama de domínio	Classes do domínio (Color Modeling): entidades, relacionamentos e regras centrais
Glossário de termos	Vocabulário de negócio compartilhado pela equipe e pelo cliente
Feature Cards (Miro)	Cada feature aprovada vira card visual, rastreável até RFs/RNFs
Prototipagem	Mockup das telas com impacto de UI, validado antes da codificação

Verificação e Validação

Técnica	Como é utilizada
Definition of Ready	Gate de entrada: requisito claro, completo e testável (DoR/DoD)
Definition of Done	Gate de saída: requisito efetivamente atendido
Inspeção do requisito	Revisão da qualidade do requisito e dos critérios de aceite — técnica central da cerimônia de Refinamento de Requisitos
Análise de rastreabilidade	Auditoria da matriz OE → CP → Feature → RF/RNF → Issue para verificar cobertura, consistência e ausência de órfãos — aplicada no Refinamento de Requisitos
Verificação de critérios	Conferência item a item dos critérios BDD vs. comportamento implementado
Validação assíncrona	Vídeo/screenshots + checklist enviados a Otávio via WhatsApp em até 24h
Demo orientada a valor	Demonstração na Formal Client Validation narrada pelo Iteration Goal

Organização e Atualização

Técnica	Como é utilizada
Backlog macro priorizado	Lista de features ordenada por IP, revisada a cada replenishment
Requirements Traceability Matrix	Tabela viva OE → CP → Feature → RF/RNF (rastreabilidade)
Backlog Reorganization	Reordenação a partir do feedback da Formal Client Validation
Checklist de empacotamento	Verificação na Iteration Artifact Closure de todos os artefatos entregues

ER e FDD

O FDD + Kanban operacionaliza as atividades acima em 5 etapas: as três primeiras executadas uma única vez (fundação do produto); as duas últimas repetidas a cada iteração.

Etapas Únicas (início do projeto)

Etapa FDD	Cerimônia	Atividade de ER	Artefatos
1 · Develop an Overall Model	Domain Modeling Workshop	Elicitação · Representação	Diagrama de domínio, glossário
2 · Build a Feature List	Feature Discovery Session	Elicitação · Declaração · Representação · Análise	Feature Cards, ata
3 · Plan by Feature	Iteration Replenishment (macro)	Análise · Organização	Backlog priorizado, roadmap, Feature Matrix

Etapas Iterativas (por iteração)

Etapa FDD	Cerimônia	Atividade de ER	Artefatos
4 · Design by Feature	Replenishment Micro + Commitment	Análise	Backlog da iteração, Iteration Goal
	Technical Design Review	Declaração · V&V (DoR)	Issues com critérios; notas de design
5 · Build by Feature	Kanban Pull Execution	execução (WIP ≤ 2)	Board, commits, PRs
	Feature Build Consolidation	Organização · V&V	Rastreabilidade atualizada
	Refinamento de Requisitos	V&V (análise de rastreabilidade · inspeção)	Requisitos refinados, matriz de rastreabilidade revisada, ata
	Partial Client Validation	V&V	Validação assíncrona na issue
	Formal Client Validation	V&V	Ata da demo, aprovação de Otávio
	Iteration Artifact Closure	Organização	GitHub Pages atualizado, backlog congelado

Carregando diagrama…

■ Etapas 1–3 (únicas) · ■ Etapas 4–5 (iterativas, com loop por iteração)

Cerimônias — Objetivo e Modalidade

Cada cerimônia abaixo tem um objetivo específico dentro da ER/FDD e ocorre de forma síncrona (reunião com participantes, geralmente gravada) ou assíncrona (sem reunião formal — execução, checagem ou feedback enviado por outro canal). Clique em uma cerimônia na barra para ver seu objetivo.

Domain Modeling Workshop

Etapa 1 · Develop an Overall Model · Síncrona

Workshop com o Domain Expert (Otávio) para elicitar e representar o domínio do negócio (Color Modeling) — gera o diagrama de domínio e o glossário de termos compartilhado pela equipe e pelo cliente. Ocorre uma única vez, no início do projeto.

Feature Discovery Session

Etapa 2 · Build a Feature List · Síncrona

Sessão dedicada que transforma necessidades de negócio brutas em candidatas a feature, produzindo a lista inicial de features e os primeiros Feature Cards. Ocorre uma única vez, no início do projeto.

Iteration Replenishment (macro)

Etapa 3 · Plan by Feature · Síncrona

Prioriza o backlog macro do produto (IP = VB / PT), monta o roadmap de iterações e a Feature Matrix (Valor × Esforço) que baliza o que entra em cada iteração. Ocorre uma única vez, no início do projeto.

Replenishment Micro + Commitment

Etapa 4 · Design by Feature · Síncrona

Seleciona, a partir do backlog priorizado, as features que entram na iteração corrente e formaliza o compromisso da equipe com o Iteration Goal Statement — a frase única e demonstrável que orienta toda a iteração. Repete a cada iteração.

Technical Design Review

Etapa 4 · Design by Feature · Síncrona

Revisa os diagramas de sequência leve, os Feature Cards e os critérios de aceite (BDD) das features planejadas para a iteração, autorizando a abertura das issues de desenvolvimento (gate de entrada — DoR). Repete a cada iteração.

Kanban Pull Execution

Etapa 5 · Build by Feature · Assíncrona

Execução contínua do desenvolvimento com WIP limitado (≤ 2 issues por Class Owner): cada Class Owner puxa a próxima issue disponível do board conforme sua capacidade, sem reunião formal associada. Repete continuamente ao longo da iteração.

Feature Build Consolidation

Etapa 5 · Build by Feature · Assíncrona

Checagem feature a feature de que a rastreabilidade (RF/RNF, critérios de aceite) está atualizada e consistente com o comportamento efetivamente implementado — verificação assíncrona feita pelo responsável, sem reunião. Repete a cada iteração.

Refinamento de Requisitos

Etapa 5 · Build by Feature · Síncrona

Inspeciona a qualidade dos requisitos e das issues já em andamento, e audita a matriz de rastreabilidade (OE → CP → Feature → RF/RNF) em busca de inconsistências, requisitos órfãos ou desatualizados. Repete a cada iteração (pode ocorrer mais de uma vez).

Partial Client Validation

Etapa 5 · Build by Feature · Assíncrona

Coleta feedback antecipado do cliente sobre funcionalidades já implementadas, através de vídeo/screenshots e checklist enviados por WhatsApp em até 24h — sem reunião síncrona —, permitindo ajustes antes da validação formal. Repete a cada iteração, quando a disponibilidade do cliente permite (na IT2 não ocorreu: ver justificativa).

Formal Client Validation

Etapa 5 · Build by Feature · Síncrona

Demonstração ao vivo do incremento completo da iteração, narrada pelo Iteration Goal Statement, buscando a aprovação formal do cliente — marca o encerramento oficial da iteração e é pré-requisito para a abertura da próxima. Repete a cada iteração.

Iteration Artifact Closure

Etapa 5 · Build by Feature · Síncrona

Checklist de empacotamento de todos os artefatos da iteração (documentação, evidências, resultados de V&V) antes de congelar o backlog da iteração encerrada e abrir a próxima. Repete a cada iteração.

Artefatos de Engenharia de Software

Separação ER × ESw

Os artefatos abaixo descrevem e verificam a solução técnica, não o requisito. São produzidos na Technical Design Review e na Build by Feature — não constituem atividades de Engenharia de Requisitos.

Artefato de ESw	Natureza	Onde é produzido	Evidência
Diagrama de Arquitetura do Sistema	Representação da arquitetura	Develop an Overall Model (Etapa 1)	Arquitetura
Estrutura de módulos do backend	Design arquitetural	Develop an Overall Model (Etapa 1)	Arquitetura
ADR — Architecture Decision Record	Decisão arquitetural registrada	Plan by Feature (Etapa 3)	ADR-001
Diagrama de sequência (leve e formal)	Representação da solução técnica	Technical Design Review (Etapa 4)	Design Técnico
Análise de impacto e pontos de extensão	Design técnico	Technical Design Review (Etapa 4)	Design Técnico
Notas de design técnico por feature	Design técnico	Technical Design Review (Etapa 4)	Design Técnico
Smoke test end-to-end	Verificação da implementação	Feature Build Consolidation (Etapa 5)	Resultados V&V

Todos os artefatos de evidência estão centralizados na página de Evidências.

Histórico de Revisão · 8 versões

Versão	Data	Descrição	Autor(es)
1.0	12/04/2026	Criação das seções 4.1 a 4.4	Heitor e Lucas
1.7	18/05/2026	Separação entre etapas únicas e iterativas do FDD	Lucas A. Zanetti
1.9	17/06/2026	Reestruturação ER-primeiro: atividades de ER promovidas a nível principal	Heitor
1.10	17/06/2026	Separação ER × ESw; V&V reforçada com DoR, DoD e inspeção	Heitor
1.11	18/06/2026	Técnicas enriquecidas com formato/especificação de uso	Heitor
2.0	26/06/2026	Migração para Docusaurus: atividades de ER em tabs; tabelas compactadas	Equipe Crianex
2.1	28/06/2026	Cerimônia de Refinamento de Requisitos (V&V) adicionada às etapas iterativas; técnica de Análise de rastreabilidade incluída em V&V	Equipe Crianex
2.2	01/07/2026	Nova seção "Cerimônias — Objetivo e Modalidade": minibar retrátil por cerimônia com objetivo e indicação de Síncrona/Assíncrona (Partial Client Validation, Kanban Pull Execution e Feature Build Consolidation são assíncronas)	Equipe Crianex