Skip to content

Endpoint Users ​

Trang này liệt kê 14 endpoint người dùng trong user.api.ts: quản trị người dùng, lưu việc làm và theo dõi công ty. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao một nhóm có cả quản trị và thao tác cá nhân ​

Backend gom mọi thao tác trên người dùng vào /users: quản trị viên quản lý người dùng, còn ứng viên lưu việc và theo dõi công ty của chính mình. Frontend giữ nguyên cách gom đó. Phần thao tác cá nhân dùng cập nhật lạc quan để giao diện đổi ngay.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useGetUsersQueryGET /users?page=..&limit=..PaginatedQueryParamsCung cấp User(dashboard)/admin/users/page.tsx
useGetUserQueryGET /users/:ididCung cấp { User, id }Chưa có nơi nào dùng
useCreateUserMutationPOST /usersCreateUserFormDataLàm mất hiệu lực Userhooks/use-user.ts
useUpdateUserMutationPATCH /users/:id{ id, data: UpdateUserFormData }{ User, id } và Userhooks/use-user.ts, (dashboard)/admin/personal-info/page.tsx
useDeleteUserMutationDELETE /users/:ididUserhooks/use-user.ts
useLockUserMutationPATCH /users/:id/lock{ id, reason? }; body { reason } hoặc {}{ User, id } và Userhooks/use-user.ts
useUnlockUserMutationPATCH /users/:id/unlockid{ User, id } và Userhooks/use-user.ts
useBulkDeleteUsersMutationDELETE /users/bulkstring[], body { ids }User(dashboard)/admin/users/page.tsx
useSaveJobMutationPOST /users/save-jobbody { jobId }Auth, User; cập nhật lạc quan getMehooks/use-job-favorite.ts
useUnsaveJobMutationDELETE /users/save-jobbody { jobId }Auth, User; cập nhật lạc quanhooks/use-job-favorite.ts
useGetSavedJobsQueryGET /users/saved-jobs?page=..&limit=..page, limitCung cấp Userprofile/pages/my-jobs-page.tsx
useFollowCompanyMutationPOST /users/follow-companybody { companyId }Auth, User; cập nhật lạc quanfeatures/company/hooks/use-company-follow.ts
useUnfollowCompanyMutationDELETE /users/follow-companybody { companyId }Auth, User; cập nhật lạc quanfeatures/company/hooks/use-company-follow.ts
useGetFollowingCompaniesQueryGET /users/following-companies?page=..&limit=..page, limitCung cấp UserChưa có nơi nào dùng

Bốn mutation lưu việc và theo dõi công ty sửa ngay bản getMe trong onQueryStarted và hoàn tác nếu request thất bại.

Đối chiếu với backend ​

Cả 14 route có trong users.controller.ts. Theo controller:

RouteAi được gọi
POST /users, GET /users, GET /users/:id, PATCH /users/:id, PATCH /users/:id/lock, PATCH /users/:id/unlock, DELETE /users/:id, DELETE /users/bulkChỉ SUPER ADMIN
save-job, saved-jobs, follow-company, following-companiesNgười dùng đã đăng nhập, không khai báo giới hạn vai trò
ĐiểmChi tiết
Hình dạng phân trang của việc đã lưuGET /users/saved-jobs trả meta: { current, pageSize, pages, total }, không phải meta.pagination như các danh sách khác; frontend khai báo đúng hình dạng này. Backend cắt trang trong bộ nhớ từ danh sách đã lấy
Công ty đang theo dõiGET /users/following-companies trả { result, total } và chỉ nhận mã người dùng, không nhận page, limit, dù frontend vẫn gửi hai tham số này (hook chưa được dùng)

NOTE

Trang personal-info của khu vực quản trị dùng PATCH /users/:id, route chỉ cho SUPER ADMIN. Chưa kiểm tra HR cập nhật thông tin cá nhân bằng đường nào; cần chạy thử.

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

Quy tắc form và dạng dữ liệu: Model User. Hợp nhất các tên việc đã lưu: xem cùng trang đó.

Source code liên quan ​

Hợp đồng đầy đủ: API Users của backend và controller.

Đọc tiếp: Model User, Cache và invalidation, Endpoint Auth.

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