feat: rotas e telas de CLIENTE (listar, criar, editar, detalhe, excluir)
This commit is contained in:
Gustavo
@@ -0,0 +1 @@
|
||||
# app/routers/__init__.py
|
||||
@@ -0,0 +1,137 @@
|
||||
# app/routers/clientes.py
|
||||
"""
|
||||
Rotas de gestão de CLIENTE: listar/buscar, criar, editar, ver detalhe
|
||||
(contatos + status de Clientes_Chaves), excluir.
|
||||
"""
|
||||
from typing import Optional
|
||||
from urllib.parse import urlencode
|
||||
|
||||
from fastapi import APIRouter, Depends, Form, Request
|
||||
from fastapi.responses import HTMLResponse, RedirectResponse
|
||||
from fastapi.templating import Jinja2Templates
|
||||
|
||||
from ..auth import exigir_login
|
||||
from ..db import chaves as db_chaves
|
||||
from ..db import clientes as db_clientes
|
||||
from ..db import contatos as db_contatos
|
||||
from ..normalize import normalizar_documento, validar_dv_cpf, validar_dv_cnpj
|
||||
|
||||
router = APIRouter(prefix="/clientes")
|
||||
templates = Jinja2Templates(directory="app/templates")
|
||||
|
||||
|
||||
def _redirect_com_mensagem(url: str, mensagem: str, tipo: str = "success") -> RedirectResponse:
|
||||
separador = "&" if "?" in url else "?"
|
||||
return RedirectResponse(url + separador + urlencode({"mensagem": mensagem, "mensagem_tipo": tipo}), status_code=303)
|
||||
|
||||
|
||||
def _ler_form_cliente(form: dict) -> dict:
|
||||
return {campo: (form.get(campo) or "").strip() for campo in db_clientes.CAMPOS_CLIENTE}
|
||||
|
||||
|
||||
@router.get("", response_class=HTMLResponse)
|
||||
def listar(
|
||||
request: Request,
|
||||
busca: Optional[str] = None,
|
||||
mensagem: Optional[str] = None,
|
||||
mensagem_tipo: Optional[str] = None,
|
||||
usuario: str = Depends(exigir_login),
|
||||
):
|
||||
clientes = db_clientes.listar_clientes(busca=busca or None)
|
||||
return templates.TemplateResponse(
|
||||
"clientes_lista.html",
|
||||
{"request": request, "clientes": clientes, "busca": busca, "mensagem": mensagem, "mensagem_tipo": mensagem_tipo},
|
||||
)
|
||||
|
||||
|
||||
@router.get("/novo", response_class=HTMLResponse)
|
||||
def form_novo(request: Request, usuario: str = Depends(exigir_login)):
|
||||
return templates.TemplateResponse(
|
||||
"cliente_form.html",
|
||||
{"request": request, "cliente": None, "dados": {c: "" for c in db_clientes.CAMPOS_CLIENTE}, "campos": db_clientes.CAMPOS_CLIENTE},
|
||||
)
|
||||
|
||||
|
||||
@router.post("/novo")
|
||||
async def criar(request: Request, usuario: str = Depends(exigir_login)):
|
||||
form = dict((await request.form()))
|
||||
dados = _ler_form_cliente(form)
|
||||
confirmar_duplicado = form.get("confirmar_codigo_duplicado") == "1"
|
||||
|
||||
if not confirmar_duplicado and db_clientes.codigo_em_uso(dados["CODIGO"]):
|
||||
return templates.TemplateResponse(
|
||||
"cliente_form.html",
|
||||
{"request": request, "cliente": None, "dados": dados, "campos": db_clientes.CAMPOS_CLIENTE, "aviso_codigo_duplicado": True},
|
||||
)
|
||||
|
||||
_, formato_valido, tipo = normalizar_documento(dados["CNPJ"])
|
||||
dv_invalido = False
|
||||
if formato_valido:
|
||||
dv_invalido = not (validar_dv_cpf(dados["CNPJ"]) if tipo == "CPF" else validar_dv_cnpj(dados["CNPJ"]))
|
||||
if dv_invalido and form.get("confirmar_dv_invalido") != "1":
|
||||
return templates.TemplateResponse(
|
||||
"cliente_form.html",
|
||||
{"request": request, "cliente": None, "dados": dados, "campos": db_clientes.CAMPOS_CLIENTE, "aviso_dv_invalido": True},
|
||||
)
|
||||
|
||||
novo_id = db_clientes.criar_cliente(dados)
|
||||
return _redirect_com_mensagem(f"/clientes/{novo_id}", "Cliente criado.")
|
||||
|
||||
|
||||
@router.get("/{cliente_id}", response_class=HTMLResponse)
|
||||
def detalhe(
|
||||
request: Request,
|
||||
cliente_id: int,
|
||||
mensagem: Optional[str] = None,
|
||||
mensagem_tipo: Optional[str] = None,
|
||||
usuario: str = Depends(exigir_login),
|
||||
):
|
||||
cliente = db_clientes.obter_cliente(cliente_id)
|
||||
if cliente is None:
|
||||
return _redirect_com_mensagem("/clientes", "Cliente não encontrado.", "danger")
|
||||
|
||||
contatos = db_contatos.listar_contatos_por_cliente(cliente_id)
|
||||
status = db_chaves.status_chaves(cliente["CODIGO"])
|
||||
return templates.TemplateResponse(
|
||||
"cliente_detalhe.html",
|
||||
{
|
||||
"request": request, "cliente": cliente, "contatos": contatos, "status_chaves": status,
|
||||
"mensagem": mensagem, "mensagem_tipo": mensagem_tipo,
|
||||
},
|
||||
)
|
||||
|
||||
|
||||
@router.get("/{cliente_id}/editar", response_class=HTMLResponse)
|
||||
def form_editar(request: Request, cliente_id: int, usuario: str = Depends(exigir_login)):
|
||||
cliente = db_clientes.obter_cliente(cliente_id)
|
||||
if cliente is None:
|
||||
return _redirect_com_mensagem("/clientes", "Cliente não encontrado.", "danger")
|
||||
return templates.TemplateResponse(
|
||||
"cliente_form.html",
|
||||
{"request": request, "cliente": cliente, "dados": cliente, "campos": db_clientes.CAMPOS_CLIENTE},
|
||||
)
|
||||
|
||||
|
||||
@router.post("/{cliente_id}/editar")
|
||||
async def editar(request: Request, cliente_id: int, usuario: str = Depends(exigir_login)):
|
||||
form = dict((await request.form()))
|
||||
dados = _ler_form_cliente(form)
|
||||
confirmar_duplicado = form.get("confirmar_codigo_duplicado") == "1"
|
||||
|
||||
if not confirmar_duplicado and db_clientes.codigo_em_uso(dados["CODIGO"], ignorar_id=cliente_id):
|
||||
return templates.TemplateResponse(
|
||||
"cliente_form.html",
|
||||
{"request": request, "cliente": {"ID": cliente_id}, "dados": dados, "campos": db_clientes.CAMPOS_CLIENTE, "aviso_codigo_duplicado": True},
|
||||
)
|
||||
|
||||
db_clientes.atualizar_cliente(cliente_id, dados)
|
||||
return _redirect_com_mensagem(f"/clientes/{cliente_id}", "Cliente atualizado.")
|
||||
|
||||
|
||||
@router.post("/{cliente_id}/excluir")
|
||||
def excluir(cliente_id: int, usuario: str = Depends(exigir_login)):
|
||||
try:
|
||||
db_clientes.excluir_cliente(cliente_id)
|
||||
except db_clientes.ClienteComDependenciasError as exc:
|
||||
return _redirect_com_mensagem(f"/clientes/{cliente_id}", str(exc), "danger")
|
||||
return _redirect_com_mensagem("/clientes", "Cliente excluído.")
|
||||
@@ -0,0 +1,35 @@
|
||||
<!-- app/templates/base.html -->
|
||||
<!DOCTYPE html>
|
||||
<html lang="pt-BR">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<title>{% block titulo %}Painel de Clientes{% endblock %}</title>
|
||||
<style>
|
||||
body { font-family: system-ui, sans-serif; margin: 0; background: #17171a; color: #f4f4f5; }
|
||||
nav { background: #232326; padding: 12px 20px; display: flex; gap: 16px; }
|
||||
nav a { color: #f4f4f5; text-decoration: none; }
|
||||
nav a:hover { color: #F5821F; }
|
||||
main { padding: 20px; max-width: 960px; margin: 0 auto; }
|
||||
table { width: 100%; border-collapse: collapse; margin-top: 12px; }
|
||||
th, td { text-align: left; padding: 8px; border-bottom: 1px solid #3a3a3e; }
|
||||
input, select { padding: 8px; border-radius: 6px; border: 1px solid #3a3a3e; background: #17171a; color: #f4f4f5; width: 100%; box-sizing: border-box; }
|
||||
label { display: block; margin-top: 10px; font-size: 0.85rem; color: #a1a1aa; }
|
||||
button { margin-top: 14px; padding: 10px 16px; border: none; border-radius: 6px; background: #F5821F; color: #17171a; font-weight: 700; cursor: pointer; }
|
||||
.mensagem { padding: 10px; border-radius: 6px; margin-bottom: 12px; }
|
||||
.mensagem.success { background: #14532d; }
|
||||
.mensagem.danger { background: #7f1d1d; }
|
||||
.mensagem.warning { background: #78350f; }
|
||||
a.botao { display: inline-block; padding: 6px 10px; border: 1px solid #3a3a3e; border-radius: 6px; color: #f4f4f5; text-decoration: none; margin-right: 6px; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<nav>
|
||||
<a href="/clientes">Clientes</a>
|
||||
<a href="/gerador-chave">Gerador de chave</a>
|
||||
</nav>
|
||||
<main>
|
||||
{% if mensagem %}<div class="mensagem {{ mensagem_tipo or 'success' }}">{{ mensagem }}</div>{% endif %}
|
||||
{% block conteudo %}{% endblock %}
|
||||
</main>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,31 @@
|
||||
<!-- app/templates/cliente_detalhe.html -->
|
||||
{% extends "base.html" %}
|
||||
{% block titulo %}{{ cliente.RAZAO }}{% endblock %}
|
||||
{% block conteudo %}
|
||||
<h1>{{ cliente.FANTASIA }} <small>({{ cliente.CODIGO }})</small></h1>
|
||||
<p>{{ cliente.RAZAO }} — {{ cliente.CNPJ }}</p>
|
||||
<p>
|
||||
<a class="botao" href="/clientes/{{ cliente.ID }}/editar">Editar</a>
|
||||
<form method="post" action="/clientes/{{ cliente.ID }}/excluir" style="display:inline">
|
||||
<button type="submit" onclick="return confirm('Excluir este cliente?')">Excluir</button>
|
||||
</form>
|
||||
</p>
|
||||
|
||||
<h2>Contatos</h2>
|
||||
<table>
|
||||
<tr><th>Nome</th><th>Telefone</th><th>E-mail</th></tr>
|
||||
{% for ct in contatos %}
|
||||
<tr><td>{{ ct.NOME }}</td><td>{{ ct.TELEFONE }}</td><td>{{ ct.EMAIL or "" }}</td></tr>
|
||||
{% endfor %}
|
||||
</table>
|
||||
|
||||
<h2>Status em Clientes_Chaves</h2>
|
||||
{% if status_chaves %}
|
||||
<table>
|
||||
<tr>{% for mes in status_chaves.meses %}<th>{{ mes }}</th>{% endfor %}</tr>
|
||||
<tr>{% for mes, valor in status_chaves.meses.items() %}<td>{{ "✓" if valor else "—" }}</td>{% endfor %}</tr>
|
||||
</table>
|
||||
{% else %}
|
||||
<p>Nenhuma linha em Clientes_Chaves para o código {{ cliente.CODIGO }}.</p>
|
||||
{% endif %}
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,26 @@
|
||||
<!-- app/templates/cliente_form.html -->
|
||||
{% extends "base.html" %}
|
||||
{% 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">
|
||||
{% for campo, valor in dados.items() %}<input type="hidden" name="{{ campo }}" value="{{ valor }}">{% endfor %}
|
||||
<input type="hidden" name="confirmar_codigo_duplicado" value="1">
|
||||
<button type="submit">Cadastrar mesmo assim</button>
|
||||
</form>
|
||||
</div>
|
||||
{% endif %}
|
||||
{% if aviso_dv_invalido %}
|
||||
<div class="mensagem warning">O dígito verificador do documento ({{ dados.CNPJ }}) não confere — confirme se digitou certo antes de salvar.</div>
|
||||
{% endif %}
|
||||
<form method="post">
|
||||
{% for campo in campos %}
|
||||
<label for="{{ campo }}">{{ campo }}</label>
|
||||
<input type="text" id="{{ campo }}" name="{{ campo }}" value="{{ dados[campo] if dados else '' }}">
|
||||
{% endfor %}
|
||||
<button type="submit">Salvar</button>
|
||||
</form>
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,23 @@
|
||||
<!-- app/templates/clientes_lista.html -->
|
||||
{% extends "base.html" %}
|
||||
{% block titulo %}Clientes{% endblock %}
|
||||
{% block conteudo %}
|
||||
<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">
|
||||
<button type="submit">Buscar</button>
|
||||
</form>
|
||||
<p><a class="botao" href="/clientes/novo">+ Novo cliente</a></p>
|
||||
<table>
|
||||
<tr><th>Código</th><th>Razão</th><th>Fantasia</th><th>CNPJ</th><th></th></tr>
|
||||
{% for c in clientes %}
|
||||
<tr>
|
||||
<td>{{ c.CODIGO }}</td>
|
||||
<td>{{ c.RAZAO }}</td>
|
||||
<td>{{ c.FANTASIA }}</td>
|
||||
<td>{{ c.CNPJ }}</td>
|
||||
<td><a class="botao" href="/clientes/{{ c.ID }}">Abrir</a></td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</table>
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,81 @@
|
||||
"""
|
||||
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.
|
||||
"""
|
||||
from fastapi import FastAPI
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
from app.auth import exigir_login
|
||||
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)
|
||||
|
||||
|
||||
def test_listar_clientes(monkeypatch):
|
||||
monkeypatch.setattr(
|
||||
router_clientes.db_clientes,
|
||||
"listar_clientes",
|
||||
lambda busca=None, limite=100: [
|
||||
{"ID": 1, "CODIGO": "000001", "RAZAO": "Cliente Um", "FANTASIA": "Um", "CNPJ": "11222333000181"}
|
||||
],
|
||||
)
|
||||
resposta = client.get("/clientes")
|
||||
assert resposta.status_code == 200
|
||||
assert "Cliente Um" in resposta.text
|
||||
|
||||
|
||||
def test_criar_cliente_codigo_duplicado_exige_confirmacao(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) or 42
|
||||
)
|
||||
|
||||
dados_form = {campo: "000001" if campo == "CODIGO" else "x" for campo in router_clientes.db_clientes.CAMPOS_CLIENTE}
|
||||
dados_form.update(
|
||||
{
|
||||
"IMPLANTACAO": "0",
|
||||
"MENSALIDADE": "100",
|
||||
"JUROS_MORA": "0",
|
||||
"JUROS_MULTA": "0",
|
||||
"DATA_CONTRATO": "2026-01-01",
|
||||
"VENCIMENTO_CONTRATO": "2027-01-01",
|
||||
"DIA_VENCIMENTO": "10",
|
||||
"CNPJ": "11222333000181",
|
||||
}
|
||||
)
|
||||
|
||||
# Sem "confirmar_codigo_duplicado": não deve criar, deve pedir confirmação.
|
||||
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
|
||||
|
||||
# Com confirmação: cria.
|
||||
dados_form["confirmar_codigo_duplicado"] = "1"
|
||||
resposta = client.post("/clientes/novo", data=dados_form)
|
||||
assert resposta.status_code == 303
|
||||
assert criado.get("ok") is True
|
||||
|
||||
|
||||
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", follow_redirects=True)
|
||||
assert resposta.status_code == 200
|
||||
assert "tem contato" in resposta.text
|
||||
Reference in New Issue
Block a user