Ciclo de Aprovação

O Ciclo de Aprovação protege suas análises contra alterações acidentais, garantindo que todas as mudanças em visualizações e dashboards passem por um processo de revisão antes de serem publicadas.

Funcionalidades

📝 Rascunhos

Edite isoladamente sem afetar a versão publicada

🔍 Solicitações de Revisão

Submeta mudanças para aprovação

✅ Aprovações

Validação por pares antes de publicar

📚 Histórico de Versões

Auditoria completa de todas as alterações

Por que Usar?

• Proteção contra erros: Mudanças passam por revisão antes de afetar usuários
• Governança: Controle quem pode aprovar alterações críticas
• Colaboração: Discussões e comentários durante a revisão
• Auditoria: Histórico completo de quem fez o quê e quando
• Reversibilidade: Restaure versões anteriores com um clique

Conceitos Principais

Rascunhos

Um rascunho é uma cópia de trabalho isolada de uma visualização ou dashboard. Enquanto você edita o rascunho, outros usuários continuam vendo a versão publicada. Isso permite fazer alterações sem interromper quem está usando a análise.

Características dos rascunhos:

• Isolamento total da versão publicada
• Apenas o autor pode ver e editar
• Podem ser descartados a qualquer momento
• Não há limite de tempo para trabalhar neles

Solicitações de Revisão

Quando seu rascunho está pronto, você cria uma solicitação de revisão. Isso notifica os revisores que há mudanças aguardando aprovação. A solicitação inclui:

• Título descritivo das mudanças
• Descrição detalhada (opcional)
• Comparativo entre versão atual e proposta
• Espaço para comentários e discussão

Status de uma Solicitação

Status	Descrição
Pendente	Aguardando revisão
Aprovado	Revisado e aprovado, pronto para mesclar
Rejeitado	Mudanças solicitadas
Mesclado	Publicado na versão principal
Cancelado	Descartado

Versões

Cada vez que uma solicitação é mesclada, uma nova versão imutável é criada. O histórico de versões permite:

• Ver todas as versões anteriores
• Comparar versões
• Restaurar versões antigas
• Auditar quem fez cada alteração

Fluxo Padrão

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  1. CRIAR         2. EDITAR        3. SOLICITAR            │
│  ┌─────────┐      ┌─────────┐      ┌─────────┐             │
│  │Rascunho │ ───► │ Edição  │ ───► │ Revisão │             │
│  └─────────┘      └─────────┘      └─────────┘             │
│                                         │                   │
│                                         ▼                   │
│  6. PUBLICADO     5. MESCLAR       4. APROVAR              │
│  ┌─────────┐      ┌─────────┐      ┌─────────┐             │
│  │ Versão  │ ◄─── │ Mesclar │ ◄─── │Aprovação│             │
│  │   Nova  │      └─────────┘      └─────────┘             │
│  └─────────┘                                                │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Como Usar na Prática

Criando um Rascunho

1. Abra a visualização ou dashboard que deseja editar
2. Clique em Editar
3. Na janela, escolha Criar novo rascunho
4. Dê um nome descritivo (ex: "Adicionar filtro de data")
5. Faça suas alterações normalmente

Rascunhos Existentes

Se já existe um rascunho ativo, você pode continuar trabalhando nele em vez de criar um novo.

Editando o Rascunho

• Suas alterações ficam isoladas da versão publicada
• Outros usuários continuam vendo a versão principal
• Você pode alternar entre rascunho e versão principal para comparar

Submetendo para Revisão

1. Com o rascunho aberto, clique em Submeter para Revisão
2. Preencha:
   • Título: O que mudou (ex: "Adiciona filtro de período")
   • Descrição (opcional): Detalhes das alterações
3. Clique em Enviar

Geração com IA

Use os botões de IA para gerar título e descrição automaticamente baseado nas suas alterações.

Revisando Solicitações

1. Acesse Solicitações de Revisão no menu
2. Selecione uma solicitação pendente
3. Analise as mudanças na aba Alterações
4. Adicione comentários se necessário
5. Clique em Aprovar ou Solicitar Alterações

Mesclando (Publicando)

1. Com a solicitação aprovada, clique em Mesclar
2. Adicione uma descrição da alteração (opcional)
3. Confirme a mesclagem

A nova versão agora está publicada e visível para todos.

Promoção Direta

Em casos excepcionais (correções urgentes), administradores podem publicar diretamente:

1. No rascunho, clique em Submeter para Revisão
2. Selecione a aba Promover Direto
3. Informe o motivo (mínimo 10 caracteres)
4. Clique em Publicar sem Aprovação

Uso com Moderação

A promoção direta ignora o ciclo de aprovação. Use apenas para correções críticas e urgentes. Todas as promoções diretas ficam registradas no histórico.

Comentários e Discussão

Durante a revisão, autores e revisores podem trocar comentários:

• Adicionar comentário: Digite na caixa de texto e envie
• Responder: Clique em "Responder" em um comentário existente
• Editar: Edite seus próprios comentários (marcados como "editado")
• Excluir: Remova seus próprios comentários

Comentários ficam desabilitados após a solicitação ser mesclada ou cancelada.

Histórico de Versões

Cada mesclagem cria uma nova versão imutável. Para acessar:

1. Abra a visualização ou dashboard
2. Clique no ícone de Histórico (relógio)
3. Veja todas as versões com:
   • Número da versão
   • Data e hora
   • Autor
   • Descrição da alteração
   • Se foi promoção direta

Restaurando Versões

1. No histórico, localize a versão desejada
2. Clique em Visualizar para conferir
3. Clique em Promover para restaurá-la como versão atual

Nova Versão

Restaurar uma versão antiga cria uma nova versão. O histórico permanece intacto.

Governança e Compliance

Aprovações Obrigatórias

• Toda alteração passa por revisão antes de ser publicada
• Configurável: número mínimo de aprovações
• Configurável: aprovações obrigatórias de responsáveis

Trilha de Auditoria

Todos os eventos são registrados:

• Criação de rascunho
• Submissão para revisão
• Aprovações e rejeições
• Mesclagens
• Promoções diretas
• Cancelamentos

Rastreabilidade

Cada versão registra:

• Quem criou
• Quando foi publicada
• Qual solicitação de revisão originou
• Se foi promoção direta e por qual motivo

Fluxo Recomendado para Equipes

Para Mudanças Pequenas

Autor → Rascunho → Solicitar Revisão → 1 Aprovação → Mesclar

Para Mudanças Significativas

Autor → Rascunho → Solicitar Revisão → Discussão → 2+ Aprovações → Mesclar

Para Correções Urgentes

Admin → Rascunho → Promoção Direta (com justificativa)

Boas Práticas

Para Autores

• ✅ Use nomes descritivos nos rascunhos
• ✅ Escreva descrições claras na solicitação
• ✅ Responda aos comentários dos revisores
• ✅ Teste suas alterações antes de submeter
• ❌ Não acumule muitas mudanças em um único rascunho

Para Revisores

• ✅ Revise as alterações com atenção
• ✅ Deixe comentários construtivos
• ✅ Aprove apenas se estiver confiante
• ✅ Use "Solicitar Alterações" quando necessário
• ❌ Não aprove sem revisar

Para Administradores

• ✅ Defina número mínimo de aprovações
• ✅ Monitore uso de promoção direta
• ✅ Revise trilha de auditoria periodicamente
• ❌ Não use promoção direta rotineiramente

Recursos Adicionais

• Permissões - Configure quem pode aprovar
• Segurança - Práticas de segurança e compliance