Regras de Ambientes do LAC

Localização canônica: governanca/regras/regras_ambientes_lac.html

1. Decisão

O LAC adotará três ambientes de trabalho: desenvolvimento local, homologação no provedor e produção no provedor.

Essa decisão organiza o ciclo de vida dos artefatos do LAC, incluindo páginas HTML, mapas, infográficos, demandas, entregas, trilhas, modelos, regras e decisões.

2. Fundamento histórico

A separação entre desenvolvimento, homologação e produção recupera uma prática clássica de arquitetura de sistemas usada em ambientes mainframe, plataformas de microcomputadores, sistemas corporativos e aplicações web.

No LAC, essa prática passa a ser aplicada não apenas a programas, mas também aos artefatos de conhecimento.

3. Ambientes do LAC

Ambiente	Local	Função	Conteúdo típico
Desenvolvimento	Computador local	Criar, editar, testar inicialmente, guardar histórico e rascunhos.	Rascunhos, versões intermediárias, arquivos de trabalho, histórico, experiências e páginas ainda não validadas.
Homologação	Provedor, em pasta separada	Testar online antes da publicação oficial.	Páginas novas ou alteradas em validação, nova landing, novos cards, ajustes de navegação e versões candidatas.
Produção	Provedor, área pública principal	Disponibilizar conteúdo estável, navegável e intencionalmente publicado.	Landing oficial, portal, mapa do site, busca, páginas públicas e documentação validada.

Distinção importante: ambiente indica onde o artefato está sendo tratado (desenvolvimento, homologação ou produção). Estado indica sua situação no ciclo de vida (por exemplo: rascunho, em revisão, homologado, vigente, substituído, histórico ou legado). Ambiente e estado são dimensões relacionadas, mas não equivalentes.

4. Regras de governança

Regra 1 — Separação

O que está em criação fica no desenvolvimento. O que está em validação fica em homologação. O que está aprovado fica em produção.

Regra 2 — Clareza

O visitante externo não deve cair em rascunhos, páginas antigas ou versões intermediárias.

Regra 3 — Intencionalidade

Nada deve ir para produção por acaso. Toda página publicada deve ter função, destino e contexto.

5. Histórico, rascunhos e versões anteriores

A pasta historico/ deve permanecer preferencialmente no ambiente local de desenvolvimento.

O histórico só deve ir para o provedor quando for transformado em página intencional de consulta, como linha do tempo, histórico de decisões ou estudo de caso.

historico/
= desenvolvimento local

rascunhos/
= desenvolvimento local

versoes_antigas/
= desenvolvimento local

pagina_publica_aprovada.html
= produção

6. Promoção entre ambientes

A movimentação de uma página ou artefato deve seguir um fluxo simples:

Desenvolvimento local
↓
Homologação no provedor
↓
Teste em navegador, celular, tablet e, quando útil, TV
↓
Correção no computador
↓
Nova homologação, se necessário
↓
Produção

7. Depois da homologação

Após a homologação, o arquivo aprovado é promovido para produção. A versão em homologação pode ser mantida temporariamente até a confirmação do funcionamento em produção. Após essa confirmação, a homologação deve ser limpa para evitar confusão.

Essa regra evita que a homologação vire um depósito de versões antigas. A homologação deve ficar disponível para a próxima rodada de teste.

Etapa	Ação	Resultado esperado
Arquivo aprovado em homologação	Copiar ou promover para produção.	A produção passa a conter a versão oficial.
Publicação em produção	Testar a página já no endereço final.	Confirmar funcionamento real dos links, layout e acesso.
Confirmação da produção	Registrar a publicação.	Manter rastreabilidade da mudança.
Homologação pós-publicação	Limpar arquivos promovidos ou mover para nova rodada.	Evitar confusão entre versão em teste e versão oficial.
Histórico	Guardar cópia no desenvolvimento local.	Preservar memória de trabalho sem poluir o provedor.

Homologou
↓
Publicou em produção
↓
Testou em produção
↓
Registrou a publicação
↓
Limpou a homologação
↓
Preservou o histórico no desenvolvimento local

8. Registro de publicação

Quando uma página passa da homologação para a produção, a publicação deve ser registrada.

Arquivo: descobrir_lac.html
Origem: homologacao/descobrir_lac.html
Destino: descobrir_lac.html
Data da publicação: AAAA-MM-DD
Motivo: publicação da página pública de descoberta do LAC
Versão: v1.0
Observação: página validada para visitante externo inicial

Esse registro pode ficar em uma página geral de governança ou dentro da demanda correspondente.

Opção geral:
governanca/registro_publicacoes_lac.html

Opção por demanda:
projeto/demandas_entregas/camada_publica_descoberta_lac/registro_publicacao.html

9. Critérios de publicação em produção

A página tem função clara.
A navegação principal está funcionando.
Os links essenciais foram verificados.
O conteúdo não é rascunho nem versão intermediária.
A página foi testada em pelo menos um navegador de desktop e um dispositivo móvel.
O visitante externo não é exposto a linguagem interna sem explicação.
A publicação foi registrada ou marcada para registro.
A versão homologada foi limpa ou marcada para limpeza após confirmação da produção.

10. Aplicação na camada pública de descoberta do LAC

Computador local:
projeto/demandas_entregas/camada_publica_descoberta_lac/
├── rascunhos
├── historico
├── especificações
├── homologadas
├── publicadas
└── versões em elaboração

Homologação:
homologacao/descobrir_lac.html
homologacao/index.html

Produção:
descobrir_lac.html
index.html