Bỏ qua

Đặc tả Màn hình: Quản lý Vai trò & Quyền hạn (RBAC Management Screen)

Mã tài liệu: EZD-DES-SCR-ADM-009 Phiên bản: 1.0
User Story liên quan: us-adm-06 Ngày hiệu lực: 19/09/2025
Người soạn: John Người phê duyệt: Stephen

1. Mục tiêu của Màn hình

Cung cấp cho Super Admin công cụ để quản lý các vai trò (Role) và quyền hạn (Permission): tạo mới, chỉnh sửa, xóa. Đảm bảo hệ thống RBAC cơ bản, đủ để phân tách trách nhiệm giữa Super Admin và Tenant Admin.

2. Bố cục Tổng thể (Overall Layout)

  • Sidebar trái: Điều hướng (Dashboard, Promotions, FAQ, Branding, Avatar, RBAC).

  • Content chính:

  • Toolbar (tiêu đề + nút tạo mới).

  • Danh sách vai trò (bảng).
  • Modal form để tạo/sửa vai trò.

3. Phân rã các Thành phần (Component Breakdown)

Thành phần 1: Sidebar

  • Giữ nguyên layout từ Dashboard.
  • Menu item “RBAC” active.

Thành phần 2: Toolbar

  • Tiêu đề: “Quản lý Vai trò & Quyền hạn”.
  • Button chính: “+ Tạo vai trò mới” (primary).

Thành phần 3: Danh sách Vai trò (Role List Table)

  • Cột:

  • Tên vai trò (Role Name).

  • Số lượng người dùng đang gán role.
  • Danh sách quyền hạn (hiển thị dạng badge).
  • Action (Edit/Delete).
  • Empty state: Nếu chưa có role nào → hiển thị icon + text: “Chưa có vai trò nào. Hãy tạo mới để bắt đầu.”

Thành phần 4: Form Tạo/Sửa Vai trò (Modal)

  • Field:

  • Tên vai trò (bắt buộc).

  • Danh sách quyền hạn (multi-select checkbox từ list có sẵn: Quản lý Khuyến mãi, Quản lý FAQ, Quản lý Branding, Quản lý Avatar, Xem Dashboard).

  • Button:

  • Lưu (primary).

  • Hủy (secondary).
  • Validation: Không cho lưu khi thiếu tên hoặc không chọn quyền hạn.

Thành phần 5: Action Buttons

  • Edit: Mở modal với dữ liệu cũ để chỉnh sửa.
  • Delete: Dialog xác nhận: “Vai trò này đang được sử dụng, bạn cần gỡ gán trước khi xóa.”

Thành phần 6: Thông báo (Notifications)

  • Success: Toast xanh “Vai trò đã được lưu thành công / xóa thành công.”
  • Error: Toast đỏ “Không thể lưu / đồng bộ thất bại.”
  • Retry: Cho phép thử lại nếu lỗi.

4. Hành vi Chuyển tiếp (Transition Behavior)

  • Bấm Tạo mới → mở form modal.
  • Lưu thành công → modal đóng + danh sách cập nhật.
  • Xóa thành công → role biến mất khỏi bảng.
  • Nếu role còn được gán cho user → hệ thống chặn + hiển thị thông báo.

5. Triết lý Thiết kế (Design Philosophy)

  • Đơn giản – MVP-first: Chỉ quản lý role + permission list định nghĩa sẵn, không cho tenant tự tạo permission mới.
  • An toàn: Không cho phép xóa role còn gán user.
  • Nhất quán: Giữ nguyên layout từ Dashboard/Promotions/FAQ.
  • Resilience: Có empty state, error state rõ ràng.