fix: aplica transformação de URL no campo 'url' principal

[diraol]

🐛 Problema Identificado

A feature flag REPLACE_FILE_URL_BASE não estava funcionando em produção. Os resultados da API ainda retornavam URLs completas com o domínio antigo, mesmo com a flag habilitada.

Causa Raiz

No commit #86, a função _build_file_url() foi implementada mas só estava sendo aplicada ao campo txt_url. O campo principal url continuava sendo retornado diretamente do banco de dados sem transformação.

✅ Correções Implementadas

Arquivos modificados:

• gazettes/gazette_access.py: Aplica _build_file_url() ao campo url
• themed_excerpts/themed_excerpt_access.py: Aplica _build_file_url() ao campo source_url

Comportamento após a correção:

Quando configurado com:

REPLACE_FILE_URL_BASE=true
QUERIDO_DIARIO_FILES_ENDPOINT=https://cdn.queridodiario.ok.org.br

Ambos os campos url e txt_url serão transformados:

❌ Antes: "url": "https://queridodiario.nyc3.digitaloceanspaces.com/3304557/2019/file.pdf"
✅ Depois: "url": "https://cdn.queridodiario.ok.org.br/3304557/2019/file.pdf"

🧪 Testes Adicionados

Foram criados 21 novos testes para evitar regressão:

tests/test_gazette_file_url_builder.py (13 testes)

• ✅ Caminhos relativos (dados novos)
• ✅ URLs completas com substituição de base (migração)
• ✅ URLs completas sem alteração (modo legado)
• ✅ Protocolos diversos (http://, https://, s3://)
• ✅ Edge cases (trailing slashes, case insensitive)
• ✅ Integração com _assemble_gazette_object

tests/test_themed_excerpt_file_url_builder.py (8 testes)

• ✅ Mesma cobertura para themed excerpts
• ✅ Garante ambos os campos são transformados

🔍 Validação

Ran 67 tests in 0.317s

OK (expected failures=1)

✅ Todos os 46 testes existentes + 21 novos testes passando

📝 Checklist

• Código corrigido em ambos os módulos (gazettes e themed_excerpts)
• Testes unitários abrangentes adicionados
• Todos os testes passando
• Backward compatibility mantida (modo legado funciona)
• Documentação inline nos testes

🚀 Deploy

Após o merge e deploy, a API retornará URLs com o CDN configurado em QUERIDO_DIARIO_FILES_ENDPOINT quando REPLACE_FILE_URL_BASE=true.