vhr: Bộ khung HR Spring Boot + Vue
微人事 (vhr) là bộ khung (scaffold) học tập bằng Spring Boot và Vue cho một hệ thống quản lý nhân sự, không phải sản phẩm hoàn chỉnh để triển khai thẳng. Code đủ gọn để đọc hết trong một cuối tuần: tác giả dựng nó để trình bày phân quyền bằng Spring Security, migration bằng Flyway và chat qua WebSocket trong cùng một codebase. Hãy coi đây là tài liệu để lấy từng phần ra dùng, không phải phần mềm chạy production nguyên trạng.
微人事 (vhr) là gì?
微人事 (vhr) là hệ thống quản lý nhân sự mã nguồn mở, tách front-end/back-end, viết bằng Java với Spring Boot ở server và Vue cùng ElementUI ở client. Nó bao phủ vai trò và quyền hạn, hồ sơ nhân viên, thiết lập tài khoản lương, và chat thời gian thực giữa nhân viên. Tác giả gọi đây là một scaffold để học stack, không phải sản phẩm HR hoàn chỉnh — README dẫn sang dự án khác là TienChin cho nhu cầu đó.
Tính năng chính: Phân quyền, Nhân sự, Lương, Chat
- ✓Phân quyền theo vai trò trên nền Spring Security: quản trị viên gán vai trò cho người dùng, rồi gán riêng những menu, nút bấm và tài nguyên API mà từng vai trò được động vào.
- ✓Module hồ sơ nhân viên với thêm, sửa, tìm kiếm nâng cao, và import/export hàng loạt sang Excel qua Apache POI.
- ✓Thiết lập tài khoản lương (工资账套) ở cấp công ty, cộng với gán tài khoản lương cho từng nhân viên.
- ✓Quản lý phòng ban, chức vụ và chức danh dưới mục System Management, mỗi phần có thiết kế database riêng được ghi trong wiki dự án.
- ✓Chat thời gian thực giữa nhân viên, dựng trên dự án vue-chat mà README ghi công, cộng với một chuông thông báo riêng cho admin.
- ✓Schema và các bản cập nhật chạy qua migration của Flyway — chỉ cần tạo một database MySQL rỗng, Flyway lo phần còn lại.
- ✓Email chào mừng tự động gửi cho nhân viên mới, dựng từ template Freemarker và gửi trên một thread riêng.
- ✓Spring Cache dùng Redis làm backend, còn RabbitMQ chuyển message giữa module vhrserver và mailserver.
Chạy vhr trên máy local
Clone repo, sau đó tạo một database MySQL rỗng tên vhr — schema và các bản cập nhật chạy qua migration của Flyway, nên bạn không bao giờ phải import file .sql bằng tay. Trỏ cấu hình database, Redis và RabbitMQ trong application.properties về các instance của riêng bạn; RabbitMQ cần được cấu hình hai lần, một lần cho module mailserver và một lần cho vhrserver. Mở project trong IntelliJ IDEA, khởi động module mailserver, rồi chạy module vhr-web bên trong vhrserver — lúc này ứng dụng đã chạy tại http://localhost:8081/index.html. Để phát triển front-end, cd vào vuehr, chạy npm install, rồi npm run serve để serve ứng dụng Vue tại localhost:8080 (nó proxy các request API sang backend Spring Boot đang chạy, nên đừng tắt backend). Để build khi triển khai, chạy npm run build trong vuehr, rồi copy thư mục static và index.html sinh ra trong vuehr/dist vào thư mục resources/static của project Spring Boot.
Bạn có thể xây gì với nó
- •Tài liệu tham khảo để học kiến trúc tách front-end/back-end bằng Spring Boot + Vue, vì wiki trình bày từng bước các quyết định như thiết kế database phân quyền và lưu trạng thái đăng nhập.
- •Bộ khung khởi điểm cho một công cụ HR nội bộ: bỏ các màn hình demo nhân viên/lương rồi gắn schema của riêng bạn vào, giữ nguyên mô hình vai trò của Spring Security.
- •Ví dụ thực tế về RabbitMQ làm một việc thật — gửi email onboarding từ một module mailserver riêng — thay vì demo producer/consumer đồ chơi.
- •Điểm xuất phát để fork trước khi chuyển sang vhr2.0, nếu bạn cụ thể muốn stack Spring Boot 2 / Vue 2 cũ hơn thay vì bản viết lại SpringBoot3+Vue3.
Điểm mạnh
- ✓Wiki trình bày từng bước các quyết định không hề đơn giản — thiết kế database phân quyền, cách vai trò và tài nguyên liên kết động, mã hoá mật khẩu kèm salt — thay vì để bạn tự mò lại từ code.
- ✓Migration bằng Flyway nghĩa là setup chỉ là 'tạo một database rỗng', không phải đi tìm đúng file .sql để import.
- ✓Bộ tính năng vượt xa một demo CRUD: email qua RabbitMQ, chat qua WebSocket, và import/export Excel đều nằm chung trong một codebase nhỏ.
- ✓Tác giả duy trì một update log có ghi chép rồi đưa dự án đi tiếp thay vì bỏ dở — vhr2.0 tồn tại đúng để mang các bài học đó sang Spring Boot 3 và Vue 3.
Hạn chế của vhr bản gốc
- △Tác giả gọi đây là scaffold, không phải dự án hoàn chỉnh cho nghiệp vụ, và dẫn người đọc cần điều đó sang một repo khác, TienChin — vhr thiếu bất kỳ logic nghiệp vụ nào mà một phòng HR thật cần ngoài các module demo.
- △RabbitMQ phải được cấu hình hai lần, một lần cho mailserver và một lần cho vhrserver, và rất dễ bỏ sót một trong hai file cấu hình.
- △README được viết bằng tiếng Trung, không có bản dịch tiếng Anh, nên lập trình viên không biết tiếng Trung phải dựa vào bản dịch máy cho cả README lẫn wiki.
- △Update log trong README này dừng ở mục 2019.12.22 — việc phát triển tích cực từ đó đã chuyển sang bản viết lại riêng vhr2.0 trên Spring Boot 3 và Vue 3.
- △Gửi email cần mã xác thực (authorization code) của tài khoản mail riêng bạn được hardcode vào EmailRunnable.java; không có hướng dẫn thiết lập secret đó qua biến môi trường.
Lựa chọn thay thế: TienChin và vhr2.0
Câu hỏi thường gặp
微人事 (vhr) không còn là nơi tác giả tập trung phát triển — README dẫn người đọc sang vhr2.0, bản viết lại trên Spring Boot 3 và Vue 3 của cùng dự án, như phiên bản đang được duy trì. Dùng vhr để tham khảo stack Spring Boot 2 gốc; dùng vhr2.0 cho bất kỳ việc gì đang tiếp diễn.
微人事 (vhr) dùng MySQL, và các thay đổi schema chạy qua migration của Flyway thay vì import SQL thủ công. Bạn chỉ cần tạo một database rỗng tên vhr ở local; Flyway tự áp schema và các bản cập nhật khi ứng dụng khởi động.
微人事 (vhr) không được thiết kế để chạy production nguyên trạng — tác giả gọi nó là scaffold (脚手架) để học, không phải sản phẩm hoàn chỉnh cho nghiệp vụ, và dẫn người cần một hệ thống đầy đủ sang dự án riêng TienChin. Hãy coi vhr là tài liệu tham khảo để xây tiếp.
微人事 (vhr) triển khai phân quyền theo vai trò bằng Spring Security: quản trị viên gán vai trò cho từng người dùng, rồi gán riêng những menu, trang và thao tác mà mỗi vai trò được động vào. Wiki ghi lại thiết kế database phân quyền và cách vai trò với tài nguyên liên kết động với nhau.
微人事 (vhr) là scaffold học tập của tác giả, dựng để trình bày stack Spring Boot + Vue với một domain HR rút gọn; TienChin là dự án riêng, hoàn chỉnh cho nghiệp vụ, của cùng tác giả, được README của vhr khuyến nghị cho ai cần nhiều hơn một tài liệu tham khảo học tập.
微人事 (vhr) dùng cả hai: Redis để caching cùng Spring Cache, và RabbitMQ để truyền message giữa module vhrserver và mailserver, đặc biệt là để gửi email onboarding. Cả hai đều bắt buộc khi chạy local — trỏ cấu hình của chúng trong application.properties về instance của riêng bạn trước khi khởi động server.
Vấn đề mà nó giải quyết
Phần lớn tutorial Spring Boot chỉ trình bày authentication riêng lẻ: một form login, một JWT filter, xong. 微人事 (vhr) thay vào đó gắn phân quyền theo vai trò vào một domain đầy đủ — phòng ban, hồ sơ nhân viên, tài khoản lương và một module chat — trên cùng một stack Spring Security, MyBatis và Vue, để bạn thấy các phần thực sự tương tác với nhau thay vì một demo một endpoint.
Nên dùng khi nào — và khi nào nên bỏ qua
Những lập trình viên backend đã biết Spring Boot nhưng muốn một ví dụ thực tế về vai trò Spring Security gắn với màn hình thật, chứ không chỉ demo auth, sẽ tận dụng được nhiều nhất từ 微人事 (vhr) — đọc wiki song song với code là đáng công dù phải vượt qua rào cản tiếng Trung sang tiếng Anh. Bỏ qua nó nếu bạn cần một hệ thống HR bằng tiếng Anh dùng ngay, hoặc muốn phiên bản framework hiện tại; hãy đi thẳng sang vhr2.0 thay vì tự vá lại stack Spring Boot 2 / Vue 2 của vhr.
Muốn nghe thêm một ý kiến về vhr?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về vhr.
