> For the complete documentation index, see [llms.txt](https://traga-ja.gitbook.io/traga-ja/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://traga-ja.gitbook.io/traga-ja/pedidos.md).

# Pedidos

## Pedidos — Guia de Uso

### Visão Geral

A página de **Pedidos** exibe todos os pedidos ativos em tempo real em um quadro com três colunas, organizadas por status. Os pedidos são atualizados automaticamente via WebSocket.

***

### Indicador de Conexão

No topo da página, ao lado do título, um badge colorido indica o status da conexão em tempo real:

| Cor      | Status                                                              |
| -------- | ------------------------------------------------------------------- |
| Verde    | Conectado — atualizações automáticas ativas                         |
| Amarelo  | Reconectando...                                                     |
| Vermelho | Desconectado — use o botão "Atualizar" para sincronizar manualmente |

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FfVsEJU3yLuP7SawNEB1o%2FConectsfo.png?alt=media&amp;token=f6a4b050-0530-4034-9c08-3ed5a6344b6c" alt=""><figcaption></figcaption></figure>

***

### Colunas de Pedidos

| Coluna        | Descrição                                 |
| ------------- | ----------------------------------------- |
| Novos Pedidos | Pedidos recém-recebidos aguardando aceite |
| Em Preparo    | Pedidos aceitos e sendo preparados        |
| Em Entrega    | Pedidos saídos para entrega               |

Cada coluna exibe um contador com o total de pedidos naquele status.

***

### Ações nos Cards de Pedido

Cada card de pedido exibe as informações principais e botões de ação que variam conforme a coluna:

**Novos Pedidos:**

* Avançar para **Em Preparo**
* **Recusar** o pedido — abre modal de confirmação

**Em Preparo:**

* Avançar para **Em Entrega**

**Em Entrega:**

* Marcar como **Finalizado** — abre modal de confirmação

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FyYQGIlrfUXm2KYgWgc5A%2FPEDIDOOOO.png?alt=media&amp;token=c839d97b-983c-47b8-b0f4-7f5ca1601fa0" alt=""><figcaption></figcaption></figure>

Em qualquer coluna é possível clicar no card para ver os **detalhes completos** do pedido (itens, cliente, pagamento, endereço).

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FZVNcb4hUYVraNj1hDPLg%2FPedidoDETALHE.png?alt=media&amp;token=ad475f44-663b-45df-8664-8eb2ce0a564d" alt=""><figcaption></figcaption></figure>

***

### Informações do pedido

O nome do pedido nos cards é o mesmo que aparece para o cliente.

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FcRlRjT7bWDawqYFpHkft%2FInformacoesIguaisPedidos.png?alt=media&amp;token=d9d0374f-f65d-43c4-b504-76f7144114a4" alt=""><figcaption></figcaption></figure>

***

### Botões do Cabeçalho

#### Fechar / Reabrir Loja

O ícone de cadeado no topo fecha ou reabre a loja manualmente, independente do horário de funcionamento configurado.

* Cadeado aberto (cinza) → loja aberta → clique para fechar
* Cadeado fechado (vermelho) → loja fechada → clique para reabrir

> Fechar a loja impede novos pedidos pelo cardápio online.

***

#### Aceitação Automática

O ícone de raio ativa ou desativa a aceitação automática de novos pedidos.

* Cinza → desativado
* Verde → ativado — novos pedidos são movidos automaticamente para **Em Preparo** com intervalo de 1 segundo entre cada um

A preferência é salva no navegador e persiste entre sessões.

***

#### Criar Pedido

O botão **"Criar Pedido"** abre o painel lateral para registrar um pedido manualmente.

> Disponível apenas quando a loja está aberta.

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FyYQGIlrfUXm2KYgWgc5A%2FPEDIDOOOO.png?alt=media&amp;token=c839d97b-983c-47b8-b0f4-7f5ca1601fa0" alt=""><figcaption></figcaption></figure>

***

### Recusar ou Finalizar um Pedido

Ao clicar em **Recusar** (coluna Novos) ou **Finalizar** (coluna Em Entrega), um modal de confirmação é exibido antes de executar a ação. Também é possível recusar um pedido a partir do modal de detalhes, em qualquer status.

Pedidos recusados ou finalizados saem automaticamente do quadro.