test-driven-development-practices

🧪 Test-Driven Development (TDD) - Practices

📋 Checklist TDD Obrigatório

BEFORE escrever QUALQUER código crítico, SEMPRE verificar:

1. [ ] Escrevi o teste que falha (Red)?

   • Teste define comportamento esperado?
   • Teste pode detectar erros?
   • Teste compila (mesmo que função não exista ainda)?

2. [ ] O teste é atômico e focado?

   • Testa uma única coisa?
   • Nome descritivo (<Scenario>_<Condition>_<ExpectedResult>)?
   • Independente de outros testes?

3. [ ] O teste NÃO tem lógica interna?

   • Valor esperado é hardcoded (não calculado)?
   • Teste chama a função real do módulo oficial?
   • Mock apenas simula dados (não implementa lógica)?
   • Teste falharia se o código estivesse errado?
   • Não há lógica de cálculo no teste?

4. [ ] A função será testável isoladamente?

   • Sem dependências ocultas?
   • Parâmetros claros?
   • Retorno verificável?

5. [ ] Implementação mínima faz teste passar (Green)?

   • Solução mais simples possível?
   • Teste fica verde?
   • Comportamento básico funciona?

6. [ ] Refatorei com segurança (Refactor)?

   • Testes ainda passam?
   • Código melhorado sem quebrar comportamento?
   • Clean Code aplicado?

Se QUALQUER resposta for NÃO → PARAR e corrigir antes de continuar

⚠️ Exceções: Quando Test-After é Aceitável

Test-After (escrever teste depois) é aceitável quando:

• ❌ Getters/Setters simples (sem lógica)

  // Não precisa de teste primeiro
  float GetHealth() const { return Health; }
  void SetHealth(float NewHealth) { Health = NewHealth; }
  

• ❌ Wrappers diretos de API Unreal (sem lógica customizada)

  // Wrapper simples, testar depois se necessário
  UDataTable* GetRaceDataTable() const { return RaceDataTable; }
  

• ❌ Integração com Blueprint (testar depois pode ser mais prático)

  // Integração complexa, testar depois
  UFUNCTION(BlueprintCallable)
  void InitializeFromBlueprint(UCharacterSheetDataAsset* Asset);