<!-- GERADO AUTOMATICAMENTE por paginas/montar.py.
     NAO EDITE ESTE ARQUIVO: edite paginas/_fonte/ e rode montar.py.
     O bloco comum vem de _fonte/comum-listas.md -- fonte unica, para que os
     artigos das varias telas nao possam divergir entre si. -->

# A tela de Usuários: acesso, níveis e quais empresas cada um vê

> **Aplica-se a:** GaxWeb 5.0.0 (alpha) — update 27.08.2026

**Administração › Usuários** é onde se cria quem entra no GaxWeb e se define **o
que cada pessoa enxerga e pode fazer**.

É a tela que mais gera chamado depois da virada para a 5.0 — porque o acesso às
empresas mudou de lógica. Comece pela seção *Quais empresas o usuário enxerga*.

## As colunas

| Coluna | O que mostra |
|---|---|
| **Status** | Situação do usuário. |
| **Online** | 🟢 Se a pessoa está no sistema agora. |
| **Etiquetas** | Marcadores aplicados ao usuário. |
| **ID** | Número interno. |
| **Nível** | Administrador geral · Administrador perfil · Usuário padrão. |
| **Nome/Usuário** | Nome e e-mail de acesso. |
| **Atividade** | Data e hora da última atividade. |
| **GeoIP** | 🌎 **De onde a pessoa acessou** — IP e cidade. |
| **Criação** | Quando o usuário foi criado. |
| **Perfil** | A qual perfil pertence. |
| **Grupo de empresas** | O grupo vinculado, se houver. |
| **Grupo de permissões** | O grupo de permissões vinculado. |

**Filtro no cabeçalho** para ID e Nome/Usuário.

> 🌎 **A coluna GeoIP é de segurança.** Acesso de cidade inesperada merece
> atenção. Combine com o filtro **Online**: *Online (< 5 min)* · *Ausente (5-30
> min)* · *Offline (> 30 min)*.

## Os três níveis

| Nível | Enxerga |
|---|---|
| **Administrador geral** | Tudo. |
| **Administrador perfil** | As empresas do perfil dele. |
| **Usuário padrão** | **Só as empresas vinculadas a ele.** |

## Quais empresas o usuário enxerga

**No 5.0 o acesso é concedido, não presumido.** Na 4.6 as empresas apareciam de
forma mais aberta; agora, para o **Usuário padrão**, vale a regra da lista.

Abra o usuário (botão direito → **Editar**) e vá à aba **Empresas**. Ela mostra um
contador com **duas origens**:

> **Grupo: 0 | Local: 0**

| Origem | O que é |
|---|---|
| **Grupo** | Empresas que chegam pelo **Grupo de empresas** vinculado. |
| **Local** | Empresas vinculadas **uma a uma**, ali no usuário. |

**O usuário padrão vê a soma das duas.** Se ambas estão em zero, ele **não vê
nenhuma empresa** — e é essa a causa de *"meu usuário entrou e não aparece
nada"*.

Para liberar: use **Selecionar** naquela aba (uma a uma) ou vincule um **Grupo de
empresas** em *Segurança › Grupos de Empresas*.

> ⛔ **Não existe opção de "ver todas as empresas"** no cadastro do usuário.
> Para carteiras grandes, o caminho é o **Grupo de empresas** — muda em um lugar
> só e vale para todos os usuários daquele grupo.

## As quatro abas do cadastro

| Aba | O que tem |
|---|---|
| **Geral** | Perfil, e-mail, nome, senha, Situação, Nível, Grupo de empresas e Grupo de permissões. |
| **Permissões** | O que a pessoa pode fazer, item a item. |
| **Empresas** | A lista de inclusão descrita acima. |
| **Administrador** | Ajustes de sessão e segurança — veja abaixo. |

## A aba Administrador

Guarda ajustes pouco conhecidos que explicam vários chamados:

| Ajuste | Para que serve |
|---|---|
| **Limite de registros no Excel** | 📊 Teto de linhas na exportação para Excel **desse usuário**. Se a exportação vem cortada, é aqui. |
| **Permitir alternar entre versões** | 🔀 **É o que controla o botão 4.6 / 5.0.** Sem isso, a pessoa não consegue voltar à versão anterior. |
| **Permitir acesso à versão beta** | Libera versões em teste. |
| **Não permite o uso de diferentes sessões por um mesmo usuário** | Impede a mesma conta em dois lugares ao mesmo tempo. |
| **Não permite diferentes IPs numa mesma sessão** | Derruba a sessão se o IP mudar. |
| **Finalizar sessão após 15 minutos de inatividade** | Logout automático. |
| **Validar 2FA no próximo login** | Exige o segundo fator no próximo acesso. |
| **Alterar senha no próximo login** | Obriga a troca de senha. |
| **Derrubar sessão do usuário** | Encerra a sessão ativa na hora. |
| **E-mail de boas-vindas** | Dispara o e-mail de boas-vindas. |

> 🔀 **"Sumiu o botão para voltar ao 4.6".** É o **Permitir alternar entre
> versões**, aqui. Não é a versão que removeu o botão — é permissão do usuário.
>
> 👥 **Conta compartilhada entre várias pessoas** costuma esbarrar em *Não permite
> o uso de diferentes sessões*. A solução certa é criar um usuário por pessoa: sai
> mais barato que perder o histórico de quem fez o quê.

## A tela por partes

As telas de Administração seguem o mesmo desenho das listas de documentos, com um
ícone a mais.

## Os ícones do canto superior direito

| Ícone | O que faz |
|---|---|
| 📗 **Exportar resultado para Excel** | Baixa em Excel o que está na tela, com os filtros aplicados. |
| 🔄 **Recarregar toda a tabela** | Busca os dados de novo no servidor. |
| ☷ **Exibir/Ocultar colunas** | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". |
| 🧹 **Vacuum (compactar tabela)** | Compacta a tabela no banco. *Só existe nas telas de Administração.* |
| ☰ **Mais filtros** | Abre e fecha o painel **Outros filtros**, à direita. |

> 🧹 **Tela bagunçada?** Há também **Reiniciar storage local**. O GaxWeb guarda no
> seu navegador a largura e a ordem das colunas; se a tela ficou torta ou uma
> coluna sumiu e não volta, esse botão devolve o padrão. Mexe só no seu navegador,
> não altera dado nenhum.

## Reload, Registros e páginas

No topo: **Reload** (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e
**Registros** (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As
páginas ficam no rodapé.

> ⚠️ **A seleção por caixinha vale só na página aberta.** Marcou itens e virou a
> página? A marcação anterior se perde. Aumente **Registros** antes de marcar.

## A lista rola para o lado

As colunas passam da largura da tela. **Role para a direita** antes de concluir
que uma informação não existe — ou esconda as colunas que não usa.

## Como filtrar

**1. Filtro por coluna** — a caixinha abaixo do título. Nem toda coluna tem.
**2. Painel "Outros filtros"** — à direita, pelo ícone ☰.
**3. Ordenação** — clique no título da coluna.

Os três se somam.

> 🔍 **"Sumiu da lista".** O painel já vem com **Situação = 1:Ativo**: registros
> inativos ficam ocultos por padrão. Clique no **X** ao lado do campo Situação
> para ver todos. É a causa nº 1 de "meu cadastro desapareceu".

### O painel tem duas seções

Repare que **Situação** aparece duas vezes: uma na seção do **Perfil** e outra na
do registro que você está vendo. São filtros diferentes — o primeiro restringe
pelo perfil, o segundo pelo próprio cadastro.

## Abrir, editar e o histórico

**Botão direito sobre a linha:**

| Ação | O que faz |
|---|---|
| **Editar** | Abre o cadastro. |
| **Alterações** | 🕓 **Mostra quem mudou o quê, e quando.** Existe em toda a Administração e só aparece aqui. |
| **Recarregar item** | Atualiza só aquela linha. |

> ⏱️ **"Quem alterou isso?"** — use **Alterações**. É o histórico do registro, e
> resolve discussão sem precisar abrir chamado.

> 🖱️ **Duplo clique não faz nada.** Para abrir, use o botão direito → Editar.

## Ao salvar, a janela não fecha

Ela passa a se chamar **"Editando &lt;nome&gt; (ID nn)"** e continua aberta. **Se
apareceu o ID no título, gravou.** Pode fechar.

## Perguntas frequentes

**"Criei o usuário e ele não vê nenhuma empresa."**
Aba **Empresas** do usuário: Grupo e Local em zero. Vincule as empresas ou um
grupo.

**"A exportação para Excel veio cortada."**
Aba **Administrador** → *Limite de registros no Excel*. Diferente do seletor
**Registros**, que muda só o que aparece na tela.

**"O usuário sumiu da lista."**
O filtro **Situação = 1:Ativo** esconde os inativos. Limpe pelo **X**.

**"Preciso saber quem alterou este usuário."**
Botão direito → **Alterações**.