# plugin-orders

`@fayz-ai/plugin-orders` · beta · Capability parcial

Orders are the heartbeat of an operations business. plugin-orders gives a restaurant — or any food vertical — a real-time order board: dine-in, takeout, and delivery flowing across a kanban, with history behind it. It's the surface the floor staff actually live in.

## Visão geral

Comandas para operação de restaurante: um kanban de pedidos por status, com origens dine-in, takeout e delivery. Monta a página `/orders`. É um plugin **vertical** (`scope: 'vertical'`) e declara dependência do `plugin-menu` para o catálogo de itens.

Não empacota migrations. Por padrão roda com um provider mock (em memória) e, para persistir na plataforma Fayz, usa `createFayzOrdersProvider` com nomes de tabela configuráveis (`ordersTable`, `orderItemsTable`). Os lookups de item de menu e de staff são injetados pelo app. O canal `stable` já pina `^0.3.0`.

Para IA, expõe `getOrdersSummary`, `getActiveOrders` e `createOrder`. Status **beta / capability parcial**.

## Quando usar

- Operação de restaurante que precisa acompanhar comandas em tempo real.
- Separar pedidos por dine-in, takeout e delivery num kanban.
- Combinar com o plugin-menu (dependência declarada) para os itens.

## Ficha técnica

- **Pacote:** `@fayz-ai/plugin-orders`
- **Versão:** 0.3.0
- **Status:** beta
- **Capability:** Capability parcial
- **Tipo de produto:** Restaurante / food
- **Canal stable:** `^0.3.0`
- **Migrations:** nenhuma
- **Factory:** `createOrdersPlugin()`

## Modelo de dados

Sem tabelas próprias — usa a biblioteca core / archetype (mesma regra: `tenant_id` + RLS).

## Tools de IA

| id | modo | descrição |
| --- | --- | --- |
| `orders.today-summary` | read | Returns order count, revenue, and average ticket for today or a given period. |
| `orders.active-orders` | read | Lists currently active (non-completed) orders. |
| `orders.create-order` | persist | Creates a new restaurant order with items. |

## Integrações

Sem conector hospedado — provedores externos via spine de conectores (`@fayz-ai/core`).

## Integrar

Adicione o plugin em `surfaces.admin.plugins` do `app.manifest.json` e rode o doctor:

```json
{ "surfaces": { "admin": { "plugins": [ { "id": "orders", "enabled": true } ] } } }
```

```bash
npx fayz doctor
```