PRD: Bổ sung hàng

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

Bổ sung hàng là gì

Bổ sung hàng (Replenishment) là màn gợi ý đặt hàng trên trang Client: danh sách những mặt hàng cần đặt lại, kèm số lượng đề nghị đặt cho từng mặt hàng.

Nó chạy trên tồn của các kho (InventoryLocation) thuộc một chi nhánh (Merchant), và trả lời hai câu: hôm nay cần đặt gì, và vốn của quán đang nằm ở nhóm hàng nào. Đây là công cụ gợi ý. Nó không tự lập đơn mua hàng, và không chặn thao tác nào của chủ merchant.

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ữ

Con số mà toàn bộ tính năng này so sánh là khả dụng.

Vì sao một ngưỡng gõ tay là không đủ

Một ngưỡng sắp hết hàng gõ tay cho từng mục kho là công cụ thô sơ nhất để biết khi nào cần nhập thêm hàng, vì nó là một con số tĩnh. Nó không biết mặt hàng đang bán nhanh hay chậm, không biết nhà cung cấp giao trong hai ngày hay hai tuần. Quán bán 20 ly một ngày và quán bán 200 ly một ngày cùng nhận cảnh báo ở mức 10 lon sữa, dù một bên còn nửa ngày là hết, một bên còn cả tuần.

Bổ sung hàng thay con số tĩnh đó bằng một con số động: đặt hàng lại khi tồn chỉ còn đủ bán tới lúc chuyến hàng tiếp theo về, cộng một khoản đệm cho những hôm bán vọt hoặc nhà cung cấp giao trễ. Dữ liệu để tính đã nằm sẵn trong hệ thống. Tốc độ bán lấy từ lịch sử bán hàng, thời gian giao lấy từ bản ghi nhà cung cấp - mặt hàng.

Đi kèm là câu thứ hai mà chủ merchant nào cũng hỏi: trong hàng trăm mặt hàng, mặt hàng nào đáng để mất công theo dõi. Phân nhóm ABC trả lời bằng giá trị tiêu thụ, tức số lượng bán nhân giá vốn. Mục đích ở đây là kiểm soát số vốn đang nằm chết trong kho, không phải xem mặt hàng nào ra doanh số đẹp.

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

Sữa lon. Cửa sổ lịch sử 30 ngày. Nhà cung cấp ưu tiên giao trung bình 3 ngày, lâu nhất 5 ngày. Quy cách đóng gói 24 lon một thùng, số lượng đặt tối thiểu 2 thùng.

Con số	Lấy từ đâu	Giá trị
Bán trung bình một ngày	lịch sử bán 30 ngày	20
Bán nhiều nhất một ngày	cùng cửa sổ đó	35
Thời gian giao trung bình	lịch sử nhận hàng thật	3 ngày
Thời gian giao lâu nhất	lịch sử nhận hàng thật	5 ngày
Tồn an toàn (Safety Stock)	(35 x 5) - (20 x 3)	115
Điểm đặt hàng lại (Reorder Point)	(20 x 3) + 115	175

• Khả dụng còn 200: mặt hàng không vào danh sách Cần đặt hàng.
• Khả dụng rơi xuống 170: mặt hàng vào danh sách, vì 170 đã dưới 175.
• Cần bổ sung 30 lon, nhưng số lượng đề nghị đặt hiện 2 thùng (48 lon), vì luôn làm tròn lên theo quy cách đóng gói và số lượng đặt tối thiểu.
• Quản lý kho gõ tay tồn an toàn 50: điểm đặt hàng lại tính lại thành 110. Con số gõ tay luôn thắng con số công thức tính ra.

Chỗ dễ sai nhất

Thiếu dữ liệu thì để trống, không bịa một con số

Mặt hàng có dưới 14 ngày phát sinh bán, hoặc chưa nhà cung cấp nào khai thời gian giao, thì dòng đó không hiện con số nào. Nó hiện đúng lý do đang thiếu: "Chưa đủ lịch sử bán", "Chưa khai thời gian giao".

Lấy thời gian giao bằng 0 cho mặt hàng chưa khai, hay lấy tốc độ bán từ ba ngày dữ liệu, đều cho ra một con số trông có vẻ khoa học mà không ai kiểm được. Merchant tin theo và đặt sai.

Hệ quả: dòng thiếu thời gian giao mang sẵn một lối tắt mở thẳng màn nhà cung cấp của mặt hàng đó, để merchant khai ngay rồi quay lại.

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

Mục tiêu

• Tính điểm đặt hàng lại cho từng mặt hàng theo tốc độ bán thực tế và thời gian giao của nhà cung cấp.
• Cho tồn an toàn có một con số mặc định tự tính được ngay từ dữ liệu thưa, và cho chủ merchant ghi đè bằng con số của chính mình.
• Nói thật khi dữ liệu chưa đủ để tính, thay vì đưa ra một con số không tin được.
• Đưa danh sách những mặt hàng đang dưới điểm đặt hàng lại, kèm số lượng đề nghị đặt đã làm tròn theo quy cách đóng gói và số lượng đặt tối thiểu của nhà cung cấp.
• Phân mặt hàng vào nhóm A, B, C theo giá trị tiêu thụ, với ngưỡng chia nhóm chỉnh được.
• Gợi ý tần suất kiểm kê luân phiên theo nhóm ABC.

Loại trừ

• Tự động lập đơn mua hàng từ gợi ý bổ sung. Chủ merchant bấm tạo đơn từ danh sách, hệ thống không tự gửi đơn cho nhà cung cấp.
• Dự báo nhu cầu theo mùa vụ, theo khuyến mãi, hay theo ngày lễ.
• Tối ưu số lượng đặt theo chi phí đặt hàng và chi phí lưu kho.
• Phân bổ hàng giữa các địa điểm kho (điều chuyển tự động).
• Chặn bán hoặc chặn thao tác khi một mặt hàng rơi xuống dưới điểm đặt hàng lại.

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

Thước đo	Mục tiêu / tín hiệu
Số lần hết hàng	Giảm dần sau khi merchant dùng danh sách Cần đặt hàng để lập đơn mua
Độ tin của gợi ý	Merchant giữ nguyên số lượng đề nghị đặt trong phần lớn trường hợp, thay vì gõ đè số khác
Độ phủ dữ liệu	Tỉ lệ mặt hàng có đủ dữ liệu để tính điểm đặt hàng lại tăng dần khi merchant khai thời gian giao cho nhà cung cấp
Vốn nằm trong kho	Merchant nhìn được nhóm A chiếm bao nhiêu phần trăm giá trị tiêu thụ, và điều chỉnh mức tồn của nhóm đó
Nhịp kiểm kê	Mặt hàng nhóm A được kiểm kê dày hơn nhóm C sau khi bật gợi ý tần suất

3. Persona & Tình huống

Persona	Mục tiêu trong tính năng này
Chủ merchant	Biết hôm nay cần đặt gì, đặt bao nhiêu; biết vốn đang nằm ở nhóm hàng nào
Quản lý kho	Đặt tồn an toàn cho những mặt hàng mình nắm rõ; dùng nhóm ABC để xếp lịch kiểm kê luân phiên
Nhân viên mua hàng	Mở danh sách Cần đặt hàng, chọn nhà cung cấp, tạo đơn mua hàng từ đó

Kịch bản cốt lõi: chủ merchant mở màn Bổ sung hàng đầu ngày → thấy 12 mặt hàng đã rơi xuống dưới điểm đặt hàng lại → xem số lượng đề nghị đặt của từng mặt hàng, sửa lại vài dòng theo cảm nhận riêng → chọn các dòng cùng một nhà cung cấp → bấm tạo đơn mua hàng.

4. User Stories

#	Là một	Tôi muốn	Để
01	chủ merchant	hệ thống nói cho tôi biết mặt hàng nào cần đặt lại hôm nay	tôi không phải đi đếm kệ rồi đoán
02	chủ merchant	điểm đặt hàng lại tính theo tốc độ bán thật của quán tôi và thời gian giao thật của nhà cung cấp tôi	tôi không phải sống với một ngưỡng cố định gõ từ năm ngoái
03	quản lý kho	gõ tay tồn an toàn cho những mặt hàng tôi nắm rõ	tôi luôn giữ được hai thùng sữa dự phòng như tôi vẫn làm
04	chủ merchant	hệ thống nói thẳng là chưa đủ dữ liệu	tôi không phải nhận một con số mà tôi không dám tin
05	nhân viên mua hàng	số lượng đề nghị đặt đã làm tròn theo thùng và theo số lượng đặt tối thiểu của nhà cung cấp	tôi không phải tự nhân chia lại
06	chủ merchant	biết mặt hàng nào ngốn nhiều vốn nhất	tôi theo dõi kỹ những mặt hàng đó và buông những mặt hàng lặt vặt
07	quản lý kho	hệ thống gợi ý mặt hàng nào nên kiểm kê tuần này	tôi kiểm luân phiên thay vì đóng cửa kiểm cả kho một lần

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

#	Yêu cầu	Trạng thái	URD ref
FR-001	Cảnh báo sắp hết hàng chạy theo ba tầng ngưỡng và dùng tầng đầu tiên có khai. Nó độc lập với điểm đặt hàng lại bên dưới. • Ngưỡng riêng của một mục kho: merchant gõ tay ngay trên màn Tồn kho. • Ngưỡng chung cho cả mặt hàng: merchant khai trên form mặt hàng, áp cho mọi kho. • Ngưỡng mặc định của hệ thống: merchant không khai gì thì vẫn nhận cảnh báo theo con số này. • Hệ thống cảnh báo khi khả dụng rơi xuống bằng hoặc dưới ngưỡng đang áp mà vẫn còn trên 0. Khả dụng về 0 hoặc âm là trạng thái khác - hết hàng, hoặc bán quá tay - không còn là sắp hết.	🔶	URD-STK-005
FR-002	Nhu cầu bán trung bình mỗi ngày của một mặt hàng tính từ lịch sử bán hàng. • Cửa sổ lịch sử mặc định 30 ngày gần nhất, merchant chỉnh được trong màn cấu hình bổ sung hàng. • Số bán lấy theo đơn vị gốc của mặt hàng, gồm cả lượng nổ ra từ công thức của món pha chế. • Cùng cửa sổ đó, hệ thống lấy ra ngày bán nhiều nhất để dùng cho công thức tồn an toàn.	🚧	URD-RPL-001
FR-003	Điểm đặt hàng lại bằng nhu cầu bán trung bình mỗi ngày nhân thời gian giao, cộng tồn an toàn. • Thời gian giao lấy từ bản ghi nhà cung cấp - mặt hàng của nhà cung cấp đang được đánh dấu ưu tiên. • Mặt hàng chưa có nhà cung cấp ưu tiên thì lấy thời gian giao dài nhất trong các nhà cung cấp đang chào bán mặt hàng đó. • Điểm đặt hàng lại tính theo từng mặt hàng, dùng khả dụng cộng dồn trên toàn bộ kho.	🚧	URD-RPL-001 · URD-VEN-003
FR-004	Tồn an toàn mặc định tính theo công thức max-min. • Công thức: (bán nhiều nhất một ngày x thời gian giao lâu nhất) trừ (bán trung bình một ngày x thời gian giao trung bình). • Thời gian giao lâu nhất và trung bình lấy từ lịch sử các lần nhận hàng thật. Chưa có lịch sử nhận hàng thì cả hai cùng lấy số ngày khai trên bản ghi nhà cung cấp - mặt hàng. • Công thức ra số âm thì tồn an toàn bằng 0.	🚧	URD-RPL-002
FR-005	Merchant gõ tay tồn an toàn cho một mặt hàng ngay tại dòng của mặt hàng đó. Con số gõ tay luôn thắng con số công thức tính ra, cho tới khi merchant xóa nó đi.	🚧	URD-RPL-003
FR-006	Hệ thống không đưa ra con số gợi ý khi dữ liệu chưa đủ, và nói rõ đang thiếu gì. • Mặt hàng có dưới 14 ngày phát sinh bán trong cửa sổ lịch sử: dòng hiện "Chưa đủ lịch sử bán". • Mặt hàng không có nhà cung cấp nào khai thời gian giao: dòng hiện "Chưa khai thời gian giao", kèm lối tắt mở thẳng màn nhà cung cấp của mặt hàng đó. • Merchant đã gõ tay tồn an toàn thì dòng vẫn tính được điểm đặt hàng lại, dù lịch sử bán còn mỏng.	🚧	URD-RPL-001
FR-007	Công thức thống kê theo độ lệch chuẩn và mức phục vụ là một lựa chọn nâng cao, không phải công thức chạy sẵn. • Merchant tự bật cho từng mặt hàng, không bật một lần cho cả merchant. • Nó không bao giờ là công thức mặc định. Mặt hàng không bật thì vẫn dùng công thức max-min. • Chỉ mở được cho mặt hàng có từ 90 ngày lịch sử bán trở lên.	🚧	URD-RPL-004
FR-008	Màn Cần đặt hàng liệt kê những mặt hàng có khả dụng đã rơi xuống bằng hoặc dưới điểm đặt hàng lại. • Cột hiển thị: mặt hàng, khả dụng, điểm đặt hàng lại, tồn an toàn, nhà cung cấp ưu tiên, thời gian giao, số lượng đề nghị đặt. • Số lượng đề nghị đặt đưa tồn về mức đủ bán hết một chu kỳ giao hàng kể từ điểm đặt hàng lại, rồi làm tròn lên theo quy cách đóng gói và số lượng đặt tối thiểu của nhà cung cấp ưu tiên. • Merchant sửa được số lượng đề nghị đặt ngay trên dòng. • Merchant chọn nhiều dòng cùng một nhà cung cấp rồi bấm tạo đơn mua hàng. Các dòng đã chọn được mang thẳng vào đơn mua hàng mới.	🚧	URD-RPL-008 · URD-RPL-009 · URD-VEN-003
FR-009	Mặt hàng được xếp vào nhóm A, B hoặc C theo giá trị tiêu thụ. • Giá trị tiêu thụ của một mặt hàng bằng số lượng bán trong kỳ nhân giá vốn hiện tại của nó. • Mặt hàng xếp giảm dần theo giá trị tiêu thụ, rồi cộng dồn tỉ trọng để cắt nhóm. • Merchant đổi được cơ sở phân nhóm sang doanh thu, nhưng giá vốn là mặc định. • Kỳ phân nhóm mặc định 90 ngày gần nhất, chỉnh được.	🚧	URD-RPL-005
FR-010	Ngưỡng chia nhóm A/B/C mặc định 80/15/5 theo tỉ trọng giá trị tiêu thụ cộng dồn, và merchant chỉnh được. • Merchant gõ ba con số của mình trong màn cấu hình bổ sung hàng. • Tổng ba con số phải bằng 100, không đủ thì không lưu được. • Đổi ngưỡng xong, nhóm ABC của mọi mặt hàng được xếp lại theo ngưỡng mới.	🚧	URD-RPL-006
FR-011	Nhóm ABC của một mặt hàng gợi ý tần suất kiểm kê luân phiên cho mặt hàng đó. • Tần suất mặc định: nhóm A mỗi tuần, nhóm B mỗi tháng, nhóm C mỗi quý. Merchant chỉnh được từng nhóm. • Mặt hàng quá hạn kiểm theo tần suất của nhóm mình được đánh dấu "Đến hạn kiểm", và được gợi ý sẵn khi merchant mở phiếu kiểm kê mới. • Đây là gợi ý. Nó không chặn merchant kiểm mặt hàng nào tùy ý.	🚧	URD-RPL-007
FR-012	Màn cấu hình bổ sung hàng giữ các tham số dùng chung cho cả chi nhánh (Merchant). • Cửa sổ lịch sử tính nhu cầu bán trung bình, mặc định 30 ngày. • Cơ sở phân nhóm ABC (giá vốn hoặc doanh thu) và kỳ phân nhóm, mặc định giá vốn và 90 ngày. • Ba ngưỡng chia nhóm A/B/C, mặc định 80/15/5. • Tần suất kiểm kê luân phiên gợi ý cho từng nhóm.	🚧	URD-RPL-006 · URD-RPL-007

5.1 Tiêu chí nghiệm thu

• Gõ ngưỡng sắp hết hàng 10 cho một mục kho, bán cho tồn khả dụng còn đúng 10 → mục kho đó hiện cảnh báo sắp hết hàng (bằng ngưỡng đã là cảnh báo); bán tiếp cho tồn khả dụng về 0 → mục kho chuyển sang trạng thái hết hàng, không còn là sắp hết.
• Một mục kho không khai ngưỡng riêng, mặt hàng của nó cũng không khai ngưỡng chung → mục kho vẫn nhận cảnh báo sắp hết hàng theo ngưỡng mặc định của hệ thống.
• Một mặt hàng chưa được gán nhà cung cấp ưu tiên nhưng có hai nhà cung cấp khai thời gian giao 3 ngày và 6 ngày → điểm đặt hàng lại của mặt hàng đó tính theo 6 ngày, là thời gian giao dài nhất.
• Một nguyên liệu chỉ được tiêu thụ qua công thức của món pha chế, không bán trực tiếp → bán 100 ly món dùng 30ml nguyên liệu mỗi ly → nhu cầu bán của nguyên liệu ghi nhận 3.000ml, không phải 0.
• Một mặt hàng bán trung bình 20 đơn vị/ngày, bán nhiều nhất 35 đơn vị/ngày; nhà cung cấp giao trung bình 3 ngày, lâu nhất 5 ngày → mở màn Cần đặt hàng → tồn an toàn hiện 115, điểm đặt hàng lại hiện 175.
• Cùng mặt hàng đó, bán cho tồn khả dụng còn 170 → mặt hàng xuất hiện trong danh sách Cần đặt hàng; tồn còn 200 → mặt hàng không xuất hiện.
• Bán nhiều nhất một ngày bằng đúng bán trung bình, thời gian giao lâu nhất bằng thời gian giao trung bình → tồn an toàn hiện 0, không hiện số âm.
• Gõ tay tồn an toàn 50 cho một mặt hàng đang được công thức tính ra 115 → điểm đặt hàng lại tính lại theo 50; xóa con số gõ tay → điểm đặt hàng lại quay về tính theo 115.
• Mở màn Cần đặt hàng với một mặt hàng mới bán được 5 ngày → dòng đó hiện "Chưa đủ lịch sử bán", không hiện con số điểm đặt hàng lại.
• Một mặt hàng chưa có nhà cung cấp nào khai thời gian giao → dòng hiện "Chưa khai thời gian giao" kèm lối tắt sang màn nhà cung cấp của mặt hàng đó; khai thời gian giao 4 ngày xong quay lại → dòng hiện đủ điểm đặt hàng lại.
• Một mặt hàng chỉ mới bán 5 ngày nhưng đã được gõ tay tồn an toàn → dòng vẫn tính được điểm đặt hàng lại, không báo thiếu lịch sử.
• Mở tùy chọn nâng cao cho một mặt hàng có 30 ngày lịch sử bán → công thức thống kê theo độ lệch chuẩn không bật được; mở cho mặt hàng có 120 ngày lịch sử → bật được.
• Một mặt hàng có quy cách đóng gói 24 đơn vị một thùng và số lượng đặt tối thiểu 2 thùng, cần bổ sung 30 đơn vị → số lượng đề nghị đặt hiện 2 thùng (48 đơn vị), không hiện 30 đơn vị lẻ.
• Chọn 3 dòng cùng một nhà cung cấp trong danh sách Cần đặt hàng, bấm tạo đơn mua hàng → một đơn mua hàng mới mở ra với đúng 3 dòng đó, đúng số lượng đề nghị đặt và nhà cung cấp đã chọn.
• Mặt hàng X bán 100 đơn vị, giá vốn 50.000; mặt hàng Y bán 500 đơn vị, giá vốn 2.000 → chạy phân nhóm ABC → X đứng trên Y trong bảng xếp hạng giá trị tiêu thụ (5.000.000 so với 1.000.000), dù Y bán nhiều đơn vị hơn.
• Đổi ngưỡng phân nhóm từ 80/15/5 sang 70/20/10 rồi lưu → bảng ABC xếp lại theo 70/20/10; gõ 70/20/5 → không lưu được, báo tổng ba ngưỡng phải bằng 100.
• Đổi cơ sở phân nhóm sang doanh thu → bảng ABC xếp lại theo doanh thu, mặt hàng bán chạy giá rẻ leo lên nhóm cao hơn so với khi xếp theo giá vốn.
• Một mặt hàng nhóm A có lần kiểm kê gần nhất cách đây 10 ngày (tần suất nhóm A là mỗi tuần) → mặt hàng hiện dấu "Đến hạn kiểm" và được gợi ý sẵn khi mở phiếu kiểm kê mới.
• Trong màn cấu hình, đổi tần suất kiểm kê của nhóm B từ mỗi tháng sang mỗi hai tuần rồi lưu → mặt hàng nhóm B có lần kiểm gần nhất cách đây 20 ngày chuyển sang "Đến hạn kiểm", trong khi trước đó chưa tới hạn.
• Mở màn cấu hình bổ sung hàng, đổi cửa sổ lịch sử từ 30 ngày sang 60 ngày → nhu cầu bán trung bình mỗi ngày và điểm đặt hàng lại của mọi mặt hàng được tính lại theo cửa sổ 60 ngày.

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

Khía cạnh	Yêu cầu
Hiệu năng	Màn Cần đặt hàng mở ra trong 3 giây với merchant có 5.000 mặt hàng; số liệu tốc độ bán được tính sẵn theo lịch chạy nền, không tính lại từ đầu mỗi lần mở màn
Độ tươi của số liệu	Nhu cầu bán trung bình và phân nhóm ABC được tính lại ít nhất một lần mỗi ngày; màn hình ghi rõ thời điểm tính gần nhất
Chính xác số học	Số lượng dùng độ chính xác 4 chữ số thập phân; số lượng đề nghị đặt luôn làm tròn LÊN, không bao giờ làm tròn xuống thành thiếu hàng
Không chặn nghiệp vụ	Mọi con số ở đây là gợi ý; không con số nào chặn bán hàng, chặn lập đơn mua hàng, hay chặn kiểm kê
Phân quyền theo merchant	Cấu hình bổ sung hàng, tồn an toàn gõ tay và kết quả phân nhóm ABC đều cô lập theo merchant
Trung thực dữ liệu	Mặt hàng thiếu dữ liệu đầu vào hiện lý do thiếu, không hiện con số suy đoán

7. UX & Luồng

Màn Bổ sung hàng nằm trong nhóm Kho trên Client, gồm hai tab: tab Cần đặt hàng (danh sách mặt hàng dưới điểm đặt hàng lại) và tab Phân nhóm ABC (bảng xếp hạng theo giá trị tiêu thụ). Cấu hình dùng chung nằm sau nút Cấu hình ở góc phải của màn.

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

Khái niệm	Vai trò
Nhu cầu bán trung bình mỗi ngày	Số đơn vị bán ra trung bình một ngày của một mặt hàng, tính trên cửa sổ lịch sử cấu hình được
Bán nhiều nhất một ngày	Ngày bán nhiều nhất trong cùng cửa sổ lịch sử, là đầu vào của công thức tồn an toàn
Thời gian giao	Số ngày từ lúc đặt hàng tới lúc nhận hàng, khai trên bản ghi nhà cung cấp - mặt hàng và đối chiếu với lịch sử nhận hàng thật
Tồn an toàn	Khoản đệm giữ lại để chịu được ngày bán vọt hoặc chuyến giao trễ; tính theo công thức max-min hoặc do merchant gõ tay
Điểm đặt hàng lại	Mức tồn khả dụng mà khi chạm tới thì cần đặt hàng ngay: nhu cầu bán trung bình x thời gian giao + tồn an toàn
Số lượng đề nghị đặt	Số lượng cần mua để đưa tồn về mức đủ một chu kỳ giao hàng, làm tròn lên theo quy cách đóng gói và số lượng đặt tối thiểu
Giá trị tiêu thụ	Số lượng bán trong kỳ nhân giá vốn hiện tại; cơ sở mặc định để phân nhóm ABC
Nhóm ABC	Ba nhóm mặt hàng chia theo tỉ trọng giá trị tiêu thụ cộng dồn, ngưỡng mặc định 80/15/5
Tần suất kiểm kê luân phiên	Khoảng cách giữa hai lần kiểm kê gợi ý cho một mặt hàng, suy ra từ nhóm ABC của nó

Chỉ ở mức khái niệm - schema đầ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	Lịch sử bán hàng	nguồn duy nhất cho nhu cầu bán trung bình mỗi ngày và ngày bán nhiều nhất; món pha chế phải nổ được xuống nguyên liệu thì nguyên liệu mới có số bán.
02	VEN Nhà cung cấp - mặt hàng	nguồn của thời gian giao, quy cách đóng gói và số lượng đặt tối thiểu; không có dữ liệu này thì không tính được điểm đặt hàng lại.
03	VAL Giá vốn	nguồn của giá trị tiêu thụ khi phân nhóm ABC theo giá vốn.
04	STK Mục kho & mức tồn	nguồn của tồn khả dụng, con số được so với điểm đặt hàng lại.
05	PO Đơn mua hàng	nơi các dòng đã chọn trong danh sách Cần đặt hàng được mang sang.
06	CNT Kiểm kê	nơi gợi ý tần suất kiểm kê luân phiên theo nhóm ABC được dùng.

Giả định

#	Giả định	Sai thì sao
01	Merchant khai thời gian giao cho ít nhất những mặt hàng quan trọng của mình; mặt hàng không khai thì chấp nhận không có gợi ý.	Không ai khai thời gian giao thì màn Cần đặt hàng trống rỗng và toàn bộ tính năng không có gì để hiện.
02	Nhu cầu bán trong cửa sổ lịch sử là dự báo đủ tốt cho chu kỳ giao hàng tiếp theo; không có mùa vụ hay khuyến mãi đột biến trong khoảng đó.	Một đợt cao điểm ngay sau cửa sổ lịch sử làm điểm đặt hàng lại thấp hơn nhu cầu thật, và merchant hết hàng đúng lúc bán chạy nhất.
03	Merchant hiểu đây là gợi ý và vẫn là người quyết định đặt bao nhiêu.	Merchant đặt theo con số một cách máy móc thì một lần dữ liệu bẩn sẽ thành một đơn mua hàng sai, và niềm tin vào cả màn hình mất theo.
04	Giá vốn của mặt hàng đủ tin để dùng làm cơ sở phân nhóm ABC.	Giá vốn sai thì bảng ABC xếp sai, và merchant dồn công theo dõi vào đúng nhóm hàng không ngốn vốn.

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

Khía cạnh	Kế hoạch
Phase	P2 (Kho) - xem danh mục feature URD; xếp sau các feature nền của Kho trong thứ tự triển khai
Rollout	Mọi merchant; màn Bổ sung hàng chỉ gợi ý, không tự động hóa. Màn có ghi dữ liệu (tồn an toàn gõ tay, tham số cấu hình dùng chung, và đơn mua hàng do merchant chủ động bấm tạo), nhưng không đổi bất kỳ luồng bán, nhập hay kiểm kê nào đang chạy
Migration	Không đổi dữ liệu tồn; tham số cấu hình bổ sung hàng nhận giá trị mặc định (30 ngày, 80/15/5, giá vốn, 90 ngày) cho mọi merchant
Tiêu chí phát hành	Điểm đặt hàng lại và tồn an toàn khớp với tính tay trên bộ mẫu; mặt hàng thiếu dữ liệu hiện đúng lý do thiếu; tạo đơn mua hàng từ danh sách mang sang đúng dòng và đúng số lượng
Theo dõi	Tỉ lệ mặt hàng có đủ dữ liệu tính, tỉ lệ merchant gõ đè số lượng đề nghị đặt, số đơn mua hàng lập từ màn Cần đặt hàng

Tham chiếu

• URD: Bổ sung hàng
• Liên quan: Nhà cung cấp · Đơn mua hàng · Giá vốn · Mục kho & mức tồn · Kiểm kê
• 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	Merchant mới mở, dữ liệu bán thưa và bẩn, công thức ra số vô nghĩa nhưng trông có vẻ khoa học	Không dùng công thức thống kê làm mặc định; dùng công thức max-min đơn giản, và ẩn hẳn con số khi dưới 14 ngày lịch sử bán (FR-006)
02	Merchant không khai thời gian giao thì cả tính năng vô dụng	Dòng thiếu dữ liệu hiện lối tắt mở thẳng màn nhà cung cấp của mặt hàng đó để khai ngay (FR-006)
03	Mùa vụ và khuyến mãi làm nhu cầu bán trung bình lệch xa thực tế	Cửa sổ lịch sử chỉnh được, và merchant gõ đè tồn an toàn khi biết trước đợt cao điểm (FR-005)
04	Ngưỡng ABC 80/15/5 không hợp với ngành đuôi dài như bán lẻ nhiều mã hàng	Ngưỡng chỉnh được theo merchant (FR-010)
05	Món pha chế bán ra nhưng nguyên liệu không nổ được xuống số bán thì nguyên liệu luôn thiếu lịch sử bán	Đã chốt: lượng nguyên liệu nổ ra từ công thức được cộng vào nhu cầu bán trung bình của chính nguyên liệu đó (FR-002); nguyên liệu của món chưa khai công thức thì rơi vào trạng thái thiếu lịch sử bán và hiện rõ lý do (FR-006)
06	Số lượng đề nghị đặt làm tròn lên theo thùng có thể vượt xa nhu cầu thật với mặt hàng bán chậm	Merchant sửa được số lượng ngay trên dòng trước khi tạo đơn mua hàng (FR-008)
07	Chọn kỳ phân nhóm ABC 90 ngày với merchant mới mở 2 tháng	Mở: xác định cách hiển thị nhóm ABC khi kỳ lịch sử ngắn hơn kỳ phân nhóm đã cấu hình
08	Các con số mặc định trong PRD này chưa được PO chốt thành luật nghiệp vụ: 14 ngày lịch sử tối thiểu mới ra số (FR-006), 30 ngày cửa sổ tính nhu cầu bán (FR-002), 90 ngày kỳ phân nhóm ABC (FR-009) và 90 ngày tối thiểu để bật công thức thống kê (FR-007), tần suất kiểm kê tuần/tháng/quý (FR-011), lấy thời gian giao lâu nhất và trung bình từ lịch sử nhận hàng thật (FR-004), và lấy thời gian giao dài nhất khi mặt hàng chưa có nhà cung cấp ưu tiên (FR-003)	Mở: PO chốt cả cụm này một lượt. Toàn bộ đã được viết xuống URD-RPL-001/002/004/006/007 để FR có gốc; PO gật thì giữ nguyên, PO đổi con số nào thì sửa ở URD trước rồi PRD theo sau

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

#	Câu hỏi	Trả lời
01	Điểm đặt hàng lại khác gì ngưỡng sắp hết hàng tôi đang gõ tay?	Ngưỡng sắp hết hàng là một con số tĩnh do bạn gõ, nó không biết bạn bán nhanh hay chậm. Điểm đặt hàng lại tính theo tốc độ bán thật và thời gian nhà cung cấp giao hàng, nên nó nhích lên khi bạn bán chạy và hạ xuống khi bạn bán chậm. Hai thứ chạy song song, bạn có thể dùng cả hai.
02	Tại sao tồn an toàn không dùng công thức thống kê cho chính xác?	Công thức thống kê cần lịch sử bán dài và sạch mới đáng tin. Một quán mới mở vài tháng thì công thức đó ra một con số rác, mà lại trông rất khoa học nên bạn dễ tin theo. Công thức max-min chỉ cần bốn con số bạn nhìn thấy được, và bạn kiểm tra lại được bằng tay. Ai có dữ liệu đủ dài thì bật tùy chọn nâng cao.
03	Tôi tự biết mức tồn an toàn của mình thì sao?	Gõ thẳng vào dòng của mặt hàng đó. Con số bạn gõ luôn thắng con số công thức tính ra, cho tới khi bạn xóa nó đi.
04	Tại sao ABC tính theo giá vốn chứ không theo doanh thu?	Vì ABC ở đây để kiểm soát số vốn đang nằm chết trong kho, không phải để xem mặt hàng nào ra doanh số đẹp. Một mặt hàng bán ít nhưng giá vốn cao vẫn ngốn nhiều vốn của bạn hơn một mặt hàng bán chạy giá rẻ. Nếu muốn nhìn theo doanh thu, đổi cơ sở phân nhóm trong màn cấu hình.
05	Ngưỡng 80/15/5 lấy ở đâu ra và tôi có phải theo không?	Đó là ngưỡng thông dụng, dùng làm mặc định để bạn có ngay một bảng ABC mà không phải nghĩ. Bán lẻ nhiều mã hàng và F&B ít mã hàng có phân bố rất khác nhau, nên bạn chỉnh lại được cho hợp quán mình, miễn ba con số cộng lại bằng 100.
06	Hệ thống có tự đặt hàng giúp tôi không?	Không. Hệ thống chỉ đưa danh sách và số lượng đề nghị đặt. Bạn xem, sửa nếu thấy chưa hợp, rồi tự bấm tạo đơn mua hàng.
07	Nhóm ABC ảnh hưởng gì tới kiểm kê?	Nhóm A là nhóm ngốn vốn nhất nên được gợi ý kiểm dày hơn (mặc định mỗi tuần), nhóm C thưa hơn (mặc định mỗi quý). Đó là gợi ý để bạn kiểm luân phiên thay vì đóng cửa kiểm cả kho, bạn vẫn kiểm mặt hàng nào tùy ý.