feat: rotas de CLIENTE_CONTATO na tela de detalhe do cliente

app/routers/contatos.py

@@ -0,0 +1,69 @@
+"""
+Rotas de gestão de CLIENTE_CONTATO — sempre no contexto de um cliente
+(cliente_id na URL). Redireciona de volta para /clientes/{cliente_id}
+(a tela de detalhe do cliente, montada na Task 8).
+"""
+from urllib.parse import urlencode
+
+from fastapi import APIRouter, Depends, Form
+from fastapi.responses import RedirectResponse
+
+from ..auth import exigir_login
+from ..db import clientes as db_clientes
+from ..db import contatos as db_contatos
+from ..normalize import normalizar_telefone
+
+router = APIRouter(prefix="/clientes")
+
+
+def _redirect_com_mensagem(cliente_id: int, mensagem: str, tipo: str = "success") -> RedirectResponse:
+    query = urlencode({"mensagem": mensagem, "mensagem_tipo": tipo})
+    return RedirectResponse(f"/clientes/{cliente_id}?{query}", status_code=303)
+
+
+@router.post("/{cliente_id}/contatos")
+def adicionar(
+    cliente_id: int,
+    nome: str = Form(""),
+    telefone: str = Form(...),
+    email: str = Form(""),
+    usuario: str = Depends(exigir_login),
+):
+    if db_clientes.obter_cliente(cliente_id) is None:
+        return _redirect_com_mensagem(cliente_id, "Cliente não encontrado.", "danger")
+
+    telefone_normalizado = normalizar_telefone(telefone)
+    if not telefone_normalizado:
+        return _redirect_com_mensagem(cliente_id, "Telefone obrigatório.", "danger")
+
+    if db_contatos.contato_duplicado(cliente_id, telefone_normalizado):
+        return _redirect_com_mensagem(cliente_id, f"O telefone {telefone_normalizado} já está cadastrado para este cliente.", "warning")
+
+    db_contatos.inserir_contato(cliente_id, nome.strip() or None, telefone_normalizado, email.strip() or None)
+    return _redirect_com_mensagem(cliente_id, "Contato adicionado.")
+
+
+@router.post("/{cliente_id}/contatos/{contato_id}/editar")
+def editar(
+    cliente_id: int,
+    contato_id: int,
+    nome: str = Form(""),
+    telefone: str = Form(...),
+    email: str = Form(""),
+    usuario: str = Depends(exigir_login),
+):
+    telefone_normalizado = normalizar_telefone(telefone)
+    if not telefone_normalizado:
+        return _redirect_com_mensagem(cliente_id, "Telefone obrigatório.", "danger")
+
+    if db_contatos.contato_duplicado(cliente_id, telefone_normalizado, ignorar_id=contato_id):
+        return _redirect_com_mensagem(cliente_id, f"O telefone {telefone_normalizado} já está cadastrado para este cliente.", "warning")
+
+    db_contatos.atualizar_contato(contato_id, cliente_id, nome.strip() or None, telefone_normalizado, email.strip() or None)
+    return _redirect_com_mensagem(cliente_id, "Contato atualizado.")
+
+
+@router.post("/{cliente_id}/contatos/{contato_id}/excluir")
+def excluir(cliente_id: int, contato_id: int, usuario: str = Depends(exigir_login)):
+    db_contatos.excluir_contato(contato_id, cliente_id)
+    return _redirect_com_mensagem(cliente_id, "Contato excluído.")

app/templates/cliente_detalhe.html

@@ -13,11 +13,27 @@
 
   <h2>Contatos</h2>
   <table>
-    <tr><th>Nome</th><th>Telefone</th><th>E-mail</th></tr>
+    <tr><th>Nome</th><th>Telefone</th><th>E-mail</th><th></th></tr>
     {% for ct in contatos %}
-    <tr><td>{{ ct.NOME }}</td><td>{{ ct.TELEFONE }}</td><td>{{ ct.EMAIL or "" }}</td></tr>
+    <tr>
+      <td>{{ ct.NOME }}</td><td>{{ ct.TELEFONE }}</td><td>{{ ct.EMAIL or "" }}</td>
+      <td>
+        <form method="post" action="/clientes/{{ cliente.ID }}/contatos/{{ ct.ID }}/excluir" style="display:inline">
+          <button type="submit" onclick="return confirm('Excluir este contato?')">Excluir</button>
+        </form>
+      </td>
+    </tr>
     {% endfor %}
   </table>
+  <form method="post" action="/clientes/{{ cliente.ID }}/contatos">
+    <label for="nome">Nome</label>
+    <input type="text" id="nome" name="nome">
+    <label for="telefone">Telefone</label>
+    <input type="text" id="telefone" name="telefone" required>
+    <label for="email">E-mail</label>
+    <input type="text" id="email" name="email">
+    <button type="submit">Adicionar contato</button>
+  </form>
 
   <h2>Status em Clientes_Chaves</h2>
   {% if status_chaves %}