@kesflow/kf 0.1.7 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +20 -3
- package/package.json +1 -1
package/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: kf-cli
|
|
3
|
-
description: Thao tác nội bộ KesFlow qua CLI `kf` thay cho bấm màn ops
|
|
3
|
+
description: Thao tác nội bộ KesFlow qua CLI `kf` thay cho bấm màn ops, nhân danh người đăng nhập (quyền theo vai) — lớp/LMS (chốt buổi, record, slide, recap, đăng buổi, tiến độ, chấm và công bố điểm); Challenge (theo dõi, hoàn cọc, buổi live); đơn và khách (huỷ/mở lại, sửa số, gửi lại thư, ghi chú); ghi danh (thêm/thu/mở lại quyền, đổi email); sản phẩm, voucher, tài nguyên, customize; thanh toán (gán/sửa/gỡ khoản, chờ đối chiếu); hoàn tiền, hoá đơn, CCCD; affiliate, báo cáo, chi trả; nhân sự (vai, lời mời); xoá dữ liệu (CEO). Dùng khi nhân sự nhờ "chốt buổi", "up record lên LMS", "chấm bài", "Challenge", "hoàn cọc", "xem đơn", "huỷ đơn", "ghi danh", "đổi email học viên", "tạo voucher", "gán khoản", "ghi hoàn tiền", "xuất hoá đơn", "link affiliate", "chi trả", "mời nhân sự", "xoá sản phẩm thử" hoặc nhắc tới `kf`. Không dùng cho việc ngoài `kf --help` (gửi mail tự do, quản lý token agent — làm trên ops).
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# kf — CLI nội bộ KesFlow cho agent
|
|
@@ -54,12 +54,29 @@ description: Thao tác nội bộ KesFlow qua CLI `kf` thay cho bấm màn ops
|
|
|
54
54
|
- `ghi-danh-them`, `ghi-danh-thu`, `ghi-danh-doi-email` là `[high]` — cấp/cắt quyền học thật, đổi email đăng nhập: chỉ `--yes` sau khi người dùng nêu đúng **email + sản phẩm** (và email mới) trong chat. `ghi-danh-tam-dung`, `ghi-danh-tiep-tuc`, `ghi-danh-mo-lai` là ghi thường. Mọi thao tác cần `--ly-do` (≥1 ký tự).
|
|
55
55
|
- Người học có quyền từ đơn hoặc danh sách nhập lớp: không đổi email ở đây (`ENROLLMENT_EMAIL_OWNED_BY_ORDER` / `…_IMPORT`) — sửa ở đơn (`don-sua-suat`) hoặc ở nguồn nhập.
|
|
56
56
|
|
|
57
|
-
## Sản phẩm, voucher, tài nguyên, customize (CEO, admin loại sản phẩm; kế toán chỉ đọc)
|
|
57
|
+
## Sản phẩm, voucher, tài nguyên, customize (CEO, admin loại sản phẩm; kế toán chỉ đọc; voucher: mọi vai trừ trợ giảng)
|
|
58
58
|
- Đọc: `kf sp-ds`, `kf sp-chi-tiet --ma <SP>` (lấy `phien_ban` trước mọi lệnh ghi), `kf sp-tong-quan --ma <SP>`, `kf tn-ds --ma <SP>`, `kf cz-ds`, `kf cz-chi-tiet --id …`.
|
|
59
59
|
- Ghi thường: `sp-tao`, `sp-sua` (không có khoá tiền), `sp-van-hanh`, `sp-loai` (CEO), `sp-hien-thi` (CEO), `cz-sua`. Lý do tuỳ chọn, trừ `sp-hien-thi`.
|
|
60
|
-
- `[high]`: `sp-gia` (giá, miễn phí, % affiliate — % chỉ CEO), `sp-trang-thai` (mở/đóng bán; đọc `thieu[]` để nói vì sao chưa mở được), `voucher-tao`, `voucher-tat` (
|
|
60
|
+
- `[high]`: `sp-gia` (giá, miễn phí, % affiliate — % chỉ CEO), `sp-trang-thai` (mở/đóng bán; đọc `thieu[]` để nói vì sao chưa mở được), `voucher-tao`, `voucher-tat`, `voucher-bat` (bật lại voucher đã tắt; mã trùng với voucher **đang bật** khác → `NB_VOUCHER_TRUNG`), `loai-tao`, `loai-kich-hoat` (CEO; tắt loại là thu quyền **mọi admin** của loại đó — nêu tên họ; bật lại thì họ có quyền lại ngay). Trước `--yes` nêu đúng mã sản phẩm/mã voucher và con số trong chat, chờ người dùng đồng ý.
|
|
61
61
|
- Trùng mã voucher → `NB_VOUCHER_TRUNG` (409): báo người dùng chọn mã khác, không tự đổi mã.
|
|
62
62
|
|
|
63
|
+
## Xoá dữ liệu (chỉ CEO — cực kỳ nguy hiểm, không hoàn tác)
|
|
64
|
+
- Luôn `kf xoa-xem --loai <san_pham|voucher|ghi_danh|loai_quan_tri> --khoa <mã/id>` trước. Trình cho người dùng **nguyên văn**: từng loại dữ liệu và số dòng sẽ mất, các tín hiệu "dữ liệu thật", số dòng Base Tiền phải xoá tay, và câu "không hoàn tác được". Bị chặn (`chan`) thì dừng, báo lý do.
|
|
65
|
+
- Dữ liệu rác: một lệnh `kf xoa … --yes` sau khi người dùng đồng ý. Dữ liệu thật: lệnh đầu trả `NB_XOA_CAN_XAC_NHAN_2` kèm mã — **dừng, hỏi người dùng lần hai**, chỉ khi họ đồng ý mới gọi lại với mã đó. Không bao giờ gửi hai xác nhận trong một lượt.
|
|
66
|
+
- `NB_XOA_DA_DOI`: dữ liệu đã đổi từ lúc xem — xem lại từ đầu. `NB_XOA_CHAN`: bị chặn (vd sổ chi trả affiliate, SP quản lý ở Base Tiền) — dừng, báo lý do. Giao dịch ngân hàng của đơn bị xoá không mất, quay về "Chờ xử lý".
|
|
67
|
+
|
|
68
|
+
## Hoàn tiền và hoá đơn (CEO, kế toán; admin đọc trong phạm vi)
|
|
69
|
+
- Gọi `hoan-ds` và `hoan-ung-vien` trước. Trước `hoan-ghi --yes` nêu **mã đơn, số tiền vào, số đã hoàn, luỹ kế mới** (không phải phần chênh), lý do và từng người sẽ mất quyền học; chờ người dùng đồng ý đúng các số đó.
|
|
70
|
+
- `ok_cho_khop`: tiền đã ghi, chưa khớp xong — đọc lại, thử lại **cùng payload**, không nâng luỹ kế để "thử". `thu_quyen.loi`: tiền đã ghi — thử lại cùng payload để thu quyền xong, không tạo khoản hoàn mới. Thử lại chỉ tác dụng khi chưa ai ghi thêm hoàn trên khoản đó; ngược lại thu quyền trên màn Hoàn tiền.
|
|
71
|
+
- Hoá đơn: đọc `hoa-don-ds`/`hoa-don-chi-tiet` trước; `hoa-don-ghi` hành động `nhan` rồi dùng `phien_ban_token` mới cho bước sau. `hoa-don-cccd` trả số CCCD đầy đủ (ghi audit); `hoa-don-xuat` trả JSON các hàng (không phải xlsx), `gom_cccd` chỉ bật khi người dùng yêu cầu. Mọi thao tác ghi cần `--yes` sau khi người dùng đồng ý.
|
|
72
|
+
|
|
73
|
+
## Affiliate và chi trả (aff-ds: CEO; báo cáo, chi trả: CEO, kế toán)
|
|
74
|
+
- `kf aff-ds --san-pham-ma <mã>` lấy link (chỉ có khi mã dùng được với sản phẩm đó); `kf aff-bao-cao` xem báo cáo. Hoa hồng là sổ **chỉ đọc**.
|
|
75
|
+
- Rút tiền: `kf chi-tra-ds --trang-thai cho`. Trước `chi-tra-ghi-chuyen --yes` nêu **người nhận, ngân hàng, STK, số net, nội dung chuyển khoản** và chỉ ghi sau khi đã chuyển tay, có mã giao dịch ngân hàng thật. Kết quả chưa rõ thì tra lại cùng yêu cầu, không tạo lệnh mới. `chi-tra-tu-choi` cần lý do. Không ghi STK ra file chung. Hoàn cọc Challenge dùng `ch-hoan-coc*`.
|
|
76
|
+
|
|
77
|
+
## Nhân sự (chỉ CEO)
|
|
78
|
+
- Đọc: `kf ns-ds`, `kf ns-tim --email …`. Ghi (`ns-ghi`, `ns-cap-goi`, `ns-moi-luu`, `ns-moi-huy`) đều `[high]`: trước `--yes` nêu **ai, vai/loại nào, thêm hay thu**; thu hồi nhân sự là thu **mọi quyền** của người đó. Lý do ≥1 ký tự. `ns-moi-luu` trả `du_lieu.link` (link nhận lời mời trên ops): gửi đúng link đó cho người được mời, đừng tự dựng link.
|
|
79
|
+
|
|
63
80
|
## Thao tác tiền (CEO, kế toán)
|
|
64
81
|
- Đọc trước, ghi sau: `kf khoan-ds` (mặc định chỉ khoản còn việc; `--trang-thai tat_ca` để tra mọi giao dịch), `kf khoan-sua-lien-ket-xem --id <khoản>` để lấy liên kết hiện tại và `phien_ban`.
|
|
65
82
|
- Trước `khoan-gan-don` / `khoan-sua-lien-ket … --yes`: nêu trong chat **mã giao dịch, số tiền, mã đơn đích** (và đơn cũ nếu sửa/gỡ) rồi chờ người dùng đồng ý đúng các số đó. Đơn cần xem kỹ thì nhờ người dùng mở đơn trên ops.
|