checkpro.vn
Bắt đầu nhanhTài liệu chi tiết

Đăng ký Vai trò

Menu: Đăng ký
Route: /roles/register
Quyền yêu cầu: Hiển thị khi user có role UNROLE (chưa thuộc tổ chức nào)
Phiên bản: v1.0 — 2026-05-08

1. Giới thiệu

Trang Đăng ký Vai trò cho phép người dùng mới đăng ký vai trò trên hệ thống CheckProVN. Đây là bước đầu tiên để bắt đầu sử dụng hệ thống khi tài khoản chưa thuộc tổ chức nào.

[!NOTE]
Trang này chỉ hiển thị trên thanh bên khi tài khoản có role UNROLE. Sau khi đăng ký thành công, hệ thống tự chuyển hướng đến Tổng quan và trang này sẽ không còn hiển thị.

2. Điều kiện truy cập

Điều kiện Chi tiết
Quyền Không yêu cầu permission cụ thể
Vai trò Chỉ hiển thị cho user có role UNROLE
Chuyển hướng tự động Nếu đã có role hoặc permission → tự redirect về /dashboard

3. Giao diện

Trang gồm 1 biểu mẫu đơn giản chia làm 2 cột:

Khu vực Vị trí Mô tả
Breadcrumb Trên cùng Tài khoản → Đăng ký vai trò
Card biểu mẫu Trung tâm Biểu mẫu chọn vai trò và nhập thông tin

3.1 Cột trái — Chọn vai trò

Sử dụng radio button để chọn 1 trong 3 vai trò:

Vai trò Mã Mô tả
Nhà sản xuất manufacturer Đơn vị sản xuất hàng hóa, cần truy xuất nguồn gốc
Đơn vị vận chuyển shipper Đơn vị vận chuyển, logistics
Đơn vị kiểm soát hàng hóa controller Đơn vị giám sát, kiểm tra chất lượng

3.2 Cột phải — Thông tin đăng ký

Trường Bắt buộc Mô tả
Tên ✅ Có Tên hiển thị của đơn vị / nhóm
Mô tả ✅ Có Mô tả ngắn về vai trò / đơn vị (textarea, 4 dòng)

3.3 Nút hành động

Nút Chức năng
Gửi yêu cầu Gửi biểu mẫu đăng ký (chỉ khả dụng khi đã điền đầy đủ)
Xóa biểu mẫu Đặt lại tất cả các trường về rỗng

4. Hướng dẫn thao tác

4.1 Đăng ký vai trò mới

  1. Truy cập trang Đăng ký trên thanh bên (hoặc hệ thống tự chuyển hướng)
  2. Chọn vai trò phù hợp bằng cách nhấn radio button:
    • ○ Nhà sản xuất
    • ○ Đơn vị vận chuyển
    • ○ Đơn vị kiểm soát hàng hóa
  3. Nhập Tên tổ chức / đơn vị (bắt buộc)
  4. Nhập Mô tả về vai trò / đơn vị (bắt buộc)
  5. Nhấn nút "Gửi yêu cầu"
  6. Nếu thành công:
    • Hiển thị thông báo xanh: "Đăng ký thành công nhà sản xuất!"
    • Hệ thống tự động cập nhật quyền
    • Tự chuyển hướng đến Tổng quan
    • thanh bên sẽ hiển thị menu đầy đủ

[!IMPORTANT]
Hiện tại, hệ thống chỉ hỗ trợ đăng ký vai trò Nhà sản xuất (manufacturer). Các vai trò Shipper và Controller sẽ được hỗ trợ trong phiên bản tới.

4.2 Xóa biểu mẫu

  1. Nhấn nút "Xóa biểu mẫu"
  2. Tất cả các trường (vai trò, tên, mô tả) sẽ được đặt lại về rỗng

5. Lưu ý quan trọng

[!WARNING]

  • Nút "Gửi yêu cầu" chỉ khả dụng khi:
    • ✅ Đã chọn vai trò
    • ✅ Đã nhập Tên (không rỗng)
    • ✅ Đã nhập Mô tả (không rỗng)
    • ✅ Không đang trong quá trình gửi
  • Nếu thiếu bất kỳ trường nào, hệ thống hiển thị cảnh báo đỏ bên dưới trường tương ứng

[!NOTE]

  • Sau khi đăng ký thành công, hệ thống sẽ tự động hydrate lại permissions từ server
  • Bước tiếp theo sau đăng ký vai trò là hoàn thiện Hồ sơ doanh nghiệp — xem guide 22_Business_Profile.md

6. Luồng xử lý tổng quan

User đăng nhập (UNROLE)
    ↓
Thanh bên hiển thị mục "Đăng ký"
    ↓
User chọn vai trò + điền thông tin
    ↓
Nhấn "Gửi yêu cầu"
    ↓
API: POST /GroupInfo/RegisProducer
    ↓
Thành công → Hydrate permissions → Redirect /dashboard
    ↓
User tiếp tục Onboarding (Hồ sơ doanh nghiệp)

7. Câu hỏi thường gặp (FAQ)

Câu hỏi Trả lời
Tôi không thấy mục "Đăng ký" trên thanh bên? Bạn đã có vai trò hoặc đã thuộc tổ chức. Mục này chỉ hiện khi role = UNROLE.
Gửi yêu cầu bị lỗi? Kiểm tra kết nối mạng. Nếu lỗi vẫn tiếp tục, liên hệ hỗ trợ kỹ thuật.
Tôi muốn đăng ký vai trò Shipper nhưng không được? Hiện tại chỉ hỗ trợ vai trò "Nhà sản xuất". Các vai trò khác sẽ được mở trong phiên bản tới.
Sau khi đăng ký xong, tôi cần làm gì tiếp? Hệ thống sẽ đưa bạn đến Tổng quan, từ đó truy cập Hồ sơ doanh nghiệp để hoàn thiện thông tin tổ chức.

Cập nhật lần cuối: 2026-05-08