基本功能完成，下一步开始美化UI

openspec/changes/user-group-management/proposal.md

@@ -0,0 +1,38 @@
+# Change: User Group Management System
+
+## Status
+**Pending Testing** (Note: Add User Group functionality is not yet tested)
+
+## Why
+To manage users more efficiently by grouping them and assigning exam tasks to groups.
+
+## What Changes
+1.  **User Group Management**:
+    *   Add "User Group" management module in User Management interface.
+    *   Support CRUD for user groups.
+    *   System built-in "All Users" group.
+2.  **User-Group Association**:
+    *   Show user groups in user details.
+    *   Support multi-select for user groups.
+    *   Audit log for group changes.
+3.  **Exam Task Assignment**:
+    *   Support assigning tasks by individual users and user groups.
+    *   Handle duplicate selections (user in selected group).
+    *   Show unique user count.
+4.  **Permissions**:
+    *   Admin only for managing groups.
+5.  **Data Consistency**:
+    *   Cascade delete for groups and users.
+    *   Protect "All Users" group.
+
+## Impact
+- Affected specs: user-group
+- Affected code:
+    - api/database/index.ts
+    - api/models/userGroup.ts
+    - api/controllers/userGroupController.ts
+    - api/controllers/userController.ts
+    - api/controllers/examTaskController.ts
+    - src/pages/admin/UserManagePage.tsx
+    - src/pages/admin/UserGroupManage.tsx
+    - src/pages/admin/ExamTaskPage.tsx

openspec/changes/user-group-management/specs/user-group/spec.md

@@ -0,0 +1,44 @@
+# Spec: User Group Management
+
+## 1. User Group Management Functionality
+- **Module**: New "User Group" management module in User Management interface.
+- **CRUD**: Support Create, Read, Update, Delete for user groups.
+- **Group Info**: Group Name, Description, Created Time.
+- **"All Users" Special Group**:
+    - All users automatically belong to this group.
+    - Users cannot voluntarily exit this group.
+    - New users automatically join this group.
+    - This group cannot be deleted.
+
+## 2. User-Group Association Management
+- **Display**: User details page shows the list of user groups.
+- **Assignment**: Support multi-select to set user groups.
+- **Multi-group**: Single user can belong to multiple groups.
+- **Audit**: Log user group changes (Audit log).
+
+## 3. Exam Task Assignment Functionality
+- **Assignment Methods**:
+    - Select by Individual User.
+    - Select by User Group.
+- **Hybrid Selection**: Support selecting both specific users and user groups simultaneously.
+- **Deduplication**:
+    - System automatically removes duplicates when a user is selected directly and also belongs to a selected group.
+    - Keep only one instance in the task assignment result.
+    - Record original selection in assignment log.
+
+## 4. Permissions & Verification
+- **Admin**: Adding/Modifying user groups requires administrator permissions.
+- **Scope**: Users can only view groups they have permission to manage.
+- **Verification**: Both Frontend and Backend must verify user group operation permissions.
+
+## 5. Data Consistency Assurance
+- **Delete Group**: Automatically remove all user associations when a group is deleted.
+- **Delete User**: Automatically remove from all user groups when a user is deleted.
+- **Protection**: Built-in "All Users" group cannot be modified or deleted.
+
+## 6. Interface Design Requirements
+- **Component**: Use multi-select component for user group selection.
+- **Identification**: Clearly identify the "All Users" special group.
+- **Count Display**: Clearly display the final actual assigned user count (after deduplication) in the Exam Task Assignment interface.
+
+**Note**: The "Add User Group" functionality has been implemented but is currently **untested**.