Pular para o conteúdo
← Todas as decisões

ADR-024

Proposta gerada sob demanda no idioma escolhido, sem infraestrutura de tradução

Metade do conteúdo da proposta é cadastrado no banco, então localização por arquivos de recurso resolveria metade do problema com infraestrutura inteira. A distinção que decidiu: capacidade não é artefato.

Trilha Ciclo de proposta e cotação, 4ª de 4.

Status
Aceita
Decidida em
11/08/2026
Publicada em
Sistema
plataforma B2B de funil comercial e propostas

Contexto

O público é internacional, e o documento de proposta precisa existir em português, inglês e espanhol. O gerador de PDF tinha rótulos fixos em português no código e cultura de formatação travada em pt-BR. Não havia nenhuma infraestrutura de tradução: nem arquivos de recurso, nem localizador, nem internacionalização no frontend. O único vestígio bilíngue era uma coluna de descrição em inglês num catálogo, que o PDF sequer usava.

Critérios que pesaram

Em ordem de peso.

  1. A exigência é de capacidade, não de artefato: o documento tem de poder sair em qualquer um dos três idiomas.
  2. O que se vê antes de enviar tem de ser o que se manda.
  3. Metade do conteúdo é cadastrado no banco, não está em código.
  4. Adoção incremental: nenhum cadastro existente pode quebrar por não ter tradução.

Opções consideradas

  • Gerar sempre os três PDFs a cada envio: arquivaria todas as versões, e triplicaria tempo de geração e armazenamento para usar uma; as outras duas nascem mortas. Descartada.
  • Localização padrão da plataforma, com arquivos de recurso. É o caminho idiomático, e cobre só os rótulos fixos: o conteúdo cadastrado no banco, que é metade do problema, continuaria sem tradução. Descartada por resolver metade do problema com infraestrutura inteira.
  • Gerar sob demanda no idioma escolhido, com pré-visualização pelo mesmo caminho de código.

Decisão

O idioma é escolhido no momento do envio e o PDF é gerado só naquele idioma. Os rótulos fixos saíram do gerador para um dicionário de idioma e chave, e a cultura de formatação (moeda e data) passou a acompanhar o idioma escolhido em vez de ser fixa. O conteúdo cadastrado ganhou colunas de descrição por idioma nos catálogos e no template de contrato, com fallback para português quando a tradução está vazia: nenhum cadastro existente quebra, e a adoção é incremental. Há um endpoint de pré-visualização que devolve o PDF pelo mesmo caminho de geração do envio, então o que o vendedor vê é literalmente o que o cliente recebe. O idioma efetivamente enviado fica gravado na cotação, e é ele que define o idioma da página pública de aprovação.

Consequências

As duas metades pesam igual.

Melhorou

Clientes internacionais passaram a receber o documento no idioma deles sem que o sistema ganhasse uma camada de internacionalização. E o compartilhamento do caminho de geração entre pré-visualização e envio torna impossível, por construção, a divergência entre o que se revisa e o que se manda.

Piorou

As versões não enviadas não ficam arquivadas, o que ninguém pediu, mas é uma escolha que fecha porta. E a qualidade da proposta em outro idioma passou a depender de alguém preencher os catálogos: o fallback para português é seguro do ponto de vista técnico e produz um documento misturado quando a tradução está pela metade. Isso ficou registrado explicitamente como risco assumido: tradução é trabalho contínuo, e os catálogos nasceram vazios.

Revisitando hoje

Ainda de pé em set/2026. A distinção que resolveu a decisão, capacidade contra artefato, é a parte que eu levaria para qualquer discussão parecida: "precisamos ter as três versões" quase nunca significa "precisamos materializar três arquivos", e confundir as duas coisas triplica custo por nada.

Quarto de doze registros sobre o ciclo de proposta. Os anteriores trataram do caminho do documento; este trata do idioma em que ele sai.

PDF internacionalização modelagem de domínio

Receba o resumo da semana

Um e-mail por semana com o que foi publicado. Sem spam, e você sai quando quiser.

Blog do Felipe Marciano

Decisões de arquitetura, .NET e sistemas distribuídos, escritas por quem vive com as consequências delas.

© 2026 Felipe Marciano. Todos os direitos reservados. · v1.54.0