ClientFlow v4.5 — Operational Core

Esta versão junta a proposta v4.3 + v4.4 numa atualização única e incremental para o sistema em campo.

Objetivo

Transformar a UI num sistema operacional diário:

Email / Chatwoot / pedido recebido
→ Comunicação classificada
→ Centro de trabalho
→ Cliente / oportunidade
→ Task humana ou Outbox automática
→ Documento / envio
→ Timeline

O que muda

Dashboard

O / passa a ser uma visão geral: métricas, alertas e ligação direta ao Centro de trabalho. Deixa de ser a página principal para execução item a item.

Centro de trabalho

O /operations passa a juntar itens acionáveis:

tasks humanas pendentes;
comunicações por tratar;
outbox pending/failed/blocked;
clientes/produtos/documentos que bloqueiam o fluxo.

Comunicações

Nova área:

/communications
/comunicacoes

Guarda emails/mensagens classificados com ligação opcional a cliente, oportunidade e task.

Estados suportados:

new
classified
needs_review
linked
task_created
done
ignored

Oportunidade

A página da oportunidade passa a incluir navegação por secções:

Resumo
Produtos
Documentos
Tasks
Comunicações
Outbox
Timeline
Técnico

Tasks contextualizadas

A tabela tasks recebe colunas para contexto operacional:

communication_id
document_id
shipment_id
outbox_id
priority
assigned_to

Timeline unificada

Nova tabela timeline_events, integrada na timeline da oportunidade.

Instalação

Fazer backup da base de dados.
Aplicar código v4.5.
Reiniciar serviço.
Confirmar que o startup executou init_db().
Opcional: aplicar manualmente migrations/006_v45_operational_core.sql.
Validar no browser:

/
/operations
/communications
/opportunities/{id}

Notas

Não muda para React/Vue.
Mantém FastAPI + HTML/HTMX.
Não remove rotas antigas.
A automação crítica continua por outbox e deve continuar a exigir validação humana quando aplicável.

2.0 KiB Raw Blame History