Files
clientflow_backend/docs/CLIENTFLOW_V474_HTMX_COMPLETION.md
2026-06-09 22:55:58 +01:00

102 lines
1.6 KiB
Markdown

# ClientFlow v4.7.4 — HTMX Completion & Operator UX
## Objetivo
Completar a experiência HTMX nas áreas operacionais, sem alterar regras de negócio, schema de base de dados, Chatwoot auto-complete, associação de oportunidades ou worker da outbox.
## O que mudou
### Oportunidades
Novo partial:
```text
/opportunities/partials/board
```
A página `/opportunities` passou a filtrar o quadro por HTMX, com atualização do container:
```text
#opportunities-board
```
Filtros principais:
```text
Todas
Novas
Orçamento enviado
Pró-forma enviada
Pagamento pendente
Enviadas
Bloqueadas
```
### Tasks
Novo partial:
```text
/tasks/{task_id}/partials/detail
```
As ações principais do detalhe de task passam a poder atualizar o painel:
```text
#task-detail-panel
```
Ações com HTMX:
```text
Marcar como feita
Ignorar tarefa
Reclassificar
Preparar pró-forma
Preparar envio
Preparar recolha
```
### Outbox
Novo partial:
```text
/outbox/partials/table
```
A página `/outbox` passa a atualizar filtros e ações manuais no container:
```text
#outbox-table
```
Ações com HTMX:
```text
Reprocessar
Ignorar
```
## Compatibilidade
As rotas antigas continuam disponíveis. Sem HTMX, os forms continuam com `method="post"` e `action`, mantendo fallback por redirect.
## Não muda
```text
Não requer migração de base de dados.
Não altera regras Chatwoot.
Não altera auto-complete.
Não altera associação oportunidade/cliente.
Não altera outbox worker.
Não altera integrações Jasmin/Packlink/Odoo/Mautic.
```
## Validação
```bash
PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q
```