fix: telefone de contato sem DDI e updates/excludes que fingiam sucesso

- app/routers/contatos.py: CLIENTE_CONTATO.TELEFONE passa a ser gravado
  sempre com DDI 55 (normalizar_telefone_com_ddi, mesma normalização já
  usada em CLIENTE.TELEFONE/CELULAR) — confirmado no node '10 - Validar
  Telefones' do workflow n8n de produção (ER6Piy9yu93uOVuY) que o
  telefone é usado exatamente como está gravado, sem nenhuma
  normalização própria. Um contato cadastrado pelo painel sem o
  funcionário digitar '55' na frente nunca recebia a chave automática
  por WhatsApp — falha silenciosa, sem nenhum erro visível.

- app/db/clientes.py, app/db/contatos.py, app/db/funcionarios.py:
  excluir_cliente/atualizar_contato/excluir_contato/redefinir_senha
  passam a retornar bool (cur.rowcount > 0) em vez de None — um
  ID inexistente não gera erro nenhum do MySQL (WHERE só não bate com
  nada), então sem checar rowcount o router não tinha como saber que
  não alterou/excluiu nada.

- app/routers/clientes.py, app/routers/contatos.py,
  app/routers/funcionarios.py: editar/excluir/redefinir-senha/
  alternar-ativo passam a checar essa existência e mostrar 'não
  encontrado' em vez de registrar 'sucesso' no log e redirecionar pra
  uma tela que também vai dizer que não encontrou nada.

- app/templates/clientes_lista.html: busca não estava com urlencode nos
  links de paginação/ordenação — um termo de busca com '&' (comum em
  razão social, ex. 'Fulano & Cia') cortava o resto da query string do
  link, perdendo página/ordenação.

Suíte completa (192 testes) passando, com 13 testes novos cobrindo os
casos de 'não encontrado' e o DDI do telefone de contato.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app/db/clientes.py

@@ -155,7 +155,11 @@ def atualizar_cliente(cliente_id: int, dados: dict) -> None:
         conn.close()
 
 
-def excluir_cliente(cliente_id: int) -> None:
+def excluir_cliente(cliente_id: int) -> bool:
+    """True se a linha realmente existia (cur.rowcount > 0) — um ID
+    inexistente não gera erro nenhum do MySQL, então sem checar rowcount
+    o chamador não tem como distinguir "excluiu" de "não tinha nada pra
+    excluir"."""
     conn = get_connection()
     try:
         with conn.cursor() as cur:
@@ -165,5 +169,6 @@ def excluir_cliente(cliente_id: int) -> None:
                 raise ClienteComDependenciasError(
                     "Este cliente tem contatos cadastrados (CLIENTE_CONTATO) — remova-os antes de excluir."
                 ) from exc
+            return cur.rowcount > 0
     finally:
         conn.close()

app/db/contatos.py

@@ -50,7 +50,12 @@ def inserir_contato(cliente_id: int, nome: str | None, telefone: str, email: str
 
 def atualizar_contato(
     contato_id: int, cliente_id: int, nome: str | None, telefone: str, email: str | None = None
-) -> None:
+) -> bool:
+    """True se realmente existia um CLIENTE_CONTATO com esse ID nesse
+    cliente (cur.rowcount > 0) — um ID inexistente, ou de outro cliente,
+    não gera erro nenhum do MySQL (WHERE simplesmente não bate com
+    nada), então sem checar rowcount o chamador não tem como saber que
+    não alterou nada."""
     conn = get_connection()
     try:
         with conn.cursor() as cur:
@@ -59,11 +64,13 @@ def atualizar_contato(
                 "WHERE ID = %s AND CLIENTE_ID = %s",
                 (nome, telefone, email, contato_id, cliente_id),
             )
+            return cur.rowcount > 0
     finally:
         conn.close()
 
 
-def excluir_contato(contato_id: int, cliente_id: int) -> None:
+def excluir_contato(contato_id: int, cliente_id: int) -> bool:
+    """True se uma linha foi de fato excluída — ver atualizar_contato."""
     conn = get_connection()
     try:
         with conn.cursor() as cur:
@@ -71,5 +78,6 @@ def excluir_contato(contato_id: int, cliente_id: int) -> None:
                 "DELETE FROM CLIENTE_CONTATO WHERE ID = %s AND CLIENTE_ID = %s",
                 (contato_id, cliente_id),
             )
+            return cur.rowcount > 0
     finally:
         conn.close()

app/db/funcionarios.py

@@ -117,7 +117,11 @@ def atualizar_funcionario(funcionario_id: int, nome: str, login: str, perfil: st
         conn.close()
 
 
-def redefinir_senha(funcionario_id: int, nova_senha: str) -> None:
+def redefinir_senha(funcionario_id: int, nova_senha: str) -> bool:
+    """True se o ID realmente existia (cur.rowcount > 0) — sem essa
+    checagem um ID inexistente fazia um UPDATE que não afeta nenhuma
+    linha, sem erro nenhum do MySQL, e o chamador registrava "sucesso"
+    no log mesmo sem ter mudado a senha de ninguém."""
     conn = get_connection()
     try:
         with conn.cursor() as cur:
@@ -125,6 +129,7 @@ def redefinir_senha(funcionario_id: int, nova_senha: str) -> None:
                 "UPDATE FUNCIONARIO_PAINEL SET SENHA_HASH = %s WHERE ID = %s",
                 (gerar_hash(nova_senha), funcionario_id),
             )
+            return cur.rowcount > 0
     finally:
         conn.close()