Gestão de Pessoas API
Data: de publicação: 10/11/2025
⚙️ Foram feitos ajustes relacionados à integração com a AURA.
🚀ORIENTAÇÕES PARA DEPLOY
Pacote lowcode:
- 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.
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:
- 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.
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:
- 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 | ✅ | 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.
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:
- 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.
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:
- 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.
Data: de publicação: 25/02/2025
- Decodificação base64 segura.
- Correções no código.
🚀ORIENTAÇÕES PARA DEPLOY
Pacote lowcode:
- 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.
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 |
|
🆕 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
🚀ORIENTAÇÕES PARA DEPLOY
- 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.
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 (Run2Biz) | Run2biz - Produção: registry.cloud4biz.com/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
- package_gestao_admin_v1.0.zip: Esse pacote é destinado somente ao Tenant Principal por ser um componente da API para seu correto funcionamento.
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 (Run2Biz) | Run2biz - Produção: registry.cloud4biz.com/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
- package_gestao_admin_v1.0.zip: Esse pacote é destinado somente ao Tenant Principal por ser um componente da API para seu correto funcionamento.
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 (Run2Biz) | Run2biz - Produção: registry.cloud4biz.com/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
- package_gestao_admin_v1.0.zip: Esse pacote é destinado somente ao Tenant Principal por ser um componente da API para seu correto funcionamento.
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) | |
Imagens da versão (Run2Biz) |
|
🆕 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.
- 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. |
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) | |
Imagens da versão (Run2Biz) |
|
🆕 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
- 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. |
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) | |
Imagens da versão (Run2Biz) |
|
🆕 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.|
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 (Run2Biz) | |
🆕 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.
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 (Run2Biz) | |
🆕 MELHORIAS / NOVAS FUNCIONALIDADES
- Merge da branch "Feature/auth cookie"
✅ CORREÇÕES
- Erro na alteração de senha do usuário resolvido
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 (Run2Biz) | |
🆕 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
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 (Run2Biz) | |
🆕 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
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 (Run2Biz) | |
🆕 MELHORIAS / NOVAS FUNCIONALIDADES
- Funcionalidade de Importação e Exportação de usuários em massa implementada
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 (Run2Biz) | |
🆕 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