Files

Welton Moura 936aad779b feat: RRBEC Local Server - Go backend with Django sync

- Implement local-first architecture with SQLite
- Add bidirectional sync with Django via ChangeLog
- JWT authentication with auto-refresh token
- REST API for products, orders, commands, payments
- Stock management with automatic deduction

2026-04-04 17:38:40 -03:00

2.6 KiB

Raw Permalink Blame History

RRBEC Middleware - Guia de Integração (Electron/Desktop)

Este guia documenta como a aplicação Electron deve se comunicar com o servidor middleware local em Go.

1. Configurações Base

URL Base: http://localhost:8080/api/v1
Porta Default: 8080 (configurável no arquivo .env do servidor).
Formato: Todas as requisições e respostas utilizam application/json.

2. Autenticação (SimpleAuth)

O servidor não utiliza tokens JWT complexos localmente. A autenticação funciona assim:

Faça login em /login enviando username e password.
O servidor retornará um objeto de usuário. Capture o valor do campo id (inteiro).
Envie esse valor no cabeçalho HTTP X-User-ID em todas as rotas marcadas como [PROTEGIDO].

3. Endpoints da API

POST /login

Body: { "username": "seu_usuario", "password": "sua_senha" }
Retorno: Objeto User completo.

[PÚBLICO] Listar Mesas

GET /mesas

Retorno: Array de objetos mesas com id, uuid, name, active.

[PÚBLICO] Listar Produtos/Estoque

GET /products

Retorno: Array de produtos com preços e quantidade em estoque.

[PÚBLICO] Listar Categorias

GET /categories

[PÚBLICO] Listar Clientes

GET /clients

[PÚBLICO] Listar Pedidos (Cozinha/Orders)

GET /orders

[PÚBLICO] Listar Tipos de Pagamento

GET /payment-types

[PÚBLICO] Listar Pagamentos Realizados

GET /payments

[PÚBLICO] Ver Comanda por ID

GET /comandas/:id (Ex: /api/v1/comandas/9)

Retorno: Detalhes da comanda.

4. Comandas e Itens (Ações)

[PROTEGIDO] Abrir Nova Comanda

POST /comandas

Headers: X-User-ID: <id_do_usuario>
Body: { "mesa_id": 1, "client_id": null }

[PROTEGIDO] Lançar Pedido (Adicionar Item)

POST /items-comanda

Headers: X-User-ID: <id_do_usuario>
Body: { "comanda_id": 9, "product_id": 50, "applicant": "Nome do Garçom" }

[PROTEGIDO] Deletar Item Individual

DELETE /items-comanda/:id

Headers: X-User-ID: <id_do_usuario>

[PROTEGIDO] Limpar e Fechar Comanda (Apagar Inteira)

POST /comandas/:id/apagar

Headers: X-User-ID: <id_do_usuario>
Efeito: Remove todos os itens da comanda e muda o status para CLOSED.

[PROTEGIDO] Pagar e Fechar Comanda

POST /comandas/:id/pagar

Headers: X-User-ID: <id_do_usuario>

Body:

{
    "value": 50.00,
    "type_pay_id": 1,
    "client_id": null
}

Efeito: Registra o pagamento localmente e fecha a comanda.

2.6 KiB Raw Permalink Blame History