Giao diện
PIM-MASTER-BLUEPRINT
Product Information Management — Single Source of Truth cho mỗi sản phẩm Đức Thiện
Transformation Office (PMO) · 10/07/2026 · Neo: doc 03 (R2), C2, C3, C4, R04, Execution-Master-Backlog · Thiết kế — CHƯA thực thi
Sứ mệnh: Mỗi sản phẩm có MỘT bản ghi nguồn sự thật (SoT). Mọi kênh — Website · Catalogue · Datasheet · Sales · SEO · AEO · CRM · Distributor Kit — đọc từ SoT, không tự sửa nội dung sản phẩm ở kênh. Sửa một chỗ → cập nhật mọi nơi.Nguyên tắc kỷ luật bằng chứng (kế thừa dự án): mỗi trường mang evidence source · confidence · verified_date · status. Trường chưa xác minh (vd độ dính N/cm, công suất) KHÔNG được publish — chỉ ở trạng thái
provisional. PIM kế thừa sổ UNKNOWN & tag R2.
1. Phạm vi sản phẩm & mã danh mục
Neo trên 11 dòng SP (PDF/doc 03-R2) + phòng sạch + stretch/tape/non-adhesive.
| Mã CAT | Dòng sản phẩm |
|---|---|
| KIN | Màng bảo vệ kính/gương |
| DA | Màng bảo vệ đá (hoa cương/thạch anh)/countertop |
| NHO | Màng nhôm profile/kỹ thuật/thanh (UV) |
| ACP | Màng tấm nhôm nhựa (ACP) |
| PAN | Màng tôn/thép mạ kẽm/panel |
| INX | Màng inox/kim loại thường |
| DOT | Màng kim loại đột dập ("độc quyền VN") |
| LAS | Màng kim loại cắt laser ("độc quyền VN") |
| NHU | Màng tấm nhựa lấy sáng (acrylic) |
| GAC | Màng gạch men |
| GO | Màng nội thất/gỗ |
| DTU | Màng công nghiệp điện tử (độ sạch cao) |
| THT | Màng tấm than tre đa năng |
| PSR | Phòng sạch — con lăn bụi |
| PSM | Phòng sạch — thảm dính bụi |
| STR | Màng stretch |
| TAP | Băng dính |
| NAK | Màng PE không tráng keo |
Đơn vị SoT: 1 bản ghi = 1 Product Family (vd DT-KIN-001). Biến thể (độ dày × grade keo × màu × khổ) là variant matrix bên trong bản ghi; nếu cần bán/quản theo variant riêng → SKU con DT-KIN-001-80T (80µm, trong suốt).
2. PRODUCT INFORMATION MODEL — 12 nhóm thuộc tính
Mỗi nhóm có Owner (mục 6) và trạng thái publish riêng. Kiểu dữ liệu gợi ý trong ngoặc.
G1 · COMMERCIAL — Owner: Sales/CEO
name_vi, name_en, family, positioning_tier (B1: cash/beachhead/showcase), target_segments[], price_unit (/m²·/kg·/cuộn), price_band (nội bộ), MOQ, lead_time, warranty (3 tháng ngoài trời/6 tháng kho), incoterms_default[], usp.
G2 · TECHNICAL — Owner: QC/R&D
base_film (PE), adhesive_type (acrylic/rubber/tĩnh điện/co-ex), thickness_um (range), adhesion_GF (nguồn PDF), adhesion_Ncm (⚠️ provisional tới khi test — N3), tack, uv_months, temp_C, light_transmission_pct (kính), elongation_pct, width_mm, length_m, color_opacity[], residue_free (bool), printable (bool).
G3 · MANUFACTURING — Owner: Production
make_source (in-house / sourced — N6), production_line, capacity_note (⚠️ UNKNOWN #4), corona_treatment, slitting_range, logo_print_capability.
G4 · QUALITY — Owner: QC/Compliance
iso_scope_ref (ISO 9001:2015 — verify N1), qc_test_methods[] (máy đo lực dính/độ dày/độ nhớt — PDF p21), coa_ref, third_party_test_ref (SGS/TÜV — provisional), tolerance.
G5 · PACKAGING — Owner: Production/Export
roll_core_mm (76), rolls_per_pallet, moisture_protection, sea_export_pack (đá ưu tiên), carton_label.
G6 · EXPORT / COMPLIANCE — Owner: Compliance/Export
hs_code, reach_status (article — không đăng ký; SVHC decl — R04), svhc_status, rohs_declaration (điện tử), food_contact (N/A trừ khi tiếp xúc TP), ce (N/A — không gắn), country_notes[].
G7 · WEBSITE — Owner: Digital
slug_vi, slug_en, category_path, canonical, page_status (draft/live), hreflang.
G8 · SEO — Owner: Digital/Marketing
primary_keyword, secondary_keywords[], meta_title, meta_description, schema_type (Product/Offer), internal_links[].
G9 · AEO — Owner: Digital/Marketing
buyer_questions[] (câu hỏi mua thực), snippet_facts[] (fact ngắn trích dẫn được), faq[], comparison_facts[] (vs substitutes/đối thủ).
G10 · SALES — Owner: Sales
pitch, pain_points_solved[], objections[], substitutes[], decision_factors[], cross_sell[] (map doc 03/05).
G11 · DOCUMENTS — Owner: theo tài liệu (C2)
Links + version tới: TDS, REACH_SVHC_decl, test_report, COA, application_guide, material_declaration, packaging_spec, warranty (KHÔNG có SDS cho article — R04).
G12 · MEDIA — Owner: Marketing
product_photos[], factory_photos[], application_photos[], video[], logo_print_samples[], thumbnail.
Meta mỗi trường:
value · evidence_source · confidence(H/M/L) · verified_date · status(draft/review/approved/published/provisional).
3. FOLDER STRUCTURE
/pim/
├── README.md
├── _schema/
│ ├── product-model.yaml # định nghĩa 12 nhóm + kiểu dữ liệu
│ ├── controlled-vocab.yaml # CAT codes, màu, grade keo, đơn vị
│ └── field-ownership.yaml # trường → owner (mục 6)
├── _templates/ # template tài liệu (từ C2): TDS, REACH decl, COA...
├── products/
│ ├── DT-KIN-001/
│ │ ├── product.yaml # ⭐ BẢN GHI SoT (12 nhóm)
│ │ ├── CHANGELOG.md # lịch sử phiên bản bản ghi
│ │ ├── documents/
│ │ │ ├── TDS/DT-KIN-001_TDS_vi_v1.0_2026-07-10.pdf
│ │ │ ├── REACH/ TestReport/ COA/ AppGuide/ ...
│ │ └── media/
│ │ ├── photos/ video/ thumbnails/
│ ├── DT-DA-001/ ...
│ └── ...
└── _exports/ # ĐẦU RA sinh tự động (read-only cho consumer)
├── website-feed.json
├── catalogue/ datasheets/ distributor-kit/
└── crm-catalog.csvNguyên tắc: products/*/product.yaml = nguồn duy nhất. _exports/* được SINH RA, không sửa tay. Consumer đọc _exports/ hoặc product.yaml, không bao giờ giữ bản sao chỉnh riêng.
4. NAMING CONVENTION
- Product Family ID:
DT-<CAT>-<NNN>→DT-KIN-001. SKU variant:DT-KIN-001-<mã variant>(vd-80T= 80µm trong suốt). - Tài liệu:
<ID>_<DOCTYPE>_<lang>_v<major.minor>_<YYYY-MM-DD>.<ext>→DT-KIN-001_TDS_en_v1.2_2026-07-10.pdfDOCTYPE ∈ {TDS, REACH, SVHC, TEST, COA, APP, MAT, PKG, WAR, CAT}. - Media:
<ID>_<kind>_<nn>.<ext>→DT-KIN-001_application_03.jpg(kind ∈ product/factory/application/video/logoprint/thumb). - Quy tắc: không dấu, không cách (dùng
-/_), lang ∈ {vi,en}, ngày ISO. Slug web tách riêng ở G7.
5. VERSION CONTROL
- Bản ghi:
product.yamlcórecord_version(semver). Minor = sửa nội dung/giá trị; Major = đổi cấu trúc/công thức/SKU. Mỗi thay đổi ghiCHANGELOG.md(giống Release-2 log: what/why/evidence/tag). - Trường: mỗi trường có
verified_date+status. Đổi trường "approved/published" → tăng version + yêu cầu re-approval (mục 7). - Tài liệu: version trong tên file (v1.0→v1.1); bản cũ chuyển
documents/_archive/. - Hệ thống: khuyến nghị đặt
/pim/dưới git (repo riêng) để lịch sử/nhánh/khôi phục; nếu không, bắt buộc CHANGELOG +_archive/. - Nguồn evidence: trường kỹ thuật trỏ tới tài liệu/thí nghiệm gốc (vd
adhesion_Ncm.evidence = TEST/DT-KIN-001_TEST...); khi chưa có →status: provisional.
6. ASSET OWNERSHIP
| Nhóm | Owner (Accountable) | Ghi chú |
|---|---|---|
| G1 Commercial | Sales Lead (+CEO giá) | price_band nội bộ |
| G2 Technical | QC/R&D | nguồn của TDS |
| G3 Manufacturing | Production | make_source, capacity |
| G4 Quality | QC + Compliance | ISO/COA/test |
| G5 Packaging | Production/Export | |
| G6 Export/Compliance | Compliance + Export | REACH/HS/RoHS |
| G7–G9 Website/SEO/AEO | Digital/Marketing | |
| G10 Sales | Sales | |
| G11 Documents | Owner từng tài liệu (C2) | |
| G12 Media | Marketing |
- Product Owner (mỗi SKU): 1 người chịu trách nhiệm tổng thể bản ghi (mặc định Sales Lead).
- Data Steward (PIM admin): 1 người gác cổng schema/naming/version/quyền publish (mặc định PMO/Marketing ops).
7. APPROVAL WORKFLOW
DRAFT → REVIEW (owner nhóm) → APPROVE (gác cổng) → PUBLISH (Steward) → _exports/- Gác cổng theo nhóm: G2/G4 (Technical/Quality) cần QC/R&D + Compliance ký; G6 (Export) cần Compliance; G1 giá cần CEO.
- Cổng bằng chứng (bắt buộc): trường chỉ lên
publishedkhi cóevidence_source+verified_date. Ví dụ:adhesion_Ncm→ publish chỉ sau test bên thứ ba (E3-T2/N3); trước đó giữadhesion_GFpublished +adhesion_Ncm: provisional.iso_scope_ref→ publish chỉ khi ISO còn hiệu lực (E0-T2/N1).references(G1/G10) → publish chỉ sau quyền dùng partner (E0-T4/N2).
- Không qua cổng = không xuất ra
_exports/→ Website/Catalogue/Datasheet không thể hiển thị dữ liệu chưa duyệt.
8. UPDATE WORKFLOW (trigger-based)
| Trigger | Hành động | Owner |
|---|---|---|
| Đổi công thức/nguồn nguyên liệu | Major version; re-test; cập nhật G2/G3/G4 | QC/R&D |
| Candidate List SVHC cập nhật (2 lần/năm) | Re-check REACH/SVHC decl (G6) | Compliance |
| Có test bên thứ ba mới | provisional→published cho G2/G4; bump TDS | QC/Compliance |
| ISO gia hạn/hết hạn (N1) | Cập nhật G4 iso_scope_ref; nếu hết hạn → hạ status các trường phụ thuộc | Compliance |
| Đổi giá/MOQ/lead time | Minor version G1; sync CRM/quote | Sales/CEO |
| Thêm/đổi reference/case study | Cập nhật G1/G10/G12 sau quyền dùng | Sales/Marketing |
| Ảnh/video mới | Cập nhật G12 + thumbnails | Marketing |
Mọi update: Change Request → Steward kiểm → owner cập nhật → re-approval (nếu trường published) → version bump → re-publish _exports/.
9. ONE PRODUCT → ONE SOURCE → MANY CONSUMERS
| Consumer | Đọc nhóm nào từ SoT | Cách |
|---|---|---|
| Website | G1,G2,G7,G8,G9,G11,G12 | website-feed.json |
| Catalogue | G1,G2,G12 | render _exports/catalogue/ |
| Datasheet (TDS) | G2,G4,G11 | render từ template C2 |
| Sales (quote/pitch) | G1,G10,G11 | Quotation/Capability (C4) |
| SEO | G7,G8 | meta/schema |
| AEO | G9 | FAQ/snippet/LLM |
| CRM | G1 (+ SKU) | crm-catalog.csv |
| Distributor Kit | G1,G3(OEM),G11,G12 | _exports/distributor-kit/ |
Bất biến: consumer không chỉnh nội dung sản phẩm; muốn đổi → sửa
product.yaml→ re-publish. Loại bỏ tình trạng "website nói khác datasheet nói khác Alibaba" (đúng lỗi Phase A đã phát hiện).
10. Bản ghi mẫu (minh hoạ — DT-KIN-001)
yaml
id: DT-KIN-001
record_version: 1.0
product_owner: sales_lead
G1_commercial:
name_vi: "Màng PE bảo vệ bề mặt kính, gương"
name_en: "PE Protective Film for Glass & Mirror"
positioning_tier: showcase # B1
warranty: "3 tháng ngoài trời / 6 tháng lưu kho"
MOQ: {value: null, status: provisional, note: "UNKNOWN #6"}
G2_technical:
thickness_um: {value: "25-150", evidence: PDF_p09, status: published}
adhesion_GF: {value: "50-450", evidence: PDF_p09, status: published}
adhesion_Ncm: {value: null, status: provisional, note: "N3 - chờ test SGS"}
uv_option: {value: true, evidence: PDF_p09, status: published}
G4_quality:
iso_scope_ref: {value: "ISO 9001:2015", status: review, note: "verify N1 hiệu lực"}
G6_export:
reach_status: {value: "article - no registration; SVHC decl", evidence: R04, status: approved}
ce: "N/A - không gắn"
G11_documents:
TDS: {file: "documents/TDS/DT-KIN-001_TDS_vi_v1.0_2026-07-10.pdf", status: draft}Kết: PIM biến 18 dòng sản phẩm thành các bản ghi SoT có 12 nhóm thuộc tính, folder/naming/version/ownership/approval/update chuẩn hoá, phục vụ 8 consumer từ một nguồn. Cổng bằng chứng đảm bảo không publish dữ liệu chưa xác minh (kế thừa kỷ luật Release 2). Thiết kế hoàn tất. CHƯA thực thi. STOP.