Gestão de Pessoas API

versão 1 4 5 data de publicação 10/11/2025 data de publicação 10/11/2025 ⚙️ foram feitos ajustes relacionados à integração com a aura 🚀orientações para deploy pacote lowcode https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento imagens run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 4 5 release as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta versão 1 4 4 data de publicação 04/09/2025 data de publicação 04/09/2025 ✉️ ajuste no envio de e mails agora o endereço do servidor (host) usado para enviar e mails 👉 é definido por uma variável de ambiente 🚀orientações para deploy pacote lowcode https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento imagens run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 4 4 release variáveis de ambiente adicionadas chave valor de exemplo opcional descrição email host smtpout secureserver net ✅ host para envio de email caso não definido, valor padrão 'smtp office365 com' as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta versão 1 4 2 data de publicação 22/08/2025 data de publicação 22/08/2025 📧 e mail automático ao criar usuário agora o sistema pode enviar um e mail automaticamente quando um usuário é criado ⚠️ esse e mail só é enviado se a configuração sendemailonusercreation = true na tabela gestão de pessoas secrets 👥 criação de usuários em massa agora é possível criar vários usuários de uma só vez para tenants do marketplace 🚀orientações para deploy pacote lowcode https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento imagens run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 4 2 release centralit nexus nexus centralit io 9091/gestao pessoas api 1 4 2 release variáveis de ambiente adicionadas chave valor de exemplo opcional descrição email user email\@dominio com ✅ usuário utilizado para envio de e mails de criação de usuário via host smtp office365 com se não informado, os e mails não serão enviados email pass password ✅ senha do usuário definido em email user para envio de e mails via smtp office365 com se não informado, os e mails não serão enviados base domain cloud4biz com ✅ domínio usado nos links enviados nos e mails de criação de usuário gp secrets cache ttl 7200 ✅ tempo de vida (ttl) em segundos do cache de secrets padrão 3600 segundos (1 hora) gp secrets cache check period 360 ✅ intervalo em segundos para verificação do cache de secrets padrão 180 segundos (3 minutos) as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta versão 1 4 0 data de publicação 10/06/2025 data de publicação 10/06/2025 🔐 controle de acesso mais inteligente agora o sistema controla o que cada pessoa pode fazer com base nas licenças do tenant (empresa/cliente) 📊 consulta de licenças usadas (por dentro do sistema) serve para ver quantas licenças já estão sendo usadas por um tenant específico é possível filtrar informando 🏷️ realm → nome do ambiente 🆔 tenant uuid → identificador do tenant 🔑 rota /gettenantusedapplicensesbytoken retorna as licenças usadas do tenant automaticamente , usando apenas o token de acesso 🚀orientações para deploy pacote lowcode https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento imagens run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 4 0 release variáveis de ambiente adicionadas chave valor de exemplo opcional descrição keycloak realm run2biz ❌ define o realm principal/admin keycloak user usuario ❌ user admin do keycloak keycloak password password ❌ password admin do keycloak as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta versão 1 3 6 data de publicação 27/02/2025 data de publicação 27/02/2025 👩‍💼👨‍💼 gestores com mais acesso agora usuários com a role de gestor no mydesk podem acessar as telas de 📄 lista de usuários (/page/users/list) 👥 grupos e membros (/groupmembers) 🚫 filtro automático de usuários usuários que possuem o atributo gphide são filtrados ⚙️ parâmetro extra para mostrar usuários ocultos foi criado o parâmetro mdshow quando usado, ignora o filtro do gphide e mostra usuários que normalmente ficariam ocultos 🚀orientações para deploy pacote lowcode https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento imagens run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 3 6 release as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta versão 1 3 5 data de publicação 25/02/2025 data de publicação 25/02/2025 decodificação base64 segura correções no código 🚀orientações para deploy pacote lowcode https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento imagens run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 3 5 release as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta release 1 3 3 informações da release considerações aplicação gestão de pessoas api nome da versão 1 3 3 data de publicação 20/12/2024 cards relacionados (informar título do card) imagens da versão run2biz produção registry cloud4biz com/deployscdi/gestao pessoas api 1 3 3 release centralit nexus nexus centralit io 9091/gestao pessoas api 1 3 3 release melhorias/ novas funcionalidades removido /auth das rotas iniciais das urls do keycloak para compatibilidade com a versão 25, apenas adicionando /auth nas variáveis de ambiente quando necessário adicionado rota interna para 'obter usuários por ids' necessário ter a variável de ambiente feature internal routes=true parametro 'max' adicionado na rota /groupmembers, define o maximo de usuarios a serem retornados parametro 'max' adicionado na rota /page/users/list, define o maximo de usuarios a serem retornados parametro 'ismarketplace' adicionado na rota /roles, caso verdadeiro, roles de sistema e roles de aplicações não adquiridas no ambiente não são retornadas parametro 'mdgroups' adicionado na rota getgroups, caso verdadeiro, apenas grupos com o atributo mdshow=true são retornados atributos incluidos na criação ou update de grupos correções orientações para deploy https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento as orientações desta seção pressupõem que a mudança de versão está partindo da seção anterior para a atual caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão atual do seu ambiente até esta release 1 2 11 informações da release considerações aplicação gestão de pessoas api nome da versão 1 2 11 data de publicação 13/11/2024 cards relacionados (informar título do card) imagens da versão (central it) centralit nexus nexus centralit io 9091/gestao pessoas api 1 2 11 release melhorias/ novas funcionalidades endpoint post "/createorupdategroup" agora retorna o id do grupo atualizado/criado novo endpoint get "/groupmembers" /groupmembers get retorna os membros de um grupo, até 10 usuários parâmetros groupid string id do grupo desejado first number (default = 0) traz os usuários a partir deste numero (paginação) correções corrigido bug no mecanismo de usuários dessincronizados quando o cache de usuários está ativado, causando uma aparente perda de dados do usuário criado/editado visto que o cache não está sincronizado com o keycloak corrigido bug na criação de usuários por não encontrar o id do usuário recém criado orientações para deploy https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento release 1 1 3 informações da release considerações aplicação gestão de pessoas api nome da versão 1 1 3 data de publicação 26/09/2024 cards relacionados (informar título do card) imagens da versão (central it centralit nexus nexus centralit io 9091/gestao pessoas api 1 1 3 release correções corrigido bug no mecanismo de usuários dessincronizados quando o cache de usuários está ativado, causando uma aparente perda de dados do usuário criado/editado visto que o cache não está sincronizado com o keycloak corrigido bug na criação de usuários por não encontrar o id do usuário recém criado orientações para deploy https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento release 1 1 2 informações da release considerações aplicação gestão de pessoas api nome da versão 1 1 2 data de publicação 25/09/2024 cards relacionados (informar título do card) https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6425 https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6427 https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6586 imagens da versão (central it centralit nexus nexus centralit io 9091/gestao pessoas api 1 1 1 release melhorias/ novas funcionalidades possibilidade de busca de usuários usando campos como nome de usuário, primeiro nome, sobrenome e e mail corrigido bug com a pesquisa na tratativa de erros e conversão de valores adição de um mecanismo opcional de cache na busca de usuários através do redis para caso de lentidão na resposta do keycloak (ex uso de integração ldap no realm, keycloak externo a rede do cluster etc) retirado botões de exportação da interface de usuários/dashboard usuários sem sessão definida são interpretados como "ilimitado" possibilidade de busca de usuários usando campos como nome de usuário, primeiro nome, sobrenome e e mail orientações para deploy as orientações desta seção pressupõem que a mudança de versão está partindo de 1 1 2 para 1 1 1 caso não seja esse o cenário, siga as orientações dos lançamentos anteriores, partindo da versão do ambiente até esta https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento chave valor de exemplo opcional descrição max users before pagination 1000 (padrão) ✅ define a estratégia de obtenção de usuários entre paginação e lote com todos usuários baseado na quantidade de usuário no realm alvo valor inteiro users per page limit 500 (padrão) ✅ define a quantidade de usuários por página na estratégia de obtenção de usuários entre paginação baseado na quantidade de usuário no realm alvo valor inteiro feature users cache enabled false ✅ define se o cache de usuários deve ser habilitado ou não valor booleano redis url redis\ //localhost 6379 (padrão) ❌ define a url do redis (necessário apontar para o servidor do redis master) formato redis\[s] //\[\[username]\[ password]@]\[host]\[ port]\[/db number] force first run refetch false ✅ define se o cache de usuários deve ser atualizado ou não ao iniciar a aplicação ignorando o cache local valor booleano users batch update cron /30 ✅ define o cron para atualizar o cache de usuários valor cron keycloak max requests per second 20 ✅ define o limite de requisições por segundo para o keycloak valor inteiro keycloak cache max requests per second 10 ✅ define o limite de requisições por segundo do cache do keycloak valor inteiro release 1 1 1 informações da release considerações aplicação gestão de pessoas api nome da versão 1 1 1 data de publicação 25/09/2024 cards relacionados (informar título do card) https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6425 https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6427 https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6586 imagens da versão (central it centralit nexus nexus centralit io 9091/gestao pessoas api 1 1 1 release melhorias/ novas funcionalidades possibilidade de busca de usuários usando campos como nome de usuário, primeiro nome, sobrenome e e mail adição de um mecanismo opcional de cache na busca de usuários através do redis para caso de lentidão na resposta do keycloak (ex uso de integração ldap no realm, keycloak externo a rede do cluster etc) retirado botões de exportação da interface de usuários/dashboard usuários sem sessão definida são interpretados como "ilimitado" possibilidade de busca de usuários usando campos como nome de usuário, primeiro nome, sobrenome e e mail orientações para deploy https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas/package gestao pessoas automation zip https //gitlab cloud4biz com/lowcode/lowcode packages/ /blob/main/gestaopessoas admin/package gestao admin v1 0 zip esse pacote é destinado somente ao tenant principal por ser um componente da api para seu correto funcionamento chave valor de exemplo opcional descrição max users before pagination 1000 (padrão) ✅ define a estratégia de obtenção de usuários entre paginação e lote com todos usuários baseado na quantidade de usuário no realm alvo valor inteiro users per page limit 500 (padrão) ✅ define a quantidade de usuários por página na estratégia de obtenção de usuários entre paginação baseado na quantidade de usuário no realm alvo valor inteiro feature users cache enabled false ✅ define se o cache de usuários deve ser habilitado ou não valor booleano redis url redis\ //localhost 6379 (padrão) ❌ define a url do redis (necessário apontar para o servidor do redis master) formato redis\[s] //\[\[username]\[ password]@]\[host]\[ port]\[/db number] force first run refetch false ✅ define se o cache de usuários deve ser atualizado ou não ao iniciar a aplicação ignorando o cache local valor booleano users batch update cron /30 ✅ define o cron para atualizar o cache de usuários valor cron keycloak max requests per second 20 ✅ define o limite de requisições por segundo para o keycloak valor inteiro keycloak cache max requests per second 10 ✅ define o limite de requisições por segundo do cache do keycloak valor inteiro release 1 0 11 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 11 data de publicação 02/09/2024 cards relacionados (informar título do card) https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6425 https //admin 4biz one/kanban/workspaces/1196/boards/1633/tasks/6427 imagens da versão (central it centralit nexus nexus centralit io 9091/gestao pessoas api 1 0 11 melhorias/ novas funcionalidades (fix) melhorias no tratamento de erros na checagem de licença correções (fix) bug na criação de usuários individuais e por lote por mudanças na checagem de licença | release 1 0 10 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 10 data de publicação cards relacionados (informar título do card) imagens da versão (central it melhorias/ novas funcionalidades refatorado o mecanismo de processamento de logs correções (fix) alterado o token de serviço para o do usuário na checagem de licença release 1 0 9 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 9 data de publicação cards relacionados (informar título do card) imagens da versão (central it melhorias/ novas funcionalidades merge da branch "feature/auth cookie" correções erro na alteração de senha do usuário resolvido release 1 0 5 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 5 data de publicação cards relacionados (informar título do card) imagens da versão (central it melhorias/ novas funcionalidades paginação alterada para server side busca de usuarios alterada para server side melhor performance ordenação removida devido a limitações do keycloak release 1 0 3 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 3 data de publicação cards relacionados (informar título do card) imagens da versão (central it melhorias/ novas funcionalidades criação e deleção de roles implementadas para usuarios com a role "gp admin" correções senha padrão alterada para atender os requisitos de prod release 1 0 2 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 2 data de publicação cards relacionados (informar título do card) imagens da versão (central it melhorias/ novas funcionalidades funcionalidade de importação e exportação de usuários em massa implementada release 1 0 0 informações da release considerações aplicação gestão de pessoas api nome da versão 1 0 0 data de publicação cards relacionados (informar título do card) imagens da versão (central it melhorias/ novas funcionalidades primeira versão da gestão de pessoas api crud de usuários crud de grupos relatório de usuários x roles efetivas (roles diretamente adicionadas ao usuario, assim como indiretamente ex roles adicionadas por pertencer a um grupo) integrada a gestão de licenças api, para validar usuários e seus tipos de sessão correções orientações para deploy