Files

HaHafeng e3e7e028e8 feat(platform): Complete platform infrastructure implementation and verification

Platform Infrastructure - 8 Core Modules Completed:
- Storage Service (LocalAdapter + OSSAdapter stub)
- Logging System (Winston + JSON format)
- Cache Service (MemoryCache + Redis stub)
- Async Job Queue (MemoryQueue + DatabaseQueue stub)
- Health Check Endpoints (liveness/readiness/detailed)
- Database Connection Pool (with Serverless optimization)
- Environment Configuration Management
- Monitoring Metrics (DB connections/memory/API)

Key Features:
- Adapter Pattern for zero-code environment switching
- Full backward compatibility with legacy modules
- 100% test coverage (all 8 modules verified)
- Complete documentation (11 docs updated)

Technical Improvements:
- Fixed duplicate /health route registration issue
- Fixed TypeScript interface export (export type)
- Installed winston dependency
- Added structured logging with context support
- Implemented graceful shutdown for Serverless
- Added connection pool optimization for SAE

Documentation Updates:
- Platform infrastructure planning (04-骞冲彴鍩虹璁炬柦瑙勫垝.md)
- Implementation report (2025-11-17-骞冲彴鍩虹璁炬柦瀹炴柦瀹屾垚鎶ュ憡.md)
- Verification report (2025-11-17-骞冲彴鍩虹璁炬柦楠岃瘉鎶ュ憡.md)
- Git commit guidelines (06-Git鎻愪氦瑙勮寖.md) - Added commit frequency rules
- Updated 3 core architecture documents

Code Statistics:
- New code: 2,532 lines
- New files: 22
- Updated files: 130+
- Test pass rate: 100% (8/8 modules)

Deployment Readiness:
- Local environment: 鉁?Ready
- Cloud environment: 馃攧 Needs OSS/Redis dependencies

Next Steps:
- Ready to start ASL module development
- Can directly use storage/logger/cache/jobQueue

Tested: Local verification 100% passed
Related: #Platform-Infrastructure

2025-11-18 08:00:41 +08:00

18 KiB

Raw Blame History

下一阶段行动计划 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时，直接在统一架构下

核心原则：架构先行，一次到位 ⭐⭐⭐

为什么前端架构要优先？

✅ 避免ASL开发完后再重构前端
✅ 一开始就在统一框架下开发
✅ 其他模块（AIA、PKB、审稿）直接接入
✅ 导航、布局、路由一次到位

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配置（已完成）：

DeepSeek-V3 (直连) - 快速初筛 ✅
GPT-5-Pro (CloseAI) - 精准筛选 ✅
Claude-4.5 (CloseAI) - 冲突仲裁 ✅
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集成指南）：

// 策略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上午集中讨论和决策，不在本计划中详细展开。

🔗 相关文档

核心参考文档

架构设计：

LLM配置：

Schema设计：

数据库连接配置
Schema隔离架构设计（待创建）

🎯 下一步行动

立即开始（如果还没开始Week 1）

Week 1 Day 1：规划10个Schema架构
Week 1 Day 2：编写迁移脚本
Week 1 Day 3：执行Schema迁移

如果Week 1已完成

Week 2 Day 6上午：前端架构设计会议 ⭐⭐⭐
- 确定技术栈
- 设计模块注册机制
- 设计导航结构
Week 2 Day 6下午：开始实施前端架构
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 = 高效务实！ ⭐⭐⭐

18 KiB Raw Blame History Unescape Escape

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

💡 V2.2版核心调整

为什么调整？

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

📊 整体规划 - 四周四阶段

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

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

空Schema预留（7个）📋

Week 1详细任务

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

核心原则：架构先行，一次到位 ⭐⭐⭐

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

Day 6上午：前端架构设计 ⭐ 关键设计

Day 6下午-Day 7：前端架构实施

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

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

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

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

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

Day 1下午：ASL数据库设计

Day 2：ASL API和前端设计

Week 3 Day 3-5 + Week 4：ASL核心功能开发

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

Week 5-6：LLM网关重构 ⭐

Week 7+：其他模块

📊 V2.2版工作量总结

🎯 成功标准

Week 1成功标准

Week 2成功标准 ⭐⭐⭐

Week 3-4成功标准

Week 5+成功标准

💡 关键优势总结

V2.2版的核心优势 ⭐⭐⭐

📝 关于前端架构设计

Week 2 Day 6上午的重点 ⭐

🔗 相关文档

核心参考文档

🎯 下一步行动

立即开始（如果还没开始Week 1）

如果Week 1已完成

18 KiB

Raw Blame History