PRD: Đồng bộ đa kênh

Module	Kho	PRD ID	PRD-SYN-001
Trạng thái	Chưa tạo item	FEAT	SYN
Epic	—	Plane	—
Ngày	2026-07-13	Phiên bản	v1.0
Gói	@nx/inventory	URD	SYN
Surface	BackendClient · Chủ/QL
Phụ trách	Phát Nguyễn

Đồng bộ đa kênh là gì

Merchant nối gian hàng của mình trên một sàn thương mại điện tử vào BANA thành một kênh bán bên ngoài (External Channel). Từ lúc đó, BANA là nơi duy nhất quyết định gian hàng còn bao nhiêu hàng để bán.

Mỗi kênh bên ngoài rút hàng từ đúng một kho (InventoryLocation) của một chi nhánh (Merchant). Kênh không có tồn riêng: nó chỉ là nơi trưng bày con số của cùng một mục kho.

Bốn chỉ số trong tồn kho

Trích từ Kho & mức tồn để khỏi phải mở PRD khác. Mỗi mặt hàng ở mỗi kho mang bốn con số:

Con số	Hệ thống gọi	Nghĩa
Thực có	on-hand	Hàng đang nằm trong kho
Đang giữ	reserved	Đã hứa cho một chứng từ khác, không bán cho ai được nữa
Khả dụng	available	Phần còn bán được
Đang về	incoming	Đã rời kho gửi, chưa tới kho nhận

Bất biến, đúng ở mọi thời điểm:

Khả dụng = Thực có - Đang giữ

Sàn nhận đúng con số khả dụng, trừ tiếp khoản đệm (Buffer) nếu merchant có đặt.

Vì sao phải có một nguồn tồn kho duy nhất

Một quán hoặc một merchant bán lẻ hiếm khi chỉ bán ở một chỗ. Cùng một thùng hàng trong kho được chào bán ở quầy, trên ứng dụng giao đồ ăn, và trên gian hàng của sàn thương mại điện tử. Kho chỉ có một, nhưng số hàng đang được hứa ở ba nơi cùng lúc.

Hai lỗi kinh điển xảy ra khi không có một nguồn tồn kho duy nhất. Thứ nhất là bán quá tay: khách trên sàn đặt món mà hàng đã bán hết ở quầy từ sáng, merchant phải hủy đơn và chịu phạt điểm uy tín. Thứ hai là tồn ảo: hai phần mềm cùng ghi tồn lên một gian hàng, mỗi bên ghi một con số theo cách hiểu của mình, và con số hiển thị cuối cùng không đúng với bất kỳ ai.

BANA giải bài này bằng cách nhận vai trò nguồn tồn kho duy nhất. Mọi kênh bán, kênh nội bộ tại quầy lẫn gian hàng trên sàn, đều rút hàng từ cùng một bảng tồn. Đơn từ sàn về thì đi đúng đường bán hàng như một đơn tại quầy, không có đường tắt.

Một mặt hàng từ đầu tới cuối

Mặt hàng Y tại kho A. Kênh gán vào kho A. Khoản đệm ban đầu 0.

Việc xảy ra	Thực có	Đang giữ	Khả dụng	Khoản đệm	Số đẩy lên sàn
Ghép mặt hàng Y với gian hàng	50	5	45	0	45
Đặt khoản đệm 3 cho Y	50	5	45	3	42
Thu ngân bán 2 đơn vị tại quầy	48	5	43	3	40
Khách trên sàn đặt 2 đơn vị	46	5	41	3	38
Merchant lỡ đặt khoản đệm 60	46	5	41	60	0

• Số đẩy lên sàn là khả dụng trừ khoản đệm, chặn dưới ở 0. Không bao giờ đẩy số âm.
• 5 đơn vị đang giữ cho đơn tại quầy không bao giờ được chào bán trên sàn.
• Đơn từ sàn đi đúng đường của một đơn tại quầy: giữ tồn, trừ tồn, ghi sổ biến động. Xong là BANA đẩy lại con số mới.

Chỗ dễ sai nhất

Tồn chỉ chảy một chiều, từ BANA xuống sàn

BANA có đọc con số tồn đang hiển thị trên gian hàng về, nhưng chỉ để đối chiếu với con số mình vừa đẩy và bật cảnh báo khi lệch. Con số đọc về không bao giờ được ghi vào bảng tồn của BANA.

Ghi ngược lại là mở đường cho tồn ảo: sàn nói còn 99, BANA ghi theo 99, rồi lần đẩy sau BANA lại tính ra 42 và ghi đè. Hai bên đá nhau, và con số cuối cùng không đúng với ai cả.

Hệ quả: người dùng sửa tồn thẳng trên trang quản trị của sàn thì con số đó chỉ sống tới lần đẩy kế tiếp. Muốn đổi con số trên sàn thì đổi tồn hoặc đổi khoản đệm trong BANA.

1. Mục tiêu & Loại trừ

Mục tiêu

• Cho merchant nối một gian hàng trên sàn vào BANA, và ghép từng mặt hàng trên sàn với đúng một mục kho trong BANA.
• Đẩy tồn một chiều từ BANA xuống sàn, không nhận chiều ngược lại.
• Đẩy con số khả dụng (thực có trừ đang giữ), không phải số thực có.
• Cho merchant đặt một khoản đệm cấu hình được, mặc định 0, ở cấp kênh và ghi đè được ở từng mặt hàng.
• Kéo đơn phát sinh trên sàn về BANA và cho nó đi qua đúng đường giữ tồn và trừ tồn của một đơn bán bình thường.
• Đẩy lại tồn mới lên sàn ngay sau khi tồn của mặt hàng thay đổi vì bất kỳ lý do gì.
• Cho merchant thấy lịch sử và tình trạng đồng bộ của từng mặt hàng trên từng kênh.

Loại trừ

• Đồng bộ danh mục sản phẩm, giá bán, khuyến mãi và hình ảnh lên sàn. PRD này chỉ nói về tồn kho.
• Đối soát tiền và phí sàn, thuộc module Tài chính.
• Đường vận chuyển và trạng thái giao hàng của đơn từ sàn, thuộc module Bán hàng.
• Cách tính số khả dụng và cơ chế giữ tồn, thuộc feature Giữ tồn và feature Mục kho & mức tồn.
• Cấu trúc dòng sổ biến động và bộ mã lý do, thuộc feature Sổ biến động.
• Chiều ngược lại (sàn ghi tồn vào BANA) - không hỗ trợ, kể cả về sau.

2. Thước đo thành công

Thước đo	Mục tiêu / tín hiệu
Bán quá tay trên sàn	Số đơn từ sàn bị merchant hủy vì hết hàng giảm dần về 0
Độ trễ đồng bộ	Sau một lần bán tại quầy, con số hiển thị trên gian hàng khớp lại với BANA trong vòng vài chục giây
Độ phủ ghép mặt hàng	100% mặt hàng đang bán trên gian hàng đều ghép được với một mục kho trong BANA
Sạch tồn ảo	Không gian hàng nào có hai hệ cùng ghi tồn
Tin cậy của merchant	Merchant không phải mở gian hàng ra sửa tồn bằng tay nữa

3. Persona & Tình huống

Persona	Mục tiêu trong tính năng này
Owner / Manager	Nối gian hàng, ghép mặt hàng, đặt khoản đệm, theo dõi lịch sử đồng bộ
Cashier	Bán tại quầy như bình thường và tin rằng hàng mình vừa bán không còn được chào trên sàn
Nhân viên kho	Xử lý đơn từ sàn giống như một đơn giao hàng bình thường, không phải trừ tay

Kịch bản cốt lõi: chủ merchant nối gian hàng trên sàn vào BANA và ghép từng mặt hàng → BANA đẩy số khả dụng trừ khoản đệm lên gian hàng → khách trên sàn đặt hàng → đơn được kéo về BANA, giữ tồn rồi trừ tồn như một đơn bán bình thường, ghi sổ biến động → BANA tính lại khả dụng và đẩy con số mới lên đúng gian hàng đó → cùng lúc, mỗi lần thu ngân bán một món tại quầy thì con số trên gian hàng cũng giảm theo.

4. User Stories

#	Là một	Tôi muốn	Để
01	chủ merchant	nối gian hàng trên sàn vào BANA	tôi không phải ngồi sửa tồn trên sàn bằng tay mỗi tối
02	chủ merchant	số hàng đã nằm trong giỏ của khách tại quầy không còn được chào bán trên sàn	tôi không phải hủy đơn của khách trên sàn
03	chủ merchant	giữ lại vài đơn vị không chào lên sàn	đơn tại quầy vẫn còn hàng khi sàn bán mạnh
04	chủ merchant	đơn từ sàn trừ kho tự động	sổ kho của tôi không bị lệch vì quên trừ tay
05	chủ merchant	biết BANA đã đẩy con số nào lên sàn lúc nào	khi số trên sàn trông lạ thì tôi tra được ngay
06	chủ merchant	hệ thống cảnh báo nếu còn phần mềm khác cùng ghi tồn lên gian hàng của tôi	tôi biết vì sao số cứ nhảy loạn

5. Yêu cầu chức năng

#	Yêu cầu	Trạng thái	URD ref
FR-001	Merchant nối một gian hàng trên sàn thương mại điện tử vào BANA thành một kênh bán bên ngoài. • Form nối kênh có các ô: sàn (bắt buộc), tên gian hàng (bắt buộc), kho lấy hàng cho kênh này (bắt buộc), khoản đệm mặc định của kênh (tùy chọn, mặc định 0). • Một kênh bên ngoài luôn rút hàng từ đúng một kho. • Kênh có hai trạng thái: Đang đồng bộ và Tạm dừng. Tạm dừng thì BANA ngưng đẩy tồn nhưng giữ nguyên cấu hình.	🚧	URD-SYN-007
FR-002	Kênh bán nội bộ và kênh bán bên ngoài dùng chung một bảng tồn. • Kênh bán nội bộ do merchant tự khai. BANA gieo sẵn một bộ mặc định theo ngành (quán ăn: tại chỗ, mang đi; bán lẻ: tại quầy, trực tuyến), và merchant sửa hoặc thêm kênh của mình được. • Kênh bên ngoài không có kho riêng và không có con số tồn riêng. Nó chỉ là nơi trưng bày con số khả dụng của cùng một mục kho.	🚧	URD-SYN-001
FR-003	Từng mặt hàng trên gian hàng được ghép với đúng một mục kho trong BANA. • Màn ghép hiện hai cột: mặt hàng trên sàn và mục kho tương ứng trong BANA, tìm được theo tên hoặc mã. • Một mục kho ghép được với nhiều mặt hàng trên nhiều sàn. Nhưng một mặt hàng trên một sàn chỉ ghép với đúng một mục kho. • Mặt hàng chưa ghép thì không được đồng bộ, và mang nhãn Chưa ghép trong danh sách.	🚧	URD-SYN-008
FR-004	Tồn chảy một chiều từ BANA xuống sàn. • BANA ghi tồn lên gian hàng. Con số tồn hiển thị trên sàn không bao giờ được đọc ngược về ghi đè vào BANA. • Người dùng sửa tồn thẳng trên trang quản trị của sàn thì lần đẩy kế tiếp của BANA ghi đè lại con số đó.	🚧	URD-SYN-001 · URD-SYN-006
FR-005	Con số BANA đẩy lên sàn là khả dụng, không phải thực có. • Khả dụng bằng thực có trừ đang giữ, lấy tại kho đã gán cho kênh. • Hàng đang giữ cho một đơn tại quầy, một phiếu chuyển kho hay một lệnh sản xuất đều không được chào bán trên sàn.	🚧	URD-SYN-002
FR-006	Số đẩy lên sàn trừ thêm một khoản đệm cấu hình được. • Khoản đệm đặt ở cấp kênh, mặc định 0, và ghi đè được cho từng mặt hàng của kênh đó. • Số đẩy lên sàn bằng khả dụng trừ khoản đệm. Kết quả âm thì đẩy 0, không đẩy số âm. • Đổi khoản đệm là kích hoạt một lần đẩy lại ngay cho các mặt hàng bị ảnh hưởng.	🚧	URD-SYN-003
FR-007	Đơn phát sinh trên sàn được kéo về BANA và trở thành một đơn bán bình thường. • Đơn từ sàn mang nhãn kênh bán là chính kênh bên ngoài đó, để báo cáo doanh thu tách được theo kênh. • Đơn đi qua đúng đường giữ tồn rồi trừ tồn như đơn tại quầy, và ghi sổ biến động như mọi lần trừ tồn khác. • Cùng một đơn từ sàn, dù được kéo về nhiều lần, cũng chỉ trừ kho một lần. • Đơn từ sàn rơi vào mặt hàng chưa ghép thì nằm lại ở danh sách đơn cần xử lý kèm lý do. Hệ thống không trừ kho mù.	🚧	URD-SYN-004
FR-008	Ngay sau khi trừ kho cho đơn từ sàn, BANA tính lại khả dụng và đẩy con số mới lên chính sàn đó. • Mặt hàng đó cũng được đẩy lại lên mọi kênh bên ngoài khác đang bán cùng mục kho, để hai sàn không cùng chào bán một món đã hết. • Đơn từ sàn bị hủy thì phần hàng đã giữ hoặc đã trừ được trả lại kho, và con số mới lại được đẩy lên.	🚧	URD-SYN-005
FR-009	Mọi thay đổi tồn của một mục kho đều kích hoạt đẩy lại lên các kênh bên ngoài đang bán mục kho đó. • Nguồn kích hoạt: bán tại quầy, nhập hàng, chuyển kho, kiểm kê, hủy hàng, và đơn từ chính các sàn. • Nhiều thay đổi liên tiếp trên cùng một mặt hàng được gom thành một lần đẩy con số mới nhất, không đẩy từng nhịp một.	🚧	URD-SYN-005
FR-010	Một gian hàng chỉ nhận cập nhật tồn từ đúng một nguồn là BANA. • Lúc nối kênh, merchant phải tick xác nhận đã gỡ mọi phần mềm khác đang ghi tồn lên gian hàng này. • BANA đẩy con số X, lần đọc lại thấy sàn đang hiển thị một con số khác mà không do đơn từ sàn gây ra: kênh hiện cảnh báo Có hệ khác đang ghi tồn, kèm hướng dẫn xử lý. • Cảnh báo là để merchant nhìn thấy. Nó không tự tắt kênh.	🚧	URD-SYN-006
FR-011	Merchant xem được lịch sử đồng bộ của từng mặt hàng trên từng kênh. • Mỗi dòng lịch sử ghi: thời điểm đẩy, con số khả dụng, khoản đệm đã trừ, con số cuối đẩy lên sàn, và kết quả Thành công hoặc Lỗi kèm lý do. • Lần đẩy lỗi được thử lại tự động. Quá số lần thử thì mặt hàng mang nhãn Đồng bộ lỗi, và merchant bấm đẩy lại bằng tay được. • Danh sách lọc được theo kênh, theo mặt hàng và theo kết quả.	🚧	URD-SYN-009
FR-012	Kênh bên ngoài là dữ liệu riêng của từng chi nhánh (Merchant). • Người dùng chỉ thấy và cấu hình kênh thuộc chi nhánh của chính mình. • Xóa kênh là xóa mềm. Kênh đã xóa ngưng đẩy tồn ngay, và con số cuối cùng đã đẩy vẫn nằm lại trên sàn cho tới khi merchant tự sửa.	🚧	URD-SYN-007

5.1 Tiêu chí nghiệm thu

• Vào mục Kênh bán ở trang Client, bấm Nối kênh, chọn sàn, đặt tên gian hàng và chọn kho A → kênh được tạo ở trạng thái Đang đồng bộ, khoản đệm hiện 0.
• Mở màn ghép mặt hàng của kênh vừa nối, ghép mặt hàng Y trên sàn với mục kho Y trong BANA → nhãn Chưa ghép biến mất, mặt hàng Y vào danh sách được đồng bộ.
• Để một mặt hàng trên sàn chưa ghép rồi bấm đồng bộ → mặt hàng đó không được đẩy tồn và vẫn giữ nhãn Chưa ghép.
• Mặt hàng Y có thực có 50, đang giữ 5, khoản đệm 0 → chạy đồng bộ → con số đẩy lên sàn là 45, không phải 50.
• Đặt khoản đệm 3 cho mặt hàng Y rồi lưu → hệ thống tự đẩy lại ngay, con số trên sàn thành 42.
• Đặt khoản đệm 60 cho một mặt hàng chỉ còn 45 khả dụng → con số đẩy lên sàn là 0, không phải số âm.
• Bán 2 đơn vị mặt hàng Y tại quầy trên POS → mở lịch sử đồng bộ của Y → thấy một dòng đẩy mới với con số 40, kết quả Thành công.
• Có đơn từ sàn mua 2 đơn vị mặt hàng Y → đơn hiện trong danh sách đơn bán với nhãn kênh là tên gian hàng → tồn thực có của Y giảm 2, sổ biến động có một dòng mới trỏ về đơn đó.
• Ngay sau đơn ở bước trên, xem lịch sử đồng bộ của Y → thấy một dòng đẩy mới ứng với số khả dụng đã tính lại và trừ khoản đệm.
• Kéo lại cùng một đơn từ sàn lần thứ hai → tồn của Y không giảm thêm lần nữa, sổ biến động không có dòng mới.
• Hủy một đơn từ sàn đã trừ kho → tồn của Y tăng lại đúng phần đã trừ, và một dòng đẩy mới xuất hiện trong lịch sử đồng bộ.
• Có đơn từ sàn cho một mặt hàng chưa ghép → đơn nằm ở danh sách đơn cần xử lý kèm lý do Chưa ghép mặt hàng, tồn không đổi.
• Ghép mặt hàng Y với hai gian hàng trên hai sàn khác nhau, rồi bán hết hàng tại quầy → cả hai gian hàng đều nhận con số 0.
• Vào trang quản trị của sàn sửa tay tồn của Y thành 999, rồi bán một món tại quầy → lần đẩy kế tiếp của BANA ghi đè, con số trên sàn quay về đúng số khả dụng trừ khoản đệm.
• Nối kênh mà không tick xác nhận đã gỡ phần mềm khác đang ghi tồn → nút Nối kênh không bật.
• Đẩy con số 42 lên gian hàng, rồi cho một hệ ngoài ghi đè thành 99 mà không có đơn từ sàn nào → kênh hiện cảnh báo Có hệ khác đang ghi tồn kèm hướng dẫn xử lý, kênh vẫn chạy.
• Mặt hàng Y khả dụng 45 → cùng lúc kiểm ở POS và ở gian hàng trên sàn: cả hai đều rút từ cùng con số 45, gian hàng không có tồn riêng.
• Xóa kênh đã nối → không còn dòng đẩy mới nào, con số cuối cùng vẫn đứng nguyên trên gian hàng.
• Sàn trả về lỗi cho một lần đẩy → dòng lịch sử ghi Lỗi kèm lý do, hệ thống thử lại; quá số lần thử thì mặt hàng hiện nhãn Đồng bộ lỗi và nút Đẩy lại xuất hiện.
• Chuyển kênh sang Tạm dừng rồi bán tại quầy → không có dòng đẩy mới nào trong lịch sử; bật lại Đang đồng bộ → con số hiện tại được đẩy lên ngay.
• Đăng nhập bằng tài khoản của merchant khác → không thấy kênh bên ngoài nào của merchant đầu tiên.

6. Yêu cầu phi chức năng

Khía cạnh	Yêu cầu
Một chiều tuyệt đối	Không có đường nào cho con số tồn từ sàn ghi vào bảng tồn của BANA; dữ liệu nhận từ sàn gồm đơn hàng, kết quả của lần đẩy, và con số tồn đọc về chỉ để đối chiếu cảnh báo - con số đọc về KHÔNG BAO GIỜ được ghi vào bảng tồn của BANA
Idempotency	Cùng một đơn từ sàn, dù nhận về bao nhiêu lần, chỉ trừ kho một lần; khóa chống trùng dựa trên mã đơn của sàn
Độ trễ	Từ lúc tồn đổi trong BANA tới lúc con số mới được gửi lên sàn không quá 60 giây trong điều kiện sàn hoạt động bình thường
Gom nhịp đẩy	Nhiều thay đổi tồn liên tiếp trên cùng một mặt hàng trong vòng vài giây được gom thành một lần đẩy con số mới nhất
Chịu lỗi	Sàn lỗi hoặc chậm không được làm chậm hay chặn việc bán tại quầy; hàng đợi đẩy tồn chạy tách khỏi đường bán hàng
Thứ tự	Với cùng một mặt hàng trên cùng một kênh, con số đẩy sau không bao giờ bị con số cũ hơn ghi đè
Phân quyền theo merchant	Mọi kênh, bản ghi ghép mặt hàng và dòng lịch sử đồng bộ được giới hạn trong merchant của chính người dùng; xóa là xóa mềm
Truy vết	Mỗi lần đẩy lưu lại con số khả dụng, khoản đệm và con số cuối, đủ để giải thích vì sao sàn hiển thị con số đó
i18n	Nhãn trạng thái kênh, nhãn kết quả đồng bộ và thông báo cảnh báo là song ngữ

7. UX & Luồng

Đường đi của một đơn từ sàn, và vòng phản hồi đẩy tồn:

Con số nào được đẩy lên sàn:

Màn hình nằm ở trang Client, trong mục Kênh bán: một màn danh sách kênh hiện tên gian hàng, sàn, kho gán cho kênh, khoản đệm mặc định và trạng thái Đang đồng bộ hay Tạm dừng; một màn ghép mặt hàng dạng hai cột; và một màn lịch sử đồng bộ dạng bảng với các cột Thời điểm, Mặt hàng, Kênh, Số khả dụng, Khoản đệm, Số đã đẩy, Kết quả.

8. Dữ liệu & Miền nghiệp vụ

Khái niệm	Vai trò
Kênh bên ngoài	Một gian hàng trên sàn đã nối vào BANA, gắn với đúng một địa điểm kho và một khoản đệm mặc định
Ghép mặt hàng	Cặp nối giữa một mặt hàng trên sàn và một mục kho trong BANA; không ghép thì không đồng bộ
Khoản đệm	Số hàng giữ lại không chào lên sàn; đặt ở cấp kênh, ghi đè được ở từng mặt hàng, mặc định 0
Số đẩy lên sàn	Số khả dụng tại kho của kênh, trừ khoản đệm, chặn dưới ở 0
Đơn từ sàn	Đơn bán mang nhãn kênh là một kênh bên ngoài; đi qua đúng đường giữ tồn và trừ tồn của đơn tại quầy
Lịch sử đồng bộ	Dòng ghi lại một lần đẩy: thời điểm, số khả dụng, khoản đệm, số đã đẩy, kết quả
Cảnh báo tồn ảo	Dấu hiệu có hệ khác cùng ghi tồn lên gian hàng, nhận ra khi con số trên sàn lệch khỏi con số BANA vừa đẩy mà không do đơn từ sàn

Chỉ ở mức khái niệm - schema và bất biến đầy đủ nằm trong inventory domain model.

9. Phụ thuộc & Giả định

Phụ thuộc vào

#	Feature	Phụ thuộc điều gì
01	STK Mục kho & mức tồn	nguồn của số thực có và số khả dụng được đẩy lên sàn.
02	RSV Giữ tồn	phần đang giữ bị trừ ra khỏi con số đẩy lên sàn, và là bước đầu tiên khi đơn từ sàn về.
03	LDG Sổ biến động	nơi lần trừ tồn cho đơn từ sàn được ghi lại.
04	LOC Địa điểm kho	mỗi kênh bên ngoài rút hàng từ đúng một địa điểm.
05	Module Bán hàng	đơn từ sàn được tạo và đi qua vòng đời đơn bán như một đơn tại quầy.

Giả định

#	Giả định	Sai thì sao
01	Sàn cho phép ghi tồn từ bên ngoài và trả về mã đơn ổn định để BANA chống trùng.	Sàn không cho ghi tồn thì không nối kênh được. Mã đơn không ổn định thì cùng một đơn bị trừ kho nhiều lần, và tồn tụt xuống âm không rõ lý do.
02	Sàn báo được đơn mới về cho BANA, hoặc BANA hỏi sàn định kỳ, và độ trễ của kênh đó nằm trong mức chấp nhận được của merchant.	Đơn về chậm hàng giờ thì tồn trên sàn luôn cao hơn thực tế trong khoảng đó, và bán quá tay quay lại đúng như trước khi nối kênh.
03	Merchant chấp nhận rằng con số trên sàn có thể trễ vài chục giây so với BANA, và bù rủi ro đó bằng khoản đệm.	Merchant kỳ vọng khớp tức thời thì mỗi lần lệch vài giây sẽ bị đọc là lỗi, và niềm tin vào con số trên sàn mất đi.
04	Merchant chỉ dùng BANA để ghi tồn lên gian hàng đã nối; mọi phần mềm khác đã được gỡ khỏi gian hàng đó.	Hai hệ cùng ghi thì con số trên gian hàng nhảy loạn, không đúng với hệ nào, và cảnh báo tồn ảo bật liên tục mà không tự sửa được.
05	Một mặt hàng trên sàn tương ứng với đúng một mục kho, không phải một combo được nổ ra nhiều mục kho.	Bán combo trên sàn thì không có một con số khả dụng nào để đẩy, và mặt hàng đó phải nằm ngoài phạm vi đồng bộ cho tới khi có luật tính số nhỏ nhất theo định lượng.

10. Kế hoạch phát hành & Tiêu chí

Khía cạnh	Kế hoạch
Phase	P2 (Kho v2) - xem danh mục feature URD
Rollout	Bật theo từng merchant khi merchant chủ động nối kênh; kênh nội bộ hiện có không đổi gì
Migration	Không có dữ liệu kênh bên ngoài cũ; lần đồng bộ đầu tiên của một kênh đẩy toàn bộ mặt hàng đã ghép
Tiêu chí phát hành	Kịch bản thực có 50, đang giữ 5, khoản đệm 3 ra con số 42 chạy đúng; đơn từ sàn trừ kho đúng một lần và đẩy lại tồn mới; sửa tồn tay trên sàn bị lần đẩy kế tiếp ghi đè
Theo dõi	Số đơn từ sàn bị hủy vì hết hàng, độ trễ đẩy tồn, tỉ lệ lần đẩy lỗi theo sàn, số mặt hàng chưa ghép

Tham chiếu

• URD: Đồng bộ đa kênh
• Liên quan: Mục kho & mức tồn · Giữ tồn & chặn bán quá tay · Sổ biến động · Địa điểm kho
• Module: Kho - URD
• Developer: @nx/inventory · domain model

Rủi ro & Câu hỏi mở

#	Rủi ro / câu hỏi	Giảm thiểu / trạng thái
01	Đẩy số thực có thay vì số khả dụng sẽ chào bán lại phần hàng đã giữ cho đơn tại quầy	Con số đẩy lên sàn là số khả dụng, đã trừ phần đang giữ (FR-005)
02	Nhiều hệ cùng ghi tồn lên một gian hàng sinh ra tồn ảo	Xác nhận bắt buộc lúc nối kênh và cảnh báo khi phát hiện con số lệch không do đơn từ sàn (FR-010)
03	Độ trễ giữa BANA và sàn vẫn để lọt một đơn bán quá tay trong khoảng vài giây	Khoản đệm cấu hình được cho phép merchant tự mua thêm biên an toàn (FR-006)
04	Đơn từ sàn được kéo về nhiều lần sẽ trừ kho nhiều lần	Chống trùng theo mã đơn của sàn, một đơn chỉ trừ kho một lần (FR-007)
05	Sàn lỗi hoặc giới hạn số lần gọi làm nghẽn hàng đợi đẩy tồn và tồn trên sàn đứng yên	Đẩy tồn chạy tách khỏi đường bán hàng, có thử lại và có nhãn Đồng bộ lỗi để merchant nhìn thấy (FR-011)
06	Combo và món pha chế trên sàn không tương ứng một-một với một mục kho	Mở: quyết định cách tính số khả dụng cho một mặt hàng trên sàn được nổ ra nhiều thành phần, dựa trên số nhỏ nhất theo định lượng
07	Merchant bán trên nhiều sàn thì một món hết hàng có thể chào bán lệch nhau giữa các sàn	Một thay đổi tồn đẩy lại lên mọi kênh đang bán cùng mục kho (FR-008)

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

#	Câu hỏi	Trả lời
01	Vì sao BANA đẩy số khả dụng chứ không đẩy số thực có?	Vì số thực có gồm cả phần hàng đã hứa cho người khác. Ba lon đang nằm trong giỏ của khách tại quầy vẫn còn trên kệ, nhưng chúng đã được bán rồi. Đẩy số thực có lên sàn là đem chính ba lon đó chào bán lần thứ hai, và đó là nguyên nhân bán quá tay phổ biến nhất.
02	Khoản đệm dùng để làm gì?	Để mua thêm một biên an toàn. Giữa lúc BANA đẩy con số và lúc sàn hiển thị nó luôn có một khoảng trễ; trong khoảng đó khách trên sàn vẫn có thể đặt. Merchant đặt khoản đệm 3 nghĩa là "đừng chào bán ba đơn vị cuối cùng trên sàn, để dành cho khách tại quầy". Mặc định là 0, tức là không giữ lại gì.
03	Sàn có ghi tồn ngược về BANA được không?	Không, và sẽ không bao giờ. Tồn chỉ chảy một chiều từ BANA xuống sàn. BANA có đọc con số tồn đang hiển thị trên gian hàng về, nhưng chỉ để đối chiếu với con số mình vừa đẩy và cảnh báo khi lệch; con số đọc về không bao giờ được ghi vào bảng tồn của BANA.
04	Tôi lỡ sửa tồn tay trên trang quản trị của sàn thì sao?	Con số đó tồn tại tới lần đẩy kế tiếp của BANA rồi bị ghi đè. Muốn đổi con số trên sàn thì đổi tồn hoặc đổi khoản đệm trong BANA, đừng sửa trên sàn.
05	Tôi đang dùng thêm một phần mềm quản lý sàn khác, có sao không?	Có. Hai hệ cùng ghi tồn lên một gian hàng thì mỗi bên ghi một con số theo cách hiểu của mình, và con số hiển thị cuối cùng không đúng với ai cả - đó là tồn ảo. BANA yêu cầu merchant xác nhận đã gỡ phần mềm kia lúc nối kênh, và cảnh báo nếu phát hiện dấu hiệu còn hệ khác đang ghi.
06	Đơn từ sàn có được trừ kho khác đơn tại quầy không?	Không. Nó đi đúng con đường của một đơn tại quầy: giữ tồn, trừ tồn, ghi sổ biến động. Khác biệt duy nhất là nhãn kênh bán, để báo cáo doanh thu tách được theo kênh.
07	Hiện tại "kênh bán" trong BANA là gì?	Là kênh bán nội bộ do merchant tự khai. BANA gieo sẵn một bộ mặc định theo ngành (quán ăn: tại chỗ, mang đi; bán lẻ: tại quầy, trực tuyến), và merchant sửa hoặc thêm kênh của mình được. Kênh bên ngoài mà PRD này mô tả nằm cùng chỗ với chúng và dùng chung một bảng tồn, chỉ khác ở chỗ có con số được đẩy ra ngoài.