Ürün kataloğu yerelleştirme iş akışı
Updated 2026-09-05
Metin yamaları üretin, ürün gerçeklerini kodda koruyun, sonra anlamı inceleyin. Yerel 20 ürünlük vaka, yapısal olarak geçerli 40 dil taslağının yine de düzeltme gerektirebileceğini gösterir.
Çeviri öncesinde kaynağı dondurun
Kataloğu dışa aktarın ve değişmez bir kaynak görüntüsü koruyun. Kökenini, dışa aktarma zamanını ve revizyonu veya dosya hash'ini kaydedin. Dil işleri oluşturmadan önce her varyanta kararlı bir kimlik verin ve eksik ya da yinelenen tanımlayıcıları kontrol edin. İşlemek istediğiniz ürün-locale çiftlerinin manifestini tutun.
Kaynak hazırlığını çeviriden ayırın. Çelişkili ölçüleri, eksik birimleri ve desteklenmeyen iddiaları önce ürün sahibiyle çözün. Tedarikçi dışa aktarmasını normalleştirmek gerekebilir; bu düzeltmeleri kaynak değişikliği olarak kaydedin ve dil çalışması başlamadan önce sahibin ortaya çıkan tabanı onaylamasını sağlayın.
Korunan gerçekleri düzenlenebilir metinden ayırın
SKU, fiyat, para birimi, birim, varyant ilişkisi ve diğer operasyonel değerler için korunan bir kayıt oluşturun. Yalnızca metin yaması üretin. Birleştirme sırasında korunan değerleri doğrudan kaynaktan kopyalayın ve tekrar karşılaştırın; model bağlam olarak gördüğü alanın otoritesi hâline gelmesin.
İddiaları da izlenebilir yapın. Onaylı önermeleri kanıtlarına bağlayın ve taslak adımına desteklenmeyen her şeyi işaretlemesini söyleyin. Aşağıdaki yapılandırma örnek bir hat politikasıdır, Shopify veya WooCommerce tarafından kabul edilen bir dosya değildir. Bağdaştırıcınız bunu gerçek hedef sözleşmesine eşlemelidir.
{
"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"
}Sözlük ve locale özeti ekleyin
Bir locale özeti kitleyi, tonu, onaylı terminolojiyi ve sunum kurallarını tanımlamalıdır. Ürün kavramlarını tercih edilen yazımlardan ayrı tutun. W3C ITS, daha zengin bir yerelleştirme sistemine bilgi verebilecek terminoloji ve çeviri üst verisini tanımlar; bu iş akışı daha basit sürümlenmiş bir editoryal kayıt kullanır.
Belirsiz terimleri gerçek kategoriden örneklerle çözün. Bir sözlük girdisi değişirse etkilenen adayları belirleyin ve yeniden üretim mi yoksa hedefli düzenleme mi gerektiğine karar verin. Her locale'i aynı onaylı kaynağa bağlayın. Bir çevrilmiş sürümün geri kalan için incelenmemiş ara kaynak hâline gelmesine izin vermeyin.
Yerel vaka: 20 ürün, 40 dil yaması
20 sentetik üründen oluşan dondurulmuş katalog, xhigh akıl yürütmeyle açıkça gpt-5.6-luna için yapılandırılmış bir çeviri ajanı tarafından 20 Japonca ve 20 Almanca yamaya çevrildi. Her yama yalnızca sku, locale, title ve description içerir. Birleştirici price, currency, material ve dimensions değerlerini source.json'dan kopyalar; bu nedenle gerçekleri korumak modele devredilmiş bir kopyalama değil, hattın özelliğidir.
Kaydedilen validated-ja.json ve validated-de.json dosyalarının her biri 20 satır ve boş failures listesi içerir. Salt okunur yeniden birleştirme iki kaydedilmiş çıktıyla da eşleşir. Kendi grubunuzda bu deseni kullanın: kaynak revizyonunu koruyun, dil yamalarını ayrı kaydedin ve inceleme paketini oluşturmadan önce kapsamı ve izin verilen alanları doğrulayın.

| Vaka varlığı | Kaydedilen sonuç | İnceleme durumu |
|---|---|---|
| source.json | 20 sentetik ürün; dondurulmuş revizyon | Yetkili fikstür gerçekleri |
| validated-ja.json | 20 birleştirilmiş satır; 0 yapısal hata | Anlamsal inceleme beklemede |
| validated-de.json | 20 birleştirilmiş satır; 0 yapısal hata | Anlamsal inceleme beklemede |
| raw-ja.json | Özgün Japonca yamalar korundu | İki yapay zekâ inceleme düzeltmesinden önce |
Editoryal incelemeden önce deterministik kontroller çalıştırın
Çıktı şemasını, izin verilen alanları, tanımlayıcı eşlemesini, kaynak revizyonunu, gerekli metni ve korunan değerleri doğrulayın. Yer tutucu sayılarını uygulamanın gerçek şablon grameriyle karşılaştırın. Genel bir metin değiştirmesi uygulamak yerine HTML işaretlemesini ayrıştırın. Hatalı kayıtları içe aktarıcıdan düzeltmesini istemek yerine bekletin.
Elektronik tablo inceleme dosyalarında OWASP formül enjeksiyonu risklerini ve evrensel güvenli CSV dönüşümünün olmadığını belgeler. Seçilen elektronik tablo aracı için incelenmiş bir dışa aktarma politikası kullanın ve bu varlığı makine içe aktarmasından ayrı tutun. İnsan görüntülemesi için kaçış ön eki eklemek mağaza yükündeki SKU'yu yanlışlıkla değiştirmemelidir.
İnceleme kararlarını içerik revizyonlarına bağlayın
İnceleyenlere kaynak gerçeklerini, sözlük bağlamını, adayı ve yapılandırılmış sorunları verin. Olgusal ve dil kararlarını ayrı isteyin. İçeriği kimin onayladığını ve hangi revizyonları gördüğünü kaydedin. Bir inceleyen yerelleştirilmiş ifadeyi kabul ederken kanıt gerektiren bir iddiayı bekletebilir; kayıt bu ayrımı göstermelidir.
Yerel vakada yapay zekâ incelemesi Japonca DEMO-003'ü oluklu kartonu ima eden ifadeden kaynağın karton arkalığıyla tutarlı ifadeye düzeltti. Ayrıca DEMO-010'u toplam iki sap anlamına gelecek şekilde netleştirdi. Özgün çıktı raw-ja.json içinde durur. Birleştirilen iki dil hâlâ review_status: unreviewed ve translation_semantic_review: pending taşır: bu düzeltmeler ana dili konuşan veya satıcı onayı değildir.
| Varlık | Amaç | Tanımlaması gereken |
|---|---|---|
| Kaynak görüntüsü | Yetkili girdi | Ürün ve kaynak revizyonu |
| Aday kaydı | Önerilen yerelleştirilmiş metin | Locale, deneme ve sözlük |
| İnceleme kararı | Bu adayı kullanma izni | İnceleyen ve içerik revizyonu |
| İçe aktarma paketi | Asgari onaylı hedef yaması | Bağdaştırıcı ve hedef alanlar |
| Geri okuma raporu | Gözlemlenen saklanmış sonuç | Hedef kimlikleri ve farklar |
Hedef paketini birleştirin ve doğrulayın
Onaylı ve kaynak güncel adayları seçin, yalnızca izin verilen alanlarını dönüştürün. Shopify'ın çeviri API'si kaynak ve digest sözleşmesini kullanır; WooCommerce kurulumu ürün eşlemesini ve birden fazla dil için doğrulanmış yerelleştirme katmanını gerektirir. Genel inceleme paketi evrensel mağaza içe aktarması değildir.
Hazırlıkta küçük bir yetkili içe aktarmayı test edin. İçe aktarıcı sonucunu kaydedin, hedef alanları geri okuyun ve ürün ile locale davranışını inceleyin. Planlanan ürün kümesini saklanan sonuçlarla uzlaştırın. Başarısız satırları ayrı tutun ve gerekirse dikkatle sınırlı bir geri dönüş için önceki değerleri koruyun.
Sonucu ve sınırlarını kaydedin
Tamamlanan manifest kaynağı, sözlüğü, istemleri, adayları, kontrolleri, onayları ve hedef sonuçlarını bağlamalıdır. Kanıt bulunan her deneme için yeniden denemeler dahil gerçek kullanımı kaydedin. Eksik kullanımı ve eksik inceleme sonuçlarını açıkça bilinmiyor tutun. Ayrıştırılabilen dosya mağazanın onu kabul ettiğinin kanıtı değildir.
Sınırlı yerel vakada seçilen model Astra değil Luna'ydı ve ağ geçidi çağrısı veya gerçek mağaza içe aktarması yoktu. API kullanımı, istek kimlikleri ve faturalandırma açığa çıkmadı; model_api_usage ve model_api_cost sıfır değil null kaldı. Sonraki adım anlamsal onay, ardından ayrı yetkilendirilmiş hedef testidir.
Sık sorulan sorular
En küçük yararlı hat varlığı nedir?
Bir ürün-locale çifti için adaya, doğrulama sonucuna ve inceleme kararına bağlanan kaynak görüntüsü. Bu kayıt daha sonra doğrulanmış bir hedef yamasına eşlenebilir.
Kaynak fiyatları modelden geçirilmeli mi?
Yalnızca gereken bağlamı dahil edin. Yetkili fiyatları düzenlenebilir çıktının dışında tutun ve onları içeren kayıtları birleştirirken doğrudan kaynaktan kopyalayın.
Yinelenen çevirileri nasıl önlerim?
Kaynak, sözlük ve istem revizyonları olan kararlı bir ürün-locale kimliği kullanın. Yeniden denemeleri ilgisiz yeni kayıtlar değil, amaçlanan işin denemeleri olarak tutun.
Tek bir CSV hem inceleyene hem içe aktarıcıya hizmet edebilir mi?
Ayrı varlıkları tercih edin. İnceleme notları ve elektronik tabloya özgü güvenlik dönüşümleri genel alanlar veya makine içe aktarmaları için uygun olmayabilir.
Alan doğrulamasını geçmek çeviri kalitesini kanıtlar mı?
Hayır. Yerel vaka 40 birleştirilmiş satır için yapısal kontrolleri geçti, ancak yapay zekâ incelemesi düzeltilmesi gereken Japonca ifadeler buldu. Kaynaktan kopyalanan alanlar sağlam kaldı, açıklama anlamı yine de inceleme gerektirdi.