feat: Update observation tracking in PDV and Kitchen

This commit is contained in:
Welton Silva
2026-02-23 18:31:38 -03:00
commit d1319c39ba
18 changed files with 7983 additions and 0 deletions

56
GUIA_POSTMAN_API.md Normal file
View File

@@ -0,0 +1,56 @@
# Guia de Teste da API com Postman
Este documento explica como testar os endpoints da API do sistema **Gestão Raul** utilizando o Postman.
---
## 1. Passo 1: Obter o Token de Acesso (Login)
Como a API é protegida, você precisa primeiro de um token de autorização.
1. Abra o **Postman** e crie uma nova aba de requisição.
2. Mude o método para **POST**.
3. Coloque a URL: `http://localhost:8000/api/v1/token/`
4. Vá na aba **Body**, selecione a opção **raw** e escolha **JSON** no menu à direita.
5. Insira suas credenciais no formato abaixo:
```json
{
"username": "seu_usuario_django",
"password": "sua_senha_django"
}
```
6. Clique em **Send**.
7. No resultado (JSON), copie o código que aparece no campo `"access"`.
---
## 2. Passo 2: Acessar os Endpoints da API
Agora que você tem o token, pode acessar qualquer endpoint protegido (ex: Pedidos).
1. Crie uma nova aba de requisição no Postman.
2. Mude o método para **GET**.
3. Coloque a URL do endpoint que deseja testar, por exemplo:
`http://localhost:8000/api/v1/orders/`
4. Vá na aba **Authorization** (fica logo abaixo da URL).
5. No campo **Type**, selecione **Bearer Token**.
6. No campo **Token** (à direita), cole o código `"access"` que você copiou no Passo 1.
7. Clique em **Send**.
Você deverá ver a lista de dados em formato JSON.
---
## Dicas Rápidas
- **Erro 401 Unauthorized:** Significa que o token não foi enviado corretamente ou expirou. Obtenha um novo no Passo 1.
- **CORS:** O backend está configurado para aceitar requisições de outras origens (CORS), permitindo que seu frontend se conecte normalmente.
- **Endpoints Disponíveis:**
- `/api/v1/orders/` (Pedidos)
- `/api/v1/products/` (Produtos)
- `/api/v1/clients/` (Clientes)
- `/api/v1/mesas/` (Mesas)
- `/api/v1/comandas/` (Comandas)
- `/api/v1/items-comanda/` (Itens de Comanda)
- `/api/v1/categories/` (Categorias)
- `/api/v1/payment-types/` (Tipos de Pagamento)
- `/api/v1/payments/` (Registro de Pagamentos)