refactor(asl): ASL frontend architecture refactoring with left navigation

- feat: Create ASLLayout component with 7-module left navigation - feat: Implement Title Screening Settings page with optimized PICOS layout - feat: Add placeholder pages for Workbench and Results - fix: Fix nested routing structure for React Router v6 - fix: Resolve Spin component warning in MainLayout - fix: Add QueryClientProvider to App.tsx - style: Optimize PICOS form layout (P+I left, C+O+S right) - style: Align Inclusion/Exclusion criteria side-by-side - docs: Add architecture refactoring and routing fix reports Ref: Week 2 Frontend Development Scope: ASL module MVP - Title Abstract Screening
2025-11-18 21:51:51 +08:00
parent e3e7e028e8
commit 3634933ece
213 changed files with 20054 additions and 442 deletions
--- a/docs/03-业务模块/ASL-AI智能文献/04-开发计划/03-任务分解.md
+++ b/docs/03-业务模块/ASL-AI智能文献/04-开发计划/03-任务分解.md
@@ -1,11 +1,12 @@
 # ASL 模块任务分解（To-do List）

-> **文档版本：** V3.0  
+> **文档版本：** V3.1  
 > **创建日期：** 2025-11-16  
 > **适用阶段：** MVP（标题摘要初筛）  
 > **预计周期：** 4 周  
-> **最后更新：** 2025-11-16  
-> **⭐ 重要：基于真实架构（Frontend-v2 + Backend + asl_schema）**
+> **最后更新：** 2025-11-18  
+> **⭐ 重要：基于真实架构（Frontend-v2 + Backend + asl_schema）**  
+> **📊 Week 1 进度：** ✅ 100% 完成（提前4天完成）

 ---

@@ -51,13 +52,18 @@

 ---

-## 🗓️ Week 1: 数据库Schema与后端API框架（Day 1-5）
+## 🗓️ Week 1: 数据库Schema与后端API框架（Day 1-5）✅ 已完成

-### Day 1: Prisma Schema 设计
+**完成日期**: 2025-11-18  
+**实际耗时**: 1天（提前4天）  
+**完成报告**: [Week 1完成报告](../05-开发记录/2025-11-18-Week1完成报告.md)  
+**API测试**: [ASL-API测试报告](../../../../backend/ASL-API-测试报告.md)
+
+### Day 1: Prisma Schema 设计 ✅

 #### 数据库任务

- [ ] **T1.1.1** 设计 asl_schema 表结构
+- [✅] **T1.1.1** 设计 asl_schema 表结构
  - 文件：`backend/prisma/schema.prisma`
  - 新增4个模型：
    - `AslScreeningProject`（筛选项目表）
@@ -74,68 +80,71 @@
  - 负责人：后端开发
  - 参考：`02-标题摘要初筛开发计划.md` Week 1 Day 1

- [ ] **T1.1.2** 在 User 模型中添加关联
+- [✅] **T1.1.2** 在 User 模型中添加关联
  ```prisma
  // backend/prisma/schema.prisma - User模型添加
  aslProjects AslScreeningProject[] @relation("AslProjects")
  ```
-  - 预计耗时：10 分钟
-  - 负责人：后端开发
+  - 实际耗时：5 分钟
+  - 完成人：AI Assistant

- [ ] **T1.1.3** 运行 Prisma 迁移
+- [✅] **T1.1.3** 运行 Prisma 迁移
  ```bash
  cd backend
-  npx prisma migrate dev --name add_asl_screening_tables
+  npx tsx scripts/create-asl-tables.ts  # 手动SQL创建
  ```
-  - 预计耗时：5 分钟
-  - 负责人：后端开发
+  - 实际耗时：10 分钟
+  - 完成人：AI Assistant

- [ ] **T1.1.4** 生成 Prisma Client
+- [✅] **T1.1.4** 生成 Prisma Client
  ```bash
  npx prisma generate
  ```
-  - 预计耗时：5 分钟
-  - 负责人：后端开发
+  - 实际耗时：3 分钟
+  - 完成人：AI Assistant

- [ ] **T1.1.5** 验证数据库表创建
-  - 使用 DBeaver 连接数据库
-  - 检查 asl_schema 下的4个表
-  - 检查索引和外键
-  - 预计耗时：15 分钟
-  - 负责人：后端开发
+- [✅] **T1.1.5** 验证数据库表创建
+  - 使用脚本验证数据库
+  - 检查 asl_schema 下的4个表 ✅
+  - 检查索引和外键 ✅
+  - 实际耗时：5 分钟
+  - 完成人：AI Assistant

-**Day 1 验收标准**：
+**Day 1 验收标准** ✅：
 - ✅ asl_schema 4张表创建成功
 - ✅ Prisma Client 生成无错误
 - ✅ 可查询 asl_schema 表

 ---

-### Day 2: 后端目录结构创建
+### Day 2: 后端目录结构创建 ✅

-> **⭐ 前置条件（2025-11-16 更新）**：平台已提供存储服务  
-> **说明**：存储抽象层已在平台级实现（`backend/src/common/storage/`），ASL模块可直接使用  
-> **参考文档**：[平台基础设施规划](../../../09-架构实施/04-平台基础设施规划.md)
+> **⭐ 前置条件（2025-11-17 更新）**：平台基础设施已完成实施 ✅  
+> **完成状态**：8个核心模块，100%测试通过  
+> **完成报告**：[平台基础设施实施完成报告](../../../08-项目管理/03-每周计划/2025-11-17-平台基础设施实施完成报告.md)  
+> **使用指南**：[backend/src/common/README.md](../../../../backend/src/common/README.md)

-#### 平台服务说明（ASL模块无需实现）
+#### 平台已提供的8个核心模块（ASL模块无需实现）

-**平台已提供以下服务**：
+**平台基础设施已完成（2025-11-17）**：

-| 服务 | 路径 | 使用方式 | 说明 |
-|------|------|---------|------|
-| 存储服务 | `common/storage/` | `import { storage } from '@/common/storage'` | 文件上传下载（本地/OSS） |
-| 日志系统 | `common/logging/` | `import { logger } from '@/common/logging'` | 标准化日志输出 |
-| 异步任务 | `common/jobs/` | `import { jobQueue } from '@/common/jobs'` | 长时间任务处理 |
-| 缓存服务 | `common/cache/` | `import { cache } from '@/common/cache'` | 分布式缓存 |
-| 数据库 | `config/database.ts` | `import { prisma } from '@/config/database'` | 全局Prisma实例 |
+| # | 服务 | 路径 | 使用方式 | 说明 |
+|---|------|------|---------|------|
+| 1 | 存储服务 | `common/storage/` | `import { storage } from '@/common/storage'` | 文件上传下载（本地/OSS切换） |
+| 2 | 日志系统 | `common/logging/` | `import { logger } from '@/common/logging'` | 结构化JSON日志 |
+| 3 | 缓存服务 | `common/cache/` | `import { cache } from '@/common/cache'` | 内存/Redis缓存 |
+| 4 | 异步任务 | `common/jobs/` | `import { jobQueue } from '@/common/jobs'` | 长时间任务处理 |
+| 5 | 健康检查 | `common/health/` | `import { registerHealthRoutes } from '@/common/health'` | SAE健康检查 |
+| 6 | 监控指标 | `common/monitoring/` | `import { Metrics } from '@/common/monitoring'` | 性能监控和告警 |
+| 7 | 数据库连接池 | `config/database.ts` | `import { prisma } from '@/config/database'` | 全局Prisma实例 |
+| 8 | 环境配置 | `config/env.ts` | `import { env } from '@/config/env'` | 统一配置管理 |

 **示例代码**：
 ```typescript
 // ASL模块直接使用平台服务
-import { storage } from '@/common/storage'
-import { logger } from '@/common/logging'
-import { jobQueue } from '@/common/jobs'
+import { storage, logger, cache, jobQueue } from '@/common'
 import { prisma } from '@/config/database'
+import { Metrics } from '@/common/monitoring'

 // 上传文件
 const url = await storage.upload('asl/literature/123.pdf', pdfBuffer)
@@ -143,15 +152,32 @@ const url = await storage.upload('asl/literature/123.pdf', pdfBuffer)
 // 记录日志
 logger.info('Literature uploaded', { projectId, url })

+// 缓存数据
+await cache.set(`project:${projectId}`, data, 3600)
+
 // 创建异步任务
 const job = await jobQueue.push('asl:screening', { projectId })
+
+// 记录监控指标
+Metrics.recordAPIResponseTime('POST', '/api/v1/asl/screening', 200, 150)
 ```

+**⚠️ 禁止的操作（必须遵守）**：
+
+| 禁止操作 | 正确做法 | 原因 |
+|---------|---------|------|
+| `fs.writeFileSync()` | 使用 `storage.upload()` | Serverless容器重启丢失文件 |
+| `new PrismaClient()` | 使用全局 `prisma` 实例 | 避免连接数暴增（已配置连接池） |
+| 硬编码配置 | 使用 `process.env` 或 `env` | 配置管理混乱 |
+| 同步处理LLM批量任务 | 使用 `jobQueue.push()` | 避免Serverless超时 |
+| 直接使用 `console.log()` | 使用 `logger.info()` | 日志格式标准化 |
+| 自己实现缓存逻辑 | 使用 `cache.set()` / `cache.get()` | 平台已提供分布式缓存 |
+
 ---

 #### 后端任务

- [ ] **T1.2.1** 创建 ASL 模块目录结构
+- [✅] **T1.2.1** 创建 ASL 模块目录结构
  ```bash
  cd backend/src/modules
  mkdir -p asl/{routes,controllers,services,schemas,types,utils}
@@ -180,7 +206,7 @@ const job = await jobQueue.push('asl:screening', { projectId })
  - 预计耗时：30 分钟
  - 负责人：后端开发

- [ ] **T1.2.5** 创建类型定义文件
+- [✅] **T1.2.5** 创建类型定义文件
  ```typescript
  // types/screening.types.ts
  export interface Literature { ... }
@@ -190,25 +216,31 @@ const job = await jobQueue.push('asl:screening', { projectId })
  - 预计耗时：30 分钟
  - 负责人：后端开发

-**Day 2 验收标准**：
- ✅ ASL 模块目录结构完整
+**Day 2 验收标准** ✅：
+- ✅ ASL 模块目录结构完整（5个子目录，9个文件）
 - ✅ 所有占位文件创建完成
- ✅ 可正常使用平台服务（storage/logger/prisma等）
+- ✅ **可正常使用平台服务（8个核心模块）**：
+  - ✅ `import { storage } from '@/common/storage'` 可用
+  - ✅ `import { logger } from '@/common/logging'` 可用
+  - ✅ `import { cache } from '@/common/cache'` 可用
+  - ✅ `import { jobQueue } from '@/common/jobs'` 可用
+  - ✅ `import { prisma } from '@/config/database'` 可用
+  - ✅ `import { Metrics } from '@/common/monitoring'` 可用

 ---

-### Day 3: 注册ASL路由
+### Day 3: 注册ASL路由 ✅

 #### 后端任务

- [ ] **T1.3.1** 实现 `routes/index.ts`
+- [✅] **T1.3.1** 实现 `routes/index.ts`
  - 注册所有API路由
  - 参考 `legacy/routes/` 的风格
  - 预计耗时：1 小时
  - 负责人：后端开发
  - 参考：`02-标题摘要初筛开发计划.md` Week 1 Day 2

- [ ] **T1.3.2** 在 `src/index.ts` 中注册ASL路由
+- [✅] **T1.3.2** 在 `src/index.ts` 中注册ASL路由
  ```typescript
  import { aslRoutes } from './modules/asl/routes/index.js'
  await app.register(aslRoutes, { prefix: '/api/v1/asl' })
@@ -217,7 +249,7 @@ const job = await jobQueue.push('asl:screening', { projectId })
  - 预计耗时：10 分钟
  - 负责人：后端开发

- [ ] **T1.3.3** 测试路由可访问性
+- [✅] **T1.3.3** 测试路由可访问性
  ```bash
  # 启动后端服务
  cd backend && npm run dev
@@ -227,18 +259,18 @@ const job = await jobQueue.push('asl:screening', { projectId })
  - 预计耗时：10 分钟
  - 负责人：后端开发

-**Day 3 验收标准**：
+**Day 3 验收标准** ✅：
 - ✅ 后端服务正常启动
- ✅ ASL路由注册成功
- ✅ API可访问（返回空数组或404）
+- ✅ ASL路由注册成功（/api/v1/asl）
+- ✅ API可访问（10个端点）

 ---

-### Day 4-5: 实现基础API
+### Day 4-5: 实现基础API ✅

 #### 后端任务

- [ ] **T1.4.1** 实现 `projectService.ts`
+- [✅] **T1.4.1** 实现 `projectService.ts`
  - `createProject(userId, data)` - 创建项目
  - `listProjects(userId)` - 获取项目列表
  - `getProject(projectId)` - 获取项目详情
@@ -246,7 +278,7 @@ const job = await jobQueue.push('asl:screening', { projectId })
  - 预计耗时：2 小时
  - 负责人：后端开发

- [ ] **T1.4.2** 实现 `projectController.ts`
+- [✅] **T1.4.2** 实现 `projectController.ts`
  - `createProject` - 控制器
  - `listProjects` - 控制器
  - `getProject` - 控制器
@@ -254,30 +286,31 @@ const job = await jobQueue.push('asl:screening', { projectId })
  - 预计耗时：1.5 小时
  - 负责人：后端开发

- [ ] **T1.4.3** 实现 `literatureService.ts`
+- [✅] **T1.4.3** 实现 `literatureService.ts`
  - `importBatch(projectId, literatures)` - 批量导入
  - `listLiteratures(projectId, page, pageSize)` - 分页查询
  - 去重逻辑（基于DOI和标题）
  - 预计耗时：2 小时
  - 负责人：后端开发

- [ ] **T1.4.4** 实现 `literatureController.ts`
+- [✅] **T1.4.4** 实现 `literatureController.ts`
  - `importLiteratures` - 导入控制器
  - `listLiteratures` - 列表控制器
  - Excel数据验证
  - 预计耗时：1.5 小时
  - 负责人：后端开发

- [ ] **T1.4.5** Postman 测试
+- [✅] **T1.4.5** API测试（完整测试脚本）
  - 创建 Postman 测试集合
  - 测试所有已实现的API
  - 预计耗时：1 小时
  - 负责人：后端开发

-**Day 4-5 验收标准**：
- ✅ 项目管理API可调用
- ✅ 文献导入API可调用
+**Day 4-5 验收标准** ✅：
+- ✅ 项目管理API可调用（5个接口）
+- ✅ 文献导入API可调用（4个接口）
 - ✅ 数据正确保存到 asl_schema
+- ✅ 所有测试通过（7/7 - 100%）

 ---

@@ -924,6 +957,166 @@ const job = await jobQueue.push('asl:screening', { projectId })

 ---

+---
+
+## 🚀 Phase 2: 智能Prompt生成模块（Week 5-7）
+
+> **前置条件**: MVP阶段（Week 1-4）完成  
+> **开发周期**: 3周  
+> **优先级**: P1（高级功能）  
+> **详细设计**: [智能Prompt生成模块开发计划](../02-技术设计/07-智能Prompt生成模块开发计划.md)
+
+### 核心目标
+
+**解决问题**: 消除AI与人类对边界情况的理解差异
+
+**核心流程**:
+```
+用户输入PICOS → AI分析边界情况 → 用户确认 → 生成自定义Prompt → 筛选
+```
+
+---
+
+### 🗓️ Week 5: 后端开发（Day 21-25）
+
+#### Day 21-22: PICOS分析服务
+
+- [ ] **T5.1.1** 创建Prompt配置数据表
+  - 文件：`backend/prisma/schema.prisma`
+  - 新增模型：`PromptConfiguration`
+  - 预计耗时：2小时
+
+- [ ] **T5.1.2** 实现PICOS分析服务
+  - 文件：`backend/src/modules/asl/services/picosAnalyzer.ts`
+  - 功能：调用LLM分析PICOS，生成边界问题
+  - 预计耗时：1天
+
+- [ ] **T5.1.3** API: 分析PICOS
+  - 路由：`POST /api/v1/asl/prompt/analyze`
+  - 预计耗时：3小时
+
+#### Day 23: Prompt生成服务
+
+- [ ] **T5.2.1** 实现Prompt生成逻辑
+  - 文件：`backend/src/modules/asl/services/promptGenerator.ts`
+  - 预计耗时：1天
+
+- [ ] **T5.2.2** API: 确认边界规则并生成Prompt
+  - 路由：`POST /api/v1/asl/prompt/confirm-rules`
+  - 预计耗时：2小时
+
+#### Day 24: Prompt保存与使用
+
+- [ ] **T5.3.1** API: 保存最终Prompt
+  - 路由：`POST /api/v1/asl/prompt/save`
+  - 预计耗时：3小时
+
+- [ ] **T5.3.2** 修改筛选服务支持自定义Prompt
+  - 新增参数：`customPromptOverride?: string`
+  - 预计耗时：2小时
+
+#### Day 25: 测试与优化
+
+- [ ] **T5.4.1** 单元测试
+  - 预计耗时：3小时
+
+- [ ] **T5.4.2** 集成测试
+  - 预计耗时：3小时
+
+---
+
+### 🗓️ Week 6: 前端开发（Day 26-30）
+
+#### Day 26: PICOS输入界面
+
+- [ ] **T6.1.1** 创建PICOS配置页面
+  - 路径：`/asl/projects/:id/prompt-config`
+  - 预计耗时：4小时
+
+- [ ] **T6.1.2** PICOS输入表单组件
+  - 7个输入字段
+  - 预计耗时：4小时
+
+#### Day 27-28: 用户确认界面
+
+- [ ] **T6.2.1** AI理解展示组件
+  - 显示必须纳入/排除的要素
+  - 预计耗时：1天
+
+- [ ] **T6.2.2** 边界问题确认组件
+  - 逐个确认边界问题
+  - 预计耗时：1天
+
+#### Day 29: Prompt编辑器
+
+- [ ] **T6.3.1** Prompt预览与编辑组件
+  - 支持用户编辑和保存
+  - 预计耗时：1天
+
+#### Day 30: 集成与测试
+
+- [ ] **T6.4.1** 完整流程集成
+  - 预计耗时：3小时
+
+- [ ] **T6.4.2** UI/UX优化
+  - 预计耗时：3小时
+
+---
+
+### 🗓️ Week 7: 优化与上线（Day 31-35）
+
+#### Day 31-32: 功能完善
+
+- [ ] **T7.1.1** Prompt模板管理
+  - 预计耗时：1天
+
+- [ ] **T7.1.2** 在筛选任务中使用自定义Prompt
+  - 预计耗时：4小时
+
+#### Day 33: 测试
+
+- [ ] **T7.2.1** 端到端测试
+  - 预计耗时：1天
+
+#### Day 34-35: 优化与上线
+
+- [ ] **T7.3.1** 性能优化
+  - 预计耗时：4小时
+
+- [ ] **T7.3.2** 用户文档
+  - 预计耗时：4小时
+
+- [ ] **T7.3.3** 上线部署
+  - 预计耗时：4小时
+
+---
+
+### Phase 2 验收标准
+
+- [ ] 用户可以输入PICOS和纳排标准
+- [ ] AI可以分析并生成5-8个边界问题
+- [ ] 用户可以确认每个边界问题的处理方式
+- [ ] 系统可以自动生成自定义Prompt
+- [ ] 用户可以编辑生成的Prompt
+- [ ] 筛选任务可以使用自定义Prompt
+- [ ] Prompt生成准确率 ≥ 90%
+
+---
+
+## 📊 完整进度跟踪
+
+| 阶段 | Week | 任务 | 状态 | 完成时间 |
+|------|------|------|------|----------|
+| **MVP** | Week 1 | 数据库+后端API | ✅ | 2025-11-18 |
+| **MVP** | Week 2 | 前端UI | ⬜ | - |
+| **MVP** | Week 3 | 批量筛选+高级功能 | ⬜ | - |
+| **MVP** | Week 4 | 测试+上线 | ⬜ | - |
+| **Phase 2** | Week 5 | 智能Prompt后端 | ⬜ | - |
+| **Phase 2** | Week 6 | 智能Prompt前端 | ⬜ | - |
+| **Phase 2** | Week 7 | 优化+上线 | ⬜ | - |
+
+---
+
 ## 📚 相关文档

 - [开发里程碑](./01-开发里程碑.md)
@@ -931,12 +1124,15 @@ const job = await jobQueue.push('asl:screening', { projectId })
 - [质量保障策略](../02-技术设计/06-质量保障与可追溯策略.md)
 - [技术选型](../02-技术设计/07-文献处理技术选型.md)
 - [API 设计规范](../02-技术设计/02-API设计规范.md)
+- [智能Prompt生成模块](../02-技术设计/07-智能Prompt生成模块开发计划.md) ⭐ **新增**
 - [前后端模块化架构设计-V2](../../../00-系统总体设计/前后端模块化架构设计-V2.md)
 - [Schema隔离架构设计](../../../09-架构实施/01-Schema隔离架构设计（10个）.md)

 ---

 **更新日志**：
+- 2025-11-18: V4.0 更新，整合智能Prompt生成模块（Phase 2: Week 5-7）
+- 2025-11-18: V3.1 更新，补充平台基础设施完成状态（8个核心模块，禁止操作清单）
 - 2025-11-16: V3.0 完全重写，基于真实架构（Frontend-v2 + Backend + asl_schema），详细到每个任务
 - 2025-11-16: V2.0 完全重写，详细到每个任务（预计耗时、负责人、验收标准）
 - 2025-10-29: V1.0 创建，初始占位符