# 下一阶段行动计划 V2.2 - 前端架构优先�?

> **计划周期�?* 2025-11-07 �?2025-12-06�?周）  
> **核心目标�?* Schema隔离 + **前端统一架构** + ASL核心功能  
> **制定时间�?* 2025-11-09  
> **版本�?* V2.2（前端架构优先版�? 
> **最后更新：** 2025-11-09

---

## 💡 V2.2版核心调�?

> **🎯 最大变化：前端统一架构提前到Week 2�?*

### 为什么调整？

**V2.1版问题：**
- Week 2只做后端分层 + LLM网关
- Week 3开发ASL时，前端还是散乱�?
- 开发完ASL后再重构前端 �?大量返工

**V2.2版优化：**
- �?Week 2先建立前端统一架构
- �?所有模块插件化接入，一次到�?
- �?Week 3开发ASL时，直接在统一框架�?
- �?LLM网关推迟到Week 5（现有调用已够用�?

---

## 🎯 V2.2 vs V2.1 关键差异

| 项目 | V2.1�?| **V2.2�?* �?| 原因 |
|------|-------|-------------|------|
| **Week 2重点** | 后端分层 + LLM网关 | **前端架构 + 后端分层** ⭐⭐�?| 架构先行，避免返�?|
| **前端架构** | 未明确时�?| **Week 2上半周完�?* �?| ASL在统一框架下开�?|
| **LLM网关** | Week 2开�?| **推迟到Week 5** �?| 现有调用已work |
| **CloseAI集成** | 未提�?| **已完成配�?* �?| 4个LLM可用 |
| **ASL开发环�?* | 独立开�?| **统一架构�?* �?| 避免后期重构 |

---

## 📊 整体规划 - 四周四阶�?

```
Week 1              Week 2                      Week 3-4           Week 5+
Schema隔离    �?  前端架构+后端分层    �?   ASL核心开�?  �?  LLM网关+其他模块
(3详细+7�?      (统一导航+插件�?         (在统一框架�?      (抽取统一网关)
```

| 阶段 | 时间 | 核心任务 | 交付成果 | 优先�?|
|------|------|---------|---------|--------|
| **阶段1** | Week 1 | **Schema隔离�?详细+7空）** | 10个Schema完成 | P0 ⭐⭐�?|
| **阶段2** | Week 2 | **前端统一架构 + 后端分层** �?| 统一导航+模块插件�?| P0 ⭐⭐�?|
| **阶段3** | Week 3-4 | **ASL核心功能�?个LLM�?* | 文献筛选完整流�?| P0 ⭐⭐�?|
| **阶段4** | Week 5+ | LLM网关统一 + 其他模块 | LLM网关+DC/RVW | P1 ⭐⭐ |

---

## 🚀 阶段1：Schema隔离（Week 1）✅ 保持不变

> **时间�?* 2025-11-07 �?2025-11-13�?天）  
> **策略�?* 3个详细迁�?+ 7个空Schema预留

### 详细设计+迁移�?个）�?

**1. platform_schema** - 平台基础（迁移users表）
**2. aia_schema** - AI智能问答（迁�?个表�?
**3. pkb_schema** - 个人知识库（迁移2个表�?

### 空Schema预留�?个）📋

**4. asl_schema** - AI智能文献（Week 3设计�?
**5. common_schema** - 通用能力
**6-10.** dc/rvw/admin/ssa/st_schema - 其他模块

### Week 1详细任务

- **Day 1-2�?* 3个Schema详细设计 + 7个空Schema创建SQL
- **Day 3�?* 执行迁移，验证功�?
- **Day 4�?* Prisma更新�?个详细模型）+ 补充AIA/PKB数据库文�?
- **Day 5�?* 代码适配 + 补充AIA/PKB API文档 + Week 1总结

**交付物：**
- �?10个Schema全部创建�?详细+7空）
- �?AIA和PKB完整文档（数据库+API�?
- �?现有功能正常运行

**详细参考：** 见V2.1版Week 1部分（完全相同）

---

## 🎨 阶段2：前端统一架构 + 后端分层（Week 2）⭐⭐⭐

> **时间�?* 2025-11-14 �?2025-11-20�?天）  
> **核心�?* 建立统一前端导航框架，所有模块插件化接入  
> **目标�?* Week 3开发ASL时，直接在统一架构�?

### 核心原则：架构先行，一次到�?⭐⭐�?

**为什么前端架构要优先�?*
1. �?避免ASL开发完后再重构前端
2. �?一开始就在统一框架下开�?
3. �?其他模块（AIA、PKB、审稿）直接接入
4. �?导航、布局、路由一次到�?

---

### Day 6-7（上半周）：前端统一架构 ⭐⭐�?核心任务

#### Day 6上午：前端架构设�?�?关键设计

**任务：前端架构整体设�?*
- [ ] 梳理前端架构需求和目标
- [ ] 确定前端技术栈和工具链
- [ ] 设计模块注册机制
- [ ] 设计统一导航和布局方案
- [ ] 编写前端架构设计文档

**需要解决的核心问题�?*

**1. 技术栈选择**
- UI组件库选择（Ant Design? Material-UI? 自研？）
- 路由方案（React Router配置�?
- 状态管理（Redux? Zustand? 不用？）
- 构建工具（当前Vite，是否需要调整？�?

**2. 统一布局设计**
- 顶部导航栏设计（Logo、模块切换、用户信息）
- 侧边菜单设计（模块内导航、收�?展开�?
- 面包屑设计（当前位置指示�?
- 主内容区布局

**3. 模块插件化机�?*
- 模块如何注册到主应用�?
- 模块路由如何动态加载？
- 模块权限如何控制�?
- 模块样式如何隔离�?

**4. 导航结构设计**
- 一级导航：模块级（AIA、PKB、ASL、审稿等�?
- 二级导航：功能级（项目管理、对话、文献筛选等�?
- 导航如何响应式适配�?

**输出文档�?*
- `01-平台基础�?06-前端架构/04-前端架构实施方案-V2.md`
- 更新：`01-平台基础�?06-前端架构/01-前端总体架构设计.md`
- 更新：`01-平台基础�?06-前端架构/02-导航结构设计.md`

**参考文档：**
- `01-平台基础�?06-前端架构/01-前端总体架构设计.md`（现有设计）
- `01-平台基础�?06-前端架构/02-导航结构设计.md`（现有导航）
- `01-平台基础�?06-前端架构/03-架构原型�?html`（原型参考）

**设计要点�?*
```
主要考虑�?
1. 简单易维护（单人开发）
2. 模块化清晰（支持独立开发）
3. 扩展性好（新模块快速接入）
4. 用户体验佳（统一的交互风格）
```

---

#### Day 6下午-Day 7：前端架构实�?

**任务1：创建统一布局框架**
- [ ] 创建 `frontend/src/layouts/MainLayout.tsx`
  - 顶部导航栏组�?
  - 侧边菜单组件
  - 主内容区
  - 面包屑导�?
- [ ] 创建 `frontend/src/components/TopNav.tsx`
- [ ] 创建 `frontend/src/components/SideMenu.tsx`

**任务2：实现模块注册机�?*
- [ ] 创建 `frontend/src/router/moduleRegistry.ts`
- [ ] 定义模块配置接口
- [ ] 实现动态路由加�?
- [ ] 实现模块权限控制

**任务3：整合现有模�?*
- [ ] 重构AIA模块接入统一导航（现有功能）
- [ ] 重构PKB模块接入统一导航（现有功能）
- [ ] 重构审稿模块接入统一导航（现有功能）

**任务4：为未来模块预留入口**
- [ ] ASL模块入口（占位符，显�?开发中"�?
- [ ] 数据清洗入口（占位符�?
- [ ] 统计分析入口（占位符�?
- [ ] 运营管理入口（占位符�?

**前端目录结构�?*
```
frontend/
├── src/
�?  ├── layouts/                    # 布局组件
�?  �?  └── MainLayout.tsx         # 统一布局：顶部导�?侧边�?
�?  ├── components/                # 通用组件
�?  �?  ├── TopNav.tsx             # 顶部导航�?
�?  �?  ├── SideMenu.tsx           # 侧边菜单
�?  �?  └── Breadcrumb.tsx         # 面包�?
�?  ├── router/                    # 路由管理
�?  �?  ├── index.tsx              # 主路由配�?
�?  �?  └── moduleRegistry.ts      # 模块注册中心
�?  ├── modules/                   # 模块化目�?
�?  �?  ├── aia/                   # AI智能问答（已有）
�?  �?  �?  ├── routes.tsx         # 模块路由
�?  �?  �?  ├── pages/             # 页面组件
�?  �?  �?  └── index.ts           # 模块导出
�?  �?  ├── pkb/                   # 个人知识库（已有�?
�?  �?  ├── review/                # 审稿系统（已有）
�?  �?  ├── asl/                   # AI智能文献（占位）
�?  �?  ├── dataClean/             # 数据清洗（占位）
�?  �?  ├── statistics/            # 统计分析（占位）
�?  �?  └── admin/                 # 运营管理（占位）
�?  └── App.tsx                    # 应用入口
```

**验收标准�?*
- [ ] �?统一布局创建完成
- [ ] �?3个现有模块成功接入统一导航
- [ ] �?模块切换流畅，路由正�?
- [ ] �?占位模块显示"开发中"状�?
- [ ] �?前端架构文档完善

---

### Day 8-9（下半周）：后端代码分层

**任务：建立三层代码结�?*
- [ ] 创建 platform/common/modules 三层目录
- [ ] 迁移现有代码到新结构
- [ ] 建立统一错误处理
- [ ] 建立统一日志系统

**后端目录结构�?*
```
backend/src/
├── platform/           # L1：平台基础�?
�?  ├── auth/          # 认证（JWT、Session�?
�?  ├── permissions/   # 权限管理（RBAC�?
�?  └── users/         # 用户服务
├── common/            # L2：通用能力�?
�?  ├── llm/           # LLM调用（保留简单实现）
�?  �?  ├── deepseek.ts
�?  �?  ├── closeai.ts  # �?GPT-5 + Claude-4.5
�?  �?  └── qwen.ts
�?  ├── files/         # 文件处理
�?  └── utils/         # 工具函数
└── modules/           # L3：业务模块层
    ├── aia/           # AI智能问答
    ├── pkb/           # 个人知识�?
    ├── review/        # 审稿系统
    └── asl/           # AI智能文献（准备目录）
```

**说明�?*
- LLM调用暂时保留简单实现（已够用）
- Week 5再统一抽取LLM网关
- CloseAI配置已完成，可直接使�?

**验收标准�?*
- [ ] �?三层目录结构清晰
- [ ] �?现有代码迁移完成
- [ ] �?统一错误处理和日志系�?
- [ ] �?现有功能无回�?

---

### Day 10（周末）：Week 2验收 + Week 3准备

**任务1：Week 2总体验收**
- [ ] 前端统一架构验收
- [ ] 后端代码分层验收
- [ ] 编写Week 2总结报告

**任务2：ASL准备工作**
- [ ] 阅读ASL需求文�?
- [ ] 准备CloseAI测试�?个LLM�?
- [ ] 规划Week 3详细任务

**Week 2交付物清单：**
- [ ] �?前端统一布局框架
- [ ] �?模块注册和动态路由机�?
- [ ] �?3个现有模块整合完�?
- [ ] �?后端三层代码结构
- [ ] �?前端架构设计文档
- [ ] �?ASL可以在统一框架下开始开�?

---

## 📚 阶段3：ASL核心功能开发（Week 3-4�?

> **时间�?* 2025-11-21 �?2025-12-04�?周）  
> **优势�?* 在统一前端架构下开发，4个LLM已配置好  
> **重点�?* 文献筛选核心功�?

### Week 3 Day 1-2：ASL详细设计

#### Day 1上午�?个LLM集成测试 �?

**任务：验�?个LLM可用�?*
- [ ] 测试DeepSeek-V3连接
- [ ] 测试GPT-5-Pro连接（CloseAI�?
- [ ] 测试Claude-4.5连接（CloseAI�?
- [ ] 测试Qwen-Max连接
- [ ] 编写LLM统一调用服务

**4个LLM配置（已完成）：**
1. **DeepSeek-V3** (直连) - 快速初�?�?
2. **GPT-5-Pro** (CloseAI) - 精准筛�?�?
3. **Claude-4.5** (CloseAI) - 冲突仲裁 �?
4. **Qwen-Max** (备�? - 长文本处�?�?

**参考文档：**
- `02-通用能力�?01-LLM大模型网�?03-CloseAI集成指南.md`

#### Day 1下午：ASL数据库设�?

**任务：设计asl_schema表结�?*
- [ ] 文献项目表（literature_projects�?
- [ ] PICO配置表（pico_configs�?
- [ ] 文献条目表（literature_items�?
  - 包含4个模型的筛选结果字�?
  - 共识决策字段
  - 成本统计字段
- [ ] 编写数据库设计文�?

**输出文档�?*
- `03-业务模块/ASL-AI智能文献/02-技术设�?01-数据库设�?md`

#### Day 2：ASL API和前端设�?

**任务1：API设计**
- [ ] 项目管理API
- [ ] 文献导入API
- [ ] 4模型筛选API
- [ ] 结果查询API

**任务2：前端页面设�?*
- [ ] �?`frontend/src/modules/asl/` 下设计页面结�?
- [ ] 自动接入统一导航（已有框架）
- [ ] 设计筛选结果展示（显示4个模型意见）

**输出文档�?*
- `03-业务模块/ASL-AI智能文献/02-技术设�?02-API设计规范.md`
- `03-业务模块/ASL-AI智能文献/02-技术设�?03-前端页面设计.md`

---

### Week 3 Day 3-5 + Week 4：ASL核心功能开�?

**功能1：文献项目管�?*
- [ ] 创建/编辑/删除项目
- [ ] PICO配置
- [ ] 项目列表展示

**功能2：文献导�?*
- [ ] CSV格式解析
- [ ] 批量导入
- [ ] 数据验证

**功能3�?模型智能筛�?⭐⭐�?*
- [ ] 双模型并行筛选（DeepSeek + GPT-5�?
- [ ] 结果一致性判�?
- [ ] 冲突时启用Claude仲裁
- [ ] 成本统计和优�?

**功能4：筛选结果管�?*
- [ ] 结果展示�?个模型对比）
- [ ] 共识度展�?
- [ ] 人工复核界面
- [ ] 导出功能

**筛选策略（参考CloseAI集成指南）：**
```typescript
// 策略1：双模型对比（推荐）�?
async screenWithTwoModels(literature) {
  const [deepseek, gpt5] = await Promise.all([
    llm.chat('deepseek', prompt),
    llm.chat('gpt5', prompt),
  ]);
  
  if (deepseek.decision === gpt5.decision) {
    return { consensus: 'high', decision: deepseek.decision };
  }
  
  // 启用Claude仲裁
  const claude = await llm.chat('claude', prompt);
  return resolveConflict([deepseek, gpt5, claude]);
}
```

**Week 4交付物：**
- [ ] �?ASL Phase 1完整功能
- [ ] �?4个LLM集成完成
- [ ] �?筛选结果对比展�?
- [ ] �?完整测试通过

---

## 🔧 阶段4：LLM网关统一 + 其他模块（Week 5+�?

> **时间�?* 2025-12-05 开�? 
> **策略�?* 有了多个模块实践，统一抽取LLM网关

### Week 5-6：LLM网关重构 �?

**为什么Week 5再做�?*
- �?Week 3-4 ASL开发时，已�?个模型实�?
- �?有了具体使用场景，抽取更合理
- �?避免过度设计

**任务�?*
- [ ] 统一LLM调用接口
- [ ] 版本分级（专业版/高级�?旗舰版）
- [ ] 配额管理和限�?
- [ ] Token计数和计�?
- [ ] 使用记录和监�?

**参考：**
- `02-通用能力�?01-LLM大模型网�?[AI对接] LLM网关快速上下文.md`

### Week 7+：其他模�?

- 数据清洗模块（DC�?
- 智能统计分析（SSA�?
- 统计分析工具（ST�?
- 运营管理（ADMIN�?

---

## 📊 V2.2版工作量总结

| 阶段 | 任务 | V2.1工作�?| V2.2工作�?| 变化 |
|------|------|-----------|-----------|------|
| Week 1 | Schema隔离 | 2�?| **2�?* | 不变 �?|
| Week 2 | 后端分层+LLM网关 | 2�?| **前端架构2�?后端分层1.5�?* | 调整 �?|
| Week 3-4 | ASL开�?| 2�?| **2�?*（但在统一框架下） | 优化 �?|
| Week 5+ | 其他模块 | - | **LLM网关+其他模块** | 延后 �?|

**总体工作量：** 4�?�?4周（不变�?
**关键优化�?* 前端架构提前，避免ASL开发后重构 ⭐⭐�?

---

## 🎯 成功标准

### Week 1成功标准
- [ ] �?10个Schema全部创建�?详细+7空）
- [ ] �?Platform/AIA/PKB数据100%迁移
- [ ] �?AIA和PKB文档完整

### Week 2成功标准 ⭐⭐�?
- [ ] �?**前端统一布局框架完成**
- [ ] �?**3个现有模块成功接入统一导航**
- [ ] �?**模块注册机制清晰**
- [ ] �?后端三层代码结构清晰
- [ ] �?ASL可以在统一框架下开始开�?

### Week 3-4成功标准
- [ ] �?ASL文献筛选功能完�?
- [ ] �?4个LLM集成成功（DeepSeek/GPT-5/Claude-4.5/Qwen�?
- [ ] �?双模型对�?三模型仲裁实�?
- [ ] �?筛选结果对比展示完�?

### Week 5+成功标准
- [ ] �?LLM网关统一调用接口
- [ ] �?配额管理和计费系�?
- [ ] �?其他模块逐步开�?

---

## 💡 关键优势总结

### V2.2版的核心优势 ⭐⭐�?

**1. 架构先行，避免返�?*
- 前端统一架构先完�?
- ASL在统一框架下开�?
- 不需要开发后再重�?

**2. 聚焦核心价�?*
- Week 1: 数据架构基础 �?
- Week 2: **前端+后端架构统一** �?
- Week 3-4: ASL核心功能 �?
- Week 5+: 优化和扩�?

**3. Just-in-time开�?*
- LLM网关：Week 5有实践再抽取
- 其他模块：按需逐步开�?
- 避免过度设计

**4. 4个LLM已就�?*
- DeepSeek-V3 �?
- GPT-5-Pro ✅（CloseAI�?
- Claude-4.5 ✅（CloseAI�?
- Qwen-Max �?

---

## 📝 关于前端架构设计

### Week 2 Day 6上午的重�?�?

**前端架构设计会议议题�?*

**1. 技术栈确认**
- UI组件库选择
- 路由方案
- 状态管理方�?
- 构建工具配置

**2. 布局设计**
- 顶部导航�?
- 侧边菜单
- 主内容区
- 面包�?

**3. 模块化机�?*
- 模块注册方式
- 路由动态加�?
- 权限控制
- 样式隔离

**4. 导航结构**
- 一级导航（模块级）
- 二级导航（功能级�?
- 响应式适配

**说明�?* 这些问题在Week 2 Day 6上午集中讨论和决策，不在本计划中详细展开�?

---

## 🔗 相关文档

### 核心参考文�?

**架构设计�?*
- [前端总体架构设计](../01-平台基础�?06-前端架构/01-前端总体架构设计.md)
- [导航结构设计](../01-平台基础�?06-前端架构/02-导航结构设计.md)
- [架构原型图](../01-平台基础�?06-前端架构/03-架构原型�?html)

**LLM配置�?*
- [CloseAI集成指南](../02-通用能力�?01-LLM大模型网�?03-CloseAI集成指南.md)
- [环境配置指南](../07-运维文档/01-环境配置指南.md)
- [环境变量配置模板](../07-运维文档/02-环境变量配置模板.md)

**Schema设计�?*
- [数据库连接配置](../09-架构实施/02-数据库连接配�?md)
- [Schema隔离架构设计](../09-架构实施/01-Schema隔离架构设计.md)（待创建�?

---

## 🎯 下一步行�?

### 立即开始（如果还没开始Week 1�?

1. **Week 1 Day 1**：规�?0个Schema架构
2. **Week 1 Day 2**：编写迁移脚�?
3. **Week 1 Day 3**：执行Schema迁移

### 如果Week 1已完�?

1. **Week 2 Day 6上午**：前端架构设计会�?⭐⭐�?
   - 确定技术栈
   - 设计模块注册机制
   - 设计导航结构
   
2. **Week 2 Day 6下午**：开始实施前端架�?

3. **Week 2 Day 8**：后端代码分�?

---

**制定人：** AI助手  
**版本�?* V2.2（前端架构优先版�? 
**最后更新：** 2025-11-09  
**核心策略�?* 
- �?Schema隔离�?详细+7空）- 架构基础
- �?**前端统一架构优先** - 避免返工 ⭐⭐�?
- �?后端代码分层 - 模块清晰
- �?ASL在统一框架下开�?- 高效开�?
- �?4个LLM已就绪（CloseAI配置完成�? 质量保证
- �?LLM网关延后到Week 5 - Just-in-time开�?

**核心理念：架构先�?+ 聚焦核心 + Just-in-time = 高效务实�?* ⭐⭐�?