docs: complete documentation system (250+ files)

- 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
2025-11-16 15:43:55 +08:00
parent 0fe6821a89
commit e52020409c
173 changed files with 46227 additions and 11964 deletions
--- a/docs/08-项目管理/V2.2版本变化说明.md
+++ b/docs/08-项目管理/V2.2版本变化说明.md
@@ -0,0 +1,309 @@
+# V2.2版本变化说明
+
+> **版本：** V2.2（前端架构优先版）  
+> **发布日期：** 2025-11-09  
+> **核心变化：** 前端统一架构提前到Week 2 ⭐⭐⭐
+
+---
+
+## 📊 V2.2 vs V2.1 核心差异
+
+| 维度 | V2.1版 | V2.2版 ⭐ | 为什么调整？ |
+|------|-------|---------|------------|
+| **Week 2核心任务** | 后端分层 + LLM网关 | **前端统一架构 + 后端分层** | 架构先行，避免ASL开发后返工 ⭐⭐⭐ |
+| **前端架构时机** | 未明确 | **Week 2上半周完成** | ASL在统一框架下开发 |
+| **LLM网关开发** | Week 2完成 | **推迟到Week 5** | 现有调用已work，避免过度设计 |
+| **ASL开发环境** | 独立开发 | **统一架构下开发** | 不需要后期重构 |
+| **CloseAI配置** | 未提及 | **已完成** | 4个LLM可用（含GPT-5、Claude-4.5）|
+
+---
+
+## 🎯 V2.2版核心理念
+
+### 1. 架构先行 ⭐⭐⭐
+
+**问题：** V2.1版中，前端架构时机不明确
+- Week 3开发ASL时，前端还是散乱的
+- 开发完后再重构 → 大量返工
+
+**解决：** V2.2版将前端架构提前到Week 2
+- ✅ Week 2先建立统一布局和导航
+- ✅ 所有模块（AIA、PKB、审稿）插件化接入
+- ✅ Week 3开发ASL时，直接在统一框架下
+- ✅ 不需要后期重构
+
+### 2. Just-in-time开发 ⭐⭐
+
+**问题：** V2.1版Week 2就要开发LLM网关
+- 还没有实际使用场景
+- 容易过度设计
+
+**解决：** V2.2版推迟到Week 5
+- ✅ Week 3-4 ASL开发时，有了实际使用场景
+- ✅ Week 5抽取LLM网关更合理
+- ✅ 现有CloseAI配置已够用
+
+### 3. 聚焦核心价值 ⭐⭐
+
+**原则：**
+- Week 1: 数据架构基础 ✅
+- Week 2: **前端+后端架构统一** ⭐
+- Week 3-4: ASL核心功能 ⭐
+- Week 5+: 优化和扩展
+
+---
+
+## 📋 Week 2详细对比
+
+### V2.1版Week 2
+
+```
+Day 6-7: 后端代码分层
+Day 8-9: LLM网关开发
+Day 10: 验收
+
+问题：前端架构未涉及
+```
+
+### V2.2版Week 2 ⭐
+
+```
+Day 6-7（上半周）: 前端统一架构 ⭐⭐⭐
+  - Day 6上午: 前端架构设计（技术栈、模块化、导航）
+  - Day 6下午-7: 实施（Layout、模块注册、整合现有模块）
+
+Day 8-9（下半周）: 后端代码分层
+  - 三层目录结构
+  - 保留简单LLM调用（够用）
+
+Day 10: 验收 + Week 3准备
+
+优势：前端架构一次到位
+```
+
+---
+
+## 🎨 前端架构设计要点
+
+### Week 2 Day 6上午的核心任务
+
+**需要决策的问题：**
+
+1. **技术栈确认**
+   - UI组件库：Ant Design? Material-UI?
+   - 路由方案：React Router配置
+   - 状态管理：Redux? Zustand? 不用？
+   - 当前Vite构建工具是否需要调整？
+
+2. **统一布局设计**
+   - 顶部导航栏（Logo、模块切换、用户信息）
+   - 侧边菜单（收缩/展开、多级菜单）
+   - 主内容区
+   - 面包屑导航
+
+3. **模块插件化机制**
+   - 模块如何注册？
+   - 路由如何动态加载？
+   - 权限如何控制？
+   - 样式如何隔离？
+
+4. **导航结构**
+   - 一级导航：模块级（AIA、PKB、ASL等）
+   - 二级导航：功能级（项目、对话、筛选等）
+   - 响应式适配
+
+**设计原则：**
+- 简单易维护（单人开发）
+- 模块化清晰（支持独立开发）
+- 扩展性好（新模块快速接入）
+- 用户体验佳（统一交互风格）
+
+**说明：** 这些问题在Week 2 Day 6上午集中讨论决策，不在计划中详细展开。
+
+---
+
+## 🚀 4个LLM配置（新增）
+
+### V2.1版：只提到DeepSeek和Qwen
+
+### V2.2版：4个LLM完整配置 ⭐
+
+**已完成配置（CloseAI）：**
+
+1. **DeepSeek-V3** (直连)
+   - 用途：快速初筛，成本低
+   - 价格：¥0.001/1K tokens
+
+2. **GPT-5-Pro** (CloseAI代理) ⭐ 新增
+   - 用途：精准筛选，质量高
+   - 价格：¥0.10/1K tokens
+   - Model ID: `gpt-5-pro`
+
+3. **Claude-4.5-Sonnet** (CloseAI代理) ⭐ 新增
+   - 用途：冲突仲裁，结构化输出
+   - 价格：¥0.021/1K tokens
+   - Model ID: `claude-sonnet-4-5-20250929`
+
+4. **Qwen-Max** (备选)
+   - 用途：长文本处理，性价比高
+   - 价格：¥0.004/1K tokens
+
+**筛选策略：**
+- **双模型对比**（DeepSeek + GPT-5）- 推荐 ⭐
+- **三模型仲裁**（+Claude）- 冲突时启用
+- **成本优化**（80% DeepSeek，20% GPT-5）
+
+**配置文档：**
+- `02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md` ⭐
+- `07-运维文档/01-环境配置指南.md`
+- `backend/CLOSEAI-CONFIG.md`
+
+---
+
+## ✅ V2.2版优势总结
+
+### 核心优势 ⭐⭐⭐
+
+**1. 避免返工（最大价值）**
+```
+V2.1版流程：
+Week 2: 后端分层
+Week 3-4: ASL开发（前端散乱）
+Week 5: 发现需要重构前端 → 返工 ❌
+
+V2.2版流程：
+Week 2: 前端架构先完成
+Week 3-4: ASL直接在统一框架下开发
+Week 5: 继续扩展，不需要重构 ✅
+```
+
+**2. 开发效率提升**
+- Week 3开发ASL时，前端框架已就绪
+- 只需关注业务逻辑，不用考虑架构
+- 模块插件化，代码结构清晰
+
+**3. 质量保证**
+- 4个LLM已配置好（含GPT-5和Claude-4.5）
+- 统一的用户体验
+- 便于测试和维护
+
+**4. 灵活扩展**
+- 新模块直接插入统一框架
+- 不影响现有模块
+- 前端架构稳定
+
+---
+
+## 📝 关键决策记录
+
+### 决策1：前端架构提前到Week 2
+
+**背景：**
+- 用户反馈：前端各模块独立散乱，需要统一
+- ASL是重点模块，不应该在散乱架构下开发
+
+**决策：**
+- Week 2上半周优先完成前端统一架构
+- 建立模块插件化机制
+- ASL在统一框架下开发
+
+**收益：**
+- 避免ASL开发后重构
+- 提升开发效率
+- 保证用户体验一致性
+
+---
+
+### 决策2：LLM网关推迟到Week 5
+
+**背景：**
+- 现有DeepSeek和Qwen调用已work
+- CloseAI配置已完成（GPT-5、Claude-4.5可用）
+- Week 2时间有限，需要聚焦前端架构
+
+**决策：**
+- Week 2只保留简单LLM调用
+- Week 3-4 ASL开发时使用现有调用
+- Week 5有了实践经验，再统一抽取LLM网关
+
+**收益：**
+- 避免过度设计
+- 聚焦核心价值
+- Just-in-time开发
+
+---
+
+### 决策3：集成CloseAI（GPT-5和Claude-4.5）
+
+**背景：**
+- AI智能文献需要高质量的LLM
+- DeepSeek虽快但准确率85%
+- GPT-5和Claude-4.5准确率95%+
+
+**决策：**
+- 配置CloseAI代理（已完成）
+- 4个LLM组合使用
+- 双模型对比 + 三模型仲裁
+
+**收益：**
+- 文献筛选质量大幅提升
+- 成本可控（灵活策略）
+- 国内稳定访问
+
+---
+
+## 🎯 执行建议
+
+### 如果还没开始Week 1
+
+1. 按V2.2版执行
+2. Week 1重点：Schema隔离（3详细+7空）
+3. Week 2重点：**前端架构优先** ⭐⭐⭐
+
+### 如果Week 1已完成
+
+1. **立即启动Week 2前端架构设计**
+2. Day 6上午：前端架构设计会议 ⭐
+3. Day 6下午-7：实施前端统一架构
+4. Day 8-9：后端代码分层
+
+### 如果已经在开发ASL
+
+1. **暂停ASL开发**
+2. **补做前端统一架构**
+3. 将ASL重构到统一框架下
+4. 虽然会有一点返工，但长远更好
+
+---
+
+## 📚 相关文档
+
+**V2.2版完整计划：**
+- [下一阶段行动计划-V2.2-前端架构优先版.md](./下一阶段行动计划-V2.2-前端架构优先版.md) ⭐⭐⭐
+
+**前端架构参考：**
+- [前端总体架构设计](../01-平台基础层/06-前端架构/01-前端总体架构设计.md)
+- [导航结构设计](../01-平台基础层/06-前端架构/02-导航结构设计.md)
+
+**LLM配置参考：**
+- [CloseAI集成指南](../02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md) ⭐
+- [环境配置指南](../07-运维文档/01-环境配置指南.md)
+
+**V2.1版对比：**
+- [下一阶段行动计划-V2.1-务实版.md](./下一阶段行动计划-V2.1-务实版.md)
+
+---
+
+**更新日期：** 2025-11-09  
+**制定人：** AI助手  
+**核心理念：** 架构先行 + Just-in-time + 聚焦核心 = 高效务实！ ⭐⭐⭐
+
+
+
+
+
+
+
+
+
+