Alur kerja pelokalan katalog produk

Bekukan sumber sebelum menerjemahkan

Ekspor katalog dan pertahankan snapshot sumber immutable. Catat asal, waktu ekspor, serta revisi atau hash file. Beri setiap varian identitas stabil dan periksa pengenal yang hilang atau duplikat sebelum membuat pekerjaan bahasa. Simpan manifest pasangan produk-locale yang hendak diproses.

Pisahkan persiapan sumber dari terjemahan. Selesaikan ukuran yang bertentangan, satuan yang hilang, dan klaim tanpa dukungan dengan pemilik produk terlebih dahulu. Normalisasi ekspor pemasok mungkin diperlukan; catat koreksi sebagai perubahan sumber dan minta pemilik menyetujui baseline sebelum pekerjaan bahasa dimulai.

Pisahkan fakta terlindungi dari teks yang dapat diedit

Buat catatan terlindungi untuk SKU, harga, mata uang, satuan, hubungan varian, dan nilai operasional lainnya. Hasilkan hanya patch teks. Saat perakitan, salin nilai terlindungi langsung dari sumber dan bandingkan lagi agar model tidak menjadi otoritas untuk kolom yang hanya dilihat sebagai konteks.

Buat klaim dapat ditelusuri juga. Hubungkan pernyataan yang disetujui dengan buktinya dan beri tahu tahap penyusunan untuk menandai hal yang tidak didukung. Konfigurasi berikut adalah kebijakan pipeline ilustratif, bukan file yang diterima Shopify atau WooCommerce. Adapter Anda harus memetakannya ke kontrak tujuan aktual.

{
  "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"
}

Lampirkan glosarium dan brief locale

Brief locale harus mengidentifikasi audiens, nada, terminologi yang disetujui, dan aturan penyajian. Pisahkan konsep produk dari ejaan pilihan. W3C ITS mendefinisikan metadata terminologi dan terjemahan yang dapat menginformasikan sistem lokalisasi yang lebih kaya; alur ini menggunakan catatan editorial berversi yang lebih sederhana.

Selesaikan istilah ambigu dengan contoh dari kategori aktual. Jika entri glosarium berubah, identifikasi kandidat yang terdampak dan putuskan apakah perlu dibuat ulang atau diedit secara terarah. Kaitkan setiap locale dengan sumber disetujui yang sama. Jangan menjadikan satu versi terjemahan sebagai sumber perantara yang belum ditinjau bagi sisanya.

Kasus lokal: 20 produk, 40 patch bahasa

Katalog 20 produk sintetis yang dibekukan diterjemahkan menjadi 20 patch Jepang dan 20 patch Jerman oleh agen terjemahan yang secara eksplisit dikonfigurasi untuk gpt-5.6-luna dengan reasoning xhigh. Setiap patch hanya berisi sku, locale, title, dan description. Assembler menyalin price, currency, material, dan dimensions dari source.json, sehingga pelestarian fakta merupakan properti pipeline, bukan pekerjaan menyalin yang didelegasikan ke model.

validated-ja.json dan validated-de.json yang tersimpan masing-masing berisi 20 baris dan daftar failures kosong. Perakitan ulang read-only cocok dengan kedua output. Gunakan pola ini pada batch Anda: pertahankan revisi sumber, simpan patch bahasa secara terpisah, dan validasi cakupan serta kolom yang diizinkan sebelum merakit paket peninjauan.

Jalankan pemeriksaan deterministik sebelum tinjauan editorial

Validasi schema output, kolom yang diizinkan, pemetaan pengenal, revisi sumber, teks wajib, dan nilai terlindungi. Bandingkan jumlah placeholder menggunakan grammar template aktual aplikasi. Parse markup, jangan menerapkan substitusi teks umum ke HTML. Tahan catatan malformed daripada meminta importer memperbaikinya.

Untuk file peninjauan spreadsheet, OWASP mendokumentasikan risiko formula injection dan tidak adanya transformasi CSV aman universal. Gunakan kebijakan ekspor yang ditinjau untuk alat spreadsheet pilihan dan pisahkan artefak tersebut dari impor mesin. Menambahkan prefix escape untuk tampilan manusia tidak boleh mengubah SKU secara tidak sengaja dalam payload toko.

Ikat keputusan peninjauan ke revisi konten

Berikan peninjau fakta sumber, konteks glosarium, kandidat, dan masalah terstruktur. Minta keputusan faktual dan bahasa secara terpisah. Catat siapa yang menyetujui konten dan revisi apa yang mereka lihat. Peninjau dapat menerima frasa lokal sambil menahan klaim yang membutuhkan bukti; catatan harus menampilkan perbedaan itu.

Dalam kasus lokal, tinjauan AI mengoreksi DEMO-003 Jepang dari redaksi yang mengimplikasikan karton bergelombang menjadi redaksi yang konsisten dengan penyangga kardus sumber. Tinjauan juga memperjelas DEMO-010 sebagai dua pegangan seluruhnya. Output asli tetap di raw-ja.json. Kedua bahasa yang dirakit tetap memiliki review_status: unreviewed dan translation_semantic_review: pending: koreksi ini bukan persetujuan penutur asli atau merchant.

Rakit dan verifikasi paket tujuan

Pilih kandidat yang disetujui dan sesuai sumber, lalu ubah hanya kolom yang diizinkan. API terjemahan Shopify menggunakan kontrak resource serta digest; deployment WooCommerce memerlukan pemetaan produk dan, untuk banyak bahasa, lapisan lokalisasi yang terverifikasi. Paket peninjauan generik bukan impor toko universal.

Uji impor kecil berotorisasi di staging. Simpan hasil importer, baca kembali kolom yang ditargetkan, dan periksa perilaku produk serta locale. Rekonsiliasikan set produk yang direncanakan dengan hasil tersimpan. Pisahkan baris gagal dan simpan nilai sebelumnya untuk pembalikan yang cakupannya hati-hati bila diperlukan.

Catat hasil dan keterbatasannya

Manifest lengkap harus menghubungkan sumber, glosarium, prompt, kandidat, pemeriksaan, persetujuan, dan hasil tujuan. Catat penggunaan aktual untuk setiap percobaan saat bukti tersedia, termasuk retry. Penggunaan dan hasil peninjauan yang hilang harus tetap secara eksplisit tidak diketahui. File yang dapat di-parse bukan bukti bahwa toko menerimanya.

Untuk kasus lokal terbatas, model yang dipilih adalah Luna, bukan Astra, dan tidak ada gateway call atau impor toko nyata. Penggunaan API, request ID, dan billing tidak terekspos; model_api_usage dan model_api_cost tetap null, bukan nol. Langkah berikutnya adalah persetujuan semantik diikuti tes tujuan yang diotorisasi secara terpisah.

Pertanyaan umum