---
title: Gestão de Pessoas API
slug: releases/gestao-de-pessoas-api
docTags: 
createdAt: 2024-10-10T13:36:28.871Z
---

:::::ExpandableHeading
## Versão 1.4.5

<font color="#4283c7">Data: de publicação: 10/11/2025</font>

::::Tabs
:::Tab{title="Evoluções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/v3QOBRFO45u3MVuqke-WI_titulo-destaque-de-valor.png)

⚙️ Foram feitos ajustes relacionados à integração com a AURA.

***
:::

:::Tab{title="Deploy"}
**🚀ORIENTAÇÕES PARA DEPLOY**

**Pacote lowcode:**

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)
- [package\_gestao\_admin\_v1.0.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`&#x20;

*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.*
:::
::::
:::::

:::::ExpandableHeading
## Versão 1.4.4

<font color="#4283c7">Data: de publicação: 04/09/2025</font>

::::Tabs
:::Tab{title="Evoluções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/v3QOBRFO45u3MVuqke-WI_titulo-destaque-de-valor.png)

**✉️ Ajuste no envio de e-mails**

- Agora o **endereço do servidor (host)** usado para enviar e-mails
  &#x20;👉 é definido por uma **variável de ambiente**.

***
:::

:::Tab{title="Deploy"}
**🚀ORIENTAÇÕES PARA DEPLOY**

Pacote lowcode:

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)
- [package\_gestao\_admin\_v1.0.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`&#x20;

***

**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.*
:::
::::
:::::

:::::ExpandableHeading
## Versão 1.4.2

<font color="#4283c7">Data: de publicação: 22/08/2025</font>

::::Tabs
:::Tab{title="Evoluções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/v3QOBRFO45u3MVuqke-WI_titulo-destaque-de-valor.png)

📧 **E-mail automático ao criar usuário**

- Agora o sistema pode **enviar um e-mail automaticamente** quando um usuário é criado.&#x20;
- ⚠️ Esse e-mail **só é enviado se** a configuração:&#x20;
  - 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**.

***
:::

:::Tab{title="Deploy"}
**🚀ORIENTAÇÕES PARA DEPLOY**

Pacote lowcode:

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)
- [package\_gestao\_admin\_v1.0.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`&#x20;

***

**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.*
:::
::::
:::::

:::::ExpandableHeading
## Versão 1.4.0

<font color="#4283c7">Data: de publicação: 10/06/2025</font>

::::Tabs
:::Tab{title="Evoluções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/v3QOBRFO45u3MVuqke-WI_titulo-destaque-de-valor.png)

**🔐 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.&#x20;
- É possível filtrar informando:&#x20;
  - 🏷️ **realm** → nome do ambiente&#x20;
  - 🆔 **tenant-uuid** → identificador do tenant

***

🔑 **Rota&#x20;**`/getTenantUsedAppLicensesByToken`

- Retorna as **licenças usadas do tenant automaticamente**, usando apenas o **token de acesso**.

***
:::

:::Tab{title="Deploy"}
**🚀ORIENTAÇÕES PARA DEPLOY**

Pacote lowcode:

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)
- [package\_gestao\_admin\_v1.0.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.*
:::
::::
:::::

:::::ExpandableHeading
## Versão 1.3.6

<font color="#4283c7">Data: de publicação: 27/02/2025</font>

::::Tabs
:::Tab{title="Evoluções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/v3QOBRFO45u3MVuqke-WI_titulo-destaque-de-valor.png)

**👩‍💼👨‍💼 Gestores com mais acesso**

- Agora **usuários com a role de Gestor no MyDesk** podem acessar as telas de:&#x20;
  - 📄 Lista de usuários (/page/users/list)&#x20;
  - 👥 Grupos e membros (/groupMembers)

***

**🚫 Filtro automático de usuários**

- Usuários que possuem o atributo **gpHide&#x20;**&#x73;ão filtrados.&#x20;

***

**⚙️ Parâmetro extra para mostrar usuários ocultos**

- Foi criado o parâmetro **mdShow :&#x20;**&#x71;uando usado, **ignora o filtro do gpHide** e mostra usuários que normalmente ficariam ocultos.

***
:::

:::Tab{title="Deploy"}
**🚀ORIENTAÇÕES PARA DEPLOY**

Pacote lowcode:

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)
- [package\_gestao\_admin\_v1.0.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.*
:::
::::
:::::

:::::ExpandableHeading
## Versão 1.3.5

<font color="#4283c7">Data: de publicação: 25/02/2025</font>

::::Tabs
:::Tab{title="Evoluções"}
![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/v3QOBRFO45u3MVuqke-WI_titulo-destaque-de-valor.png)

- Decodificação base64 segura.
- Correções no código.

***
:::

:::Tab{title="Deploy"}
**🚀ORIENTAÇÕES PARA DEPLOY**

Pacote lowcode:

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)
- [package\_gestao\_admin\_v1.0.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.*
:::
::::
:::::

:::ExpandableHeading
## 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&#x20;
- **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&#x20;
- Adicionado rota interna para 'obter usuários por ids' - Necessário ter a variável de ambiente FEATURE\_INTERNAL\_ROUTES=true&#x20;
- Parametro 'max' adicionado na rota /groupMembers, define o maximo de usuarios a serem retornados&#x20;
- Parametro 'max' adicionado na rota /page/users/list, define o maximo de usuarios a serem retornados&#x20;
- 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&#x20;
- Parametro 'mdGroups' adicionado na rota getGroups, caso verdadeiro, apenas grupos com o atributo mdShow=true são retornados&#x20;
- Atributos incluidos na criação ou update de grupos

### Correções

### Orientações para deploy

- [package\_gestao\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)&#x20;
- [package\_gestao\_admin\_v1.0.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.&#x20;

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.
:::

:::ExpandableHeading
## 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.&#x20;

Novo endpoint get "/groupMembers"

**/groupMembers - GET**

Retorna os membros de um grupo, até 10 usuários.

### Parâmetros

- groupID: string - ID do grupo desejado&#x20;
- 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.&#x20;
- 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\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)&#x20;
- [package\_gestao\_admin\_v1.0.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.
:::

:::ExpandableHeading
## 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.&#x20;
- 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\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)&#x20;
- [package\_gestao\_admin\_v1.0.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.
:::

:::ExpandableHeading
## 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) | - [6425 - \[Ticket - 17474- Gestão de Pessoas\] Falha ao salvar a tela de edição de usuários](https://admin.4biz.one/kanban/workspaces/1196/boards/1633/tasks/6425)&#x20;
- [6427 - \[Gestão de Pessoas\] Corrigir os erros no módulo de gestão de pessoas que está com erro e a carga apresentando lentidão](https://admin.4biz.one/kanban/workspaces/1196/boards/1633/tasks/6427)&#x20;
- [6586 - Ticket-17510\:Corrigir os erros no módulo de gestão de pessoas que está com erro e a carga apresentando lentidão.](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.&#x20;
  - Corrigido bug com a pesquisa na tratativa de erros e conversão de valores.&#x20;
  - 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.&#x20;
  - Usuários sem sessão definida são interpretados como "Ilimitado".&#x20;
  - 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\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)&#x20;
- [package\_gestao\_admin\_v1.0.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.                                                                                 |

###
:::

:::ExpandableHeading
## 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) | - [6425 - \[Ticket - 17474- Gestão de Pessoas\] Falha ao salvar a tela de edição de usuários](https://admin.4biz.one/kanban/workspaces/1196/boards/1633/tasks/6425)&#x20;
- [6427 - \[Gestão de Pessoas\] Corrigir os erros no módulo de gestão de pessoas que está com erro e a carga apresentando lentidão](https://admin.4biz.one/kanban/workspaces/1196/boards/1633/tasks/6427)&#x20;
- [6586 - Ticket-17510\:Corrigir os erros no módulo de gestão de pessoas que está com erro e a carga apresentando lentidão.](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.&#x20;
  - 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.&#x20;
  - Usuários sem sessão definida são interpretados como "Ilimitado".&#x20;
  - 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\_pessoas\_automation.zip](https://gitlab.cloud4biz.com/lowcode/lowcode-packages/-/blob/main/GestaoPessoas/package_gestao_pessoas_automation.zip)&#x20;
- [package\_gestao\_admin\_v1.0.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.                                                                                 |

###
:::

:::ExpandableHeading
## 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) | - [6425 - \[Ticket - 17474- Gestão de Pessoas\] Falha ao salvar a tela de edição de usuários](https://admin.4biz.one/kanban/workspaces/1196/boards/1633/tasks/6425)&#x20;
- [6427 - \[Gestão de Pessoas\] Corrigir os erros no módulo de gestão de pessoas que está com erro e a carga apresentando lentidão](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.|
:::

:::ExpandableHeading
## 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.
:::

:::ExpandableHeading
## 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
:::

:::ExpandableHeading
## 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&#x20;
  - busca de usuarios alterada para server side&#x20;
  - melhor performance&#x20;
  - ordenação removida devido a limitações do keycloak
:::

:::ExpandableHeading
## 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
:::

:::ExpandableHeading
## 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
:::

:::ExpandableHeading
## 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&#x20;
  - CRUD de usuários&#x20;
  - CRUD de grupos&#x20;
  - Relatório de Usuários X Roles efetivas (roles diretamente adicionadas ao usuario, assim como indiretamente. ex: roles adicionadas por pertencer a um grupo)&#x20;
  - integrada a Gestão de Licenças API, para validar usuários e seus tipos de sessão

### Correções

### Orientações para deploy
:::

