Определяет структуру ресурсов, API, хранилище, инструменты, матрицу тестирования и проверки релиза для рабочего процесса перевода. Этот эталон фиксирует границы принятия, поведение при сбоях и наблюдаемые доказательства, оставляя при этом конфигурацию ограничений, специфичных для среды.
Статус пакета: эталонный контекст готов для проверки человеком. Контракт и сценарии тестирования завершены, но не заявляется, что внедряющая реализация их прошла.
Решение
Для рабочего процесса перевода принять канонические данные, нейтральные к локали, плюс явную локаль представления. Реализовать поведение через один авторитетный путь записи, типизированные интерфейсы, явное состояние и идемпотентную обработку побочных эффектов. Этот пакет является эталонным контрактом: внедряющая команда должна выбрать числовые ограничения, провайдеров, юрисдикции и операционных владельцев на основе данных из собственной среды.
Область применения
- Акторы рабочего процесса перевода, входные данные, выходные данные, состояния, версии политики или схемы и внешне видимые результаты, описанные в этом блоке реализации.
- Основные и альтернативные интерфейсы, фоновые задачи, кэши, интеграции, вспомогательные пути и доказательства, которые могут задействовать ту же границу.
- Конфигурация, специфичная для внедрения, развертывания, восстановления и проверки, необходимая для безопасного применения эталона.
Вне этого блока
- Выбор универсального поставщика, фреймворка, юрисдикции, числового порога, периода хранения или целевого уровня сервиса для каждого внедряющего.
- Утверждение, что упакованные сценарии были выполнены на нижестоящей реализации или что этот эталон предоставляет юридическую, безопасность или сертификацию доступности.
Контракт
- Сохранять канонические значения и стабильные ключи перевода; применять локально-специфичное форматирование только на границах представления или генерации документов.
- Разрешать запрошенные, пользовательские, организационные и продуктовые локали с помощью одного детерминированного, наблюдаемого цепочного процесса.
- Использовать языковые теги и данные локали из поддерживаемых стандартов; не выводить язык, регион, валюту или юридические условия друг из друга.
- Тестировать расширение, категории множественного числа, двунаправленный текст, отсутствующие ресурсы, часовые пояса, валюты и ввод на нелатинице с помощью репрезентативных фикстур.
- Валидировать входные данные один раз на границе и сохранять нормализованное представление, используемое последующей логикой.
- Сохранять бизнес-переход до или атомарно с записью в исходящем журнале; потребители устраняют дублирование по устойчивому идентификатору операции.
- Отслеживать версию источника, локаль, переводчика, статус проверки, заполнители, скриншоты или контекст и пригодность к выпуску для каждого ресурса.
- Изменения источника помечают затронутые переводы как устаревшие; автоматический перевод остается явно непроверенным, пока не будет принята объявленная политика.
Руководство по реализации
- Сначала выпускать добавочные изменения в хранилище и интерфейсах, заполнять наблюдаемым образом, затем выводить из эксплуатации старые пути после подтверждения совместимости.
- Моделировать входы, выходы, акторов, состояния, инварианты, побочные эффекты и доказательства рабочего процесса перевода до выбора деталей фреймворка или поставщика.
- Хранить применимую версию контракта или политики рабочего процесса перевода вместе с материальным состоянием, чтобы миграции, воспроизведение и решения поддержки оставались атрибутируемыми.
- Вводить путь через контролируемое развертывание, сравнивать ожидаемые и наблюдаемые результаты и сохранять проверенный маршрут восстановления до завершения подтверждения внедрения.
Обработка сбоев и меры предосторожности
- Отсутствующий или недействительный ресурс следует объявленной цепочке резервных вариантов, безопасно записывает ключ и локаль и никогда не раскрывает внутренний идентификатор как окончательный текст.
- Недопустимое или противоречивое состояние рабочего процесса перевода отклоняется или помещается в карантин; реализация никогда не угадывает значение, расширяющее полномочия или дублирующее эффект.
- Повторы ограничены и используют устойчивый идентификатор; после исчерпания попыток работа достигает инспектируемого конечного состояния с ответственным владельцем.
Проверка и эксплуатация
- Внедрять сбой зависимости до и после сохранения и доказывать, что повтор приводит к одному внешне видимому результату.
- Мониторить успех, отказ, ошибку валидации, сбой зависимости, исчерпание повторов и восстановление рабочего процесса перевода по версии контракта без чувствительных параметров полезной нагрузки.
- Повторно запускать парные положительные и отрицательные фикстуры после изменений политики, схемы, зависимости, миграции или границ и сохранять полученные доказательства.
Предположения внедрения
- Имена и значения в примере — это конкретная фикстура, а не универсальные значения по умолчанию; внедряющие заменяют их через документированные доказательства и владение.
- Внедряющая система может предоставить аутентифицированную идентичность, устойчивые версии операций или записей, ограниченную телеметрию и контролируемый путь для изменений.
Примеры, выглядящие как исполняемые, в этом пакете являются фикстурами и контрактами приемки. Запустите валидатор коллекции для проверки структуры и метаданных, затем переведите и выполните сценарии в целевом репозитории перед фиксацией доказательств реализации.