Mudança em desenvolvimento
Está em construção, verificação ou aceitação e ainda não deve estar em produção.
Paridade controlada entre ambientes
Sincronização entre Desenvolvimento e Produção do LAC
Esta página define como comparar, identificar, classificar e regularizar diferenças entre os ambientes de desenvolvimento e produção, preservando versões, decisões, evidências e responsabilidade sobre cada mudança.
Definição consolidada: sincronização é a capacidade de
manter desenvolvimento e produção sob controle de versão, sabendo quais
diferenças são esperadas, quais representam mudanças ainda não implantadas
e quais constituem divergências indevidas que exigem correção, auditoria
ou Jornada de regularização.
Princípio
Sincronizar não significa tornar tudo idêntico o tempo todo
Desenvolvimento pode conter mudanças em construção. O essencial é que cada diferença seja conhecida, justificada, rastreável e encaminhada.
Implantação pendente
A entrega foi aceita, mas a publicação ou validação em produção ainda não terminou.
Ambientes sem controle
Não há justificativa, registro, decisão ou correspondência clara entre as versões.
Regra de governança
Toda diferença relevante entre desenvolvimento e produção deve possuir uma causa conhecida, um estado, um responsável e um próximo encaminhamento.
Escopo
O que deve ser sincronizado?
A comparação não deve limitar-se aos arquivos HTML principais.
Páginas HTML
Arquivos criados, alterados, renomeados, movidos ou removidos.
Imagens e knowgramas
Nomes, versões, dimensões, caminhos e arquivos efetivamente utilizados.
CSS e JavaScript
Estilos, scripts, bibliotecas e componentes compartilhados.
Dados e configuração
JSON, PHP, banco de dados, APIs, parâmetros e arquivos de estado.
Navegação
Índices, mapas, menus, breadcrumbs, redirecionamentos e páginas relacionadas.
Estrutura física
Pastas, nomes, localização, permissões e caminhos relativos.
Documentação
Versão, decisão, checklist, evidência, registro de implantação e manutenção.
Estado institucional
O que está em construção, aceito, implantado, validado ou descontinuado.
Fluxo de controle
Ciclo de sincronização
O ciclo começa pela identificação do estado de referência e termina com paridade confirmada ou divergências formalmente encaminhadas.
Definir referênciaversão e escopo esperado
→
Inventariararquivos, páginas e dependências
→
Compararpresença, conteúdo e versão
→
Classificardiferença esperada ou indevida
→
Decidirpublicar, corrigir, reverter ou manter
→
Regularizarexecutar o tratamento autorizado
→
Validarconfirmar resultado nos ambientes
→
Registrarevidência e estado final
Linha de base
Qual é o estado de referência?
A sincronização precisa saber qual versão foi aceita, qual foi implantada e qual está sendo construída.
Linha de base aceita
Conjunto de entregas aprovado para implantação ou já validado em produção.
Estado de desenvolvimento
Inclui linha de base mais mudanças autorizadas em construção, revisão ou teste.
Estado de produção
Versão efetivamente publicada, acessível e validada no ambiente real.
Linha de base aceita
│
├── Desenvolvimento
│ ├── versão aceita
│ └── mudanças autorizadas ainda não implantadas
│
└── Produção
└── versão implantada e validada
Diferença legítima
└── mudança conhecida, registrada e em fluxo
Divergência indevida
└── diferença sem justificativa, decisão ou rastreabilidade
Método
Critérios de comparação
A comparação deve examinar existência, localização, conteúdo, dependências e estado institucional.
| Critério | Desenvolvimento | Produção | Resultado possível |
|---|---|---|---|
| Presença do arquivo | Existe ou foi removido. | Existe ou foi removido. | Igual, pendente de publicação ou divergente. |
| Nome e caminho | Localização atual no projeto. | Localização publicada. | Paridade ou link potencialmente quebrado. |
| Conteúdo | Versão em construção ou aceita. | Versão implantada. | Igual, diferença autorizada ou alteração indevida. |
| Data e versão | Última alteração registrada. | Última implantação registrada. | Versão correspondente ou desatualização. |
| Dependências | Imagens, CSS, JS, dados e páginas associadas. | Dependências disponíveis no servidor. | Completa, parcial ou quebrada. |
| Navegação | Links e caminhos esperados. | Links acessíveis no ambiente real. | Funcionando, pendente ou inconsistente. |
| Estado institucional | Em construção, verificação ou aceitação. | Implantado, validado ou descontinuado. | Coerente ou sem correspondência. |
Resultado da comparação
Classificação das diferenças
A classificação determina o encaminhamento e evita corrigir como erro uma diferença que ainda faz parte do desenvolvimento.
| Classe | Significado | Encaminhamento |
|---|---|---|
| Em paridade | Os ambientes correspondem à versão esperada. | Registrar confirmação e manter controle. |
| Mudança em desenvolvimento | Diferença autorizada ainda em construção ou verificação. | Manter no fluxo da Jornada. |
| Implantação pendente | Entrega aceita ainda não publicada ou validada. | Executar rotina de implantação. |
| Produção desatualizada | Versão aceita deveria estar em produção, mas não está. | Publicar ou investigar impedimento. |
| Produção alterada | Há mudança em produção não refletida ou não autorizada no desenvolvimento. | Preservar evidência, decidir incorporação ou reversão. |
| Dependência ausente | Página existe, mas imagem, script, estilo, dado ou link não corresponde. | Corrigir implantação e revalidar. |
| Divergência acumulada | Múltiplas diferenças sem rastreabilidade suficiente. | Auditoria e Jornada de regularização. |
Tratamento
Como regularizar diferenças?
A direção da sincronização depende de qual ambiente contém a versão correta e autorizada.
Desenvolvimento → Produção
Usar quando a entrega do desenvolvimento foi verificada, aceita e autorizada para publicação.
Produção → Desenvolvimento
Usar somente quando uma alteração legítima em produção precisa ser incorporada à base de desenvolvimento.
Reverter produção
Usar quando a mudança em produção é indevida, insegura ou não deve integrar a linha de base.
Manter diferença temporária
Usar quando a mudança está autorizada e ainda percorre construção, teste ou aceitação.
Regularização seletiva
Corrigir apenas arquivos ou dependências afetados, preservando versões válidas.
Jornada de regularização
Usar quando a divergência é ampla, estrutural, recorrente ou sem rastreabilidade suficiente.
Regra de segurança
Nunca sobrescrever um ambiente apenas para “deixá-lo igual” sem antes identificar qual versão é válida, preservar o estado anterior e registrar a decisão de sincronização.
Responsabilidades
Papéis na sincronização
A mesma pessoa pode acumular funções, mas a autoridade e a execução devem permanecer distinguíveis.
| Papel | Responsabilidade |
|---|---|
| Gestor do LAC | Define escopo da comparação, coordena classificação, decisão e regularização. |
| Responsável técnico ou editorial | Identifica arquivos, dependências, caminhos, conteúdo e versão correta. |
| Responsável pela implantação | Executa publicação, reversão ou correção autorizada. |
| Qualidade | Verifica critérios de paridade, funcionamento e evidências. |
| Auditor | Avalia divergências amplas, recorrentes ou sem rastreabilidade. |
| Governança ou Proprietário | Decide exceções, conflitos de versão e regularizações de maior impacto. |
| Manutenção | Preserva o estado regularizado e observa novas divergências. |
Rastreabilidade
Evidências da sincronização
A comparação deve permitir reconstruir o estado dos ambientes e a decisão tomada.
Data e escopo da comparação.
Linha de base ou versão esperada.
Inventário de arquivos e dependências examinados.
Diferenças encontradas e sua classificação.
Justificativa para diferenças autorizadas.
Decisão de publicação, incorporação, correção ou reversão.
Responsável pelo tratamento.
Cópia ou referência ao estado anterior.
Resultado da regularização.
Validação nos dois ambientes.
Pendências e novas demandas.
Aplicação
Exemplo: página criada no desenvolvimento
O exemplo mostra possíveis estados para uma mesma diferença.
Arquivo:
governanca/gestao_do_lac/
sincronizacao_desenvolvimento_producao_lac.html
│
├── Existe no desenvolvimento e não existe em produção
│
├── Situação A
│ ├── ainda em construção
│ └── diferença esperada
│
├── Situação B
│ ├── aceita e aguardando publicação
│ └── implantação pendente
│
├── Situação C
│ ├── deveria estar publicada
│ └── produção desatualizada
│
└── Regularização
├── verificar entrega e dependências
├── preservar estado anterior
├── publicar
├── validar links e navegação
└── registrar paridade confirmada
Implantação da prática
Quando a sincronização está operacional?
A prática exige comparação recorrente, classificação consistente e regularização com evidências.
Linha de base ou versão esperada identificada.
Inventário mínimo dos objetos comparados disponível.
Diferenças classificadas como esperadas, pendentes ou indevidas.
Responsável pela análise definido.
Decisões de sincronização registradas.
Estado anterior preservado antes de sobrescrita ou reversão.
Regularizações validadas nos ambientes.
Divergências recorrentes convertidas em demanda ou Jornada.
Ao menos duas verificações de paridade concluídas.
Próximo documento: auditoria_paridade_ambientes_lac.html
Deve ficar preferencialmente em governanca/auditoria/ e
definir a avaliação independente do estado real dos ambientes, seus
achados, riscos, evidências e recomendações de regularização.
Síntese institucional
A sincronização desenvolvimento–produção não elimina diferenças legítimas; torna cada diferença conhecida, justificada e governável. Assim, o LAC preserva controle sobre versões, implantação, manutenção e evolução, evitando que o ambiente real se afaste silenciosamente do conhecimento construído e aceito.