Hướng dẫn kiểm thử MVP

Quick Reference — 4 bộ kiểm thử:

• Checklist — bảng test case tổng, tick từng dòng (≈80 cases)
• Scenarios — kiểm thử theo user journey (8 kịch bản)
• Checklist · BQ-Calibrated — ~35 TC chạy trên seed snapshot calibrate từ BigQuery Q1 2026 (NEW)
• Scenarios · BQ-Calibrated — scenario theo dữ liệu thực BQ (NEW)

Đối tượng: Product & Data team (non-coding). Không cần viết code, chỉ cần browser + tài khoản demo.

Bạn nên dùng phong cách nào?

Tình huống	Khuyến nghị
UAT trước demo stakeholder	Scenarios (kể câu chuyện)
Pre-release regression	Checklist (bao quát)
Smoke test sau deploy	Subset Checklist (mục 1–10)
Khi report bug	Bắt đầu từ Scenario rồi lùi về Checklist để cô lập

Trước khi bắt đầu

1. Môi trường test

Env	URL	Reset data
Demo	https://boxme-workforce-planner.pages.dev (prototype)	–
Staging MVP	<staging-url>	npm run demo:reset
Local	http://localhost:5173	npm run demo:reset

2. Tài khoản demo (đã seed)

Email	Role	Mật khẩu
kam.loreal@demo.boxme	KAM	Demo@123
am.fmcg@demo.boxme	AM	Demo@123
planner@demo.boxme	PLANNER	Demo@123
wh.hcm@demo.boxme	OPS (WH Mgr)	Demo@123
auditor@demo.boxme	AUDITOR	Demo@123
admin@demo.boxme	ADMIN	Demo@123

Nếu chưa tồn tại → chạy npm run seed ở thư mục wfp-v2/.

3. Browser & resolution

• Chrome / Edge / Safari ≥ 2 versions cuối
• Desktop ≥ 1280×720 (responsive mobile chưa trong MVP scope)
• DevTools mở để xem console errors (Cmd/Ctrl + Option + J)

4. Báo cáo lỗi

Format gợi ý:

**Tiêu đề:** [Module] mô tả ngắn
**Env:** staging | local
**Account:** planner@demo.boxme
**Reproduce:**
1. ...
2. ...
3. ...
**Expected:**
**Actual:**
**Severity:** P0 (block) | P1 (high) | P2 (medium) | P3 (cosmetic)
**Attachments:** screenshot, console log

Coverage MVP

Tính năng	Có trong MVP?	Trang test
Auth & role-based menu	✅	Login, Sidebar
Import lịch sử (CSV/Excel/manual)	✅	/admin/history-import
Submit adjustment (KAM)	✅	/planner/override-import
Forecast engine nightly	✅	/planner/forecast
Review pipeline (NEW→SEEN→ACCEPTED/REJECTED)	✅	/planner/forecast/review
Reports kho + khách	✅	/planner/forecast/{warehouse,customer}
Config (mùa, event, UPH)	✅	/admin/config/*
Audit log + timeline	✅	Drawer trong forecast pages
Shift planning (5-layer)	❌ post-MVP	Placeholder
Hiring forecast	❌ post-MVP	Placeholder
BSIN ML / Auto-tune	❌ post-MVP	–

Định nghĩa "Pass" cho MVP

MVP pass khi tất cả đúng:

1. 100% scenarios pass (8/8)
2. ≥ 95% checklist pass (≥ 76/80)
3. 0 bug severity P0
4. ≤ 3 bug P1 (có workaround)
5. Audit log đầy đủ cho mọi quyết định trong UAT

Tiếp: Checklist · Scenarios