Elysia Tools
Навигация
Workflow Playbook
Проверьте структуру UUID, синтаксис Semantic Versioning и символы URL-slug с сохраняемыми доказательствами, не выдавая корректный формат за глобальную уникальность, доступность или совместимость релиза.
Темы
Соберите точные значения, которые пересекают границу системы: UUID в записи, версию в метаданных пакета или slug в маршруте. До проверки назначьте каждому значению класс. Строка, похожая на версию, может следовать локальному соглашению, поэтому инструмент должен определяться контрактом поля.
Валидатор UUID дает наблюдения о формате, версии и варианте. Валидатор SemVer разбирает major, minor, patch, предварительный релиз и метаданные сборки. Валидатор slug обнаруживает проблемы символов, регистра и разделителей. Эти сведения не заменяют политику проекта, которая может запрещать Nil UUID, резервировать slug или требовать конкретный канал релиза.
Храните исходный ввод и вывод валидатора. При ошибке покажите грамматическую проблему и предложите исправление на утверждение владельцу; не изменяйте идентификатор молча. Для предупреждения зафиксируйте, принято ли оно проектом и почему, чтобы QA мог повторить решение.
Корректный формат не показывает коллизию UUID, регистрацию пакета или URL, разрешение slug и совместимость релиза с существующими клиентами. Для анализа версий продолжите в api-versioning-breaking-change-review. Для маршрутов и canonical обратитесь к technical-seo-url-workflows. Workflow validation-format и validation-validate пригодятся при расширении проверки на другие форматы.
Принимайте запись только тогда, когда у каждого значения есть класс, результат валидатора и решение по политике. Внешние проверки, которые еще не выполнялись, отмечайте как ожидающие. Полезный результат — трассируемая проверка синтаксиса с четкими ограничениями, а не обещание глобальной уникальности, доступности, владения, существования URL или совместимости публикации.
Руководство по рабочему процессу
Создайте короткую таблицу с исходным значением, классом, ответственным полем и источником правила. Направьте три класса в специализированные валидаторы, а проверки реестра, DNS, маршрутизации и совместимости оставьте соответствующим системам.
Пропустите каждый UUID через валидатор UUID и сохраните результат формата, определенную версию, вариант и возможный признак Nil UUID. Сопоставьте наблюдения с политикой проекта; корректная структура не означает, что другое хранилище не использует то же значение.
Передайте предлагаемую версию валидатору SemVer и проверьте major, minor, patch, предварительный релиз, метаданные сборки, ошибки и предупреждения. Считайте это синтаксическим свидетельством; совместимость и влияние изменений проверяются в процессе API и релиза.
Проверьте кандидат через валидатор slug и зафиксируйте ошибки символов, регистра или разделителей. Перед публикацией отдельно проверьте владельца маршрута, коллизии, перенаправления, зарезервированные слова и целевой URL; при необходимости используйте workflow технического SEO.
Используйте валидатор UUID для структуры UUID с дефисами, валидатор SemVer для x.y.z с необязательными предварительным релизом и метаданными сборки, а валидатор slug для строчных URL-слов с дефисами. Не выбирайте инструмент только по внешнему виду строки.
Успешный результат подтверждает синтаксис или соглашение для переданного значения. Он не доказывает глобальную уникальность, существование пакета или URL, право владения именем или совместимость с опубликованным релизом.