clientflow_backend/STABLE_NAVIGATION_HOTFIX.md

ClientFlow v4928.1.4.3 — Operations navigation hotfix

Correção de navegabilidade descoberta após a publicação da v4928.1.4.2 stable.

Problema

No Centro de trabalho (/operations), o operador abre uma tarefa a partir da lista priorizada, conclui a tarefa e depois só consegue voltar através do botão Back do browser. Ao usar Back, a lista pode vir da cache do browser e ficar desatualizada, mantendo a tarefa concluída visível.

Correção

• Links do Centro de trabalho para /tasks/{id} passam a transportar return_to=/operations?scope=....
• A página de detalhe da tarefa mostra um link explícito: ← Voltar ao Centro de trabalho atualizado.
• Ao concluir ou ignorar uma tarefa aberta a partir do Centro de trabalho, o endpoint devolve HX-Redirect para o return_to, forçando recarregamento fresco da lista.
• O return_to é validado com allowlist interna (/operations, /operacoes, /tasks) para evitar open redirect.

Validação local

python3 -m compileall -q app tests
pytest -q
209 passed

Escopo

Não altera regras de negócio, reconciliação, matching fiscal, documentos, tasks ou integrações. É apenas uma correção de UX/navegação.