Changelog

Publique as novidades de cada entrega em linguagem de cliente. O changelog publicado fica visível no Portal do Cliente — mantenha o texto sem jargão técnico.

Comunicação de melhorias, correções e entregas para clientes — este é o papel da tela "Changelog" dentro da plataforma.

O que o cliente lê sobre a novidade — escrito em benefício, não em nome de campo. Regra da casa: se o texto só faz sentido para quem programou, ele ainda não está pronto.

Aqui você registra UMA entrada do changelog: o título da melhoria ou correção, a release e o produto/pacote em que ela saiu, a data de publicação e a descrição. Dois interruptores fecham o registro: "Publicado" diz se a entrada está valendo, e "Visível ao cliente" decide se ela entra na comunicação voltada ao cliente — dá para manter um registro interno publicado sem expô-lo. A entrada aparece depois na lista de changelog, que é o histórico do que foi comunicado.

Esta lista aceita recorte por link: "?q=texto" abre já pesquisada, "?fd_=valor" filtra por um campo do dicionário (em campo de relação, casa pelo rótulo, não pelo id) e "?excluidas=1" abre a lixeira. É o caminho do rastro do número: um total em outro relatório pode linkar direto para o conjunto que o formou. A navegação normal não paga consulta extra — o filtro só roda quando o link traz parâmetro.

"Publicado" controla se a entrada vale — rascunho não comunica nada. "Visível ao cliente" é um segundo portão: decide se aquela entrada aparece para o cliente ou fica só na visão interna. A combinação útil é justamente a assimétrica: publicar mudanças técnicas internas sem visibilidade ao cliente, e reservar o texto visível para o que o cliente entende e valoriza. Revise os dois antes de salvar — marcar um não implica o outro.

Este formulário é do motor de telas: no cabeçalho há navegação de anterior/próximo, que percorre os registros na mesma ordem da lista de onde você veio — útil para revisar uma sequência de entradas sem abrir uma a uma. A tela também respeita a sua preferência de 1, 2 ou 3 colunas de campos (ajustável por tela, com padrão global nas Preferências do usuário), e o botão "?" abre esta ajuda em qualquer tela.

O acesso é governado por perfil: quem administra a conta concede "visualizar" (e os demais verbos) na tela de Acessos. Se alguém da equipe não encontra esta tela no menu, o caminho é pedir a concessão ao administrador — ausência no menu não é defeito, é permissão.

Os botões de Excel, PDF e CSV desta lista exportam o CONJUNTO INTEIRO do recorte atual — não apenas a página visível. Vale o filtro que estiver aplicado: refine primeiro, exporte depois. As colunas seguem a sua preferência de colunas salva, e as visões salvas guardam recortes que você usa sempre (ex.: só o que está visível ao cliente). A lixeira, com o que foi excluído, fica acessível por "?excluidas=1".

Ao salvar uma visão pelo botão Visões, ela guarda quatro coisas: o texto da busca, os filtros aplicados, quais colunas aparecem (e em que ordem) e por qual coluna a lista está ordenada. Aplicar a visão restaura tudo de uma vez — inclusive zerando a ordenação e a página em que você estava, para o resultado ser exatamente o que a visão descreve. Visões salvas antes desta versão continuam válidas: o que elas não guardaram simplesmente não muda ao aplicar.

Nas fichas, sair de um campo já dispara a conferência do que dá para conferir na hora: campo obrigatório deixado em branco e e-mail mal formado. O aviso aparece embaixo do campo e desaparece quando você começa a corrigir. Campo numérico não precisa de aviso: ele simplesmente não aceita letra enquanto você digita. Isso é conforto, não a validação final: ao salvar, o sistema confere tudo de novo do lado do servidor.

No painel de atividade do registro, cada anotação tem "Virar demanda". O clique cria um ticket com o texto da anotação, quem a escreveu e o link deste registro — nada é redigitado. Use quando a anotação é um pedido de ação ("alguém precisa revisar isto"); a anotação continua onde estava. O botão só aparece com o registro já salvo; sessão somente-leitura (demonstração) não cria.

"O que mudou para o meu cliente?" — quando essa pergunta aparecer, é nesta tela que ela se responde.

Abra o registro e olhe a Linha do tempo, à direita: ela mostra cada alteração como "de um valor para outro", com a pessoa e a data. Quando há muita alteração, use os dois filtros no topo da linha do tempo — um por campo, outro por pessoa. A procura é feita no banco, então alteração antiga aparece do mesmo jeito. Você também pode perguntar ao Tenkai: "quem mudou o contrato 482?".