Product catalog localization workflow

Translate করার আগে source freeze করুন

Catalog export করে immutable source snapshot সংরক্ষণ করুন। Origin, export time ও revision বা file hash record করুন। Language job তৈরির আগে প্রতিটি variant-কে stable identity দিন এবং missing বা duplicate identifier check করুন। Process করার product-locale pair-এর manifest রাখুন।

Source preparation ও translation আলাদা করুন। Contradictory measurement, missing unit ও unsupported claim আগে product owner-এর সঙ্গে resolve করুন। Supplier export normalize করা দরকার হতে পারে; correction-কে source change হিসেবে record করুন এবং language work শুরুর আগে owner-কে resulting baseline approve করতে দিন।

Protected fact ও editable text আলাদা করুন

SKU, price, currency, unit, variant relationship ও অন্য operational value-এর protected record তৈরি করুন। শুধু text patch generate করুন। Assembly-এর সময় protected value সরাসরি source থেকে copy করে আবার compare করুন, যাতে context হিসেবে দেখা field-এ model authority না পায়।

Claim-ও traceable রাখুন। Approved assertion evidence-এর সঙ্গে link করে unsupported কিছু flag করতে drafting step-কে বলুন। নিচের configuration illustrative pipeline policy, Shopify বা WooCommerce accepted file নয়। আপনার adapter-কে actual destination contract-এ map করতে হবে।

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

Glossary ও locale brief attach করুন

Locale brief-এ audience, tone, approved terminology ও presentation rule identify করা উচিত। Product concept preferred spelling থেকে আলাদা রাখুন। W3C ITS richer localization system-এর জন্য terminology ও translation metadata define করে; এই workflow simpler versioned editorial record ব্যবহার করে।

Actual category-এর example দিয়ে ambiguous term resolve করুন। Glossary entry বদলালে affected candidate identify করে regeneration নাকি targeted edit দরকার ঠিক করুন। প্রতিটি locale একই approved source-এর সঙ্গে tied রাখুন। একটি translated version-কে অন্যগুলোর জন্য unreviewed intermediate source হতে দেবেন না।

Local case: 20 product, 40 language patch

20টি synthetic product-এর frozen catalog translation agent 20টি Japanese ও 20টি German patch-এ translate করেছে; agent-কে gpt-5.6-luna ও xhigh reasoning-এ explicitভাবে configure করা ছিল। প্রতিটি patch-এ শুধু sku, locale, title ও description। Assembler source.json থেকে price, currency, material ও dimensions copy করে, তাই fact preserve করা pipeline-এর property, model-এর ওপর delegated copying task নয়।

Saved validated-ja.json file ও validated-de.json file-এ প্রত্যেকটিতে 20 row এবং empty failures list আছে। Read-only reassembly দুই saved output-ই match করে। নিজের batch-এ এই pattern ব্যবহার করুন: source revision retain, language patch আলাদা save এবং review package assemble করার আগে coverage ও permitted field validate করুন।

Editorial review-এর আগে deterministic check চালান

Output schema, allowed field, identifier mapping, source revision, required text ও protected value validate করুন। Application-এর real template grammar দিয়ে placeholder count compare করুন। HTML-এ general text substitution না করে markup parse করুন। Malformed record importer-কে repair করতে না দিয়ে hold করুন।

Spreadsheet review file-এর জন্য OWASP formula-injection risk ও universal safe CSV transformation না থাকার কথা document করে। Chosen spreadsheet tool-এর জন্য reviewed export policy ব্যবহার করুন এবং সেই artifact machine import থেকে আলাদা রাখুন। Human viewing-এর জন্য escape prefix যোগ করলে store payload-এ SKU অজান্তে বদলানো যাবে না।

Content revision-এর সঙ্গে review decision bind করুন

Reviewer-কে source fact, glossary context, candidate ও structured issue দিন। Factual ও language decision আলাদা চাইুন। কে content approve করেছেন এবং কোন revision দেখেছেন record করুন। Reviewer localized phrase accept করলেও evidence দরকার এমন claim hold করতে পারেন; record-এ এই distinction প্রকাশ হওয়া উচিত।

Local case-এ AI review Japanese DEMO-003-এর wording corrugated cardboard imply করা থেকে source-এর cardboard backing-এর সঙ্গে consistent wording-এ correct করেছে। DEMO-010-ও মোট দুইটি handle বোঝায় স্পষ্ট করা হয়েছে। Original output raw-ja.json file-এ আছে। দুই assembled language-এই review_status: unreviewed এবং translation_semantic_review: pending আছে: এগুলো native-speaker বা merchant approval নয়।

Destination package assemble ও verify করুন

Approved, source-current candidate select করে কেবল permitted field transform করুন। Shopify translation API resource ও digest contract ব্যবহার করে; WooCommerce deployment-এ product mapping এবং multiple language হলে verified localization layer দরকার। Generic review package universal store import নয়।

Staging-এ ছোট authorized import test করুন। Importer result save করুন, targeted field read back করুন এবং product ও locale behavior inspect করুন। Planned product set stored outcome-এর সঙ্গে reconcile করুন। Failed row আলাদা রাখুন এবং দরকার হলে carefully scoped reversal-এর জন্য previous value preserve করুন।

Result ও তার limit record করুন

Completed manifest source, glossary, prompt, candidate, check, approval ও destination result link করবে। Evidence available হলে retry-সহ প্রতিটি attempt-এর actual usage record করুন। Missing usage ও missing review result explicitly unknown রাখুন। Parse করা যায় এমন file shop তা accept করেছে এমন proof নয়।

Bounded local case-এ selected model Luna, Astra নয়; gateway call বা real store import ছিল না। API usage, request ID ও billing exposed হয়নি; model_api_usage ও model_api_cost null, zero নয়। Next step semantic approval, তারপর separately authorized destination test।

সাধারণ প্রশ্ন