feat: cabecalhos clicaveis para ordenar (crescente/decrescente) a lista de clientes

Codigo, Razao, Fantasia e CNPJ agora sao links no cabecalho da tabela:
clicar ordena crescente; clicar de novo na mesma coluna alterna pra
decrescente (e vice-versa). Trocar de coluna sempre comeca em
crescente. Seta (▲/▼) indica a coluna/direcao ativa.

db_clientes.listar_clientes() ganha o parametro direcao (whitelist
asc/desc, igual ja acontecia com ordenar_por). Links de
Anterior/Proxima da paginacao preservam a direcao escolhida.

97/97 testes passando.

tests/test_router_clientes.py

@@ -57,7 +57,7 @@ def test_listar_clientes(monkeypatch):
     monkeypatch.setattr(
         router_clientes.db_clientes,
         "listar_clientes",
-        lambda busca=None, limite=100, offset=0, ordenar_por="razao": [
+        lambda busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc": [
             {"ID": 1, "CODIGO": "000001", "RAZAO": "Cliente Um", "FANTASIA": "Um", "CNPJ": "11222333000181"}
         ],
     )
@@ -71,7 +71,7 @@ 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": [
+        lambda busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc": [
             {"ID": i, "CODIGO": f"{i:06d}", "RAZAO": f"Cliente {i}", "FANTASIA": f"C{i}", "CNPJ": "11222333000181"}
             for i in range(1, 6)
         ],
@@ -89,7 +89,7 @@ def test_listar_clientes_pagina_com_controles_de_paginacao(monkeypatch):
 def test_listar_clientes_ordenar_por_invalido_cai_no_padrao(monkeypatch):
     capturado = {}
 
-    def _listar_clientes(busca=None, limite=100, offset=0, ordenar_por="razao"):
+    def _listar_clientes(busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc"):
         capturado["ordenar_por"] = ordenar_por
         return []
 
@@ -103,6 +103,43 @@ def test_listar_clientes_ordenar_por_invalido_cai_no_padrao(monkeypatch):
     assert capturado["ordenar_por"] == "codigo"
 
 
+def test_cabecalhos_da_lista_alternam_direcao(monkeypatch):
+    monkeypatch.setattr(
+        router_clientes.db_clientes, "listar_clientes", lambda **kwargs: []
+    )
+    monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 0)
+
+    # Sem ordenar_por/direcao na URL: padrão é razao/asc. Clicar de novo em
+    # "Razão" deve levar pra desc; clicar em "Código" (coluna diferente da
+    # atual) deve levar pra asc (não continua o desc de outra coluna).
+    resposta = client.get("/clientes")
+    assert 'ordenar_por=razao&direcao=desc' in resposta.text
+    assert 'ordenar_por=codigo&direcao=asc' in resposta.text
+
+    # Já ordenado por codigo/desc: clicar em "Código" de novo deve voltar pra asc.
+    resposta = client.get("/clientes?ordenar_por=codigo&direcao=desc")
+    assert 'ordenar_por=codigo&direcao=asc' in resposta.text
+    # E as outras colunas oferecem asc (primeira vez que seriam clicadas).
+    assert 'ordenar_por=razao&direcao=asc' in resposta.text
+
+
+def test_listar_clientes_direcao_invalida_cai_no_padrao(monkeypatch):
+    capturado = {}
+
+    def _listar_clientes(busca=None, limite=100, offset=0, ordenar_por="razao", direcao="asc"):
+        capturado["direcao"] = direcao
+        return []
+
+    monkeypatch.setattr(router_clientes.db_clientes, "listar_clientes", _listar_clientes)
+    monkeypatch.setattr(router_clientes.db_clientes, "contar_clientes", lambda busca=None, ordenar_por="razao": 0)
+
+    client.get("/clientes?direcao=coisa_invalida")
+    assert capturado["direcao"] == "asc"
+
+    client.get("/clientes?direcao=desc")
+    assert capturado["direcao"] == "desc"
+
+
 def test_form_novo_preenche_codigo_sugerido(monkeypatch):
     monkeypatch.setattr(router_clientes.db_clientes, "proximo_codigo_sugerido", lambda: "000243")
     resposta = client.get("/clientes/novo")