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.
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.
- A exigência é de capacidade, não de artefato: o documento tem de poder sair em qualquer um dos três idiomas.
- O que se vê antes de enviar tem de ser o que se manda.
- Metade do conteúdo é cadastrado no banco, não está em código.
- 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.