# Reavaliação de Planejar por etapas

10 de setembro de 2026 · avaliação do demonstrador local e dos requisitos disponíveis

**A sequência atual tem quatro etapas, com estimativa de demanda em Montar. O demonstrador ainda não cobre integralmente o planejamento de produção.** O núcleo correto é trabalhar ciclo a ciclo sobre uma base vigente, transformar produtos em condições promocionais, avaliar VNP + promoções, revisar demanda e concluir uma versão rastreável. O ganho de simplicidade vem de manter esse contexto e eliminar retrabalho entre etapas.

Esta é uma avaliação heurística, de requisitos e de comportamento executável. Não substitui observação de planejadores reais com catálogo e volumes reais. A planilha e os documentos são fontes de evidência; as recomendações abaixo não transformam suas dúvidas em regras aprovadas.

## Jornada recomendada

| Etapa | Decisão do planejador | Informação essencial | Saída esperada |
|---|---|---|---|
| Preparar | Em qual recorte e período vou trabalhar? | País, filtros comerciais, anos, Q1–Q4, ciclos incluídos e metas de cada recorte/ciclo | Recorte aplicado e metas de receita/margem confirmadas por ciclo, com origem explícita |
| Montar | O que vou promover e qual demanda adotar? | Base vigente, condições comerciais, painel EOS, estimativas e resultado versus meta | Composição e demanda revisadas por ciclo |
| Verificar | O plano está pronto para fechar? | Bloqueios, demanda revisada nas condições atuais, justificativas e versão salva | Revisão validada para fechamento |
| Concluir | Qual resultado e quais exceções estou encerrando? | Resultado por ciclo, metas, desvios, decisões, versão e destino | Foto final local; em produção, aprovação e confirmação do destino quando exigidas |

Montar é o espaço principal de trabalho. Verificar reúne exceções já calculadas; não deveria exigir que o usuário marque como resolvida uma pendência cuja causa permanece. Navegar entre etapas é permitido; salvar, enviar, adotar e concluir são ações governadas pelo estado real.

## Inconsistências corrigidas nesta revisão

| Achado | Efeito anterior | Comportamento corrigido |
|---|---|---|
| Meta dissociada do recorte | Trocar país/categoria mantinha orçamento do recorte anterior | Metas são separadas por país/canal/masterbrand/categoria/marca e ciclo; voltar recupera o recorte anterior. Ativas são separadas por país/canal e ciclo |
| Mudança de recorte com rascunho | Erro ao aplicar podia perder os filtros escolhidos | O comando informa que salvará as alterações antes de aplicar a seleção |
| Meta só aparecia longe da montagem | O usuário via receita sem saber quanto faltava naquele ciclo | Receita alvo, margem piso, diferença para o alvo e situação aparecem junto ao resultado do ciclo |
| Meta incompleta tratada como atingida | Um piso ausente podia ser comparado como zero | Meta parcial permanece explícita; desvio de qualquer alvo conhecido exige motivo no fechamento local |
| Retorno parcial sem continuação | Não era possível completar o mesmo pedido | Lotes complementares são anexados à mesma solicitação, com validação do lote e contagem separada de retornos/decisões |
| Adoção em massa sobrescrevia revisão | Aceitar sugestões novamente apagava um ajuste manual | Adoção coletiva atua somente nas decisões pendentes |
| Demanda bloqueada impedia adoção geral | Era necessário mudar o bloqueio para terminar | Linha bloqueada mantém todos os atributos; sua sugestão e decisão fixa ficam registradas, e as demais linhas podem ser adotadas |
| Recorte e bloqueios editáveis durante pedido | Controles ofereciam ações incompatíveis com a versão enviada | Campos protegidos e atalho para a solicitação/cancelamento |
| Progresso visual enganoso | Visitar etapas adiantadas parecia validar o plano; adoção apagava check de verificação | Marcadores reconhecem validação/pedido compatível e revisão adotada |
| Botões desabilitados sem caminho direto | Usuário precisava procurar a etapa necessária | Atalhos para verificação/estimativa e mensagens específicas para bloqueios e alterações não salvas |
| Cabeçalho e seleção duplicada de ciclo | Muito espaço antes dos produtos | Cabeçalho compacto, uma faixa de ciclos e consolidado explícito. Visualização e busca separadas dos painéis de VNPs e promoções; ações em lote aparecem com a seleção. Descartar fica junto ao salvamento |

Os steps continuam no topo desde a abertura e fixos durante a rolagem. Preparar mantém os quatro filtros em uma linha no desktop. O card redundante de contexto não foi reintroduzido. A ajuda sobre salvamento fica recolhida.

## O que ainda impede chamar o fluxo de completo

### 1. Período do plano e lote de trabalho precisam ser separados

Selecionar Q1 de 2027 e Q4 de 2028 é válido para organizar o horizonte. Isso não significa que todos esses ciclos estejam no mesmo gate ou prontos para o EOS/fechamento ao mesmo tempo.

**Hoje:** o painel EOS permite selecionar itens e ciclos por solicitação, validar somente o lote e completar a revisão em pedidos sucessivos. A conclusão ainda abrange todos os ciclos do recorte. Demanda e composição permanecem protegidas globalmente enquanto um pedido está ativo; não há solicitações simultâneas.

**Recomendação de desenho:** manter uma jornada única e estado por ciclo. Em Montar, a seleção do painel EOS já explicita os itens e ciclos do pedido. Em Concluir, mostrar quais ciclos serão encerrados e quais continuarão em trabalho. O fechamento trimestral consolidaria suas versões correspondentes. O fechamento individual requer confirmar a granularidade de aprovação e não foi implementado como regra presumida. Já está identificado na especificação como decisão de produção multiciclal.

### 2. A carga precisa representar a fonte oficial

Tela 7 A57 exige todos os itens vigentes do ciclo/categoria em VNP nos impressos; A58 inclui promoções anteriores. A proposta demonstra essa lógica com cinco produtos e vigências sintéticas. Calendário, dados mestres, preço, demanda, custos e ativas ainda não são integrações oficiais. México e Chile não recebem o catálogo brasileiro por fallback.

Antes de operação real, distinguir carga em andamento, carga concluída vazia, falha de integração e filtro sem resultados. Sem isso, “nenhum VNP” não permite saber se não há portfólio ou se falta dado.

### 3. A cobertura do cadastro ainda é parcial

- As 28 mecânicas foram extraídas; apenas desconto simples tem criação executável completa. Grupos, progressivas, benefícios, kits/ZEST, verticais e demand drivers precisam entrar no editor contextual da mesma jornada.
- A112–A114 pedem escolha de estimativa por unidades ou UPC. A grade oferece unidades, UPC absoluto e conversão pela base do ciclo; permanecem pendentes as integrações oficiais.
- C3:C6 incluem Categoria Resultado. Essa dimensão ainda não está disponível como filtro no demonstrador e precisa ser distinguida de Categoria de Planejamento. Canal não é exigido nesse grupo de filtros; continua no contexto interno.
- Plano trimestral de origem e outras versões ainda têm contratos especificados, mas a consulta/cópia integrada não está construída.

### 4. Algumas regras de negócio permanecem em aberto

| Regra | Fonte/limite | Decisão necessária |
|---|---|---|
| Anulação de VNP | A64 depende da mecânica | Homologar país, veículo, papel, requisito e exceções; a implementação atual cobre o exemplo de desconto simples |
| Mais de uma promoção do mesmo CV | A93 é uma pergunta aberta | Coexistência, exclusividade, sobreposição e demanda compartilhada |
| Piso Boy | Fonte e mapa divergem sobre quando bloqueia | Confirmar se bloqueia forecast ou apenas aprovação/publicação; hoje bloqueia forecast como hipótese da proposta |
| Metas ausentes e desvios | Política oficial não fechada | Quem pode ajustar/aceitar e em qual gate; aviso e justificativa local não equivalem a aprovação |
| Financeiro | Fórmulas e premissas diferem entre documentos/código | Exemplos homologados por país/público, comissão, impostos, royalties, benefícios e doações |
| Chaves de orçamento e ativas | Separação local evita herança indevida | Confirmar granularidade oficial, origem e versões; não ratear o orçamento de “Todas” para categorias sem regra |
| Linha bloqueada no EOS | A85–A91 congelam atributos, inclusive demanda | Como o serviço identifica demanda fixa; o demonstrador conserva a linha e registra ambos os valores |

### 5. Finalização e escala precisam de implementação real

Concluir preserva uma foto local e bloqueia edição daquela versão. A confirmação verde aparece após salvar e reúne escopo, versão, indicadores, metas e desvios por ciclo. O relatório HTML independente e os dados JSON podem ser baixados; abrir nova revisão mantém a foto anterior. As propostas de metas usam orçamento ou histórico simulado explicitamente identificado, exigindo aceite/edição antes de Montar. Essa exigência foi aprovada como melhoria de UX, sem atribuição de obrigatoriedade às RFs. Aprovação por papel/alçada, EOS/Aurora, Databricks, snapshots oficiais e saídas DRE/Outlook ainda não estão conectados. Histórico em navegador não é controle de concorrência entre planejadores nem auditoria de servidor.

A tela usa cards para explicar VNP → promoção. Para milhares de produtos, a grade pesquisável com edição em massa deve ser a principal área de trabalho, com carregamento por página ou virtualização, filtros por situação e resumo compacto do ciclo durante a edição. A grade atual é alternativa funcional, mas a escala e o tempo de execução não foram homologados com catálogo real.

## Validação executada

104 testes automatizados passaram, incluindo confirmação de metas e relatório da conclusão. No navegador, foram conferidos aceite em lote, edição, ausência de referência por recorte, bloqueio de zero/vazio, persistência, conclusão com desvio, falha de salvamento sem falso sucesso, download HTML, nova revisão e layouts desktop/celular. Os roteiros de navegador cobrem criação de promoção, vigência, substituição/restauração de VNP, anos/quarters, troca de recorte, rascunho recuperado, solicitação completa/parcial, ajuste manual, bloqueios, justificativas, conclusão e reabertura. O roteiro desta revisão também verifica ausência de transbordamento e steps fixos em 1440, 1024 e 390 pixels.

Os resultados validam a demonstração e as transições exercitadas. Não comprovam integração externa, homologação financeira, autorização por perfil ou usabilidade com planejadores reais.

## Prioridade recomendada

1. Confirmar estado, envio, aprovação e fechamento por ciclo versus conjunto.
2. Homologar calendário, base vigente, anulação e exemplos financeiros.
3. Completar o editor de mecânicas e unidades/UPC dentro da etapa Montar.
4. Testar com um planejador uma campanha real de vários ciclos, incluindo alteração, retorno parcial e desvio de meta.

A estimativa agora faz parte de Montar, resultando em quatro etapas. A prioridade é integrar as fontes oficiais e completar as regras de cada decisão, com verificação final sobre a demanda aplicada.