feat(admin): Add user management and upgrade to module permission system

Features - User Management (Phase 4.1): - Database: Add user_modules table for fine-grained module permissions - Database: Add 4 user permissions (view/create/edit/delete) to role_permissions - Backend: UserService (780 lines) - CRUD with tenant isolation - Backend: UserController + UserRoutes (648 lines) - 13 API endpoints - Backend: Batch import users from Excel - Frontend: UserListPage (412 lines) - list/filter/search/pagination - Frontend: UserFormPage (341 lines) - create/edit with module config - Frontend: UserDetailPage (393 lines) - details/tenant/module management - Frontend: 3 modal components (592 lines) - import/assign/configure - API: GET/POST/PUT/DELETE /api/admin/users/* endpoints Architecture Upgrade - Module Permission System: - Backend: Add getUserModules() method in auth.service - Backend: Login API returns modules array in user object - Frontend: AuthContext adds hasModule() method - Frontend: Navigation filters modules based on user.modules - Frontend: RouteGuard checks requiredModule instead of requiredVersion - Frontend: Remove deprecated version-based permission system - UX: Only show accessible modules in navigation (clean UI) - UX: Smart redirect after login (avoid 403 for regular users) Fixes: - Fix UTF-8 encoding corruption in ~100 docs files - Fix pageSize type conversion in userService (String to Number) - Fix authUser undefined error in TopNavigation - Fix login redirect logic with role-based access check - Update Git commit guidelines v1.2 with UTF-8 safety rules Database Changes: - CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled) - ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code) - INSERT 4 permissions + role assignments - UPDATE PUBLIC tenant with 8 module subscriptions Technical: - Backend: 5 new files (~2400 lines) - Frontend: 10 new files (~2500 lines) - Docs: 1 development record + 2 status updates + 1 guideline update - Total: ~4900 lines of code Status: User management 100% complete, module permission system operational
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions
--- a/docs/03-业务模块/AIA-AI智能问答/04-开发计划/03-前端组件设计.md
+++ b/docs/03-业务模块/AIA-AI智能问答/04-开发计划/03-前端组件设计.md
@@ -1,7 +1,7 @@
 # AIA V2.1 前端组件设计

 > **版本**：V2.1  
-> **åˆ›å»ºæ—¥æœŸ**ï¼?026-01-11  
+> **创建日期**：2026-01-11  
 > **技术栈**：React 19 + TypeScript 5 + Ant Design 6 + Ant Design X 2.1

 ---
@@ -11,45 +11,45 @@
 ```
 frontend-v2/src/modules/aia/
 ├── pages/
-â”?  â”œâ”€â”€ Dashboard.tsx              # æ™ºèƒ½ä½“å¤§åŽ…ï¼ˆé¦–é¡µï¼?
-â”?  â””â”€â”€ Workspace.tsx              # å¯¹è¯<EFBFBD>å·¥ä½œå<EFBFBD>?
+│   ├── Dashboard.tsx              # 智能体大厅（首页）
+│   └── Workspace.tsx              # 对话工作台
 ├── components/
-â”?  â”œâ”€â”€ AgentPipeline/
-â”?  â”?  â”œâ”€â”€ index.tsx              # 5é˜¶æ®µæµ<EFBFBD>æ°´çº¿å®¹å™?
-â”?  â”?  â”œâ”€â”€ StageColumn.tsx        # å<EFBFBD>•é˜¶æ®µåˆ—
-â”?  â”?  â””â”€â”€ AgentCard.tsx          # æ™ºèƒ½ä½“å<EFBFBD>¡ç‰?
-â”?  â”œâ”€â”€ IntentSearch/
-â”?  â”?  â”œâ”€â”€ index.tsx              # æ„<EFBFBD>å›¾æ<EFBFBD>œç´¢æ¡?
-â”?  â”?  â””â”€â”€ SuggestionDropdown.tsx # å»ºè®®ä¸‹æ‹‰æ¡?
-â”?  â”œâ”€â”€ ConversationList/
-â”?  â”?  â”œâ”€â”€ index.tsx              # åŽ†å<EFBFBD>²ä¼šè¯<EFBFBD>åˆ—è¡¨
-â”?  â”?  â””â”€â”€ ConversationItem.tsx   # ä¼šè¯<EFBFBD>é¡?
-â”?  â”œâ”€â”€ MessageList/
-â”?  â”?  â”œâ”€â”€ index.tsx              # æ¶ˆæ<EFBFBD>¯åˆ—è¡¨
-â”?  â”?  â”œâ”€â”€ UserMessage.tsx        # ç”¨æˆ·æ¶ˆæ<EFBFBD>¯
-â”?  â”?  â”œâ”€â”€ AssistantMessage.tsx   # AIå›žå¤<EFBFBD>
-â”?  â”?  â””â”€â”€ ThinkingBlock.tsx      # æ·±åº¦æ€<EFBFBD>è€ƒæŠ˜å<EFBFBD> å<EFBFBD>—
-â”?  â”œâ”€â”€ Attachment/
-â”?  â”?  â”œâ”€â”€ AttachmentUpload.tsx   # é™„ä»¶ä¸Šä¼ 
-â”?  â”?  â”œâ”€â”€ AttachmentCard.tsx     # é™„ä»¶å<EFBFBD>¡ç‰‡
-â”?  â”?  â””â”€â”€ AttachmentPreview.tsx  # é™„ä»¶é¢„è§ˆ
-â”?  â”œâ”€â”€ SlashCommands/
-â”?  â”?  â””â”€â”€ index.tsx              # å¿«æ<EFBFBD>·æŒ‡ä»¤è<EFBFBD>œå<EFBFBD>•
-â”?  â””â”€â”€ ActionBar/
-â”?      â””â”€â”€ index.tsx              # ç»“æžœæ“<EFBFBD>ä½œæ ?
+│   ├── AgentPipeline/
+│   │   ├── index.tsx              # 5阶段流水线容器
+│   │   ├── StageColumn.tsx        # 单阶段列
+│   │   └── AgentCard.tsx          # 智能体卡片
+│   ├── IntentSearch/
+│   │   ├── index.tsx              # 意图搜索框
+│   │   └── SuggestionDropdown.tsx # 建议下拉框
+│   ├── ConversationList/
+│   │   ├── index.tsx              # 历史会话列表
+│   │   └── ConversationItem.tsx   # 会话项
+│   ├── MessageList/
+│   │   ├── index.tsx              # 消息列表
+│   │   ├── UserMessage.tsx        # 用户消息
+│   │   ├── AssistantMessage.tsx   # AI回复
+│   │   └── ThinkingBlock.tsx      # 深度思考折叠块
+│   ├── Attachment/
+│   │   ├── AttachmentUpload.tsx   # 附件上传
+│   │   ├── AttachmentCard.tsx     # 附件卡片
+│   │   └── AttachmentPreview.tsx  # 附件预览
+│   ├── SlashCommands/
+│   │   └── index.tsx              # 快捷指令菜单
+│   └── ActionBar/
+│       └── index.tsx              # 结果操作栏
 ├── hooks/
-â”?  â”œâ”€â”€ useConversation.ts         # å¯¹è¯<EFBFBD>ç®¡ç<EFBFBD>†
-â”?  â”œâ”€â”€ useAgents.ts               # æ™ºèƒ½ä½“æ•°æ<EFBFBD>?
-â”?  â”œâ”€â”€ useIntentRouter.ts         # æ„<EFBFBD>å›¾è·¯ç”±
-â”?  â”œâ”€â”€ useStreamMessage.ts        # æµ<EFBFBD>å¼<EFBFBD>æ¶ˆæ<EFBFBD>¯
-â”?  â””â”€â”€ useAttachment.ts           # é™„ä»¶ä¸Šä¼ 
+│   ├── useConversation.ts         # 对话管理
+│   ├── useAgents.ts               # 智能体数据
+│   ├── useIntentRouter.ts         # 意图路由
+│   ├── useStreamMessage.ts        # 流式消息
+│   └── useAttachment.ts           # 附件上传
 ├── api/
-â”?  â””â”€â”€ index.ts                   # API å°<EFBFBD>è£…
+│   └── index.ts                   # API 封装
 ├── types/
-â”?  â””â”€â”€ index.ts                   # TypeScript ç±»åž‹
+│   └── index.ts                   # TypeScript 类型
 ├── styles/
-â”?  â”œâ”€â”€ dashboard.module.css       # Dashboard æ ·å¼<EFBFBD>
-â”?  â””â”€â”€ workspace.module.css       # Workspace æ ·å¼<EFBFBD>
+│   ├── dashboard.module.css       # Dashboard 样式
+│   └── workspace.module.css       # Workspace 样式
 └── index.tsx                      # 模块入口 + 路由
 ```

@@ -68,7 +68,7 @@ frontend-v2/src/modules/aia/
  --stage-write: #F59E0B;      /* 橙色 - 论文撰写 */
  --stage-publish: #EF4444;    /* 红色 - 成果发布 */
  
-  /* åŠŸèƒ½è‰?*/
+  /* 功能色 */
  --ai-assistant: #6366F1;     /* AI助手主色 */
  --thinking-bg: #F3F4F6;      /* 思考块背景 */
  --thinking-border: #E5E7EB;  /* 思考块边框 */
@@ -108,7 +108,7 @@ frontend-v2/src/modules/aia/

 ## 📄 页面设计

-### 1. Dashboardï¼ˆæ™ºèƒ½ä½“å¤§åŽ…ï¼?
+### 1. Dashboard（智能体大厅）

 ```tsx
 // pages/Dashboard.tsx
@@ -119,7 +119,7 @@ import { AgentPipeline } from '../components/AgentPipeline';
 export const Dashboard: React.FC = () => {
  return (
    <div className={styles.dashboard}>
-      {/* é¡¶éƒ¨æ„<EFBFBD>å›¾æ<EFBFBD>œç´¢æ¡?*/}
+      {/* 顶部意图搜索框 */}
      <header className={styles.header}>
        <h1>AI 智能助手</h1>
        <p>有什么可以帮助您的？</p>
@@ -135,14 +135,14 @@ export const Dashboard: React.FC = () => {
 };
 ```

-**å¸ƒå±€ç‰¹ç‚¹**ï¼?
+**布局特点**：
 - 顶部居中大搜索框
- 5é˜¶æ®µæµ<EFBFBD>æ°´çº¿æ¨ªå<EFBFBD>‘å¹³é“ºï¼ˆæ¡Œé<EFBFBD>¢ï¼? çºµå<C2B5>‘æ»šåŠ¨ï¼ˆç§»åŠ¨ï¼‰
- Gemini é£Žæ ¼å¤§ç•™ç™?
+- 5阶段流水线横向平铺（桌面）/ 纵向滚动（移动）
+- Gemini 风格大留白

 ---

-### 2. Workspaceï¼ˆå¯¹è¯<EFBFBD>å·¥ä½œå<EFBFBD>°ï¼?
+### 2. Workspace（对话工作台）

 ```tsx
 // pages/Workspace.tsx
@@ -201,7 +201,7 @@ export const Workspace: React.FC = () => {

 ## 🧩 组件详细设计

-### 1. AgentPipelineï¼?é˜¶æ®µæµ<C3A6>æ°´çº¿ï¼‰
+### 1. AgentPipeline（5阶段流水线）

 ```tsx
 // components/AgentPipeline/index.tsx
@@ -238,7 +238,7 @@ export const AgentPipeline: React.FC<AgentPipelineProps> = ({ onAgentClick }) =>
 };
 ```

-**æ ·å¼<EFBFBD>ç‰¹ç‚¹**ï¼?
+**样式特点**：
 ```css
 .pipeline {
  display: flex;
@@ -258,7 +258,7 @@ export const AgentPipeline: React.FC<AgentPipelineProps> = ({ onAgentClick }) =>

 ---

-### 2. IntentSearchï¼ˆæ„<EFBFBD>å›¾æ<EFBFBD>œç´¢æ¡†ï¼?
+### 2. IntentSearch（意图搜索框）

 ```tsx
 // components/IntentSearch/index.tsx
@@ -307,14 +307,14 @@ export const IntentSearch: React.FC = () => {

 ---

-### 3. ThinkingBlockï¼ˆæ·±åº¦æ€<EFBFBD>è€ƒæŠ˜å<EFBFBD> å<EFBFBD>—ï¼?
+### 3. ThinkingBlock（深度思考折叠块）

 ```tsx
 // components/MessageList/ThinkingBlock.tsx

 interface ThinkingBlockProps {
  content: string;
-  duration?: number;  // æ€<EFBFBD>è€ƒè€—æ—¶ï¼ˆç§’ï¼?
+  duration?: number;  // 思考耗时（秒）
  isStreaming?: boolean;  // 是否正在生成
 }

@@ -328,7 +328,7 @@ export const ThinkingBlock: React.FC<ThinkingBlockProps> = ({
  
  useEffect(() => {
    if (!isStreaming && expanded) {
-      // å®Œæˆ<EFBFBD>å<EFBFBD>?1.5s è‡ªåŠ¨æ”¶èµ·
+      // 完成后 1.5s 自动收起
      const timer = setTimeout(() => setExpanded(false), 1500);
      return () => clearTimeout(timer);
    }
@@ -344,7 +344,7 @@ export const ThinkingBlock: React.FC<ThinkingBlockProps> = ({
          {isStreaming ? <LoadingOutlined spin /> : <BulbOutlined />}
        </span>
        <span className={styles.title}>
-          {isStreaming ? 'æ£åœ¨æ·±åº¦æ€<EFBFBD>è€?..' : `å·²æ·±åº¦æ€<EFBFBD>è€?(è€—æ—¶ ${duration?.toFixed(1)}s)`}
+          {isStreaming ? '正在深度思考...' : `已深度思考 (耗时 ${duration?.toFixed(1)}s)`}
        </span>
        <span className={styles.expandIcon}>
          {expanded ? <UpOutlined /> : <DownOutlined />}
@@ -363,7 +363,7 @@ export const ThinkingBlock: React.FC<ThinkingBlockProps> = ({
 };
 ```

-**æ ·å¼<EFBFBD>**ï¼?
+**样式**：
 ```css
 .thinkingBlock {
  background: var(--thinking-bg);
@@ -412,18 +412,18 @@ export const AttachmentUpload: React.FC<AttachmentUploadProps> = ({
  
  const handleUpload = async (file: File) => {
    if (attachments.length >= maxCount) {
-      message.error(`æœ€å¤šä¸Šä¼?${maxCount} ä¸ªé™„ä»¶`);
+      message.error(`最多上传 ${maxCount} 个附件`);
      return false;
    }
    
    // 文件类型校验
    const allowedTypes = ['application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'text/plain', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'];
    if (!allowedTypes.includes(file.type)) {
-      message.error('ä»…æ”¯æŒ?PDFã€<C3A3>Wordã€<C3A3>TXTã€<C3A3>Excel æ–‡ä»¶');
+      message.error('仅支持 PDF、Word、TXT、Excel 文件');
      return false;
    }
    
-    // æ–‡ä»¶å¤§å°<EFBFBD>æ ¡éªŒï¼?0MBï¼?
+    // 文件大小校验（20MB）
    if (file.size > 20 * 1024 * 1024) {
      message.error('文件大小不能超过 20MB');
      return false;
@@ -448,7 +448,7 @@ export const AttachmentUpload: React.FC<AttachmentUploadProps> = ({
        </Button>
      </Upload>
      
-      {/* å·²ä¸Šä¼ é™„ä»¶åˆ—è¡?*/}
+      {/* 已上传附件列表 */}
      <div className={styles.attachmentList}>
        {attachments.map(att => (
          <AttachmentCard
@@ -483,10 +483,10 @@ interface SlashCommandsProps {
 }

 const commands: SlashCommand[] = [
-  { key: 'polish', icon: 'âœ?, label: 'æ¶¦è‰²', description: 'ä¼˜åŒ–æ–‡æœ¬è¡¨è¾¾' },
+  { key: 'polish', icon: '✨', label: '润色', description: '优化文本表达' },
  { key: 'expand', icon: '📝', label: '扩写', description: '扩展内容细节' },
  { key: 'translate', icon: '🌐', label: '翻译', description: '中英互译' },
-  { key: 'export', icon: 'ðŸ“„', label: 'å¯¼å‡ºWord', description: 'å¯¼å‡ºä¸?Word æ–‡æ¡£' },
+  { key: 'export', icon: '📄', label: '导出Word', description: '导出为 Word 文档' },
 ];

 export const SlashCommands: React.FC<SlashCommandsProps> = ({
@@ -544,7 +544,7 @@ export const SlashCommands: React.FC<SlashCommandsProps> = ({

 ---

-### 6. ActionBarï¼ˆç»“æžœæ“<EFBFBD>ä½œæ <EFBFBD>ï¼?
+### 6. ActionBar（结果操作栏）

 ```tsx
 // components/ActionBar/index.tsx
@@ -623,7 +623,7 @@ export function useConversation(conversationId?: string): UseConversationReturn
    }
  }, [conversationId]);
  
-  // å<EFBFBD>‘é€<EFBFBD>æ¶ˆæ<EFBFBD>¯ï¼ˆæµ<EFBFBD>å¼<EFBFBD>ï¼?
+  // 发送消息（流式）
  const sendMessage = async (content: string, attachmentIds?: string[]) => {
    setIsLoading(true);
    
@@ -637,7 +637,7 @@ export function useConversation(conversationId?: string): UseConversationReturn
    };
    setMessages(prev => [...prev, userMessage]);
    
-    // åˆ<EFBFBD>å§‹åŒ?AI æ¶ˆæ<CB86>¯
+    // 初始化 AI 消息
    const aiMessage: Message = {
      id: `temp-ai-${Date.now()}`,
      role: 'assistant',
@@ -769,7 +769,7 @@ export function useStreamMessage() {

 ---

-## ðŸ“± å“<C3A5>åº”å¼<C3A5>è®¾è®?
+## 📱 响应式设计

 ### 断点策略

@@ -783,19 +783,19 @@ const breakpoints = {
 };
 ```

-### Dashboard å“<EFBFBD>åº”å¼?
+### Dashboard 响应式

 | 断点 | 布局 |
 |------|------|
 | `< 768px` | 流水线纵向滚动，卡片单列 |
-| `â‰?768px` | æµ<EFBFBD>æ°´çº¿æ¨ªå<EFBFBD>?5 åˆ?|
+| `≥ 768px` | 流水线横向 5 列 |

-### Workspace å“<EFBFBD>åº”å¼?
+### Workspace 响应式

 | 断点 | 布局 |
 |------|------|
 | `< 768px` | 侧边栏隐藏（抽屉滑出），输入框键盘适配 |
-| `â‰?768px` | ä¾§è¾¹æ <EFBFBD>å›ºå®šæ˜¾ç¤?240px |
+| `≥ 768px` | 侧边栏固定显示 240px |

 ---

@@ -883,4 +883,3 @@ export interface SlashCommand {



-