Como garantir qualidade em customizações Odoo?
Customizar o Odoo pode ser necessário para atender uma regra fiscal, integrar outro sistema, automatizar um processo ou sustentar um diferencial da empresa.
O problema não está na existência da customização. O risco aparece quando ela é entregue sem requisitos claros, revisão de código, testes, homologação, documentação e estratégia de manutenção.
Uma alteração pode funcionar no cenário demonstrado e ainda falhar quando outro usuário executa, outra empresa está ativa, o documento é cancelado, o volume cresce, uma integração fica indisponível ou a versão do Odoo é atualizada.
Resposta direta: como garantir qualidade?
Uma entrega confiável combina requisitos testáveis, arquitetura adequada, padrões de código, revisão por outra pessoa, testes automatizados, homologação funcional, integração contínua, controle de versão, ambiente de testes e monitoramento pós-publicação.
O processo precisa responder: o que a customização deve fazer, quais cenários foram testados, quais riscos existem, quem aprovou, como publicar, como reverter e como manter na próxima versão.
Não existe uma única técnica capaz de garantir qualidade. O resultado vem da combinação de controles técnicos, funcionais e operacionais.
O que significa qualidade em uma customização?
| Dimensão | Pergunta |
|---|---|
| Aderência funcional | A solução atende ao processo e aos critérios de aceite? |
| Integridade | Os dados permanecem corretos e consistentes? |
| Segurança | Usuários acessam somente o que deveriam? |
| Desempenho | O processo suporta o volume esperado? |
| Usabilidade | O usuário consegue concluir a tarefa com clareza? |
| Manutenibilidade | Outra pessoa consegue compreender e evoluir o código? |
| Observabilidade | Falhas e degradações podem ser detectadas? |
| Migrabilidade | Existe caminho para atualizar o módulo e os dados? |
Qualidade começa no requisito
Um desenvolvimento não pode ser testado adequadamente quando a expectativa é vaga. Expressões como “melhorar a aprovação”, “automatizar a nota” ou “fazer igual ao sistema antigo” não definem o comportamento esperado.
Uma descrição mais testável seria: pedidos de compra acima do limite da empresa devem permanecer bloqueados até a aprovação do grupo responsável, registrando decisão, data e comentário.
Critérios de aceite
Critérios de aceite descrevem o comportamento esperado. Uma estrutura útil é: dado um contexto, quando uma ação acontece, então determinado resultado deve ocorrer.
Exemplo: dado um pedido acima do limite, quando o comprador tentar confirmar, então o sistema deve solicitar aprovação e impedir a confirmação até uma decisão válida.
Inclua cenários de rejeição, cancelamento, alteração de valor, usuário não autorizado e empresa diferente.
Classifique o risco da mudança
| Risco | Exemplo | Controles esperados |
|---|---|---|
| Baixo | Campo informativo sem lógica crítica | Revisão, instalação e homologação básica |
| Médio | Automação comercial ou relatório gerencial | Testes funcionais, regressão e permissões |
| Alto | Estoque, financeiro, fiscal ou integração crítica | Testes automatizados, segurança, volume e contingência |
| Crítico | Pagamento, emissão em massa ou migração | Revisão reforçada, ensaio, monitoramento e rollback |
A classificação deve considerar impacto, frequência, reversibilidade, volume, sensibilidade e dependências externas.
Teste automatizado, homologação e monitoramento
| Controle | Finalidade |
|---|---|
| Teste automatizado | Verificar regras repetíveis e proteger contra regressões |
| Revisão de código | Encontrar riscos, inconsistências e alternativas |
| Homologação funcional | Confirmar que o processo atende à operação real |
| Teste de integração | Validar comunicação entre componentes e sistemas |
| Teste de desempenho | Confirmar comportamento com volume representativo |
| Monitoramento | Detectar falhas depois da publicação |
O usuário pode homologar um fluxo, mas dificilmente repetirá centenas de combinações em toda alteração futura. O teste automatizado pode validar a regra, mas não garante que a experiência atende ao usuário.
A pirâmide de testes
Uma estratégia equilibrada possui muitos testes rápidos nas camadas inferiores e menos testes completos nas camadas superiores.
Na base: métodos, cálculos, restrições e permissões. No meio: documentos relacionados, módulos e integrações. No topo: tours, fluxos ponta a ponta e homologação.
Tour protege a jornada. Teste unitário protege a regra. Uma boa suíte utiliza os dois no lugar adequado.
Testes Python no Odoo
O framework do Odoo suporta testes Python baseados em unittest. Eles são adequados para validar modelos, cálculos, restrições, métodos, criação de documentos, estados, permissões e regras de negócio.
Classes como TransactionCase permitem executar cenários com transações controladas. Os testes devem permanecer dentro do módulo e acompanhar sua evolução.
O que testar no backend?
Priorize comportamentos próprios: cálculo de limite, seleção de regra, criação de documento relacionado, bloqueio por estado, distribuição por empresa, atualização de saldo e tratamento de exceção.
Teste entrada válida, limite, entrada inválida, ausência de dado, cancelamento e permissão.
Instalação e atualização
Um módulo precisa instalar sem dependências ausentes, XML inválido, referências inexistentes, acessos incompletos ou assets quebrados.
Projetos mantidos também precisam testar a atualização sobre uma base existente. Novos campos, mudanças de tipo, XML IDs, dados noupdate, views e registros históricos podem funcionar em instalação limpa e falhar durante o upgrade do módulo.
Tags e seleção de testes
Odoo permite selecionar testes por tags, módulos, classes e métodos. Isso ajuda a separar testes rápidos, pós-instalação, cenários lentos e grupos específicos.
Uma estratégia pode executar testes rápidos em toda alteração e uma suíte mais ampla antes da publicação. Tags mal utilizadas podem deixar cenários importantes fora do pipeline.
Testes de JavaScript
Customizações de interface precisam de testes próprios. Odoo 19 utiliza o framework HOOT para testes unitários de JavaScript.
Esses testes podem verificar componentes, serviços, eventos, DOM, formatação, ações do usuário e respostas simuladas. Helpers do cliente web e um servidor simulado ajudam a isolar os cenários.
Mock server
Em testes de frontend, o servidor simulado pode responder chamadas comuns sem alterar uma base real. Isso torna o cenário rápido e previsível.
O mock, porém, precisa representar respostas relevantes do servidor. Um mock incorreto pode permitir que o frontend passe e a integração real falhe.
Tours e testes ponta a ponta
Tours simulam passos realizados no navegador e ajudam a validar a comunicação entre interface, JavaScript, servidor, modelos, views e ações.
Exemplos: criar um pedido, preencher campos, confirmar, abrir o documento relacionado e verificar o resultado.
Utilize tours para jornadas importantes, não para cada detalhe visual.
Testes manuais continuam necessários
Testes manuais são importantes para usabilidade, textos, impressão, percepção visual, dispositivos e investigação exploratória.
Um teste manual confiável possui roteiro e evidência: pré-condição, passos, resultado esperado, resultado obtido, ambiente, usuário e anexo.
Homologação funcional
A homologação confirma que a solução atende ao negócio. Deve ser executada por responsáveis funcionais e usuários-chave com autoridade para aprovar.
Desenvolvedor verifica se implementou a regra. Usuário responsável confirma se a regra representa a operação.
| Item | Conteúdo |
|---|---|
| Cenário | Processo ou regra testada |
| Pré-condição | Dados, usuários e estados necessários |
| Passos | Ações executadas |
| Resultado esperado | Comportamento previsto |
| Evidência | Registro, captura, relatório ou log |
| Conclusão | Aprovado, reprovado ou aprovado com pendência |
Fluxo principal e exceções
O fluxo principal confirma a operação mais frequente. As exceções verificam se o sistema permanece seguro diante de falta de estoque, desconto fora do limite, documento rejeitado, pagamento parcial, usuário sem acesso, integração indisponível, devolução e cancelamento.
Teste de regressão
Regressão acontece quando uma alteração quebra algo que funcionava. Uma correção em vendas pode afetar estoque, faturamento, portal, integração e relatório.
Todo bug relevante é candidato a um teste que impeça seu retorno.
Segurança
Teste com usuários reais de cada perfil. Verifique leitura, criação, alteração, exclusão, exportação, botões, campos, empresas e registros próprios.
Odoo utiliza direitos de acesso, regras de registro, grupos em campos e verificações no código. Esconder uma opção na view não é proteção suficiente.
Métodos públicos e sudo
Métodos públicos podem ser acionados por mecanismos remotos compatíveis. Valide permissão, empresa, estado, valores e consistência antes de executar ações críticas.
sudo() pode ser necessário em situações específicas, mas também contorna regras. Ele não deve ser utilizado apenas para fazer o erro de acesso desaparecer.
Testes multiempresa
Teste usuário de uma empresa, usuário com várias empresas, registros compartilhados, propriedades específicas e documentos intercompany.
Verifique contas, impostos, diários, armazéns, sequências e parceiros. Um cenário testado apenas na matriz pode falhar em outro CNPJ.
Testes de integração
Valide sucesso, timeout, indisponibilidade, autenticação inválida, payload incompleto, duplicidade, reprocessamento e resposta inesperada.
Teste identificadores, estados, datas, moedas, anexos e volumes. Integração não está testada quando apenas um exemplo de sucesso foi enviado e recebido.
Idempotência
Repita o mesmo evento. O mesmo pedido externo, pagamento ou confirmação não deve criar documentos duplicados.
Um fluxo que funciona uma vez pode falhar na primeira retentativa. Idempotência precisa ser testada, não presumida.
Testes de desempenho
Uma customização pode funcionar com dez registros e falhar com milhares. Teste volumes representativos para importação, emissão em lote, recomputação, dashboard, confirmação, estoque e integração.
Meça tempo, consultas SQL, memória, concorrência e impacto sobre outros usuários.
Consultas em loop
Buscas ou gravações executadas para cada registro podem produzir centenas ou milhares de consultas. Operações em lote, agregações e uso adequado do ORM costumam ser mais sustentáveis.
Profiler
O profiler ajuda a localizar gargalos. Como a própria coleta possui custo, a medição final deve considerar condições semelhantes de cache, dados e carga, preferencialmente também sem a sobrecarga do profiler.
Testes fiscais
Customizações fiscais exigem cenários definidos com responsáveis fiscais e contábeis. Teste empresa, regime, produto, serviço, operação, estado, município, parceiro, imposto, retenção e documento.
Também teste autorização, rejeição, cancelamento, contingência e retorno.
Um documento autorizado em um cenário não comprova todas as operações fiscais da empresa.
Relatórios, e-mails e automações
Relatórios precisam ser validados em valores, filtros, totais, moeda, idioma, quebra de página, campos longos, logotipo e permissões.
E-mails precisam ser testados em assunto, remetente, destinatários, corpo, links e anexos, sem disparar para contatos reais durante a homologação.
Ações automáticas precisam ser testadas com registros que atendem e que não atendem às condições. Verifique repetição, loops, retroatividade, usuário técnico e multiempresa.
Migração de versão
Uma customização precisa ser adaptada quando modelos, campos, views ou APIs mudam. O processo inclui instalar em base vazia da nova versão, corrigir incompatibilidades, executar testes, migrar dados e testar sobre cópia atualizada.
A base vazia valida a compatibilidade do código. A base migrada valida a compatibilidade com os dados e as configurações do cliente.
Scripts de migração
Scripts podem precisar renomear, transformar, recalcular, consolidar, remover ou corrigir dados. Eles devem ser testados em volume, com registros incompletos e conciliação do resultado.
Ensaio da atualização
Antes da produção, execute um ensaio completo. Meça backup, restauração, migração, atualização de módulos, validação e indisponibilidade. Registre comandos, responsáveis e problemas encontrados.
Revisão de código
Outra pessoa deve analisar alterações relevantes. A revisão verifica aderência ao requisito, arquitetura, legibilidade, segurança, desempenho, testes, compatibilidade e manutenção.
Pull request
Uma pull request deve explicar problema, solução, módulos afetados, passos de teste, riscos, migração e evidências.
Alterações enormes e misturadas dificultam revisão. Separe refatoração, funcionalidade e correção quando possível.
Padrões, lint e pre-commit
Padrões podem incluir PEP 8, organização de imports, formatação, convenções Odoo, nomes e estrutura de módulos.
Pre-commit, linters, formatadores e verificações específicas podem encontrar inconsistências antes da CI e da revisão.
Verificação automática resolve problemas repetitivos e libera a revisão humana para arquitetura, regra e risco.
Integração contínua
CI executa verificações a cada alteração ou pull request. Um pipeline pode incluir lint, instalação, atualização, testes Python, testes JavaScript, tours e construção do ambiente.
| Etapa | Objetivo |
|---|---|
| Validação estática | Encontrar padrões e arquivos incorretos |
| Instalação | Confirmar dependências e dados iniciais |
| Atualização | Validar evolução do módulo |
| Testes próprios | Proteger regras da customização |
| Testes relacionados | Detectar regressões em dependências |
| Ambiente | Preparar versão reproduzível para homologação |
A CI não substitui o ambiente de homologação. Ela utiliza bases controladas; a homologação valida configurações, dados, perfis e integrações do projeto.
Testes instáveis e cobertura
Um teste instável passa e falha sem mudança relevante. Causas podem incluir tempo, ordem, dados compartilhados, concorrência e dependência externa. Repetir até passar não resolve o problema.
Cobertura ajuda a identificar código não exercitado, mas percentual alto não garante cenários de qualidade. Priorize regras críticas, limites, erros, segurança e regressões.
Dados de teste
Dados devem ser pequenos, claros, independentes e adequados ao cenário. Evite informações sensíveis reais no repositório.
Um teste confiável produz o mesmo resultado sozinho, em conjunto e em diferentes execuções.
Ambiente de homologação
O ambiente deve ser próximo da produção em versão, código, módulos, parâmetros, infraestrutura e integrações relevantes.
Cópias de produção podem ajudar com volume e histórico, mas precisam de acesso controlado, anonimização, retenção e neutralização de e-mails, pagamentos e integrações.
Homologação só produz confiança quando o ambiente representa suficientemente o local em que a mudança será executada.
Git, branches e versionamento
Customizações em código devem estar no Git. O repositório registra histórico, autor, revisão, branch, tag e relação com a entrega.
A passagem entre desenvolvimento, homologação e produção deve utilizar o mesmo commit ou artefato.
Documentação
A documentação técnica deve explicar finalidade, arquitetura, modelos, configurações, integrações, crons, permissões, testes e publicação.
A documentação funcional deve explicar quando utilizar, campos, etapas, responsabilidades, exceções e resultado. Ela deve descrever o processo, não apenas as telas.
Definição de pronto
| Critério | Exemplo |
|---|---|
| Requisito | Critérios de aceite atendidos |
| Código | Padrões e revisão concluídos |
| Testes | Automatizados e manuais aprovados |
| Segurança | Perfis e empresas validados |
| Desempenho | Volume representativo testado quando aplicável |
| Documentação | Técnica e funcional atualizadas |
| Homologação | Responsável funcional aprovou |
| Publicação | Monitoramento e rollback definidos |
Publicação e rollback
Antes de publicar, confirme commit, módulos, dependências, backup, janela, migração, responsáveis e comunicação.
Rollback precisa considerar código, banco, scripts e transações realizadas após a publicação. Voltar o código pode não ser suficiente quando os dados foram transformados.
Smoke test e monitoramento
Depois da publicação, execute testes rápidos dos processos críticos: login, abertura de telas, criação de documento, confirmação, impressão e integração.
Monitore logs, erros, filas, crons, tempo de resposta, banco e integrações. Também acompanhe sinais funcionais, como documentos pendentes, notas rejeitadas e sincronizações atrasadas.
Incidentes devem gerar aprendizado
Quando ocorrer um problema, registre impacto, linha do tempo, causa, correção, contorno e prevenção.
Pergunte qual teste, alerta, revisão ou processo poderia ter detectado ou evitado o incidente. Transforme a resposta em melhoria.
Módulos OCA e qualidade
Utilizar um módulo da OCA pode reduzir desenvolvimento próprio, mas não elimina avaliação e homologação.
Verifique versão, licença, maturidade, mantenedores, dependências, testes, issues, pull requests e aderência ao processo.
Mesmo quando o módulo possui testes, o projeto pode precisar validar sua combinação com localização brasileira, outros módulos e configurações do cliente.
Qualidade comunitária reduz riscos, mas não transforma qualquer módulo em solução pronta para qualquer cliente.
Community, Enterprise e Studio
Qualidade é necessária em Community e Enterprise. Projetos das duas edições podem possuir módulos próprios, integrações e componentes OCA compatíveis.
Alterações realizadas com Studio também precisam de inventário, teste e governança. Para lógica crítica, integração e comportamento reutilizável, módulos em Python oferecem maior capacidade de versionamento, revisão e testes.
Quando não customizar?
Antes do desenvolvimento, avalie padrão do Odoo, configuração, OCA, integração existente e mudança de processo.
Não customizar pode ser a melhor decisão quando o benefício é pequeno, a exceção é rara ou o custo de manutenção é desproporcional.
Erros comuns
Testar apenas como administrador
Permissões e multiempresa ficam sem validação.
Homologar apenas a demonstração
Usuário observa, mas não executa casos próprios.
Testar somente o fluxo feliz
Cancelamentos e exceções aparecem em produção.
Confiar apenas na instalação
Módulo instala, mas falha durante o uso.
Não testar atualização
Base nova funciona e base existente quebra.
Corrigir bug sem teste de regressão
O mesmo problema pode voltar.
Ignorar desempenho
Processo funciona apenas com pouco volume.
Editar produção diretamente
Código publicado deixa de corresponder ao Git.
Confundir cobertura com qualidade
Linhas executadas não garantem regras verificadas.
Checklist técnico da entrega
| Área | Controle |
|---|---|
| Código | Git, padrão, escopo e revisão |
| Instalação | Módulo instala sem erro relevante |
| Atualização | Base existente atualiza corretamente |
| Backend | Regras e exceções possuem testes |
| Frontend | Componentes e interações foram validados |
| Segurança | ACL, regras, campos e métodos foram testados |
| Multiempresa | Entidades e propriedades estão consistentes |
| Desempenho | Volume e consultas foram avaliados |
| Integração | Falhas, retentativas e duplicidade foram testadas |
| Migração | Scripts são repetíveis e conciliados |
| Documentação | Uso, configuração e manutenção estão descritos |
| CI | Controles obrigatórios passaram |
Checklist de publicação
| Item | Definição |
|---|---|
| Versão | Commit e módulos identificados |
| Janela | Horário e impacto comunicados |
| Backup | Cópia e restauração compatíveis |
| Procedimento | Passos e comandos documentados |
| Responsáveis | Técnico e funcional disponíveis |
| Rollback | Ponto de decisão e recuperação definidos |
| Smoke test | Cenários rápidos preparados |
| Monitoramento | Logs, filas e processos acompanhados |
A abordagem da Escodoo
A Escodoo trata customizações como componentes que precisarão funcionar, ser suportados e migrados durante todo o ciclo de vida do Odoo.
Nossa abordagem pode incluir levantamento, fit-gap, módulo Python, Git, revisão de código, testes automatizados, CI, homologação, segurança, desempenho, publicação e monitoramento.
Atuamos com Odoo Community, Enterprise, módulos da OCA, localização brasileira, integrações, Doodba, GitHub Actions e Escodoo Cloud.
Perguntas frequentes
Odoo possui framework de testes?
Sim. Odoo suporta testes Python, testes unitários de JavaScript e tours para cenários de integração entre navegador e servidor.
Todo módulo precisa de testes automatizados?
O nível deve acompanhar o risco. Regras críticas, cálculos, segurança, integrações e regressões deveriam possuir proteção automatizada.
Homologação substitui testes automatizados?
Não. Homologação valida aderência funcional; testes automatizados repetem verificações e protegem evoluções futuras.
É necessário testar como usuário comum?
Sim. Testar apenas como administrador pode esconder falhas de permissão, regra de registro e multiempresa.
Como testar integrações?
Valide sucesso, falha, timeout, duplicidade, autenticação, reprocessamento, identificadores e observabilidade.
O que é teste de regressão?
É a verificação de que uma alteração não quebrou funções que já estavam operando.
Qual é a função da CI?
Executar verificações repetíveis a cada mudança, antes que o código avance para homologação ou produção.
Percentual de cobertura garante qualidade?
Não. Cobertura mostra código executado, mas não garante que cenários importantes foram corretamente verificados.
Módulo OCA precisa ser homologado?
Sim. Testes comunitários ajudam, mas a combinação de módulos, configurações e processos do cliente precisa de validação própria.
Como preparar uma migração de versão?
Teste módulos em base vazia da nova versão, adapte código e testes, migre dados, valide a base atualizada e faça ensaio antes da produção.
Conclusão: qualidade acompanha todo o ciclo
Customizações Odoo precisam ser tratadas como software de negócio, não como alterações isoladas de tela.
A qualidade começa com requisitos e critérios de aceite. Revisão e padrões reduzem erros antes da execução. Testes Python, JavaScript e tours protegem regras e integrações. Homologação confirma aderência ao processo.
Segurança, multiempresa, desempenho, fiscal e migração precisam de cenários próprios. CI torna controles repetíveis. Git mantém rastreabilidade. Publicação planejada reduz risco. Monitoramento detecta falhas depois do go-live.
Precisa desenvolver ou revisar customizações Odoo?
A Escodoo pode apoiar análise, arquitetura, desenvolvimento em Python, revisão, testes automatizados, CI, homologação, segurança e migração.
Trabalhamos com Odoo Community, Enterprise, módulos da OCA, localização brasileira, integrações e Escodoo Cloud.
Fale com nossa equipe e estruture customizações confiáveis, testáveis e preparadas para evoluir com o seu ambiente.
Avaliar minhas customizações OdooComo garantir qualidade em customizações Odoo?
Customizar o Odoo pode ser necessário para atender uma regra fiscal, integrar outro sistema, automatizar um processo ou sustentar um diferencial da empresa.
O problema não está na existência da customização. O risco aparece quando ela é entregue sem requisitos claros, revisão de código, testes, homologação, documentação e estratégia de manutenção.
Uma alteração pode funcionar no cenário demonstrado e ainda falhar quando outro usuário executa, outra empresa está ativa, o documento é cancelado, o volume cresce, uma integração fica indisponível ou a versão do Odoo é atualizada.
Resposta direta: como garantir qualidade?
Uma entrega confiável combina requisitos testáveis, arquitetura adequada, padrões de código, revisão por outra pessoa, testes automatizados, homologação funcional, integração contínua, controle de versão, ambiente de testes e monitoramento pós-publicação.
O processo precisa responder: o que a customização deve fazer, quais cenários foram testados, quais riscos existem, quem aprovou, como publicar, como reverter e como manter na próxima versão.
Não existe uma única técnica capaz de garantir qualidade. O resultado vem da combinação de controles técnicos, funcionais e operacionais.
O que significa qualidade em uma customização?
| Dimensão | Pergunta |
|---|---|
| Aderência funcional | A solução atende ao processo e aos critérios de aceite? |
| Integridade | Os dados permanecem corretos e consistentes? |
| Segurança | Usuários acessam somente o que deveriam? |
| Desempenho | O processo suporta o volume esperado? |
| Usabilidade | O usuário consegue concluir a tarefa com clareza? |
| Manutenibilidade | Outra pessoa consegue compreender e evoluir o código? |
| Observabilidade | Falhas e degradações podem ser detectadas? |
| Migrabilidade | Existe caminho para atualizar o módulo e os dados? |
Qualidade começa no requisito
Um desenvolvimento não pode ser testado adequadamente quando a expectativa é vaga. Expressões como “melhorar a aprovação”, “automatizar a nota” ou “fazer igual ao sistema antigo” não definem o comportamento esperado.
Uma descrição mais testável seria: pedidos de compra acima do limite da empresa devem permanecer bloqueados até a aprovação do grupo responsável, registrando decisão, data e comentário.
Critérios de aceite
Critérios de aceite descrevem o comportamento esperado. Uma estrutura útil é: dado um contexto, quando uma ação acontece, então determinado resultado deve ocorrer.
Exemplo: dado um pedido acima do limite, quando o comprador tentar confirmar, então o sistema deve solicitar aprovação e impedir a confirmação até uma decisão válida.
Inclua cenários de rejeição, cancelamento, alteração de valor, usuário não autorizado e empresa diferente.
Classifique o risco da mudança
| Risco | Exemplo | Controles esperados |
|---|---|---|
| Baixo | Campo informativo sem lógica crítica | Revisão, instalação e homologação básica |
| Médio | Automação comercial ou relatório gerencial | Testes funcionais, regressão e permissões |
| Alto | Estoque, financeiro, fiscal ou integração crítica | Testes automatizados, segurança, volume e contingência |
| Crítico | Pagamento, emissão em massa ou migração | Revisão reforçada, ensaio, monitoramento e rollback |
A classificação deve considerar impacto, frequência, reversibilidade, volume, sensibilidade e dependências externas.
Teste automatizado, homologação e monitoramento
| Controle | Finalidade |
|---|---|
| Teste automatizado | Verificar regras repetíveis e proteger contra regressões |
| Revisão de código | Encontrar riscos, inconsistências e alternativas |
| Homologação funcional | Confirmar que o processo atende à operação real |
| Teste de integração | Validar comunicação entre componentes e sistemas |
| Teste de desempenho | Confirmar comportamento com volume representativo |
| Monitoramento | Detectar falhas depois da publicação |
O usuário pode homologar um fluxo, mas dificilmente repetirá centenas de combinações em toda alteração futura. O teste automatizado pode validar a regra, mas não garante que a experiência atende ao usuário.
A pirâmide de testes
Uma estratégia equilibrada possui muitos testes rápidos nas camadas inferiores e menos testes completos nas camadas superiores.
Na base: métodos, cálculos, restrições e permissões. No meio: documentos relacionados, módulos e integrações. No topo: tours, fluxos ponta a ponta e homologação.
Tour protege a jornada. Teste unitário protege a regra. Uma boa suíte utiliza os dois no lugar adequado.
Testes Python no Odoo
O framework do Odoo suporta testes Python baseados em unittest. Eles são adequados para validar modelos, cálculos, restrições, métodos, criação de documentos, estados, permissões e regras de negócio.
Classes como TransactionCase permitem executar cenários com transações controladas. Os testes devem permanecer dentro do módulo e acompanhar sua evolução.
O que testar no backend?
Priorize comportamentos próprios: cálculo de limite, seleção de regra, criação de documento relacionado, bloqueio por estado, distribuição por empresa, atualização de saldo e tratamento de exceção.
Teste entrada válida, limite, entrada inválida, ausência de dado, cancelamento e permissão.
Instalação e atualização
Um módulo precisa instalar sem dependências ausentes, XML inválido, referências inexistentes, acessos incompletos ou assets quebrados.
Projetos mantidos também precisam testar a atualização sobre uma base existente. Novos campos, mudanças de tipo, XML IDs, dados noupdate, views e registros históricos podem funcionar em instalação limpa e falhar durante o upgrade do módulo.
Tags e seleção de testes
Odoo permite selecionar testes por tags, módulos, classes e métodos. Isso ajuda a separar testes rápidos, pós-instalação, cenários lentos e grupos específicos.
Uma estratégia pode executar testes rápidos em toda alteração e uma suíte mais ampla antes da publicação. Tags mal utilizadas podem deixar cenários importantes fora do pipeline.
Testes de JavaScript
Customizações de interface precisam de testes próprios. Odoo 19 utiliza o framework HOOT para testes unitários de JavaScript.
Esses testes podem verificar componentes, serviços, eventos, DOM, formatação, ações do usuário e respostas simuladas. Helpers do cliente web e um servidor simulado ajudam a isolar os cenários.
Mock server
Em testes de frontend, o servidor simulado pode responder chamadas comuns sem alterar uma base real. Isso torna o cenário rápido e previsível.
O mock, porém, precisa representar respostas relevantes do servidor. Um mock incorreto pode permitir que o frontend passe e a integração real falhe.
Tours e testes ponta a ponta
Tours simulam passos realizados no navegador e ajudam a validar a comunicação entre interface, JavaScript, servidor, modelos, views e ações.
Exemplos: criar um pedido, preencher campos, confirmar, abrir o documento relacionado e verificar o resultado.
Utilize tours para jornadas importantes, não para cada detalhe visual.
Testes manuais continuam necessários
Testes manuais são importantes para usabilidade, textos, impressão, percepção visual, dispositivos e investigação exploratória.
Um teste manual confiável possui roteiro e evidência: pré-condição, passos, resultado esperado, resultado obtido, ambiente, usuário e anexo.
Homologação funcional
A homologação confirma que a solução atende ao negócio. Deve ser executada por responsáveis funcionais e usuários-chave com autoridade para aprovar.
Desenvolvedor verifica se implementou a regra. Usuário responsável confirma se a regra representa a operação.
| Item | Conteúdo |
|---|---|
| Cenário | Processo ou regra testada |
| Pré-condição | Dados, usuários e estados necessários |
| Passos | Ações executadas |
| Resultado esperado | Comportamento previsto |
| Evidência | Registro, captura, relatório ou log |
| Conclusão | Aprovado, reprovado ou aprovado com pendência |
Fluxo principal e exceções
O fluxo principal confirma a operação mais frequente. As exceções verificam se o sistema permanece seguro diante de falta de estoque, desconto fora do limite, documento rejeitado, pagamento parcial, usuário sem acesso, integração indisponível, devolução e cancelamento.
Teste de regressão
Regressão acontece quando uma alteração quebra algo que funcionava. Uma correção em vendas pode afetar estoque, faturamento, portal, integração e relatório.
Todo bug relevante é candidato a um teste que impeça seu retorno.
Segurança
Teste com usuários reais de cada perfil. Verifique leitura, criação, alteração, exclusão, exportação, botões, campos, empresas e registros próprios.
Odoo utiliza direitos de acesso, regras de registro, grupos em campos e verificações no código. Esconder uma opção na view não é proteção suficiente.
Métodos públicos e sudo
Métodos públicos podem ser acionados por mecanismos remotos compatíveis. Valide permissão, empresa, estado, valores e consistência antes de executar ações críticas.
sudo() pode ser necessário em situações específicas, mas também contorna regras. Ele não deve ser utilizado apenas para fazer o erro de acesso desaparecer.
Testes multiempresa
Teste usuário de uma empresa, usuário com várias empresas, registros compartilhados, propriedades específicas e documentos intercompany.
Verifique contas, impostos, diários, armazéns, sequências e parceiros. Um cenário testado apenas na matriz pode falhar em outro CNPJ.
Testes de integração
Valide sucesso, timeout, indisponibilidade, autenticação inválida, payload incompleto, duplicidade, reprocessamento e resposta inesperada.
Teste identificadores, estados, datas, moedas, anexos e volumes. Integração não está testada quando apenas um exemplo de sucesso foi enviado e recebido.
Idempotência
Repita o mesmo evento. O mesmo pedido externo, pagamento ou confirmação não deve criar documentos duplicados.
Um fluxo que funciona uma vez pode falhar na primeira retentativa. Idempotência precisa ser testada, não presumida.
Testes de desempenho
Uma customização pode funcionar com dez registros e falhar com milhares. Teste volumes representativos para importação, emissão em lote, recomputação, dashboard, confirmação, estoque e integração.
Meça tempo, consultas SQL, memória, concorrência e impacto sobre outros usuários.
Consultas em loop
Buscas ou gravações executadas para cada registro podem produzir centenas ou milhares de consultas. Operações em lote, agregações e uso adequado do ORM costumam ser mais sustentáveis.
Profiler
O profiler ajuda a localizar gargalos. Como a própria coleta possui custo, a medição final deve considerar condições semelhantes de cache, dados e carga, preferencialmente também sem a sobrecarga do profiler.
Testes fiscais
Customizações fiscais exigem cenários definidos com responsáveis fiscais e contábeis. Teste empresa, regime, produto, serviço, operação, estado, município, parceiro, imposto, retenção e documento.
Também teste autorização, rejeição, cancelamento, contingência e retorno.
Um documento autorizado em um cenário não comprova todas as operações fiscais da empresa.
Relatórios, e-mails e automações
Relatórios precisam ser validados em valores, filtros, totais, moeda, idioma, quebra de página, campos longos, logotipo e permissões.
E-mails precisam ser testados em assunto, remetente, destinatários, corpo, links e anexos, sem disparar para contatos reais durante a homologação.
Ações automáticas precisam ser testadas com registros que atendem e que não atendem às condições. Verifique repetição, loops, retroatividade, usuário técnico e multiempresa.
Migração de versão
Uma customização precisa ser adaptada quando modelos, campos, views ou APIs mudam. O processo inclui instalar em base vazia da nova versão, corrigir incompatibilidades, executar testes, migrar dados e testar sobre cópia atualizada.
A base vazia valida a compatibilidade do código. A base migrada valida a compatibilidade com os dados e as configurações do cliente.
Scripts de migração
Scripts podem precisar renomear, transformar, recalcular, consolidar, remover ou corrigir dados. Eles devem ser testados em volume, com registros incompletos e conciliação do resultado.
Ensaio da atualização
Antes da produção, execute um ensaio completo. Meça backup, restauração, migração, atualização de módulos, validação e indisponibilidade. Registre comandos, responsáveis e problemas encontrados.
Revisão de código
Outra pessoa deve analisar alterações relevantes. A revisão verifica aderência ao requisito, arquitetura, legibilidade, segurança, desempenho, testes, compatibilidade e manutenção.
Pull request
Uma pull request deve explicar problema, solução, módulos afetados, passos de teste, riscos, migração e evidências.
Alterações enormes e misturadas dificultam revisão. Separe refatoração, funcionalidade e correção quando possível.
Padrões, lint e pre-commit
Padrões podem incluir PEP 8, organização de imports, formatação, convenções Odoo, nomes e estrutura de módulos.
Pre-commit, linters, formatadores e verificações específicas podem encontrar inconsistências antes da CI e da revisão.
Verificação automática resolve problemas repetitivos e libera a revisão humana para arquitetura, regra e risco.
Integração contínua
CI executa verificações a cada alteração ou pull request. Um pipeline pode incluir lint, instalação, atualização, testes Python, testes JavaScript, tours e construção do ambiente.
| Etapa | Objetivo |
|---|---|
| Validação estática | Encontrar padrões e arquivos incorretos |
| Instalação | Confirmar dependências e dados iniciais |
| Atualização | Validar evolução do módulo |
| Testes próprios | Proteger regras da customização |
| Testes relacionados | Detectar regressões em dependências |
| Ambiente | Preparar versão reproduzível para homologação |
A CI não substitui o ambiente de homologação. Ela utiliza bases controladas; a homologação valida configurações, dados, perfis e integrações do projeto.
Testes instáveis e cobertura
Um teste instável passa e falha sem mudança relevante. Causas podem incluir tempo, ordem, dados compartilhados, concorrência e dependência externa. Repetir até passar não resolve o problema.
Cobertura ajuda a identificar código não exercitado, mas percentual alto não garante cenários de qualidade. Priorize regras críticas, limites, erros, segurança e regressões.
Dados de teste
Dados devem ser pequenos, claros, independentes e adequados ao cenário. Evite informações sensíveis reais no repositório.
Um teste confiável produz o mesmo resultado sozinho, em conjunto e em diferentes execuções.
Ambiente de homologação
O ambiente deve ser próximo da produção em versão, código, módulos, parâmetros, infraestrutura e integrações relevantes.
Cópias de produção podem ajudar com volume e histórico, mas precisam de acesso controlado, anonimização, retenção e neutralização de e-mails, pagamentos e integrações.
Homologação só produz confiança quando o ambiente representa suficientemente o local em que a mudança será executada.
Git, branches e versionamento
Customizações em código devem estar no Git. O repositório registra histórico, autor, revisão, branch, tag e relação com a entrega.
A passagem entre desenvolvimento, homologação e produção deve utilizar o mesmo commit ou artefato.
Documentação
A documentação técnica deve explicar finalidade, arquitetura, modelos, configurações, integrações, crons, permissões, testes e publicação.
A documentação funcional deve explicar quando utilizar, campos, etapas, responsabilidades, exceções e resultado. Ela deve descrever o processo, não apenas as telas.
Definição de pronto
| Critério | Exemplo |
|---|---|
| Requisito | Critérios de aceite atendidos |
| Código | Padrões e revisão concluídos |
| Testes | Automatizados e manuais aprovados |
| Segurança | Perfis e empresas validados |
| Desempenho | Volume representativo testado quando aplicável |
| Documentação | Técnica e funcional atualizadas |
| Homologação | Responsável funcional aprovou |
| Publicação | Monitoramento e rollback definidos |
Publicação e rollback
Antes de publicar, confirme commit, módulos, dependências, backup, janela, migração, responsáveis e comunicação.
Rollback precisa considerar código, banco, scripts e transações realizadas após a publicação. Voltar o código pode não ser suficiente quando os dados foram transformados.
Smoke test e monitoramento
Depois da publicação, execute testes rápidos dos processos críticos: login, abertura de telas, criação de documento, confirmação, impressão e integração.
Monitore logs, erros, filas, crons, tempo de resposta, banco e integrações. Também acompanhe sinais funcionais, como documentos pendentes, notas rejeitadas e sincronizações atrasadas.
Incidentes devem gerar aprendizado
Quando ocorrer um problema, registre impacto, linha do tempo, causa, correção, contorno e prevenção.
Pergunte qual teste, alerta, revisão ou processo poderia ter detectado ou evitado o incidente. Transforme a resposta em melhoria.
Módulos OCA e qualidade
Utilizar um módulo da OCA pode reduzir desenvolvimento próprio, mas não elimina avaliação e homologação.
Verifique versão, licença, maturidade, mantenedores, dependências, testes, issues, pull requests e aderência ao processo.
Mesmo quando o módulo possui testes, o projeto pode precisar validar sua combinação com localização brasileira, outros módulos e configurações do cliente.
Qualidade comunitária reduz riscos, mas não transforma qualquer módulo em solução pronta para qualquer cliente.
Community, Enterprise e Studio
Qualidade é necessária em Community e Enterprise. Projetos das duas edições podem possuir módulos próprios, integrações e componentes OCA compatíveis.
Alterações realizadas com Studio também precisam de inventário, teste e governança. Para lógica crítica, integração e comportamento reutilizável, módulos em Python oferecem maior capacidade de versionamento, revisão e testes.
Quando não customizar?
Antes do desenvolvimento, avalie padrão do Odoo, configuração, OCA, integração existente e mudança de processo.
Não customizar pode ser a melhor decisão quando o benefício é pequeno, a exceção é rara ou o custo de manutenção é desproporcional.
Erros comuns
Testar apenas como administrador
Permissões e multiempresa ficam sem validação.
Homologar apenas a demonstração
Usuário observa, mas não executa casos próprios.
Testar somente o fluxo feliz
Cancelamentos e exceções aparecem em produção.
Confiar apenas na instalação
Módulo instala, mas falha durante o uso.
Não testar atualização
Base nova funciona e base existente quebra.
Corrigir bug sem teste de regressão
O mesmo problema pode voltar.
Ignorar desempenho
Processo funciona apenas com pouco volume.
Editar produção diretamente
Código publicado deixa de corresponder ao Git.
Confundir cobertura com qualidade
Linhas executadas não garantem regras verificadas.
Checklist técnico da entrega
| Área | Controle |
|---|---|
| Código | Git, padrão, escopo e revisão |
| Instalação | Módulo instala sem erro relevante |
| Atualização | Base existente atualiza corretamente |
| Backend | Regras e exceções possuem testes |
| Frontend | Componentes e interações foram validados |
| Segurança | ACL, regras, campos e métodos foram testados |
| Multiempresa | Entidades e propriedades estão consistentes |
| Desempenho | Volume e consultas foram avaliados |
| Integração | Falhas, retentativas e duplicidade foram testadas |
| Migração | Scripts são repetíveis e conciliados |
| Documentação | Uso, configuração e manutenção estão descritos |
| CI | Controles obrigatórios passaram |
Checklist de publicação
| Item | Definição |
|---|---|
| Versão | Commit e módulos identificados |
| Janela | Horário e impacto comunicados |
| Backup | Cópia e restauração compatíveis |
| Procedimento | Passos e comandos documentados |
| Responsáveis | Técnico e funcional disponíveis |
| Rollback | Ponto de decisão e recuperação definidos |
| Smoke test | Cenários rápidos preparados |
| Monitoramento | Logs, filas e processos acompanhados |
A abordagem da Escodoo
A Escodoo trata customizações como componentes que precisarão funcionar, ser suportados e migrados durante todo o ciclo de vida do Odoo.
Nossa abordagem pode incluir levantamento, fit-gap, módulo Python, Git, revisão de código, testes automatizados, CI, homologação, segurança, desempenho, publicação e monitoramento.
Atuamos com Odoo Community, Enterprise, módulos da OCA, localização brasileira, integrações, Doodba, GitHub Actions e Escodoo Cloud.
Perguntas frequentes
Odoo possui framework de testes?
Sim. Odoo suporta testes Python, testes unitários de JavaScript e tours para cenários de integração entre navegador e servidor.
Todo módulo precisa de testes automatizados?
O nível deve acompanhar o risco. Regras críticas, cálculos, segurança, integrações e regressões deveriam possuir proteção automatizada.
Homologação substitui testes automatizados?
Não. Homologação valida aderência funcional; testes automatizados repetem verificações e protegem evoluções futuras.
É necessário testar como usuário comum?
Sim. Testar apenas como administrador pode esconder falhas de permissão, regra de registro e multiempresa.
Como testar integrações?
Valide sucesso, falha, timeout, duplicidade, autenticação, reprocessamento, identificadores e observabilidade.
O que é teste de regressão?
É a verificação de que uma alteração não quebrou funções que já estavam operando.
Qual é a função da CI?
Executar verificações repetíveis a cada mudança, antes que o código avance para homologação ou produção.
Percentual de cobertura garante qualidade?
Não. Cobertura mostra código executado, mas não garante que cenários importantes foram corretamente verificados.
Módulo OCA precisa ser homologado?
Sim. Testes comunitários ajudam, mas a combinação de módulos, configurações e processos do cliente precisa de validação própria.
Como preparar uma migração de versão?
Teste módulos em base vazia da nova versão, adapte código e testes, migre dados, valide a base atualizada e faça ensaio antes da produção.
Conclusão: qualidade acompanha todo o ciclo
Customizações Odoo precisam ser tratadas como software de negócio, não como alterações isoladas de tela.
A qualidade começa com requisitos e critérios de aceite. Revisão e padrões reduzem erros antes da execução. Testes Python, JavaScript e tours protegem regras e integrações. Homologação confirma aderência ao processo.
Segurança, multiempresa, desempenho, fiscal e migração precisam de cenários próprios. CI torna controles repetíveis. Git mantém rastreabilidade. Publicação planejada reduz risco. Monitoramento detecta falhas depois do go-live.
Precisa desenvolver ou revisar customizações Odoo?
A Escodoo pode apoiar análise, arquitetura, desenvolvimento em Python, revisão, testes automatizados, CI, homologação, segurança e migração.
Trabalhamos com Odoo Community, Enterprise, módulos da OCA, localização brasileira, integrações e Escodoo Cloud.
Fale com nossa equipe e estruture customizações confiáveis, testáveis e preparadas para evoluir com o seu ambiente.
Avaliar minhas customizações Odoo