Release v4928.1.4.2 stable

docs/CLIENTFLOW_V474_HTMX_COMPLETION.md

@@ -0,0 +1,101 @@
+# 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
+```