# Categoria

### Aba: Categorias

#### Como funciona

As categorias são exibidas como cards expansíveis. Ao clicar em uma categoria, ela se expande e mostra seus itens. Quando há uma pesquisa ativa, todas as categorias se expandem automaticamente e apenas as que contenham correspondência (nome da categoria ou nome/descrição de algum item) são exibidas.

***

#### Criar Categoria

{% stepper %}
{% step %}

### **Clique em "Nova Categoria"**

<figure><img src="/files/rwRT0wQefLeDIDWxbAbO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Preencha os campos no painel lateral e c**lique em "Criar Categoria"**&#x20;

<mark style="background-color:yellow;">**Importante: clientes conseguem ver apenas itens com status ‘Disponível’; os ‘Indisponíveis’ não aparecem.**</mark>

<figure><img src="/files/MwZnpTSJFuquCGnRcxUM" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### &#x20;**A Categoria nova aparecerá na tabela**

<figure><img src="/files/BQ7dNnEKu55Va3Na1e1V" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

**Campos da Categoria:**

| Campo           | Obrigatório | Descrição                                                                       |
| --------------- | ----------- | ------------------------------------------------------------------------------- |
| Nome            | Sim         | Nome da categoria (máx. 50 caracteres). Ex: `Lanches`, `Bebidas`                |
| Disponibilidade | Sim         | **Disponível** — aparece no cardápio. **Indisponível** — oculta temporariamente |

***

#### Editar, Clonar e Excluir Categoria

Cada categoria possui um menu de ações no card:

| Ação    | Descrição                                                                                          |
| ------- | -------------------------------------------------------------------------------------------------- |
| Editar  | Abre o painel lateral com os dados atuais para alteração                                           |
| Clonar  | Duplica a categoria com todos os seus dados e com a (Cópia) na frente do nome — requer confirmação |
| Excluir | Remove a categoria permanentemente — requer confirmação                                            |

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

#### Editar Categoria

{% stepper %}
{% step %}

### Clique no botão "Editar" que aparecer como  <i class="fa-pencil">:pencil:</i>

<figure><img src="/files/bPLJoupWVh4c0Nqc4Beh" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Em seguida preencha as informações desejadas&#x20;

<mark style="background-color:yellow;">**Importante: clientes conseguem ver apenas itens com status ‘Disponível’; os ‘Indisponíveis’ não aparecem.**</mark>

<figure><img src="/files/OxvEVRJHzUPQOHtEDNJE" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aparecerá uma mensagem no topo da tela e o item estará com as novas alterações

<figure><img src="/files/B8Buaa8YTNHNGwZuh9Dg" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Clonar Categoria

{% stepper %}
{% step %}

### Clique no botão "Clonar" que aparecer como <i class="fa-file">:file:</i>

{% endstep %}

{% step %}

### Em seguida clique no botão "Clonar" do card&#x20;

<figure><img src="/files/g8RqTxZxFLDtQSB1lULF" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### A categoria clonada aparecerá no topo da lista com "(Cópia)" na frente&#x20;

<figure><img src="/files/9nLNGv3sfz1W4R1AIghl" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Excluir Categoria

{% stepper %}
{% step %}

### Clique no botão "Excluir" que aparecer como <i class="fa-trash">:trash:</i>

{% endstep %}

{% step %}

### Em seguida clique no botão "Excluir" do card&#x20;

<figure><img src="/files/8BhY9eeMr3bctfQ5ngy5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aparecerá uma mensagem no topo da tela e Categoria não estará mais na lista

<figure><img src="/files/M6PEWcExezGDMzY5d7li" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

#### Reordenar Categorias

O botão **"Ordenar Categorias"** (visível quando há mais de uma categoria) abre um modal com **drag-and-drop** para definir a ordem de exibição no cardápio online. Após definir a ordem clique em "Salvar Ordem" para salvar a nova ordem das Categorias da tabela.

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

***

### Itens de uma Categoria

Os itens ficam dentro de cada categoria. Para vê-los, expanda a categoria clicando nela.

***

#### Criar Item

{% stepper %}
{% step %}

### Expanda a categoria desejada

Se for a primeira vez o botão será **"Adicionar Primeiro Item"**&#x20;

<figure><img src="/files/FA5YzLciFEd1KjnkGNJR" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Clique em "Adicionar Item"**&#x20;

<figure><img src="/files/qu8leo6dHaifrtssyJQr" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Preencha o formulário no painel lateral e clique em **"Criar"**

<figure><img src="/files/BZzqCdr2IvF3rXlsgjmW" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

**Campos do Item:**

| Campo                  | Obrigatório | Descrição                                                                       |
| ---------------------- | ----------- | ------------------------------------------------------------------------------- |
| Nome                   | Sim         | Nome do item exibido no cardápio                                                |
| Descrição              | Não         | Texto descritivo exibido ao cliente                                             |
| Preço                  | Sim         | Valor do item em R$                                                             |
| Tipo                   | Sim         | **Comida** ou **Bebida**                                                        |
| Foto                   | Não         | Imagem do produto (PNG, JPG ou GIF)                                             |
| Restrições alimentares | Não         | Uma ou mais: Vegetariano, Vegano, Orgânico, Sem Glúten, Sem Açúcar, Sem Lactose |
| Grupos de Adicionais   | Não         | Vincula grupos de adicionais já cadastrados a este item                         |
| Item ativo             | —           | Controla se o item aparece no cardápio                                          |

> Os grupos de adicionais precisam ser criados previamente na aba **Grupos de Adicionais** antes de serem vinculados a um item.

***

#### Editar, Clonar e Excluir Item

Cada item possui ações disponíveis no seu card:

| Ação    | Descrição                                                     |
| ------- | ------------------------------------------------------------- |
| Editar  | Abre o painel lateral com os dados atuais                     |
| Clonar  | Duplica o item dentro da mesma categoria — requer confirmação |
| Excluir | Remove o item permanentemente — requer confirmação            |

#### Editar Item

{% stepper %}
{% step %}

### Clique no botão "Editar" que aparecer como <i class="fa-pencil">:pencil:</i>

<figure><img src="/files/rRtO4jZ5oH0RpgWCbdPN" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Em seguida edite as informações desejadas e clique em "Salvar Alterações"

<figure><img src="/files/IayRcbtcxbYfFUa3I5dd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aparecerá uma mensagem no topo da tela e o item estará com as novas alterações

<figure><img src="/files/Anhu9nCHgo9VOoSnm1I7" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Clonar Item

{% stepper %}
{% step %}

### Clique no botão "Clonar" que aparecer como <i class="fa-file">:file:</i>

### Em seguida clique no botão "Clonar" do card&#x20;

<figure><img src="/files/YiotzURaDwFTnsFwJski" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aparecerá uma mensagem no topo da tela e o item novo aparecerá na categoria

<figure><img src="/files/OxgtDahQEcPV4Igx74vN" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Excluir Item

{% stepper %}
{% step %}

### Clique no botão "Excluir" que aparecer como <i class="fa-trash">:trash:</i>

### Em seguida clique no botão "Excluir" do card&#x20;

<figure><img src="/files/K7G2hQtZECCdYqYMGcum" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aparecerá uma mensagem no topo da tela e o Item não estará mais na lista

<figure><img src="/files/s8yKecN16jDWPhALve9Y" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

#### Reordenar Itens

O botão **"Ordenar"** (visível quando há mais de um item na categoria expandida) abre um modal com **drag-and-drop** para definir a ordem dos itens dentro daquela categoria.


---

# 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://traga-ja.gitbook.io/traga-ja/cardapio/categoria.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.