Admin · Cấu hình tham số
Quick Reference — Trang
/admin/configroot → vào 3 sub: Định mức (UPH), Tham số (mùa, event), Kho.
Các nhóm config
| Trang | Sửa gì | Tần suất |
|---|---|---|
/admin/config/thamso | monthly_multiplier[m], event_multiplier[e] | Đầu tháng / khi planner kêu lệch |
/admin/config/dinhmuc | UPH[warehouse, group, pk_type] | Khi đo lại năng suất |
/admin/warehouses | Danh mục kho, active flag | Hiếm |
SOP 1 · Sửa monthly multiplier
| # | ▶ | ✅ |
|---|---|---|
| 1 | Vào /admin/config/thamso | Tab "Mùa" mặc định |
| 2 | Tìm row tháng cần sửa (vd T6 = 1.0) | – |
| 3 | Click vào giá trị → nhập mới (vd 1.2) | – |
| 4 | Bấm "Lưu" | Toast OK + audit log row |
| 5 | (optional) Bấm "Rerun nightly" | Forecast tính lại trong 1-2 phút |
WARNING
Sửa multiplier ảnh hưởng toàn bộ forecast của tháng đó. Test ở staging trước khi sửa prod.
SOP 2 · Sửa event multiplier
| # | ▶ | ✅ |
|---|---|---|
| 1 | Tab "Sự kiện" | – |
| 2 | Edit row event_type (vd MEGA_SALE = 4.5 → 5.0) | – |
| 3 | Lưu | Audit log ghi before/after |
Event mặc định:
| event_type | Default mult | Khi dùng |
|---|---|---|
NORMAL | 1.0 | Ngày thường |
MID_MONTH | 1.8 | 15 hàng tháng |
DOUBLE_DAY | 2.5 | 6.6, 7.7, 8.8… |
MEGA_SALE | 4.5 | 11.11, 12.12 |
BLACK_FRIDAY | 3.5 | Tuần cuối T11 |
SOP 3 · Sửa UPH config (định mức)
| # | ▶ | ✅ |
|---|---|---|
| 1 | Vào /admin/config/dinhmuc | Bảng matrix |
| 2 | Filter theo kho | Bảng còn rows của kho đó |
| 3 | Sửa ô (group × pk_type) | – |
| 4 | Lưu | – |
UPH gợi ý baseline (đơn/giờ/người):
| group | SB | MIX | HVY |
|---|---|---|---|
| NORMAL | 60 | 45 | 25 |
| FRAGILE | 40 | 30 | – |
| HAZMAT | 30 | 25 | 20 |
TIP
Số này khác nhau theo kho. Dùng time study thực tế để lấy số chính xác.
SOP 4 · Quản lý kho
| ▶ | ✅ |
|---|---|
/admin/warehouses → Add | Mở dialog tạo kho mới |
| Điền code, name, shift_minutes mặc định | – |
| Save | Kho xuất hiện trong dropdown scope |
DANGER
KHÔNG xoá kho có data lịch sử. Chỉ set active=false để ẩn khỏi list.
Audit cho mọi thay đổi config
Mọi thay đổi config tự động ghi audit_log với:
action = CONFIG_CHANGEbefore= giá trị cũafter= giá trị mớiactor_id= bạn
Auditor đọc được toàn bộ.
Lỗi thường gặp
"Validation error: multiplier must be ≥ 0"
Hệ số phải ≥ 0. Negative không có nghĩa. Nếu muốn "giảm" → dùng < 1 (vd 0.7).
Sửa rồi mà forecast chưa đổi
- Nightly job chạy 02:00 → đợi sang hôm sau
- Hoặc bấm "Rerun" thủ công ở trang config
- Hoặc dùng
npm run demo:reset(chỉ env demo)