1. Giới thiệu

1.1 Mục đích

Tài liệu này định nghĩa các yêu cầu phần mềm cho module Tuyển dụng của Hệ thống Quản lý Nhân sự.

1.2 Phạm vi

Module Tuyển dụng quản lý quy trình tuyển dụng từ đầu đến cuối với hệ thống vai trò hai cấp. Vai trò cấp hệ thống (user, super_admin) được quản lý bởi module AUTH. Vai trò cấp tổ chức (HR, Candidate, Employer) được quản lý trong nội bộ tổ chức. Người dùng tự đăng ký với vai trò hệ thống user và nhận vai trò cấp tổ chức khi tham gia hoặc được thêm vào một tổ chức.

1.3 Phụ thuộc Module

1.4 Định nghĩa

1.5 Vai trò Người dùng

Vai trò Cấp hệ thống (được quản lý bởi module AUTH)

Vai trò Cấp tổ chức (được quản lý trong nội bộ tổ chức)

Lưu ý: Một người dùng có thể có các vai trò cấp tổ chức khác nhau trong các tổ chức khác nhau. Vai trò cấp hệ thống xác định những gì người dùng có thể thực hiện trên toàn hệ thống, trong khi vai trò cấp tổ chức xác định những gì người dùng có thể thực hiện trong một tổ chức cụ thể.

2. Tổng quan Module

2.1 Mô tả Module

2.2 Sơ đồ Trường hợp sử dụng

Hình 1: Sơ đồ Trường hợp sử dụng Tuyển dụng (3 Vai trò)

3. Chi tiết Đặc tả Trường hợp sử dụng

3.1 UC-09: Đăng tin Việc làm

Luồng Chính:

1. Người dùng điều hướng đến trang quản lý việc làm
2. Người dùng nhập chi tiết việc làm (tiêu đề, mô tả, phòng ban, địa điểm)
3. Người dùng nhập khoảng lương và loại hình việc làm
4. Người dùng thêm yêu cầu việc làm
5. Hệ thống lưu việc làm dưới dạng bản nháp với người dùng là chủ sở hữu
6. Người dùng gửi việc làm để duyệt
7. Hệ thống cập nhật trạng thái thành "pending_approval"
8. Hệ thống thông báo cho HR (nếu HR tạo) hoặc thông báo cho admin (nếu Employer tạo)

Lưu ý: Đăng ký là tùy chọn. Người dùng có đăng ký sẽ được các tính năng cao cấp như ưu tiên đăng tin, tin được giới thiệu.

Hình 2: UC-09 Đăng tin Việc làm - Sơ đồ Hoạt động

Hình 3: UC-09 Đăng tin Việc làm - Sơ đồ Chuỗi

3.2 UC-10: Quản lý Việc làm

Luồng Chính:

1. Người dùng điều hướng đến trang quản lý việc làm
2. Hệ thống hiển thị kho việc làm của người dùng:
   • Tất cả việc làm do người dùng này tạo
   • Chỉ báo trạng thái (nháp, mở, đóng, lưu trữ)
   • Số lượng hồ sơ trên mỗi việc làm
3. Người dùng có thể:
   • Chỉnh sửa chi tiết việc làm
   • Thay đổi trạng thái việc làm (mở/đóng/lưu trữ)
   • Xem người nộp đơn cho mỗi việc làm
4. Hệ thống cập nhật bản ghi việc làm

Luồng Thay thế:

• 2a. Employer chưa có đăng ký: Hệ thống hiển thị thông báo yêu cầu đăng ký

3.3 UC-03: Duyệt Việc làm

Luồng Chính:

1. Ứng viên điều hướng đến trang danh sách việc làm
2. Hệ thống hiển thị tất cả việc làm đang mở
3. Ứng viên áp dụng bộ lọc (địa điểm, lương, loại hình)
4. Hệ thống trả về kết quả đã lọc
5. Ứng viên chọn một việc làm để xem chi tiết
6. Hệ thống hiển thị chi tiết việc làm với yêu cầu

Hình 4: UC-03 Duyệt Việc làm - Sơ đồ Hoạt động

Hình 5: UC-03 Duyệt Việc làm - Sơ đồ Chuỗi

3.4 UC-04: Nộp Hồ sơ Ứng tuyển

Luồng Chính:

1. Ứng viên chọn việc làm và nhấn "Ứng tuyển"
2. Ứng viên chọn hồ sơ hiện có từ danh sách hồ sơ của mình, hoặc tải lên hồ sơ mới (PDF/DOCX, tối đa 10MB qua module FILE)
3. Ứng viên nhập thư xin việc
4. Ứng viên xem lại và nộp hồ sơ
5. Hệ thống kiểm tra hồ sơ (kiểm tra resume_file_id tồn tại trong module FILE)
6. Hệ thống kiểm tra trùng lặp hồ sơ
7. Hệ thống đóng băng hồ sơ bằng cách sao chép resume_file_id vào bản ghi hồ sơ (không thể thay đổi sau khi nộp)
8. Hệ thống tạo bản ghi hồ sơ
9. Hệ thống gửi thông báo cho nhà tuyển dụng
10. Ứng viên thấy thông báo thành công

Luồng Thay thế:

• 6a. Đã ứng tuyển: Hệ thống hiển thị lỗi "Đã Ứng tuyển"
• 5a. Dữ liệu đầu vào không hợp lệ: Hệ thống hiển thị lỗi xác thực

Hình 6: UC-04 Nộp Hồ sơ Ứng tuyển - Sơ đồ Hoạt động

Hình 7: UC-04 Nộp Hồ sơ Ứng tuyển - Sơ đồ Chuỗi

3.5 UC-05: Xem Trạng thái Hồ sơ

Luồng Chính:

1. Ứng viên điều hướng đến "Hồ sơ của tôi"
2. Hệ thống hiển thị danh sách hồ sơ
3. Ứng viên chọn một hồ sơ
4. Hệ thống hiển thị chi tiết và trạng thái hồ sơ
5. Ứng viên xem lịch sử trạng thái và dòng thời gian

Hình 8: UC-05 Xem Trạng thái Hồ sơ - Sơ đồ Hoạt động

Hình 9: UC-05 Xem Trạng thái Hồ sơ - Sơ đồ Chuỗi

3.6 UC-06: Duyệt Hồ sơ Ứng tuyển

Luồng Chính:

1. HR điều hướng đến bảng điều khiển hồ sơ
2. Hệ thống hiển thị tất cả hồ sơ
3. HR áp dụng bộ lọc (việc làm, trạng thái)
4. Hệ thống trả về kết quả đã lọc
5. HR chọn một hồ sơ để duyệt
6. HR xem hồ sơ ứng viên, thư xin việc và hồ sơ xin việc (qua URL tải xuống presigned từ module FILE)
7. HR cập nhật trạng thái hồ sơ (sàng lọc/từ chối)

Hình 12: UC-06 Duyệt Hồ sơ Ứng tuyển - Sơ đồ Hoạt động

Hình 13: UC-06 Duyệt Hồ sơ Ứng tuyển - Sơ đồ Chuỗi

3.7 UC-07: Lịch phỏng vấn

Luồng Chính:

1. HR chọn ứng viên từ các hồ sơ đã sàng lọc
2. HR chọn người phỏng vấn
3. HR chọn ngày/giờ và địa điểm
4. HR thêm liên kết họp và ghi chú
5. Hệ thống kiểm tra lịch trống của người phỏng vấn
6. Hệ thống tạo bản ghi phỏng vấn
7. Hệ thống gửi lời mời lịch
8. Hệ thống thông báo cho ứng viên và người phỏng vấn

Hình 14: UC-07 Lịch phỏng vấn - Sơ đồ Hoạt động

Hình 15: UC-07 Lịch phỏng vấn - Sơ đồ Chuỗi

3.8 UC-08: Đánh giá Ứng viên (Interviewer)

Luồng Chính:

1. HR truy cập phỏng vấn đã hoàn thành
2. HR xem lại hồ sơ và CV của ứng viên
3. HR nhập điểm đánh giá (kỹ thuật, giao tiếp, phù hợp văn hóa)
4. HR chọn đề xuất (strong_yes/yes/neutral/no/strong_no)
5. HR thêm nhận xét
6. Hệ thống lưu bản ghi đánh giá
7. Hệ thống cập nhật trạng thái phỏng vấn

Hình 16: UC-08 Đánh giá Ứng viên - Sơ đồ Hoạt động

Hình 17: UC-08 Đánh giá Ứng viên - Sơ đồ Chuỗi

3.9 UC-12: Đánh giá Ứng viên (HR)

Luồng Chính:

1. Người phỏng vấn điều hướng đến phỏng vấn đã hoàn thành
2. Người phỏng vấn nhấn "Viết Đánh giá"
3. Người phỏng vấn đánh giá ứng viên trên nhiều chiều:
   • Kỹ năng chuyên môn (1-5 sao)
   • Kỹ năng giao tiếp
   • Phù hợp văn hóa
   • Khả năng giải quyết vấn đề
   • Làm việc nhóm
4. Người phỏng vấn viết tiêu đề và mô tả đánh giá
5. Người phỏng vấn chọn đề xuất (strong_yes/yes/neutral/no/strong_no)
6. Người phỏng vấn gửi đánh giá
7. Hệ thống lưu bản ghi đánh giá
8. Hệ thống cập nhật điểm trung bình đánh giá của ứng viên

Luồng Thay thế:

• 1a. Phỏng vấn chưa hoàn thành: Hệ thống hiển thị thông báo "Phỏng vấn phải được hoàn thành trước"
• 2a. Đã đánh giá: Hệ thống hiển thị thông báo "Bạn đã đánh giá ứng viên này rồi"

Hình 18: UC-12 Đánh giá Ứng viên - Sơ đồ Hoạt động

Hình 19: UC-12 Đánh giá Ứng viên - Sơ đồ Chuỗi

3.10 UC-15: Quản lý Hồ sơ Xin việc

Luồng Chính:

1. Ứng viên điều hướng đến trang quản lý "Hồ sơ của tôi"
2. Hệ thống hiển thị danh sách tất cả hồ sơ đã tải lên kèm metadata (tên tệp, loại, kích thước, ngày tải lên)
3. Ứng viên có thể:
   • Tải lên hồ sơ mới: Chọn tệp (PDF/DOCX, tối đa 10MB) - tệp được lưu qua module FILE với đường dẫn {candidate_user_id}/resumes/{uuid}.pdf
   • Đặt hồ sơ chính: Đánh dấu một hồ sơ là chính (mặc định cho các hồ sơ mới)
   • Xóa hồ sơ: Xóa hồ sơ chưa được liên kết với bất kỳ hồ sơ ứng tuyển nào
   • Tải xuống hồ sơ: Lấy URL tải xuống presigned từ module FILE để xem hồ sơ
4. Hệ thống kiểm tra loại tệp và kích thước
5. Hệ thống gọi module FILE để lưu tệp và nhận file_id
6. Hệ thống tạo bản ghi recr_candidate_resumes với tham chiếu file_id
7. Hệ thống trả về danh sách hồ sơ đã cập nhật

Luồng Thay thế:

• 3a. Loại tệp không hợp lệ: Hệ thống trả về lỗi "Chỉ cho phép tệp PDF và DOCX"
• 3b. Tệp quá lớn: Hệ thống trả về lỗi "Kích thước tệp không được vượt quá 10MB"
• 3c. Xóa hồ sơ đã liên kết: Hệ thống trả về lỗi "Không thể xóa hồ sơ đã liên kết với hồ sơ ứng tuyển đã nộp"
• 4a. Module FILE không khả dụng: Hệ thống trả về lỗi "Dịch vụ tệp tạm thời không khả dụng"

3.11 UC-13: Cập nhật Hồ sơ

Luồng Chính:

1. Người dùng điều hướng đến trang hồ sơ
2. Hệ thống hiển thị dữ liệu hồ sơ hiện tại
3. Người dùng chỉnh sửa các trường hồ sơ:
   • Tất cả vai trò: Họ tên, số điện thoại, ảnh đại diện
   • Candidate: Hồ sơ xin việc, kỹ năng, kinh nghiệm, lương mong muốn
   • HR: Phòng ban, chức vụ
   • Employer: Tên công ty, trang web, mô tả, ngành nghề, quy mô
4. Người dùng gửi thay đổi
5. Hệ thống kiểm tra dữ liệu đầu vào
6. Hệ thống cập nhật bản ghi hồ sơ
7. Hệ thống trả về phản hồi thành công

Luồng Thay thế:

• 3a. Dữ liệu đầu vào không hợp lệ: Hệ thống hiển thị lỗi xác thực
• 4a. Tải lên thất bại: Hệ thống hiển thị lỗi tải lên tệp

Hình 10: UC-13 Cập nhật Hồ sơ - Sơ đồ Hoạt động

Hình 11: UC-13 Cập nhật Hồ sơ - Sơ đồ Chuỗi

3.12 UC-11: Đánh giá Việc làm

Luồng Chính:

1. Ứng viên điều hướng đến danh sách việc làm
2. Ứng viên nhấn "Viết Đánh giá"
3. Ứng viên đánh giá việc làm trên nhiều chiều:
   • Đánh giá tổng thể (1-5 sao)
   • Cân bằng công việc-cuộc sống
   • Đền bù
   • Phát triển nghề nghiệp
   • Văn hóa công ty
4. Ứng viên viết tiêu đề và mô tả đánh giá
5. Ứng viên gửi đánh giá
6. Hệ thống lưu bản ghi đánh giá
7. Hệ thống cập nhật điểm trung bình đánh giá của việc làm

Luồng Thay thế:

• 1a. Ứng viên chưa ứng tuyển: Hệ thống hiển thị thông báo "Chỉ người nộp đơn mới có thể đánh giá"
• 2a. Đã đánh giá: Hệ thống hiển thị thông báo "Bạn đã đánh giá việc làm này rồi"

Hình 20: UC-11 Đánh giá Việc làm - Sơ đồ Hoạt động

Hình 21: UC-11 Đánh giá Việc làm - Sơ đồ Chuỗi

3.13 UC-17: Trích xuất Skills từ CV bằng AI

Luồng Chính:

1. Hệ thống nhận sự kiện resume.uploaded sau khi CV lưu thành công vào module FILE
2. Hệ thống đưa job xử lý vào hàng đợi (queue) phân tích CV, trạng thái CV = processing
3. Worker lấy nội dung CV (qua module FILE, presigned URL) và trích xuất văn bản (OCR nếu ảnh scan)
4. Worker gọi AI (LLM) với prompt trích xuất: kỹ năng cứng, kỹ năng mềm, số năm kinh nghiệm, chức danh, trình độ học vấn
5. AI trả về danh sách skills/tags dạng có cấu trúc (JSON) kèm điểm tin cậy (confidence score) cho từng tag
6. Hệ thống chuẩn hóa tag (map về từ điển skill chuẩn — vd "ReactJS" và "React.js" → "React")
7. Hệ thống lưu kết quả vào recr_resume_skills, cập nhật trạng thái CV = analyzed
8. Candidate thấy danh sách skill được gợi ý trên trang "Hồ sơ của tôi", có thể sửa/xóa/thêm thủ công

Luồng Thay thế:

• 3a. CV là ảnh scan chất lượng thấp/không đọc được: trạng thái = failed, thông báo Candidate tự nhập tay
• 4a. AI service timeout/lỗi: retry tối đa 3 lần với backoff, sau đó chuyển failed
• 8a. Candidate chỉnh sửa tag do AI gợi ý sai: hệ thống lưu is_manual_override = true cho tag đó (không bị ghi đè ở lần phân tích lại)

Sơ đồ Hoạt động

Hình 24: Luồng Trích xuất Tags/Skills từ CV bằng AI

Sơ đồ Chuỗi

Hình 25: Tích hợp Trích xuất Skills từ CV

3.14 UC-18: Trích xuất Skills từ JD bằng AI

Luồng Chính:

1. HR/Employer nhập xong mô tả công việc + yêu cầu (UC-09 bước 2-4), lưu nháp
2. Hệ thống tự động (hoặc HR chủ động bấm nút) gửi job vào hàng đợi phân tích JD
3. Worker gọi AI với nội dung JD: tiêu đề, mô tả, yêu cầu, đưa ra danh sách skill/tag bắt buộc (required) và ưu tiên (nice_to_have)
4. Hệ thống chuẩn hóa tag theo cùng từ điển skill dùng cho CV (đảm bảo đồng nhất để matching)
5. Hệ thống lưu vào recr_job_skills, hiển thị gợi ý cho HR dưới dạng chip có thể chọn/bỏ trước khi công bố
6. HR xác nhận hoặc chỉnh sửa danh sách tag, lưu lại
7. Tin tuyển dụng tiếp tục luồng gửi duyệt (UC-09 bước 6 trở đi)

Luồng Thay thế:

• 3a. JD quá ngắn/thiếu thông tin: AI trả về danh sách rỗng hoặc cảnh báo, gợi ý HR bổ sung mô tả
• 3b. AI service lỗi: HR vẫn có thể đăng tin bình thường, tự nhập tag thủ công (tính năng AI không chặn luồng đăng tin)

Lưu ý thiết kế: Vì skill trên CV và JD phải dùng chung một hệ tag/skill chuẩn hóa, cần một bảng master recr_skills_taxonomy — tránh tình trạng CV ghi "NodeJS" còn JD ghi "Node.js" thành 2 tag khác nhau, làm sai điểm matching.

Sơ đồ Hoạt động

Hình 26: Luồng Trích xuất Tags/Skills từ JD bằng AI

Sơ đồ Chuỗi

Hình 27: Tích hợp Trích xuất Skills từ JD

3.15 UC-19: Tính điểm Matching Ứng viên - Việc làm

Luồng Chính:

1. Candidate xem chi tiết một job / hoặc HR mở danh sách ứng viên đã nộp cho 1 job
2. Hệ thống lấy danh sách tag của CV và tag của Job
3. Hệ thống tính điểm theo công thức trọng số (vd: required skill khớp = 70%, nice-to-have khớp = 20%, kinh nghiệm/trình độ phù hợp = 10%)
4. Hệ thống lưu kết quả vào recr_match_scores kèm breakdown (tag nào khớp, tag nào thiếu)
5. Hệ thống hiển thị điểm % kèm chi tiết: "Khớp 8/10 kỹ năng yêu cầu, thiếu: Docker, Kubernetes"
6. (HR) Danh sách người nộp đơn được sắp xếp mặc định theo điểm matching giảm dần

Luồng Thay thế:

• 2a. CV hoặc Job chưa được AI phân tích xong (đang processing): hiển thị "Đang tính toán độ phù hợp..."
• 3a. Không có tag nào ở 1 trong 2 phía: điểm = 0%, hiển thị "Chưa đủ dữ liệu để so khớp"

Sơ đồ Hoạt động

Hình 28: Luồng Tính điểm Matching Ứng viên - Việc làm

Sơ đồ Chuỗi

Hình 29: Tích hợp Tính điểm Matching

3.16 UC-20: Gợi ý Ứng viên Phù hợp

Luồng Chính:

1. Hệ thống nhận sự kiện job.approved, đưa job vào hàng đợi xử lý gợi ý ứng viên
2. Worker lấy danh sách skill yêu cầu của việc làm từ recr_job_skills, giới hạn phạm vi ứng viên trong cùng tổ chức đăng job
3. Worker lọc sơ bộ ứng viên bằng truy vấn có ít nhất một skill trùng với việc làm (join recr_resume_skills với recr_job_skills), chỉ lấy ứng viên có is_open_to_work = true và không ở trạng thái "hired" cho việc làm khác trong tổ chức
4. Với từng ứng viên trong tập đã lọc, worker gọi lại hàm tính điểm phù hợp dùng chung với UC-19 (không viết thuật toán riêng)
5. Hệ thống lọc các ứng viên có điểm phù hợp trên ngưỡng cấu hình (mặc định 70%), sắp xếp giảm dần, lấy tối đa N ứng viên đầu (mặc định 20)
6. Hệ thống kiểm tra giới hạn tần suất: bỏ qua ứng viên đã nhận đủ số lời mời gợi ý tối đa từ tổ chức này trong khoảng thời gian cấu hình (mặc định tối đa 3 gợi ý/tuần/tổ chức)
7. Hệ thống lưu kết quả vào recr_job_suggestions với trạng thái "new"
8. Hệ thống gửi thông báo cho HR phụ trách: "N ứng viên phù hợp cho việc làm [tên việc làm]"
9. HR mở danh sách gợi ý, xem chi tiết điểm phù hợp và có thể gửi lời mời ứng tuyển trực tiếp (tái sử dụng luồng mời hiện có ở module Invitation)

Luồng Thay thế:

• 3a. Không có ứng viên nào thỏa điều kiện lọc sơ bộ: hệ thống không tạo gợi ý, không gửi thông báo
• 5a. Không có ứng viên nào đạt ngưỡng điểm phù hợp: hệ thống ghi log, không gửi thông báo cho HR
• 6a. Ứng viên đã đạt giới hạn tần suất nhận gợi ý: ứng viên bị loại khỏi danh sách gợi ý cho job này, không tính là lỗi, tiếp tục xử lý các ứng viên còn lại
• 6b. Cùng một ứng viên phù hợp với nhiều job được duyệt gần nhau (trong cùng ngày, cùng tổ chức): hệ thống gộp thành một thông báo duy nhất cho ứng viên ("Có N vị trí phù hợp với bạn") thay vì gửi riêng lẻ từng job
• 9a. HR gửi lời mời cho ứng viên gợi ý: hệ thống cập nhật trạng thái gợi ý tương ứng thành "contacted"
• 9b. HR bỏ qua gợi ý: HR có thể đánh dấu "Bỏ qua", trạng thái chuyển thành "dismissed", không gợi ý lại ứng viên đó cho cùng việc làm

Sơ đồ Hoạt động

Hình 30: Luồng Gợi ý Ứng viên Phù hợp cho Việc làm Mới

Sơ đồ Chuỗi

Hình 31: Tích hợp Gợi ý Ứng viên

3.17 UC-14: Xem Bảng Điều khiển

Luồng Chính:

1. Người dùng điều hướng đến trang bảng điều khiển
2. Hệ thống truy vấn OpenSearch để lấy dữ liệu tổng hợp
3. Hệ thống hiển thị bảng điều khiển với:
   • Phân tích Người dùng:
     • Tổng số người dùng đã đăng ký (theo vai trò: Candidate, HR, Employer)
     • Đăng ký mới (hàng ngày, hàng tuần, hàng tháng)
     • Người dùng hoạt động (đăng nhập trong 7 ngày qua)
     • Biểu đồ xu hướng tăng trưởng người dùng
   • Phân tích Đăng nhập:
     • Tổng số lần đăng nhập (theo vai trò)
     • Tần suất đăng nhập (theo giờ, theo ngày)
     • Số lần đăng nhập thất bại
     • Thời điểm đăng nhập cao điểm
   • Phân tích Tuyển dụng: (Chỉ HR)
     • Việc làm đang mở
     • Hồ sơ đã nhận
     • Phỏng vấn đã lên lịch
     • Đề nghị đã gửi
   • Phân tích Đăng ký:
     • Đăng ký đang hoạt động theo gói
     • Doanh thu theo gói
     • Đăng ký sắp hết hạn
4. Người dùng có thể lọc theo khoảng thời gian
5. Hệ thống cập nhật bảng điều khiển với dữ liệu đã lọc

Luồng Thay thế:

• 2a. OpenSearch không khả dụng: Hệ thống hiển thị dữ liệu đã lưu trong bộ nhớ đệm hoặc thông báo lỗi
• 4a. Không có dữ liệu: Hệ thống hiển thị thông báo "Không có dữ liệu"

3.18 UC-21: Báo cáo & Thống kê Tương tác Ứng viên

Các chỉ số KPI cần thống kê:

Bộ lọc & Phân đoạn dữ liệu:

Luồng Chính:

1. Người dùng điều hướng đến trang "Báo cáo Tương tác Ứng viên"
2. Hệ thống hiển thị bộ lọc mặc định (30 ngày gần nhất, tất cả vị trí, tất cả phòng ban)
3. Hệ thống truy vấn database để lấy dữ liệu thô theo bộ lọc mặc định
4. Hệ thống tính toán các chỉ số KPI: New CV Uploads, Updated CVs, Total Job Applications, Application Success Rate
5. Hệ thống render biểu đồ (line chart theo thời gian, bar chart theo vị trí, pie chart theo trạng thái) và bảng số liệu chi tiết
6. Người dùng xem báo cáo, có thể hover để xem tooltip chi tiết
7. Người dùng thay đổi bộ lọc (thời gian, vị trí, phòng ban, trạng thái)
8. Hệ thống refresh dữ liệu và render lại biểu đồ/bảng với bộ lọc mới

Luồng Thay thế:

• 6a. Xuất file Excel/CSV: Người dùng nhấn "Xuất file" → Hệ thống generate file với đầy đủ dữ liệu → Trả về download URL → Người dùng tải file
• 6b. Thay đổi khoảng thời gian: Người dùng chọn timeframe khác → Hệ thống query lại dữ liệu → Cập nhật biểu đồ và bảng
• 6c. So sánh kỳ: Người dùng chọn "So sánh với kỳ trước" → Hệ thống query dữ liệu kỳ trước → Hiển thị % thay đổi trên từng KPI

Luồng Ngoại lệ:

• 3a. Không có dữ liệu trong khoảng thời gian chọn: Hệ thống hiển thị thông báo "Không có dữ liệu trong khoảng thời gian đã chọn" với gợi ý mở rộng khoảng thời gian
• 3b. Lỗi tải dữ liệu: Hệ thống hiển thị thông báo lỗi "Không thể tải dữ liệu báo cáo", cho phép nhấn nút tải lại (retry)
• 3c. Database quá tải: Hệ thống trả về dữ liệu từ cache (Redis) nếu có, nếu không hiển thị thông báo "Hệ thống đang bận, vui lòng thử lại sau"

Quy tắc Nghiệp vụ:

Yêu cầu Phi chức năng:

FR Liên quan: FR-054, FR-055, FR-056

Sơ đồ Chuỗi

Hình 32: UC-21 Báo cáo & Thống kê Tương tác Ứng viên - Sơ đồ Chuỗi

3.19 UC-01: Mua Gói Đăng ký

Luồng Chính:

1. Người dùng điều hướng đến trang đăng ký gói
2. Hệ thống hiển thị các gói có sẵn:
   • 1 Tháng: Giá tiêu chuẩn
   • 6 Tháng: Giảm 10%
   • 1 Năm: 2 tháng miễn phí (trả tiền cho 10 tháng)
3. Người dùng chọn gói
4. Hệ thống tính toán giá cuối cùng với giảm giá
5. Người dùng xem lại tóm tắt đơn hàng
6. Người dùng hoàn thành thanh toán
7. Hệ thống tạo bản ghi đăng ký
8. Hệ thống kích hoạt đăng ký
9. Người dùng nhận xác nhận
10. Người dùng có thể truy cập tính năng cao cấp (khác nhau tùy vai trò)

Lợi ích Đăng ký theo Vai trò:

• Candidate: Ưu tiên ứng tuyển, nâng cấp hồ sơ, phân tích nâng cao
• HR: Công cụ tuyển dụng nâng cao, hỗ trợ ưu tiên, phân tích nâng cao
• Employer: Đăng tin cao cấp, tin được giới thiệu, theo dõi ứng viên nâng cao

Luồng Thay thế:

• 7a. Thanh toán thất bại: Hệ thống hiển thị lỗi, gói đăng ký không được kích hoạt
• 7b. Đã hủy thanh toán: Hệ thống quay lại lựa chọn gói

3.20 UC-02: Quản lý Gói Đăng ký

Luồng Chính:

1. Người dùng điều hướng đến trang quản lý đăng ký
2. Hệ thống hiển thị trạng thái đăng ký hiện tại:
   • Tên gói và thời hạn
   • Ngày bắt đầu và ngày kết thúc
   • Số ngày còn lại
   • Trạng thái gia hạn tự động
3. Employer có thể:
   • Gia hạn đăng ký
   • Nâng cấp gói (ví dụ: 1 tháng -> 6 tháng)
   • Hủy gia hạn tự động
4. Hệ thống xử lý yêu cầu
5. Hệ thống cập nhật bản ghi đăng ký

3.21 UC-16: Cấu hình Webhook Cá nhân

Luồng Chính:

1. Người dùng điều hướng đến trang Cài đặt > Webhook
2. Người dùng nhập URL webhook (endpoint đích)
3. Người dùng chọn các sự kiện muốn nhận. Mặc định chỉ có application.submitted
4. Người dùng bật công tắc "Kích hoạt Webhook"
5. Hệ thống xác thực định dạng URL (phải là HTTPS)
6. Hệ thống gửi một sự kiện test (webhook.test) đến URL để xác minh endpoint phản hồi 2xx
7. Hệ thống lưu cấu hình webhook cho người dùng
8. Người dùng thấy thông báo thành công kèm trạng thái "Đang hoạt động"

Luồng Thay thế:

• 5a. URL không hợp lệ hoặc không phải HTTPS: Hệ thống hiển thị lỗi xác thực
• 6a. Test webhook thất bại (timeout/lỗi 4xx-5xx): Hệ thống lưu cấu hình ở trạng thái "Chưa xác minh" và cảnh báo người dùng, không tự động kích hoạt

Sơ đồ Hoạt động

Hình 33: Luồng Cấu hình Webhook Cá nhân

Sơ đồ Chuỗi

Hình 34: Tích hợp Cấu hình Webhook

3.22 UC-22: Đăng tin Hot Job

Luồng Chính:

1. HR/Employer chọn việc làm cần đẩy Hot
2. Hệ thống hiển thị tùy chọn Hot Job:
   • 3 Ngày: Giá tiêu chuẩn
   • 7 Ngày: Giảm 10%
   • 14 Ngày: Giảm 20%
3. Người dùng chọn thời hạn và thanh toán
4. Hệ thống cập nhật việc làm: is_hot = true, hot_expires_at = now + duration
5. Việc làm hiển thị nhãn "HOT" và ưu tiên trong kết quả tìm kiếm
6. Hệ thống gửi thông báo khi Hot Job sắp hết hạn

Luồng Thay thế:

• 1a. Chưa có gói Premium: Hiển thị thông báo "Cần gói Premium để sử dụng Hot Job"
• 3a. Thanh toán thất bại: Gói Hot Job không được kích hoạt

3.23 UC-23: Mua Quảng cáo Job (Ads Job)

Luồng Chính:

1. HR/Employer chọn việc làm cần quảng cáo
2. Hệ thống hiển thị tùy chọn quảng cáo:
   • Gói Cơ bản: Hiển thị trên trang chủ, 7 ngày
   • Gói Nâng cao: Hiển thị trên trang chủ + email recommendation, 14 ngày
   • Gói Premium: Hiển thị trên trang chủ + email + push notification, 30 ngày
3. Người dùng chọn gói và ngân sách quảng cáo
4. Hệ thống tính toán chi phí dựa trên gói và thời hạn
5. Người dùng hoàn thành thanh toán
6. Hệ thống tạo bản ghi quảng cáo (recr_job_ads)
7. Job được gắn nhãn "Ad" và hiển thị ưu tiên
8. Hệ thống theo dõi lượt hiển thị và lượt nhấp

Luồng Thay thế:

• 5a. Thanh toán thất bại: Quảng cáo không được kích hoạt
• 8a. Job hết hạn: Quảng cáo tự động dừng, hệ thống gửi báo cáo hiệu quả

3.24 UC-24: Ứng tuyển qua Link HR

Luồng Chính:

1. Ứng viên nhận link job từ HR (qua email, Zalo, LinkedIn...)
2. Ứng viên truy cập link → Hệ thống hiển thị chi tiết job
3. Ứng viên nhấn "Ứng tuyển ngay"
4. Nếu chưa đăng nhập: Hệ thống yêu cầu đăng ký/đăng nhập
5. Ứng viên chọn hồ sơ hoặc tải lên mới
6. Ứng viên nhập thư xin việc
7. Hệ thống gắn source = "hr_link" để track hiệu quả recruitment link
8. Hệ thống tạo bản ghi ứng tuyển
9. Hệ thống gửi thông báo cho HR: "Có ứng viên mới qua link chia sẻ"

Lợi ích:

• HR theo dõi được hiệu quả từng link chia sẻ
• Ứng viên trải nghiệm ứng tuyển nhanh, không cần tìm kiếm
• Tính conversion rate từ link HR

3.25 UC-25: HR Chia sẻ Link Job

Luồng Chính:

1. HR chọn việc làm cần chia sẻ
2. Hệ thống tạo link rút gọn: recr.com/j/{job_id}?ref={hr_id}
3. HR thấy Preview card của job (tiêu đề, lương, địa điểm)
4. HR chọn kênh chia sẻ:
   • Sao chép link
   • Gửi qua email
   • Chia sẻ lên mạng xã hội
5. Hệ thống ghi nhận hr_job_links (hr_id, job_id, channel, created_at)
6. HR có thể xem thống kê lượt click từ link

3.26 UC-26: Tính Hoa hồng HR

Luồng Chính:

1. Ứng viên được đánh giá "hired" bởi Employer
2. Hệ thống kiểm tra HR nào đã:
   • Tạo việc làm này, HOẶC
   • Refer ứng viên này (qua link HR), HOẶC
   • Phỏng vấn và đánh giá ứng viên này
3. Hệ thống tính hoa hồng dựa trên:
   • Loại việc làm: IT = 10%, Non-IT = 8%
   • Lương tháng đầu: Lương gross × % hoa hồng
   • Thời hạn: Hoa hồng thanh toán sau 30 ngày thử việc
4. Hệ thống tạo bản ghi hoa hồng (recr_hr_commissions)
5. Admin xem danh sách hoa hồng chờ thanh toán
6. Admin xác nhận thanh toán hoa hồng
7. Hệ thống cập nhật trạng thái: pending → paid

Công thức tính:

commission_amount = gross_salary × commission_rate
commission_rate = job_type == "IT" ? 0.10 : 0.08
payment_date = hired_date + 30 days

3.27 UC-27: Tạo Tổ chức (Organization)

Luồng Chính:

1. Người dùng điều hướng đến trang "Tạo Tổ chức"
2. Hệ thống hiển thị form tạo tổ chức:
   • Tên tổ chức: Bắt buộc, duy nhất
   • URL Slug: Duy nhất, tự động tạo từ tên, có thể chỉnh sửa. Định dạng: recr.com/o/{slug}
   • Mô tả: Optional
   • Lĩnh vực: Dropdown chọn
   • Website: Optional
   • Logo: Optional (upload qua FILE module)
3. Người dùng nhập thông tin và nhấn "Tạo"
4. Hệ thống kiểm tra:
   • Tên tổ chức chưa tồn tại
   • Slug chưa tồn tại (kiểm tra real-time khi nhập)
   • Người dùng chưa sở hữu tổ chức khác
5. Hệ thống tạo bản ghi tổ chức (status: active)
6. Hệ thống tạo bản ghi thành viên với role: owner
7. Người dùng thấy thông báo thành công và được chuyển đến trang tổ chức
8. Người dùng có thể bắt đầu đăng tin tuyển dụng

Luồng Thay thế:

• 4a. Tên tổ chức đã tồn tại: Hệ thống hiển thị lỗi "Tên tổ chức đã được sử dụng"
• 4b. Slug đã tồn tại: Hệ thống gợi ý slug khác
• 4c. Đã có tổ chức: Hệ thống từ chối "Bạn chỉ có thể tạo 1 tổ chức"

3.28 UC-28: Quản lý Tổ chức

Luồng Chính:

1. Owner truy cập trang quản lý tổ chức
2. Hệ thống hiển thị thông tin tổ chức:
   • Tên, slug, mô tả, logo
   • Danh sách thành viên (Owner, HR)
   • Số lượng việc làm đang đăng
3. Owner có thể:
   • Chỉnh sửa thông tin tổ chức
   • Mời HR qua email
   • Quản lý vai trò thành viên
   • Xóa thành viên (không xóa được Owner)
4. HR được mời nhận email và chấp nhận
5. HR trở thành thành viên của tổ chức, có thể đăng tin tuyển dụng

3.29 UC-29: Đăng tin Việc làm (Draft → Publish)

Luồng Chính:

1. Người dùng nhấn "Tạo tin tuyển dụng mới"
2. Hệ thống kiểm tra OrgGuard: người dùng thuộc tổ chức active
3. Hệ thống hiển thị form tạo việc làm
4. Bước 1 - Lưu nháp:
   • Người dùng nhập thông tin bất kỳ (không bắt buộc đầy đủ)
   • Nhấn "Lưu nháp" → Việc làm được lưu với status: draft
   • Có thể lưu lại bất cứ lúc nào
5. Bước 2 - Chỉnh sửa:
   • Chỉ sửa được việc làm có status: draft
   • Có thể thêm/bớt yêu cầu công việc (skills, kinh nghiệm...)
6. Bước 3 - Đăng tin:
   • Nhấn "Đăng tin" → Hệ thống validate đầy đủ:
   • title - không rỗng
   • description - không rỗng
   • salary_min <= salary_max
   • location - không rỗng
   • job_type - hợp lệ (full_time, part_time, contract...)
7. Nếu validate thành công: status → pending_approval
8. Admin/HR duyệt tin → status → open
9. Việc làm hiển thị trên trang tìm việc

Luồng Thay thế:

• 5a. Validate thất bại: Hệ thống hiển thị lỗi, cho phép chỉnh sửa
• 7a. Admin từ chối: status → draft, lý do từ chối

4. Yêu cầu Chức năng

4.1 Yêu cầu Ứng viên

4.3a Yêu cầu HR/Employer — AI & Matching

4.2 Yêu cầu HR

4.3 Yêu cầu Nhà tuyển dụng

4.4 Yêu cầu Đăng ký

4.5 Yêu cầu Đánh giá

4.6 Yêu cầu Phân tích

4.7 Yêu cầu Lời mời

5. Mô hình Dữ liệu

5.1 Sơ đồ Quan hệ Thực thể

Hình 22: ERD Tuyển dụng (3 Vai trò)

5.2 Yêu cầu Dữ liệu

5.3 Chi tiết Bảng — recr_webhook_configs

5.4 Chi tiết Bảng — recr_resume_skills

5.5 Chi tiết Bảng — recr_job_skills

5.6 Chi tiết Bảng — recr_skills_taxonomy

5.7 Chi tiết Bảng — recr_match_scores

5.8 Chi tiết Bảng — recr_job_suggestions

6. Đặc tả API

6.1 Tổng quan Endpoint

Endpoint Xác thực (Tất cả Vai trò)

Endpoint Ứng viên

Endpoint HR

Endpoint Candidate — Open to Work

Endpoint Đăng ký (Tất cả Vai trò)

Endpoint Lời mời

Endpoint Nhà tuyển dụng

7. Tích hợp

7.1 Sơ đồ Chuỗi

Hình 23: Luồng Ứng tuyển Ứng viên

7.2 Sự kiện Webhook

7.2.1 Webhook Nội bộ (RabbitMQ)

Giao tiếp giữa các module trong hệ thống, dùng RabbitMQ làm message broker.

7.2.2 Webhook Ngoài (HTTP POST — Tính năng mới)

Người dùng (HR/Employer) cấu hình URL đích để nhận sự kiện từ hệ thống ra bên ngoài (ATS, Slack, CRM...). Được ký bằng HMAC secret_key để xác thực nguồn gửi.

Lưu ý: Mặc định khi tạo webhook, sự kiện application.submitted được chọn sẵn. HR có thể bổ sung thêm sự kiện sau đó.

7.3 API Webhook

7.4 Tích hợp AI Trích xuất Skills

Luồng xử lý tự động khi Candidate tải CV lên:

7.5 Tích hợp AI Trích xuất Skills từ JD

Luồng xử lý khi HR/Employer lưu nháp job:

7.6 Tích hợp Matching Score

Luồng tính điểm khi Candidate xem job hoặc HR xem danh sách ứng viên:

7.7 Tích hợp Gợi ý Ứng viên (UC-20)

Luồng tự động khi job được duyệt:

8. Yêu cầu Phi chức năng

9. Ma trận Truy cập Hồ sơ RBAC

Lưu ý: Tất cả việc tải hồ sơ của HR và Nhà tuyển dụng đều thực hiện qua URL presigned có thời hạn được tạo bởi module FILE. Truy cập tệp trực tiếp không bao giờ được hiển thị.

10. Ma trận Truy xuất Yêu cầu