Quy trình bản địa hóa catalog sản phẩm

Updated 2026-09-05

Tạo bản vá văn bản, giữ dữ kiện sản phẩm trong mã rồi rà soát ý nghĩa. Ca local 20 sản phẩm cho thấy 40 bản nháp ngôn ngữ hợp cấu trúc vẫn có thể cần sửa.

Đóng băng nguồn trước khi dịch

Xuất catalog và giữ ảnh chụp nguồn bất biến. Ghi nguồn gốc, thời điểm xuất và bản sửa hoặc hash tệp. Cấp danh tính ổn định cho từng biến thể và kiểm tra mã định danh thiếu hoặc trùng trước khi tạo job ngôn ngữ. Giữ manifest các cặp sản phẩm-locale dự kiến xử lý.

Tách chuẩn bị nguồn khỏi dịch. Giải quyết phép đo mâu thuẫn, đơn vị thiếu và khẳng định không hỗ trợ với chủ sản phẩm trước. Chuẩn hóa export nhà cung cấp có thể cần, hãy ghi sửa như thay đổi nguồn và để chủ sở hữu phê duyệt baseline kết quả trước khi làm ngôn ngữ.

Tách dữ kiện được bảo vệ khỏi văn bản chỉnh sửa

Tạo bản ghi bảo vệ cho SKU, giá, tiền tệ, đơn vị, quan hệ biến thể và giá trị vận hành khác. Chỉ tạo bản vá văn bản. Khi lắp ráp, sao chép giá trị bảo vệ trực tiếp từ nguồn và so lại để model không trở thành thẩm quyền cho trường nó chỉ thấy trong ngữ cảnh.

Làm khẳng định có thể truy dấu nữa. Gắn mệnh đề đã duyệt với bằng chứng và yêu cầu bước soạn gắn cờ điều không hỗ trợ. Cấu hình sau là policy pipeline minh họa, không phải tệp Shopify hay WooCommerce chấp nhận. Adapter phải ánh xạ vào hợp đồng điểm đến thực.

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

Gắn bảng thuật ngữ và brief locale

Brief locale nên nêu khán giả, giọng, thuật ngữ được duyệt và quy tắc trình bày. Tách khái niệm sản phẩm khỏi cách viết ưu tiên. W3C ITS định nghĩa metadata thuật ngữ và dịch có thể hỗ trợ hệ thống bản địa hóa phong phú; workflow này dùng bản ghi biên tập có phiên bản đơn giản hơn.

Giải quyết thuật ngữ mơ hồ bằng ví dụ từ danh mục thực. Nếu entry bảng thuật ngữ đổi, xác định ứng viên bị ảnh hưởng và quyết định tạo lại hay sửa có mục tiêu. Gắn từng locale với cùng nguồn đã duyệt. Đừng để một bản dịch thành nguồn trung gian chưa rà soát cho phần còn lại.

Ca local: 20 sản phẩm, 40 bản vá ngôn ngữ

Catalog tổng hợp 20 sản phẩm đã đóng băng được agent dịch thành 20 patch Nhật và 20 patch Đức, cấu hình rõ gpt-5.6-luna với suy luận xhigh. Mỗi patch chỉ có sku, locale, title và description. Bộ lắp ráp sao chép giá, tiền tệ, vật liệu và kích thước từ source.json, nên giữ các dữ kiện đó là thuộc tính pipeline chứ không phải tác vụ sao chép giao cho model.

validated-ja.json và validated-de.json đã lưu mỗi tệp có 20 dòng và danh sách failures rỗng. Lắp lại chỉ đọc khớp cả hai output. Dùng mẫu này cho batch của bạn: giữ bản sửa nguồn, lưu patch ngôn ngữ riêng và xác thực phạm vi cùng trường được phép trước khi lắp gói rà soát.

Báo cáo rà soát catalog tổng hợp local hiển thị sản phẩm nguồn tiếng Anh cạnh bản nháp Nhật và Đức, với 40 dòng đã bản địa hóa và rà soát ngữ nghĩa đang chờ.
Ảnh chụp thực tế báo cáo rà soát catalog tổng hợp local của ca Luna xhigh: 20 sản phẩm nguồn và 40 dòng bản địa hóa. Rà soát native speaker và merchant vẫn chờ.
Artifact caKết quả ghi nhậnTrạng thái rà soát
source.json20 sản phẩm tổng hợp; revision đóng băngDữ kiện fixture có thẩm quyền
validated-ja.json20 dòng đã lắp; 0 lỗi cấu trúcRà soát ngữ nghĩa đang chờ
validated-de.json20 dòng đã lắp; 0 lỗi cấu trúcRà soát ngữ nghĩa đang chờ
raw-ja.jsonPatch Nhật gốc được giữTrước hai lần sửa AI review

Chạy kiểm tra xác định trước rà soát biên tập

Xác thực schema output, trường được phép, ánh xạ mã định danh, bản sửa nguồn, văn bản bắt buộc và giá trị bảo vệ. So số placeholder bằng grammar template thật của ứng dụng. Parse markup thay vì thay văn bản chung vào HTML. Giữ record sai thay vì yêu cầu importer sửa.

Với tệp rà soát bảng tính, OWASP ghi nhận nguy cơ chèn công thức và không có biến đổi CSV an toàn phổ quát. Dùng policy export đã rà soát cho công cụ bảng tính đã chọn và giữ artifact đó riêng với import máy. Prefix escape cho người xem không được vô tình đổi SKU trong payload cửa hàng.

Gắn quyết định rà soát với bản sửa nội dung

Cung cấp cho người rà soát dữ kiện nguồn, ngữ cảnh bảng thuật ngữ, ứng viên và vấn đề có cấu trúc. Yêu cầu quyết định dữ kiện và ngôn ngữ riêng. Ghi ai đã duyệt và họ đã thấy bản sửa nào. Người rà soát có thể chấp nhận câu địa phương trong khi tạm giữ khẳng định cần bằng chứng; hồ sơ phải thể hiện khác biệt.

Trong ca local, AI review sửa DEMO-003 Nhật từ cách nói hàm ý bìa carton sóng thành cách nói khớp bìa bìa cứng của nguồn. Nó cũng làm rõ DEMO-010 là tổng hai quai. Output gốc vẫn ở raw-ja.json. Cả hai ngôn ngữ lắp vẫn mang review_status: unreviewed và translation_semantic_review: pending: đây không phải phê duyệt native speaker hay merchant.

ArtifactMục đíchPhải xác định
Ảnh chụp nguồnĐầu vào có thẩm quyềnSản phẩm và bản sửa nguồn
Bản ghi ứng viênVăn bản địa phương đề xuấtLocale, lần thử và bảng thuật ngữ
Quyết định rà soátQuyền dùng ứng viên đóNgười rà soát và bản sửa nội dung
Gói nhậpBản vá điểm đến tối thiểu đã duyệtAdapter và trường đích
Báo cáo đọc lạiKết quả lưu được quan sátID điểm đến và khác biệt

Lắp và xác minh gói điểm đến

Chọn ứng viên đã duyệt, hiện tại theo nguồn và chỉ biến đổi trường được phép. API dịch Shopify dùng hợp đồng resource và digest; triển khai WooCommerce cần ánh xạ sản phẩm và, với nhiều ngôn ngữ, lớp bản địa hóa đã xác minh. Gói rà soát chung không tự là import cửa hàng phổ quát.

Kiểm thử một lần nhập nhỏ được ủy quyền ở staging. Lưu kết quả importer, đọc lại trường mục tiêu và kiểm tra hành vi sản phẩm cùng locale. Đối soát tập sản phẩm dự kiến với kết quả lưu. Giữ hàng lỗi riêng và bảo toàn giá trị trước để hoàn tác có phạm vi nếu cần.

Ghi kết quả và giới hạn

Manifest hoàn chỉnh nên nối nguồn, bảng thuật ngữ, prompt, ứng viên, kiểm tra, phê duyệt và kết quả điểm đến. Ghi usage thực cho mỗi lần thử khi có bằng chứng, gồm retry. Giữ usage thiếu và kết quả rà soát thiếu rõ là chưa biết. Tệp parse được không phải bằng chứng cửa hàng chấp nhận.

Với ca local có phạm vi, model được chọn là Luna, không phải Astra, và không có gateway call hay import cửa hàng thật. Usage API, request ID và billing không lộ; model_api_usage và model_api_cost vẫn null, không phải không. Bước tiếp theo là phê duyệt ngữ nghĩa rồi test điểm đến được ủy quyền riêng.

Câu hỏi thường gặp

Artifact pipeline hữu ích nhỏ nhất là gì?

Ảnh chụp nguồn nối với ứng viên, kết quả xác thực và quyết định rà soát cho một cặp sản phẩm-locale. Bản ghi đó sau có thể ánh xạ vào bản vá điểm đến đã xác minh.

Có nên gửi giá nguồn qua model không?

Chỉ đưa ngữ cảnh cần thiết. Giữ giá có thẩm quyền ngoài output chỉnh sửa và sao chép trực tiếp từ nguồn khi lắp bản ghi chứa chúng.

Ngăn bản dịch trùng thế nào?

Dùng danh tính sản phẩm-locale ổn định cùng bản sửa nguồn, bảng thuật ngữ và prompt. Giữ retry là lần thử của công việc dự kiến, không phải bản ghi mới không liên quan.

Một CSV có thể phục vụ người rà soát và importer không?

Nên tách artifact. Ghi chú rà soát và biến đổi an toàn riêng của bảng tính có thể không phù hợp trường công khai hoặc import máy.

Field validation đạt có chứng minh chất lượng dịch không?

Không. Ca local đạt kiểm tra cấu trúc cho 40 dòng lắp, nhưng AI review tìm cách diễn đạt Nhật cần sửa. Trường sao chép từ nguồn nguyên vẹn còn ý nghĩa mô tả vẫn cần rà soát.