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
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user