> ## Documentation Index
> Fetch the complete documentation index at: https://docs.econtractid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vai trò

> Quản lý vai trò và phân quyền trong hệ thống econtractid

# Quản lý Vai trò

Chức năng **Vai trò** cho phép quản trị viên định nghĩa nhóm quyền hạn và gán cho người dùng. Phân quyền theo vai trò giúp kiểm soát chặt chẽ quyền truy cập vào từng tính năng.

<CardGroup cols={3}>
  <Card title="Tạo vai trò" icon="plus" color="#16A34A">
    Định nghĩa vai trò mới với các quyền tùy chỉnh
  </Card>

  <Card title="Phân quyền" icon="key" color="#7C3AED">
    Cấu hình chi tiết quyền theo từng module
  </Card>

  <Card title="Quản lý vai trò" icon="pen-to-square" color="#2563EB">
    Chỉnh sửa hoặc xóa các vai trò đã tạo
  </Card>
</CardGroup>

## Danh sách Vai trò

Màn hình danh sách hiển thị tất cả các vai trò đã được tạo trong hệ thống, bao gồm các cột:

<img src="https://mintcdn.com/vtsdc/1bKa7R32rj0XB74C/images/vai-tro/man-vai-tro.png?fit=max&auto=format&n=1bKa7R32rj0XB74C&q=85&s=6d3aa85943195cca02a557599d94bf69" alt="Màn hình danh sách Vai trò" width="1920" height="964" data-path="images/vai-tro/man-vai-tro.png" />

| Cột               | Mô tả                                             |
| ----------------- | ------------------------------------------------- |
| **Hành động**     | Biểu tượng ✏️ chỉnh sửa và 🗑️ xóa vai trò        |
| **Tên vai trò**   | Tên định danh của vai trò (VD: GIAMDOC, QLNHANSU) |
| **Người tạo**     | Tài khoản đã tạo vai trò                          |
| **Ngày cập nhật** | Thời điểm cập nhật gần nhất                       |

Góc trên bên phải có nút **+ Tạo vai trò** để thêm mới và nút 🔄 để làm mới danh sách.

## Tạo mới Vai trò

<img src="https://mintcdn.com/vtsdc/1bKa7R32rj0XB74C/images/vai-tro/tao-vai-tro.png?fit=max&auto=format&n=1bKa7R32rj0XB74C&q=85&s=c942cc2e4753106351a6e663ff594795" alt="Form tạo mới Vai trò" width="1920" height="967" data-path="images/vai-tro/tao-vai-tro.png" />

<Steps>
  <Step title="Mở form tạo mới">
    Nhấn nút **+ Tạo vai trò** ở góc trên bên phải màn hình danh sách.
  </Step>

  <Step title="Nhập thông tin cơ bản">
    Điền các thông tin sau vào form:

    | Trường               | Mô tả                                     |
    | -------------------- | ----------------------------------------- |
    | **Vai trò cấp trên** | Chọn vai trò cha từ danh sách (nếu có)    |
    | **Tên vai trò**      | Nhập tên vai trò *(bắt buộc)*             |
    | **Mô tả**            | Mô tả phạm vi, chức năng của vai trò      |
    | **Parent Code**      | Mã nhóm quyền cha để phân nhóm phân quyền |
  </Step>

  <Step title="Cấu hình phân quyền">
    Trong bảng phân quyền, tích chọn các quyền phù hợp cho từng tính năng. Mỗi tính năng có 2 loại quyền:

    | Cột quyền           | Ý nghĩa                                                 |
    | ------------------- | ------------------------------------------------------- |
    | **Có quyền**        | Cho phép thực hiện tính năng này                        |
    | **Quyền chi nhánh** | Quyền áp dụng riêng cho đơn vị/chi nhánh của người dùng |

    Danh sách tính năng được chia thành 2 nhóm:

    **Nhóm chính (Parent Code):**

    | Tính năng       | Mô tả                              |
    | --------------- | ---------------------------------- |
    | Biểu đồ         | Xem biểu đồ thống kê, dashboard    |
    | Xử lý công việc | Xử lý các công việc, nhiệm vụ      |
    | Hồ sơ           | Quản lý hồ sơ, hợp đồng            |
    | Số hoá          | Chức năng số hoá tài liệu          |
    | Files           | Quản lý tệp đính kèm               |
    | Quản trị        | Truy cập khu vực quản trị hệ thống |
    | Báo cáo         | Xem và xuất báo cáo                |

    **Nhóm cài đặt (Parent Code: preferences):**

    | Tính năng | Mô tả                         |
    | --------- | ----------------------------- |
    | Tài khoản | Quản lý tài khoản người dùng  |
    | Đơn vị    | Quản lý đơn vị, tổ chức       |
    | Vai trò   | Quản lý vai trò, phân quyền   |
    | Đối tác   | Quản lý thông tin đối tác     |
    | Quy trình | Quản lý quy trình nghiệp vụ   |
    | Hệ thống  | Cài đặt hệ thống              |
    | Admin     | Quyền quản trị cao nhất       |
    | Lịch sử   | Xem lịch sử thao tác hệ thống |
  </Step>

  <Step title="Lưu vai trò">
    Nhấn **Lưu & đóng** để lưu và quay lại danh sách, hoặc **Đóng** để hủy.
  </Step>
</Steps>

<Note>
  Tích chọn **Quyền chi nhánh** để giới hạn phạm vi quyền chỉ trong đơn vị/chi nhánh của người dùng, thay vì toàn bộ hệ thống.
</Note>

## Chỉnh sửa Vai trò

<Steps>
  <Step title="Chọn vai trò cần sửa">
    Trong danh sách, nhấn biểu tượng ✏️ tại dòng vai trò muốn chỉnh sửa.
  </Step>

  <Step title="Cập nhật thông tin">
    Thay đổi tên, mô tả hoặc cấu hình lại các quyền trong bảng phân quyền.
  </Step>

  <Step title="Lưu thay đổi">
    Nhấn **Lưu & đóng**. Thay đổi được áp dụng ngay với tất cả người dùng thuộc vai trò này.
  </Step>
</Steps>

## Xóa Vai trò

<Warning>
  Chỉ xóa được vai trò khi **không còn người dùng nào** được gán. Hãy chuyển vai trò cho người dùng trước khi xóa.
</Warning>

1. Trong danh sách, nhấn biểu tượng 🗑️ tại dòng vai trò cần xóa.
2. Xác nhận trong hộp thoại xác nhận.