Release v4928.1.4.2 stable

docs/CLIENTFLOW_V4927_ROADMAP_STEP1.md

@@ -0,0 +1,30 @@
+# ClientFlow v4.9.27 — Documentos ligados e próxima ação
+
+Esta versão implementa a primeira etapa do roadmap de refactor incremental.
+
+## Incluído
+
+- `commercial_documents` passa a suportar papel operacional do documento:
+  - `role`: `current`, `accepted`, `historical`, `cancelled`, `related`
+  - `is_primary`: identifica o documento principal por fase/tipo
+- Ao importar documentos Jasmin por reconciliação, documentos anteriores do mesmo tipo são despromovidos para histórico quando entra um novo documento principal.
+- Novo serviço central `app/opportunity_next_action_service.py` para calcular a próxima ação da oportunidade.
+- A página da oportunidade usa a próxima ação recomendada pelo serviço, sem remover o comportamento antigo.
+- Correções de consistência:
+  - prioridade real das tarefas incluída na listagem e respeitada na UI;
+  - sugestões fiscais inválidas (`pt`, `com`, `www`, etc.) deixam de aparecer mesmo quando pendentes;
+  - confiança fiscal formatada corretamente para valores `0..1` e `0..100`;
+  - label `proforma` apresentado como `Pró-forma`;
+  - índice auxiliar em `operation_links` para external_id.
+
+## Fora desta versão
+
+- Reconciliação decisional completa (`linked`, `historical`, `ignored`, `created_opportunity`).
+- Redesign completo da página da oportunidade.
+- Painel operacional baseado integralmente em tasks.
+- Remoção/destruição de índices antigos de `operation_links`.
+
+## Validação
+
+- `python -m pytest -q`
+- Resultado: `203 passed`