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.

| Artifact ca | Kết quả ghi nhận | Trạng thái rà soát |
|---|---|---|
| source.json | 20 sản phẩm tổng hợp; revision đóng băng | Dữ kiện fixture có thẩm quyền |
| validated-ja.json | 20 dòng đã lắp; 0 lỗi cấu trúc | Rà soát ngữ nghĩa đang chờ |
| validated-de.json | 20 dòng đã lắp; 0 lỗi cấu trúc | Rà soát ngữ nghĩa đang chờ |
| raw-ja.json | Patch 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.
| Artifact | Mục đích | Phải xác định |
|---|---|---|
| Ảnh chụp nguồn | Đầu vào có thẩm quyền | Sản phẩm và bản sửa nguồn |
| Bản ghi ứng viên | Văn bản địa phương đề xuất | Locale, lần thử và bảng thuật ngữ |
| Quyết định rà soát | Quyền dùng ứng viên đó | Người rà soát và bản sửa nội dung |
| Gói nhập | Bản vá điểm đến tối thiểu đã duyệt | Adapter và trường đích |
| Báo cáo đọc lại | Kết quả lưu được quan sát | ID đ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.