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

> **计划周期：** 2025-11-07 至 2025-12-06（4周）  
> **核心目标：** 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隔离（3详细+7空）** | 10个Schema完成 | P0 ⭐⭐⭐ |
| **阶段2** | Week 2 | **前端统一架构 + 后端分层** ⭐ | 统一导航+模块插件化 | P0 ⭐⭐⭐ |
| **阶段3** | Week 3-4 | **ASL核心功能（4个LLM）** | 文献筛选完整流程 | P0 ⭐⭐⭐ |
| **阶段4** | Week 5+ | LLM网关统一 + 其他模块 | LLM网关+DC/RVW | P1 ⭐⭐ |

---

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

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

### 详细设计+迁移（3个）⭐

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

### 空Schema预留（7个）📋

**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更新（3个详细模型）+ 补充AIA/PKB数据库文档
- **Day 5：** 代码适配 + 补充AIA/PKB API文档 + Week 1总结

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

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

---

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

> **时间：** 2025-11-14 至 2025-11-20（7天）  
> **核心：** 建立统一前端导航框架，所有模块插件化接入  
> **目标：** 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测试（4个LLM）
- [ ] 规划Week 3详细任务

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

---

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

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

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

#### Day 1上午：4个LLM集成测试 ⭐

**任务：验证4个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：4模型智能筛选 ⭐⭐⭐**
- [ ] 双模型并行筛选（DeepSeek + GPT-5）
- [ ] 结果一致性判断
- [ ] 冲突时启用Claude仲裁
- [ ] 成本统计和优化

**功能4：筛选结果管理**
- [ ] 结果展示（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开发时，已有4个模型实践
- ✅ 有了具体使用场景，抽取更合理
- ✅ 避免过度设计

**任务：**
- [ ] 统一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全部创建（3详细+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**：规划10个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隔离（3详细+7空）- 架构基础
- ✅ **前端统一架构优先** - 避免返工 ⭐⭐⭐
- ✅ 后端代码分层 - 模块清晰
- ✅ ASL在统一框架下开发 - 高效开发
- ✅ 4个LLM已就绪（CloseAI配置完成）- 质量保证
- ✅ LLM网关延后到Week 5 - Just-in-time开发

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










