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
This commit is contained in:
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions

View File

@@ -1,48 +1,48 @@
# 平台前端总体架构设计
> **<EFBFBD>。」迚域悽<EFBFBD>?* v1.0
> **蛻帛サコ譌・譛滂シ?* 2025-10-29
> **扈エ謚、閠<EFBFBD><EFBFBD>** 蜑咲ォッ蠑€蜿大屬髦?
> **文档版本:** v1.0
> **创建日期:** 2025-10-29
> **维护者:** 前端开发团队
> **最后更新:** 2025-10-29
---
## 📋 文档说明
譛ャ譁<EFBFBD>。」譏ッ**蟷ウ蜿ー郤ァ蜑咲ォッ譫カ譫<EFBDB6>ョセ隶?*<2A>梧カオ逶匁紛荳ェAI遘醍<E98198>泌ケウ蜿ー逧<EFBDB0>燕遶ッ譫カ譫<EFBDB6>シ悟桁諡ャ<E8ABA1>?
- 扈滉ク€<EFBFBD>。カ驛ィ蟇シ闊ェ隶セ隶?
- 讓。蝮怜喧譫カ譫<EFBFBD>ョセ隶?
本文档是**平台级前端架构设计**涵盖整个AI科研平台的前端架构包括
- 统一的顶部导航设计
- 模块化架构设计
- 路由设计
- <EFBFBD>剞謗ァ蛻カ邉サ扈滂シ?*迚域悽驟咲スョ螳悟<E89EB3>蜿ッ隹<EFBDAF><E99AB9>?*<2A>?
- 讓。蝮礼峡遶区€ァ隶セ隶。<EFBFBD>域髪謖∵悴譚・迢ャ遶句<EFBFBD><EFBFBD>シ?
- 权限控制系统(**版本配置完全可调整**
- 模块独立性设计(支持未来独立分拆)
> **豕ィ諢擾シ?* 譛ャ譁<EFBDAC>。」譏ッ蟷ウ蜿ー郤ァ隶セ隶。<E99AB6>悟推讓。蝮礼噪隸ヲ扈<EFBDA6>楔譫<E6A594>ョセ隶。隸キ蜿り€<E3828A>推讓。蝮礼噪荳灘ア樊枚譯」縲?
> **注意:** 本文档是平台级设计,各模块的详细架构设计请参考各模块的专属文档。
> **驥崎ヲ∵署遉コ<EFBFBD>?* 譛ャ譁<EFBDAC>。」荳ュ豸牙所逧<E68980>沿譛ャ譚<EFBDAC>剞蛻<E5899E><E89BBB><EFBFBD>亥渕遑€迚医€<E58CBB>ォ倡コァ迚医€∵覧闊ー迚育噪讓。蝮怜<E89DAE>驟搾シ牙插荳コ**蛻晏ァ区婿譯<E5A9BF>**<2A>悟庄莉・譬ケ謐ョ荳壼苅髴€豎る囂譌カ隹<EFBDB6><EFBFBD>梧裏髴€謾ケ蜉ィ莉」遐<EFBDA3>€サ霎代€よ耳闕蝉サ主錘遶ッAPI蜉ィ諤∬執蜿也沿譛ャ驟咲スョ縲?
> **重要提示:** 本文档中涉及的版本权限分配(基础版、高级版、旗舰版的模块分配)均为**初始方案**可以根据业务需求随时调整无需改动代码逻辑。推荐从后端API动态获取版本配置。
---
## 🎯 设计原则
### 1. 讓。蝮怜喧隶セ隶?
- 豈丈クェ蜉溯<EFBFBD>讓。蝮礼峡遶句シ€蜿代€∫峡遶矩Κ鄂?
### 1. 模块化设计
- 每个功能模块独立开发、独立部署
- 模块间无依赖关系,可独立运行
- 謾ッ謖∵ィ。蝮礼峡遶倶コァ蜩∝喧<EFBFBD>亥ヲ<EFBFBD>I譎コ閭ス譁<EFBFBD>鍵迢ャ遶句醗蜊厄シ?
- 支持模块独立产品化如AI智能文献独立售卖
### 2. 权限控制设计
- 蝓コ莠守畑謌キ迚域悽逧<EFBFBD>揀髯先而蛻?
- 轣オ豢サ逧<EFBFBD>粥閭ス讓。蝮怜シ€蜈ウ譛コ蛻?
- 謾ッ謖∵悴譚・蝠<EFBFBD>ク壽ィ。蠑乗挙螻包シ亥渕遑€迚医€<EFBFBD>ォ倡コァ迚医€∵覧闊ー迚茨シ?
- 基于用户版本的权限控制
- 灵活的功能模块开关机制
- 支持未来商业模式拓展(基础版、高级版、旗舰版)
### 3. 蜿ッ謇ゥ螻墓€ァ隶セ隶?
- <EFBFBD>蕗譁ー讓。蝮玲磁蜈・謗・蜿?
### 3. 可扩展性设计
- 预留新模块接入接口
- 插件化的模块加载机制
- 驟咲スョ鬩ア蜉ィ逧<EFBFBD>粥閭ス蠑€蜈?
- 配置驱动的功能开关
### 4. 荳€閾エ諤ァ隶セ隶?
### 4. 一致性设计
- 统一的UI/UX规范
- 扈滉ク€<EFBFBD>コ、莠呈ィ。蠑?
- 扈滉ク€<EFBFBD>憾諤∫ョ。逅?
- 统一的交互模式
- 统一的状态管理
---
@@ -51,37 +51,37 @@
### 导航结构
```
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏?Logo [AI髣ョ遲脳 [AI譎コ閭ス譁<EFBDBD>鍵] [遏・隸<EFBDA5>コ転 [譎コ閭ス謨ー謐ョ貂<EFBDAE>エ余 [譎コ閭ス扈溯ョ。蛻<EFBDA1>梵] [扈溯ョ。蛻<EFBDA1>梵蟾・蜈キ] [逕ィ謌キ蜷?笆シ] 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
┌──────────────────────────────────────────────────────────────────────────────┐
Logo [AI问答] [AI智能文献] [知识库] [智能数据清洗] [智能统计分析] [统计分析工具] [用户名 ▼] │
└──────────────────────────────────────────────────────────────────────────────┘
```
### 蟇シ闊ェ鬘ケ隸ヲ諠?
### 导航项详情
| 菴咲スョ | 荳ュ譁<EFBDAD>錐遘ー | 闍ア譁<EFBDB1><E8AD81><EFBFBD><EFBFBD> | 霍ッ逕ア霍ッ蠕<EFBDAF> | 蠑€蜿醍憾諤?| 譚<>剞隕∵アゑシ亥<EFBDBC>蟋矩<E89F8B>鄂ョ<E98482><EFBDAE> |
| 位置 | 中文名称 | 英文标识 | 路由路径 | 开发状态 | 权限要求(初始配置) |
|------|---------|---------|---------|---------|---------------------|
| 1 | AI髣ョ遲<EFBFBD> | `ai-qa` | `/ai-qa` | 笨?蟾イ蠑€蜿?| 蝓コ遑€迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?|
| 2 | AI譎コ閭ス譁<EFBFBD> | `literature-platform` | `/literature` | <EFBFBD>圦 蠕<>€蜿?| 鬮倡コァ迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?|
| 3 | 遏・隸<EFBFBD>コ?| `knowledge-base` | `/knowledge-base` | 笨?蟾イ蠑€蜿?| 蝓コ遑€迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?|
| 4 | 譎コ閭ス謨ー謐ョ貂<EFBFBD><EFBFBD> | `data-cleaning` | `/data-cleaning` | <EFBFBD>搭 蜊<><EFBFBD> | 鬮倡コァ迚? 笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?|
| 5 | 譎コ閭ス扈溯ョ。蛻<EFBFBD> | `statistical-analysis` | `/intelligent-analysis` | 笨?蟾イ蠑€蜿托シ<E68998>ava蝗「髦滂シ?| 譌苓芦迚?笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?|
| 6 | 扈溯ョ。蛻<EFBFBD>梵蟾・蜈キ | `statistical-tools` | `/statistical-tools` | 笨?蟾イ蠑€蜿托シ<E68998>ava蝗「髦滂シ?| 譌苓芦迚?笞<><E7AC9E>丞庄隹<E5BA84><E99AB9>?|
| 譛€蜿ウ萓ァ | 荳ェ莠コ荳ュ蠢<EFBDAD> | `user-center` | `/user/*` | 笨?蟾イ蠑€蜿?| 謇€譛臥畑謌?|
| 1 | AI问答 | `ai-qa` | `/ai-qa` | ✅ 已开发 | 基础版+ ⚠️可调整 |
| 2 | AI智能文献 | `literature-platform` | `/literature` | 🚧 待开发 | 高级版+ ⚠️可调整 |
| 3 | 知识库 | `knowledge-base` | `/knowledge-base` | ✅ 已开发 | 基础版+ ⚠️可调整 |
| 4 | 智能数据清洗 | `data-cleaning` | `/data-cleaning` | 📋 占位 | 高级版+ ⚠️可调整 |
| 5 | 智能统计分析 | `statistical-analysis` | `/intelligent-analysis` | ✅ 已开发Java团队 | 旗舰版 ⚠️可调整 |
| 6 | 统计分析工具 | `statistical-tools` | `/statistical-tools` | ✅ 已开发Java团队 | 旗舰版 ⚠️可调整 |
| 最右侧 | 个人中心 | `user-center` | `/user/*` | ✅ 已开发 | 所有用户 |
> **隸エ譏趣シ?* 譚<>剞隕∵アょ<EFBDB1>荳ュ逧?蝓コ遑€迚?"縲?鬮倡コァ迚?"縲?譌苓芦迚?荳?*蛻晏ァ矩<EFBDA7>鄂ョ**<2A>悟庄譬ケ謐ョ荳壼苅髴€豎る囂譌カ隹<EFBDB6><EFBFBD>梧裏髴€謾ケ蜉ィ莉」遐<EFBDA3>€サ霎代€よ耳闕蝉サ主錘遶ッAPI蜉ィ諤∬執蜿也沿譛ャ驟咲スョ縲?
> **说明:** 权限要求列中的"基础版+"、"高级版+"、"旗舰版"为**初始配置**可根据业务需求随时调整无需改动代码逻辑。推荐从后端API动态获取版本配置。
### 路由路径设计
```typescript
// 荳サ霍ッ逕ア扈捺<EFBFBD>?
// 主路由结构
const routes = {
// 模块路由
'/ai-qa': 'AI问答模块',
'/literature': 'AI智能文献模块',
'/knowledge-base': '遏・隸<EFBFBD>コ捺ィ。蝮?,
'/knowledge-base': '知识库模块',
'/data-cleaning': '智能数据清洗模块(占位)',
'/intelligent-analysis': '<EFBFBD><EFBFBD>ava蝗€<EFBFBD><EFBFBD><EFBFBD>?,
'/statistical-tools': '扈溯ョ。蛻<EFBFBD>梵蟾・蜈キ讓。蝮暦シ<EFBFBD>ava蝗「髦溷シ€蜿托シ悟宵蛛夐。カ驛ィ蟇シ闊ェ髮<EFBFBD><EFBFBD><EFBFBD>?,
'/intelligent-analysis': '智能统计分析模块Java团队开发只做顶部导航集成',
'/statistical-tools': '统计分析工具模块Java团队开发只做顶部导航集成',
// 用户相关
'/user/profile': '个人中心 - 个人资料',
@@ -93,35 +93,35 @@ const routes = {
---
## <EFBFBD><EFBFBD>?謨エ菴捺楔譫<E6A594>ョセ隶。
## 🏗️ 整体架构设计
### 譫カ譫<EFBFBD>アよャ。蝗?
### 架构层次图
```
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? 蠎皮畑螻?(Application) 笏?
笏? 笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏?
笏? 笏?AI髣ョ遲<EFBDAE> 笏?笏<>I譎コ閭ス譁<EFBDBD>鍵笏?笏?遏・隸<EFBDA5>コ? 笏?笏?蜈カ莉匁ィ。蝮<EFBDA1> 笏? 笏?
笏? 笏?Module 笏?笏?Module 笏?笏?Module 笏?笏?Module 笏? 笏?
笏? 笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
竊?
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? <EFBFBD>楔螻?(Framework Layer) 笏?
笏? 笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏?
笏? 笏?蟇シ闊ェ邉サ扈<EFBDBB> 笏?笏?霍ッ逕ア邉サ扈<EFBDBB> 笏?笏?譚<>剞謗ァ蛻カ 笏? 笏?
笏? 笏?Navigation 笏?笏?Router 笏?笏?Permission 笏? 笏?
笏? 笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏?
笏? 笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏?
笏? 笏?蟶<>€邉サ扈<EFBDBB> 笏?笏?迥カ諤∫ョ。逅? 笏?笏?驟咲スョ邂。逅<EFBDA1> 笏? 笏?
笏? 笏?Layout 笏?笏?State Mgmt 笏?笏?Config 笏? 笏?
笏? 笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏? 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
竊?
笏娯楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
笏? 蝓コ遑€螻?(Base Layer) 笏?
笏? React + TypeScript + Ant Design + Tailwind CSS 笏?
笏披楳笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏€笏?
┌─────────────────────────────────────────────────────────────┐
应用层 (Application)
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ │ AI问答 │ │AI智能文献│ │ 知识库 │ │ 其他模块 │
│ │ Module │ │ Module │ │ Module │ │ Module
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
框架层 (Framework Layer)
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ │ 导航系统 │ │ 路由系统 │ │ 权限控制
│ │ Navigation │ │ Router │ │ Permission
│ └──────────────┘ └──────────────┘ └──────────────┘
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ │ 布局系统 │ │ 状态管理 │ │ 配置管理 │ │
│ │ Layout │ │ State Mgmt │ │ Config
│ └──────────────┘ └──────────────┘ └──────────────┘
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
基础层 (Base Layer)
React + TypeScript + Ant Design + Tailwind CSS
└─────────────────────────────────────────────────────────────┘
```
### 目录结构设计
@@ -129,80 +129,80 @@ const routes = {
```
frontend-v2/
├── src/
笏? 笏懌楳笏€ app/ # 蠎皮畑蜈・蜿」
笏? 笏? 笏懌楳笏€ App.tsx # 譬ケ扈<EFBFBD>サ?
笏? 笏? 笏懌楳笏€ main.tsx # 蜈・蜿」譁<EFBFBD>サカ
笏? 笏? 笏披楳笏€ routes.tsx # 霍ッ逕ア驟咲スョ
笏? 笏?
笏? 笏懌楳笏€ framework/ # <EFBFBD>楔螻ゑシ域<EFBFBD>ク蠢<EFBFBD>シ?
笏? 笏? 笏懌楳笏€ navigation/ # 蟇シ闊ェ邉サ扈<EFBFBD>
笏? 笏? 笏? 笏懌楳笏€ TopNavigation.tsx # 鬘カ驛ィ蟇シ闊ェ
笏? 笏? 笏? 笏懌楳笏€ SideNavigation.tsx # 蟾ヲ萓ァ蟇シ闊ェ
笏? 笏? 笏? 笏披楳笏€ navigationConfig.ts # 蟇シ闊ェ驟咲スョ
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ routing/ # 霍ッ逕ア邉サ扈<EFBFBD>
笏? 笏? 笏? 笏懌楳笏€ RouterConfig.tsx # 霍ッ逕ア驟咲スョ
笏? 笏? 笏? 笏懌楳笏€ RouteGuard.tsx # 霍ッ逕ア螳亥梱<EFBFBD>域揀髯撰シ<EFBFBD>
笏? 笏? 笏? 笏披楳笏€ LazyLoader.tsx # 諛貞刈霓?
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ permission/ # <EFBFBD>剞謗ァ蛻カ
笏? 笏? 笏? 笏懌楳笏€ PermissionProvider.tsx
笏? 笏? 笏? 笏懌楳笏€ usePermission.ts # <EFBFBD>Hook
笏? 笏? 笏? 笏懌楳笏€ permissionConfig.ts # <EFBFBD>剞驟咲スョ
笏? 笏? 笏? 笏披楳笏€ versionConfig.ts # 迚域悽驟咲スョ
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ layout/ # <EFBFBD>€邉サ扈<EFBFBD>
笏? 笏? 笏? 笏懌楳笏€ MainLayout.tsx # 荳サ蟶<EFBFBD>€
笏? 笏? 笏? 笏懌楳笏€ ModuleLayout.tsx # 讓。蝮怜ク<EFBFBD>€
笏? 笏? 笏? 笏披楳笏€ EmptyLayout.tsx # 遨コ蟶<EFBFBD>€
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ config/ # 驟咲スョ邂。逅<EFBFBD>
笏? 笏? 笏? 笏懌楳笏€ moduleConfig.ts # 讓。蝮鈴<EFBFBD>鄂ョ
笏? 笏? 笏? 笏懌楳笏€ appConfig.ts # 蠎皮畑驟咲スョ
笏? 笏? 笏? 笏披楳笏€ environment.ts # 邇ッ蠅<EFBFBD><EFBFBD>鄂ョ
笏? 笏? 笏?
笏? 笏? 笏披楳笏€ state/ # 蜈ィ螻€迥カ諤?
笏? 笏? 笏懌楳笏€ userStore.ts # 逕ィ謌キ迥カ諤?
笏? 笏? 笏懌楳笏€ navigationStore.ts # 蟇シ闊ェ迥カ諤?
笏? 笏? 笏披楳笏€ permissionStore.ts # <EFBFBD>剞迥カ諤?
笏? 笏?
笏? 笏懌楳笏€ modules/ # 蜉溯<EFBFBD>讓。蝮暦シ育峡遶具シ<EFBFBD>
笏? 笏? 笏懌楳笏€ ai-qa/ # AI髣ョ遲疲ィ。蝮<EFBFBD>
笏? 笏? 笏? 笏懌楳笏€ index.tsx
笏? 笏? 笏? 笏懌楳笏€ routes.tsx
笏? 笏? 笏? 笏披楳笏€ ...
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ literature/ # AI譎コ閭ス譁<EFBFBD>鍵讓。蝮<EFBFBD>
笏? 笏? 笏? 笏懌楳笏€ index.tsx
笏? 笏? 笏? 笏懌楳笏€ routes.tsx
笏? 笏? 笏? 笏披楳笏€ ...
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ knowledge-base/ # 遏・隸<EFBFBD>コ捺ィ。蝮?
笏? 笏? 笏? 笏懌楳笏€ index.tsx
笏? 笏? 笏? 笏懌楳笏€ routes.tsx
笏? 笏? 笏? 笏披楳笏€ ...
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ data-cleaning/ # 譎コ閭ス謨ー謐ョ貂<EFBFBD>エ暦シ亥頃菴搾シ<EFBFBD>
笏? 笏? 笏? 笏披楳笏€ Placeholder.tsx
笏? 笏? 笏?
笏? 笏? 笏懌楳笏€ intelligent-analysis/ # 譎コ閭ス扈溯ョ。蛻<EFBFBD>
笏? 笏? 笏? 笏披楳笏€ ...
笏? 笏? 笏?
笏? 笏? 笏披楳笏€ statistical-tools/ # 扈溯ョ。蛻<EFBFBD>梵蟾・蜈キ
笏? 笏? 笏披楳笏€ ...
笏? 笏?
笏? 笏懌楳笏€ components/ # 騾夂畑扈<EFBFBD>サカ
笏? 笏? 笏懌楳笏€ common/ # 蝓コ遑€<EFBFBD>サカ
笏? 笏? 笏懌楳笏€ business/ # 荳壼苅扈<EFBFBD>サカ
笏? 笏? 笏披楳笏€ hooks/ # 騾夂畑Hooks
笏? 笏?
笏? 笏懌楳笏€ api/ # API螻?
笏? 笏? 笏懌楳笏€ client.ts # API螳「謌キ遶?
笏? 笏? 笏懌楳笏€ modules/ # 讓。蝮輸PI
笏? 笏? 笏披楳笏€ types/ # API邀サ蝙<EFBFBD>
笏? 笏?
笏? 笏懌楳笏€ utils/ # 蟾・蜈キ蜃ス謨ー
笏? 笏披楳笏€ types/ # 蜈ィ螻€邀サ蝙<EFBFBD>
│ ├── app/ # 应用入口
│ │ ├── App.tsx # 根组件
│ │ ├── main.tsx # 入口文件
│ │ └── routes.tsx # 路由配置
│ │
│ ├── framework/ # 框架层(核心)
│ │ ├── navigation/ # 导航系统
│ │ │ ├── TopNavigation.tsx # 顶部导航
│ │ │ ├── SideNavigation.tsx # 左侧导航
│ │ │ └── navigationConfig.ts # 导航配置
│ │ │
│ │ ├── routing/ # 路由系统
│ │ │ ├── RouterConfig.tsx # 路由配置
│ │ │ ├── RouteGuard.tsx # 路由守卫(权限)
│ │ │ └── LazyLoader.tsx # 懒加载
│ │ │
│ │ ├── permission/ # 权限控制
│ │ │ ├── PermissionProvider.tsx
│ │ │ ├── usePermission.ts # 权限Hook
│ │ │ ├── permissionConfig.ts # 权限配置
│ │ │ └── versionConfig.ts # 版本配置
│ │ │
│ │ ├── layout/ # 布局系统
│ │ │ ├── MainLayout.tsx # 主布局
│ │ │ ├── ModuleLayout.tsx # 模块布局
│ │ │ └── EmptyLayout.tsx # 空布局
│ │ │
│ │ ├── config/ # 配置管理
│ │ │ ├── moduleConfig.ts # 模块配置
│ │ │ ├── appConfig.ts # 应用配置
│ │ │ └── environment.ts # 环境配置
│ │ │
│ │ └── state/ # 全局状态
│ │ ├── userStore.ts # 用户状态
│ │ ├── navigationStore.ts # 导航状态
│ │ └── permissionStore.ts # 权限状态
│ │
│ ├── modules/ # 功能模块(独立)
│ │ ├── ai-qa/ # AI问答模块
│ │ │ ├── index.tsx
│ │ │ ├── routes.tsx
│ │ │ └── ...
│ │ │
│ │ ├── literature/ # AI智能文献模块
│ │ │ ├── index.tsx
│ │ │ ├── routes.tsx
│ │ │ └── ...
│ │ │
│ │ ├── knowledge-base/ # 知识库模块
│ │ │ ├── index.tsx
│ │ │ ├── routes.tsx
│ │ │ └── ...
│ │ │
│ │ ├── data-cleaning/ # 智能数据清洗(占位)
│ │ │ └── Placeholder.tsx
│ │ │
│ │ ├── intelligent-analysis/ # 智能统计分析
│ │ │ └── ...
│ │ │
│ │ └── statistical-tools/ # 统计分析工具
│ │ └── ...
│ │
│ ├── components/ # 通用组件
│ │ ├── common/ # 基础组件
│ │ ├── business/ # 业务组件
│ │ └── hooks/ # 通用Hooks
│ │
│ ├── api/ # API
│ │ ├── client.ts # API客户端
│ │ ├── modules/ # 模块API
│ │ └── types/ # API类型
│ │
│ ├── utils/ # 工具函数
│ └── types/ # 全局类型
```
---
@@ -211,7 +211,7 @@ frontend-v2/
### 用户版本定义
> **驥崎ヲ∬ッエ譏趣シ?* 迚域悽譚<E682BD>剞蛻<E5899E><E89BBB>譏ッ螳悟<E89EB3>?*蜿ッ驟咲スョ縲∝庄隹<E5BA84>紛**逧<>€ゆサ・荳矩<E88DB3>鄂ョ荳コ**蛻晏ァ区婿譯<E5A9BF>**<2A>悟庄莉・譬ケ謐ョ荳壼苅髴€豎る囂譌カ菫ョ謾ケ<E8ACBE>梧裏髴€謾ケ蜉ィ莉」遐<EFBDA3>€サ霎代€?
> **重要说明:** 版本权限分配是完全**可配置、可调整**的。以下配置为**初始方案**,可以根据业务需求随时修改,无需改动代码逻辑。
```typescript
// 用户版本类型
@@ -219,14 +219,14 @@ type UserVersion = 'basic' | 'advanced' | 'premium';
// 版本配置(可配置,支持后期调整)
// 配置文件位置src/framework/permission/versionConfig.ts
// 謌冶€<EFBFBD>€夊ソ<EFBFBD>錘遶ッAPI蜉ィ諤∬執蜿夜<EFBFBD>鄂?
// 或者通过后端API动态获取配置
const VERSION_CONFIG = {
basic: {
name: '蝓コ遑€迚?,
modules: ['ai-qa', 'knowledge-base'], // 蛻晏ァ矩<EFBDA7>鄂ョ<E98482>壼渕遑€迚亥桁蜷ォ讓。蝮?
name: '基础版',
modules: ['ai-qa', 'knowledge-base'], // 初始配置:基础版包含模块
},
advanced: {
name: '?,
name: '高级版',
modules: [
'ai-qa',
'knowledge-base',
@@ -235,7 +235,7 @@ const VERSION_CONFIG = {
], // 初始配置:高级版包含模块
},
premium: {
name: '譌苓芦迚?,
name: '旗舰版',
modules: [
'ai-qa',
'knowledge-base',
@@ -247,15 +247,15 @@ const VERSION_CONFIG = {
},
};
// 隸エ譏趣シ?
// 1. 莉・荳頑ィ。蝮怜<EFBFBD>驟堺クコ蛻晏ァ区婿譯茨シ悟庄譬ケ謐ョ螳樣刔荳壼苅髴€豎りー<EFBFBD><EFBFBD>?
// 说明:
// 1. 以上模块分配为初始方案,可根据实际业务需求调整
// 2. 支持通过配置文件修改,无需改动代码
// 3. 更推荐从后端API动态获取版本配置便于实时调整
```
### 权限控制实现
> **隶セ隶。隸エ譏趣シ?* 譚<>剞謗ァ蛻カ驥<EFBDB6>畑驟咲スョ鬩ア蜉ィ逧<EFBDA8>婿蠑擾シ梧髪謖<E9ABAA>€夊ソ<E5A48A><EFBDBF>鄂ョ譁<EFBDAE>サカ謌門錘遶ッAPI蜉ィ諤∬執蜿也沿譛ャ驟咲スョ<EFBDBD>御セソ莠主錘譛溽<E8AD9B>豢サ隹<EFBDBB>紛縲?
> **设计说明:** 权限控制采用配置驱动的方式支持通过配置文件或后端API动态获取版本配置便于后期灵活调整。
```typescript
// 权限控制Hook
@@ -266,7 +266,7 @@ export const usePermission = () => {
// const allowedModules = VERSION_CONFIG[userVersion].modules;
// 方式2从后端API动态获取推荐支持实时调整
const versionConfig = useVersionConfig(); // 莉拶PI闔キ蜿匁怙譁ー驟咲ス?
const versionConfig = useVersionConfig(); // 从API获取最新配置
const allowedModules = versionConfig[userVersion]?.modules || [];
const hasAccess = (moduleId: string): boolean => {
@@ -275,7 +275,7 @@ export const usePermission = () => {
const getFilteredNavigation = (navigation: NavigationItem[]) => {
return navigation.filter((item) => {
// 譽€譟・逕ィ謌キ迚域悽譏ッ蜷ヲ貊。雜ウ讓。蝮苓ヲ∵ア?
// 检查用户版本是否满足模块要求
if (!item.requiredVersion) return true;
const versionHierarchy = ['basic', 'advanced', 'premium'];
const userLevel = versionHierarchy.indexOf(userVersion);
@@ -288,12 +288,12 @@ export const usePermission = () => {
hasAccess,
getFilteredNavigation,
userVersion,
versionConfig, // 霑泌屓蠖灘燕迚域悽驟咲スョ<EFBFBD>御セソ莠手ー<EFBFBD>ッ?
versionConfig, // 返回当前版本配置,便于调试
};
};
```
### 迚域悽驟咲スョ蜉ィ諤∬執蜿厄シ域耳闕先婿譯茨シ?
### 版本配置动态获取(推荐方案)
```typescript
// src/framework/permission/useVersionConfig.ts
@@ -311,16 +311,16 @@ export const useVersionConfig = () => {
refetchOnWindowFocus: false,
});
// 螯よ棡API隸キ豎ょ、ア雍・<EFBFBD>悟屓騾€蛻ー譛ャ蝨ー驟咲ス?
// 如果API请求失败回退到本地配置
return data || VERSION_CONFIG;
};
```
**莨伜漢<EFBFBD>?*
- 笨?迚域悽驟咲スョ蜿ッ蝨ィ蜷守ォッ螳樊慮隹<E685AE><EFBFBD>梧裏髴€蜑咲ォッ蜿醍沿
- 笨?謾ッ謖、/B豬玖ッ穂ク榊酔迚域悽驟咲スョ
- 笨?萓ソ莠手ソ占是莠コ蜻倡<E89CBB>豢サ隹<EFBDBB>紛莠ァ蜩∫ュ也払
- 笨?蜑咲ォッ譛画悽蝨ー驟咲スョ菴應クコ蜈懷コ墓婿譯茨シ御ソ晁ッ∝庄逕ィ諤?
**优势:**
- ✅ 版本配置可在后端实时调整,无需前端发版
- ✅ 支持A/B测试不同版本配置
- ✅ 便于运营人员灵活调整产品策略
- ✅ 前端有本地配置作为兜底方案,保证可用性
### 路由守卫
@@ -339,7 +339,7 @@ export const RouteGuard = ({ moduleId, children }) => {
---
## <EFBFBD>伯 讓。蝮礼峡遶区€ァ隶セ隶?
## 🔌 模块独立性设计
### 模块注册机制
@@ -350,9 +350,9 @@ interface ModuleDefinition {
name: string; // 模块名称
route: string; // 路由路径
icon?: ReactNode; // 图标
component: LazyComponent; // 諛貞刈霓ス扈<EFBFBD>サ?
component: LazyComponent; // 懒加载组件
sideNav?: SideNavConfig; // 左侧导航配置
version?: UserVersion[]; // 謾ッ謖∫噪迚域<EFBFBD>?
version?: UserVersion[]; // 支持的版本
standalone?: boolean; // 是否支持独立运行
apiBaseUrl?: string; // 独立运行时的API地址
}
@@ -366,7 +366,7 @@ const MODULES: ModuleDefinition[] = [
component: lazy(() => import('@/modules/literature')),
version: ['advanced', 'premium'],
standalone: true, // 支持独立运行
apiBaseUrl: process.env.LITERATURE_API_URL, // 蜿ッ驟咲ス?
apiBaseUrl: process.env.LITERATURE_API_URL, // 可配置
},
// ... 其他模块
];
@@ -375,7 +375,7 @@ const MODULES: ModuleDefinition[] = [
### 独立部署支持
```typescript
// 讓。蝮怜刈霓ス蝎?
// 模块加载器
export const ModuleLoader = ({ moduleId }: { moduleId: string }) => {
const module = MODULES.find((m) => m.id === moduleId);
@@ -383,7 +383,7 @@ export const ModuleLoader = ({ moduleId }: { moduleId: string }) => {
return <NotFound />;
}
// 譽€譟・譏ッ蜷ヲ迢ャ遶玖ソ占。梧ィ。蠑?
// 检查是否独立运行模式
const isStandalone = module.standalone &&
window.location.hostname === module.apiBaseUrl;
@@ -397,7 +397,7 @@ export const ModuleLoader = ({ moduleId }: { moduleId: string }) => {
};
```
### 驟咲スョ鬩ア蜉ィ逧<EFBFBD>ィ。蝮怜刈霓?
### 配置驱动的模块加载
```typescript
// 环境变量配置
@@ -421,12 +421,12 @@ const getEnabledModules = () => {
```
MainLayout (主布局)
├── Header (顶部导航)
笏? 笏懌楳笏€ Logo
笏? 笏懌楳笏€ TopNavigation (蟇シ闊ェ鬘?
笏? 笏披楳笏€ UserMenu (逕ィ謌キ闖懷黒)
笏?
│ ├── Logo
│ ├── TopNavigation (导航项)
│ └── UserMenu (用户菜单)
└── MainContent (主内容区)
笏懌楳笏€ SideNavigation (蟾ヲ萓ァ蟇シ闊ェ) - 蜿ッ騾?
├── SideNavigation (左侧导航) - 可选
└── Content (内容区域)
└── ModuleLayout (模块布局)
```
@@ -498,55 +498,55 @@ export const ModuleLayout = ({ module }: { module: ModuleDefinition }) => {
}
```
### 蜩榊コ泌シ剰ョセ隶?
### 响应式设计
- **譯碁擇遶?(>1024px)**: 螳梧紛譏セ遉コ謇€譛牙ッシ闊ェ鬘ケ
- **蟷ウ譚ソ遶?(768-1024px)**: 譏セ遉コ蜑?荳ェ<E88DB3><EFBFBD>菴呎釜蜿<E9879C>蛻?譖エ螟<EFBDB4>"闖懷黒
- **遘サ蜉ィ遶?(<768px)**: 豎牙<EFBFBD>。闖懷黒 + 謚ス螻牙ッシ闊ェ
- **桌面端 (>1024px)**: 完整显示所有导航项
- **平板端 (768-1024px)**: 显示前4个其余折叠到"更多"菜单
- **移动端 (<768px)**: 汉堡菜单 + 抽屉导航
---
## 📝 实施计划
### 隨ャ荳€髦カ谿オ<EFBFBD>壽。<EFBFBD>楔謳ュ蟒コ<EFBFBD><EFBFBD>eek 1<EFBFBD>?
- [x] 蛻帛サコ譁ー蜑咲ォッ鬘ケ逶ョ扈捺<EFBFBD>?
### 第一阶段框架搭建Week 1
- [x] 创建新前端项目结构
- [ ] 实现顶部导航组件
- [ ] 实现路由系统
- [ ] 实现权限控制基础
- [ ] 实现基础布局系统
### 隨ャ莠碁亳谿オ<EFBFBD>壽ィ。蝮鈴寔謌撰シ<EFBFBD>eek 2<EFBFBD>?
### 第二阶段模块集成Week 2
- [ ] 迁移AI问答模块
- [ ] 霑∫ァサ遏・隸<EFBFBD>コ捺ィ。蝮?
- [ ] 迁移知识库模块
- [ ] 实现占位模块(智能数据清洗)
- [ ] 完善权限控制
### 隨ャ荳蛾亳谿オ<EFBFBD>哂I譎コ閭ス譁<EFBFBD>鍵蠑€蜿托シ<EFBFBD>eek 3+<EFBFBD>?
### 第三阶段AI智能文献开发Week 3+
- [ ] 开发AI智能文献模块
- [ ] 实现模块独立运行支持
- [ ] 螳悟埋譁<EFBFBD>。」蜥梧オ玖ッ?
- [ ] 完善文档和测试
---
## 🔄 未来扩展考虑
### 1. 讓。蝮礼峡遶倶コァ蜩∝<EFBFBD>?
### 1. 模块独立产品化
- 支持通过环境变量配置独立运行
- 独立的API地址配置
- 迢ャ遶狗噪驛ィ鄂イ驟咲ス?
- 独立的部署配置
### 2. 版本权限管理
- 后端API提供用户版本信息
- 迚域悽驟咲スョ螳悟<EFBFBD>蜿ッ隹<EFBFBD><EFBFBD>域裏髴€謾ケ蜉ィ莉」遐<EFBFBD>シ?
- 版本配置完全可调整(无需改动代码)
- 推荐从后端API动态获取版本配置支持实时调整模块分配
- 蜑咲ォッ譬ケ謐ョ迚域悽蜉ィ諤∵仞遉?髫占酪讓。蝮<EFBDA1>
- 前端根据版本动态显示/隐藏模块
- 支持版本升级提示
- 迚域悽譚<EFBFBD>剞蛻<EFBFBD><EFBFBD>遲也払蜿ッ髫乗慮譬ケ謐ョ荳壼苅髴€豎りー<EFBFBD><EFBFBD>?
- 版本权限分配策略可随时根据业务需求调整
### 3. 譁ー讓。蝮玲磁蜈?
### 3. 新模块接入
- 遵循模块接口规范
- 在配置文件中注册模块
- 閾ェ蜉ィ髮<EFBFBD><EFBFBD>蛻ー蟇シ闊ェ邉サ扈?
- 自动集成到导航系统
---
@@ -560,7 +560,7 @@ export const ModuleLayout = ({ module }: { module: ModuleDefinition }) => {
---
**<EFBFBD>。」迚域悽<EFBFBD>?* v1.0
**文档版本:** v1.0
**最后更新:** 2025-10-29