# Ambiente

## Visão Geral

Nesta função é possível realizar o cadastro e a manutenção dos ambientes físicos da empresa. 

O cadastro de Ambiente permite identificar as plantas e os Codins vinculados a cada local, além de definir limites mínimos e máximos de lotação de pessoas e estabelecer a hierarquia de ambientes através da indicação de um ambiente superior.

#### Onde encontro esta tela?

Seja pelo menu superior ou lateral, o caminho é: Estrutura ➜ Empresa ➜ Ambiente.

* **Na Versão 3.1 (Nova):** Clique no ícone de menu à esquerda para expandir.

{% hint style="info" icon="lightbulb-on" %}
**Dica Ágil:** Pressione a lupa no topo e digite "Ambiente" para ir direto, sem cliques extras. *v3.1.0*
{% endhint %}

## Regras de Negócio

* **Pré-requisito:** É necessário que a Planta e os Codins já estejam previamente cadastrados no sistema para que o vínculo seja realizado.
* **Obrigatoriedade:** Os campos Ambiente, Planta e Código do Ambiente Superior são de preenchimento mandatório.
* **Hierarquia:** Caso não exista um ambiente superior, o campo Código do Ambiente Superior deve ser preenchido obrigatoriamente com o valor 0.
* **Identificação:** O código de ordenação da tabela é gerado automaticamente pelo sistema após a inclusão.

## Como consultar um Ambiente

Ao acessar o menu, a tela de Consulta permite gerenciar os ambientes já cadastrados através dos seguintes comandos:

<figure><img src="/files/WN5Sw7Lsw3Vn3f7rFduH" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
**+ Novo:** Cadastre um Ambiente para sua empresa, clicando neste botão.
{% endstep %}

{% step %}
**Pesquisar:** Pesquise usando filtros um Ambiente já cadastrado.
{% endstep %}

{% step %}
**Ferramentas da Tabela:** Você pode ordenar colunas (A-Z) ou exportar a lista em formatos como PDF, Excel ou CSV.
{% endstep %}

{% step %}
**Busca Rápida:** Localize Ambientes pelo nome ou código.
{% endstep %}

{% step %}
**Editar cadastro:** Edite o cadastro de um Ambiente, clicando no botão de edição.
{% endstep %}
{% endstepper %}

## Como Cadastrar um Ambiente

1. Na tela de Consulta, clique no botão **+ Novo**.
2. No campo **Ambiente**, informe o nome da área física.
3. Selecione a **Planta** correspondente ao ambiente.
4. Informe o **Código do Ambiente Superior**. (*Se não houver, preencha com 0*).
5. No campo **Codins,** utilize as setas para selecionar e associar os dispositivos ao ambiente.
6. Se necessário, defina a Quantidade mínima de pessoas e a Quantidade máxima de pessoas permitidas no local.
7. Clique em **+ Incluir**.&#x20;
8. Uma mensagem de confirmação indicará o sucesso da operação e o sistema gerará o código de ordenação.

<figure><img src="/files/9zOSBXbLlo1HjSO6lwhH" alt=""><figcaption></figcaption></figure>

### Guia de Edição Rápida

Caso precise ajustar um ambiente existente:

1. Na tela de **Consulta**, localize o ambiente desejado.
2. Clique no ícone de **Edição** (Lápis) à esquerda do código.
3. Altere as informações necessárias (o código gerado automaticamente estará bloqueado para edição).
4. Clique em **Salvar** para registrar as mudanças.

<figure><img src="/files/CoXGqOw658LJdVktywig" alt=""><figcaption><p><em>Edição de Ambiente</em></p></figcaption></figure>

## FAQ - Perguntas Frequentes

<details>

<summary>Quando devo cadastrar um Ambiente no sistema?</summary>

O ambiente deve ser cadastrado sempre que for necessário identificar e organizar os espaços físicos da empresa, vinculando plantas, Codins e definindo regras como hierarquia de ambientes e limite de pessoas.

</details>

<details>

<summary>Por que não consigo cadastrar um ambiente novo?</summary>

Isso acontece quando a planta ou os Codins ainda não estão cadastrados no sistema. Esses itens são pré-requisitos obrigatórios para realizar o cadastro de um ambiente.

</details>

<details>

<summary>Quais campos são obrigatórios no cadastro de Ambiente?</summary>

Os campos Ambiente, Planta e Código do Ambiente Superior são obrigatórios. Os demais campos podem ser preenchidos conforme a necessidade de controle da empresa.

</details>

<details>

<summary>O que devo informar no campo Código do Ambiente Superior se o ambiente não tiver hierarquia?</summary>

Nesse caso, o campo deve ser preenchido com o valor 0, indicando que o ambiente não possui um ambiente superior vinculado.

</details>

<details>

<summary>Posso alterar o código do ambiente depois de cadastrado?</summary>

Não. O código do ambiente é gerado automaticamente pelo sistema e não pode ser alterado. Todos os outros campos permanecem disponíveis para edição.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/manual-de-operacao/manual-do-suricato/estrutura-e-equipamentos/estrutura/empresa/ambiente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.