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

rrbec_server/ELECTRON_INTEGRATION.md

@@ -0,0 +1,86 @@
+# 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:
+1. Faça login em `/login` enviando `username` e `password`.
+2. O servidor retornará um objeto de usuário. Capture o valor do campo `id` (inteiro).
+3. Envie esse valor no cabeçalho HTTP `X-User-ID` em todas as rotas marcadas como **[PROTEGIDO]**.
+
+---
+
+## 3. Endpoints da API
+
+### [PÚBLICO] Login
+**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**:
+  ```json
+  {
+      "value": 50.00,
+      "type_pay_id": 1,
+      "client_id": null
+  }
+  ```
+- **Efeito**: Registra o pagamento localmente e fecha a comanda.