Kho công cụ: chính sách, quyền và bán công cụ

Nhóm menu "Kho công cụ" trong khu quản trị (/admin).

Module Toolbox quản lý ai được dùng công cụ nào, đến bao giờ. Module ToolboxCommerce (tuỳ chọn, cần Ecommerce) thêm việc bán công cụ. Người học thấy tất cả ở Kho công cụ.

Mô hình một câu

Mỗi công cụ có một chính sách (miễn phí / miễn phí khi đang học / trả phí). Người học có quyền khi chính sách cho phép, hoặc khi có một quyền dùng còn hiệu lực từ một trong sáu nguồn: quản trị cấp, dùng thử, đang học, mã kích hoạt, mua lẻ, gói đăng ký.

Bật cho tổ chức

Bật module Toolbox; công cụ cụ thể (ví dụ CvBuilder) là module riêng, bật thêm. Muốn bán thì bật ToolboxCommerce (đòi Ecommerce đã bật). Tắt một module công cụ thì mọi thẻ, quyền và món trong gói của nó ẩn khỏi người học ngay, không xoá dữ liệu.

Bản đồ màn hình

Màn hình	Dùng để
Chính sách công cụ	Đặt chính sách, số ngày dùng thử, ân hạn cho từng công cụ; nút Đồng bộ công cụ tạo dòng cho công cụ mới bật
Quyền dùng công cụ	Xem mọi quyền đang có (nguồn, hạn); cấp tay cho một người; Thu hồi
Mã kích hoạt	Phát mã cho lớp, đối tác; Tạo hàng loạt, Xuất CSV
Sử dụng công cụ	Báo cáo: bao nhiêu người đang có quyền theo từng công cụ × nguồn, bao nhiêu sắp hết hạn (30 ngày)
Sản phẩm công cụ (ToolboxCommerce)	Tạo sản phẩm bán lẻ cho một khoá công cụ
Cài đặt → Học tập → Kho công cụ	Chính sách mặc định, ngày dùng thử mặc định, ân hạn mặc định
Báo cáo & Phân tích → Doanh thu công cụ (ToolboxCommerce)	Tiền thu theo công cụ, số người mua, tỉ lệ thử → mua

Chính sách công cụ

Mỗi dòng là một công cụ (hoặc một khoá con của công cụ — ví dụ công cụ CV có khoá con cho mẫu Pro, chấm điểm, khớp tin tuyển dụng, LinkedIn).

Chính sách	Người học được gì
Miễn phí cho mọi người học	Ai đăng nhập cũng dùng
Miễn phí khi đang học (mặc định)	Dùng khi còn khoá học hiệu lực, cộng ân hạn sau khi khoá kết thúc (mặc định 90 ngày)
Trả phí	Cần một quyền dùng từ dùng thử / mã / mua / gói / cấp tay

Cột Ngày dùng thử: để trống là dùng mặc định của tổ chức; 0 = không cho dùng thử. Mỗi người chỉ dùng thử một lần mỗi công cụ, và dùng thử mở cả họ khoá (khoá cha + mọi khoá con) — bạn không thể cho thử riêng một khoá con.

Khoá con kế thừa chính sách của khoá cha

Đặt công cụ CV là Miễn phí cho mọi người học thì mẫu Pro, chấm điểm, khớp tin, LinkedIn cũng miễn phí theo. Muốn "lõi miễn phí, tính năng nâng cao trả phí" thì để khoá cha miễn phí và đặt từng khoá con là Trả phí — đây là cách công cụ CV được cấu hình sẵn.

Nút Đồng bộ công cụ tạo dòng chính sách cho công cụ vừa bật; không có dòng thì công cụ chạy theo mặc định của tổ chức.

Quyền dùng công cụ

Danh sách mọi quyền, lọc Chỉ còn hiệu lực. Nguồn: Quản trị cấp, Dùng thử, Đang học, Mã kích hoạt, Mua lẻ, Gói. Trạng thái: Đang hiệu lực, Hết hạn, Đã thu hồi, Chưa bắt đầu.

• Cấp tay: Tạo → chọn người dùng, khoá công cụ, ngày bắt đầu/kết thúc (để trống Đến = vĩnh viễn).
• Thu hồi: nút Thu hồi trên dòng (có xác nhận). Quyền thu hồi không xoá, để lại vết.
• Hết hạn, người học nhận đúng một thông báo cho mỗi công cụ và chỉ khi không còn quyền nào khác. Không có thông báo "sắp hết hạn"; muốn nhắc trước, dùng báo cáo Sử dụng công cụ cột Sắp hết hạn.

Mã kích hoạt

Một mã = một khoá công cụ + thời hạn (ngày) + số lượt dùng + hạn đổi + (tuỳ chọn) chỉ email thuộc tên miền. Mỗi người chỉ đổi một mã một lần. Tạo hàng loạt sinh nhiều mã cùng cấu hình; Xuất CSV để phát cho lớp. Người học đổi mã ở đầu trang Kho công cụ hoặc trong hộp khoá của công cụ.

Bán công cụ (ToolboxCommerce)

Sản phẩm công cụ: chọn Công cụ / khoá (khoá cha hoặc khoá con), tên, mô tả, Giá (VND), Thời hạn (ngày) — để trống là vĩnh viễn; muốn bán nhiều thời hạn thì tạo nhiều sản phẩm — và Đang bán.

• Mua sản phẩm của khoá cha → quyền cho cả họ khoá; sản phẩm của khoá con → chỉ khoá đó.
• Quyền tính từ lúc thanh toán thành công, không phải lúc đặt hàng.
• Hệ thống từ chối bán cho người đã có quyền vĩnh viễn hoặc đang được mở sẵn theo chính sách.
• Ngừng bán bằng cách tắt Đang bán. Sản phẩm đã có đơn không xoá vĩnh viễn được; thùng rác chỉ để dọn sản phẩm chưa bán được lần nào.
• Ưu đãi kéo lại (win-back): người dùng thử xong, hai ngày sau chưa mua, còn sản phẩm đang bán, và tổ chức bật mã giảm giá học thử → nhận một email kèm mã giảm giá riêng cho người đó, chỉ dùng cho sản phẩm rẻ nhất của công cụ, 1 lượt. Mã dùng chung cấu hình với học thử khoá học: khối Chuyển đổi học thử (Cài đặt → Email & Thông báo, /admin/settings/notifications?tab=ecommerce_trial_conversion) — công tắc Đúc mã giảm giá khi bắt đầu học thử, Mức giảm và Mã còn hiệu lực sau khi hết hạn học thử (ngày). Tắt công tắc đó thì không có thư kéo lại. Các công tắc email của khối này chỉ áp cho học thử khoá học, không áp cho công cụ. Xem thêm Mã riêng một người.

Báo cáo Doanh thu công cụ (Trung tâm báo cáo, quyền view_any_tool_product): theo từng công cụ — Đơn đã trả, Người mua, Doanh thu, Dùng thử (bắt đầu trong kỳ), Thử → mua. Doanh thu là tiền thực thu theo ngày thanh toán, đã trừ giảm giá; chỉ tính VND.

Đưa công cụ vào gói đăng ký

Trong Gói đăng ký → Món trong gói, thêm món Loại: Công cụ, chọn khoá. Người mua gói được quyền suốt hạn gói, nguồn Gói; huỷ gói thì thu hồi ngay, hết hạn thì quyền hết cùng gói. Cùng màn hình đó thêm được Vé sự kiện (trong gói) — xem Gói đăng ký.

Một món cấp lỗi (ví dụ module công cụ đã bị tắt) sinh cảnh báo vận hành; sửa xong chạy lại bằng lệnh:

php artisan subscriptions:replay-item-grants --tenant=<id>

Quyền cho vai trò

Quyền	Cho phép
view_any_tool_access_policy, update_tool_access_policy	Xem / sửa chính sách
view_any_tool_entitlement, create_tool_entitlement, delete_tool_entitlement	Xem / cấp / thu hồi quyền
*_tool_access_code	Quản lý mã kích hoạt
page_ToolUsageReport	Báo cáo Sử dụng công cụ
configure_toolbox	Pane cài đặt Kho công cụ
*_tool_product	Sản phẩm công cụ (kèm view_any_tool_product cho báo cáo doanh thu)

Lệnh vận hành

# Đóng quyền quá hạn + dọn bất nhất (chạy tự động mỗi giờ; gọi tay khi cần)
php artisan tenants:run toolbox:sweep --argument=task=expire
php artisan tenants:run toolbox:sweep --argument=task=reconcile

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

Người học đang có khoá mà vẫn bị khoá? Xem chính sách của đúng khoá con họ chạm vào (chấm điểm CV chẳng hạn là khoá con Trả phí dù công cụ CV miễn phí). Hộp khoá phía người học ghi rõ lý do.

Cho một lớp dùng thử dài hơn mặc định? Đừng dùng dùng thử (một lần, cố định theo công cụ). Phát mã kích hoạt với thời hạn mong muốn và giới hạn theo tên miền email của lớp.

Tại sao báo cáo doanh thu ghi "—" ở cột Thử → mua? Trong kỳ không có lượt dùng thử nào bắt đầu, nên tỉ lệ không xác định.