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