Skip to content

Trinhvhao/human-resource-management

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏢 QLNS — Hệ thống Quản lý Nhân sự Thông minh

HRMS thế hệ mới cho doanh nghiệp Việt Nam — tích hợp AI chatbot, chấm công bằng khuôn mặt, tính lương tự động, và tuân thủ 100% pháp luật lao động Việt Nam.

Next.js NestJS React TypeScript Tailwind Prisma PostgreSQL TensorFlow


🎯 QLNS là gì?

QLNS là phần mềm quản lý nhân sự toàn diện, được thiết kế riêng cho doanh nghiệp vừa và nhỏ tại Việt Nam. Thay vì dùng nhiều công cụ rời rạc (Excel, email, giấy tờ), QLNS tập hợp mọi thứ vào một hệ thống duy nhất.

Một người quản lý nhân sự dùng QLNS có thể quản lý hồ sơ nhân viên, theo dõi chấm công, duyệt nghỉ phép, tính lương, và trả lời câu hỏi nhân sự bằng AI — tất cả từ một màn hình duy nhất.


👥 Ai sử dụng QLNS?

Vai trò Họ là ai QLNS giúp họ làm gì
Admin Quản trị viên hệ thống Cấu hình toàn bộ hệ thống, quản lý tài khoản, quyền truy cập
HR Manager Trưởng phòng Nhân sự Quản lý nhân viên, tính lương, duyệt nghỉ phép, xem báo cáo tổng hợp
Manager Trưởng nhóm / Trưởng phòng Xem thông tin phòng ban, duyệt tăng ca, theo dõi nhân sự cấp dưới
Employee Nhân viên Xem lương, đăng ký nghỉ phép, check-in chấm công, cập nhật hồ sơ cá nhân

✨ Những điều đặc biệt về QLNS

🤖 AI Chatbot — Hỏi gì cũng trả lời

Nhân viên có thể hỏi chatbot mọi thứ về HR mà không cần liên hệ phòng Nhân sự:

"Tôi còn bao nhiêu ngày phép năm nay?"
"Lương tháng 5 của tôi được tính như thế nào?"
"Tôi đăng ký tăng ca ngày mai được không?"

Chatbot sử dụng RAG (Retrieval-Augmented Generation) — kết hợp kiến thức công ty với dữ liệu thực từ hệ thống — để trả lời chính xác, có ngữ cảnh, hoạt động 24/7.


📸 Chấm công bằng khuôn mặt — Không cần thẻ

Thay vì quét thẻ RFID hay ký tay, nhân viên chỉ cần nhìn vào camera tại quầy. Hệ thống tự động nhận diện khuôn mặt, ghi nhận giờ vào/giờ ra, và tính tổng giờ làm trong ngày.

  • Không lo quên thẻ
  • Không ai nhờ người khác chấm công hộ
  • Không cần thiết bị đắt tiền — dùng camera laptop hoặc điện thoại
  • Đăng ký khuôn mặt chỉ mất 30 giây

💰 Tính lương đúng luật — Không cần Excel

Mỗi tháng, hệ thống tự động tính toán lương cho tất cả nhân viên dựa trên:

Thành phần QLNS tính như thế nào
Lương cơ bản Theo hợp đồng lao động đã ký
Tăng ca 150% (ngày thường) / 200% (ngày nghỉ) / 300% (ngày lễ)
Thuế TNCN 7 bậc lũy tiến từ 5% → 35%, tự động áp đúng bậc
Bảo hiểm BHXH 8%, BHYT 1.5%, BHTN 1% — có trần 36 triệu
Phụ cấp Xăng xe, điện thoại, nhà ở... tùy cấu hình
Giảm trừ Theo loại hợp đồng: thử việc, theo mùa, dưới 3 tháng sẽ không đóng bảo hiểm

Workflow phê duyệt 4 bước đảm bảo không ai tính sai: Bản nháp → Chờ duyệt → Đã duyệt → Đã khóa. Sau khi khóa, dữ liệu lương không thể chỉnh sửa.


📊 Dashboard — Thấy mọi thứ, không cần hỏi ai

Admin / HR nhìn thấy ngay:

  • Tổng số nhân viên, bao nhiêu người đi làm hôm nay, bao nhiêu người nghỉ
  • Biểu đồ xu hướng chấm công 30 ngày gần nhất
  • Danh sách hợp đồng sắp hết hạn trong 30 ngày tới
  • Chi phí lương theo từng phòng ban
  • Ai là nhân viên xuất sắc nhất tháng

Nhân viên nhìn thấy ngay:

  • Số ngày phép còn lại
  • Bảng công tháng này
  • Phiếu lương gần nhất
  • Lịch làm việc tuần này

📋 Workflow — Mọi thứ có quy trình rõ ràng

Không còn email xin phép hay tin nhắn zalo xin nghỉ. Tất cả quy trình HR đều chạy trên hệ thống với audit trail đầy đủ:

Quy trình Diễn ra như thế nào
Nghỉ phép Nhân viên gửi yêu cầu → HR xem lịch phòng ban → Duyệt hoặc từ chối → Số dư phép tự động cập nhật
Tăng ca Nhân viên đăng ký giờ tăng ca → Quản lý duyệt → Giờ tăng ca tự động cộng vào lương
Sửa chấm công Nhân viên yêu cầu sửa giờ → HR xem giờ cũ & mới → Duyệt kèm ghi chú → Bảng công cập nhật
Chấm dứt hợp đồng Nộp đơn → HR tính quyết toán (BH, thuế, tiền lương) → Phê duyệt → Nhân viên chuyển trạng thái
Thay đổi phòng ban Gửi yêu cầu → Admin duyệt → Cập nhật sơ đồ tổ chức & quyền truy cập

🏢 Quản lý tổ chức trực quan

Sơ đồ tổ chức công ty được vẽ tự động từ dữ liệu hệ thống — không cần Visio hay PowerPoint. Admin có thể:

  • Thêm / sửa / xóa phòng ban
  • Gán trưởng phòng
  • Xem cây phân cấp toàn công ty
  • Theo dõi lịch sử thay đổi cơ cấu
  • Gửi yêu cầu thay đổi phòng ban có phê duyệt

🇻🇳 Viết bằng tiếng Việt, thiết kế cho người Việt

  • Giao diện hoàn toàn bằng tiếng Việt
  • Các loại hợp đồng theo Bộ Luật Lao động Việt Nam
  • Ngày nghỉ lễ, Tết theo lịch Việt Nam
  • Định dạng số, ngày tháng theo quy ước Việt Nam
  • Thuế TNCN, bảo hiểm tính đúng quy định pháp luật

🔧 Công nghệ

QLNS được xây dựng trên nền tảng công nghệ hiện đại, đáng tin cậy:

Lớp Công nghệ
Giao diện người dùng Next.js 16 + React 19 — trang web nhanh, responsive trên mọi thiết bị
Backend API NestJS 11 — kiến trúc modular, dễ mở rộng, có tài liệu API tự động
Cơ sở dữ liệu PostgreSQL (Supabase) — dữ liệu được lưu trữ an toàn, connection pooling
Nhận diện khuôn mặt TensorFlow.js — xử lý ngay trên thiết bị, không cần server AI riêng
AI chatbot OpenRouter API (Gemini, Llama, Mistral) + Transformers.js — embeddings tìm kiếm kiến thức
ORM Prisma 5 — truy vấn type-safe, migrations tự động
Lưu trữ file Supabase Storage — ảnh đại diện, tài liệu nhân viên
Email Handlebars templates — email xác thực, thông báo phê duyệt đẹp trên mọi thiết bị

🔒 Bảo mật

Tính năng Chi tiết
Xác thực JWT token — đăng nhập một lần, hết hạn tự đăng xuất
Phân quyền 4 vai trò (Admin / HR / Manager / Employee) — mỗi người chỉ thấy dữ liệu được phép
Mật khẩu bcrypt hashing — không lưu mật khẩu dạng plain text
Duyệt lương 4 bước phê duyệt — không ai tự ý sửa lương
Audit trail Mọi thay đổi đều được ghi log (ai sửa, sửa gì, lúc nào)

🚀 Bắt đầu nhanh

Yêu cầu

  • Node.js 18+
  • PostgreSQL 14+ (hoặc tài khoản Supabase)

1. Backend

cd apps/backend
npm install
cp .env.example .env
# Cập nhật DATABASE_URL trong .env

npm run prisma:generate
npm run prisma:migrate
npm run prisma:seed    # Tùy chọn: tạo dữ liệu mẫu
npm run dev            # Server chạy tại http://localhost:3001

2. Frontend

cd apps/frontend
npm install
cp .env.example .env.local
# Cập nhật NEXT_PUBLIC_API_URL=http://localhost:3001/api

npm run dev            # App chạy tại http://localhost:3000

3. Đăng nhập

Vai trò Email Mật khẩu
Admin admin@2th.com password123
HR Manager hr@2th.com password123
Employee employee@2th.com password123

Lưu ý: Đổi mật khẩu mặc định ngay sau lần đầu tiên đăng nhập trong môi trường thực tế.


📋 Tính năng đầy đủ

👥 Quản lý Nhân viên

  • Tạo, chỉnh sửa, xóa hồ sơ nhân viên
  • Upload ảnh đại diện (có crop tool)
  • Theo dõi lịch sử hoạt động từng nhân viên
  • Đính kèm tài liệu: hợp đồng, bằng cấp, giấy tờ
  • Tìm kiếm & lọc nhanh theo phòng ban, chức vụ, trạng thái
  • Xuất danh sách nhân viên ra Excel

🕐 Chấm công

  • Check-in/check-out bằng khuôn mặt (camera)
  • Check-in/check-out thủ công (nút bấm)
  • Tự động tính giờ làm trong ngày
  • Tự động đánh dấu vắng nếu không check-in trước 7PM
  • Yêu cầu sửa bảng công khi có sai sót
  • Duyệt / từ chối yêu cầu sửa bảng công
  • Xem lịch sử chấm công theo tháng
  • Báo cáo chấm công: tổng giờ làm, tỷ lệ đúng giờ, muộn, vắng

📅 Nghỉ phép

  • 7 loại nghỉ phép: phép năm, ốm, không lương, thai sản, cha sản, hiếu, khác
  • Gửi yêu cầu nghỉ phép trực tuyến
  • HR duyệt hoặc từ chối kèm ghi chú
  • Theo dõi số dư phép năm tự động
  • Xem tổng hợp số dư phép toàn công ty
  • Tự động trừ số dư khi nghỉ phép được duyệt

⏱️ Tăng ca

  • Đăng ký tăng ca theo ngày, giờ
  • Phê duyệt bởi quản lý
  • Tự động tính vào lương tháng (150% ngày thường / 200% nghỉ / 300% lễ)

💰 Lương & Phúc lợi

  • Tạo bảng lương tháng tự động
  • Tính lương: lương cơ bản + tăng ca + phụ cấp - khấu trừ
  • Tính thuế TNCN theo biểu thuế lũy tiến 7 bậc
  • Tính bảo hiểm (BHXH, BHYT, BHTN)
  • Điều chỉnh lương từng nhân viên trước khi duyệt
  • Phê duyệt bảng lương (4 bước)
  • Khóa bảng lương sau khi phê duyệt — không sửa được nữa
  • Xem & tải phiếu lương cá nhân (PDF)
  • Xem tổng thu nhập năm (YTD summary)
  • Cấu hình cấu phần lương: phụ cấp xăng xe, điện thoại, nhà ở...
  • Ghi nhận khen thưởng (tháng, quý, năm, thành tích đặc biệt)
  • Ghi nhận kỷ luật (vi phạm, cảnh cáo)

📄 Hợp đồng lao động

  • 3 loại hợp đồng: thử việc, xác định thời hạn, không xác định thời hạn
  • Theo dõi ngày ký, ngày hết hạn
  • Cảnh báo hợp đồng sắp hết hạn (30 ngày trước)
  • Quản lý phụ lục hợp đồng
  • Quy trình chấm dứt hợp đồng — tính quyết toán tự động

🏛️ Phòng ban & Đội nhóm

  • Thêm / sửa / xóa phòng ban
  • Gán trưởng phòng
  • Xem sơ đồ tổ chức dạng cây tương tác
  • Quản lý đội nhóm trong phòng ban
  • Gán trưởng nhóm, thêm/tháo thành viên
  • Yêu cầu thay đổi cơ cấu phòng ban (có phê duyệt)

📊 Báo cáo & Dashboard

  • Dashboard tổng quan theo vai trò người dùng
  • Biểu đồ chấm công: xu hướng theo ngày/tháng
  • Biểu đồ chi phí lương theo phòng ban
  • Biểu đồ nhân sự: tuyển dụng, nghỉ việc, tỷ lệ nhân viên
  • Top nhân viên xuất sắc tháng
  • Tỷ lệ nghỉ việc (turnover rate)
  • Bản đồ nhiệt chấm công (attendance heatmap)
  • Cảnh báo: hợp đồng hết hạn, nhân viên vi phạm, HR tasks
  • Xuất báo cáo Excel: nhân viên, chấm công, lương, nghỉ phép

🤖 AI Chatbot

  • Trả lời câu hỏi về số ngày phép, lương, chấm công
  • Trả lời câu hỏi về chính sách công ty
  • Tìm kiếm thông tin nhân viên trong công ty
  • Hoạt động 24/7, không cần nhân viên HR trực

🗓️ Lịch làm việc

  • Lịch toàn công ty trên FullCalendar (day/week/month/list)
  • Quản lý ca làm việc: sáng, chiều, đêm, tùy chỉnh giờ
  • Tạo lịch hàng loạt cho nhiều người cùng lúc
  • Lịch cá nhân: nghỉ phép đã duyệt, sự kiện liên quan
  • Quản lý ngày lễ (Quốc khánh, Tết, lễ tết khác)

🔔 Thông báo & Email

  • Thông báo trong ứng dụng cho mọi sự kiện HR
  • Email tự động: xác thực tài khoản, thông báo phê duyệt, phiếu lương
  • Nhắc nhở: hợp đồng hết hạn, nghỉ phép chưa duyệt, deadline

👤 Hồ sơ cá nhân

  • Mỗi nhân viên tự cập nhật: ảnh đại diện, thông tin liên hệ
  • Đổi mật khẩu
  • Xem lịch sử hoạt động cá nhân
  • Xem thông tin hồ sơ: ngày vào làm, phòng ban, chức vụ, hợp đồng

⚙️ Cài đặt hệ thống (Admin)

  • Cấu hình giờ làm việc mặc định
  • Cấu hình grace period check-in (15 phút mặc định)
  • Quản lý ngày nghỉ lễ
  • Quản lý người dùng & phân quyền
  • Cấu hình email SMTP
  • Cấu hình AI chatbot (chọn model, API key)
Tài liệu Nội dung
SETUP_GUIDE.md Hướng dẫn cài đặt đầy đủ từng bước
PROJECT_DOCUMENTATION.md Tài liệu kỹ thuật chi tiết
DEPLOYMENT_GUIDE.md Triển khai lên production
Database Indexes Tối ưu hiệu năng truy vấn

Xây dựng với ❤️ tại Việt Nam
© 2026 QLNS — Hệ thống Quản lý Nhân sự Thông minh

About

Human Resource Management System (HRMS) with RBAC, employee/department, attendance, leave, overtime, salary components, rewards & disciplines — built with Next.js, NestJS, Prisma, and PostgreSQL.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors