Criando Testes de Integração para Migração de Oracle para PostgreSQL

Gera casos de teste de integração para artefatos de acesso a dados em um único projeto de destino. Os testes visam o Oracle e capturam seu comportamento como a linha de base autoritativa. Eles são escritos para serem logicamente portáteis — para que possam sobreviver à migração da Fase 6 sem reescrita — mas não são executados contra o PostgreSQL nesta fase.

Pré-requisitos

• O projeto de teste já deve existir e compilar (estruturado separadamente).
• Leia a classe de teste base existente e as convenções do gerenciador de sementes antes de escrever os testes.

Fluxo de Trabalho

Test Creation:
- [ ] Step 1: Discover the test project conventions
- [ ] Step 2: Identify testable data access artifacts
- [ ] Step 3: Create seed data
- [ ] Step 4: Write test cases
- [ ] Step 5: Review determinism

Etapa 1: Descobrir as convenções do projeto de teste

Leia a classe de teste base, o gerenciador de sementes e o arquivo do projeto para entender os padrões de herança, gerenciamento de transações e convenções de arquivo de sementes.

Etapa 2: Identificar artefatos de acesso a dados testáveis

Escopo apenas para o projeto de destino. Liste os métodos de acesso a dados que interagem com o banco de dados — repositórios, DAOs, chamadores de stored procedure, construtores de consulta.

Etapa 3: Criar dados de semente

• Siga as convenções de localização e nomenclatura de arquivos de sementes do projeto existente.
• Evite TRUNCATE TABLE — mantenha os dados existentes do banco de dados intactos.
• Assuma que linhas de negócios e linhas de consulta existentes já estão presentes; adicione apenas registros de semente mínimos e seguros contra colisões necessários para o cenário.
• Não confirme dados de semente; os testes são executados em transações que são revertidas.
• Garanta que os dados de semente não entrem em conflito com outros testes.
• Carregue e verifique os dados de semente antes que as asserções dependam deles.
• Crie ou reutilize uma classe de LookupConstants de teste para IDs/códigos de consulta estáveis usados em construtores de sementes e asserções.

Etapa 4: Escrever casos de teste

• Herde da classe de teste base para obter criação/reversão automática de transações.
• Garanta que cada método que acessa o banco de dados em escopo tenha pelo menos um teste de integração (ou vários testes para ramos de comportamento de maior risco).
• Afirme saídas lógicas (linhas, colunas, contagens, tipos de erro), não mensagens específicas da plataforma.
• Afirme valores esperados específicos — nunca afirme que um valor é meramente não nulo ou não vazio quando um valor concreto está disponível a partir dos dados de semente.
• Evite testar caminhos de código que não existem ou afirmar comportamento que não pode ocorrer.
• Evite asserções redundantes entre testes que visam o mesmo método.
• Para parâmetros de texto, inclua cobertura de string vazia e NULL/entrada ausente, onde aplicável.
• Para comportamento de data/hora, inclua asserções que validem que o valor gravado e lido de volta corresponde — use a precisão da coluna do Oracle (por exemplo, apenas segundos para uma coluna de data/hora sem frações de segundo) em vez de assumir qualquer sintaxe de tipo de banco de dados específica.

Etapa 5: Revisar determinismo

Reexamine cada asserção contra valores não nulos. Confirme que cada um é determinístico em relação aos dados semeados. Corrija qualquer asserção que dependa do estado do banco de dados fora do controle do teste.

Principais Restrições

• Apenas Fase 3 — estes testes visam o Oracle. Não invoque esta habilidade durante a Fase 6 ou contra um projeto que visa o PostgreSQL.
• Oracle é a fonte dourada — os testes capturam o comportamento esperado do Oracle.
• Portabilidade de asserção — evite mensagens de erro ou sintaxe específicas da plataforma nas asserções para que, quando o projeto de teste for migrado para o PostgreSQL na Fase 6, as asserções não exijam alterações.
• Semear apenas contra Oracle — o projeto de teste será migrado para o PostgreSQL na Fase 6; os dados de semente e a infraestrutura permanecerão com o Oracle como alvo até então.
• Escopo para um projeto — não crie testes para artefatos fora do projeto de destino.
• Preservar dados existentes — nunca reescreva ou apague linhas de negócios ou de consulta pré-existentes.