Criando Relatórios de Bugs para Migração de Oracle para PostgreSQL

Quando Usar

• Documentar um defeito causado por diferenças de comportamento entre Oracle e PostgreSQL
• Escrever ou revisar um relatório de bug para um projeto de migração de Oracle para PostgreSQL

Formato do Relatório de Bug

Use o modelo em references/BUG-REPORT-TEMPLATE.md. Cada relatório deve incluir:

• Status: ✅ RESOLVIDO, ⛔ NÃO RESOLVIDO, ou ⏳ EM PROGRESSO
• Componente: Endpoint, repositório ou stored procedure afetado
• Teste: Nomes de testes automatizados relacionados
• Severidade: Baixa / Média / Alta / Crítica — com base no escopo do impacto
• Problema: Comportamento esperado no Oracle vs. comportamento observado no PostgreSQL
• Cenário: Passos de reprodução ordenados com dados de exemplo, operação, resultado esperado e resultado real
• Causa Raiz: A diferença específica de comportamento entre Oracle/PostgreSQL que causa o defeito
• Solução: Alterações feitas ou necessárias, com caminhos de arquivo explícitos
• Validação: Passos para confirmar a correção em ambos os bancos de dados

Orientações para Migração de Oracle para PostgreSQL

• Oracle é a fonte da verdade — defina o comportamento esperado a partir da linha de base do Oracle
• Destaque explicitamente as nuances da camada de dados: string vazia vs. NULL, rigor na coerção de tipos, collation, valores de sequência, fusos horários, preenchimento, constraints
• Alterações no código do cliente devem ser evitadas, a menos que sejam necessárias para o comportamento correto; quando propostas, documente e justifique-as claramente

Estilo de Escrita

• Linguagem clara, frases curtas, próximas ações claras
• Tempo verbal presente ou passado de forma consistente
• Marcadores e listas numeradas para passos e validações
• Trechos mínimos de SQL e logs como evidência; omita dados sensíveis e mantenha os trechos reproduzíveis
• Mantenha as versões de runtime/linguagem existentes; evite correções especulativas

Convenção de Nomes de Arquivo

Salve os relatórios de bug em .github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md onde:

• {ProjectName} é o nome da montagem/pasta do projeto com espaços normalizados para - (por exemplo, MyApp.DataAccess)
• <DescriptiveSlug> é um identificador curto em PascalCase descrevendo o defeito (por exemplo, EmptyStringNullHandling, RefCursorUnwrapFailure)