feat(aia): Complete AIA V2.0 with universal streaming capabilities
Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
This commit is contained in:
@@ -1,48 +1,48 @@
|
||||
# 蟷ｳ蜿ｰ蜑咲ｫｯ諤ｻ菴捺楔譫<E6A594>ｮｾ隶｡
|
||||
|
||||
> **文档版本：** v1.0
|
||||
> **创建日期：** 2025-10-29
|
||||
> **维护者：** 前端开发团队
|
||||
> **譁<EFBFBD>｡｣迚域悽<EFBFBD>?* v1.0
|
||||
> **蛻帛ｻｺ譌･譛滂ｼ?* 2025-10-29
|
||||
> **扈ｴ謚､閠<EFBFBD>ｼ<EFBFBD>** 蜑咲ｫｯ蠑蜿大屬髦?
|
||||
> **譛蜷取峩譁ｰ<E8AD81><EFBDB0>** 2025-10-29
|
||||
|
||||
---
|
||||
|
||||
## <20>搭 譁<>｡｣隸ｴ譏<EFBDB4>
|
||||
|
||||
本文档是**平台级前端架构设计**，涵盖整个AI科研平台的前端架构，包括：
|
||||
- 统一的顶部导航设计
|
||||
- 模块化架构设计
|
||||
譛ｬ譁<EFBFBD>｡｣譏ｯ**蟷ｳ蜿ｰ郤ｧ蜑咲ｫｯ譫ｶ譫<EFBDB6>ｮｾ隶?*<2A>梧ｶｵ逶匁紛荳ｪAI遘醍<E98198>泌ｹｳ蜿ｰ逧<EFBDB0>燕遶ｯ譫ｶ譫<EFBDB6>ｼ悟桁諡ｬ<E8ABA1>?
|
||||
- 扈滉ｸ逧<EFBFBD>｡ｶ驛ｨ蟇ｼ闊ｪ隶ｾ隶?
|
||||
- 讓｡蝮怜喧譫ｶ譫<EFBFBD>ｮｾ隶?
|
||||
- 霍ｯ逕ｱ隶ｾ隶｡
|
||||
- 权限控制系统（**版本配置完全可调整**）
|
||||
- 模块独立性设计（支持未来独立分拆）
|
||||
- 譚<EFBFBD>剞謗ｧ蛻ｶ邉ｻ扈滂ｼ?*迚域悽驟咲ｽｮ螳悟<E89EB3>蜿ｯ隹<EFBDAF><E99AB9>?*<2A>?
|
||||
- 讓｡蝮礼峡遶区ｧ隶ｾ隶｡<EFBFBD>域髪謖∵悴譚･迢ｬ遶句<EFBFBD>諡<EFBFBD>ｼ?
|
||||
|
||||
> **注意：** 本文档是平台级设计，各模块的详细架构设计请参考各模块的专属文档。
|
||||
> **豕ｨ諢擾ｼ?* 譛ｬ譁<EFBDAC>｡｣譏ｯ蟷ｳ蜿ｰ郤ｧ隶ｾ隶｡<E99AB6>悟推讓｡蝮礼噪隸ｦ扈<EFBDA6>楔譫<E6A594>ｮｾ隶｡隸ｷ蜿り<E3828A>推讓｡蝮礼噪荳灘ｱ樊枚譯｣縲?
|
||||
|
||||
> **重要提示：** 本文档中涉及的版本权限分配（基础版、高级版、旗舰版的模块分配）均为**初始方案**，可以根据业务需求随时调整，无需改动代码逻辑。推荐从后端API动态获取版本配置。
|
||||
> **驥崎ｦ∵署遉ｺ<EFBFBD>?* 譛ｬ譁<EFBDAC>｡｣荳ｭ豸牙所逧<E68980>沿譛ｬ譚<EFBDAC>剞蛻<E5899E><E89BBB><EFBFBD>亥渕遑迚医<E58CBB>ｫ倡ｺｧ迚医∵覧闊ｰ迚育噪讓｡蝮怜<E89DAE>驟搾ｼ牙插荳ｺ**蛻晏ｧ区婿譯<E5A9BF>**<2A>悟庄莉･譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ隹<EFBDB6>紛<EFBFBD>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎代よ耳闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ縲?
|
||||
|
||||
---
|
||||
|
||||
## <20>識 隶ｾ隶｡蜴溷<E89CB4>
|
||||
|
||||
### 1. 模块化设计
|
||||
- 每个功能模块独立开发、独立部署
|
||||
### 1. 讓｡蝮怜喧隶ｾ隶?
|
||||
- 豈丈ｸｪ蜉溯<EFBFBD>讓｡蝮礼峡遶句ｼ蜿代∫峡遶矩Κ鄂?
|
||||
- 讓｡蝮鈴龍譌<E9BE8D>萓晁ｵ門<EFBDB5>邉ｻ<E98289>悟庄迢ｬ遶玖ｿ占｡<E58DA0>
|
||||
- 支持模块独立产品化（如AI智能文献独立售卖）
|
||||
- 謾ｯ謖∵ｨ｡蝮礼峡遶倶ｺｧ蜩∝喧<EFBFBD>亥ｦ<EFBFBD>I譎ｺ閭ｽ譁<EFBFBD>鍵迢ｬ遶句醗蜊厄ｼ?
|
||||
|
||||
### 2. 譚<>剞謗ｧ蛻ｶ隶ｾ隶｡
|
||||
- 基于用户版本的权限控制
|
||||
- 灵活的功能模块开关机制
|
||||
- 支持未来商业模式拓展（基础版、高级版、旗舰版）
|
||||
- 蝓ｺ莠守畑謌ｷ迚域悽逧<EFBFBD>揀髯先而蛻?
|
||||
- 轣ｵ豢ｻ逧<EFBFBD>粥閭ｽ讓｡蝮怜ｼ蜈ｳ譛ｺ蛻?
|
||||
- 謾ｯ謖∵悴譚･蝠<EFBFBD>ｸ壽ｨ｡蠑乗挙螻包ｼ亥渕遑迚医<EFBFBD>ｫ倡ｺｧ迚医∵覧闊ｰ迚茨ｼ?
|
||||
|
||||
### 3. 可扩展性设计
|
||||
- 预留新模块接入接口
|
||||
### 3. 蜿ｯ謇ｩ螻墓ｧ隶ｾ隶?
|
||||
- 鬚<EFBFBD>蕗譁ｰ讓｡蝮玲磁蜈･謗･蜿?
|
||||
- 謠剃ｻｶ蛹也噪讓｡蝮怜刈霓ｽ譛ｺ蛻ｶ
|
||||
- 配置驱动的功能开关
|
||||
- 驟咲ｽｮ鬩ｱ蜉ｨ逧<EFBFBD>粥閭ｽ蠑蜈?
|
||||
|
||||
### 4. 一致性设计
|
||||
### 4. 荳閾ｴ諤ｧ隶ｾ隶?
|
||||
- 扈滉ｸ逧ФI/UX隗<58>激
|
||||
- 统一的交互模式
|
||||
- 统一的状态管理
|
||||
- 扈滉ｸ逧<EFBFBD>ｺ､莠呈ｨ｡蠑?
|
||||
- 扈滉ｸ逧<EFBFBD>憾諤∫ｮ｡逅?
|
||||
|
||||
---
|
||||
|
||||
@@ -51,37 +51,37 @@
|
||||
### 蟇ｼ闊ｪ扈捺桷
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────────────────┐
|
||||
│ Logo [AI问答] [AI智能文献] [知识库] [智能数据清洗] [智能统计分析] [统计分析工具] [用户名 ▼] │
|
||||
└──────────────────────────────────────────────────────────────────────────────┘
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏?Logo [AI髣ｮ遲脳 [AI譎ｺ閭ｽ譁<EFBDBD>鍵] [遏･隸<EFBDA5>ｺ転 [譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ余 [譎ｺ閭ｽ扈溯ｮ｡蛻<EFBDA1>梵] [扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ] [逕ｨ謌ｷ蜷?笆ｼ] 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
```
|
||||
|
||||
### 导航项详情
|
||||
### 蟇ｼ闊ｪ鬘ｹ隸ｦ諠?
|
||||
|
||||
| 位置 | 中文名称 | 英文标识 | 路由路径 | 开发状态 | 权限要求（初始配置） |
|
||||
| 菴咲ｽｮ | 荳ｭ譁<EFBDAD>錐遘ｰ | 闍ｱ譁<EFBDB1><E8AD81><EFBFBD>ｯ<EFBFBD> | 霍ｯ逕ｱ霍ｯ蠕<EFBDAF> | 蠑蜿醍憾諤?| 譚<>剞隕∵ｱゑｼ亥<EFBDBC>蟋矩<E89F8B>鄂ｮ<E98482><EFBDAE> |
|
||||
|------|---------|---------|---------|---------|---------------------|
|
||||
| 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/*` | ✅ 已开发 | 所有用户 |
|
||||
| 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/*` | 笨?蟾ｲ蠑蜿?| 謇譛臥畑謌?|
|
||||
|
||||
> **说明：** 权限要求列中的"基础版+"、"高级版+"、"旗舰版"为**初始配置**，可根据业务需求随时调整，无需改动代码逻辑。推荐从后端API动态获取版本配置。
|
||||
> **隸ｴ譏趣ｼ?* 譚<>剞隕∵ｱょ<EFBDB1>荳ｭ逧?蝓ｺ遑迚?"縲?鬮倡ｺｧ迚?"縲?譌苓芦迚?荳?*蛻晏ｧ矩<EFBDA7>鄂ｮ**<2A>悟庄譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ隹<EFBDB6>紛<EFBFBD>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎代よ耳闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ縲?
|
||||
|
||||
### 霍ｯ逕ｱ霍ｯ蠕<EFBDAF>ｮｾ隶｡
|
||||
|
||||
```typescript
|
||||
// 主路由结构
|
||||
// 荳ｻ霍ｯ逕ｱ扈捺<EFBFBD>?
|
||||
const routes = {
|
||||
// 讓｡蝮苓ｷｯ逕ｱ
|
||||
'/ai-qa': 'AI髣ｮ遲疲ｨ｡蝮<EFBDA1>',
|
||||
'/literature': 'AI譎ｺ閭ｽ譁<EFBDBD>鍵讓｡蝮<EFBDA1>',
|
||||
'/knowledge-base': '知识库模块',
|
||||
'/knowledge-base': '遏･隸<EFBFBD>ｺ捺ｨ｡蝮?,
|
||||
'/data-cleaning': '譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBFBD>ｴ玲ｨ｡蝮暦ｼ亥頃菴搾ｼ<EFBFBD>',
|
||||
'/intelligent-analysis': '智能统计分析模块（Java团队开发，只做顶部导航集成）',
|
||||
'/statistical-tools': '统计分析工具模块（Java团队开发，只做顶部导航集成）',
|
||||
'/intelligent-analysis': '譎ｺ閭ｽ扈溯ｮ｡蛻<EFBFBD>梵讓｡蝮暦ｼ<EFBFBD>ava蝗｢髦溷ｼ蜿托ｼ悟宵蛛夐｡ｶ驛ｨ蟇ｼ闊ｪ髮<EFBFBD><EFBFBD><EFBFBD>?,
|
||||
'/statistical-tools': '扈溯ｮ｡蛻<EFBFBD>梵蟾･蜈ｷ讓｡蝮暦ｼ<EFBFBD>ava蝗｢髦溷ｼ蜿托ｼ悟宵蛛夐｡ｶ驛ｨ蟇ｼ闊ｪ髮<EFBFBD><EFBFBD><EFBFBD>?,
|
||||
|
||||
// 逕ｨ謌ｷ逶ｸ蜈ｳ
|
||||
'/user/profile': '荳ｪ莠ｺ荳ｭ蠢<EFBFBD> - 荳ｪ莠ｺ襍<EFBFBD>侭',
|
||||
@@ -93,35 +93,35 @@ const routes = {
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 整体架构设计
|
||||
## <EFBFBD>女<EFBFBD>?謨ｴ菴捺楔譫<E6A594>ｮｾ隶｡
|
||||
|
||||
### 架构层次图
|
||||
### 譫ｶ譫<EFBFBD>ｱよｬ｡蝗?
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 应用层 (Application) │
|
||||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||||
│ │ AI问答 │ │AI智能文献│ │ 知识库 │ │ 其他模块 │ │
|
||||
│ │ Module │ │ Module │ │ Module │ │ Module │ │
|
||||
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 框架层 (Framework Layer) │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ 导航系统 │ │ 路由系统 │ │ 权限控制 │ │
|
||||
│ │ Navigation │ │ Router │ │ Permission │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ 布局系统 │ │ 状态管理 │ │ 配置管理 │ │
|
||||
│ │ Layout │ │ State Mgmt │ │ Config │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 基础层 (Base Layer) │
|
||||
│ React + TypeScript + Ant Design + Tailwind CSS │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏? 蠎皮畑螻?(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 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
```
|
||||
|
||||
### 逶ｮ蠖慕ｻ捺桷隶ｾ隶｡
|
||||
@@ -129,80 +129,80 @@ const routes = {
|
||||
```
|
||||
frontend-v2/
|
||||
笏懌楳笏 src/
|
||||
│ ├── 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/ # 全局类型
|
||||
笏? 笏懌楳笏 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>
|
||||
```
|
||||
|
||||
---
|
||||
@@ -211,7 +211,7 @@ frontend-v2/
|
||||
|
||||
### 逕ｨ謌ｷ迚域悽螳壻ｹ<E5A3BB>
|
||||
|
||||
> **重要说明：** 版本权限分配是完全**可配置、可调整**的。以下配置为**初始方案**，可以根据业务需求随时修改，无需改动代码逻辑。
|
||||
> **驥崎ｦ∬ｯｴ譏趣ｼ?* 迚域悽譚<E682BD>剞蛻<E5899E><E89BBB>譏ｯ螳悟<E89EB3>?*蜿ｯ驟咲ｽｮ縲∝庄隹<E5BA84>紛**逧<>ゆｻ･荳矩<E88DB3>鄂ｮ荳ｺ**蛻晏ｧ区婿譯<E5A9BF>**<2A>悟庄莉･譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ菫ｮ謾ｹ<E8ACBE>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎代?
|
||||
|
||||
```typescript
|
||||
// 逕ｨ謌ｷ迚域悽邀ｻ蝙<EFBDBB>
|
||||
@@ -219,14 +219,14 @@ type UserVersion = 'basic' | 'advanced' | 'premium';
|
||||
|
||||
// 迚域悽驟咲ｽｮ<EFBDBD>亥庄驟咲ｽｮ<EFBDBD>梧髪謖∝錘譛溯ｰ<E6BAAF>紛<EFBFBD><E7B49B>
|
||||
// 驟咲ｽｮ譁<EFBDAE>ｻｶ菴咲ｽｮ<EFBDBD>嘖rc/framework/permission/versionConfig.ts
|
||||
// 或者通过后端API动态获取配置
|
||||
// 謌冶<EFBFBD>夊ｿ<EFBFBD>錘遶ｯAPI蜉ｨ諤∬執蜿夜<EFBFBD>鄂?
|
||||
const VERSION_CONFIG = {
|
||||
basic: {
|
||||
name: '基础版',
|
||||
modules: ['ai-qa', 'knowledge-base'], // 初始配置：基础版包含模块
|
||||
name: '蝓ｺ遑迚?,
|
||||
modules: ['ai-qa', 'knowledge-base'], // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>壼渕遑迚亥桁蜷ｫ讓｡蝮?
|
||||
},
|
||||
advanced: {
|
||||
name: '高级版',
|
||||
name: '鬮倡ｺｧ迚?,
|
||||
modules: [
|
||||
'ai-qa',
|
||||
'knowledge-base',
|
||||
@@ -235,7 +235,7 @@ const VERSION_CONFIG = {
|
||||
], // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>夐ｫ倡ｺｧ迚亥桁蜷ｫ讓｡蝮<EFBDA1>
|
||||
},
|
||||
premium: {
|
||||
name: '旗舰版',
|
||||
name: '譌苓芦迚?,
|
||||
modules: [
|
||||
'ai-qa',
|
||||
'knowledge-base',
|
||||
@@ -247,15 +247,15 @@ const VERSION_CONFIG = {
|
||||
},
|
||||
};
|
||||
|
||||
// 说明：
|
||||
// 1. 以上模块分配为初始方案，可根据实际业务需求调整
|
||||
// 隸ｴ譏趣ｼ?
|
||||
// 1. 莉･荳頑ｨ｡蝮怜<EFBFBD>驟堺ｸｺ蛻晏ｧ区婿譯茨ｼ悟庄譬ｹ謐ｮ螳樣刔荳壼苅髴豎りｰ<EFBFBD><EFBFBD>?
|
||||
// 2. 謾ｯ謖<EFBDAF>夊ｿ<E5A48A><EFBDBF>鄂ｮ譁<EFBDAE>ｻｶ菫ｮ謾ｹ<E8ACBE>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>
|
||||
// 3. 譖ｴ謗ｨ闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBDBD>御ｾｿ莠主ｮ樊慮隹<E685AE>紛
|
||||
```
|
||||
|
||||
### 譚<>剞謗ｧ蛻ｶ螳樒鴫
|
||||
|
||||
> **设计说明：** 权限控制采用配置驱动的方式，支持通过配置文件或后端API动态获取版本配置，便于后期灵活调整。
|
||||
> **隶ｾ隶｡隸ｴ譏趣ｼ?* 譚<>剞謗ｧ蛻ｶ驥<EFBDB6>畑驟咲ｽｮ鬩ｱ蜉ｨ逧<EFBDA8>婿蠑擾ｼ梧髪謖<E9ABAA>夊ｿ<E5A48A><EFBDBF>鄂ｮ譁<EFBDAE>ｻｶ謌門錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBDBD>御ｾｿ莠主錘譛溽<E8AD9B>豢ｻ隹<EFBDBB>紛縲?
|
||||
|
||||
```typescript
|
||||
// 譚<>剞謗ｧ蛻ｶHook
|
||||
@@ -266,7 +266,7 @@ export const usePermission = () => {
|
||||
// const allowedModules = VERSION_CONFIG[userVersion].modules;
|
||||
|
||||
// 譁ｹ蠑<EFBDB9>2<EFBFBD>壻ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿厄ｼ域耳闕撰ｼ梧髪謖∝ｮ樊慮隹<E685AE>紛<EFBFBD><E7B49B>
|
||||
const versionConfig = useVersionConfig(); // 从API获取最新配置
|
||||
const versionConfig = useVersionConfig(); // 莉拶PI闔ｷ蜿匁怙譁ｰ驟咲ｽ?
|
||||
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, // 返回当前版本配置，便于调试
|
||||
versionConfig, // 霑泌屓蠖灘燕迚域悽驟咲ｽｮ<EFBFBD>御ｾｿ莠手ｰ<EFBFBD>ｯ?
|
||||
};
|
||||
};
|
||||
```
|
||||
|
||||
### 版本配置动态获取（推荐方案）
|
||||
### 迚域悽驟咲ｽｮ蜉ｨ諤∬執蜿厄ｼ域耳闕先婿譯茨ｼ?
|
||||
|
||||
```typescript
|
||||
// src/framework/permission/useVersionConfig.ts
|
||||
@@ -311,16 +311,16 @@ export const useVersionConfig = () => {
|
||||
refetchOnWindowFocus: false,
|
||||
});
|
||||
|
||||
// 如果API请求失败，回退到本地配置
|
||||
// 螯よ棡API隸ｷ豎ょ､ｱ雍･<EFBFBD>悟屓騾蛻ｰ譛ｬ蝨ｰ驟咲ｽ?
|
||||
return data || VERSION_CONFIG;
|
||||
};
|
||||
```
|
||||
|
||||
**优势：**
|
||||
- ✅ 版本配置可在后端实时调整，无需前端发版
|
||||
- ✅ 支持A/B测试不同版本配置
|
||||
- ✅ 便于运营人员灵活调整产品策略
|
||||
- ✅ 前端有本地配置作为兜底方案，保证可用性
|
||||
**莨伜漢<EFBFBD>?*
|
||||
- 笨?迚域悽驟咲ｽｮ蜿ｯ蝨ｨ蜷守ｫｯ螳樊慮隹<E685AE>紛<EFBFBD>梧裏髴蜑咲ｫｯ蜿醍沿
|
||||
- 笨?謾ｯ謖、/B豬玖ｯ穂ｸ榊酔迚域悽驟咲ｽｮ
|
||||
- 笨?萓ｿ莠手ｿ占是莠ｺ蜻倡<E89CBB>豢ｻ隹<EFBDBB>紛莠ｧ蜩∫ｭ也払
|
||||
- 笨?蜑咲ｫｯ譛画悽蝨ｰ驟咲ｽｮ菴應ｸｺ蜈懷ｺ墓婿譯茨ｼ御ｿ晁ｯ∝庄逕ｨ諤?
|
||||
|
||||
### 霍ｯ逕ｱ螳亥梱
|
||||
|
||||
@@ -339,7 +339,7 @@ export const RouteGuard = ({ moduleId, children }) => {
|
||||
|
||||
---
|
||||
|
||||
## 🔌 模块独立性设计
|
||||
## <EFBFBD>伯 讓｡蝮礼峡遶区ｧ隶ｾ隶?
|
||||
|
||||
### 讓｡蝮玲ｳｨ蜀梧惻蛻ｶ
|
||||
|
||||
@@ -350,9 +350,9 @@ interface ModuleDefinition {
|
||||
name: string; // 讓｡蝮怜錐遘ｰ
|
||||
route: string; // 霍ｯ逕ｱ霍ｯ蠕<EFBDAF>
|
||||
icon?: ReactNode; // 蝗ｾ譬<EFBDBE>
|
||||
component: LazyComponent; // 懒加载组件
|
||||
component: LazyComponent; // 諛貞刈霓ｽ扈<EFBFBD>ｻ?
|
||||
sideNav?: SideNavConfig; // 蟾ｦ萓ｧ蟇ｼ闊ｪ驟咲ｽｮ
|
||||
version?: UserVersion[]; // 支持的版本
|
||||
version?: UserVersion[]; // 謾ｯ謖∫噪迚域<EFBFBD>?
|
||||
standalone?: boolean; // 譏ｯ蜷ｦ謾ｯ謖∫峡遶玖ｿ占｡<E58DA0>
|
||||
apiBaseUrl?: string; // 迢ｬ遶玖ｿ占｡梧慮逧БPI蝨ｰ蝮
|
||||
}
|
||||
@@ -366,7 +366,7 @@ const MODULES: ModuleDefinition[] = [
|
||||
component: lazy(() => import('@/modules/literature')),
|
||||
version: ['advanced', 'premium'],
|
||||
standalone: true, // 謾ｯ謖∫峡遶玖ｿ占｡<E58DA0>
|
||||
apiBaseUrl: process.env.LITERATURE_API_URL, // 可配置
|
||||
apiBaseUrl: process.env.LITERATURE_API_URL, // 蜿ｯ驟咲ｽ?
|
||||
},
|
||||
// ... 蜈ｶ莉匁ｨ｡蝮<EFBDA1>
|
||||
];
|
||||
@@ -375,7 +375,7 @@ const MODULES: ModuleDefinition[] = [
|
||||
### 迢ｬ遶矩Κ鄂ｲ謾ｯ謖<EFBDAF>
|
||||
|
||||
```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
|
||||
// 邇ｯ蠅<EFBDAF>序驥城<E9A9A5>鄂ｮ
|
||||
@@ -421,12 +421,12 @@ const getEnabledModules = () => {
|
||||
```
|
||||
MainLayout (荳ｻ蟶<EFBDBB>ｱ)
|
||||
笏懌楳笏 Header (鬘ｶ驛ｨ蟇ｼ闊ｪ)
|
||||
│ ├── Logo
|
||||
│ ├── TopNavigation (导航项)
|
||||
│ └── UserMenu (用户菜单)
|
||||
│
|
||||
笏? 笏懌楳笏 Logo
|
||||
笏? 笏懌楳笏 TopNavigation (蟇ｼ闊ｪ鬘?
|
||||
笏? 笏披楳笏 UserMenu (逕ｨ謌ｷ闖懷黒)
|
||||
笏?
|
||||
笏披楳笏 MainContent (荳ｻ蜀<EFBDBB>ｮｹ蛹ｺ)
|
||||
├── SideNavigation (左侧导航) - 可选
|
||||
笏懌楳笏 SideNavigation (蟾ｦ萓ｧ蟇ｼ闊ｪ) - 蜿ｯ騾?
|
||||
笏披楳笏 Content (蜀<>ｮｹ蛹ｺ蝓<EFBDBA>)
|
||||
笏披楳笏 ModuleLayout (讓｡蝮怜ｸ<E6809C>ｱ)
|
||||
```
|
||||
@@ -498,55 +498,55 @@ export const ModuleLayout = ({ module }: { module: ModuleDefinition }) => {
|
||||
}
|
||||
```
|
||||
|
||||
### 响应式设计
|
||||
### 蜩榊ｺ泌ｼ剰ｮｾ隶?
|
||||
|
||||
- **桌面端 (>1024px)**: 完整显示所有导航项
|
||||
- **平板端 (768-1024px)**: 显示前4个，其余折叠到"更多"菜单
|
||||
- **移动端 (<768px)**: 汉堡菜单 + 抽屉导航
|
||||
- **譯碁擇遶?(>1024px)**: 螳梧紛譏ｾ遉ｺ謇譛牙ｯｼ闊ｪ鬘ｹ
|
||||
- **蟷ｳ譚ｿ遶?(768-1024px)**: 譏ｾ遉ｺ蜑?荳ｪ<E88DB3>悟<EFBFBD>菴呎釜蜿<E9879C>蛻?譖ｴ螟<EFBDB4>"闖懷黒
|
||||
- **遘ｻ蜉ｨ遶?(<768px)**: 豎牙<EFBFBD>｡闖懷黒 + 謚ｽ螻牙ｯｼ闊ｪ
|
||||
|
||||
---
|
||||
|
||||
## <20>統 螳樊命隶｡蛻<EFBDA1>
|
||||
|
||||
### 第一阶段：框架搭建（Week 1）
|
||||
- [x] 创建新前端项目结构
|
||||
### 隨ｬ荳髦ｶ谿ｵ<EFBFBD>壽｡<EFBFBD>楔謳ｭ蟒ｺ<EFBFBD><EFBFBD>eek 1<EFBFBD>?
|
||||
- [x] 蛻帛ｻｺ譁ｰ蜑咲ｫｯ鬘ｹ逶ｮ扈捺<EFBFBD>?
|
||||
- [ ] 螳樒鴫鬘ｶ驛ｨ蟇ｼ闊ｪ扈<EFBDAA>ｻｶ
|
||||
- [ ] 螳樒鴫霍ｯ逕ｱ邉ｻ扈<EFBDBB>
|
||||
- [ ] 螳樒鴫譚<E9B4AB>剞謗ｧ蛻ｶ蝓ｺ遑
|
||||
- [ ] 螳樒鴫蝓ｺ遑蟶<C280>ｱ邉ｻ扈<EFBDBB>
|
||||
|
||||
### 第二阶段：模块集成（Week 2）
|
||||
### 隨ｬ莠碁亳谿ｵ<EFBFBD>壽ｨ｡蝮鈴寔謌撰ｼ<EFBFBD>eek 2<EFBFBD>?
|
||||
- [ ] 霑∫ｧｻAI髣ｮ遲疲ｨ｡蝮<EFBDA1>
|
||||
- [ ] 迁移知识库模块
|
||||
- [ ] 霑∫ｧｻ遏･隸<EFBFBD>ｺ捺ｨ｡蝮?
|
||||
- [ ] 螳樒鴫蜊<E9B4AB>菴肴ｨ｡蝮暦ｼ域匱閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ暦ｼ<E69AA6>
|
||||
- [ ] 螳悟埋譚<E59F8B>剞謗ｧ蛻ｶ
|
||||
|
||||
### 第三阶段：AI智能文献开发（Week 3+）
|
||||
### 隨ｬ荳蛾亳谿ｵ<EFBFBD>哂I譎ｺ閭ｽ譁<EFBFBD>鍵蠑蜿托ｼ<EFBFBD>eek 3+<EFBFBD>?
|
||||
- [ ] 蠑蜿羨I譎ｺ閭ｽ譁<EFBDBD>鍵讓｡蝮<EFBDA1>
|
||||
- [ ] 螳樒鴫讓｡蝮礼峡遶玖ｿ占｡梧髪謖<E9ABAA>
|
||||
- [ ] 完善文档和测试
|
||||
- [ ] 螳悟埋譁<EFBFBD>｡｣蜥梧ｵ玖ｯ?
|
||||
|
||||
---
|
||||
|
||||
## <20>売 譛ｪ譚･謇ｩ螻戊<E6888A>剔
|
||||
|
||||
### 1. 模块独立产品化
|
||||
### 1. 讓｡蝮礼峡遶倶ｺｧ蜩∝<EFBFBD>?
|
||||
- 謾ｯ謖<EFBDAF>夊ｿ<E5A48A>識蠅<E8AD98>序驥城<E9A9A5>鄂ｮ迢ｬ遶玖ｿ占｡<E58DA0>
|
||||
- 迢ｬ遶狗噪API蝨ｰ蝮驟咲ｽｮ
|
||||
- 独立的部署配置
|
||||
- 迢ｬ遶狗噪驛ｨ鄂ｲ驟咲ｽ?
|
||||
|
||||
### 2. 迚域悽譚<E682BD>剞邂｡逅<EFBDA1>
|
||||
- 蜷守ｫｯAPI謠蝉ｾ帷畑謌ｷ迚域悽菫｡諱ｯ
|
||||
- 版本配置完全可调整（无需改动代码）
|
||||
- 迚域悽驟咲ｽｮ螳悟<EFBFBD>蜿ｯ隹<EFBFBD>紛<EFBFBD>域裏髴謾ｹ蜉ｨ莉｣遐<EFBFBD>ｼ?
|
||||
- 謗ｨ闕蝉ｻ主錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBDBD>梧髪謖∝ｮ樊慮隹<E685AE>紛讓｡蝮怜<E89DAE>驟<EFBFBD>
|
||||
- 前端根据版本动态显示/隐藏模块
|
||||
- 蜑咲ｫｯ譬ｹ謐ｮ迚域悽蜉ｨ諤∵仞遉?髫占酪讓｡蝮<EFBDA1>
|
||||
- 謾ｯ謖∫沿譛ｬ蜊<EFBDAC>ｺｧ謠千､ｺ
|
||||
- 版本权限分配策略可随时根据业务需求调整
|
||||
- 迚域悽譚<EFBFBD>剞蛻<EFBFBD><EFBFBD>遲也払蜿ｯ髫乗慮譬ｹ謐ｮ荳壼苅髴豎りｰ<EFBFBD><EFBFBD>?
|
||||
|
||||
### 3. 新模块接入
|
||||
### 3. 譁ｰ讓｡蝮玲磁蜈?
|
||||
- 驕ｵ蠕ｪ讓｡蝮玲磁蜿｣隗<EFBDA3>激
|
||||
- 蝨ｨ驟咲ｽｮ譁<EFBDAE>ｻｶ荳ｭ豕ｨ蜀梧ｨ｡蝮<EFBDA1>
|
||||
- 自动集成到导航系统
|
||||
- 閾ｪ蜉ｨ髮<EFBFBD><EFBFBD>蛻ｰ蟇ｼ闊ｪ邉ｻ扈?
|
||||
|
||||
---
|
||||
|
||||
@@ -560,7 +560,7 @@ export const ModuleLayout = ({ module }: { module: ModuleDefinition }) => {
|
||||
|
||||
---
|
||||
|
||||
**文档版本：** v1.0
|
||||
**譁<EFBFBD>｡｣迚域悽<EFBFBD>?* v1.0
|
||||
**譛蜷取峩譁ｰ<E8AD81><EFBDB0>** 2025-10-29
|
||||
|
||||
|
||||
|
||||
@@ -1,23 +1,23 @@
|
||||
# 蟇ｼ闊ｪ扈捺桷隶ｾ隶｡譁<EFBDA1>｡｣
|
||||
|
||||
> **文档版本：** v1.0
|
||||
> **创建日期：** 2025-10-29
|
||||
> **维护者：** 前端开发团队
|
||||
> **譁<EFBFBD>｡｣迚域悽<EFBFBD>?* v1.0
|
||||
> **蛻帛ｻｺ譌･譛滂ｼ?* 2025-10-29
|
||||
> **扈ｴ謚､閠<EFBFBD>ｼ<EFBFBD>** 蜑咲ｫｯ蠑蜿大屬髦?
|
||||
> **譛蜷取峩譁ｰ<E8AD81><EFBDB0>** 2025-10-29
|
||||
|
||||
---
|
||||
|
||||
## <20>搭 譁<>｡｣隸ｴ譏<EFBDB4>
|
||||
|
||||
本文档详细说明AI科研平台的导航结构设计，包括顶部导航和左侧导航的设计规范。
|
||||
譛ｬ譁<EFBFBD>｡｣隸ｦ扈<EFBFBD>ｯｴ譏拶I遘醍<EFBFBD>泌ｹｳ蜿ｰ逧<EFBFBD>ｯｼ闊ｪ扈捺桷隶ｾ隶｡<EFBFBD>悟桁諡ｬ鬘ｶ驛ｨ蟇ｼ闊ｪ蜥悟ｷｦ萓ｧ蟇ｼ闊ｪ逧<EFBFBD>ｮｾ隶｡隗<EFBFBD>激縲?
|
||||
|
||||
> **重要提示：** 本文档中涉及的模块版本要求（`requiredVersion`）均为**初始配置**，可以根据业务需求随时调整。版本权限分配完全可配置，无需改动代码逻辑。
|
||||
> **驥崎ｦ∵署遉ｺ<EFBFBD>?* 譛ｬ譁<EFBDAC>｡｣荳ｭ豸牙所逧<E68980>ｨ｡蝮礼沿譛ｬ隕∵ｱゑｼ<E38291>requiredVersion`<60>牙插荳?*蛻晏ｧ矩<EFBDA7>鄂ｮ**<2A>悟庄莉･譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ隹<EFBDB6>紛縲ら沿譛ｬ譚<EFBDAC>剞蛻<E5899E><E89BBB>螳悟<E89EB3>蜿ｯ驟咲ｽｮ<EFBDBD>梧裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎代?
|
||||
|
||||
---
|
||||
|
||||
## <20>ｧｭ 鬘ｶ驛ｨ蟇ｼ闊ｪ隶ｾ隶｡
|
||||
|
||||
### 导航项配置
|
||||
### 蟇ｼ闊ｪ鬘ｹ驟咲ｽ?
|
||||
|
||||
```typescript
|
||||
// navigationConfig.ts
|
||||
@@ -26,15 +26,15 @@ export interface NavigationItem {
|
||||
label: string; // 譏ｾ遉ｺ蜷咲ｧｰ
|
||||
route: string; // 霍ｯ逕ｱ霍ｯ蠕<EFBDAF>
|
||||
icon?: ReactNode; // 蝗ｾ譬<EFBDBE>ｼ亥庄騾会ｼ<E4BC9A>
|
||||
requiredVersion?: UserVersion; // 最低版本要求（可配置，支持后期调整）
|
||||
requiredVersion?: UserVersion; // 譛菴守沿譛ｬ隕∵ｱゑｼ亥庄驟咲ｽｮ<EFBFBD>梧髪謖∝錘譛溯ｰ<EFBFBD>紛<EFBFBD>?
|
||||
standalone?: boolean; // 譏ｯ蜷ｦ謾ｯ謖∫峡遶玖ｿ占｡<E58DA0>
|
||||
}
|
||||
|
||||
/**
|
||||
* 鬘ｶ驛ｨ蟇ｼ闊ｪ驟咲ｽｮ
|
||||
*
|
||||
* ⚠️ 重要说明：
|
||||
* - requiredVersion 字段为初始配置，可根据业务需求随时调整
|
||||
* 笞<EFBFBD><EFBFBD><EFBFBD> 驥崎ｦ∬ｯｴ譏趣ｼ?
|
||||
* - requiredVersion 蟄玲ｮｵ荳ｺ蛻晏ｧ矩<EFBFBD>鄂ｮ<EFBFBD>悟庄譬ｹ謐ｮ荳壼苅髴豎る囂譌ｶ隹<EFBFBD><EFBFBD>?
|
||||
* - 謗ｨ闕宣夊ｿ<E5A48A>錘遶ｯAPI蜉ｨ諤∬執蜿也沿譛ｬ驟咲ｽｮ<EFBDBD>梧髪謖∝ｮ樊慮隹<E685AE>紛
|
||||
* - 菫ｮ謾ｹ迚域悽隕∵ｱよ裏髴謾ｹ蜉ｨ莉｣遐<EFBDA3>ｻ霎托ｼ悟宵髴譖ｴ譁ｰ驟咲ｽｮ蜊ｳ蜿ｯ
|
||||
*/
|
||||
@@ -49,12 +49,12 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
id: 'literature-platform',
|
||||
label: 'AI譎ｺ閭ｽ譁<EFBDBD>鍵',
|
||||
route: '/literature',
|
||||
requiredVersion: 'advanced', // 初始配置：高级版可用（可调整）
|
||||
requiredVersion: 'advanced', // 蛻晏ｧ矩<EFBFBD>鄂ｮ<EFBFBD>夐ｫ倡ｺｧ迚亥庄逕ｨ<EFBFBD>亥庄隹<EFBFBD>紛<EFBFBD>?
|
||||
standalone: true,
|
||||
},
|
||||
{
|
||||
id: 'knowledge-base',
|
||||
label: '知识库',
|
||||
label: '遏･隸<EFBFBD>ｺ?,
|
||||
route: '/knowledge-base',
|
||||
requiredVersion: 'basic', // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>壼渕遑迚亥庄逕ｨ<E98095>亥庄隹<E5BA84>紛<EFBFBD><E7B49B>
|
||||
},
|
||||
@@ -62,21 +62,21 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
id: 'data-cleaning',
|
||||
label: '譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBFBD>ｴ<EFBFBD>',
|
||||
route: '/data-cleaning',
|
||||
requiredVersion: 'advanced', // 初始配置：高级版可用（可调整）
|
||||
placeholder: true, // 占位，显示"开发中"
|
||||
requiredVersion: 'advanced', // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>夐ｫ倡ｺｧ迚亥庄逕ｨ<E98095>亥庄隹<E5BA84>紛<EFBFBD>?
|
||||
placeholder: true, // 蜊<>菴搾ｼ梧仞遉?蠑蜿台ｸｭ"
|
||||
},
|
||||
{
|
||||
id: 'statistical-analysis',
|
||||
label: '譎ｺ閭ｽ扈溯ｮ｡蛻<EFBFBD>梵',
|
||||
route: '/intelligent-analysis',
|
||||
requiredVersion: 'premium', // 初始配置：旗舰版可用（可调整）
|
||||
requiredVersion: 'premium', // 蛻晏ｧ矩<EFBDA7>鄂ｮ<E98482>壽覧闊ｰ迚亥庄逕ｨ<E98095>亥庄隹<E5BA84>紛<EFBFBD>?
|
||||
external: true, // 逕ｱJava蝗｢髦溷ｼ蜿托ｼ悟宵蛛夐｡ｶ驛ｨ蟇ｼ闊ｪ髮<EFBDAA><E9ABAE>
|
||||
},
|
||||
{
|
||||
id: 'statistical-tools',
|
||||
label: '扈溯ｮ｡蛻<EFBFBD>梵蟾･蜈ｷ',
|
||||
route: '/statistical-tools',
|
||||
requiredVersion: 'premium', // 初始配置：旗舰版可用（可调整）
|
||||
requiredVersion: 'premium', // 蛻晏ｧ矩<EFBFBD>鄂ｮ<EFBFBD>壽覧闊ｰ迚亥庄逕ｨ<EFBFBD>亥庄隹<EFBFBD>紛<EFBFBD>?
|
||||
external: true, // 逕ｱJava蝗｢髦溷ｼ蜿托ｼ悟宵蛛夐｡ｶ驛ｨ蟇ｼ闊ｪ髮<EFBDAA><E9ABAE>
|
||||
},
|
||||
];
|
||||
@@ -85,19 +85,19 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
### 鬘ｶ驛ｨ蟇ｼ闊ｪ蟶<EFBDAA>ｱ
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────────────┐
|
||||
│ [Logo] [AI问答] [AI智能文献] [知识库] [智能数据清洗] [智能统计分析] [统计分析工具] [用户名] [用户菜单▼] │
|
||||
└──────────────────────────────────────────────────────────────────────────┘
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏? [Logo] [AI髣ｮ遲脳 [AI譎ｺ閭ｽ譁<EFBDBD>鍵] [遏･隸<EFBDA5>ｺ転 [譎ｺ閭ｽ謨ｰ謐ｮ貂<EFBDAE>ｴ余 [譎ｺ閭ｽ扈溯ｮ｡蛻<EFBDA1>梵] [扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ] [逕ｨ謌ｷ蜷江 [逕ｨ謌ｷ闖懷黒笆ｼ] 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
160px 閾ｪ騾ょｺ泌ｮｽ蠎ｦ 200px
|
||||
```
|
||||
|
||||
### 隗<>ｧ芽ｮｾ隶｡隗<EFBDA1>激
|
||||
|
||||
#### 导航项样式
|
||||
- **正常状态**：`color: #4b5563`, `font-weight: 500`
|
||||
- **悬停状态**：`color: #0ea5e9`, `background: rgba(14, 165, 233, 0.1)`
|
||||
- **激活状态**：`color: #0ea5e9`, `font-weight: 600`, `border-bottom: 2px solid #0ea5e9`
|
||||
- **禁用状态**（无权限）：`color: #9ca3af`, `cursor: not-allowed`
|
||||
#### 蟇ｼ闊ｪ鬘ｹ譬ｷ蠑?
|
||||
- **豁｣蟶ｸ迥ｶ諤?*<2A>啻color: #4b5563`, `font-weight: 500`
|
||||
- **謔ｬ蛛懃憾諤?*<2A>啻color: #0ea5e9`, `background: rgba(14, 165, 233, 0.1)`
|
||||
- **豼豢ｻ迥ｶ諤?*<2A>啻color: #0ea5e9`, `font-weight: 600`, `border-bottom: 2px solid #0ea5e9`
|
||||
- **遖∫畑迥ｶ諤?*<2A>域裏譚<E8A38F>剞<EFBFBD>会ｼ啻color: #9ca3af`, `cursor: not-allowed`
|
||||
|
||||
#### 髣ｴ霍晁ｧ<E69981>激
|
||||
- 蟇ｼ闊ｪ鬘ｹ荵矩龍<E79FA9>啻16px` 豌ｴ蟷ｳ髣ｴ霍<EFBDB4>
|
||||
@@ -108,26 +108,26 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
|
||||
**菴咲ｽｮ**<EFBFBD>夐｡ｶ驛ｨ蟇ｼ闊ｪ譛蜿ｳ萓ｧ
|
||||
|
||||
**显示内容**：
|
||||
- 用户名（手机号脱敏显示，如：`186****8738`）
|
||||
**譏ｾ遉ｺ蜀<EFBFBD>ｮｹ**<EFBFBD>?
|
||||
- 逕ｨ謌ｷ蜷搾ｼ域焔譛ｺ蜿ｷ閼ｱ謨乗仞遉ｺ<EFBFBD>悟ｦゑｼ啻186****8738`<EFBFBD>?
|
||||
- 逕ｨ謌ｷ螟ｴ蜒<EFBDB4>/蝗ｾ譬<EFBDBE>ｼ育せ蜃ｻ隗ｦ蜿台ｸ区級闖懷黒<E687B7><E9BB92>
|
||||
|
||||
**下拉菜单选项**：
|
||||
**荳区級闖懷黒騾蛾｡ｹ**<EFBFBD>?
|
||||
```
|
||||
┌─────────────────────┐
|
||||
│ 个人中心 │
|
||||
│ 历史记录 │
|
||||
│ ──────────────── │
|
||||
│ 订阅管理 │
|
||||
│ 退出账号 │
|
||||
└─────────────────────┘
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏?荳ｪ莠ｺ荳ｭ蠢<EFBDAD> 笏?
|
||||
笏?蜴<>彰隶ｰ蠖<EFBDB0> 笏?
|
||||
笏?笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏 笏?
|
||||
笏?隶｢髦<EFBDA2>ｮ｡逅<EFBDA1> 笏?
|
||||
笏?騾蜃ｺ雍ｦ蜿? 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
```
|
||||
|
||||
**路由跳转**：
|
||||
- 个人中心 → `/user/profile`
|
||||
- 历史记录 → `/user/history`
|
||||
- 订阅管理 → `/user/subscription`
|
||||
- 退出账号 → 登出操作
|
||||
**霍ｯ逕ｱ霍ｳ霓ｬ**<EFBFBD>?
|
||||
- 荳ｪ莠ｺ荳ｭ蠢<EFBFBD> 竊?`/user/profile`
|
||||
- 蜴<EFBFBD>彰隶ｰ蠖<EFBFBD> 竊?`/user/history`
|
||||
- 隶｢髦<EFBFBD>ｮ｡逅<EFBFBD> 竊?`/user/subscription`
|
||||
- 騾蜃ｺ雍ｦ蜿?竊?逋ｻ蜃ｺ謫堺ｽ<E5A0BA>
|
||||
|
||||
---
|
||||
|
||||
@@ -135,27 +135,27 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
|
||||
### 隶ｾ隶｡蜴溷<E89CB4>
|
||||
|
||||
1. **按需显示**：只有进入具体模块后才显示左侧导航
|
||||
2. **模块独立**：每个模块有自己独立的左侧导航配置
|
||||
1. **謖蛾怙譏ｾ遉ｺ**<EFBFBD>壼宵譛芽ｿ帛<EFBFBD>蜈ｷ菴捺ｨ｡蝮怜錘謇肴仞遉ｺ蟾ｦ萓ｧ蟇ｼ闊?
|
||||
2. **讓｡蝮礼峡遶<EFBFBD>**<EFBFBD>壽ｯ丈ｸｪ讓｡蝮玲怏閾ｪ蟾ｱ迢ｬ遶狗噪蟾ｦ萓ｧ蟇ｼ闊ｪ驟咲ｽ?
|
||||
3. **螻らｺｧ貂<EFBDA7>匆**<EFBFBD>壽髪謖∽ｸ郤ｧ蜥御ｺ檎ｺｧ闖懷黒
|
||||
|
||||
### AI髣ｮ遲疲ｨ｡蝮怜ｷｦ萓ｧ蟇ｼ闊ｪ
|
||||
|
||||
**布局方式**：卡片式布局（不使用左侧导航）
|
||||
**蟶<EFBFBD>ｱ譁ｹ蠑<EFBFBD>**<EFBFBD>壼今迚<EFBFBD>ｼ丞ｸ<EFBFBD>ｱ<EFBFBD>井ｸ堺ｽｿ逕ｨ蟾ｦ萓ｧ蟇ｼ闊ｪ<EFBFBD>?
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ AI问答主界面 │
|
||||
│ ┌───────────────────────────────────┐ │
|
||||
│ │ 搜索框 + 提问按钮 │ │
|
||||
│ └───────────────────────────────────┘ │
|
||||
│ │
|
||||
│ 或选择一个智能体开始: │
|
||||
│ ┌────┐ ┌────┐ ┌────┐ ┌────┐ │
|
||||
│ │选题│ │PICO│ │研究│ │方法│ ... │
|
||||
│ │评价│ │梳理│ │方案│ │学 │ │
|
||||
│ └────┘ └────┘ └────┘ └────┘ │
|
||||
└─────────────────────────────────────────┘
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏? AI髣ｮ遲比ｸｻ逡碁<EFBFBD>? 笏?
|
||||
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||||
笏? 笏? 謳懃ｴ｢譯?+ 謠宣琉謖蛾聴 笏? 笏?
|
||||
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||||
笏? 笏?
|
||||
笏? 謌夜画叫荳荳ｪ譎ｺ閭ｽ菴灘ｼ蟋? 笏?
|
||||
笏? 笏娯楳笏笏笏笏?笏娯楳笏笏笏笏?笏娯楳笏笏笏笏?笏娯楳笏笏笏笏? 笏?
|
||||
笏? 笏る蛾｢倪<EFBDA2>?笏１ICO笏?笏ら<E7AC8F>皮ｩｶ笏<EFBDB6> 笏よ婿豕補狽 ... 笏?
|
||||
笏? 笏りｯ<E3828A>ｻｷ笏<EFBDB7> 笏よ｢ｳ逅<EFBDB3>狽 笏よ婿譯遺狽 笏ょｭｦ 笏? 笏?
|
||||
笏? 笏披楳笏笏笏笏?笏披楳笏笏笏笏?笏披楳笏笏笏笏?笏披楳笏笏笏笏? 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
```
|
||||
|
||||
### AI譎ｺ閭ｽ譁<EFBDBD>鍵讓｡蝮怜ｷｦ萓ｧ蟇ｼ闊ｪ
|
||||
@@ -170,7 +170,7 @@ const LITERATURE_SIDE_NAV = [
|
||||
},
|
||||
{
|
||||
id: 'search',
|
||||
label: '智能文献检索',
|
||||
label: '譎ｺ閭ｽ譁<EFBFBD>鍵譽邏?,
|
||||
route: '/literature/search',
|
||||
icon: '<EFBFBD>剥',
|
||||
},
|
||||
@@ -184,7 +184,7 @@ const LITERATURE_SIDE_NAV = [
|
||||
id: 'screening',
|
||||
label: '譬<EFBFBD>｢俶遭隕∝<EFBFBD>遲<EFBFBD>',
|
||||
route: '/literature/screening',
|
||||
icon: '✅',
|
||||
icon: '笨?,
|
||||
},
|
||||
{
|
||||
id: 'full-text',
|
||||
@@ -194,37 +194,37 @@ const LITERATURE_SIDE_NAV = [
|
||||
},
|
||||
{
|
||||
id: 'extraction',
|
||||
label: '全文解析与数据提取',
|
||||
label: '蜈ｨ譁<EFBFBD>ｧ｣譫蝉ｸ取焚謐ｮ謠仙<EFBFBD>?,
|
||||
route: '/literature/extraction',
|
||||
icon: '<EFBFBD>溌',
|
||||
},
|
||||
{
|
||||
id: 'analysis',
|
||||
label: '数据综合分析与报告',
|
||||
label: '謨ｰ謐ｮ扈ｼ蜷亥<EFBFBD>譫蝉ｸ取冠蜻?,
|
||||
route: '/literature/analysis',
|
||||
icon: '<27>投',
|
||||
},
|
||||
];
|
||||
```
|
||||
|
||||
**布局样式**：
|
||||
**蟶<EFBFBD>ｱ譬ｷ蠑<EFBFBD>**<EFBFBD>?
|
||||
- 螳ｽ蠎ｦ<E8A08E>啻200px`
|
||||
- 閭梧勹濶ｲ<E6BFB6>啻#f9fafb`
|
||||
- 豼豢ｻ鬘ｹ<E9AC98>啻background: #e0e7ff`, `border-left: 3px solid #4f46e5`
|
||||
|
||||
### 知识库模块左侧导航
|
||||
### 遏･隸<EFBFBD>ｺ捺ｨ｡蝮怜ｷｦ萓ｧ蟇ｼ闊?
|
||||
|
||||
```typescript
|
||||
const KNOWLEDGE_BASE_SIDE_NAV = [
|
||||
{
|
||||
id: 'list',
|
||||
label: '知识库列表',
|
||||
label: '遏･隸<EFBFBD>ｺ灘<EFBFBD>陦?,
|
||||
route: '/knowledge-base',
|
||||
icon: '<EFBFBD>答',
|
||||
},
|
||||
{
|
||||
id: 'create',
|
||||
label: '+ 新建知识库',
|
||||
label: '+ 譁ｰ蟒ｺ遏･隸<EFBFBD>ｺ?,
|
||||
route: '/knowledge-base/create',
|
||||
icon: '+',
|
||||
},
|
||||
@@ -233,23 +233,23 @@ const KNOWLEDGE_BASE_SIDE_NAV = [
|
||||
|
||||
### 譎ｺ閭ｽ扈溯ｮ｡蛻<EFBDA1>梵讓｡蝮暦ｼ亥､夜Κ讓｡蝮苓ｯｴ譏趣ｼ<E8B6A3>
|
||||
|
||||
**说明：** 智能统计分析模块由**Java团队**开发，采用**Java后端**技术栈。
|
||||
**我们的职责：** 仅在顶部导航中集成该模块的入口，点击后跳转到Java团队开发的页面。
|
||||
**设计规范：** 不需要我们设计左侧导航，Java团队已有自己的页面布局设计。
|
||||
**隸ｴ譏趣ｼ?* 譎ｺ閭ｽ扈溯ｮ｡蛻<EFBDA1>梵讓｡蝮礼<E89DAE>?*Java蝗｢髦<EFBDA2>**蠑蜿托ｼ碁㊦逕ｨ**Java蜷守ｫｯ**謚譛ｯ譬医?
|
||||
**謌台ｻｬ逧<EFBFBD>′雍｣<EFBFBD><EFBFBD>** 莉<>惠鬘ｶ驛ｨ蟇ｼ闊ｪ荳ｭ髮<EFBDAD><E9ABAE>隸･讓｡蝮礼噪蜈･蜿｣<E89CBF>檎せ蜃ｻ蜷手ｷｳ霓ｬ蛻ｰJava蝗｢髦溷ｼ蜿醍噪鬘ｵ髱｢縲?
|
||||
**隶ｾ隶｡隗<EFBFBD>激<EFBFBD>?* 荳埼怙隕∵<E99A95>莉ｬ隶ｾ隶｡蟾ｦ萓ｧ蟇ｼ闊ｪ<E9978A>繰ava蝗｢髦溷ｷｲ譛芽<E8AD9B>蟾ｱ逧<EFBDB1>｡ｵ髱｢蟶<EFBDA2>ｱ隶ｾ隶｡縲?
|
||||
|
||||
**集成方式：**
|
||||
- 顶部导航点击后，直接跳转到 `/intelligent-analysis` 路由
|
||||
**髮<EFBFBD><EFBFBD>譁ｹ蠑擾ｼ?*
|
||||
- 鬘ｶ驛ｨ蟇ｼ闊ｪ轤ｹ蜃ｻ蜷趣ｼ檎峩謗･霍ｳ霓ｬ蛻?`/intelligent-analysis` 霍ｯ逕ｱ
|
||||
- 隸･霍ｯ逕ｱ蜿ｯ閭ｽ謖<EFBDBD>髄迢ｬ遶狗噪Java蠎皮畑謌吠frame蠏悟<E8A08F>
|
||||
- 蜈ｷ菴馴寔謌先婿蠑城怙荳捌ava蝗｢髦溷刻蝠<E588BB>｡ｮ螳<EFBDAE>
|
||||
|
||||
### 扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ讓｡蝮暦ｼ亥､夜Κ讓｡蝮苓ｯｴ譏趣ｼ<E8B6A3>
|
||||
|
||||
**说明：** 统计分析工具模块由**Java团队**开发，采用**Java后端**技术栈。
|
||||
**我们的职责：** 仅在顶部导航中集成该模块的入口，点击后跳转到Java团队开发的页面。
|
||||
**设计规范：** 该模块**不是左侧导航设计**，Java团队有自己的页面布局（如顶部Tab导航等）。
|
||||
**隸ｴ譏趣ｼ?* 扈溯ｮ｡蛻<EFBDA1>梵蟾･蜈ｷ讓｡蝮礼<E89DAE>?*Java蝗｢髦<EFBDA2>**蠑蜿托ｼ碁㊦逕ｨ**Java蜷守ｫｯ**謚譛ｯ譬医?
|
||||
**謌台ｻｬ逧<EFBFBD>′雍｣<EFBFBD><EFBFBD>** 莉<>惠鬘ｶ驛ｨ蟇ｼ闊ｪ荳ｭ髮<EFBDAD><E9ABAE>隸･讓｡蝮礼噪蜈･蜿｣<E89CBF>檎せ蜃ｻ蜷手ｷｳ霓ｬ蛻ｰJava蝗｢髦溷ｼ蜿醍噪鬘ｵ髱｢縲?
|
||||
**隶ｾ隶｡隗<EFBFBD>激<EFBFBD>?* 隸･讓｡蝮?*荳肴弍蟾ｦ萓ｧ蟇ｼ闊ｪ隶ｾ隶｡**<EFBFBD>繰ava蝗｢髦滓怏閾ｪ蟾ｱ逧<EFBFBD>｡ｵ髱｢蟶<EFBFBD>ｱ<EFBFBD>亥ｦる｡ｶ驛ｨTab蟇ｼ闊ｪ遲会ｼ峨?
|
||||
|
||||
**集成方式：**
|
||||
- 顶部导航点击后，直接跳转到 `/statistical-tools` 路由
|
||||
**髮<EFBFBD><EFBFBD>譁ｹ蠑擾ｼ?*
|
||||
- 鬘ｶ驛ｨ蟇ｼ闊ｪ轤ｹ蜃ｻ蜷趣ｼ檎峩謗･霍ｳ霓ｬ蛻?`/statistical-tools` 霍ｯ逕ｱ
|
||||
- 隸･霍ｯ逕ｱ蜿ｯ閭ｽ謖<EFBDBD>髄迢ｬ遶狗噪Java蠎皮畑謌吠frame蠏悟<E8A08F>
|
||||
- 蜈ｷ菴馴寔謌先婿蠑城怙荳捌ava蝗｢髦溷刻蝠<E588BB>｡ｮ螳<EFBDAE>
|
||||
|
||||
@@ -260,9 +260,9 @@ const KNOWLEDGE_BASE_SIDE_NAV = [
|
||||
### 鬘ｶ驛ｨ蟇ｼ闊ｪ蛻<EFBDAA>困
|
||||
|
||||
```typescript
|
||||
// 点击顶部导航项
|
||||
// 轤ｹ蜃ｻ鬘ｶ驛ｨ蟇ｼ闊ｪ鬘?
|
||||
const handleNavClick = (item: NavigationItem) => {
|
||||
// 1. 检查权限
|
||||
// 1. 譽譟･譚<EFBFBD><EFBFBD>?
|
||||
if (!hasPermission(item.requiredVersion)) {
|
||||
showUpgradePrompt(item);
|
||||
return;
|
||||
@@ -274,10 +274,10 @@ const handleNavClick = (item: NavigationItem) => {
|
||||
return;
|
||||
}
|
||||
|
||||
// 3. 导航到目标路由
|
||||
// 3. 蟇ｼ闊ｪ蛻ｰ逶ｮ譬<EFBFBD>ｷｯ逕?
|
||||
navigate(item.route);
|
||||
|
||||
// 4. 更新激活状态
|
||||
// 4. 譖ｴ譁ｰ豼豢ｻ迥ｶ諤?
|
||||
setActiveNavItem(item.id);
|
||||
};
|
||||
```
|
||||
@@ -285,12 +285,12 @@ const handleNavClick = (item: NavigationItem) => {
|
||||
### 蟾ｦ萓ｧ蟇ｼ闊ｪ蛻<EFBDAA>困
|
||||
|
||||
```typescript
|
||||
// 点击左侧导航项
|
||||
// 轤ｹ蜃ｻ蟾ｦ萓ｧ蟇ｼ闊ｪ鬘?
|
||||
const handleSideNavClick = (item: SideNavItem) => {
|
||||
// 导航到目标路由（模块内部路由）
|
||||
// 蟇ｼ闊ｪ蛻ｰ逶ｮ譬<EFBFBD>ｷｯ逕ｱ<EFBFBD>域ｨ｡蝮怜<EFBFBD>驛ｨ霍ｯ逕ｱ<EFBFBD>?
|
||||
navigate(item.route);
|
||||
|
||||
// 更新激活状态
|
||||
// 譖ｴ譁ｰ豼豢ｻ迥ｶ諤?
|
||||
setActiveSideNavItem(item.id);
|
||||
};
|
||||
```
|
||||
@@ -300,24 +300,24 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
蟇ｹ莠取ｷｱ螻らｺｧ鬘ｵ髱｢<EFBFBD>悟ｻｺ隶ｮ豺ｻ蜉<EFBFBD>髱｢蛹<EFBFBD>ｱ大ｯｼ闊ｪ<EFBFBD><EFBFBD>
|
||||
|
||||
```
|
||||
首页 > AI智能文献 > 标题摘要初筛 > 审核工作台
|
||||
鬥夜｡ｵ > AI譎ｺ閭ｽ譁<EFBFBD>鍵 > 譬<>｢俶遭隕∝<E99A95>遲<EFBFBD> > 螳｡譬ｸ蟾･菴懷<E88FB4>?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 响应式设计
|
||||
## <EFBFBD>導 蜩榊ｺ泌ｼ剰ｮｾ隶?
|
||||
|
||||
### 桌面端 (>1024px)
|
||||
### 譯碁擇遶?(>1024px)
|
||||
- 螳梧紛譏ｾ遉ｺ謇譛蛾｡ｶ驛ｨ蟇ｼ闊ｪ鬘ｹ
|
||||
- 显示完整的左侧导航
|
||||
- 譏ｾ遉ｺ螳梧紛逧<EFBFBD>ｷｦ萓ｧ蟇ｼ闊?
|
||||
|
||||
### 平板端 (768-1024px)
|
||||
- 显示前4个顶部导航项
|
||||
### 蟷ｳ譚ｿ遶?(768-1024px)
|
||||
- 譏ｾ遉ｺ蜑?荳ｪ鬘ｶ驛ｨ蟇ｼ闊ｪ鬘ｹ
|
||||
- 蜈ｶ菴吝ｯｼ闊ｪ鬘ｹ謚伜匠蛻ｰ"譖ｴ螟<EFBDB4>"闖懷黒
|
||||
- 左侧导航可折叠为抽屉式
|
||||
- 蟾ｦ萓ｧ蟇ｼ闊ｪ蜿ｯ謚伜匠荳ｺ謚ｽ螻牙ｼ?
|
||||
|
||||
### 移动端 (<768px)
|
||||
- 顶部导航采用汉堡菜单（☰）
|
||||
### 遘ｻ蜉ｨ遶?(<768px)
|
||||
- 鬘ｶ驛ｨ蟇ｼ闊ｪ驥<EFBFBD>畑豎牙<EFBFBD>｡闖懷黒<EFBFBD>遺于<EFBFBD>?
|
||||
- 蟾ｦ萓ｧ蟇ｼ闊ｪ謾ｹ荳ｺ蠎暮ΚTab蟇ｼ闊ｪ謌匁歓螻牙ｼ<E78999>
|
||||
|
||||
---
|
||||
@@ -336,7 +336,7 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
--nav-text-active: #0ea5e9;
|
||||
--nav-active-border: #0ea5e9;
|
||||
|
||||
/* 侧边栏颜色 */
|
||||
/* 萓ｧ霎ｹ譬城｢懆<EFBFBD>?*/
|
||||
--sidebar-bg: #f9fafb;
|
||||
--sidebar-active-bg: #e0e7ff;
|
||||
--sidebar-active-border: #4f46e5;
|
||||
@@ -354,7 +354,7 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
|
||||
## <20>統 螳樊命貂<E591BD>黒
|
||||
|
||||
### 组件开发
|
||||
### 扈<EFBFBD>ｻｶ蠑蜿?
|
||||
- [ ] `TopNavigation.tsx` - 鬘ｶ驛ｨ蟇ｼ闊ｪ扈<EFBDAA>ｻｶ
|
||||
- [ ] `SideNavigation.tsx` - 蟾ｦ萓ｧ蟇ｼ闊ｪ扈<EFBDAA>ｻｶ
|
||||
- [ ] `UserMenu.tsx` - 逕ｨ謌ｷ闖懷黒扈<E9BB92>ｻｶ
|
||||
@@ -364,16 +364,16 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
### 驟咲ｽｮ譁<EFBDAE>ｻｶ
|
||||
- [ ] `navigationConfig.ts` - 蟇ｼ闊ｪ驟咲ｽｮ
|
||||
- [ ] `moduleNavConfig.ts` - 讓｡蝮怜ｯｼ闊ｪ驟咲ｽｮ
|
||||
- [ ] `versionConfig.ts` - 版本配置（本地配置，作为兜底）
|
||||
- [ ] `versionConfig.ts` - 迚域悽驟咲ｽｮ<EFBFBD>域悽蝨ｰ驟咲ｽｮ<EFBFBD>御ｽ應ｸｺ蜈懷ｺ包ｼ?
|
||||
- [ ] `useVersionConfig.ts` - 迚域悽驟咲ｽｮHook<6F>井ｻ拶PI蜉ｨ諤∬執蜿厄ｼ<E58E84>
|
||||
|
||||
### 譁<>｡｣
|
||||
- [ ] 更新本文档
|
||||
- [ ] 譖ｴ譁ｰ譛ｬ譁<EFBFBD>｡?
|
||||
- [ ] 郛門<E9839B>蟇ｼ闊ｪ扈<EFBDAA>ｻｶ菴ｿ逕ｨ譁<EFBDA8>｡｣
|
||||
|
||||
---
|
||||
|
||||
**文档版本：** v1.0
|
||||
**譁<EFBFBD>｡｣迚域悽<EFBFBD>?* v1.0
|
||||
**譛蜷取峩譁ｰ<E8AD81><EFBDB0>** 2025-10-29
|
||||
|
||||
|
||||
|
||||
@@ -2,32 +2,32 @@
|
||||
|
||||
## 📋 目录
|
||||
|
||||
本目录包含平台前端的架构设计文档。
|
||||
本目录包å<EFBFBD>«å¹³å<EFBFBD>°å‰<EFBFBD>端的架构设计文档ã€?
|
||||
|
||||
### 文档列表
|
||||
|
||||
- **[01-å‰<C3A5>端总体架构设计.md](./01-å‰<C3A5>端总体架构设计.md)** - å¹³å<C2B3>°çº§å‰<C3A5>端架构总体设计
|
||||
- **[02-导航结构设计.md](./02-导航结构设计.md)** - 顶部导航和左侧导航的详细设计
|
||||
- **[03-架构原型图.html](./03-架构原型图.html)** - 交互式前端架构原型图
|
||||
- **[03-架构原型å›?html](./03-架构原型å›?html)** - 交互å¼<C3A5>å‰<C3A5>端架构原型图
|
||||
|
||||
---
|
||||
|
||||
## 🎯 设计原则
|
||||
|
||||
### 1. 模块化设计
|
||||
- 每个功能模块独立开发、独立部署
|
||||
### 1. 模å<EFBFBD>—化设è®?
|
||||
- æ¯<EFBFBD>个功能模å<EFBFBD>—独立开å<EFBFBD>‘ã€<EFBFBD>独立部ç½?
|
||||
- 模å<C2A1>—é—´æ— ä¾<C3A4>赖关系，å<C592>¯ç‹¬ç«‹è¿<C3A8>è¡Œ
|
||||
- 支持模块独立产品化
|
||||
- 支æŒ<EFBFBD>模å<EFBFBD>—独立产å“<EFBFBD>åŒ?
|
||||
|
||||
### 2. æ<>ƒé™<C3A9>控制设计
|
||||
- 基于用户版本的权限控制
|
||||
- 灵活的功能模块开关机制
|
||||
- 版本配置可动态调整
|
||||
- 基于用户版本的æ<EFBFBD>ƒé™<EFBFBD>控åˆ?
|
||||
- ç<EFBFBD>µæ´»çš„功能模å<EFBFBD>—开关机åˆ?
|
||||
- 版本é…<EFBFBD>ç½®å<EFBFBD>¯åŠ¨æ€<EFBFBD>è°ƒæ•?
|
||||
|
||||
### 3. 可扩展性设计
|
||||
- 预留新模块接入接口
|
||||
### 3. å<EFBFBD>¯æ‰©å±•æ€§è®¾è®?
|
||||
- 预留新模å<EFBFBD>—接入接å<EFBFBD>?
|
||||
- æ<>’件化的模å<C2A1>—åŠ è½½æœºåˆ¶
|
||||
- 配置驱动的功能开关
|
||||
- é…<EFBFBD>置驱动的功能开å…?
|
||||
|
||||
---
|
||||
|
||||
@@ -38,7 +38,7 @@
|
||||
|
||||
---
|
||||
|
||||
**维护者：** 前端开发团队
|
||||
**维护者：** å‰<C3A5>端开å<E282AC>‘团é˜?
|
||||
**最å<E282AC>Žæ›´æ–°ï¼š** 2025-11-07
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user