Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(asl): Update module and system status documentation

Browse Source 
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:
HaHafeng
2025-11-23 11:36:30 +08:00
parent e28617ab89
commit f240aa9236
2 changed files with 90 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
docs/00-系统总体设计/00-系统当前状态与开发指南.md
View File

@@ -1,13 +1,14 @@
# AI临床研究平台 - 系统当前状态与开发指南
> **版本：** V2.4.0
> **版本：** V2.5.0
> **创建日期：** 2025-11-17
> **更新日期：** 2025-11-18
> **更新日期：** 2025-11-23
> **适用对象：** 新开发人员、AI助手、技术决策者
> **阅读时间：** 20分钟
> **文档定位：** 系统真实状态 + 核心开发规范 ⭐ 必读
**📝 版本历史：**
- V2.5.0 (2025-11-23): 更新ASL模块状态（全文复筛后端完成，Day 2-5，2500+行代码）
- V2.4.0 (2025-11-18): 更新ASL模块状态（Week 1完成，4个表+10个API+双模型筛选）
- V2.3.1 (2025-11-18): 更新LLM模型支持（添加CloseAI集成说明）
- V2.3.0 (2025-11-17): 初始创建，基于平台基础设施完成后的真实状态
@@ -99,7 +100,7 @@ frontend-v2/src/
├── modules/ # 📦 业务模块（7个目录，6个已注册）
│ ├── aia/ # ✅ AI智能问答（占位）
│ │ └── index.tsx
│ ├── asl/ # 🚧 AI智能文献（Week 1后端完成✅，Week 2前端开发中）
│ ├── asl/ # 🚧 AI智能文献（标题摘要初筛完成✅，全文复筛后端完成✅，待前端）
│ │ └── index.tsx
│ ├── pkb/ # ✅ 个人知识库（占位）
│ │ └── index.tsx
@@ -137,7 +138,7 @@ frontend-v2/src/
- 1个预留（rvw - 稿件审查，未来开发）
- ✅ 模块注册表：6个模块已注册（moduleRegistry.ts）
- AI问答（aia）
- AI智能文献（asl）- Week 1后端完成✅，Week 2前端开发中
- AI智能文献（asl）- 标题摘要初筛完成✅，全文复筛后端完成✅，待前端开发
- 知识库（pkb）
- 智能数据清洗（dc）
- 智能统计分析（ssa）- Java团队
@@ -145,7 +146,7 @@ frontend-v2/src/
- 📋 预留模块：稿件审查（rvw）- 目录已创建，待添加到注册表
- ✅ 权限系统：3级版本控制（basic/advanced/premium）
- ✅ 错误边界：模块级错误隔离
- 🚧 模块开发：ASL模块Week 1完成✅，Week 2前端开发中
- 🚧 模块开发：ASL模块Day 2-5完成✅（全文复筛后端2500+行代码），Day 6-8待前端开发
---
@@ -223,12 +224,14 @@ backend/src/
│ └── jsonParser.ts
│
├── modules/ # 🌟 新模块开发区（标准化架构）
│ └── asl/ # 🚧 AI智能文献（Week 1完成✅）
│ ├── controllers/ # ✅ 项目、文献控制器
│ ├── services/ # ✅ LLM筛选服务（双模型+三种风格）
│ ├── routes/ # ✅ 10个API接口
│ └── asl/ # 🚧 AI智能文献（标题摘要初筛完成✅，全文复筛后端完成✅）
│ ├── controllers/ # ✅ 3个控制器（项目、文献、标题初筛、全文复筛）
│ ├── services/ # ✅ LLM筛选服务（双模型+三种风格+全文12字段）
│ ├── routes/ # ✅ 15个API接口（10个标题初筛 + 5个全文复筛）
│ ├── schemas/ # ✅ JSON Schema + Prompt生成
│ └── types/ # ✅ TypeScript类型定义
│ ├── types/ # ✅ TypeScript类型定义
│ ├── common/ # ✅ 全文复筛通用能力层（PDF、LLM、验证）
│ └── fulltext-screening/ # ✅ 全文复筛模块（Day 2-5完成，2500+行代码）
│
├── config/ # ⚙️ 配置层
│ ├── database.ts # ⭐ 数据库配置（Serverless连接池优化）
@@ -435,7 +438,7 @@ CLOSEAI_CLAUDE_BASE_URL=https://api.openai-proxy.org/anthropic
- ✅ Legacy模块：AIA/PKB/RVW 正常运行
- ✅ **平台基础设施：8个模块测试通过（100%）**
- ✅ 数据库连接：1/400（正常）
- ✅ ASL模块：Week 1完成（数据库+后端API+LLM筛选服务），Week 2前端开发中
- ✅ ASL模块：标题摘要初筛完成✅，全文复筛后端完成✅（Day 2-5，2500+行代码），待前端开发
---
@@ -449,11 +452,13 @@ CLOSEAI_CLAUDE_BASE_URL=https://api.openai-proxy.org/anthropic
✅ platform_schema -- 平台层：用户、角色、权限
✅ aia_schema -- AI问答：项目、对话、消息
✅ pkb_schema -- 知识库：文档、批处理、知识图谱
✅ asl_schema -- AI智能文献：4个表已创建（2025-11-18）
✅ asl_schema -- AI智能文献：6个表已创建（2025-11-23）
- screening_projects（筛选项目）
- literatures（文献条目）
- screening_results（筛选结果，含双模型理由）
- screening_tasks（筛选任务）
- literatures（文献条目，+13个全文字段）
- screening_results（标题摘要初筛结果）
- screening_tasks（标题摘要初筛任务）
- fulltext_screening_tasks（全文复筛任务）
- fulltext_screening_results（全文复筛结果，12字段）
📋 rvw_schema -- 稿件审查：预留
📋 dc_schema -- 数据清洗：预留
📋 admin_schema -- 运营管理：预留
@@ -538,7 +543,7 @@ MAX_INSTANCES=20 # SAE最大实例数
**⚠️ 注意：** 测试API仅用于开发验证，生产部署前需删除
### ASL模块API（标准化架构）⭐ **2025-11-18新增**
### ASL模块API（标准化架构）⭐ **2025-11-23更新**
**前缀：** `/api/v1/asl`
@@ -546,18 +551,28 @@ MAX_INSTANCES=20 # SAE最大实例数
|---------|------|------|------|
| 项目管理 | 5个 | CRUD项目（含PICOS、纳排标准、筛选风格） | ✅ 已测试 |
| 文献管理 | 4个 | 导入文献（JSON/Excel）、查询、删除 | ✅ 已测试 |
| 标题摘要初筛 | 4个 | 任务创建、进度查询、结果获取、人工复核 | ✅ 已测试 |
| **全文复筛（NEW）** | **5个** | **任务管理、进度、结果、决策、Excel导出** | **✅ 已完成** |
| 健康检查 | 1个 | 模块健康状态 | ✅ 已测试 |
**核心接口**:
```
# 项目与文献
POST /api/v1/asl/projects # 创建项目（含PICOS、筛选风格）
GET /api/v1/asl/projects # 项目列表
GET /api/v1/asl/projects/:id # 项目详情
POST /api/v1/asl/projects/:id/literatures/import-excel # 导入Excel文献
GET /api/v1/asl/projects/:id/literatures # 文献列表
# 全文复筛（Day 5新增）
POST /api/v1/asl/fulltext-screening/tasks # 创建任务
GET /api/v1/asl/fulltext-screening/tasks/:taskId/progress # 获取进度
GET /api/v1/asl/fulltext-screening/tasks/:taskId/results # 获取结果
PUT /api/v1/asl/fulltext-screening/results/:resultId/decision # 更新决策
GET /api/v1/asl/fulltext-screening/tasks/:taskId/export # 导出Excel
```
**测试报告**: `backend/ASL-API-测试报告.md` (7/10接口，100%通过)
**测试报告**:
- 标题摘要初筛: `backend/ASL-API-测试报告.md` (10/10接口，100%通过)
- 全文复筛: `backend/src/modules/asl/fulltext-screening/__tests__/` (31个测试用例)
### API文档