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:
2025-11-23 11:36:30 +08:00
parent e28617ab89
commit f240aa9236
2 changed files with 90 additions and 39 deletions

View File

@@ -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导出
- **开发中功能**
- 🚧 全文复筛批处理与前端UIDay 4-6
- 🚧 全文复筛前端UIDay 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开发**
- FulltextScreeningController5个核心API652行
- 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 Prompt6601字符
├── user_prompt_template.md # User Prompt模板199行
├── json_schema.json # JSON Schema12字段约束
└── cochrane_standards/ # Cochrane标准MVP暂不加载
├── 随机化方法.md
├── 盲法.md
└── 结果完整性.md
── controllers/
── FulltextScreeningController.ts # 5个核心API652行
├── services/
├── FulltextScreeningService.ts # 批处理服务716行
└── ExcelExporter.ts # Excel导出服务352行
├── routes/
└── fulltext-screening.ts # 路由注册73行
├── prompts/ # 提示词体系
│ ├── system_prompt.md # System Prompt6601字符
│ ├── user_prompt_template.md # User Prompt模板199行
│ ├── json_schema.json # JSON Schema12字段约束
│ └── 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
```
### 关键参数说明
#### 创建项目