Changelog

Nhật ký thay đổi của Workforce Planner (prototype + MVP wfp-v2/) và bộ tài liệu VitePress. Định dạng theo Keep a Changelog. Phiên bản theo SemVer.

---

[Unreleased]

Planned

• Shift planning 5-layer (post-MVP).
• Hiring forecast & BSIN ML auto-tune.
• Mobile responsive cho dashboard KAM.

---

[0.3.0] · 2026-05-23 — BQ-Calibrated Testing

Added

• Bộ kiểm thử BQ-calibrated dựa trên dữ liệu BigQuery thực Q1 2026:
  • testing/checklist-bq-calibrated.md — ~35 TC chia 7 nhóm A–G, mỗi TC có expected_value + reference_query + automation.
  • testing/scenarios-bq-calibrated.md — scenario theo user journey, dùng số liệu BQ thực.
• Calibration dataset data/calibration/2026Q1.json (15 KB) — snapshot Q1 2026 từ project boxme-cloud, gồm 6 warehouses · 12 customers · 589 calendar days.
• Seed snapshot ổn định ở wfp-v2/public/seed-snapshot.json để test có thể reset deterministic.
• E2E tests (Playwright) cho hai luồng chính:
  • wfp-v2/e2e/import-wizard.spec.ts — KAM import lịch sử.
  • wfp-v2/e2e/review-flow.spec.ts — Planner review NEW → ACCEPTED/REJECTED.
• Scripts trong wfp-v2/package.json:
  • npm run calibrate:show — xem & chạy lại query BQ calibrate.
  • npm run seed — seed snapshot từ calibration JSON.
  • npm run templates — sinh template import CSV/Excel.
  • npm run demo:reset — reset toàn bộ demo data.
• Menu Changelog trên top-nav + sidebar VitePress.

Changed

• Cập nhật trang testing/index.md liệt kê 4 bộ test (Checklist · Scenarios · Checklist BQ-Calibrated · Scenarios BQ-Calibrated).
• Cập nhật build dist của wfp-v2/ (Cloudflare Pages) với seed snapshot mới.

Fixed

• Đồng bộ field naming SQL alias trong data/bq-queries.sql theo Boxme SQL Naming Convention.

---

[0.2.0] · 2026-05-21 — Documentation Pack

Added

• 27 trang docs ở /docs/ + VitePress site ở /docs-site/ (port dev mặc định):
  • Knowledge — personas/, jtbd/, flows/ (Persona × JTBD × Process Flow).
  • Tech — architecture.md, database.md, data-flow.md, deployment.md, api/.
  • SOP (non-coding, theo vai trò) — sop/{dang-nhap, gui-dieu-chinh, phe-duyet, xem-du-bao, bao-cao-kho, cau-hinh-tham-so, nhap-du-lieu-lich-su, audit}.md.
  • Testing MVP — testing/{checklist, scenarios}.md (~80 cases + 8 scenarios).
• SEO foundation: sitemap-urls.txt, robots.txt, frontmatter keywords + robots cho mọi trang.
• HUONG-DAN-VAN-HANH.md (38 KB) ở root — nguồn fact gốc cho ops team.

Changed

• Refactor sidebar VitePress thành 5 cụm (Tổng quan · Knowledge · Kỹ thuật · SOP · Kiểm thử MVP).

---

[0.1.0] · 2026-05-01 — MVP Scaffolding

Added

• Prototype HTML (index.html + js/, React/Babel CDN, FontAwesome 6, design tokens assets/boxme-tokens.css brand #0b43ea).
  • Serve local: python3 -m http.server 3300.
  • Deployed: https://boxme-workforce-planner.pages.dev.
• App MVP wfp-v2/ — React 18 + Vite + TypeScript + Supabase + Tailwind + Radix UI + Recharts.
• 5 tính năng MVP:
  1. Import lịch sử (CSV/Excel/manual).
  2. KAM submit adjustment.
  3. Forecast engine baseline × monthly × event.
  4. Review pipeline NEW → SEEN → ACCEPTED/REJECTED.
  5. Báo cáo kho + khách.
• 6 role + 6 demo accounts (kam.loreal, am.fmcg, planner, wh.hcm, auditor, admin @demo.boxme).
• Audit log insert-only với Supabase RLS revoke UPDATE/DELETE.
• Architecture rules 4-layer domain → engine → services → hooks → UI; engine src/engine/* PURE (không import từ services/).

---

Tham chiếu nhanh

Phiên bản	Ngày	Highlight
0.3.0	2026-05-23	BQ-calibrated tests, calibration dataset, e2e Playwright
0.2.0	2026-05-21	Bộ docs VitePress đầy đủ (27 trang)
0.1.0	2026-05-01	Khởi tạo MVP wfp-v2 + prototype HTML

Cập nhật mục mới: chỉnh sửa docs/changelog.md và bump phiên bản.