feat: filtro de status (ativos/inativos/todos) na rota de listagem

app/routers/clientes.py

@@ -43,6 +43,9 @@ CAMPOS_OBRIGATORIOS = ["CODIGO", "CNPJ", "RAZAO", "FANTASIA"]
 _CAMPOS_DECIMAIS_OPCIONAIS = ["IMPLANTACAO", "MENSALIDADE", "JUROS_MORA", "JUROS_MULTA"]
 _CAMPOS_DATA_OPCIONAIS = ["DATA_CONTRATO", "VENCIMENTO_CONTRATO"]
 
+FILTROS_STATUS_VALIDOS = {"ativos": 1, "inativos": 0, "todos": None}
+STATUS_PADRAO = "ativos"
+
 
 def _redirect_com_mensagem(url: str, mensagem: str, tipo: str = "success") -> RedirectResponse:
     separador = "&" if "?" in url else "?"
@@ -164,6 +167,7 @@ def listar(
     direcao: str = db_clientes.DIRECAO_PADRAO,
     pagina: int = 1,
     por_pagina: Optional[int] = None,
+    status: str = STATUS_PADRAO,
     mensagem: Optional[str] = None,
     mensagem_tipo: Optional[str] = None,
     usuario: str = Depends(exigir_login),
@@ -172,17 +176,21 @@ def listar(
         ordenar_por = db_clientes.ORDENACAO_PADRAO
     if direcao not in db_clientes.DIRECOES_VALIDAS:
         direcao = db_clientes.DIRECAO_PADRAO
+    if status not in FILTROS_STATUS_VALIDOS:
+        status = STATUS_PADRAO
+    filtro_ativo = FILTROS_STATUS_VALIDOS[status]
 
     por_pagina_efetivo = _resolver_por_pagina(por_pagina, request.cookies.get(POR_PAGINA_COOKIE))
 
     pagina = max(pagina, 1)
-    total = db_clientes.contar_clientes(busca=busca or None, ordenar_por=ordenar_por)
+    total = db_clientes.contar_clientes(busca=busca or None, ordenar_por=ordenar_por, filtro_ativo=filtro_ativo)
     total_paginas = max(math.ceil(total / por_pagina_efetivo), 1)
     pagina = min(pagina, total_paginas)
     offset = (pagina - 1) * por_pagina_efetivo
 
     clientes = db_clientes.listar_clientes(
-        busca=busca or None, limite=por_pagina_efetivo, offset=offset, ordenar_por=ordenar_por, direcao=direcao
+        busca=busca or None, limite=por_pagina_efetivo, offset=offset, ordenar_por=ordenar_por,
+        direcao=direcao, filtro_ativo=filtro_ativo,
     )
 
     primeiro_item = offset + 1 if total > 0 else 0
@@ -193,7 +201,7 @@ def listar(
         "clientes_lista.html",
         {
             "clientes": clientes, "busca": busca, "ordenar_por": ordenar_por, "direcao": direcao,
-            "mensagem": mensagem, "mensagem_tipo": mensagem_tipo,
+            "mensagem": mensagem, "mensagem_tipo": mensagem_tipo, "status": status,
             "pagina": pagina, "total_paginas": total_paginas, "total": total,
             "por_pagina": por_pagina_efetivo, "opcoes_por_pagina": OPCOES_POR_PAGINA,
             "primeiro_item": primeiro_item, "ultimo_item": ultimo_item,
@@ -216,6 +224,7 @@ def listar(
 def form_novo(request: Request, usuario: str = Depends(exigir_login)):
     dados = {c: "" for c in db_clientes.CAMPOS_CLIENTE}
     dados["CODIGO"] = db_clientes.proximo_codigo_sugerido()
+    dados["ATIVO"] = "1"
     return templates.TemplateResponse(
         request,
         "cliente_form.html",