Skip to content

Trang quản trị ​

Khu vực /admin là nơi quản trị viên và nhà tuyển dụng quản lý người dùng, công ty, tin tuyển dụng và hồ sơ. Trang dành cho người dùng khu vực này, và developer thêm hoặc sửa một trang quản trị.

Vì sao cần ​

Dữ liệu của nền tảng (người dùng, công ty, tin, hồ sơ) cần một nơi quản lý tập trung. Mỗi vai trò thấy và làm được phần khác nhau, giao diện thể hiện điều đó bằng cách ẩn mục và nút mà vai trò không có quyền.

Đối tượng: SUPER ADMIN và HR. AdminRoute bao các trang (dashboard): chưa đăng nhập thì chuyển tới /login, đăng nhập nhưng không phải quản trị hoặc HR thì về /.

WARNING

AdminRoute và CASL chỉ điều khiển giao diện. Quyền thật do backend quyết định bằng @Roles ở từng route; xem Phân quyền.

Đánh đổi: khu vực này thiết kế cho màn hình lớn; trên màn hình nhỏ có biểu ngữ nhắc nên dùng máy tính.

Giao diện ​

Dashboard quản trị

Dashboard quản trị: thanh bên điều hướng, sáu thẻ số liệu, biểu đồ cột việc làm mới và biểu đồ vùng hồ sơ nhận được theo bảy ngày.

Chưa dùng ảnh trang quản lý người dùng vì ảnh chứa tên và email của người dùng seed.

Các trang ​

TrangĐường dẫnNội dung
Dashboard/adminSố liệu toàn nền tảng cho SUPER ADMIN; HR được chuyển sang Dashboard HR
Người dùng/admin/usersTìm theo tên, lọc theo vai trò, thêm, sửa, khóa và mở khóa, xóa, xóa hàng loạt
Công ty/admin/companiesDanh sách, thêm, sửa, xóa, xóa hàng loạt, tải logo
Việc làm/admin/jobsQuản lý tin và duyệt tin, xem Duyệt tin tuyển dụng
Hồ sơ/admin/resumesLọc theo trạng thái, đổi trạng thái, xóa, xóa hàng loạt
Thông tin cá nhân/admin/personal-infoCập nhật thông tin của chính mình
Đổi mật khẩu/admin/change-passwordĐổi mật khẩu của chính mình

Hai trang cuối không có trong thanh bên mà mở từ menu người dùng ở đầu trang. Không có trang quản lý vai trò hay quyền: ba vai trò và quyền của chúng cố định trong src/lib/casl/ability.ts.

Ai thấy gì ​

Thanh bên lọc mục theo quyền CASL (useFilteredNavigation). Mỗi mục gắn một đối tượng quyền:

MụcĐối tượngSUPER ADMINHR
DashboardStatisticCóCó (chuyển sang dashboard HR)
Người dùngUserCóKhông
Công tyCompanyCóCó, chỉ đọc và sửa
Việc làmJobCóCó, tạo, đọc, sửa, xóa
Hồ sơResumeCóCó, đọc và sửa

Nút thêm công ty hiện với người có quyền create trên Company, nút xóa người dùng, công ty và hồ sơ theo quyền delete, nên HR không thấy các nút đó; nút duyệt tin theo quyền approve. Phạm vi dữ liệu theo công ty của HR do backend áp dụng, không phải giao diện.

Xóa hàng loạt ​

Các bảng người dùng, công ty, tin và hồ sơ có hộp chọn từng dòng (useTableSelection) và hộp thoại xác nhận (BulkDeleteConfirmDialog). Mỗi trang gọi endpoint DELETE .../bulk tương ứng với danh sách mã.

API liên quan ​

TrangEndpoint chính
Người dùngEndpoint Users
Công tyEndpoint Companies
Việc làmEndpoint Jobs
Hồ sơEndpoint Resumes
DashboardEndpoint Statistics
Đổi mật khẩuEndpoint Auth

Dữ liệu và kiểm tra ​

Số liệu dashboard quản trị: countActiveJobs, countPendingApprovalJobs, countHiringCompanies, countCompanies, countUsers, xu hướng việc làm và hồ sơ, kỹ năng được cần nhiều nhất, tình trạng xử lý hồ sơ, kèm generatedAt và fromCache; chi tiết ở Endpoint Statistics. Có nút làm mới (refetch) và nhãn độ mới.

Trường hợp lỗi ​

Tình huốngHành vi
Chưa đăng nhập hoặc không có quyền vào khu vựcChuyển về /login hoặc /
Dashboard lỗiThông báo lỗi kèm nút thử lại
HR mở /adminChuyển sang /hr/dashboard
Thao tác bị backend từ chốiToast với thông điệp của backend

Test cases ​

TestNội dung
src/components/statistics/admin-statistics-page.test.tsxHiển thị số liệu từ endpoint của quản trị; chuyển HR khỏi trang
src/components/user/user-form.test.tsxForm người dùng

Chưa có test cho: AdminRoute, thanh bên lọc theo quyền, các trang danh sách và xóa hàng loạt.

Source code liên quan ​

Tài liệu backend: Statistics.

Đọc tiếp: Dashboard HR, Duyệt tin tuyển dụng, Phân quyền.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code