mirror of
https://github.com/welton89/RRBEC.git
synced 2026-04-05 13:35:42 +00:00
refactor: clean up product models, remove deployment files, and add media static serving configuration
This commit is contained in:
@@ -1,54 +0,0 @@
|
||||
# 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*
|
||||
Reference in New Issue
Block a user