Files
GTI_GERENCIADOR_FISCAL/tests/test_router_clientes.py
T
Gustavo 9ed0bf57c2 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).
2026-08-13 14:04:24 -03:00

331 lines
12 KiB
Python

"""
Testa só a camada HTTP: monta um FastAPI() com apenas este router, sobrescreve
exigir_login (sem exigir Basic Auth real) e faz monkeypatch das funções de
app.db.clientes usadas pelo router — não toca no banco de verdade.
"""
import pytest
from fastapi import FastAPI
from fastapi.testclient import TestClient
from app.auth import exigir_login
from app.db.connection import get_connection
from app.routers import clientes as router_clientes
app_teste = FastAPI()
app_teste.include_router(router_clientes.router)
app_teste.dependency_overrides[exigir_login] = lambda: "teste"
client = TestClient(app_teste, follow_redirects=False)
# Este app de teste não tem o middleware de CSRF (só o main.py real o monta).
# Simula um navegador que já tem o cookie definido: os testes de POST
# precisam mandar o mesmo valor no campo oculto "csrf_token".
CSRF_TESTE = "teste-csrf-token"
client.cookies.set("csrf_token", CSRF_TESTE)
@pytest.fixture(autouse=True)
def _sem_log_real(monkeypatch):
"""
O router registra cada ação em LOG_PAINEL (app/db/log.py) — por padrão
isso bateria no banco real. Substitui por um no-op nos testes que não
são especificamente sobre o log (test_router_clientes não testa
app/db/log.py, isso já é coberto em tests/test_db_log.py).
"""
monkeypatch.setattr(router_clientes.db_log, "registrar", lambda *args, **kwargs: None)
def _form_valido(codigo: str = "000001") -> dict:
"""Monta um dict de formulário válido (todos os campos preenchidos)."""
dados = {campo: "x" for campo in router_clientes.db_clientes.CAMPOS_CLIENTE}
dados.update(
{
"CODIGO": codigo,
"CNPJ": "11222333000181",
"IMPLANTACAO": "0",
"MENSALIDADE": "100",
"JUROS_MORA": "0",
"JUROS_MULTA": "0",
"DATA_CONTRATO": "2026-01-01",
"VENCIMENTO_CONTRATO": "2027-01-01",
"DIA_VENCIMENTO": "10",
"csrf_token": CSRF_TESTE,
}
)
return dados
def test_listar_clientes(monkeypatch):
monkeypatch.setattr(
router_clientes.db_clientes,
"listar_clientes",
lambda busca=None, limite=100, offset=0, ordenar_por="razao": [
{"ID": 1, "CODIGO": "000001", "RAZAO": "Cliente Um", "FANTASIA": "Um", "CNPJ": "11222333000181"}
],
)
monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None: 1)
resposta = client.get("/clientes")
assert resposta.status_code == 200
assert "Cliente Um" in resposta.text
def test_listar_clientes_pagina_com_controles_de_paginacao(monkeypatch):
monkeypatch.setattr(
router_clientes.db_clientes,
"listar_clientes",
lambda busca=None, limite=100, offset=0, ordenar_por="razao": [
{"ID": i, "CODIGO": f"{i:06d}", "RAZAO": f"Cliente {i}", "FANTASIA": f"C{i}", "CNPJ": "11222333000181"}
for i in range(1, 6)
],
)
monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None: 250)
resposta = client.get("/clientes?pagina=2")
assert resposta.status_code == 200
assert "Página 2 de 3" in resposta.text
assert "250 clientes" in resposta.text
assert "Anterior" in resposta.text
assert "Próxima" in resposta.text
def test_listar_clientes_ordenar_por_invalido_cai_no_padrao(monkeypatch):
capturado = {}
def _listar_clientes(busca=None, limite=100, offset=0, ordenar_por="razao"):
capturado["ordenar_por"] = ordenar_por
return []
monkeypatch.setattr(router_clientes.db_clientes, "listar_clientes", _listar_clientes)
monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None: 0)
client.get("/clientes?ordenar_por=coisa_invalida_qualquer")
assert capturado["ordenar_por"] == "razao"
client.get("/clientes?ordenar_por=codigo")
assert capturado["ordenar_por"] == "codigo"
def test_form_novo_preenche_codigo_sugerido(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "proximo_codigo_sugerido", lambda: "000243")
resposta = client.get("/clientes/novo")
assert resposta.status_code == 200
assert 'value="000243"' in resposta.text
def test_detalhe_cliente_mostra_formulario_de_edicao_de_contato(monkeypatch):
monkeypatch.setattr(
router_clientes.db_clientes,
"obter_cliente",
lambda cid: {"ID": cid, "CODIGO": "000001", "RAZAO": "Cliente Um", "FANTASIA": "Um", "CNPJ": "11222333000181"},
)
monkeypatch.setattr(
router_clientes.db_contatos,
"listar_contatos_por_cliente",
lambda cid: [{"ID": 7, "NOME": "Fulano", "TELEFONE": "75999090001", "EMAIL": None}],
)
monkeypatch.setattr(router_clientes.db_chaves, "status_chaves", lambda codigo: None)
resposta = client.get("/clientes/1")
assert resposta.status_code == 200
assert '/clientes/1/contatos/7/editar' in resposta.text
assert 'value="Fulano"' in resposta.text
assert 'value="75999090001"' in resposta.text
def test_criar_cliente_codigo_duplicado_bloqueia_sem_bypass(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: True)
criado = {}
monkeypatch.setattr(
router_clientes.db_clientes, "criar_cliente", lambda dados: criado.setdefault("ok", True) and 42
)
dados_form = _form_valido()
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 200
assert "já está em uso" in resposta.text
assert "ok" not in criado
# Não existe mais bypass: mesmo insistindo, sem trocar o código, continua bloqueado.
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 200
assert "já está em uso" in resposta.text
assert "ok" not in criado
def test_criar_cliente_campo_obrigatorio_faltando_bloqueia(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: False)
criado = {}
monkeypatch.setattr(
router_clientes.db_clientes, "criar_cliente", lambda dados: criado.setdefault("ok", True) and 42
)
dados_form = _form_valido()
dados_form["RAZAO"] = ""
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 200
assert "RAZAO" in resposta.text
assert "ok" not in criado
def test_criar_cliente_campos_administrativos_em_branco_usa_defaults(monkeypatch):
"""
IMPLANTACAO/MENSALIDADE/JUROS_MORA/JUROS_MULTA/DATA_CONTRATO/
VENCIMENTO_CONTRATO não são mais obrigatórios — em branco, o cliente é
criado mesmo assim, com defaults (0,00 / hoje).
"""
import datetime
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: False)
capturado = {}
monkeypatch.setattr(
router_clientes.db_clientes, "criar_cliente", lambda dados: capturado.setdefault("dados", dados) and 42
)
dados_form = _form_valido()
for campo in ("IMPLANTACAO", "MENSALIDADE", "JUROS_MORA", "JUROS_MULTA", "DATA_CONTRATO", "VENCIMENTO_CONTRATO"):
dados_form[campo] = ""
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 303
dados = capturado["dados"]
assert dados["IMPLANTACAO"] == "0.00"
assert dados["MENSALIDADE"] == "0.00"
assert dados["JUROS_MORA"] == "0.00"
assert dados["JUROS_MULTA"] == "0.00"
hoje = datetime.date.today().isoformat()
assert dados["DATA_CONTRATO"] == hoje
assert dados["VENCIMENTO_CONTRATO"] == hoje
def test_criar_cliente_normaliza_cnpj_e_telefones(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: False)
capturado = {}
monkeypatch.setattr(
router_clientes.db_clientes, "criar_cliente", lambda dados: capturado.setdefault("dados", dados) and 42
)
dados_form = _form_valido()
dados_form.update(
{
"CNPJ": "11.222.333/0001-81",
"TELEFONE": "(75) 3333-4444",
"CELULAR": "(75) 99909-1780",
}
)
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 303
assert capturado["dados"]["CNPJ"] == "11222333000181"
assert capturado["dados"]["TELEFONE"] == "7533334444"
assert capturado["dados"]["CELULAR"] == "75999091780"
def test_editar_cliente_normaliza_cnpj_e_telefones(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: False)
capturado = {}
monkeypatch.setattr(
router_clientes.db_clientes,
"atualizar_cliente",
lambda cliente_id, dados: capturado.setdefault("dados", dados),
)
dados_form = _form_valido()
dados_form.update(
{
"CNPJ": "111.444.777-35",
"TELEFONE": "(75) 3333-4444",
"CELULAR": "(75) 99909-1780",
}
)
resposta = client.post("/clientes/1/editar", data=dados_form)
assert resposta.status_code == 303
assert capturado["dados"]["CNPJ"] == "11144477735"
assert capturado["dados"]["TELEFONE"] == "7533334444"
assert capturado["dados"]["CELULAR"] == "75999091780"
def test_editar_cliente_codigo_duplicado_bloqueia_sem_bypass(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: True)
atualizado = {}
monkeypatch.setattr(
router_clientes.db_clientes,
"atualizar_cliente",
lambda cliente_id, dados: atualizado.setdefault("ok", True),
)
dados_form = _form_valido()
resposta = client.post("/clientes/1/editar", data=dados_form)
assert resposta.status_code == 200
assert "já está em uso" in resposta.text
assert "ok" not in atualizado
def test_excluir_cliente_com_dependencia_mostra_erro(monkeypatch):
monkeypatch.setattr(
router_clientes.db_clientes,
"obter_cliente",
lambda cliente_id: {"ID": cliente_id, "CODIGO": "000001", "RAZAO": "R", "FANTASIA": "F"},
)
monkeypatch.setattr(router_clientes.db_contatos, "listar_contatos_por_cliente", lambda cliente_id: [])
monkeypatch.setattr(router_clientes.db_chaves, "status_chaves", lambda codigo: None)
def _excluir(cliente_id):
raise router_clientes.db_clientes.ClienteComDependenciasError("tem contato")
monkeypatch.setattr(router_clientes.db_clientes, "excluir_cliente", _excluir)
resposta = client.post("/clientes/1/excluir", data={"csrf_token": CSRF_TESTE}, follow_redirects=True)
assert resposta.status_code == 200
assert "tem contato" in resposta.text
def _limpar_codigo(codigo: str) -> None:
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute("DELETE FROM CLIENTE WHERE CODIGO = %s", (codigo,))
finally:
conn.close()
def test_criar_cliente_com_data_e_decimais_vazios_cria_com_defaults():
"""
Integração com o banco real de dev: DATA_CONTRATO/decimais deixaram de
ser obrigatórios — em branco, o router aplica defaults (0,00 / hoje)
antes de gravar, então o cliente é criado normalmente (303), não gera
erro nem 500.
"""
codigo = "999906"
dados_form = _form_valido(codigo)
for campo in ("IMPLANTACAO", "MENSALIDADE", "JUROS_MORA", "JUROS_MULTA", "DATA_CONTRATO", "VENCIMENTO_CONTRATO"):
dados_form[campo] = ""
try:
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 303
finally:
_limpar_codigo(codigo)
def test_criar_cliente_com_dv_invalido_exige_confirmacao(monkeypatch):
monkeypatch.setattr(router_clientes.db_clientes, "codigo_em_uso", lambda codigo, ignorar_id=None: False)
criado = {}
monkeypatch.setattr(
router_clientes.db_clientes, "criar_cliente", lambda dados: criado.setdefault("ok", True) and 42
)
dados_form = _form_valido()
dados_form["CNPJ"] = "11144477734" # CPF com DV inválido (1 dígito diferente do válido "...735")
# Sem confirmar: pede confirmação, não cria.
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 200
assert "não confere" in resposta.text
assert "ok" not in criado
# Confirmando: cria.
dados_form["confirmar_dv_invalido"] = "1"
resposta = client.post("/clientes/novo", data=dados_form)
assert resposta.status_code == 303
assert criado.get("ok") is True