feat: log de acoes/envios, ordenacao/filtro, codigo sequencial, campos opcionais

- Tabela LOG_PAINEL (nova, ja criada no banco de dev) + app/db/log.py:
  toda criacao/edicao/exclusao de cliente e contato fica registrada
  (usuario, acao, sucesso/erro, detalhe). Tela /log mostra esse
  historico.
- app/n8n_client.py: leitura opcional (N8N_API_URL/N8N_API_KEY) da
  Data Table pagamentos_processados do n8n, mostrando os envios
  automaticos de chave na mesma tela /log. Degrada de forma segura
  (lista vazia) se nao configurado ou se a chamada falhar.
- Lista de clientes ganha ordenacao configuravel (codigo/razao/
  fantasia/CNPJ) via whitelist, alem da busca que ja existia.
- CODIGO duplicado agora BLOQUEIA de verdade na criacao/edicao (sem
  bypass) — antes so avisava com opcao de confirmar mesmo assim.
- Formulario de novo cliente sugere o proximo CODIGO sequencial
  (editavel), ignorando a faixa reservada para dados de teste
  (>= 900000) para nao ser contaminado por sobra de teste no banco.
- IMPLANTACAO/MENSALIDADE/JUROS_MORA/JUROS_MULTA/DATA_CONTRATO/
  VENCIMENTO_CONTRATO deixam de ser obrigatorios — em branco, gravam
  default (0,00 / hoje) em vez de bloquear o cadastro. Só CODIGO/CNPJ/
  RAZAO/FANTASIA continuam obrigatorios.
- Limpeza: removidas 10 linhas de teste vazadas (CODIGO 999902) que
  ficaram no banco de dev por sessoes de teste interrompidas.

69/69 testes passando (16 novos).

app/templates/base.html

@@ -26,6 +26,7 @@
   <nav>
     <a href="/clientes">Clientes</a>
     <a href="/gerador-chave">Gerador de chave</a>
+    <a href="/log">Log</a>
   </nav>
   <main>
     {% if mensagem %}<div class="mensagem {{ mensagem_tipo or 'success' }}">{{ mensagem }}</div>{% endif %}

app/templates/cliente_form.html

@@ -3,16 +3,9 @@
 {% block titulo %}{{ "Editar" if cliente else "Novo" }} cliente{% endblock %}
 {% block conteudo %}
   <h1>{{ "Editar" if cliente else "Novo" }} cliente</h1>
-  {% if aviso_codigo_duplicado %}
-    <div class="mensagem warning">
-      O código {{ dados.CODIGO }} já está em uso por outro cliente.
-      <form method="post">
-        <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
-        {% for campo, valor in dados.items() %}<input type="hidden" name="{{ campo }}" value="{{ valor }}">{% endfor %}
-        <input type="hidden" name="confirmar_codigo_duplicado" value="1">
-        <input type="hidden" name="confirmar_dv_invalido" value="{{ '1' if (aviso_dv_invalido or confirmar_dv_invalido) else '' }}">
-        <button type="submit">Cadastrar mesmo assim</button>
-      </form>
+  {% if erro_codigo_duplicado %}
+    <div class="mensagem danger">
+      O código {{ dados.CODIGO }} já está em uso por outro cliente — escolha outro código antes de salvar.
     </div>
   {% endif %}
   {% if aviso_dv_invalido %}
@@ -22,7 +15,6 @@
         <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
         {% for campo, valor in dados.items() %}<input type="hidden" name="{{ campo }}" value="{{ valor }}">{% endfor %}
         <input type="hidden" name="confirmar_dv_invalido" value="1">
-        <input type="hidden" name="confirmar_codigo_duplicado" value="{{ '1' if (aviso_codigo_duplicado or confirmar_codigo_duplicado) else '' }}">
         <button type="submit">Cadastrar mesmo assim</button>
       </form>
     </div>
@@ -35,15 +27,16 @@
   <form method="post">
     <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
     {% for campo in campos %}
-      <label for="{{ campo }}">{{ campo }}</label>
+      <label for="{{ campo }}">{{ campo }}{% if campo in campos_obrigatorios %} *{% endif %}</label>
       {% if campo in ["DATA_CONTRATO", "VENCIMENTO_CONTRATO"] %}
-        <input type="date" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}" required>
+        <input type="date" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}" {% if campo in campos_obrigatorios %}required{% endif %}>
       {% elif campo in ["IMPLANTACAO", "MENSALIDADE", "JUROS_MORA", "JUROS_MULTA"] %}
-        <input type="number" step="0.01" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}" required>
+        <input type="number" step="0.01" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}" {% if campo in campos_obrigatorios %}required{% endif %}>
       {% else %}
-        <input type="text" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}" required>
+        <input type="text" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}" {% if campo in campos_obrigatorios %}required{% endif %}>
       {% endif %}
     {% endfor %}
+    <p><small>* campos obrigatórios. Os demais podem ficar em branco — implantação/mensalidade/juros ficam 0,00 e as datas de contrato ficam com a data de hoje até serem ajustadas.</small></p>
     <button type="submit">Salvar</button>
   </form>
 {% endblock %}

app/templates/clientes_lista.html

@@ -5,6 +5,13 @@
   <h1>Clientes</h1>
   <form method="get" action="/clientes">
     <input type="text" name="busca" value="{{ busca or '' }}" placeholder="Buscar por código, CNPJ, razão ou fantasia">
+    <label for="ordenar_por">Ordenar por</label>
+    <select id="ordenar_por" name="ordenar_por">
+      <option value="razao" {% if ordenar_por == "razao" %}selected{% endif %}>Razão social</option>
+      <option value="codigo" {% if ordenar_por == "codigo" %}selected{% endif %}>Código</option>
+      <option value="fantasia" {% if ordenar_por == "fantasia" %}selected{% endif %}>Fantasia</option>
+      <option value="cnpj" {% if ordenar_por == "cnpj" %}selected{% endif %}>CNPJ</option>
+    </select>
     <button type="submit">Buscar</button>
   </form>
   <p><a class="botao" href="/clientes/novo">+ Novo cliente</a></p>
@@ -23,11 +30,11 @@
   {% if total_paginas and total_paginas > 1 %}
     <p>
       {% if pagina > 1 %}
-        <a class="botao" href="/clientes?pagina={{ pagina - 1 }}{{ '&busca=' + busca if busca else '' }}">&larr; Anterior</a>
+        <a class="botao" href="/clientes?pagina={{ pagina - 1 }}{{ '&busca=' + busca if busca else '' }}&ordenar_por={{ ordenar_por }}">&larr; Anterior</a>
       {% endif %}
       Página {{ pagina }} de {{ total_paginas }} ({{ total }} clientes)
       {% if pagina < total_paginas %}
-        <a class="botao" href="/clientes?pagina={{ pagina + 1 }}{{ '&busca=' + busca if busca else '' }}">Próxima &rarr;</a>
+        <a class="botao" href="/clientes?pagina={{ pagina + 1 }}{{ '&busca=' + busca if busca else '' }}&ordenar_por={{ ordenar_por }}">Próxima &rarr;</a>
       {% endif %}
     </p>
   {% endif %}

app/templates/log.html

@@ -0,0 +1,55 @@
+<!-- app/templates/log.html -->
+{% extends "base.html" %}
+{% block titulo %}Log{% endblock %}
+{% block conteudo %}
+  <h1>Log</h1>
+  <p><a class="botao" href="/clientes">&larr; Clientes</a></p>
+
+  <h2>Ações no painel</h2>
+  {% if acoes %}
+    <table>
+      <tr><th>Quando</th><th>Usuário</th><th>Ação</th><th>Entidade</th><th>Status</th><th>Detalhe</th></tr>
+      {% for a in acoes %}
+      <tr>
+        <td>{{ a.CRIADO_EM }}</td>
+        <td>{{ a.USUARIO }}</td>
+        <td>{{ a.ACAO }}</td>
+        <td>{{ a.ENTIDADE }}{% if a.ENTIDADE_ID %} #{{ a.ENTIDADE_ID }}{% endif %}</td>
+        <td>{{ "OK" if a.SUCESSO else "ERRO" }}</td>
+        <td>{{ a.DETALHE or "" }}</td>
+      </tr>
+      {% endfor %}
+    </table>
+  {% else %}
+    <p>Nenhuma ação registrada ainda.</p>
+  {% endif %}
+
+  <h2>Envios automáticos de chave (n8n)</h2>
+  {% if not envios_configurado %}
+    <p>
+      Integração com o n8n não configurada — defina <code>N8N_API_URL</code> e
+      <code>N8N_API_KEY</code> no ambiente (ver <code>.env.example</code>) para ver
+      aqui os envios automáticos de chave feitos pelo workflow do n8n.
+    </p>
+  {% elif not envios %}
+    <p>Nenhum envio encontrado (ou não foi possível consultar o n8n agora).</p>
+  {% else %}
+    <table>
+      <tr>
+        <th>Data</th><th>Cliente</th><th>Código</th><th>Competência</th><th>Status</th>
+        <th>Telefones enviados</th><th>Telefones com erro</th>
+      </tr>
+      {% for e in envios %}
+      <tr>
+        <td>{{ e.data_processamento }}</td>
+        <td>{{ e.nome_cliente }}</td>
+        <td>{{ e.codigo_cliente }}</td>
+        <td>{{ e.competencia }}</td>
+        <td>{{ e.status }}</td>
+        <td>{{ e.telefones_enviados }}</td>
+        <td>{{ e.telefones_com_erro or "" }}</td>
+      </tr>
+      {% endfor %}
+    </table>
+  {% endif %}
+{% endblock %}