Product Library — logic hoạt động

StoreFleet · cập nhật 01/10/2026 · dành cho quản lý và nhân viên

Tổng quan

Product Library là kho sản phẩm gốc. Sản phẩm sửa ở kho thì app đồng bộ ra các store đang bán sản phẩm đó.

Khái niệm	Vai trò
File	Mỗi file CSV đã import là một bản ghi riêng (tab Files). Sản phẩm luôn thuộc đúng 1 file.
Niche	Gán cho file, không gán lẻ cho sản phẩm. Niche quyết định sản phẩm thuộc về những store nào (store cũng có niche).
Handle	Khoá nhận diện sản phẩm. Dùng để chống trùng khi import và để tìm bản của sản phẩm trên từng store.

~136.570sản phẩm trong kho

115file đã import

2file đã có niche

67.830liên kết sản phẩm ↔ store

Các tab

Mỗi tab có đường dẫn riêng (/product-library?tab=…): F5 hoặc gửi link vẫn mở đúng tab và bộ lọc file.

Tab	Dùng để
Not pushed yet	Sản phẩm trong kho chưa nối với store nào. Lọc theo niche, file; tìm theo title hoặc mọi trường; có tổng số.
Live on stores (auto-sync)	Sản phẩm đã nối với ít nhất 1 store. Sửa ở đây là ghi đè ra mọi store đang có.
Files	Mỗi file đã import: số sản phẩm, số bản trùng đã cắt (tải được), gán niche, xem sản phẩm, Push cả file.
Search a niche	Tìm trong store test của một niche.
Stores	Mỗi store bao nhiêu sản phẩm: đã nối với kho, không có trong kho, có trong kho nhưng chưa nối.
Store clean-up	Danh sách sản phẩm trên store không có trong kho; xuất CSV để nhân viên dọn trên Shopify.

Nút trên đầu trang: Import products (mở cửa sổ import), Push what a store is missing, Scan stores for library products (admin).

Import

Import chỉ ghi sản phẩm không trùng vào kho, dưới niche đã chọn, và không bao giờ đẩy lên store.

Bấm Import products, chọn niche (bắt buộc). App hiện các store của niche đó kèm link Admin / Store.
Thả file .csv, .xlsx, .xls: tối đa 100MB mỗi file, 100 file một lần. Mỗi file thành một bản ghi riêng ở tab Files.
Check for duplicates chạy nền, ra bảng từng file: số sản phẩm, mới, trùng, dòng lỗi, kèm nút tải danh sách trùng.
Import chạy nền, chỉ ghi sản phẩm mới. Xong thì app tự quét các store của niche.

Luật trùng — sản phẩm bị cắt khỏi file khi:

Handle đã có trong kho (kể cả nộp lại chính file cũ). Import không ghi đè; muốn sửa thì vào trang sản phẩm.
Ảnh chính (ảnh đầu tiên) trùng một sản phẩm trong kho. Title không tính.
Lặp handle hoặc ảnh chính với dòng phía trên trong cùng file: giữ dòng đầu.

Nhóm sản phẩm dùng chung ảnh placeholder (ví dụ 3.604 mẫu giày high-top) sẽ bị cắt oan nếu import thêm mẫu dùng đúng ảnh đó.

Gán niche và quét store

Gán niche ở bất kỳ đâu cũng làm app tự quét các store của niche đó và nối sản phẩm theo handle. Không có gì được đẩy lên store.

Chỉ nối khi sản phẩm cùng niche với store và trùng handle. Sản phẩm thuộc file chưa gán niche không bao giờ được nối. Đang có đợt quét cùng niche chưa xong thì app không quét chồng.

Sửa sản phẩm, Push và đồng bộ

Sửa một sản phẩm đã nối rồi bấm Save thì app ghi đè bản trên mọi store đang có nó: title, mô tả, giá, ảnh, variant. Trung bình mỗi sản phẩm nằm trên khoảng 7–9 store.

Hành động	Kết quả
Save trên trang sản phẩm	Đẩy bản mới ra các store đã nối + store cùng niche đang có handle đó.
Edit selected (hàng loạt)	Như trên cho từng sản phẩm; 100 sản phẩm ≈ 900 lượt cập nhật trên Shopify.
Push to selling stores	Đưa sản phẩm lên store lần đầu (theo handle, không tạo bản trùng).
Push what a store is missing	Đẩy các sản phẩm của niche mà store chưa có.
Remove from selling stores / Delete	Gỡ khỏi store (xoá vĩnh viễn trên Shopify), rồi mới xoá khỏi kho nếu chọn.

Luật chặn

Niche không sửa lẻ trên sản phẩm: trang sản phẩm chỉ hiện "Follows its file", đổi ở tab Files.
Push bỏ qua sản phẩm chưa có niche và báo rõ; "Live on stores" luôn chỉ gồm sản phẩm có niche.
Đồng bộ một chiều, từ kho ra store. Sửa tay trên Shopify sẽ bị lần sửa kế tiếp trong kho đè mất.
Store lỗi (mất token…) bị bỏ qua và ghi tên trên job, các store khác vẫn cập nhật.

Stores và Store clean-up

Mỗi lần quét một store, app đọc toàn bộ sản phẩm trên store và xếp mỗi sản phẩm vào đúng một ô.

Ô	Điều kiện	Hiện ở
Đã nối	Handle có trong kho, sản phẩm cùng niche với store	Stores · Live on stores
Có trong kho, chưa nối	Handle có trong kho nhưng file chưa gán niche, hoặc khác niche	Stores
Not in library	Handle và ảnh chính đều không có trong kho	Stores · Store clean-up
In library under another handle	Ảnh chính trùng sản phẩm trong kho nhưng handle khác (bản trùng)	Stores · Store clean-up

Stores: số đếm theo từng store (tổng lấy thẳng từ Shopify). Bấm số "Not in library" để mở danh sách dọn của store đó. Admin có nút Recount all stores.

Store clean-up: danh sách để nhân viên dọn. Lọc theo niche, store, loại; mỗi dòng có link Shopify admin; Export CSV để giao việc. App chỉ liệt kê, không xoá gì. Sản phẩm đã xoá trên store tự rơi khỏi danh sách ở lần quét sau.

1.117.870sản phẩm trên 335 store

67.830đã nối với kho

193.876không có trong kho

856.164có trong kho, chưa nối

Quyền và lưu ý vận hành

Quyền (User Management)	Được làm
Product Library — view & search	Xem kho, Files, Stores, Store clean-up trong niche của mình
Import & edit products	Import (chọn niche trong phạm vi của mình), sửa sản phẩm
Assign a niche to an imported file	Đổi niche của file đã import
Push to SELLING stores & sync	Push, Push what a store is missing, Sync
Administer	Xoá, gỡ khỏi store, quét store, Recount all stores

Nhân viên không phải admin chỉ thấy sản phẩm, file và store thuộc các niche được giao.

Thử sửa trên vài sản phẩm trước khi Edit selected hàng loạt, vì mỗi lần sửa đều ghi đè trên nhiều store.
Store để giá hoặc nội dung riêng sẽ bị đè khi sản phẩm trong kho được sửa.
Gán niche sai: đổi lại niche của file. Liên kết cũ không tự mất, báo dev để gỡ.
Cột niche của file hiện đỏ "Niche not applied — pick it again" thì chọn lại niche.
Job nền (import, gán niche, quét, đếm) hiện tiến độ trên banner đầu trang; quét cả 335 store mất khoảng 5–6 tiếng.