TalentLens — AI Resume Screening System

Nền tảng sàng lọc hồ sơ ứng viên (CV) và xếp hạng ứng viên bằng Trí tuệ Nhân tạo có khả năng giải thích (Explainable AI), hỗ trợ đội ngũ Nhân sự (HR), Chuyên viên Tuyển dụng (Recruiter) và Quản lý Tuyển dụng (Hiring Manager) tự động hóa quy trình bóc tách CV/JD, ẩn danh thông tin cá nhân (PII), chấm điểm đa tầng có trích dẫn bằng chứng nguyên văn và gợi ý câu hỏi phỏng vấn một cách minh bạch, công bằng và hiệu quả.

👥 Thành viên & Phân công nhiệm vụ

(Phân chia theo kiến trúc 4 lát cắt dọc độc lập — chi tiết tại docs/team-distribution.md)

STT	Thành viên / Phân hệ	Nhiệm vụ đảm nhận
1	Person A — Foundation, Auth & Audit	Quản lý Tài khoản & Phân quyền RBAC (Admin, Recruiter, Viewer), xác thực JWT + bcrypt, cấu hình Database (SQLAlchemy 2.0 Async + Alembic), Nhật ký kiểm toán bất biến (Audit Log), Dashboard thống kê & Phân tích (Analytics).
2	Person B — CV Pipeline, Parsing & Storage	Luồng tải lên CV đơn lẻ/hàng loạt (PDF, DOCX), chống trùng lặp bằng SHA-256, lưu trữ đối tượng (MinIO S3 / Local Disk + bản sao DB), điều phối hàng đợi bất đồng bộ (Celery + Redis / Inline Runner), bộ bóc tách văn bản (PyMuPDF, pypdf, python-docx) kết hợp nhận diện quang học Tesseract OCR cho PDF dạng ảnh scan.
3	Person C — AI Extraction, PII & Hybrid Scoring	Bộ lọc ẩn danh thông tin nhạy cảm (PII Stripper bằng Regex trước khi gửi AI), trích xuất cấu trúc CV/JD bằng Google Gemini API kèm cơ chế dự phòng Offline Heuristic Parser, thuật toán chấm điểm lai 3 tầng (Rule-based + Semantic + LLM), trích xuất bằng chứng nguyên văn (Evidence Snippets) và sinh câu hỏi phỏng vấn.
4	Person D — JD Management, Ranking UI & Frontend	Kiến trúc Frontend Next.js (App Router, Feature-Driven, Song ngữ Anh/Việt), Quản lý vị trí tuyển dụng (JD) kèm tính năng Upload file PDF/DOCX tự động điền form JD, bộ Tùy chỉnh tỷ lệ % trọng số chấm điểm linh hoạt theo từng JD/CV, Bảng xếp hạng ứng viên (Ranking Review) và quy trình phê duyệt Human-in-the-Loop.

---

🚀 Tính năng chính

• 👤 Quản lý Tài khoản & Phân quyền (RBAC): Đăng ký (có kiểm soát mở/đóng đăng ký công khai), đăng nhập, đổi mật khẩu và quản lý trạng thái tài khoản. Phân quyền chặt chẽ cho 3 vai trò: Admin (toàn quyền quản trị người dùng, hệ thống & xem Audit Log), Recruiter (quản lý JD, tải CV, tùy chỉnh trọng số, chạy AI Matching & duyệt ứng viên), và Viewer (chế độ chỉ đọc cho Hiring Manager).
• 📋 Quản lý Tin tuyển dụng (JD) & Bóc tách File JD tự động: Tạo, chỉnh sửa, lọc và lưu trữ các vị trí tuyển dụng. Tích hợp tính năng Upload file JD (PDF / DOCX) tại endpoint POST /api/v1/jobs/extract-file giúp hệ thống tự động đọc hiểu (qua Gemini AI hoặc Heuristic) và điền sẵn các trường Tiêu đề, Phòng ban, Địa điểm, Mô tả, Yêu cầu, Kỹ năng, Số năm kinh nghiệm, Học vấn để HR kiểm tra trước khi lưu.
• 📄 Pipeline Xử lý CV Đơn lẻ / Hàng loạt & OCR: Hỗ trợ tải lên từng CV hoặc hàng đợi tải lên nhiều CV cùng lúc (PDF, DOCX), tự động phát hiện và đồng bộ lại nếu file trùng mã băm SHA-256, kết hợp Tesseract OCR khi phát hiện file PDF là bản scan/ảnh chụp.
• 🛡️ Ẩn danh Thông tin Cá nhân (Privacy-First PII Masking) & Blind Review: Tự động phát hiện và che dấu Email, Số điện thoại, Ngày sinh, Đường dẫn mạng xã hội và Địa chỉ cá nhân ([EMAIL], [PHONE], [LINK], [DOB], [ADDRESS]) trước khi đưa văn bản vào mô hình AI. Trên giao diện, HR có thể bật/tắt chế độ Ẩn danh tính ứng viên (Blind Review) để giảm thiểu thiên kiến vô thức (Unconscious Bias).
• ⚖️ Chấm điểm Lai 3 Tầng (Hybrid Scoring) & Tùy chỉnh Trọng số (%): Kết hợp 3 phương pháp: Chấm theo quy tắc cứng (Rule-based), Đo độ tương đồng ngữ nghĩa (Semantic) và Đánh giá chuyên sâu bằng AI (LLM Evaluation). HR có thể tùy chỉnh linh hoạt tỷ lệ % chấm điểm của từng hạng mục (Kỹ năng, Kinh nghiệm, Học vấn và Rule, Semantic, AI) mặc định cho từng vị trí JD hoặc chấm lại trực tiếp trên từng hồ sơ ứng viên.
• 🔍 Giải thích Minh bạch kèm Bằng chứng & Câu hỏi Phỏng vấn (Explainable AI): Mỗi điểm số đều đi kèm trích dẫn nguyên văn từ CV (Evidence Snippets) theo 3 mức (found, partial, not_found), danh sách kỹ năng khớp (Matched Skills), kỹ năng còn thiếu (), điểm mạnh, khoảng trống năng lực và bộ .

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗