Процес локалізації каталогу товарів

Зафіксуйте джерело до перекладу

Експортуйте каталог і збережіть незмінний знімок джерела. Запишіть його походження, час експорту та ревізію або хеш файла. Надайте кожному варіанту стабільну ідентичність і перевірте відсутні або дубльовані ідентифікатори до створення мовних завдань. Ведіть маніфест пар товар-локаль, які плануєте обробити.

Відокремте підготовку джерела від перекладу. Спочатку розв’яжіть суперечливі вимірювання, відсутні одиниці та непідтримані твердження з власником товару. Нормалізація експорту постачальника може бути потрібна; записуйте ці виправлення як зміни джерела й отримайте схвалення власника отриманої базової версії до початку мовної роботи.

Відокремте захищені факти від редагованого тексту

Створіть захищений запис для SKU, ціни, валюти, одиниці, зв’язку варіантів та інших операційних значень. Генеруйте лише текстовий патч. Під час складання копіюйте захищені значення безпосередньо з джерела й порівнюйте їх знову, щоб модель не стала авторитетом для поля, яке лише бачила як контекст.

Зробіть твердження теж відстежуваними. Схвалені твердження пов’язуйте з їхніми доказами, а етап підготовки просіть позначати все непідтримане. Наведена нижче конфігурація є ілюстративною політикою конвеєра, а не файлом, який приймає Shopify або WooCommerce. Ваш адаптер має зіставити її з фактичним контрактом призначення.

{
  "identity": ["product_id", "variant_id", "locale"],
  "protected": ["sku", "price_minor", "currency", "unit", "parent_id"],
  "editable": ["title", "description", "care_text"],
  "revisionInputs": ["source", "glossary", "prompt"],
  "releaseRequires": ["field_checks", "fact_review", "language_review"],
  "destinationWrite": "separate_authorization"
}

Додайте глосарій і бриф локалі

Бриф локалі має визначати аудиторію, тон, схвалену термінологію та правила подання. Відокремлюйте концепти товару від бажаного написання. W3C ITS визначає метадані термінології та перекладу, які можуть підживити багатшу систему локалізації; цей процес використовує простіший версіонований редакційний запис.

Розв’язуйте неоднозначні терміни прикладами з фактичної категорії. Якщо запис глосарія змінюється, визначте уражених кандидатів і вирішіть, чи потрібні їм повторна генерація або цільова правка. Кожну локаль прив’язуйте до того самого схваленого джерела. Не дозволяйте одному перекладеному варіанту стати неперевіреним проміжним джерелом для решти.

Локальний кейс: 20 товарів, 40 мовних патчів

Заморожений каталог із 20 синтетичних товарів перекладено на 20 японських і 20 німецьких патчів агентом перекладу, явно налаштованим на gpt-5.6-luna з міркуванням xhigh. Кожен патч містить лише sku, locale, title і description. Складальник копіює ціну, валюту, матеріал і розміри з source.json, тому збереження цих фактів є властивістю конвеєра, а не завданням копіювання, делегованим моделі.

Збережені validated-ja.json і validated-de.json кожен містять 20 рядків і порожній список failures. Повторне складання лише для читання збігається з обома збереженими результатами. Використовуйте цей шаблон у власній партії: зберігайте ревізію джерела, записуйте мовні патчі окремо та перевіряйте охоплення й дозволені поля до складання пакета перевірки.

Виконуйте детерміновані перевірки до редакційного рецензування

Перевіряйте схему результату, дозволені поля, мапування ідентифікаторів, ревізію джерела, потрібний текст і захищені значення. Порівнюйте кількість заповнювачів за реальною граматикою шаблонів програми. Розбирайте розмітку, а не застосовуйте загальну текстову заміну до HTML. Утримуйте неправильно сформовані записи замість прохання до імпортера виправити їх.

Для файлів перевірки електронних таблиць OWASP документує ризики ін’єкції формул і відсутність універсального безпечного перетворення CSV. Використовуйте перевірену політику експорту для вибраного інструмента таблиць, а цей артефакт тримайте окремо від машинного імпорту. Додавання префікса екранування для перегляду людиною не має випадково змінити SKU у корисному навантаженні магазину.

Прив’яжіть рішення перевірки до ревізій контенту

Надайте рецензентам факти джерела, контекст глосарія, кандидата та структуровані проблеми. Вимагайте окремих фактичного й мовного рішень. Записуйте, хто схвалив контент і які ревізії він бачив. Рецензент може прийняти локалізовану фразу, одночасно утримуючи твердження, якому потрібен доказ; запис має виражати цю відмінність.

У локальному кейсі перевірка AI виправила японський DEMO-003 з формулювання, що натякало на гофрований картон, на формулювання, узгоджене з картонною основою джерела. Також вона уточнила DEMO-010 як два держаки загалом. Початковий результат залишається в raw-ja.json. Обидві зібрані мови досі мають review_status: unreviewed і translation_semantic_review: pending: ці виправлення не є схваленням носія мови або продавця.

Зберіть і перевірте пакет призначення

Оберіть схвалених кандидатів, актуальних щодо джерела, і перетворюйте лише дозволені поля. API перекладу Shopify використовує контракт ресурсу й дайджесту; розгортання WooCommerce потребує мапування товару та, для кількох мов, перевіреного шару локалізації. Загальний пакет перевірки сам собою не є універсальним імпортом магазину.

Протестуйте невеликий авторизований імпорт у staging. Збережіть результат імпортера, прочитайте цільові поля та перевірте поведінку товару й локалі. Узгодьте запланований набір товарів зі збереженими результатами. Невдалі рядки тримайте окремо та зберігайте попередні значення для ретельно обмеженого скасування за потреби.

Запишіть результат і його межі

Завершений маніфест має пов’язувати джерело, глосарій, prompt, кандидатів, перевірки, схвалення та результати призначення. Записуйте фактичне використання для кожної спроби, де доступні докази, включно з повторами. Відсутнє використання та відсутні результати перевірки явно залишайте невідомими. Файл, який можна розібрати, не доводить, що магазин його прийняв.

Для обмеженого локального кейсу вибраною моделлю була Luna, а не Astra, і не було виклику шлюзу чи справжнього імпорту магазину. Використання API, ID запитів і платіжні дані не були доступні; model_api_usage і model_api_cost залишаються null, а не нульовими. Наступний крок — семантичне схвалення, а потім окремо авторизований тест призначення.

Поширені запитання