Define a formatação visível ao usuário, seleção de idioma, fallback, comportamento de conteúdo e casos extremos regionais para o fluxo de trabalho de tradução. Corrige limites de adoção e evidências observáveis de falha, mantendo os limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não há garantia de que uma implementação adotante os tenha aprovado.
Decisão
Para o fluxo de trabalho de tradução, adote dados canônicos neutros de localidade mais localidade explícita de apresentação. Defina uma jornada do usuário determinística com estado visível, escolhas reversíveis quando possível, entrada preservada e recuperação acessível. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais com base em evidências do seu próprio ambiente.
Escopo
- Os atores, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de UX do fluxo de trabalho de tradução.
- Interfaces primárias e alternativas, trabalho em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercer o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Alegar que os cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou acessibilidade.
Contrato
- Persistir valores canônicos e chaves de tradução estáveis; aplicar formatação específica de localidade apenas nas fronteiras de apresentação ou geração de documentos.
- Resolver localidades solicitadas, do usuário, da organização e de fallback do produto por meio de uma cadeia determinística e observável.
- Usar tags de idioma e dados de localidade de padrões mantidos; não inferir idioma, região, moeda ou termos legais uns dos outros.
- Testar expansão, categorias plurais, texto bidirecional, recursos ausentes, fusos horários, moedas e entrada não latina com fixtures representativos.
- Mostrar progresso somente enquanto o trabalho estiver realmente pendente e evitar ativação duplicada sem ocultar a intenção comprometida do usuário.
- Usar mensagens simples e específicas para ação que distingam validação, permissão, conectividade, conflito e falha terminal.
- Rastrear versão da fonte, localidade, tradutor, status da revisão, espaços reservados, capturas de tela ou contexto e elegibilidade para lançamento de cada recurso.
- Mudanças na fonte marcam traduções afetadas como obsoletas; tradução automatizada permanece visivelmente não revisada até que a política declarada a aceite.
Orientações para implementação
- Prototipar os caminhos mais longos, vazios, lentos, offline, negados e com tecnologia assistiva antes de fixar o layout do caminho feliz.
- Modelar entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências do fluxo de trabalho de tradução antes de selecionar detalhes de framework ou fornecedor.
- Armazenar a versão aplicável do contrato ou política do fluxo de trabalho de tradução com estado material para que migrações, reprodução e decisões de suporte permaneçam atribuíveis.
- Introduzir o caminho por trás de implantação controlada, comparar resultados esperados e observados e manter uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Um recurso ausente ou inválido segue a cadeia de fallback declarada, registra a chave e localidade com segurança e nunca expõe um identificador interno como cópia final.
- Estado inválido ou contraditório do fluxo de trabalho de tradução é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após esgotamento, o trabalho alcança um estado terminal inspecionável com um responsável contabilizável.
Verificação e operações
- Completar a jornada com teclado, toque, leitor de tela, viewport estreito, rede com atraso e erro de servidor recuperável.
- Monitorar sucesso, negação, falha de validação, falha de dependência, esgotamento de retentativas e recuperação do fluxo de trabalho de tradução por versão do contrato sem dimensões sensíveis do payload.
- Reexecutar fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preservar a evidência resultante.
Suposições de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidência documentada e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudança.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório de destino antes de registrar evidência de implementação.