docs(asl): Update module and system status documentation
ASL Module Status Update (v1.2 -> v1.3): - Update development stage: backend completed (Day 2-5) - Add fulltext-screening backend structure (controllers, services, routes, tests) - Add 5 new API endpoints for fulltext screening - Update milestone: Day 4-5 completed (database + batch service + API) - Mark Day 6-8 as pending (frontend development) System Status Update (v2.4.0 -> v2.5.0): - Update ASL module progress across all sections - Update database schema: 4 tables -> 6 tables (add fulltext screening tables) - Update API endpoints: 10 -> 15 (add 5 fulltext screening APIs) - Update backend structure to include fulltext-screening module - Reflect 2500+ lines of code added in Day 2-5
This commit is contained in:
@@ -1,9 +1,9 @@
|
||||
# AI智能文献模块 - 当前状态与开发指南
|
||||
|
||||
> **文档版本:** v1.2
|
||||
> **文档版本:** v1.3
|
||||
> **创建日期:** 2025-11-21
|
||||
> **维护者:** AI智能文献开发团队
|
||||
> **最后更新:** 2025-11-23
|
||||
> **最后更新:** 2025-11-23 (Day 5完成后)
|
||||
> **文档目的:** 反映模块真实状态,帮助新开发人员快速上手
|
||||
|
||||
---
|
||||
@@ -26,12 +26,12 @@
|
||||
AI智能文献模块是一个基于大语言模型(LLM)的文献筛选系统,用于帮助研究人员根据PICOS标准自动筛选文献。
|
||||
|
||||
### 当前状态
|
||||
- **开发阶段**:🚧 标题摘要初筛MVP已完成,全文复筛开发中
|
||||
- **开发阶段**:🚧 标题摘要初筛MVP已完成,全文复筛后端已完成,待前端开发
|
||||
- **已完成功能**:
|
||||
- ✅ 标题摘要初筛(Title & Abstract Screening)
|
||||
- ✅ 全文复筛核心LLM服务(Day 2-3,后端)
|
||||
- ✅ 标题摘要初筛(Title & Abstract Screening)- 完整流程
|
||||
- ✅ 全文复筛后端(Day 2-5)- LLM服务 + API + Excel导出
|
||||
- **开发中功能**:
|
||||
- 🚧 全文复筛批处理与前端UI(Day 4-6)
|
||||
- 🚧 全文复筛前端UI(Day 6-8,预计2.5天)
|
||||
- **模型支持**:DeepSeek-V3 + Qwen-Max 双模型筛选
|
||||
- **部署状态**:✅ 本地开发环境运行正常
|
||||
|
||||
@@ -48,7 +48,7 @@ AI智能文献模块是一个基于大语言模型(LLM)的文献筛选系统
|
||||
- 初筛结果页面(混合方案)
|
||||
- Excel批量导出(云原生)
|
||||
|
||||
**全文复筛(开发中)**:
|
||||
**全文复筛(后端已完成,待前端开发)**:
|
||||
- ✅ 2025-11-22:**Day 2-3完成(LLM服务与验证系统)**
|
||||
- 提示词工程体系(System/User Prompt + JSON Schema)
|
||||
- PromptBuilder服务(动态Prompt组装)
|
||||
@@ -64,10 +64,25 @@ AI智能文献模块是一个基于大语言模型(LLM)的文献筛选系统
|
||||
- 创建 fulltext_screening_results 表
|
||||
- 手动SQL迁移脚本(安全执行,不影响其他模块)
|
||||
- 数据库迁移状态文档(详细记录Schema隔离情况)
|
||||
- 🚧 2025-11-23:**Day 4下午进行中(批处理服务)**
|
||||
- AsyncTaskService(异步任务管理)
|
||||
- FulltextScreeningService(批量处理逻辑)
|
||||
- API控制器(RESTful接口)
|
||||
- ✅ 2025-11-23:**Day 4下午完成(批处理服务)**
|
||||
- FulltextScreeningService(批量处理逻辑,716行)
|
||||
- 异步任务管理(后台处理LLM调用)
|
||||
- 并发控制(p-queue)
|
||||
- 进度跟踪和错误处理
|
||||
- ✅ 2025-11-23:**Day 5完成(后端API开发)**
|
||||
- FulltextScreeningController(5个核心API,652行)
|
||||
- ExcelExporter服务(4-Sheet报告生成,352行)
|
||||
- Zod参数验证
|
||||
- 路由注册(/api/v1/asl/fulltext-screening)
|
||||
- 31个REST Client测试用例
|
||||
- API文档更新到v3.0
|
||||
- PDF提取fallback机制
|
||||
- 🚧 2025-11-24:**Day 6-8待开发(前端UI)**
|
||||
- 4个核心页面(设置、进度、工作台、结果)
|
||||
- PDF上传和预览功能
|
||||
- 双模型判断对比UI
|
||||
- 实时进度监控(轮询机制)
|
||||
- 详细前端开发计划已制定
|
||||
|
||||
---
|
||||
|
||||
@@ -179,14 +194,26 @@ backend/src/modules/asl/
|
||||
│ └── index.ts
|
||||
│
|
||||
└── fulltext-screening/ # ✅ 全文复筛模块(NEW)
|
||||
└── prompts/ # 提示词体系
|
||||
├── system_prompt.md # System Prompt(6601字符)
|
||||
├── user_prompt_template.md # User Prompt模板(199行)
|
||||
├── json_schema.json # JSON Schema(12字段约束)
|
||||
└── cochrane_standards/ # Cochrane标准(MVP暂不加载)
|
||||
├── 随机化方法.md
|
||||
├── 盲法.md
|
||||
└── 结果完整性.md
|
||||
├── controllers/
|
||||
│ └── FulltextScreeningController.ts # 5个核心API(652行)
|
||||
├── services/
|
||||
│ ├── FulltextScreeningService.ts # 批处理服务(716行)
|
||||
│ └── ExcelExporter.ts # Excel导出服务(352行)
|
||||
├── routes/
|
||||
│ └── fulltext-screening.ts # 路由注册(73行)
|
||||
├── prompts/ # 提示词体系
|
||||
│ ├── system_prompt.md # System Prompt(6601字符)
|
||||
│ ├── user_prompt_template.md # User Prompt模板(199行)
|
||||
│ ├── json_schema.json # JSON Schema(12字段约束)
|
||||
│ └── cochrane_standards/ # Cochrane标准(MVP暂不加载)
|
||||
│ ├── 随机化方法.md
|
||||
│ ├── 盲法.md
|
||||
│ └── 结果完整性.md
|
||||
└── __tests__/ # 测试文件
|
||||
├── fulltext-screening-api.http # REST Client测试(31个用例)
|
||||
├── api-integration-test.ts # 自动化集成测试
|
||||
├── e2e-real-test.ts # 端到端测试(真实PDF)
|
||||
└── e2e-real-test-v2.ts # 端到端测试(简化版)
|
||||
|
||||
backend/prisma/
|
||||
└── schema.prisma # 数据库Schema定义
|
||||
@@ -224,7 +251,7 @@ GET /projects/:projectId/literatures # 获取文献列表
|
||||
DELETE /literatures/:literatureId # 删除文献
|
||||
```
|
||||
|
||||
### 筛选相关
|
||||
### 筛选相关(标题摘要初筛)
|
||||
```http
|
||||
GET /projects/:projectId/screening-task # 获取任务进度
|
||||
GET /projects/:projectId/screening-results # 获取筛选结果
|
||||
@@ -232,6 +259,15 @@ GET /screening-results/:resultId # 获取结果详情
|
||||
POST /screening-results/:resultId/review # 提交人工复核
|
||||
```
|
||||
|
||||
### 全文复筛(NEW - Day 5)
|
||||
```http
|
||||
POST /fulltext-screening/tasks # 创建全文复筛任务
|
||||
GET /fulltext-screening/tasks/:taskId/progress # 获取任务进度
|
||||
GET /fulltext-screening/tasks/:taskId/results # 获取任务结果
|
||||
PUT /fulltext-screening/results/:resultId/decision # 更新人工决策
|
||||
GET /fulltext-screening/tasks/:taskId/export # 导出Excel报告
|
||||
```
|
||||
|
||||
### 关键参数说明
|
||||
|
||||
#### 创建项目
|
||||
|
||||
Reference in New Issue
Block a user