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*
|
|
||||||
@@ -14,21 +14,27 @@ Including another URLconf
|
|||||||
1. Import the include() function: from django.urls import include, path
|
1. Import the include() function: from django.urls import include, path
|
||||||
2. Add a URL to urlpatterns: path('blog/', include('blog.urls'))
|
2. Add a URL to urlpatterns: path('blog/', include('blog.urls'))
|
||||||
"""
|
"""
|
||||||
|
|
||||||
from django.contrib import admin
|
from django.contrib import admin
|
||||||
from django.urls import path, include
|
from django.urls import path, include
|
||||||
|
from django.conf import settings
|
||||||
|
from django.conf.urls.static import static
|
||||||
|
|
||||||
urlpatterns = [
|
urlpatterns = [
|
||||||
path('admin/', admin.site.urls),
|
path("admin/", admin.site.urls),
|
||||||
path('', include('home.urls')),
|
path("", include("home.urls")),
|
||||||
path('login/', include('login.urls')),
|
path("login/", include("login.urls")),
|
||||||
path('products/', include('products.urls')),
|
path("products/", include("products.urls")),
|
||||||
path('mesas/', include('mesas.urls')),
|
path("mesas/", include("mesas.urls")),
|
||||||
path('typePay/', include('typePay.urls')),
|
path("typePay/", include("typePay.urls")),
|
||||||
path('clients/', include('clients.urls')),
|
path("clients/", include("clients.urls")),
|
||||||
path('comandas/', include('comandas.urls')),
|
path("comandas/", include("comandas.urls")),
|
||||||
path('categories/', include('categories.urls')),
|
path("categories/", include("categories.urls")),
|
||||||
path('balcao/', include('balcao.urls')),
|
path("balcao/", include("balcao.urls")),
|
||||||
path('pedidos/', include('orders.urls')),
|
path("pedidos/", include("orders.urls")),
|
||||||
path('', include('pwa.urls')),
|
path("", include("pwa.urls")),
|
||||||
path('api/v1/', include('gestaoRaul.api_urls')),
|
path("api/v1/", include("gestaoRaul.api_urls")),
|
||||||
]
|
]
|
||||||
|
|
||||||
|
if settings.DEBUG:
|
||||||
|
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
|
||||||
|
|||||||
@@ -4,11 +4,14 @@ from django.contrib.auth.models import User
|
|||||||
from categories.models import Categories
|
from categories.models import Categories
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
class UnitOfMeasure(models.Model):
|
class UnitOfMeasure(models.Model):
|
||||||
id = models.AutoField(primary_key=True)
|
id = models.AutoField(primary_key=True)
|
||||||
name = models.CharField(max_length=50, unique=True, help_text="Ex: 'Unidade', 'Kg', 'Litro'")
|
name = models.CharField(
|
||||||
abbreviation = models.CharField(max_length=10, unique=True, help_text="Ex: 'un', 'kg', 'L'")
|
max_length=50, unique=True, help_text="Ex: 'Unidade', 'Kg', 'Litro'"
|
||||||
|
)
|
||||||
|
abbreviation = models.CharField(
|
||||||
|
max_length=10, unique=True, help_text="Ex: 'un', 'kg', 'L'"
|
||||||
|
)
|
||||||
|
|
||||||
def __str__(self):
|
def __str__(self):
|
||||||
return self.abbreviation
|
return self.abbreviation
|
||||||
@@ -19,7 +22,7 @@ class Product(models.Model):
|
|||||||
id = models.AutoField(primary_key=True)
|
id = models.AutoField(primary_key=True)
|
||||||
name = models.CharField(max_length=100)
|
name = models.CharField(max_length=100)
|
||||||
description = models.TextField(null=True, blank=True)
|
description = models.TextField(null=True, blank=True)
|
||||||
image = models.ImageField(null=True, blank=True)
|
image = models.ImageField(upload_to="products/%Y/%m/%d/", null=True, blank=True)
|
||||||
price = models.DecimalField(max_digits=10, decimal_places=2)
|
price = models.DecimalField(max_digits=10, decimal_places=2)
|
||||||
quantity = models.IntegerField(null=False, default=0)
|
quantity = models.IntegerField(null=False, default=0)
|
||||||
category = models.ForeignKey(Categories, on_delete=models.CASCADE)
|
category = models.ForeignKey(Categories, on_delete=models.CASCADE)
|
||||||
@@ -27,54 +30,48 @@ class Product(models.Model):
|
|||||||
active = models.BooleanField(default=True)
|
active = models.BooleanField(default=True)
|
||||||
unit_of_measure = models.ForeignKey(
|
unit_of_measure = models.ForeignKey(
|
||||||
UnitOfMeasure,
|
UnitOfMeasure,
|
||||||
on_delete=models.SET_NULL, # Define como NULL se a unidade de medida for excluída
|
on_delete=models.SET_NULL, # Define como NULL se a unidade de medida for excluída
|
||||||
null=True,
|
null=True,
|
||||||
blank=True,
|
blank=True,
|
||||||
help_text="Unidade de medida para este produto."
|
help_text="Unidade de medida para este produto.",
|
||||||
)
|
)
|
||||||
|
|
||||||
# Campo de composição (mantido da resposta anterior)
|
# Campo de composição (mantido da resposta anterior)
|
||||||
components = models.ManyToManyField(
|
components = models.ManyToManyField(
|
||||||
'self',
|
"self",
|
||||||
through='ProductComponent',
|
through="ProductComponent",
|
||||||
through_fields=('composite_product', 'component_product'),
|
through_fields=("composite_product", "component_product"),
|
||||||
symmetrical=False,
|
symmetrical=False,
|
||||||
related_name='is_component_of'
|
related_name="is_component_of",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
def __str__(self) -> str:
|
def __str__(self) -> str:
|
||||||
return f"{self.name}"
|
return f"{self.name}"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
class ProductComponent(models.Model):
|
class ProductComponent(models.Model):
|
||||||
composite_product = models.ForeignKey(
|
composite_product = models.ForeignKey(
|
||||||
Product,
|
Product,
|
||||||
on_delete=models.CASCADE,
|
on_delete=models.CASCADE,
|
||||||
related_name='composition_entries',
|
related_name="composition_entries",
|
||||||
help_text="O produto que é composto por outros produtos."
|
help_text="O produto que é composto por outros produtos.",
|
||||||
)
|
)
|
||||||
component_product = models.ForeignKey(
|
component_product = models.ForeignKey(
|
||||||
Product,
|
Product,
|
||||||
on_delete=models.CASCADE,
|
on_delete=models.CASCADE,
|
||||||
related_name='used_as_component_in',
|
related_name="used_as_component_in",
|
||||||
help_text="Um produto que é componente de outro produto."
|
help_text="Um produto que é componente de outro produto.",
|
||||||
)
|
)
|
||||||
quantity_required = models.PositiveIntegerField(
|
quantity_required = models.PositiveIntegerField(
|
||||||
default=1,
|
default=1,
|
||||||
help_text="Quantidade deste componente necessária para o produto composto."
|
help_text="Quantidade deste componente necessária para o produto composto.",
|
||||||
)
|
)
|
||||||
|
|
||||||
class Meta:
|
class Meta:
|
||||||
unique_together = ('composite_product', 'component_product')
|
unique_together = ("composite_product", "component_product")
|
||||||
|
|
||||||
def __str__(self):
|
def __str__(self):
|
||||||
return (
|
return (
|
||||||
f"{self.composite_product.name} requer "
|
f"{self.composite_product.name} requer "
|
||||||
f"{self.quantity_required} de {self.component_product.name}"
|
f"{self.quantity_required} de {self.component_product.name}"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +0,0 @@
|
|||||||
DISPLAY_NAME=Gestao Raul API
|
|
||||||
DESCRIPTION=Sistema de Gestão para Restaurantes/Bares com API REST.
|
|
||||||
MAIN=gestaoRaul/wsgi.py
|
|
||||||
MEMORY=512
|
|
||||||
VERSION=recommended
|
|
||||||
SUB_DOMAIN=gestao-raul # Escolha um subdomínio disponível
|
|
||||||
START=python manage.py collectstatic --noinput && python -m gunicorn gestaoRaul.wsgi:application --bind 0.0.0.0:80 --timeout 120
|
|
||||||
Reference in New Issue
Block a user