HaHafeng
88cc049fb3
- Implement 5 core API endpoints (create task, get progress, get results, update decision, export Excel) - Add FulltextScreeningController with Zod validation (652 lines) - Implement ExcelExporter service with 4-sheet report generation (352 lines) - Register routes under /api/v1/asl/fulltext-screening - Create 31 REST Client test cases - Add automated integration test script - Fix PDF extraction fallback mechanism in LLM12FieldsService - Update API design documentation to v3.0 - Update development plan to v1.2 - Create Day 5 development record - Clean up temporary test files
230 lines
4.5 KiB
Markdown
230 lines
4.5 KiB
Markdown
# 【给新AI】ASL模块 - 5分钟快速上手
|
||
|
||
**当前时间**: 2025-11-18
|
||
**当前任务**: Week 2 前端UI开发
|
||
**阅读时间**: 3分钟
|
||
|
||
---
|
||
|
||
## 这是什么项目？
|
||
|
||
**AIclinicalresearch** = 医学文献AI筛选平台
|
||
|
||
**当前开发**: ASL模块（AI Smart Literature）- 帮助医生用AI筛选医学文献
|
||
|
||
---
|
||
|
||
## 当前进度
|
||
|
||
```
|
||
✅ Week 1: 后端完成（数据库+API+LLM筛选）
|
||
🔄 Week 2: 前端开发 ← 你现在在这里
|
||
⬜ Week 3: 批量筛选
|
||
⬜ Week 4: 测试上线
|
||
```
|
||
|
||
---
|
||
|
||
## Week 2 要做什么？
|
||
|
||
### 3个页面开发
|
||
|
||
**Day 1-2**: 项目管理
|
||
- 项目列表页
|
||
- 创建项目表单（含PICOS + 筛选风格选择）
|
||
|
||
**Day 3-4**: 文献导入
|
||
- Excel上传界面
|
||
- 文献预览表格
|
||
|
||
**Day 5**: 筛选结果展示 ⭐ **重点**
|
||
- 结果列表
|
||
- **显示两个模型的判断理由**（最重要！）
|
||
|
||
---
|
||
|
||
## 核心功能：双模型筛选
|
||
|
||
```
|
||
用户上传文献
|
||
↓
|
||
DeepSeek-V3 ────┐
|
||
├─→ 对比 → 最终决策
|
||
Qwen-Max ───────┘
|
||
|
||
一致 → 采纳
|
||
冲突 → 人工复核
|
||
```
|
||
|
||
**关键**: 前端必须显示**两个模型的完整理由**
|
||
|
||
---
|
||
|
||
## 技术栈
|
||
|
||
```
|
||
前端: React 18 + Ant Design 5 + TypeScript
|
||
后端: Fastify + Prisma + PostgreSQL
|
||
LLM: DeepSeek-V3 + Qwen-Max（已集成✅）
|
||
```
|
||
|
||
---
|
||
|
||
## 快速启动
|
||
|
||
```bash
|
||
# 1. 启动后端
|
||
cd backend && npm run dev
|
||
# → http://localhost:3001
|
||
|
||
# 2. 启动前端
|
||
cd frontend-v2 && npm run dev
|
||
# → http://localhost:5173
|
||
|
||
# 3. 测试API
|
||
curl http://localhost:3001/api/v1/asl/health
|
||
```
|
||
|
||
---
|
||
|
||
## 关键文档（只需看这3个）
|
||
|
||
1. **任务清单**: `docs/03-业务模块/ASL-AI智能文献/04-开发计划/03-任务分解.md`
|
||
- Week 2详细任务
|
||
|
||
2. **UI原型**: `docs/03-业务模块/ASL-AI智能文献/03-UI设计/AI智能文献-标题摘要初筛原型.html`
|
||
- 界面参考
|
||
|
||
3. **API文档**: `docs/03-业务模块/ASL-AI智能文献/02-技术设计/02-API设计规范.md`
|
||
- 接口调用
|
||
|
||
---
|
||
|
||
## API示例
|
||
|
||
### 创建项目
|
||
```typescript
|
||
POST /api/v1/asl/projects
|
||
{
|
||
"projectName": "卒中预防研究",
|
||
"picoCriteria": {
|
||
"population": "非心源性缺血性卒中患者",
|
||
"intervention": "抗血小板药物",
|
||
"comparison": "安慰剂",
|
||
"outcome": "卒中复发",
|
||
"studyDesign": "RCT"
|
||
},
|
||
"inclusionCriteria": "...",
|
||
"exclusionCriteria": "...",
|
||
"screeningConfig": {
|
||
"style": "lenient", // ← 筛选风格：lenient/standard/strict
|
||
"models": ["deepseek-chat", "qwen-max"]
|
||
}
|
||
}
|
||
```
|
||
|
||
### 获取筛选结果
|
||
```typescript
|
||
GET /api/v1/asl/projects/:id/results
|
||
|
||
Response:
|
||
{
|
||
"literatureId": "uuid",
|
||
"title": "...",
|
||
"finalDecision": "pending",
|
||
|
||
// ⭐ 两个模型的完整结果
|
||
"model1Result": {
|
||
"modelName": "DeepSeek-V3",
|
||
"conclusion": "exclude",
|
||
"confidence": 0.92,
|
||
"reason": "虽然P、I、S维度匹配，但对照组..." // ← 必须显示
|
||
},
|
||
"model2Result": {
|
||
"modelName": "Qwen-Max",
|
||
"conclusion": "include",
|
||
"confidence": 0.85,
|
||
"reason": "研究人群和干预措施匹配..." // ← 必须显示
|
||
},
|
||
|
||
"hasConflict": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Week 2 关键任务 ⭐
|
||
|
||
### 1. 筛选风格选择器
|
||
```jsx
|
||
<Radio.Group defaultValue="standard">
|
||
<Radio value="lenient">宽松模式（初筛）</Radio>
|
||
<Radio value="standard">标准模式</Radio>
|
||
<Radio value="strict">严格模式</Radio>
|
||
</Radio.Group>
|
||
```
|
||
|
||
### 2. 模型理由展示（最重要！）
|
||
```jsx
|
||
<Row gutter={16}>
|
||
<Col span={12}>
|
||
<Card title="🤖 DeepSeek-V3">
|
||
<Tag>{model1.conclusion}</Tag>
|
||
<p><strong>理由:</strong> {model1.reason}</p>
|
||
</Card>
|
||
</Col>
|
||
<Col span={12}>
|
||
<Card title="🤖 Qwen-Max">
|
||
<Tag>{model2.conclusion}</Tag>
|
||
<p><strong>理由:</strong> {model2.reason}</p>
|
||
</Card>
|
||
</Col>
|
||
</Row>
|
||
```
|
||
|
||
---
|
||
|
||
## 重要提醒
|
||
|
||
1. ✅ **后端已完成** - 10个API都可以直接调用
|
||
2. ✅ **三种Prompt已实现** - 后端支持style参数
|
||
3. ⭐ **理由展示是核心** - 用户强调必须看到AI思考过程
|
||
4. ⚠️ **JWT暂时绕过** - 使用测试用户（生产需修复）
|
||
|
||
---
|
||
|
||
## 成功标准
|
||
|
||
- [ ] 3个页面开发完成
|
||
- [ ] 用户可以选择筛选风格
|
||
- [ ] **两个模型的理由清晰展示**
|
||
- [ ] 冲突文献有明显标记
|
||
- [ ] UI符合Ant Design规范
|
||
|
||
---
|
||
|
||
## 需要帮助？
|
||
|
||
**详细交接文档**: `docs/03-业务模块/ASL-AI智能文献/00-新AI交接文档.md`
|
||
|
||
**系统总览**: `docs/00-系统总体设计/00-系统当前状态与开发指南.md`
|
||
|
||
---
|
||
|
||
**祝开发顺利！** 🚀
|
||
|
||
---
|
||
|
||
**文档版本**: v1.0 - 极简版
|
||
**用途**: 新AI 3分钟快速上手
|
||
**详细版本**: 见`00-新AI交接文档.md`
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|