Testes e Homologação

Testes

A estratégia de testes do TutorVest foi construída para garantir confiança em cada etapa do ciclo de desenvolvimento, cobrindo as duas camadas da aplicação — frontend e backend — com abordagens distintas e complementares. Todos os testes são executados automaticamente pelo pipeline de CI via GitHub Actions, bloqueando merges em caso de falha e assegurando que apenas código validado avança no fluxo de branches. A combinação de testes unitários, de componentes e de integração forma uma rede de segurança progressiva: feedback rápido nas features do dia a dia e validação completa de ponta a ponta antes de cada promoção para produção.

Frontend

Os testes do frontend são executados com Vitest e cobrem componentes, hooks e utilitários da aplicação Next.js. O conjunto atual conta com 90 arquivos de teste e 757 asserções, todos executados automaticamente a cada pull request via yarn test. O relatório de cobertura é gerado e publicado ao fim de cada execução na pipeline.

Backend — Testes unitários

Os testes unitários do backend são organizados por camada, seguindo a separação imposta pela Clean Architecture: entidades, value objects, strategies, persistence mappers e casos de uso são testados de forma isolada, sem dependência de banco de dados ou infraestrutura externa. Executados com yarn test:unit, cobrem os módulos de gerenciamento de usuários, tutoria e documentos, entre outros. A pipeline executa esses testes em PRs abertos tanto para develop quanto para main.

Backend — Testes de integração

Os testes de integração validam os casos de uso de ponta a ponta contra um banco de dados real. Na pipeline do GitHub Actions, um contêiner Docker do PostgreSQL é provisionado automaticamente via services, os testes são executados com yarn test:integration e o ambiente é descartado ao fim do job — sem estado residual entre execuções. Esses testes rodam exclusivamente em PRs abertos para a branch main, funcionando como o gate final antes da promoção para produção.

Homologação do Cliente

Tayguara Velozo, nosso cliente, validou em reunião via Google Meet, com espelhamento de tela e análise direta do ambiente disponibilizado no servidor de homologação,  que as funcionalidades, previamente acordadas no Documento de Escopo e Planejamento do MVP (v1.0, 03/04/2026), foram implementadas e entregues conforme especificado. Além disso, recebemos o aval do cliente por e-mail, homologando e concordando com as funcionalidades implementadas no TutorVest.