# 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`