dev-testing-strategy

Testing Strategy — Software Complexo

Pirâmide de Testes

      /E2E\           → poucos, lentos, fluxos completos
     /------\
    / Integr.\        → moderados, módulos integrados
   /----------\
  /    Unit    \      → muitos, rápidos, funções isoladas

Tipo	Proporção	Ferramenta
Unit	~70%	Jest / Vitest
Integration	~20%	Jest + supertest
E2E	~10%	Playwright

Unit Tests

Testam uma função em isolamento, sem dependências externas reais.

describe('calculateDiscount', () => {
  it('should apply 10% for premium users', () => {
    expect(calculateDiscount({ price: 100, tier: 'premium' })).toBe(90)
  })

  it('should not apply discount for free users', () => {
    expect(calculateDiscount({ price: 100, tier: 'free' })).toBe(100)
  })

  it('should throw for negative price', () => {
    expect(() => calculateDiscount({ price: -10, tier: 'free' }))
      .toThrow('Price must be positive')
  })
})

Regras: Um describe por função. Um comportamento por it. Testar: happy path + edge cases + erros. Sem banco, sem API externa.

Integration Tests

Testam módulos integrados — endpoint + middleware + banco real de teste.

describe('POST /users', () => {
  it('should create user and return 201', async () => {
    const res = await request(app)
      .post('/users')
      .send({ email: '[email protected]', name: 'Test' })

    expect(res.status).toBe(201)
    expect(res.body.data).toMatchObject({ email: '[email protected]' })
    expect(res.body.meta.requestId).toBeDefined()  // requestId obrigatório
  })

  it('should return 409 when email exists', async () => {
    await createUser({ email: '[email protected]' })
    const res = await request(app)
      .post('/users').send({ email: '[email protected]', name: 'Other' })

    expect(res.status).toBe(409)
    expect(res.body.error.code).toBe('CONFLICT')
    expect(res.body.error.requestId).toBeDefined()
  })
})

Para software complexo: Usar banco real em teste — mocks de banco escondem problemas de query e migração.