LMS Documentation

Appearance

Công cụ CV: chuẩn bị, thư viện vị trí, chi phí ​

Công cụ CV (module CvBuilder) là công cụ đầu tiên trong Kho công cụ. Trang này nói những việc quản trị viên phải làm để nó chạy, và theo dõi được gì sau đó. Phía người học: Công cụ CV.

Trước khi mở cho người học ​

  1. Bật module Toolbox và CvBuilder. Muốn bán mẫu Pro / chấm điểm / khớp tin / LinkedIn thì bật thêm ToolboxCommerce (+ Ecommerce), hoặc cấp qua gói đăng ký, mã kích hoạt.
  2. Khoá API Gemini ở Cài đặt → Trí tuệ nhân tạo. Không có khoá, người học vẫn dựng CV bằng form; mọi nút AI báo "Trung tâm chưa cấu hình AI".
  3. Credit mở tài khoản: trang giới thiệu công khai /tools/cv tạo tài khoản mới rồi đọc CV cũ ngay ở lượt đầu. Trong Cài đặt → Trí tuệ nhân tạo (module AiCredits), đặt credit tặng khi đăng ký ≥ 150 và tắt yêu cầu xác minh email trước khi tặng — nếu không, người mới đăng ký gặp "hết credit" ở lượt đầu tiên.
  4. Dịch vụ PDF (Gotenberg) phải chạy — nút Xuất PDF dựa vào nó. Kiểm bằng:
    bash
    php artisan pdf:smoke
  5. Đồng bộ thư viện vị trí (xem dưới) để người học có vị trí mục tiêu để chọn.

Thư viện vị trí ​

Kho công cụ → Thư viện vị trí. Mỗi vị trí (ví dụ Điều dưỡng viên, Lập trình viên) cho AI và form biết ngành đó cần gì: Kỹ năng thường gặp, Loại bằng chứng của ngành, Bullet mẫu, Câu hỏi gợi ý (mỗi dòng một mục, có bản tiếng Việt và tiếng Anh), tên gọi kỳ thực tập của ngành, và chính sách ảnh chân dung / ngày sinh (Nên có / Tuỳ chọn / Không nên).

Hệ thống giao sẵn một bộ vị trí. Nút Đồng bộ từ bản mẫu tải bộ mới nhất: thêm vị trí mới, cập nhật vị trí còn ở trạng thái Bản nháp (AI soạn, chưa review), và không đụng vị trí bạn đã sửa (Đã sửa / Đã có chuyên gia review). Kết quả: "Vị trí: +n mới, n cập nhật, n giữ nguyên." Tắt Đang dùng để ẩn một vị trí khỏi danh sách chọn.

Nội dung ngành là thứ đáng đầu tư

Bullet mẫu và câu hỏi gợi ý quyết định AI hỏi gì và người học viết gì. Một chuyên gia ngành sửa 30 phút rồi đánh dấu Đã có chuyên gia review đáng giá hơn mọi chỉnh sửa mô hình.

Lệnh tương đương cho mọi tổ chức (sau khi cập nhật hệ thống):

bash
php artisan tenants:run cvbuilder:sync-role-templates

Cài đặt AI của công cụ CV ​

Cài đặt → Trí tuệ nhân tạo → tab "AI công cụ CV" (/admin/settings/ai?tab=ai_cv, quyền configure_ai_cv):

ÔMặc địnhGhi chú
Mô hình AItrống = dùng mô hình hội thoại chung (gemini-2.5-flash)Ô nhập tự do — gõ sai tên là mọi lượt AI của CV lỗi
Temperature0,4Khuyên 0,3–0,5
Số token tối đa4096512–16384
Ngân sách thinking (token)00 = tắt (rẻ nhất, đủ cho phỏng vấn); -1 = mô hình tự quyết; số dương = trần. Mô hình gemini-2.5-pro không tắt được
Ngưỡng cảnh báo chi phí AI một CV (USD)0,080 = tắt cảnh báo
Số CV tối thiểu để tính10Dưới ngưỡng này không cảnh báo (mẫu quá nhỏ)

Giá credit cho từng tính năng CV (đọc CV cũ, lượt phỏng vấn, viết lại, chấm điểm, khớp tin, LinkedIn) đặt ở AI → Giá credits theo tính năng, khoá bắt đầu bằng cv. — xem Theo dõi chi phí AI để phân biệt credit bán ra với tiền trả nhà cung cấp.

Theo dõi ​

Trung tâm báo cáo (quyền view_cv_report):

  • CV — phễu vào: Xem landing → Tạo tài khoản từ landing → Đồng ý dùng AI → Gửi đầu vào → Bắt đầu phiên AI → Hoàn tất phiên AI → Xuất PDF, mỗi bước kèm tỉ lệ chuyển so với bước trước.
  • CV — chất lượng & chi phí: Chi phí AI một CV (USD), CV xuất PDF, Hài lòng sau PDF (1–5) — điểm người học chấm ngay sau khi tải PDF.

Cảnh báo vận hành "Chi phí AI một CV vượt ngưỡng" bắn khi chi phí trung bình vượt ngưỡng ở trên (quét lúc 03:45 hằng đêm). Nguyên nhân hay gặp: thinking đang bật, hoặc người học tải CV cũ dạng ảnh nhiều lần.

Dữ liệu cá nhân và đồng ý ​

Công cụ gửi nội dung hồ sơ tới Google Gemini chỉ sau khi người học đồng ý một văn bản có phiên bản; đổi văn bản là mọi người phải đồng ý lại. Không bao giờ gửi từ hồ sơ: ảnh, email, điện thoại, địa chỉ, ngày sinh — riêng tệp CV cũ người học tự tải lên thì gửi nguyên trạng. Dữ liệu AI (phiên, khớp tin, điểm chấm, nháp LinkedIn) tự xoá sau 30 ngày không dùng, hoặc ngay khi người học rút đồng ý; nhật ký sự kiện giữ 180 ngày.

Bản kê khai kỹ thuật đầy đủ cho hồ sơ đánh giá tác động (Mẫu 09 theo Nghị định 13/2023) nằm trong mã nguồn tại Modules/CvBuilder/docs/legal.md — đưa cho bộ phận pháp chế trước khi mở cho người học. Ba điểm cần họ quyết: chuyển dữ liệu ra nước ngoài (Gemini), người học dưới 18 tuổi (ngày sinh), và trang CV công khai /p/{mã} in tên, email, điện thoại theo đúng nội dung CV.

Người học tự phục vụ ở Dữ liệu & quyền của bạn: xem đang lưu gì, tải JSON Resume, rút đồng ý, xoá vĩnh viễn. Quản trị viên không có nút xoá thay; yêu cầu xoá xử lý qua tài khoản người học.

Lệnh vận hành ​

bash
php artisan tenants:run cvbuilder:sync-role-templates   # cập nhật thư viện vị trí
php artisan tenants:run cvbuilder:prune-sessions        # dọn dữ liệu AI quá hạn (tự chạy 03:35)
php artisan cvbuilder:scan-cost-alerts --tenant=<id>    # quét cảnh báo chi phí (tự chạy 03:45)
php artisan pdf:smoke                                   # kiểm dịch vụ PDF

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

Người học báo "Gemini API Error" ở mọi lượt AI? Kiểm Mô hình AI trong tab AI công cụ CV: tên mô hình gõ sai, hoặc mô hình không hỗ trợ tắt thinking mà ngân sách đang là 0. Để trống ô mô hình là cách an toàn nhất.

Muốn miễn phí toàn bộ công cụ CV cho người đang học?Kho công cụ → Chính sách công cụ: đặt từng khoá con (mẫu Pro, chấm điểm, khớp tin, LinkedIn) sang Miễn phí khi đang học. Khoá cha vốn đã miễn phí.

Tắt AI mà giữ công cụ? Xoá khoá Gemini hoặc để trống — người học vẫn có form, mẫu, PDF, trang công khai; mọi nút AI ẩn.

LMS Documentation