Elysia Tools
Navegación
Workflow Playbook
Comprueba la estructura UUID, la sintaxis de Semantic Versioning y los caracteres de un slug de URL con evidencia revisable, sin confundir formato válido con unicidad, disponibilidad o compatibilidad de lanzamiento.
Temas
Reúne los valores exactos que cruzarán una frontera del sistema: un UUID en un registro, una versión en los metadatos del paquete o un slug en una ruta. Etiqueta cada valor antes de validarlo. Una cadena parecida a una versión puede seguir una convención local distinta, por lo que el contrato del campo debe decidir la herramienta.
El validador UUID aporta observaciones sobre formato, versión y variante. El validador SemVer separa major, minor, patch, pre lanzamiento y metadatos de compilación. El validador de slug detecta problemas de caracteres, mayúsculas y separadores. Son hechos útiles, pero no sustituyen una política que prohíba UUID nulos, reserve un slug o exija un canal de lanzamiento concreto.
Guarda la entrada original y la salida del validador. Ante un fallo, muestra el problema gramatical y propone una corrección para que la apruebe su responsable; no cambies silenciosamente el identificador. Si hay una advertencia, registra si el proyecto la acepta y por qué, para que QA pueda repetir la decisión.
Un formato correcto no indica si un UUID colisiona, si un paquete o URL está registrado, si un slug resuelve o si un lanzamiento es compatible con clientes existentes. Para el impacto de versiones, continúa con api-versioning-breaking-change-review. Para rutas y canonical, consulta technical-seo-url-workflows. Los workflows validation-format y validation-validate sirven cuando la revisión incluye más familias de formato.
Acepta el registro solo cuando cada valor tenga clase, resultado del validador y decisión de política. Marca como pendientes las comprobaciones externas que aún no se hicieron. El resultado útil es una revisión sintáctica trazable y con límites claros, no una promesa de unicidad global, disponibilidad, propiedad, existencia de URL o compatibilidad de publicación.
Guía de flujo de trabajo
Prepara una tabla breve con el valor original, su clase, el campo responsable y la fuente de la política. Dirige las tres clases a sus validadores especializados y deja registro, DNS, enrutamiento y compatibilidad para sus sistemas correspondientes.
Ejecuta cada UUID en el validador UUID y conserva el resultado de formato, la versión detectada, la variante y cualquier indicación de UUID nulo. Compáralo con la política del proyecto; una estructura correcta no prueba que ningún otro sistema use el mismo valor.
Envía la versión propuesta al validador SemVer y revisa major, minor, patch, pre lanzamiento, metadatos de compilación, errores y advertencias. Trátalo como evidencia sintáctica; usa el proceso de versionado de API y lanzamiento para compatibilidad e impacto.
Usa el validador UUID para la estructura UUID con guiones, el validador SemVer para x.y.z con pre lanzamiento y metadatos de compilación opcionales, y el validador de slug para palabras minúsculas separadas por guiones. No elijas una herramienta solo porque la cadena parece un identificador.
El resultado correcto respalda una nota de sintaxis o de convención para el valor recibido. No demuestra unicidad global, existencia de un paquete o URL, propiedad del nombre ni compatibilidad con un lanzamiento.
Pasa el slug candidato por el validador de slug y anota los fallos de caracteres, mayúsculas o separadores. Antes de publicar, verifica por separado propiedad de la ruta, colisiones, redirecciones, palabras reservadas y URL destino; usa el workflow SEO técnico si corresponde.