Elysia Tools
Navegação
Workflow Playbook
Verifique a estrutura de UUID, a sintaxe de Semantic Versioning e os caracteres de um slug de URL com evidências rastreáveis, sem confundir formato válido com unicidade, disponibilidade ou compatibilidade de lançamento.
Temas
Reúna os valores exatos que atravessarão uma fronteira do sistema: um UUID em um registro, uma versão nos metadados de um pacote ou um slug em uma rota. Classifique cada valor antes da validação. Uma string que parece uma versão pode seguir uma convenção local diferente; o contrato do campo deve orientar a escolha da ferramenta.
O validador UUID fornece observações de formato, versão e variante. O validador SemVer separa major, minor, patch, pré-lançamento e metadados de build. O validador de slug encontra problemas de caracteres, caixa e separadores. Esses fatos não substituem uma política que proíba UUID nulo, reserve um slug ou exija um canal de lançamento específico.
Guarde a entrada original e a saída do validador. Em caso de falha, mostre o problema de gramática e proponha uma correção para aprovação do responsável; não reescreva o identificador em silêncio. Para um aviso, registre se o projeto o aceita e por quê, permitindo que QA repita a decisão.
Um formato válido não mostra se um UUID colide, se um pacote ou URL está registrado, se um slug resolve, ou se um lançamento é compatível com clientes existentes. Para impacto de versões, continue em api-versioning-breaking-change-review. Para rotas e canonicals, consulte technical-seo-url-workflows. Os workflows validation-format e validation-validate ajudam quando a revisão inclui outras famílias de formato.
Aceite o registro somente quando cada valor tiver classe, resultado do validador e decisão de política. Marque como pendentes as verificações externas ainda não realizadas. A entrega útil é uma revisão sintática rastreável e limitada, não uma promessa de unicidade global, disponibilidade, propriedade, existência da URL ou compatibilidade de publicação.
Guia de fluxo de trabalho
Monte uma tabela curta com o valor bruto, a classe, o campo responsável e a fonte da regra. Encaminhe as três classes aos validadores específicos e deixe registro, DNS, roteamento e compatibilidade para seus sistemas responsáveis.
Execute cada UUID no validador UUID e guarde o resultado de formato, a versão detectada, a variante e qualquer indicação de UUID nulo. Compare essas observações com a política do projeto; uma estrutura válida não prova que outro sistema não usa o mesmo valor.
Envie a versão proposta ao validador SemVer e revise major, minor, patch, pré-lançamento, metadados de build, erros e avisos. Trate isso como evidência sintática; compatibilidade e impacto da mudança pertencem ao processo de API e lançamento.
Passe o slug candidato pelo validador de slug e anote falhas de caracteres, caixa ou separadores. Antes de publicar, verifique separadamente propriedade da rota, colisões, redirecionamentos, palavras reservadas e URL de destino; use o workflow de SEO técnico quando necessário.
Use o validador UUID para a estrutura UUID com hífens, o validador SemVer para x.y.z com pré-lançamento e metadados de build opcionais, e o validador de slug para palavras minúsculas separadas por hífens. Não escolha uma ferramenta apenas pela aparência da string.
Ele sustenta uma anotação de sintaxe ou convenção para o valor recebido. Não prova unicidade global, existência de pacote ou URL, propriedade do nome, nem compatibilidade com um lançamento publicado.