feat: GET /clientes le por_pagina da query/cookie e expoe contexto de paginacao

app/routers/clientes.py

@@ -165,6 +165,7 @@ def listar(
     ordenar_por: str = db_clientes.ORDENACAO_PADRAO,
     direcao: str = db_clientes.DIRECAO_PADRAO,
     pagina: int = 1,
+    por_pagina: Optional[int] = None,
     mensagem: Optional[str] = None,
     mensagem_tipo: Optional[str] = None,
     usuario: str = Depends(exigir_login),
@@ -174,24 +175,42 @@ def listar(
     if direcao not in db_clientes.DIRECOES_VALIDAS:
         direcao = db_clientes.DIRECAO_PADRAO
 
+    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_paginas = max(math.ceil(total / TAMANHO_PAGINA), 1)
+    total_paginas = max(math.ceil(total / por_pagina_efetivo), 1)
     pagina = min(pagina, total_paginas)
-    offset = (pagina - 1) * TAMANHO_PAGINA
+    offset = (pagina - 1) * por_pagina_efetivo
 
     clientes = db_clientes.listar_clientes(
-        busca=busca or None, limite=TAMANHO_PAGINA, offset=offset, ordenar_por=ordenar_por, direcao=direcao
+        busca=busca or None, limite=por_pagina_efetivo, offset=offset, ordenar_por=ordenar_por, direcao=direcao
     )
-    return templates.TemplateResponse(
+
+    primeiro_item = offset + 1 if total > 0 else 0
+    ultimo_item = min(offset + por_pagina_efetivo, total)
+
+    resposta = templates.TemplateResponse(
         request,
         "clientes_lista.html",
         {
             "clientes": clientes, "busca": busca, "ordenar_por": ordenar_por, "direcao": direcao,
             "mensagem": mensagem, "mensagem_tipo": mensagem_tipo,
             "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,
+            "janela_paginas": _janela_paginas(pagina, total_paginas),
         },
     )
+    if por_pagina in OPCOES_POR_PAGINA:
+        # Só regrava o cookie quando a query string trouxer um valor válido
+        # (não um valor herdado do cookie que já estava lá) — evita ficar
+        # reescrevendo o mesmo Set-Cookie em toda requisição à toa.
+        resposta.set_cookie(
+            POR_PAGINA_COOKIE, str(por_pagina), samesite="lax",
+            secure=request.url.scheme == "https",
+        )
+    return resposta
 
 
 @router.get("/novo", response_class=HTMLResponse)