Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: complete documentation system (250+ files)

Browse Source 
- System architecture and design documentation
- Business module docs (ASL/AIA/PKB/RVW/DC/SSA/ST)
- ASL module complete design (quality assurance, tech selection)
- Platform layer and common capabilities docs
- Development standards and API specifications
- Deployment and operations guides
- Project management and milestone tracking
- Architecture implementation reports
- Documentation templates and guides
This commit is contained in:
HaHafeng
2025-11-16 15:43:55 +08:00
parent 0fe6821a89
commit e52020409c
173 changed files with 46227 additions and 11964 deletions
Download Patch File Download Diff File Expand all files Collapse all files

598
docs/08-项目管理/下一阶段行动计划-V2.2-前端架构优先版.md Normal file
View File

@@ -0,0 +1,598 @@
# 下一阶段行动计划 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 = 高效务实！** ⭐⭐⭐