🧭 Política de Gestão de Mudanças de Software
Versão: 1.1
Data: 17/10/2025
Responsável pela aprovação: Gestor de Projetos
Revisão: Semestral
1. Objetivo
Esta política tem como objetivo padronizar o processo de Gestão de Mudanças de Software nos sistemas mantidos e desenvolvidos internamente, garantindo que todas as alterações sejam controladas, documentadas e rastreáveis, minimizando riscos e assegurando a qualidade das entregas.
Inclui também o controle e a validação de mudanças em objetos de dados, views SQL e dashboards criados pela equipe de Análise de Dados dentro do Odoo e nos bancos de dados relacionados.
2. Escopo
Aplica-se a todas as mudanças realizadas no Odoo v17 e sistemas integrados, abrangendo:
- Ajustes e melhorias evolutivas em módulos do ERP;
- Desenvolvimento de novas funcionalidades e telas;
- Criação e alteração de views no banco de dados;
- Construção e atualização de dashboards e relatórios analíticos;
- Correção de bugs e falhas em produção (hotfixes);
- Alterações em configurações, integrações e dados críticos.
Envolve os times de:
- Suporte N1 (triagem e priorização);
- Analistas de Sistemas (análise técnica e funcional);
- Desenvolvedores (DEV) (implementação e testes);
- Equipe de Análise de Dados (tratamento de dados, modelagem e visualização);
- Gestor de Projetos (coordenação, acompanhamento e aprovação final).
3. Classificação das Mudanças
| Tipo | Descrição | Exemplo | Aprovação |
|---|---|---|---|
| Evolutiva (Melhoria) | Ampliação de funcionalidades existentes ou ajustes sugeridos por usuários. | Novo campo em cadastro, ajuste em fluxo de compras. | Gestor de Projetos |
| Corretiva (Bug / Hotfix) | Correção imediata de erros em produção. | Erro em regra de cálculo, falha em relatório. | Analista + Gestor |
| Projetos Específicos | Mudanças estruturais ou de alto impacto, tratadas como projeto. | Novo módulo, integração ou reestruturação de dados. | Comitê do Projeto |
| Configuração / Parametrização | Alterações sem impacto direto de código. | Ajuste de regra fiscal ou parâmetro de módulo. | Analista |
| Analítica / Dados | Criação, ajuste ou exclusão de views SQL, consultas e dashboards analíticos. | View para indicadores de vendas, painel de performance logística. | Analista de Dados + Gestor |
4. Papéis e Responsabilidades
| Papel | Responsabilidade |
|---|---|
| Suporte N1 | Realizar triagem das solicitações e identificar se é suporte, melhoria ou bug crítico. |
| Analista de Sistemas Sênior | Avaliar impacto funcional e técnico, documentar requisitos, planejar implantação e validar entregas. |
| Desenvolvedor (DEV) | Implementar as mudanças no código, realizar testes e versionamento. |
| Analista de Dados | Criar, revisar e manter views SQL, consultas e dashboards; avaliar impacto em performance e segurança de dados. |
| Gestor de Projetos | Coordenar o ciclo de vida das mudanças, aprovar liberações e validar release notes e documentação. |
5. Fluxo do Processo de Mudança
5.1 Origem da Demanda
- Todas as solicitações nascem no Suporte N1, via ticket no Odoo.
- Caso a demanda envolva alteração funcional, de código ou de dados, é reclassificada como “Melhoria” e atribuída ao Analista de Sistemas ou ao Analista de Dados, conforme o caso.
- Mudanças de grande impacto podem originar projetos específicos no Odoo.
5.2 Análise e Planejamento
- O responsável técnico avalia impactos, dependências e riscos.
-
A análise deve incluir:
- Escopo da mudança;
- Impactos funcionais e de dados;
- Riscos de performance e integridade;
- Plano de rollback;
- Estimativa de esforço e prazo.
5.3 Desenvolvimento e Testes
- O DEV ou Analista de Dados implementa as alterações em ambiente de homologação.
-
São obrigatórios:
- Versionamento no repositório;
- Testes técnicos e funcionais;
- Validação por pares ou Analista de Sistemas.
5.4 Aprovação e Implantação
- O Gestor de Projetos aprova a mudança e agenda a implantação.
- Mudanças analíticas (views e dashboards) também passam por validação de performance e segurança antes de irem para produção.
- Cada implantação deve ser registrada com seu respectivo Release Notes.
5.5 Pós-Implementação
- O responsável verifica o resultado em produção;
- Documentação e versão são atualizadas;
- Caso haja regressão ou impacto, aplica-se o rollback planejado.
6. Gestão de Bugs e Hotfixes
- Bugs críticos seguem fluxo emergencial;
- O Suporte N1 aciona Analista e DEV ou Analista de Dados conforme o tipo de erro;
- O hotfix é validado e aplicado em produção com registro no Odoo;
- A correção é incorporada ao branch principal e documentada.
7. Critérios de Aprovação
Uma mudança só será aprovada se:
- Tiver registro completo no Odoo;
- Contiver evidências de teste e validação;
- Estiver acompanhada de Release Notes;
- Possuir plano de rollback;
- No caso de dados, possuir validação de integridade e performance.
8. Versionamento e Controle de Código
Padrão: Semantic Versioning
Formato: MAJOR.MINOR.PATCH (ex: v1.4.2)
Branches:
- main → Produção
- develop → Homologação
- feature/* → Novas funcionalidades
- hotfix/* → Correções urgentes
- data/* → Alterações específicas em views, queries e dashboards
9. Release Notes
Cada mudança registrada no Odoo deve conter:
- Versão;
- Data de liberação;
- Descrição detalhada;
- Responsáveis;
- Ambiente de destino;
- Tipo de mudança (Evolutiva, Corretiva, Analítica etc.);
- Observações e plano de rollback.
Exemplo:
Versão: 1.4.2 Data: 23/10/2025 Tipo: Analítica Descrição: Criação de view para acompanhamento de pedidos em atraso e novo dashboard logístico. Responsáveis: Equipe de Análise de Dados Ambiente: Produção Status: Implantado
10. Governança e Monitoramento
- O Gestor de Projetos revisará mensalmente as mudanças aplicadas;
-
Indicadores de desempenho incluem:
- Total de mudanças concluídas;
- Percentual de sucesso sem rollback;
- Tempo médio de aprovação;
- Volume de hotfixes aplicados;
- Volume de alterações analíticas implementadas.
- Revisão formal da política a cada 6 meses.
11. Boas Práticas Complementares
- Padronizar nomenclaturas de views e dashboards para facilitar manutenção e rastreabilidade;
- Evitar queries diretas em produção sem validação prévia de performance;
- Documentar fontes de dados e indicadores em wiki interna;
- Validar permissões de acesso a dashboards sensíveis;
- Manter integração entre Análise de Dados e DEV para alinhar dependências de estrutura e versionamento.
✅ Conclusão
Com esta atualização, a Política de Gestão de Mudanças passa a contemplar todo o ciclo de software e dados, garantindo que alterações em código, processos e informações analíticas sigam um mesmo padrão de qualidade, rastreabilidade e controle.