feat: add user management viewset and sync module to API routes

SYNC_GO_MIDDLEWARE.md

@@ -0,0 +1,54 @@
+# Guia de Sincronização: Django <-> Middleware Go
+
+Este documento descreve o funcionamento do sistema de **ChangeLog** implementado no Django para permitir que o middleware em Go mantenha uma cópia local (local-first) dos dados de forma eficiente.
+
+## 1. Funcionamento Técnico
+
+### Rastreamento de Mudanças (Django Signals)
+Foi criada uma aplicação chamada `sync` que utiliza **Django Signals**. Sempre que um dos modelos abaixo é criado, editado ou excluído, uma entrada é gerada automaticamente na tabela `ChangeLog`:
+
+- `Product`
+- `Comanda`
+- `ProductComanda`
+- `Order`
+- `Client`
+- `Categories`
+- `Mesa`
+- `Payments`
+
+### Tabela de Log (`ChangeLog`)
+Cada registro no log contém:
+- `id`: Identificador sequencial da mudança.
+- `model_name`: Nome do modelo (ex: "Product").
+- `object_id`: ID do objeto que mudou.
+- `action`: "SAVE" (para criação/edição) ou "DELETE".
+- `timestamp`: Quando a mudança ocorreu.
+
+## 2. API de Sincronização
+
+O middleware Go deve consumir o seguinte endpoint:
+
+**Endpoint:** `GET /api/v1/sync/`
+
+### Parâmetros:
+- `since_id` (opcional): Retorna apenas mudanças com ID maior que este valor.
+
+### Exemplo de Fluxo no Go:
+
+1.  **Estado Inicial**: O Go armazena o `last_sync_id` (começando em 0).
+2.  **Polling**: De tempos em tempos (ex: a cada 5 segundos), o Go chama:
+    `GET http://seu-servidor/api/v1/sync/?since_id=100` (supondo que o último ID processado foi 100).
+3.  **Processamento**:
+    - O Django retorna uma lista de mudanças (ex: IDs 101, 102, 103).
+    - Para cada mudança `SAVE` no log, o Go deve fazer um `GET` no endpoint específico do modelo para buscar os dados atualizados:
+      - Se `model_name == "Product"`, buscar em `GET /api/v1/products/{object_id}/`.
+    - Para cada mudança `DELETE`, o Go deve remover o item correspondente do seu banco de dados local.
+4.  **Atualização**: O Go atualiza seu `last_sync_id` para o maior ID recebido (neste caso, 103).
+
+## 3. Vantagens
+- **Performance**: O Go não precisa baixar todos os produtos/pedidos toda vez. Ele só baixa o que realmente mudou.
+- **Detecção de Deleção**: O sistema informa explicitamente o que foi apagado no Django.
+- **Resiliência**: Se a conexão cair, ao reconectar, o Go apenas retoma a partir do último ID que ele conhece, garantindo que nenhuma mudança seja perdida.
+
+---
+*Configurado em: 28 de Março de 2026*