Empodera

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Cristiane Ferreira Nosei Lavrador

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Cristiane Ferreira Nosei Lavrador

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Expandir
💻 Lançamento: Nova Área do Desenvolvedor
title👤 Rumo à Autonomia: Identificando Administradores Responsáveis (Parte 2)

Este release conclui a implementação da funcionalidade de direcionamento na tela de login, garantindo que novos usuários saibam exatamente quem contatar para solicitar a liberação de acesso.

O que há de novoLiberamos uma nova tela, a "Área do Desenvolvedor". Nesta tela, será possível acessar de forma dinâmica as APIs já configuradas do Empodera.
Foram criados novos perfis "Desenvolvedor" e que terão acesso a esta tela para realizar consultas de forma autônoma

Identificamos que o processo para um novo usuário solicitar acesso a uma área específica no Empodera era confuso.
A tela de login não oferecia um direcionamento claro sobre quem seria o contato responsável pela liberação, causando atrasos e dificuldades no primeiro acesso à ferramenta.

Como Funciona

Para resolver isso, a tela de login agora permite que o usuário identifique os administradores responsáveis por sua área antes mesmo de fazer o login.

  1. Busca Dinâmica por Área: Na tela de login, o usuário (especialmente em seu primeiro acesso) encontrará um campo de busca.
    Ao digitar o nome da sua Área, o sistema exibirá dinamicamente as opções correspondentes.

  2. Exibição dos Contatos: Após o usuário selecionar a área desejada, o sistema exibirá imediatamente uma lista clara contendo o Nome e o E-mail dos contatos responsáveis pela liberação de acesso daquela área

  3. Atribuição de Perfil: O Administrador da área deverá associar um dos perfis "Desenvolvedor" ao usuário desejado.

  4. Acesso: Estes perfis concedem acesso à nova aba "Área do Desenvolvedor" ,além das informações de clientes e outros dados conforme configuração do perfil.

  5. Uso: Na nova tela, o usuário encontrará os links de API configurados. Basta clicar no item desejado e, em seguida, em "Acessar Link".
    O usuário será redirecionado ao Swagger correspondente, podendo assim realizar as consultas necessárias.

Expandir
titleAcesso DesenvolvedorTela Login

Image RemovedImage Added

Expandir
titleAtenção🚨 ATENÇÃO🚨
Informações

Na ausência de Admins com a flag marcada para a área selecionada, o sistema garantirá que o usuário não fique sem um contato.
Nesses casos, serão exibidos todos os usuários com perfil Admin daquela área.

O link anterior de documentação (https://empodera.totvs.com/api/docs) foi desativado.
A partir de agora, qualquer tentativa de acesso a este endereço exibirá uma mensagem de "Acesso Restrito".
Expandir
titleAcesso Restrito

Image Removed

  1. Por que a mudança é importante?

    Chega de adivinhações! Esta atualização

representa um ganho significativo de autonomia e agilidade para os usuários desenvolvedores que utilizam nossas APIs para consultas. O acesso rápido e direto pela plataforma dá mais autonomia ao usuário, eliminando a necessidade de liberações por área ou a solicitação de abertura de tickets ao time de suporte.
Expandir

  1. entrega um valor direto ao simplificar e agilizar drasticamente o processo de onboarding de novos colaboradores.
    O usuário agora sabe exatamente quem contatar para obter seu acesso, reduzindo o tempo de espera e eliminando a fricção no primeiro contato com a ferramenta. O resultado é um processo de solicitação de acesso transparente, rápido e direcionado.

🔒 Nova Gestão de Acesso para APIs em Horário Comercial
Expandir
title✨Gerenciamento Avançado de Campos Customizados

Apresentamos uma melhoria crucial na forma como você gerencia seus campos de seleção. Agora é possível ocultar opções obsoletas sem perder o histórico de dados!

title

O que há de novo

Para otimizar a performance e garantir maior controle sobre os recursos do sistema durante os períodos de maior utilização, implementamos uma nova regra de restrição de acesso às APIs do Empodera para usuários de integração durante o horário comercial.

Como Funciona

Restrição de Horário: Por padrão, todas as requisições deusuários de integração às APIs serão bloqueadas no intervalo das 07:00h às 19:00h (Horário Comercial TOTVS).

  • Retorno de Bloqueio: Durante o período de restrição, qualquer tentativa de acesso por um usuário de integração retornará o status HTTP 403 (Forbidden) acompanhado de uma mensagem informativa.

  • Controle de Acesso (Flag): Adicionamos na tela de "Gestão Empodera > Integrações" uma nova flag que permite que o time de Suporte habilite (desativar o bloqueio) o acesso às APIs durante o horário comercial.
    Isso oferece flexibilidade para casos de necessidade operacional.

    • ?

    Identificamos que, ao longo do tempo, algumas opções em campos customizados de seleção (como Múltipla Seleção, Múltiplas Caixa de Seleção e Lista Suspensa) tornam-se obsoletas.

    No entanto, não era possível desativá-las para novos preenchimentos sem impactar os registros históricos que já utilizavam essas opções.

    Com esta atualização, os administradores ganham o poder de "ocultar" opções que não são mais relevantes, limpando a lista para novos usos, mas preservando a integridade total dos dados passados.

    🔧 Como Funciona?

    A funcionalidade foi dividida em duas frentes: a configuração pelo administrador e o impacto no uso diário da ferramenta.


    Expandir
    title1. Para Administradores (Configuração de Campos):

    • Ocultando Opções: Ao acessar a tela de configuração de Campos Customizados, você encontrará uma nova interface para gerenciar as opções dos campos de seleção (Múltipla Seleção, Múltiplas Caixa de Seleção e Lista Suspensa).

    • Controle de Status: Cada opção agora possui um controle (como um toggle ) que permite ao administrador alterar seu status para "Desabilitado".

    • Feedback Visual: A interface indicará claramente quais opções estão habilitadas e quais estão desabilitadas, facilitando o gerenciamento.

    Expandir
    title2. Para Usuários (Preenchimento e Visualização):

    • Novos Preenchimentos: Ao preencher um novo Playbook que possui Campos Customizados associados , apenas as opções marcadas como habilitadas serão exibidas na lista de seleção. Na aba de Campos Customizados do cliente , as opções desabilitadas não serão exibidas. Isso tornará o preenchimento mais rápido e relevante.

    • Visualização de Histórico: Ao visualizar dados já existentes (em Clientes, Listagem de Clientes, etc.), todos os valores preenchidos continuarão sendo exibidos corretamente, mesmo que a opção selecionada no passado esteja agora "oculta".

    Expandir
    titleNa Prática:

    Seu campo "Tipo de Chamado" (Lista Suspensa) tinha as opções "Dúvida", "Incidente" e "Solicitação". Você decide ocultar "Incidente".

    1. Administrador: Na configuração, marca "Incidente" como 'Desabilitar'.

    2. No Cliente: O usuário que irá editar o campo "Tipo de Chamado" só visualizara disponível as opções "Dúvida" e "Solicitação". Assim também se o campo estiver associado a um Playbook ou Atividade.

    3. Registro Antigo: Um registro antigo do campo "Tipo de Chamado", que foi classificado como "Incidente" continuará exibindo "Incidente" em sua visualização, porém com a informação de "(desabilitado)" à frente.

  • Auditoria: Para garantir a rastreabilidade, todas as ações de habilitar ou desabilitar esta flag serão registradas. Os últimos 10 registros (incluindo usuário e data da modificação) serão armazenados.

    • Observação: O acesso fora do horário comercial (das 19:01h às 06:59h) permanece liberado normalmente para os usuários de integração.

    💡

    Por que a mudança é importante?

    Esta atualização entrega maior governança e controle sobre o ambiente. Ao gerenciar o fluxo de integrações em horários de pico, garantimos a estabilidade da plataforma para os usuários. A inclusão da flag de controle e dos logs de auditoria proporciona a flexibilidade necessária para a operação, mantendo a segurança e a rastreabilidade das açõesresolve um desafio chave de gerenciamento de dados:

    • Flexibilidade Total: Administradores podem adaptar os campos customizados às necessidades atuais do negócio sem medo de corromper dados históricos.

    • Melhoria na Usabilidade: Os usuários finais têm uma experiência mais limpa ao preencher os campos customizados , vendo apenas as opções que realmente importam no momento.

    • Integridade dos Dados: Garantimos que seu histórico e seus relatórios permaneçam 100% precisos, pois os dados passados não são alterados ou perdidos. É o melhor dos dois mundos: listas limpas e histórico intacto.

  • Visão Padrão: Ao acessar a tela de Planos de Ação de um cliente, o sistema agora aplica um filtro automático, exibindo por padrão apenas os planos que pertencem à Equipe do usuário logado (ou à sua Área, se ele não possuir equipe).

  • Associação Automática: Ao criar um novo Plano de Ação, o campo "Equipe" ou "Área" será preenchido automaticamente com base nos dados do usuário criador.

    • ?

    Percebemos que a gestão de etiquetas não estava totalmente vinculada ao contexto da Área ou Equipe do usuário. Isso podia causar confusão na visualização e, principalmente, falhas na execução de Regras, já que uma automação poderia afetar clientes de equipes diferentes.

    Esta entrega unifica quatro frentes de trabalho para corrigir a arquitetura da funcionalidade. O resultado é que as etiquetas agora funcionam exclusivamente dentro do contexto (Área ou Equipe) em que são criadas e gerenciadas, trazendo mais controle e precisão para o seu dia a dia.

    🔧 Como Funciona?

    A mudança impacta toda a jornada de uso das Etiquetas, desde a base de dados até a execução de regras.

    Expandir
    title🚀 Evolução dos Planos de Ação: Gestão Completa por Equipe e Área🚀Gestão de Etiquetas por Equipe e Correção Estrutural

    Esta atualização representa um avanço fundamental na funcionalidade de Etiquetas (Labels). Corrigimos a arquitetura de dados e garantimos que toda a gestão de etiquetas (manual ou via regras) agora respeita 100% o contexto da sua Área ou Equipe.

    ✨ O que há de novo

    Para otimizar o fluxo de trabalho e garantir maior segurança e foco das informações, realizamos uma evolução completa na funcionalidade de Planos de Ação. Antes, a gestão de planos, formulários e playbooks era por área; agora, o conceito de Equipe foi totalmente integrado em todo o ciclo de vida do Plano de Ação.

    Isso significa que, desde a criação manual de um plano, até a adição de seus componentes (Formulários e Playbooks) e a atribuição de responsáveis, tudo respeitará a estrutura de Equipe do usuário.

    Como Funciona

    Expandir
    titleCriação e Visualização de Planos de Ação (Foco na Equipe)
    Expandir
    titleCorreção Estrutural e Migração de Dados

    Este foi o núcleo da entrega. Realizamos uma refatoração crítica na modelagem do banco de dados para corrigir relacionamentos e eliminar redundâncias. A tabela labels agora se vincula corretamente a area_id ou team_id, e um script de migração garantiu que todos os dados legados (do MongoDB) fossem trazidos para a nova estrutura de forma íntegra.

    Expandir
    titleGestão Manual (Tela do Cliente e Listagem)

    Ao adicionar ou remover uma etiqueta manualmente na Tela do Cliente ou na Listagem de Clientes, essa ação agora é restrita à Área/Equipe em que você está logado.

    • Exemplo: Se você adicionar a etiqueta "Crítico" a um cliente na Equipe A, essa etiqueta não aparecerá para o mesmo cliente quando visto pela Equipe B.

    Expandir
    title3. Automação (Regras: Condições)

    As Condições de regras que filtram por "Etiqueta" (Ex: "Se cliente POSSUI etiqueta X") agora respeitam o contexto. A regra só verificará as etiquetas do cliente dentro da equipe onde a regra está sendo executada.

    Expandir
    title4. Automação (Regras: Ações)

    Da mesma forma, as Ações de regras (Ex: "Adicionar etiqueta Y") também foram ajustadas. A regra só incluirá ou excluirá etiquetas no cliente dentro da equipe à qual a regra pertence, sem "invadir" o contexto de outras equipes.

    Seleção de Responsáveis: A lista de "Responsáveis" disponíveis para seleção no plano de ação agora éfiltrada, exibindo apenas usuários que pertencem à mesma Equipe ou Área à qual o plano está sendo associado.Limpeza de Filtro: O usuário ainda pode limpar o filtro padrão para visualizar todos os planos de ação do cliente, caso tenha permissão.      
    Expandir
    titleVisualização

    Image Removed

    Expandir
    titleAdição de Formulários e Playbooks (Contexto e Segurança)

  • Busca Filtrada:
     Ao adicionar um Formulário a um Plano de Ação, a lista de seleção exibirá apenas os formulários que pertencem à mesma Equipe/Área daquele Plano.
     Assim também com um Playbook no Plano de Ação, a lista de seleção exibirá apenas os playbooks que pertencem à Equipe/Área daquele Plano.

    • Responsáveis Filtrados:
    Da mesma forma, o campo de seleção de "Responsável" dentro do plano mostrará apenas membros da Equipe/Área do plano.
    Expandir
    titleVisualização

    Image Removed

    Expandir
    titleAutomação via Regras (Coerência Total)
    A lógica de Equipe/Área foi estendida às Regras.
    Ao configurar uma Ação do tipo "Plano de Ação" dentro de uma Regra, as listas de Formulários e Playbooks disponíveis para seleção também serão filtradas de acordo com a Equipe/Área.
    Expandir
    titleVisualização

    Image Removed

    💡

    Por que a mudança é importante?

    Esta é uma das atualizações estruturais mais importantes para a gestão de CS na plataforma. Ela move o Empodera de um modelo "global" para um modelo focado em governança, segurança e produtividade:

    • Foco Imediato: O CSM vê por padrão apenas os planos e recursos de sua própria equipe, reduzindo o ruído visual e agilizando o trabalho diário.

    • Autonomia e Organização: As equipes agora podem gerenciar seus próprios catálogos de Formulários e Playbooks, sabendo que eles serão usados no contexto correto.

    • Processo Coerente: Garantimos que as atribuições e o acesso sejam corretos, independentemente de o plano ser criado manualmente pelo CSM ou automaticamente por uma Regra.

    entrega de alta integridade estrutural que desbloqueia o verdadeiro potencial das etiquetas:

    • Contexto e Organização: O benefício mais direto é a organização. Cada equipe agora tem controle total sobre suas próprias etiquetas, sem poluir a visualização das outras.

    • Automação Precisa: O poder das Regras de automação é maximizado. Você pode criar regras complexas baseadas em etiquetas com a segurança de que elas só serão acionadas e aplicadas no contexto correto da sua equipe.

    • Dados Confiáveis: Com a correção da arquitetura de dados, garantimos que as queries, filtros e visualizações de etiquetas sejam 100% precisos e consistentes em toda a plataforma.

    ⚡ Otimização e Monitoramento do Worker de Regras
    Expandir
    title✏️ Padronização de Nomenclatura: "Empresas vinculadas" agora é "Grupo econômico"

    Para manter a plataforma alinhada com os termos de gestão de mercado, atualizamos uma nomenclatura importante referente ao cadastro de clientes.

    Expandir
    title

    O que há de novo

    Realizamos uma melhoria interna significativa no "Worker de Regras", um dos componentes centrais do Empodera. O objetivo desta atualização é aumentar a nossa capacidade de monitoramento (observabilidade) e gestão sobre a execução das regras.

    Como Funciona

  • Rastreabilidade Aprimorada: A partir de agora, cada execução de regra (seja uma execução completa, por área ou individual) é registrada e monitorada como uma tarefa separada.

    • Logs Otimizados: Revisamos os registros de atividade interna para focar nas informações estritamente necessárias, garantindo uma análise de performance mais ágil e eficiente

    Identificamos que a nomenclatura utilizada no sistema para agrupar empresas atreladas a um cliente (como matrizes, filiais e coligadas) estava desatualizada. O termo "Empresas vinculadas" não refletia mais o padrão de gestão adotado.

    Como Funciona

    Realizamos uma substituição desse termo na plataforma. A partir de agora, qualquer referência a "Empresas vinculadas" passa a ser exibida como "Grupo econômico".

    Essa alteração é estritamente textual e afeta todos os módulos e funcionalidades, incluindo:

    • Abas (ex: na Página do Cliente);

    • Títulos de colunas em tabelas e relatórios;

    • Tooltips (dicas de interface);

    • Condições de regras;

    • Cabeçalhos de relatórios e exportações.

    A funcionalidade de listagem e gerenciamento dessas empresas permanece exatamente a mesma, sem alteração comportamental.

    Por que a mudança é importante?

    Embora esta seja uma mudança técnica (backend), ela é fundamental para a estabilidade da plataforma. Com essa maior visibilidade:

  • Agilidade na Solução: Nossa equipe técnica agora consegue identificar e diagnosticar eventuais falhas na execução de regras de forma muito mais rápida.

  • Análise Preventiva: O novo monitoramento permite que tomemos ações preventivas antes que um problema impacte o usuário final.

    • Confiabilidade: Garantimos um acompanhamento mais robusto do progresso, sucessos e erros das execuções, resultando em um Worker de Regras mais confiável

    Esta atualização é um ajuste de padronização essencial. Ao adotar o termo "Grupo econômico", alinhamos a linguagem do Empodera com os conceitos de negócio atuais, garantindo maior clareza, consistência e profissionalismo na interface para todos os usuários.

    Expandir
    👤 Rumo à Autonomia: Identificando Administradores Responsáveis (Parte 1)
    title🗑️ Melhoria de Interface: Remoção do Botão de 'Feedback'

    Visando uma interface mais limpa e a eliminação de funcionalidades legadas sem uso, removemos artefatos desnecessários da plataforma.

    O que há de novo

    Iniciamos uma entrega maior focada em otimizar e descentralizar o processo de onboarding de novos usuários no Empodera.

    Nesta primeira fase (Parte 1), criamos uma forma de identificar oficialmente quem são os administradores responsáveis pela liberação de acesso em cada área ou ambienteExistia um botão de 'Feedback' na tela de "Empresas Vinculadas" (agora "Grupo econômico"). Este botão disparava um fluxo de coleta de informações que não era mais processado ou utilizado pela equipe do Empodera, gerando ruído visual.

    Como Funciona

  • Nova Flag de Permissão:
    Adicionamos um novo campo na tela de Gestão de Usuários (ao criar ou editar um usuário) chamado "Admin Responsável por Acesso".

  • Visibilidade Restrita:
    Esta nova opção é visível e editável apenas para usuários que possuem o perfil de "Admin".

  • Definição de Responsabilidade:
    Ao marcar esta flag, o sistema passa a reconhecer aquele Administrador como um ponto de contato oficial com permissão para criar e liberar o acesso de novos usuários da sua respectiva área/ambiente.

    • Múltiplos Responsáveis:
    O sistema permite que múltiplos usuários Admin sejam marcados como responsáveis dentro da mesma área.
    Expandir
    titleVisualização

    Image Removed

    O botão de 'Feedback' foi completamente removido da interface.

    1. Remoção Visual: O botão não está mais visível na tela de "Grupo econômico" (antiga "Empresas Vinculadas").

    2. Remoção Completa: Realizamos uma varredura no código-fonte e removemos este mesmo artefato de todas as outras telas do Empodera onde ele estava presente, garantindo consistência.

    3. Remoção do Fluxo: Juntamente com o botão, todos os fluxos de dados e chamadas de rede associados a esta funcionalidade foram desativados e removidos.

    Por que a mudança é importante?

    Esta entrega foca na melhoria da experiência do usuário  e na saúde do código.

    Ao remover um componente visual sem utilidade, tornamos a interface do Empodera mais limpa, direta e objetiva. Além disso, eliminamos código legado, garantindo que o sistema execute apenas os processos que agregam valor real à operação.

    Expandir
    title🛠️Relatório de Clientes: Etiquetas por Equipe

    Garantimos a precisão dos dados no Relatório de Clientes, ajustando a forma como as etiquetas (tags) são exportadas.

    O que há de novo

    Identificamos que, ao exportar o "Relatório de Clientes", o sistema não estava trazendo corretamente as etiquetas que eram atribuídas a um cliente dentro do contexto específico de uma área/equipe.

    Como Funciona

    Realizamos uma correção na consulta de dados do relatório. A partir de agora, ao acessar a tela do Cliente e solicitar a exportação do "Relatório de Clientes", o sistema buscará as informações de etiquetas diretamente da fonte correta (v2/repository).

    Isso garante que as etiquetas exibidas na exportação sejam exatamente aquelas atribuídas ao cliente dentro da sua respectiva equipe/área.

    Por que a mudança é importante?

    Esta atualização é a primeira etapa (Parte 1) de uma entrega fundamental para dar mais autonomia às áreas na gestão de seus usuários e simplificar o processo de primeiro acesso.

    Ao identificar os "Admins Responsáveis" agora, preparamos o Empodera para a segunda etapa (Parte 2): exibir esses contatos diretamente na tela de login para novos usuários.

    O ganho futuro:

    Com esta implementação completa, o novo usuário do Empodera saberá exatamente e de forma rápida quem ele deve contatar dentro da sua própria área para solicitar a criação do seu acesso, facilitando o onboardingA precisão dos dados é fundamental. Com esta correção, os relatórios exportados passam a refletir fielmente a segmentação de clientes por equipe, garantindo que gestores e usuários tenham informações confiáveis para suas análises e tomadas de decisão.