# ClientFlow v4928.1.5.127 — redução de ruído em `CONFIRM_DELIVERY`

## Objetivo

Evitar que o fluxo de follow-up crie uma confirmação de receção para cada comunicação. `CONFIRM_DELIVERY` passa a ser uma exceção manual escolhida pelo operador quando vários contactos sem resposta sugerem um problema real de envio.

## Alterações

- `CONFIRM_DELIVERY_AUTOMATION_ENABLED=false` por defeito.
- As cadências automáticas começam diretamente no follow-up adequado:
  - informação: `FOLLOW_UP_CUSTOMER_REVIEW` após 2 dias úteis;
  - orçamento: `FOLLOW_UP_QUOTE` após 2 dias úteis;
  - pagamento: `FOLLOW_UP_PAYMENT` após 2 dias úteis.
- A página da oportunidade mantém **Verificar entrega (manual)**.
- A verificação manual não inicia uma nova cascata automática.
- O backfill:
  - não cria `CONFIRM_DELIVERY`;
  - exclui oportunidades de valor zero por defeito;
  - ignora oportunidades que já tenham qualquer tarefa humana pendente;
  - aplica `LIMIT` depois dos filtros de elegibilidade.
- Novo script `scripts/disable_automatic_confirm_delivery.py`:
  - dry-run por defeito;
  - ignora apenas confirmações automáticas pendentes;
  - preserva verificações de entrega criadas manualmente.

## Atualização recomendada

```bash
cd /mnt/ssd/home/plx/clientflow_backend
source .venv/bin/activate

sudo systemctl stop clientflow-api.service

cp -a /mnt/ssd/home/plx/clientflow_backend \
  /mnt/ssd/backups/clientflow/clientflow_backend_pre_v4928_1_5_127_$(date +%Y%m%d_%H%M%S)

unzip -o /caminho/clientflow_backend_v4928_1_5_127.zip \
  -d /mnt/ssd/home/plx/clientflow_backend
```

Garantir na configuração:

```env
CONFIRM_DELIVERY_AUTOMATION_ENABLED=false
```

Validar e retirar as confirmações automáticas antigas:

```bash
python scripts/disable_automatic_confirm_delivery.py
python scripts/disable_automatic_confirm_delivery.py --apply
```

O backfill v127 é opcional. Rever antes de aplicar:

```bash
python scripts/sync_opportunity_followup_lifecycle.py --limit 50
```

Não é necessário executar `--apply` imediatamente. O fluxo normal passará a criar os novos follow-ups à medida que as ações comerciais forem concluídas.

Finalizar:

```bash
python -m py_compile \
  app/followup_service.py \
  app/config.py \
  scripts/sync_opportunity_followup_lifecycle.py \
  scripts/disable_automatic_confirm_delivery.py

sudo systemctl start clientflow-api.service
sudo systemctl status clientflow-api.service --no-pager
```

## Validação

Suite completa executada: **502 testes aprovados**.
