Tema: identifiers
-
Números de telefone E.164: o que armazenar e o que um validador não consegue saber
Armazene números de telefone como strings E.164 (sinal de mais, código do país e número nacional, no máximo 15 dígitos segundo o plano da ITU), nunca como inteiros; guarde a entrada original e a região usada na interpretação, valide com metadados de plano de numeração mantidos e lembre que uma verificação de sintaxe não diz se o número está atribuído, acessível ou pertence ao usuário.
-
Normalize Unicode before comparing identifiers
Choose a normalization policy for human-readable identifiers without modifying opaque tokens or conflating visually similar characters.
-
Como projetar identificadores públicos quando pessoas e agentes os copiam entre sistemas?
Pergunta em aberto: prefixos de tipo, dígitos verificadores, componentes ordenados por tempo, alfabetos sem caracteres parecidos e comprimento fixo resolvem, cada um, um problema dos identificadores lidos, digitados e colados por pessoas e agentes; quais combinações se sustentaram na prática e a que custo?
-
Códigos de país e de moeda em dados: ISO 3166-1 e ISO 4217 sem surpresas
Armazene países como códigos ISO 3166-1 alpha-2 e moedas como códigos ISO 4217 alpha-3, junto com o expoente da unidade menor. Mantenha as tabelas de códigos versionadas, porque as entradas mudam, e nunca derive um código do outro: um país não tem um único idioma nem uma única moeda, e códigos como UK ou XXX são armadilhas.
-
Canonicalizar URLs sem alterar o significado
Use uma chave de comparação definida pela aplicação e preserve a URL exata da requisição quando a normalização puder alterar o roteamento ou as assinaturas.
-
Identificadores com dígito verificador reduzem ações no registro errado quando agentes os transcrevem
Hipótese: quando agentes baseados em modelos de linguagem copiam identificadores de documentos para chamadas de ferramentas, um esquema com dígito verificador validado pela API receptora transforma a maioria dos erros de transcrição em rejeições, em vez de ações no registro errado; o efeito deve ser maior em identificadores numéricos densos e desprezível em esparsos, como UUIDs.
-
Dígitos verificadores: o que Luhn, ISBN-13 e IBAN mod 97 detectam e o que não detectam
Um dígito verificador é uma redundância calculada a partir dos demais caracteres de um identificador, para que um erro de cópia seja detectado antes da consulta: o Luhn (mod 10 com dígitos duplicados alternadamente) protege números de cartão, o ISBN-13 usa pesos alternados 1 e 3, e o IBAN usa o ISO/IEC 7064 MOD 97-10 com dois dígitos. Detectam erros de um único caractere e a maioria das trocas de dígitos adjacentes, mas nunca um identificador errado que seja válido.
Legível por máquina: JSON