110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# ClientFlow v3.1 — correções Jasmin/Packlink
|
|
|
|
Esta versão é incremental sobre a v3 e corrige os pontos encontrados nos testes remotos.
|
|
|
|
## Alterações principais
|
|
|
|
### Produtos
|
|
|
|
Agora existe separação entre:
|
|
|
|
- `sku`: código interno/Odoo;
|
|
- `jasmin_sales_item`: artigo de venda no Jasmin.
|
|
|
|
Exemplo:
|
|
|
|
```text
|
|
sku = ODOO-1
|
|
jasmin_sales_item = CARREGADOR_MONO_7KW
|
|
```
|
|
|
|
As tabelas recebem colunas novas de forma aditiva:
|
|
|
|
```sql
|
|
ALTER TABLE products ADD COLUMN IF NOT EXISTS jasmin_sales_item TEXT;
|
|
ALTER TABLE opportunity_items ADD COLUMN IF NOT EXISTS jasmin_sales_item TEXT;
|
|
ALTER TABLE order_items ADD COLUMN IF NOT EXISTS jasmin_sales_item TEXT;
|
|
```
|
|
|
|
Quando uma linha é adicionada à oportunidade a partir do catálogo, `opportunity_items.jasmin_sales_item` é copiado do produto.
|
|
|
|
A criação de orçamento Jasmin usa esta prioridade:
|
|
|
|
```text
|
|
metadata.jasmin_sales_item
|
|
opportunity_items.jasmin_sales_item
|
|
JASMIN_DEFAULT_SALES_ITEM
|
|
sku
|
|
```
|
|
|
|
Assim o SKU Odoo deixa de ser usado como artigo Jasmin, exceto como fallback.
|
|
|
|
### Documentos Jasmin
|
|
|
|
Depois de criar orçamento/fatura, o serviço faz um `GET` ao Jasmin para tentar preencher:
|
|
|
|
- `document_type`
|
|
- `serie`
|
|
- `series_number`
|
|
- `document_number`
|
|
- `total_amount`
|
|
- `currency`
|
|
|
|
Isto melhora a tabela `commercial_documents` e a visualização na oportunidade.
|
|
|
|
### UI da oportunidade
|
|
|
|
- O formulário **Adicionar produto** saiu da área técnica e passou para o cartão **Produtos**.
|
|
- Os botões **Criar orçamento** e **Converter em fatura** mostram mensagem de feedback informando que o pedido foi enviado para a outbox.
|
|
- A tabela de produtos mostra SKU/Odoo e artigo Jasmin separadamente.
|
|
|
|
### Timers systemd
|
|
|
|
Foram adicionados exemplos em `deploy/systemd/`:
|
|
|
|
- `clientflow-outbox-jasmin.service`
|
|
- `clientflow-outbox-jasmin.timer`
|
|
- `clientflow-outbox-packlink.service`
|
|
- `clientflow-outbox-packlink.timer`
|
|
|
|
Instalação Jasmin:
|
|
|
|
```bash
|
|
sudo cp deploy/systemd/clientflow-outbox-jasmin.* /etc/systemd/system/
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now clientflow-outbox-jasmin.timer
|
|
systemctl list-timers | grep clientflow
|
|
```
|
|
|
|
O timer Jasmin processa outbox a cada 1 minuto.
|
|
|
|
## Verificações após deploy
|
|
|
|
```bash
|
|
cd /mnt/ssd/home/plx/clientflow_backend
|
|
source .venv/bin/activate
|
|
python -m py_compile app/*.py scripts/*.py
|
|
python -m pytest -q
|
|
sudo systemctl restart clientflow-api
|
|
sudo systemctl status clientflow-api --no-pager
|
|
```
|
|
|
|
## Migração prática de produtos existentes
|
|
|
|
Depois do deploy, ir a `/products/{id}` e preencher **Artigo Jasmin** para cada produto usado em documentos.
|
|
|
|
Para corrigir via SQL/Python um produto específico:
|
|
|
|
```bash
|
|
python - <<'PY'
|
|
from sqlalchemy import text
|
|
from app.db import engine
|
|
with engine.begin() as conn:
|
|
conn.execute(text("""
|
|
UPDATE products
|
|
SET jasmin_sales_item = 'CARREGADOR_MONO_7KW', updated_at = now()
|
|
WHERE sku = 'ODOO-1'
|
|
"""))
|
|
PY
|
|
```
|