IMP — TDD: Technical Design Document (S)

O que é

No SinergIA, TDD na pasta IMP significa Technical Design Document: desenho técnico da construção (fluxos de implementação, decisões de código, contratos junto do API), vinculado a histórias ESP. Não é o documento de implantação em infraestrutura (SDD no INF) nem substitui BRD/PRD.

Ver distinção normativa: § 11.5.1 SDD (INF) e TDD (IMP).

Como usar

Crie um TDD quando for necessário detalhar como uma história aprovada será implementada (interfaces, sequências, pontos de extensão).
Referencie sempre historia-origem com o id da história ESP.
Alinhe com API Contract e critérios de aceite da história; atualize quando a implementação divergir do plano aprovado.
Estratégias e plano de testes no sentido de Test Plan usam o tipo TPL no modelo do framework (ver referências §11.5) — não confundir sigla com este TDD da IMP.

Exemplo

---
id: IMP-TDD-0001
tipo: TDD
titulo: "Desenho técnico — autenticação gov.br"
status: rascunho
autor: fulano.de.tal
data: 2026-04-11
historia-origem: ESP-HNU-0001
---

# Resumo: componentes tocados, fluxo principal, pontos de integração com HAI.

(Bloco ilustrativo; expanda com seções de desenho conforme o projeto.)

Onde se aplica

Destino	Link / caminho
Framework IMP	/framework/imp/
Índice IMP (artefatos)	/artefatos/imp/
Monorepo	`artefatos/IMP (Implementação)/03-decisoes/` (TDD, API)
Histórias ESP	/artefatos/esp/fluxo-de-vida/
SDD (INF)	/artefatos/inf/sdd/ — papel distinto
ADR (GTI)	/artefatos/gti/adr/ quando houver decisão transversal

Estratégias de teste (quando o TDD descreve verificação)

Estratégia	Quando usar
`unitario`	Funções e classes isoladas
`integracao`	Interação entre módulos ou com banco de dados
`funcional`	Comportamento completo de uma história
`regressao`	Validar que mudanças não quebraram o existente
`carga`	Desempenho sob volume — ver HIS-HDEP
`seguranca`	Validar controles de acesso e autenticação

Regras

Cada TDD deve referenciar ao menos uma história ESP em historia-origem.
Critérios de saída devem ser mensuráveis — sem critérios vagos como “testar adequadamente”.
TDDs aprovados em um sprint são arquivados em 07-referencias/ após a entrega, quando aplicável ao modo do projeto.

← Índice IMP · API Contract →