# ASL模块开�?- 新AI交接文档

**日期**: 2025-11-18  
**当前阶段**: Week 2 - 前端UI开�? 
**阅读时间**: 5分钟

---

## 🎯 项目概述

### 这是什么项目？

**AIclinicalresearch** - 医学临床研究AI平台

一个覆盖医学研究全生命周期的AI辅助平台，包�?大业务模块�?*当前正在开发ASL模块**（AI智能文献筛选）�?

---

### 系统架构（三层）

```
┌─────────────────────────────────────────�?
�? 业务模块�?(Business Layer)              �?
�? - ASL (AI智能文献) �?当前开发中          �?
�? - AIA, PKB, DC, SSA, ST, RVW           �?
└─────────────────────────────────────────�?
           �?依赖
┌─────────────────────────────────────────�?
�? 能力�?(Capability Layer)                �?
�? - LLM Gateway (5个模型已集成) �?         �?
�? - Document Processing Engine            �?
�? - RAG Engine, ETL, Medical NLP          �?
└─────────────────────────────────────────�?
           �?依赖
┌─────────────────────────────────────────�?
�? 平台基础设施�?(Platform Layer)           �?
�? 8个核心模�?- 已完�?�?                  �?
�? Storage, Logging, Caching, Jobs, etc.  �?
└─────────────────────────────────────────�?
```

**关键特�?*:
- **Schema隔离**: 10个独立PostgreSQL Schema
- **模块�?*: 每个业务模块独立开发、部署、销�?
- **云原�?*: 优化Alibaba Cloud SAE部署

---

## 📍 当前状态（2025-11-18�?

### �?Week 1 已完成（提前4天）

**后端开�?* (100%):
- �?数据库Schema设计�?个表，asl_schema�?
- �?后端API框架�?0个接口）
- �?LLM双模型筛选服�?
- �?三种筛选风格（宽松/标准/严格�?
- �?JSON解析器修复（支持中文引号�?
- �?API测试完成�?/7通过�?

**核心成果**:
1. **双模型筛�?*: DeepSeek-V3 + Qwen-Max并行
2. **三种Prompt**: 宽松/标准/严格模式
3. **理由展示**: 保存两个模型的完整判断理�?
4. **冲突检�?*: 只检测conclusion冲突，不检测PICO差异

---

### �?Week 2 待开始（当前任务�?

**前端UI开�?* (0%):
- �?Day 1-2: 项目管理界面
- �?Day 3-4: 文献导入界面
- �?Day 5: 筛选结果展�?

---

## 🔧 技术栈

### 前端
- **框架**: React 18 + TypeScript
- **UI�?*: Ant Design 5
- **路由**: React Router v6
- **状�?*: React Query + Zustand
- **架构**: Frontend-v2（模块化注册�?

### 后端
- **框架**: Fastify + TypeScript
- **ORM**: Prisma
- **数据�?*: PostgreSQL (asl_schema)
- **LLM**: DeepSeek-V3, Qwen-Max, GPT-4o, Claude-4.5

### 已完成的平台服务（可直接使用�?
```typescript
import { logger } from '@/common/logging';        // 日志
import { storage } from '@/common/storage';       // 存储
import { cache } from '@/common/cache';           // 缓存
import { jobQueue } from '@/common/jobs';         // 异步任务
import { prisma } from '@/config/database';       // 数据�?
```

---

## 📂 关键目录结构

### 前端（待开发）
```
frontend-v2/src/modules/asl/
├── pages/                    # 页面组件
�?  ├── ProjectList/         # 项目列表�?�?Week 2 Day 1
�?  ├── ProjectDetail/       # 项目详情�?�?Week 2 Day 2
�?  ├── LiteratureImport/    # 文献导入�?�?Week 2 Day 3-4
�?  └── ScreeningResults/    # 筛选结果页 �?Week 2 Day 5
├── components/               # 通用组件
├── hooks/                    # 自定义Hooks
├── services/                 # API调用
├── types/                    # TypeScript类型
└── index.tsx                 # 模块入口
```

### 后端（已完成）✅
```
backend/src/modules/asl/
├── controllers/              # 控制�?�?
├── services/                 # 业务逻辑 �?
�?  └── llmScreeningService.ts  # 核心筛选服�?
├── routes/                   # 路由 �?
├── schemas/                  # JSON Schema + Prompt生成 �?
├── types/                    # 类型定义 �?
└── prompts/                  # 三种Prompt模板 �?
    ├── v1.1.0-lenient.txt   # 宽松模式
    ├── v1.1.0-standard.txt  # 标准模式
    └── v1.1.0-strict.txt    # 严格模式
```

---

## 🌟 核心功能说明

### 1. 双模型筛选机�?

**工作流程**:
```
1. 用户上传文献（Excel�?
2. 系统解析文献（标�?摘要�?
3. 并行调用两个LLM模型�?
   - DeepSeek-V3
   - Qwen-Max
4. 两个模型独立判断（include/exclude�?
5. 系统检测冲突（conclusion是否一致）
6. 返回结果�?
   - 一�?�?finalDecision = 模型结论
   - 冲突 �?finalDecision = pending（需人工复核�?
```

**重要**: 保存两个模型�?*完整理由**供用户查�?

---

### 2. 三种筛选风�?

| 风格 | 特点 | 使用场景 |
|------|------|----------|
| **宽松模式** | 宁可多纳入，不错�?| 初筛阶段 |
| **标准模式** | 平衡准确率和召回�?| 常规使用 |
| **严格模式** | 宁可错杀，保证质�?| 精筛阶段 |

**实现**: 已在后端实现，前端需添加选择�?

---

### 3. 数据模型（asl_schema�?

**4个核心表**:
```sql
screening_projects    -- 筛选项目（存PICOS、纳排标准）
literatures          -- 文献条目（标题、摘要、PDF链接�?
screening_results    -- 筛选结果（两个模型的判�?理由�?
screening_tasks      -- 筛选任务（批量任务进度跟踪�?
```

---

## 🎨 UI原型参�?

**位置**: `docs/03-业务模块/ASL-AI智能文献/03-UI设计/AI智能文献-标题摘要初筛原型.html`

**核心页面**:
1. **项目列表** - 显示所有筛选项�?
2. **项目详情** - PICOS标准、纳排标准、文献列�?
3. **文献导入** - Excel上传、预览、导�?
4. **筛选结�?* - 显示筛选结果、两个模型的理由、冲突标�?

---

## 📋 Week 2 开发任务（详细清单�?

### Day 1-2: 项目管理界面

**任务**:
- [ ] 创建项目列表页（`/asl/projects`�?
- [ ] 创建项目按钮 + 创建项目表单
  - 项目名称
  - PICOS标准�?个字段）
  - 纳入标准（文本域�?
  - 排除标准（文本域�?
  - **筛选风格选择**（Radio: 宽松/标准/严格）⭐
- [ ] 项目列表展示（Table�?
- [ ] 项目详情页（`/asl/projects/:id`�?

**API接口**（已完成�?
- `POST /api/v1/asl/projects` - 创建项目
- `GET /api/v1/asl/projects` - 获取项目列表
- `GET /api/v1/asl/projects/:id` - 获取项目详情

---

### Day 3-4: 文献导入界面

**任务**:
- [ ] 文献导入页（`/asl/projects/:id/import`�?
- [ ] Excel文件上传（Dragger�?
- [ ] 文献预览（Table�?
- [ ] 格式验证提示
- [ ] 确认导入按钮
- [ ] 导入进度提示

**API接口**（已完成�?
- `POST /api/v1/asl/projects/:id/literatures/import-json` - 导入文献
- `GET /api/v1/asl/projects/:id/literatures` - 获取文献列表

**Excel格式**:
```
必须字段: title, abstract
可选字�? pmid, authors, journal, publicationYear, doi
```

---

### Day 5: 筛选结果展�?�?**重点**

**任务**:
- [ ] 筛选结果列表页（`/asl/projects/:id/results`�?
- [ ] 结果筛选（全部/纳入/排除/待复核）
- [ ] 结果详情弹窗 �?**关键**
  - 文献信息（标题、摘要）
  - 最终决策（include/exclude/pending�?
  - **两个模型的完整结�?*�?
    - DeepSeek-V3：结�?+ 理由 + 置信�?
    - Qwen-Max：结�?+ 理由 + 置信�?
  - 冲突提示（如果两个模型不一致）
  - 人工复核按钮

**API接口**（已完成�?
- `GET /api/v1/asl/projects/:id/results` - 获取筛选结�?

**响应格式**:
```typescript
{
  literatureId: string;
  title: string;
  abstract: string;
  finalDecision: 'include' | 'exclude' | 'pending';
  
  // �?两个模型的详细结�?
  model1Result: {
    modelName: 'DeepSeek-V3';
    conclusion: 'exclude';
    confidence: 0.92;
    reason: '完整的排除理�?..';  // �?前端需显示
    judgment: { P: 'match', I: 'match', C: 'mismatch', S: 'match' };
  },
  model2Result: {
    modelName: 'Qwen-Max';
    conclusion: 'include';
    confidence: 0.85;
    reason: '完整的纳入理�?..';  // �?前端需显示
    judgment: { ... };
  },
  
  hasConflict: true;  // 两个模型不一�?
  conflictFields: ['conclusion'];
}
```

---

## 🔥 Week 2 开发重�?

### 1. 筛选风格选择�?�?

**位置**: 创建项目表单

```jsx
<Form.Item label="筛选风�? name="screeningStyle">
  <Radio.Group defaultValue="standard">
    <Radio.Button value="lenient">
      🔓 宽松模式
      <Tooltip title="初筛推荐，宁可多纳入">
        <QuestionCircleOutlined />
      </Tooltip>
    </Radio.Button>
    <Radio.Button value="standard">
      ⚖️ 标准模式
    </Radio.Button>
    <Radio.Button value="strict">
      🔒 严格模式
    </Radio.Button>
  </Radio.Group>
</Form.Item>
```

---

### 2. 两个模型理由展示 ⭐⭐�?**最重要**

**位置**: 筛选结果详情弹�?

```jsx
<Modal title="筛选详�? width={1000}>
  {/* 最终决�?*/}
  <Alert type={finalDecision === 'pending' ? 'warning' : 'success'}>
    <strong>最终决�?</strong> {finalDecision}
  </Alert>
  
  {/* 冲突提示 */}
  {hasConflict && (
    <Alert type="warning" showIcon style={{marginTop: 16}}>
      ⚠️ 两个模型判断不一致，建议人工复核
    </Alert>
  )}
  
  <Divider />
  
  {/* �?两个模型的详细结果（并排显示�?/}
  <Row gutter={16}>
    <Col span={12}>
      <Card title="🤖 DeepSeek-V3" size="small">
        <Descriptions column={1} size="small">
          <Descriptions.Item label="结论">
            <Tag color={model1.conclusion === 'include' ? 'green' : 'red'}>
              {model1.conclusion}
            </Tag>
          </Descriptions.Item>
          <Descriptions.Item label="置信�?>
            {(model1.confidence * 100).toFixed(0)}%
          </Descriptions.Item>
        </Descriptions>
        
        <Divider style={{margin: '12px 0'}} />
        
        <div>
          <strong>判断理由:</strong>
          <p style={{marginTop: 8, whiteSpace: 'pre-wrap'}}>
            {model1.reason}  {/* �?显示完整理由 */}
          </p>
        </div>
        
        <Divider style={{margin: '12px 0'}} />
        
        <Collapse ghost size="small">
          <Panel header="PICO维度详情" key="1">
            <Descriptions column={2} size="small">
              <Descriptions.Item label="P">{model1.judgment.P}</Descriptions.Item>
              <Descriptions.Item label="I">{model1.judgment.I}</Descriptions.Item>
              <Descriptions.Item label="C">{model1.judgment.C}</Descriptions.Item>
              <Descriptions.Item label="S">{model1.judgment.S}</Descriptions.Item>
            </Descriptions>
          </Panel>
        </Collapse>
      </Card>
    </Col>
    
    <Col span={12}>
      <Card title="🤖 Qwen-Max" size="small">
        {/* 同上，显示model2的结�?*/}
      </Card>
    </Col>
  </Row>
  
  {/* 人工复核按钮 */}
  <div style={{marginTop: 16, textAlign: 'center'}}>
    <Button type="primary" onClick={handleManualReview}>
      人工复核此文�?
    </Button>
  </div>
</Modal>
```

**为什么这么重要？**
- 用户需要看到AI的思考过�?
- 当两个模型冲突时，用户需要对比理由来做决�?
- 即使人类专家也可能犯错，理由帮助验证

---

## 📚 重要文档索引

### 必读文档（开发前�?
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接口文档

### 参考文档（需要时查阅�?
1. **系统架构**: `docs/00-系统总体设计/00-系统当前状态与开发指�?md`
2. **前端模块�?*: `docs/00-系统总体设计/前后端模块化架构设计-V2.md`
3. **数据库设�?*: `docs/03-业务模块/ASL-AI智能文献/02-技术设�?01-数据库设�?md`

---

## 🚀 快速启�?

### 1. 启动后端（已完成�?
```bash
cd backend
npm run dev
# 后端运行�?http://localhost:3001
# API前缀: /api/v1/asl
```

### 2. 启动前端（待开发）
```bash
cd frontend-v2
npm run dev
# 前端运行�?http://localhost:5173
```

### 3. 测试API
```bash
# 健康检�?
curl http://localhost:3001/api/v1/asl/health

# 获取项目列表
curl http://localhost:3001/api/v1/asl/projects
```

---

## ⚠️ 重要注意事项

### 1. 临时测试模式
**JWT认证暂时绕过**，使用默认测试用户：
```typescript
const userId = requestBody.userId || 'asl-test-user-001';
```

**生产环境需�?*: 实现真实的JWT认证

---

### 2. 筛选风格参�?
创建项目时，记得传递筛选风格：
```typescript
const projectData = {
  projectName: '...',
  picoCriteria: { ... },
  inclusionCriteria: '...',
  exclusionCriteria: '...',
  screeningConfig: {
    style: 'lenient',  // �?筛选风�?
    models: ['deepseek-chat', 'qwen-max']
  }
};
```

---

### 3. 两个模型理由是核心功�?
**必须在前端显�?*，不能省略！

这是用户最重要的需求，帮助他们理解AI的判断逻辑�?

---

## 🎯 Week 2 成功标准

### 功能完整�?
- [ ] 用户可以创建项目（包含PICOS和筛选风格选择�?
- [ ] 用户可以上传Excel文件导入文献
- [ ] 用户可以查看筛选结果列�?
- [ ] 用户可以查看**两个模型的详细理�?* �?
- [ ] 用户可以识别冲突的文�?

### 界面质量
- [ ] UI符合Ant Design规范
- [ ] 响应式布局（适配不同屏幕�?
- [ ] 加载状态提�?
- [ ] 错误处理友好

### 代码质量
- [ ] TypeScript类型完整
- [ ] 组件职责清晰
- [ ] API调用封装�?
- [ ] 代码符合ESLint规范

---

## 💡 开发建�?

### 1. 先做框架，再填内�?
```
Day 1: 搭建页面框架 + 路由
Day 2: 实现表单和列�?
Day 3-4: 文献导入功能
Day 5: 筛选结果展示（重点�?
```

### 2. 组件复用
```
- ProjectForm.tsx（创�?编辑项目表单�?
- LiteratureTable.tsx（文献列表表格）
- ScreeningResultCard.tsx（筛选结果卡片）
- ModelComparisonPanel.tsx（模型对比面板）�?
```

### 3. 状态管�?
```typescript
// 使用React Query管理服务端状�?
const { data: projects } = useQuery(['projects'], fetchProjects);

// 使用Zustand管理客户端状�?
const useAslStore = create((set) => ({
  currentProject: null,
  setCurrentProject: (project) => set({ currentProject: project }),
}));
```

---

## 🔄 后续计划

### Week 3-4: MVP完成
- 批量筛�?
- 结果导出
- 测试上线

### Week 5-7: Phase 2（可选）
- 智能Prompt生成模块
- 用户自定义PICOS
- AI分析边界情况

**详见**: `docs/03-业务模块/ASL-AI智能文献/02-技术设�?07-智能Prompt生成模块开发计�?md`

---

## 📞 关键联系信息

- **项目文档**: `AIclinicalresearch/docs/`
- **代码仓库**: `AIclinicalresearch/`
- **前端代码**: `frontend-v2/src/modules/asl/`
- **后端代码**: `backend/src/modules/asl/`

---

## �?交接检查清�?

新AI应该确认理解�?
- [ ] 项目是什么（医学文献AI筛选）
- [ ] 当前状态（Week 1完成，Week 2待开始）
- [ ] 技术栈（React + Ant Design + Fastify + Prisma�?
- [ ] Week 2任务�?个页面：项目管理、文献导入、结果展示）
- [ ] 核心功能（双模型筛选、三种风格、显示理由）
- [ ] 重点任务（显示两个模型的完整理由）⭐

---

**祝新AI开发顺利！** 🚀

**文档版本**: v1.0  
**创建日期**: 2025-11-18  
**维护�?*: Previous AI Assistant  
**用�?*: 新AI快速上手指�?