Rascunhos, revisão e publicação — referência funcional
Entenda estados, responsáveis e cuidados antes de liberar uma versão do mapa.
Esta página descreve controles conhecidos por documentação e código local; permissões, telas e transições exigem ensaio isolado. Não execute sincronização, confirmação de checklist, aprovação, publicação ou alteração real apenas para testar estas instruções. O treinamento de vias e passeios não protege os demais módulos.
Estados distintos
Em memória é uma prévia ou edição ainda não confirmada pelo serviço. Gravado no rascunho significa que o armazenamento de trabalho recebeu uma alteração; uma resposta visual não substitui sua verificação. Publicado é uma versão disponibilizada pelo fluxo de publicação. Salvar, revisar, aceitar e publicar são operações diferentes.
Revisão interna e checklist da equipe registram acompanhamento; validação do cliente e aceite de uma observação têm seus próprios estados. Nenhum desses estados, isoladamente, comprova publicação. Sincronização pode gravar estruturas ou dados e não é simples atualização da tela. Histórico registra eventos ou versões conforme o sistema, sem garantir reversão universal.
Responsabilidades e controles
| Sistema e controle | Finalidade e perfil | Estado, escrita e limites |
|---|---|---|
| Field Admin — edição e indicador Rascunho | Configurador autorizado trabalha no mapa; a disponibilidade depende do local e perfil. | O código lê versão de trabalho quando Field Admin ativo. Prévia e autosave variam por ferramenta; gravar não publica. |
| Field Admin — Ver como Usuário | Abre experiência de consulta conforme contexto e permissões. | Não comprova, por si, que a versão mais recente foi publicada nem que consulta anônima foi testada. |
| Client preview protegido — rascunho/publicada | Revisão com autorização por local e capacidades; vista pode ser restrita ou completa. | Código prevê rascunho por padrão e versão publicada quando solicitada. A sessão pode manter dados de autenticação; não presumir acesso anônimo nem paridade com visitante. |
| Portal — Visualizar | Conferência da experiência conforme documentação de Liberação. | Visualizar não é publicar. Confirme qual versão e permissões se aplicam antes de interpretar o resultado. |
| Core — checklist e revisão | Equipe Zapt e cliente acompanham unidade/pavimento e observações, conforme capacidades. | Salvar rascunho, enviar comentários, mudar estado ou confirmar checklist pode gravar; revisão não equivale a publicação. |
| Portal — Publicar / histórico | Perfil autorizado libera versão após revisão; histórico pode mostrar versão, data, autor e estado segundo a documentação Portal. | Publicação altera o que está disponível; carregar versão no rascunho e descartar alterações são operações distintas e podem sobrescrever trabalho. Não ensaiadas aqui. |
O código de edição tenta marcar alterações pendentes de publicação após gravações confirmadas; essa notificação é de melhor esforço e pode falhar sem reverter o dado. Em locais nunca publicados, o estado do assistente pode seguir regra diferente. Confirme o estado real no Portal e a versão, sem confiar em um único indicador.
Revisão, comentários e validação
Na Área do Cliente, a equipe pode acompanhar unidades, pavimentos e checklist; a interface de revisões no código prevê comentários em rascunho, envio selecionado e estados como Enviada, Em análise, Aguardando resposta, Pronta para conferência e Aceita. As ações e permissões dependem do perfil. Salvar ou enviar comentário e transicionar estado gravam dados; limite, disponibilidade e reversão precisam de ensaio.
Uma marcação pode identificar local, unidade, pavimento ou mapa, dependendo do contexto. O histórico da revisão e a referência a versão observada ajudam a acompanhar o problema, mas não substituem validação do cliente, aprovação formal ou publicação. A confirmação do checklist é distinta desses estados. Consulte preparação da composição e alinhe responsáveis e critérios de aceite.
Comparação e identificação de versão
Para comparar, identifique explicitamente local, mapa, piso, perfil, versão e data de cada vista. A documentação do Portal descreve Visualizar, Rascunhos e Versões; a implementação de preview protegido aceita versão de rascunho ou publicada. Não foi comprovado aqui um comparador universal lado a lado, nem que todas as camadas e perfis usem as mesmas fontes.
A consulta como visitante ou anônimo deve ser executada somente conforme acesso permitido e em ensaio apropriado; uma sessão autenticada pode mostrar conteúdo diferente. Veja Liberação no Portal e enquadramento.
Persistência, atualização e concorrência
Uma seleção, pré-carregamento ou entrada em ferramenta não é automaticamente segura. O código de Aberturas pode migrar dados legados ao ativar o painel; seleção de tema pode gravar; sugestão de portas em lote pode salvar vários alvos. Outras ferramentas têm autosave ou efeitos específicos. A proteção de treinamento foi ensaiada apenas para vias e passeios em contexto limitado.
Atualizar dados do servidor descarta snapshots locais e recarrega; trabalho em memória pode ser perdido. Outra pessoa pode alterar o rascunho entre conferência e publicação. Respostas parciais, expiração, caches e restauração de histórico exigem examinar o estado confirmado e coordenar responsáveis. Não presuma desfazer ou reversão após escrita. Fontes: fieldAdminDraftMode.ts, fieldAdminPublishState.ts, ClientReviewGate.tsx, documentação Portal e customer-map-reviews.js; nenhuma transição foi executada nesta etapa.
Referências relacionadas
Jornada de revisão e preparação · Rascunho e gravação · Andares · Portas · Liberação · Rotas.