Đặc tả Tính năng: Quản lý Tổ chức & Người dùng
1. Tổng quan & Tầm nhìn
Tính năng Quản lý Tổ chức & Người dùng là trung tâm điều khiển hành chính của nền tảng. Nó xử lý vòng đời của các tổ chức (thuê bao) và các thành viên, đảm bảo rằng mọi người dùng được ánh xạ chính xác vào danh tính doanh nghiệp và ngữ cảnh tổ chức của họ.
2. Các Vai trò & Bên liên quan
| Vai trò | Mục tiêu |
|---|---|
| Quản trị viên Tổ chức | Mời thành viên, quản lý hồ sơ và cấu hình cài đặt tổ chức. |
| Người dùng cuối | Hoàn tất onboarding và cập nhật hồ sơ cá nhân. |
| Quản trị viên Hệ thống | Phê duyệt các yêu cầu onboarding B2B và giám sát sức khỏe thuê bao. |
3. Câu chuyện Người dùng (User Stories)
- Với tư cách là quản trị viên, tôi muốn mời nhóm của mình qua email để họ có thể truy cập không gian làm việc của chúng tôi ngay lập tức.
- Với tư cách là quản trị viên, tôi muốn thay đổi logo và slug của công ty để phù hợp với việc tái định vị thương hiệu của chúng tôi.
4. Yêu cầu Chức năng (FR)
- REQ-MGMT-001: Quy trình Onboarding B2B cho các tổ chức mới.
- REQ-MGMT-002: Hệ thống mời thành viên dựa trên email (dự kiến v1.2).
- REQ-MGMT-003: Quản lý hồ sơ tổ chức (Logo, Tên, Slug).
- REQ-MGMT-004: Vòng đời trạng thái người dùng (
ACTIVE,INACTIVE,SUSPENDED).
5. Yêu cầu Phi chức năng (NFR)
- Cô lập: Bắt buộc có
organization_idtrên tất cả các bản ghi cụ thể của thuê bao. - Tính nhất quán: Tính nhất quán 100% giữa trạng thái Người dùng trong Shell và các module satellite.
6. Logic & Quy tắc Nghiệp vụ
- Slug duy nhất: Slug của tổ chức phải là duy nhất trên toàn cầu.
- Khóa tên miền: (Tùy chọn) Ngăn chặn người dùng có email không thuộc doanh nghiệp tham gia vào tổ chức.
- Hết hạn lời mời: Lời mời hết hạn sau 48 giờ vì lý do bảo mật.
7. Giao diện Người dùng (UI/UX)
- Bảng điều khiển "Cài đặt Tổ chức".
- Danh sách "Thành viên" với chức năng tìm kiếm, lọc và hành động hàng loạt.
- Modal "Mời người dùng" với lựa chọn vai trò.
8. Kiến trúc Thông tin
- Giao diện quản trị chính trong Shell.
- Chỉnh sửa hồ sơ người dùng được hiển thị trong menu trên thanh công cụ.
9. Mô hình Dữ liệu & Lưu trữ
- Các bảng:
organizations,users,onboarding_requests.
10. Lớp API & Dịch vụ
GET /api/usersPOST /api/users(tạo thành viên trực tiếp)PUT /api/organizations/:id
11. Các Mẫu Tích hợp
- Dịch vụ Mail: Tích hợp với SendGrid/AWS SES cho các email mời tham gia.
- Đồng bộ Satellite: Các thay đổi về trạng thái người dùng được phát sóng tới các module satellite qua các hook sự kiện.
12. Bảo mật & Quyền hạn
- Chỉ
Quản trị viên Tổ chứcmới có thể mời hoặc xóa thành viên. - Vai trò
Owner(Chủ sở hữu) là bắt buộc để xóa một tổ chức hoặc thay đổi slug của nó.
13. Xử lý Lỗi & Khả năng Phục hồi
- Xác thực cho các tên miền email không hợp lệ.
- Xử lý mượt mà trạng thái "Đã được mời".
14. Hiệu năng & Khả năng Mở rộng
- Danh sách người dùng được phân trang và có thể tìm kiếm.
- Siêu dữ liệu tổ chức được cache ở lớp API.
15. Toàn cầu hóa & Bản địa hóa
- Hỗ trợ đa ngôn ngữ cho các email mời tham gia.
16. Khả năng Tiếp cận (a11y)
- Các bảng người dùng và menu hành động thân thiện với trình đọc màn hình.
17. Khả năng Quan sát & Phân tích
- Theo dõi "Người dùng Hoạt động Hàng tháng" (MAU) trên mỗi tổ chức.
- Theo dõi chuyển đổi cho phễu onboarding B2B.
18. Kiểm thử & Chất lượng
- Kiểm thử tích hợp cho luồng chuyển đổi từ được mời sang hoạt động.
- Xác thực logic tính duy nhất của slug.
19. Các Ràng buộc & Giả định
- Giả định các tổ chức luôn có ít nhất một quản trị viên hợp lệ tại mọi thời điểm.
20. Các Cải tiến Tương lai
- Nhóm thành viên / Team (v2).
- Tích hợp SCIM để tự động cấp phát người dùng.