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

1.6 KiB

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:

/opportunities/partials/board

A página /opportunities passou a filtrar o quadro por HTMX, com atualização do container:

#opportunities-board

Filtros principais:

Todas
Novas
Orçamento enviado
Pró-forma enviada
Pagamento pendente
Enviadas
Bloqueadas

Tasks

Novo partial:

/tasks/{task_id}/partials/detail

As ações principais do detalhe de task passam a poder atualizar o painel:

#task-detail-panel

Ações com HTMX:

Marcar como feita
Ignorar tarefa
Reclassificar
Preparar pró-forma
Preparar envio
Preparar recolha

Outbox

Novo partial:

/outbox/partials/table

A página /outbox passa a atualizar filtros e ações manuais no container:

#outbox-table

Ações com HTMX:

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

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

PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q