feat(aia): Complete AIA V2.0 with universal streaming capabilities

Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

Backend (~1300 lines):
- common/streaming: OpenAI Compatible adapter
- modules/aia: 12 agents, conversation service, streaming integration
- Update route versions (RVW, PKB to v1)

Frontend (~3500 lines):
- modules/aia: AgentHub + ChatWorkspace (100% prototype restoration)
- shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook
- Update API endpoints to v1

Documentation:
- AIA module status guide
- Universal capabilities catalog
- System overview updates
- All module documentation sync

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)
This commit is contained in:
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions

View File

@@ -1,62 +1,57 @@
# RVW绋夸欢瀹℃煡妯″潡杩佺Щ璁″垝锛坴2.1 - 绋冲畾杩佺Щ鐗堬級
> **文档版本:** v2.1
> **创建日期:** 2026-01-07
> **鏂囨。鐗堟湰锛?* v2.1
> **鍒涘缓鏃ユ湡锛?* 2026-01-07
> **鏈€鍚庢洿鏂帮細** 2026-01-07
> **维护者:** 开发团队
> **文档目的:** 将稿件审查功能从旧架构安全迁移到新架构同时整合MVP核心需求
> **缁存姢鑰咃細** 寮€鍙戝洟闃?
> **鏂囨。鐩<EFBFBD>殑锛?* 灏嗙ǹ浠跺<E6B5A0>鏌ュ姛鑳戒粠鏃ф灦鏋勫畨鍏ㄨ縼绉诲埌鏂版灦鏋勶紝鍚屾椂鏁村悎MVP鏍稿績闇€姹?
---
## 馃搵 椤圭洰姒傝堪
### 1. 鑳屾櫙
稿件审查功能是2025-10-30Day 30)独立开发的功能模块,目前位于 `backend/src/legacy/` `frontend/` 目录中。现需要:
绋夸欢瀹℃煡鍔熻兘鏄?025-10-30锛圖ay 30锛夌嫭绔嬪紑鍙戠殑鍔熻兘妯″潡锛岀洰鍓嶄綅浜?`backend/src/legacy/` 鍜?`frontend/` <EFBFBD>綍涓<EFBFBD>€傜幇闇€瑕侊細
1. **架构迁移**:迁移到标准的模块目录结构(`modules/rvw`
2. **功能升级**整合《智能期刊审稿系统MVP产品需求文档》的核心功能
1. **鏋舵瀯杩佺Щ**锛氳縼绉诲埌鏍囧噯鐨勬ā鍧楃洰褰曠粨鏋勶紙`modules/rvw`锛?2. **鍔熻兘鍗囩骇**锛氭暣鍚堛€婃櫤鑳芥湡鍒婂<E98D92>绋跨郴缁烳VP浜у搧闇€姹傛枃妗€嬬殑鏍稿績鍔熻兘
### 2. 杩佺Щ鍘熷垯
| 鍘熷垯 | 璇存槑 |
|------|------|
| **绋冲畾浼樺厛** | 姣忎釜Phase瀹屾垚鍚庡繀椤婚€氳繃娴嬭瘯楠岃瘉 |
| **安全可靠** | 数据库迁移前必须备份,支持回滚 |
| **瀹夊叏鍙<EFBFBD>** | 鏁版嵁搴撹縼绉诲墠蹇呴』澶囦唤锛屾敮鎸佸洖婊?|
| **闃舵<E99783>楠岃瘉** | 姣忎釜Phase鏈夋槑纭<E6A791>殑楠屾敹鏍囧噯 |
| **向后兼容** | 保留旧API过渡期不影响现有功能 |
| **渐进式** | 先核心后扩展,先后端后前端 |
| **鍚戝悗鍏煎<EFBFBD>** | 淇濈暀鏃<EFBFBD>PI杩囨浮鏈燂紝涓嶅奖鍝嶇幇鏈夊姛鑳?|
| **娓愯繘寮?* | 鍏堟牳蹇冨悗鎵╁睍锛屽厛鍚庣<E98D9A>鍚庡墠绔?|
### 3. 鍔熻兘鑼冨洿
| 功能 | 本次开发 | 数据库支撑 | 说明 |
| 鍔熻兘 | 鏈<><E98F88>寮€鍙?| 鏁版嵁搴撴敮鎾?| 璇存槑 |
|------|:--------:|:----------:|------|
| **核心AI评估** | ✅ | ✅ | 稿约规范性+方法学 |
| **批量上传** | ✅ | ✅ | 多文件上传 |
| **审稿工作台** | ✅ | ✅ | 宽表布局+筛选 |
| **智能体选择** | ✅ | ✅ | 可选1个或2个 |
| **批量操作** | ✅ | ✅ | 批量运行审查 |
| **状态筛选** | ✅ | ✅ | 全部/待处理/已完成 |
| PDF报告导出 | ✅ | ✅ | 优化现有功能 |
| PICO卡片 | ⏸️ | | **暂不开发,数据库预留** |
| 系统设置 | ⏸️ | | **暂不开发,数据库预留** |
| 历史归档 | ⏸️ | | **暂不开发,数据库预留** |
| 登录页面 | ⏸️ | - | 暂不开发 |
| **鏍稿績AI璇勪及** | 鉁?| 鉁?| 绋跨害瑙勮寖鎬?鏂规硶瀛?|
| **鎵归噺涓婁紶** | 鉁?| 鉁?| 澶氭枃浠朵笂浼?|
| **瀹$ǹ宸ヤ綔鍙?* | 鉁?| 鉁?| 瀹借〃甯冨眬+绛涢€?|
| **鏅鸿兘浣撻€夋嫨** | 鉁?| 鉁?| 鍙<>€?涓<>垨2涓?|
| **鎵归噺鎿嶄綔** | 鉁?| 鉁?| 鎵归噺杩愯<E69DA9>瀹℃煡 |
| **鐘舵€佺瓫閫?* | 鉁?| 鉁?| 鍏ㄩ儴/寰呭<E5AFB0>鐞?宸插畬鎴?|
| PDF鎶ュ憡瀵煎嚭 | 鉁?| 鉁?| 浼樺寲鐜版湁鍔熻兘 |
| PICO鍗$墖 | 鈴革笍 | 鉁?| **鏆備笉寮€鍙戯紝鏁版嵁搴撻<EFBFBD>鐣?* |
| 绯荤粺璁剧疆 | 鈴革笍 | 鉁?| **鏆備笉寮€鍙戯紝鏁版嵁搴撻<EFBFBD>鐣?* |
| 鍘嗗彶褰掓。 | 鈴革笍 | 鉁?| **鏆備笉寮€鍙戯紝鏁版嵁搴撻<EFBFBD>鐣?* |
| 鐧诲綍椤甸潰 | 鈴革笍 | - | 鏆備笉寮€鍙?|
### 4. 鏅鸿兘浣撻€夋嫨璇存槑
用户可以灵活选择运行的智能体:
鐢ㄦ埛鍙<EFBFBD>互鐏垫椿閫夋嫨杩愯<EFBFBD>鐨勬櫤鑳戒綋锛?
```
选项 A: 只选择「稿约规范性智能体」 → 只运行规范性评估
选项 B: 只选择「方法学统计智能体」 → 只运行方法学评估
选项 C: 同时选择两个智能体 → 同时运行两项评估(默认)
閫夐」 A: <EFBFBD>€夋嫨銆岀ǹ绾﹁<EFBFBD>鑼冩€ф櫤鑳戒綋銆? 鈫?鍙<>繍琛岃<E7909B>鑼冩€ц瘎浼?閫夐」 B: 鍙<>€夋嫨銆屾柟娉曞<E5A889>缁熻<E7BC81>鏅鸿兘浣撱€? 鈫?鍙<>繍琛屾柟娉曞<E5A889>璇勪及
閫夐」 C: 鍚屾椂閫夋嫨涓や釜鏅鸿兘浣? 鈫?鍚屾椂杩愯<E69DA9>涓ら」璇勪及锛堥粯璁わ級
```
---
## 📊 数据库设计(完整版,支撑未来扩展)
## 馃搳 鏁版嵁搴撹<E690B4>璁★紙瀹屾暣鐗堬紝鏀<E7B49D>拺鏈<E68BBA>潵鎵╁睍锛?
### 1. 鏈熷垔閰嶇疆琛<E79686>紙棰勭暀锛屾殏涓嶄娇鐢<E5A887>
```prisma
@@ -84,20 +79,16 @@ model JournalConfig {
model ReviewTask {
id String @id @default(uuid())
userId String @map("user_id")
journalId String? @map("journal_id") // 预留:期刊关联
journalId String? @map("journal_id") // 棰勭暀锛氭湡鍒婂叧鑱?
// 鏂囦欢淇℃伅
fileName String @map("file_name")
fileSize Int @map("file_size")
filePath String? @map("file_path")
extractedText String @map("extracted_text")
wordCount Int? @map("word_count")
authorName String? @map("author_name") // 预留:作者提取
// 状态管理
status String @default("pending")
// ✅ 智能体选择可选1个或2个
selectedAgents String[] @default(["editorial", "methodology"]) @map("selected_agents")
authorName String? @map("author_name") // 棰勭暀锛氫綔鑰呮彁鍙?
// 鐘舵€佺<E282AC>鐞? status String @default("pending")
// 鉁?鏅鸿兘浣撻€夋嫨锛氬彲閫?涓<>垨2涓? selectedAgents String[] @default(["editorial", "methodology"]) @map("selected_agents")
// 璇勪及缁撴灉
editorialReview Json? @map("editorial_review")
@@ -111,15 +102,13 @@ model ReviewTask {
// 棰勭暀锛歅ICO鎻愬彇锛堟殏涓嶄娇鐢<E5A887>
picoExtract Json? @map("pico_extract")
// 元数据
modelUsed String? @map("model_used")
// 鍏冩暟鎹? modelUsed String? @map("model_used")
startedAt DateTime? @map("started_at")
completedAt DateTime? @map("completed_at")
durationSeconds Int? @map("duration_seconds")
errorMessage String? @map("error_message")
// 预留:归档功能(暂不使用)
isArchived Boolean @default(false) @map("is_archived")
// 棰勭暀锛氬綊妗e姛鑳斤紙鏆備笉浣跨敤锛? isArchived Boolean @default(false) @map("is_archived")
archivedAt DateTime? @map("archived_at")
createdAt DateTime @default(now()) @map("created_at")
@@ -141,29 +130,26 @@ model ReviewTask {
### 3. 瀛楁<E7809B>璇存槑
| 字段 | 本次使用 | 预留用途 |
| 瀛楁<EFBFBD> | 鏈<><E98F88>浣跨敤 | 棰勭暀鐢ㄩ€?|
|------|:--------:|---------|
| `journalId` | ❌ | 系统设置:期刊关联 |
| `authorName` | ❌ | 自动提取作者名 |
| `selectedAgents` | ✅ | 用户选择的智能体 |
| `editorialScore` | ✅ | 列表显示规范性分数 |
| `methodologyStatus` | ✅ | 列表显示方法学状态 |
| `picoExtract` | | PICO卡片数据 |
| `isArchived` | ❌ | 历史归档功能 |
| `archivedAt` | ❌ | 归档时间 |
| `journalId` | 鉂?| 绯荤粺璁剧疆锛氭湡鍒婂叧鑱?|
| `authorName` | 鉂?| 鑷<>姩鎻愬彇浣滆€呭悕 |
| `selectedAgents` | 鉁?| 鐢ㄦ埛閫夋嫨鐨勬櫤鑳戒綋 |
| `editorialScore` | 鉁?| 鍒楄〃鏄剧ず瑙勮寖鎬у垎鏁?|
| `methodologyStatus` | 鉁?| 鍒楄〃鏄剧ず鏂规硶瀛︾姸鎬?|
| `picoExtract` | 鉂?| PICO鍗$墖鏁版嵁 |
| `isArchived` | 鉂?| 鍘嗗彶褰掓。鍔熻兘 |
| `archivedAt` | 鉂?| 褰掓。鏃堕棿 |
---
## 馃搵 瀹夊叏杩佺Щ绛栫暐
### 1. 迁移前准备
### 1. 杩佺Щ鍓嶅噯澶?
```bash
# 1. 备份数据库
pg_dump -h localhost -U postgres -d airesearch -F c -f backup_before_rvw_migration.dump
# 1. 澶囦唤鏁版嵁搴?pg_dump -h localhost -U postgres -d airesearch -F c -f backup_before_rvw_migration.dump
# 2. 记录当前数据量
SELECT COUNT(*) FROM public.review_tasks;
# 2. 璁板綍褰撳墠鏁版嵁閲?SELECT COUNT(*) FROM public.review_tasks;
# 3. 瀵煎嚭鍏抽敭鏁版嵁锛堝彲閫夛級
COPY public.review_tasks TO '/tmp/review_tasks_backup.csv' WITH CSV HEADER;
@@ -180,55 +166,49 @@ ALTER TABLE review_schema.review_tasks SET SCHEMA public;
DROP SCHEMA review_schema;
```
### 3. 阶段性验证
每个Phase完成后必须通过以下验证
### 3. 闃舵<EFBFBD>鎬ч獙璇?
姣忎釜Phase瀹屾垚鍚庡繀椤婚€氳繃浠ヤ笅楠岃瘉锛?
| Phase | 楠岃瘉鍐呭<E98D90> | 楠屾敹鏍囧噯 |
|-------|---------|---------|
| Phase 1 | 鍚庣<E98D9A>API娴嬭瘯 | 鎵€鏈堿PI杩斿洖姝锛屾棩蹇楁棤ERROR |
| Phase 2 | 数据库迁移 | 数据完整,查询正常,索引有效 |
| Phase 2 | 鏁版嵁搴撹縼绉?| 鏁版嵁瀹屾暣锛屾煡璇㈡<E79287>甯革紝绱㈠紩鏈夋晥 |
| Phase 3 | 鍓嶇<E98D93>鍔熻兘娴嬭瘯 | 鏍稿績娴佺▼閫氶『锛屾棤鐧藉睆/鎶ラ敊 |
| Phase 4 | 集成测试 | 端到端流程正常 |
| Phase 4 | 闆嗘垚娴嬭瘯 | 绔<>埌绔<E59F8C>祦绋嬫<E7BB8B>甯?|
| Phase 5 | 楠屾敹娴嬭瘯 | 绗﹀悎MVP楠屾敹鏍囧噯 |
---
## 📋 开发任务清单
## 馃搵 寮€鍙戜换鍔℃竻鍗?
### Phase 1锛氬悗绔<E68297>ā鍧楄縼绉伙紙2澶╋級
#### Day 1 上午:创建模块结构 + 复用核心代码
#### Day 1 涓婂崍锛氬垱寤烘ā鍧楃粨鏋?+ 澶嶇敤鏍稿績浠g爜
**1.1 鍒涘缓鐩<E7BC93>綍缁撴瀯**
```
backend/src/modules/rvw/
鈹溾攢鈹€ routes/
│ └── index.ts # 路由定义
鈹? 鈹斺攢鈹€ index.ts # <EFBFBD>敱瀹氫箟
鈹溾攢鈹€ controllers/
│ └── reviewController.ts # 控制器
├── services/
│ ├── reviewService.ts # 主服务(复用+扩展)
│ ├── editorialService.ts # 稿约评估(复用)
│ └── methodologyService.ts # 方法学评估(复用)
├── types/
│ └── index.ts # 类型定义
鈹? 鈹斺攢鈹€ reviewController.ts # 鎺у埗鍣?鈹溾攢鈹€ services/
鈹? 鈹溾攢鈹€ reviewService.ts # 涓绘湇鍔★紙澶嶇敤+鎵╁睍锛?鈹? 鈹溾攢鈹€ editorialService.ts # 绋跨害璇勪及锛堝<E9949B><EFBFBD>
鈹? 鈹斺攢鈹€ methodologyService.ts # 鏂规硶瀛﹁瘎浼帮紙澶嶇敤锛?鈹溾攢鈹€ types/
鈹? 鈹斺攢鈹€ index.ts # 绫诲瀷瀹氫箟
鈹溾攢鈹€ prompts/
│ ├── editorial_system.txt # 稿约Prompt
│ └── methodology_system.txt # 方法学Prompt
鈹? 鈹溾攢鈹€ editorial_system.txt # 绋跨害Prompt
鈹? 鈹斺攢鈹€ methodology_system.txt # 鏂规硶瀛<EFBFBD>rompt
鈹斺攢鈹€ index.ts # 妯″潡鍏ュ彛
```
- [ ] **1.1.1** 鍒涘缓鐩<E7BC93>綍缁撴瀯
- [ ] **1.1.2** 复制 `reviewEditorialStandards()` `editorialService.ts`
- [ ] **1.1.3** 复制 `reviewMethodology()` `methodologyService.ts`
- [ ] **1.1.4** 复制 `parseJSONFromLLMResponse()` `utils.ts`
- [ ] **1.1.2** 澶嶅埗 `reviewEditorialStandards()` 鈫?`editorialService.ts`
- [ ] **1.1.3** 澶嶅埗 `reviewMethodology()` 鈫?`methodologyService.ts`
- [ ] **1.1.4** 澶嶅埗 `parseJSONFromLLMResponse()` 鈫?`utils.ts`
- [ ] **1.1.5** 澶嶅埗 Prompt 鏂囦欢鍒版ā鍧楀唴
**1.2 云原生改造**
**1.2 浜戝師鐢熸敼閫?*
- [ ] **1.2.1** 替换 `console.log` `logger`
- [ ] **1.2.1** 鏇挎崲 `console.log` 鈫?`logger`
- [ ] **1.2.2** 绉婚櫎 Mock鐢ㄦ埛ID锛岄泦鎴怞WT璁よ瘉
- [ ] **1.2.3** 浣跨敤 `process.env` 閰嶇疆
@@ -242,8 +222,7 @@ export type AgentType = 'editorial' | 'methodology';
export interface RunReviewParams {
taskId: string;
agents: AgentType[]; // 可选1个或2个
}
agents: AgentType[]; // <EFBFBD>€?涓<>垨2涓?}
// services/reviewService.ts
async function runReview(params: RunReviewParams) {
@@ -254,8 +233,7 @@ async function runReview(params: RunReviewParams) {
throw new Error('璇疯嚦灏戦€夋嫨涓€涓<E282AC>櫤鑳戒綋');
}
// 更新任务状态
await prisma.reviewTask.update({
// 鏇存柊浠诲姟鐘舵€? await prisma.reviewTask.update({
where: { id: taskId },
data: {
status: 'reviewing',
@@ -301,8 +279,7 @@ function calculateOverallScore(editorial: any, methodology: any, agents: AgentTy
// 涓や釜閮介€夛細40% + 60%
return editorial.overall_score * 0.4 + methodology.overall_score * 0.6;
} else if (agents.includes('editorial') && editorial) {
// 只选规范性
return editorial.overall_score;
// <EFBFBD>€夎<EFBFBD>鑼冩€? return editorial.overall_score;
} else if (agents.includes('methodology') && methodology) {
// 鍙<>€夋柟娉曞<E5A889>
return methodology.overall_score;
@@ -314,9 +291,8 @@ function calculateOverallScore(editorial: any, methodology: any, agents: AgentTy
- [ ] **1.3.1** 瀹炵幇鏅鸿兘浣撻€夋嫨绫诲瀷瀹氫箟
- [ ] **1.3.2** 瀹炵幇 `runReview()` 鍑芥暟
- [ ] **1.3.3** 瀹炵幇缁煎悎鍒嗘暟璁$畻閫昏緫
- [ ] **1.3.4** 实现方法学状态判断(pass/warn/fail
#### Day 2 上午:批量操作 + API扩展
- [ ] **1.3.4** 瀹炵幇鏂规硶瀛︾姸鎬佸垽鏂<EFBFBD>pass/warn/fail锛?
#### Day 2 涓婂崍锛氭壒閲忔搷浣?+ API鎵╁睍
**1.4 鎵归噺杩愯<E69DA9>瀹炵幇**
@@ -325,8 +301,7 @@ function calculateOverallScore(editorial: any, methodology: any, agents: AgentTy
async function batchRunReview(params: BatchRunParams) {
const { taskIds, agents } = params;
// 限制并发数
const MAX_CONCURRENT = 5;
// 闄愬埗骞跺彂鏁? const MAX_CONCURRENT = 5;
const results = [];
for (let i = 0; i < taskIds.length; i += MAX_CONCURRENT) {
@@ -342,9 +317,8 @@ async function batchRunReview(params: BatchRunParams) {
```
- [ ] **1.4.1** 瀹炵幇鎵归噺杩愯<E69DA9>鎺ュ彛
- [ ] **1.4.2** 实现并发控制最多5个
- [ ] **1.4.3** 实现错误处理(单个失败不影响其他)
- [ ] **1.4.2** 瀹炵幇骞跺彂鎺у埗锛堟渶澶?涓<>
- [ ] **1.4.3** 瀹炵幇閿欒<EFBFBD>澶勭悊锛堝崟涓<EFBFBD>け璐ヤ笉褰卞搷鍏朵粬锛?
**1.5 API璺<49>敱瀹氫箟**
```typescript
@@ -364,58 +338,52 @@ export default async function rvwRoutes(fastify: FastifyInstance) {
```
- [ ] **1.5.1** 瀹炵幇璺<E5B987>敱瀹氫箟
- [ ] **1.5.2** 实现控制器方法
- [ ] **1.5.3** 添加请求验证
- [ ] **1.5.2** 瀹炵幇鎺у埗鍣ㄦ柟娉?- [ ] **1.5.3** 娣诲姞璇锋眰楠岃瘉
#### Day 2 下午:注册路由 + Phase 1 验证
#### Day 2 涓嬪崍锛氭敞鍐岃矾鐢?+ Phase 1 楠岃瘉
**1.6 注册新路由**
**1.6 娉ㄥ唽鏂拌矾鐢?*
```typescript
// backend/src/index.ts
import rvwRoutes from './modules/rvw/routes/index.js';
// 注册新路由v2
await fastify.register(rvwRoutes, { prefix: '/api/v2/rvw' });
logger.info('✅ RVW稿件审查路由已注册: /api/v2/rvw');
// 娉ㄥ唽鏂拌矾鐢憋紙v2锛?await fastify.register(rvwRoutes, { prefix: '/api/v1/rvw' });
logger.info('鉁?RVW绋夸欢瀹℃煡璺<E785A1>敱宸叉敞鍐? /api/v1/rvw');
// 保留旧路由(兼容)
await fastify.register(reviewRoutes, { prefix: '/api/v1' });
logger.info('✅ Legacy审稿路由保留: /api/v1/review');
// 淇濈暀鏃ц矾鐢憋紙鍏煎<EFBFBD>锛?await fastify.register(reviewRoutes, { prefix: '/api/v1' });
logger.info('鉁?Legacy瀹ǹ璺<C7B9>敱淇濈暀: /api/v1/review');
```
- [ ] **1.6.1** 注册新路由
- [ ] **1.6.2** 保留旧路由兼容
- [ ] **1.6.1** 娉ㄥ唽鏂拌矾鐢?- [ ] **1.6.2** 淇濈暀鏃ц矾鐢卞吋瀹?
**1.7 Phase 1 楠岃瘉娴嬭瘯**
```http
### 1.
POST {{baseUrl}}/api/v2/rvw/tasks
POST {{baseUrl}}/api/v1/rvw/tasks
Content-Type: multipart/form-data
# file: test.docx
### 2. <EFBFBD><EFBFBD>э
POST {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/run
POST {{baseUrl}}/api/v1/rvw/tasks/{{taskId}}/run
Content-Type: application/json
{ "agents": ["editorial"] }
### 3.
POST {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/run
### 3. <EFBFBD><EFBFBD>?POST {{baseUrl}}/api/v1/rvw/tasks/{{taskId}}/run
Content-Type: application/json
{ "agents": ["methodology"] }
### 4. <EFBFBD><EFBFBD>
POST {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/run
POST {{baseUrl}}/api/v1/rvw/tasks/{{taskId}}/run
Content-Type: application/json
{ "agents": ["editorial", "methodology"] }
### 5. <EFBFBD>
POST {{baseUrl}}/api/v2/rvw/tasks/batch/run
POST {{baseUrl}}/api/v1/rvw/tasks/batch/run
Content-Type: application/json
{
@@ -424,22 +392,22 @@ Content-Type: application/json
}
### 6.
GET {{baseUrl}}/api/v2/rvw/tasks?status=pending&limit=10
GET {{baseUrl}}/api/v1/rvw/tasks?status=pending&limit=10
### 7.
GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
GET {{baseUrl}}/api/v1/rvw/tasks/{{taskId}}/report
```
**Phase 1 验收标准:**
**Phase 1 楠屾敹鏍囧噯锛?*
| 测试项 | 预期结果 | 通过 |
| 娴嬭瘯椤?| 棰勬湡缁撴灉 | 閫氳繃 |
|--------|---------|:----:|
| 创建任务 | 返回taskId状态pending | |
| 只选规范性 | 只有editorialReview有值 | ⬜ |
| 只选方法学 | 只有methodologyReview有值 | ⬜ |
| 两个都选 | 两个Review都有值 | ⬜ |
| 批量运行 | 多个任务都完成 | ⬜ |
| 旧API兼容 | `/api/v1/review/*` 正常 | |
| 鍒涘缓浠诲姟 | 杩斿洖taskId锛岀姸鎬乸ending | 猬?|
| <EFBFBD>€夎<EFBFBD>鑼冩€?| 鍙<>editorialReview鏈夊€?| 猬?|
| <EFBFBD>€夋柟娉曞<EFBFBD> | 鍙<>methodologyReview鏈夊€?| 猬?|
| 涓や釜閮介€?| 涓や釜Review閮芥湁鍊?| 猬?|
| 鎵归噺杩愯<EFBFBD> | 澶氫釜浠诲姟閮藉畬鎴?| 猬?|
| <EFBFBD>PI鍏煎<EFBFBD> | `/api/v1/review/*` 姝e父 | 猬?|
- [ ] **1.7.1** 缂栧啓娴嬭瘯鐢ㄤ緥
- [ ] **1.7.2** 鎵ц<E98EB5>娴嬭瘯
@@ -448,12 +416,11 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
---
### Phase 2数据库Schema迁移0.5天)
### Phase 2锛氭暟鎹<EFBFBD>簱Schema杩佺Щ锛?.5澶╋級
#### 杩佺Щ鍓嶏細澶囦唤
- [ ] **2.1** 备份数据库
```bash
- [ ] **2.1** 澶囦唤鏁版嵁搴? ```bash
pg_dump -h localhost -U postgres -d airesearch -F c -f backup_phase2.dump
```
@@ -469,8 +436,7 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
-- 1. 鍒涘缓鏂癝chema
CREATE SCHEMA IF NOT EXISTS review_schema;
-- 2. 创建期刊配置表(预留)
CREATE TABLE review_schema.journal_configs (
-- 2. 鍒涘缓鏈熷垔閰嶇疆琛<EFBFBD>紙棰勭暀锛? CREATE TABLE review_schema.journal_configs (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
name VARCHAR(255) NOT NULL,
logo_url TEXT,
@@ -483,8 +449,7 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
-- 3. 杩佺Щreview_tasks琛ㄥ埌鏂癝chema
ALTER TABLE public.review_tasks SET SCHEMA review_schema;
-- 4. 添加新字段(支持未来扩展)
ALTER TABLE review_schema.review_tasks
-- 4. 娣诲姞鏂板瓧娈碉紙鏀<EFBFBD>寔鏈<EFBFBD>潵鎵╁睍锛? ALTER TABLE review_schema.review_tasks
ADD COLUMN IF NOT EXISTS journal_id UUID REFERENCES review_schema.journal_configs(id),
ADD COLUMN IF NOT EXISTS author_name VARCHAR(255),
ADD COLUMN IF NOT EXISTS selected_agents TEXT[] DEFAULT ARRAY['editorial', 'methodology'],
@@ -505,8 +470,7 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
- [ ] **2.4** 鏇存柊Prisma Schema
- 淇<>敼 `@@schema("review_schema")`
- 添加新字段
- 娣诲姞鏂板瓧娈?
- [ ] **2.5** 鎵ц<E98EB5>杩佺Щ
```bash
npx prisma migrate dev --name rvw_schema_migration
@@ -514,10 +478,8 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
#### Phase 2 楠岃瘉
- [ ] **2.6** 验证数据完整性
```sql
-- 确认数据量一致
SELECT COUNT(*) FROM review_schema.review_tasks;
- [ ] **2.6** 楠岃瘉鏁版嵁瀹屾暣鎬? ```sql
-- 纭<><E7BAAD>鏁版嵁閲忎竴鑷? SELECT COUNT(*) FROM review_schema.review_tasks;
-- 纭<><E7BAAD>瀛楁<E7809B><EFBFBD>
SELECT id, selected_agents, editorial_score FROM review_schema.review_tasks LIMIT 5;
@@ -529,15 +491,15 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
LIMIT 5;
```
**Phase 2 验收标准:**
**Phase 2 楠屾敹鏍囧噯锛?*
| 测试项 | 预期结果 | 通过 |
| 娴嬭瘯椤?| 棰勬湡缁撴灉 | 閫氳繃 |
|--------|---------|:----:|
| 数据迁移 | 数据量一致 | ⬜ |
| 新字段 | 字段存在且可用 | ⬜ |
| 外键关系 | 关联正常 | |
| 索引有效 | 查询性能正常 | |
| API正常 | 后端API仍可用 | ⬜ |
| 鏁版嵁杩佺Щ | 鏁版嵁閲忎竴鑷?| 猬?|
| 鏂板瓧娈?| 瀛楁<E7809B>瀛樺湪涓斿彲鐢?| 猬?|
| 澶栭敭鍏崇郴 | 鍏宠仈姝e父 | 猬?|
| 绱㈠紩鏈夋晥 | 鏌ヨ<E98F8C>鎬ц兘姝 | 猬?|
| API姝e父 | 鍚庣<E98D9A>API浠嶅彲鐢?| 猬?|
- [ ] **2.7** 纭<><E7BAAD>Phase 2閫氳繃
@@ -545,38 +507,33 @@ GET {{baseUrl}}/api/v2/rvw/tasks/{{taskId}}/report
### Phase 3锛氬墠绔<E5A2A0>噸鏋勶紙3澶╋級
#### Day 3:模块结构 + API
#### Day 3锛氭ā鍧楃粨鏋?+ API灞?
**3.1 鍒涘缓妯″潡缁撴瀯**
```
frontend-v2/src/modules/rvw/
鈹溾攢鈹€ api/
│ └── reviewApi.ts # API封装
鈹? 鈹斺攢鈹€ reviewApi.ts # API灏佽<EFBFBD>
鈹溾攢鈹€ components/
│ ├── ScoreCard.tsx # 复用
│ ├── EditorialReview.tsx # 复用
│ ├── MethodologyReview.tsx # 复用
│ ├── AgentSelector.tsx # 🆕 智能体选择弹窗
│ ├── BatchToolbar.tsx # 🆕 批量操作栏
│ ├── TaskTable.tsx # 🆕 任务列表表格
│ └── StatusFilter.tsx # 🆕 状态筛选
├── pages/
│ ├── ReviewDashboard.tsx # 🆕 审稿工作台
│ └── ReviewDetail.tsx # 报告详情(优化)
鈹? 鈹溾攢鈹€ ScoreCard.tsx # 澶嶇敤
鈹? 鈹溾攢鈹€ EditorialReview.tsx # 澶嶇敤
鈹? 鈹溾攢鈹€ MethodologyReview.tsx # 澶嶇敤
鈹? 鈹溾攢鈹€ AgentSelector.tsx # 馃啎 鏅鸿兘浣撻€夋嫨寮圭獥
鈹? 鈹溾攢鈹€ BatchToolbar.tsx # 馃啎 鎵归噺鎿嶄綔鏍?鈹? 鈹溾攢鈹€ TaskTable.tsx # 馃啎 浠诲姟鍒楄〃琛ㄦ牸
鈹? 鈹斺攢鈹€ StatusFilter.tsx # 馃啎 鐘舵€佺瓫閫?鈹溾攢鈹€ pages/
鈹? 鈹溾攢鈹€ ReviewDashboard.tsx # 馃啎 瀹$ǹ宸ヤ綔鍙?鈹? 鈹斺攢鈹€ ReviewDetail.tsx # 鎶ュ憡璇︽儏锛堜紭鍖栵級
鈹溾攢鈹€ hooks/
│ ├── useReviewTask.ts
│ └── useBatchOperation.ts
鈹? 鈹溾攢鈹€ useReviewTask.ts
鈹? 鈹斺攢鈹€ useBatchOperation.ts
鈹溾攢鈹€ stores/
│ └── useReviewStore.ts
鈹? 鈹斺攢鈹€ useReviewStore.ts
鈹溾攢鈹€ types/
│ └── index.ts
鈹? 鈹斺攢鈹€ index.ts
鈹斺攢鈹€ index.tsx
```
- [ ] **3.1.1** 鍒涘缓鐩<E7BC93>綍缁撴瀯
- [ ] **3.1.2** 复用现有组件ScoreCard、EditorialReview、MethodologyReview
- [ ] **3.1.2** 澶嶇敤鐜版湁缁勪欢锛圫coreCard銆丒ditorialReview銆丮ethodologyReview锛?
**3.2 API灏佽<E7818F>**
```typescript
@@ -585,12 +542,12 @@ export type AgentType = 'editorial' | 'methodology';
// 杩愯<E69DA9>瀹℃煡锛堟敮鎸侀€夋嫨鏅鸿兘浣擄級
export async function runReview(taskId: string, agents: AgentType[]): Promise<void> {
return axios.post(`/api/v2/rvw/tasks/${taskId}/run`, { agents });
return axios.post(`/api/v1/rvw/tasks/${taskId}/run`, { agents });
}
// 鎵归噺杩愯<E69DA9>
export async function batchRunReview(taskIds: string[], agents: AgentType[]): Promise<void> {
return axios.post('/api/v2/rvw/tasks/batch/run', { taskIds, agents });
return axios.post('/api/v1/rvw/tasks/batch/run', { taskIds, agents });
}
// 鑾峰彇浠诲姟鍒楄〃锛堝甫绛涢€夛級
@@ -601,30 +558,25 @@ export interface TaskListParams {
}
export async function getTaskList(params: TaskListParams): Promise<TaskListResponse> {
return axios.get('/api/v2/rvw/tasks', { params });
return axios.get('/api/v1/rvw/tasks', { params });
}
```
- [ ] **3.2.1** 瀹炵幇API灏佽<E7818F>
- [ ] **3.2.2** 瀹炵幇绫诲瀷瀹氫箟
#### Day 4:核心页面开发
#### Day 4锛氭牳蹇冮〉闈㈠紑鍙?
**3.3 鏅鸿兘浣撻€夋嫨寮圭獥**
```tsx
// components/AgentSelector.tsx
interface AgentSelectorProps {
visible: boolean;
taskIds: string[]; // 支持单个或多个
onConfirm: (agents: AgentType[]) => void;
taskIds: string[]; // <EFBFBD>寔鍗曚釜鎴栧<EFBFBD>涓? onConfirm: (agents: AgentType[]) => void;
onCancel: () => void;
}
// 弹窗内容:
// ✅ 稿约规范性智能体(默认选中)
// 格式、参考文献、图片检查
// ☐ 方法学统计智能体
// 寮圭獥鍐呭<EFBFBD>锛?// 鉁?绋跨害瑙勮寖鎬ф櫤鑳戒綋锛堥粯璁ら€変腑锛?// 鏍煎紡銆佸弬鑰冩枃鐚<E69E83>€佸浘鐗囨<E99097>鏌?// 鈽?鏂规硶瀛︾粺璁℃櫤鑳戒綋
// DeepSeek 娣卞害閫昏緫鎺ㄧ悊
//
// 鎻愮ず锛氬彲閫夋嫨1涓<31>垨鍚屾椂閫夋嫨2涓<32>櫤鑳戒綋
@@ -633,37 +585,21 @@ interface AgentSelectorProps {
```
- [ ] **3.3.1** 瀹炵幇鏅鸿兘浣撻€夋嫨寮圭獥
- [ ] **3.3.2** 支持单选和多选
- [ ] **3.3.3** 默认选中规范性智能体
- [ ] **3.3.2** <EFBFBD>寔鍗曢€夊拰澶氶€?- [ ] **3.3.3** 榛樿<E6A69B>閫変腑瑙勮寖鎬ф櫤鑳戒綋
**3.4 审稿工作台**
**3.4 瀹$ǹ宸ヤ綔鍙?*
```
┌─────────────────────────────────────────────────────────────────┐
│ Header: [Logo] 智能审稿系统 [上传新稿件] │
├─────────────────────────────────────────────────────────────────┤
│ Filter: [全部|待处理|已完成] │
├─────────────────────────────────────────────────────────────────┤
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ ☐ 文件名称/信息 上传时间 审稿维度 结果摘要 操作 │ │
│ │ ☐ 替雷利珠单抗...pdf 10:30 [规范][方法] 92分 [查看] │
│ │ ☐ 高血压药物...docx 刚刚 [未运行] 等待... [开始] │
│ └───────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ [Batch Toolbar: 3个文件已选中 | 运行智能审稿 | ✕] │
└─────────────────────────────────────────────────────────────────┘
```
鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? Header: [Logo] 鏅鸿兘瀹$ǹ绯荤粺 [涓婁紶鏂扮ǹ浠禲 鈹?鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? Filter: [鍏ㄩ儴|寰呭<E5AFB0>鐞唡宸插畬鎴怾 鈹?鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? 鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹? 鈹?鈹? 鈹? 鈽? 鏂囦欢鍚嶇О/淇℃伅 涓婁紶鏃堕棿 瀹$ǹ缁村害 缁撴灉鎽樿<E98EBD> 鎿嶄綔 鈹? 鈹?鈹? 鈹? 鈽? 鏇块浄鍒╃彔鍗曟姉...pdf 10:30 [瑙勮寖][鏂规硶] 92鍒? [鏌ョ湅] 鈹?鈹? 鈹? 鈽? 楂樿<E6A582>鍘嬭嵂鐗?..docx 鍒氬垰 [鏈<>繍琛宂 绛夊緟... [寮€濮媇 鈹?鈹? 鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹? 鈹?鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? [Batch Toolbar: 3涓<33>枃浠跺凡閫変腑 | 杩愯<E69DA9>鏅鸿兘瀹ǹ | 鉁昡 鈹?鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?```
- [ ] **3.4.1** 瀹炵幇椤甸潰甯冨眬
- [ ] **3.4.2** 瀹炵幇浠诲姟鍒楄〃琛ㄦ牸
- [ ] **3.4.3** 实现状态筛选
- [ ] **3.4.4** 实现批量操作栏
- [ ] **3.4.3** 瀹炵幇鐘舵€佺瓫閫?- [ ] **3.4.4** 瀹炵幇鎵归噺鎿嶄綔鏍?
#### Day 5锛氭姤鍛婅<E98D9B>鎯?+ Phase 3 楠岃瘉
#### Day 5报告详情 + Phase 3 验证
**3.5 鎶ュ憡璇︽儏椤?*
**3.5 报告详情页**
- [ ] **3.5.1** 实现Tab切换规范性/方法学)
- [ ] **3.5.1** 瀹炵幇Tab鍒囨崲锛堣<E9949B>鑼冩€?鏂规硶瀛︼級
- [ ] **3.5.2** 澶嶇敤璇勪及璇︽儏缁勪欢
- [ ] **3.5.3** 鏍规嵁閫夋嫨鐨勬櫤鑳戒綋鏄剧ず瀵瑰簲Tab
- [ ] **3.5.4** 瀹炵幇瀵煎嚭鎶ュ憡鎸夐挳
@@ -686,14 +622,14 @@ interface AgentSelectorProps {
**Phase 3 楠岃瘉娴嬭瘯**
| 测试项 | 预期结果 | 通过 |
| 娴嬭瘯椤?| 棰勬湡缁撴灉 | 閫氳繃 |
|--------|---------|:----:|
| 页面加载 | 工作台正常显示 | ⬜ |
| 文件上传 | 支持多文件 | ⬜ |
| 智能体选择 | 可选1个或2个 | ⬜ |
| 批量操作 | 批量运行成功 | |
| 状态筛选 | 筛选结果正确 | ⬜ |
| 报告查看 | 显示对应评估结果 | |
| 椤甸潰鍔犺浇 | 宸ヤ綔鍙版<E98D99>甯告樉绀?| 猬?|
| 鏂囦欢涓婁紶 | 鏀<>寔澶氭枃浠?| 猬?|
| 鏅鸿兘浣撻€夋嫨 | 鍙<>€?涓<>垨2涓?| 猬?|
| 鎵归噺鎿嶄綔 | 鎵归噺杩愯<E69DA9>鎴愬姛 | 猬?|
| 鐘舵€佺瓫閫?| 绛涢€夌粨鏋滄<E98F8B>纭?| 猬?|
| 鎶ュ憡鏌ョ湅 | 鏄剧ず瀵瑰簲璇勪及缁撴灉 | 猬?|
- [ ] **3.7** 纭<><E7BAAD>Phase 3閫氳繃
@@ -701,46 +637,41 @@ interface AgentSelectorProps {
### Phase 4锛氶泦鎴愭祴璇曪紙1澶╋級
**4.1 端到端测试**
**4.1 <EFBFBD>埌绔<EFBFBD>祴璇?*
| 娴嬭瘯鍦烘櫙 | 姝ラ<E5A79D> | 棰勬湡缁撴灉 |
|---------|------|---------|
| 单文件+单智能体 | 上传→选规范性→查看 | 只显示规范性报告 |
| 单文件+双智能体 | 上传→选两个→查看 | 显示两个报告Tab |
| 鍗曟枃浠?鍗曟櫤鑳戒綋 | 涓婁紶鈫掗€夎<E282AC>鑼冩€р啋鏌ョ湅 | 鍙<>樉绀鸿<E7BB80>鑼冩€ф姤鍛?|
| 鍗曟枃浠?鍙屾櫤鑳戒綋 | 涓婁紶鈫掗€変袱涓<E8A2B1>啋鏌ョ湅 | 鏄剧ず涓や釜鎶ュ憡Tab |
| 鎵归噺+鍙屾櫤鑳戒綋 | 涓婁紶3涓<33>啋鎵归噺杩愯<E69DA9> | 3涓<33>兘瀹屾垚 |
| 状态筛选 | 上传→筛选待处理 | 正确过滤 |
- [ ] **4.1.1** 执行端到端测试
- [ ] **4.1.2** 修复发现的问题
| 鐘舵€佺瓫閫?| 涓婁紶鈫掔瓫閫夊緟澶勭悊 | 姝g‘杩囨护 |
- [ ] **4.1.1** 鎵ц<E98EB5><EFBFBD>埌绔<E59F8C>祴璇?- [ ] **4.1.2** 淇<><E6B787>鍙戠幇鐨勯棶棰?
**4.2 鎬ц兘娴嬭瘯**
| 鎸囨爣 | 鐩<>爣 | 瀹為檯 |
|------|------|------|
| 列表加载 | < 1秒 | ⬜ |
| 单文件审查 | < 2分钟 | |
| 5文件并发 | < 5分钟 | |
| 鍒楄〃鍔犺浇 | < 1绉?| 猬?|
| 鍗曟枃浠跺<EFBFBD>鏌?| < 2鍒嗛挓 | 猬?|
| 5鏂囦欢骞跺彂 | < 5鍒嗛挓 | 猬?|
- [ ] **4.2.1** 鎵ц<E98EB5>鎬ц兘娴嬭瘯
**4.3 兼容性测试**
- [ ] **4.3.1** Chrome浏览器测试
- [ ] **4.3.2** Edge浏览器测试
- [ ] **4.3.3** 旧API兼容性确认
**4.3 鍏煎<EFBFBD>鎬ф祴璇?*
- [ ] **4.3.1** Chrome娴忚<E5A8B4>鍣ㄦ祴璇?- [ ] **4.3.2** Edge娴忚<E5A8B4>鍣ㄦ祴璇?- [ ] **4.3.3** 鏃<>PI鍏煎<E98D8F>х璁?
---
### Phase 5验收与上线0.5天)
### Phase 5锛氶獙鏀朵笌涓婄嚎锛?.5澶╋級
**5.1 MVP楠屾敹鏍囧噯**
| 验收项 | 预期结果 | 通过 |
| 楠屾敹椤?| 棰勬湡缁撴灉 | 閫氳繃 |
|--------|---------|:----:|
| 流程通 | 5个PDF3分钟内全部完成 | ⬜ |
| 规范性准确 | 删掉摘要结论必须报错 | |
| 方法学准确 | 混淆统计方法必须报存疑 | ⬜ |
| 无崩溃 | 连续上传20个不卡死 | |
| 娴佺▼閫?| 5涓狿DF锛?鍒嗛挓鍐呭叏閮ㄥ畬鎴?| 猬?|
| 瑙勮寖鎬у噯纭?| 鍒犳帀鎽樿<E98EBD>缁撹<E7BC81>蹇呴』鎶ラ敊 | 猬?|
| 鏂规硶瀛﹀噯纭?| 娣锋穯缁熻<E7BC81>鏂规硶蹇呴』鎶ュ瓨鐤?| 猬?|
| 鏃犲穿婧?| 杩炵画涓婁紶20涓<30>笉鍗℃<E98D97> | 猬?|
- [ ] **5.1.1** 鎵ц<E98EB5>楠屾敹娴嬭瘯
- [ ] **5.1.2** 缂栧啓楠屾敹鎶ュ憡
@@ -749,20 +680,19 @@ interface AgentSelectorProps {
- [ ] **5.2.1** 鏇存柊鏂囨。
- [ ] **5.2.2** 閫氱煡鐩稿叧浜哄憳
- [ ] **5.2.3** 监控上线后状态
- [ ] **5.2.3** 鐩戞帶涓婄嚎鍚庣姸鎬?
---
## 馃搮 鏃堕棿浼扮畻
| Phase | 任务 | 预估工时 | 验证点 |
| Phase | 浠诲姟 | 棰勪及宸ユ椂 | 楠岃瘉鐐?|
|-------|------|---------|--------|
| **Phase 1** | 后端模块迁移 | 2天 | ✓ API测试通过 |
| **Phase 2** | 数据库迁移 | 0.5天 | ✓ 数据完整性验证 |
| **Phase 3** | 前端重构 | 3天 | ✓ 功能测试通过 |
| **Phase 4** | 集成测试 | 1天 | ✓ 端到端测试通过 |
| **Phase 5** | 验收上线 | 0.5天 | ✓ MVP验收通过 |
| **总计** | - | **7天** | - |
| **Phase 1** | 鍚庣<EFBFBD>妯″潡杩佺Щ | 2澶?| 鉁?API娴嬭瘯閫氳繃 |
| **Phase 2** | 鏁版嵁搴撹縼绉?| 0.5澶?| 鉁?鏁版嵁瀹屾暣鎬ч獙璇?|
| **Phase 3** | 鍓嶇<EFBFBD>閲嶆瀯 | 3澶?| 鉁?鍔熻兘娴嬭瘯閫氳繃 |
| **Phase 4** | 闆嗘垚娴嬭瘯 | 1澶?| 鉁?绔<>埌绔<E59F8C>祴璇曢€氳繃 |
| **Phase 5** | 楠屾敹涓婄嚎 | 0.5澶?| 鉁?MVP楠屾敹閫氳繃 |
| **鎬昏<EFBFBD>** | - | **7澶?* | - |
---
@@ -770,41 +700,38 @@ interface AgentSelectorProps {
| 鍔熻兘 | 棰勭暀瀛楁<E7809B> | 鍚庣画璁″垝 |
|------|---------|---------|
| **PICO卡片** | `pico_extract` | 方法学评估扩展 |
| **系统设置** | `JournalConfig`表 | 期刊Logo/模型配置 |
| **PICO鍗$墖** | `pico_extract` | 鏂规硶瀛﹁瘎浼版墿灞?|
| **绯荤粺璁剧疆** | `JournalConfig`琛?| 鏈熷垔Logo/妯″瀷閰嶇疆 |
| **鍘嗗彶褰掓。** | `is_archived`, `archived_at` | 鑷<>姩褰掓。7澶╁墠鏁版嵁 |
| **登录页面** | - | 独立产品时开发 |
| **鐧诲綍椤甸潰** | - | <EFBFBD>珛浜у搧鏃跺紑鍙?|
---
## 鈿狅笍 椋庨櫓鎺у埗
### 1. 数据库迁移风险
### 1. 鏁版嵁搴撹縼绉婚<EFBFBD>闄?
| 椋庨櫓 | 姒傜巼 | 褰卞搷 | 鎺у埗鎺<E59F97>柦 |
|------|------|------|---------|
| 数据丢失 | 低 | 高 | 迁移前备份 |
| 迁移失败 | 中 | 中 | 准备回滚SQL |
| 性能下降 | 低 | 中 | 验证索引有效性 |
| 鏁版嵁涓㈠け | 浣?| 楂?| 杩佺Щ鍓嶅<E98D93>浠?|
| 杩佺Щ澶辫触 | 涓?| 涓?| 鍑嗗<E98D91>鍥炴粴SQL |
| 鎬ц兘涓嬮檷 | 浣?| 涓?| 楠岃瘉绱㈠紩鏈夋晥鎬?|
### 2. 鍔熻兘鍥炲綊椋庨櫓
| 椋庨櫓 | 姒傜巼 | 褰卞搷 | 鎺у埗鎺<E59F97>柦 |
|------|------|------|---------|
| 旧API中断 | 低 | 高 | 保留v1路由 |
| 评估结果异常 | 低 | 高 | 对比测试结果 |
| 前端白屏 | 中 | 中 | 阶段性测试 |
| <EFBFBD>PI涓<EFBFBD>柇 | 浣?| 楂?| 淇濈暀v1璺<31> |
| 璇勪及缁撴灉寮傚父 | 浣?| 楂?| 瀵规瘮娴嬭瘯缁撴灉 |
| 鍓嶇<EFBFBD>鐧藉睆 | 涓?| 涓?| 闃舵<E99783>鎬ф祴璇?|
### 3. 鍥炴粴璁″垝
```bash
# 如果需要回滚到迁移前状态
# 濡傛灉闇€瑕佸洖婊氬埌杩佺Щ鍓嶇姸鎬?
# 1. 鍋滄<E98D8B>鏈嶅姟
pm2 stop all
# 2. 回滚数据库
pg_restore -h localhost -U postgres -d airesearch -c backup_phase2.dump
# 2. 鍥炴粴鏁版嵁搴?pg_restore -h localhost -U postgres -d airesearch -c backup_phase2.dump
# 3. 鍒囨崲鍒版棫浠g爜鍒嗘敮
git checkout main
@@ -815,15 +742,14 @@ pm2 start all
---
## 📚 参考文档
- [智能期刊审稿系统MVP PRD](../01-需求分析/智能期刊审稿系统%20MVP%20产品需求文档.md)
- [智能审稿V7原型](../01-需求分析/智能审稿V7.html)
- [云原生开发规范](../../04-开发规范/08-云原生开发规范.md)
- [现有系统技术摸底报告](../../00-项目概述/现有系统技术摸底报告.md)
## 馃摎 鍙傝€冩枃妗?
- [鏅鸿兘鏈熷垔瀹ǹ绯荤粺MVP PRD](../01-闇€姹傚垎鏋?鏅鸿兘鏈熷垔瀹$ǹ绯荤粺%20MVP%20浜у搧闇€姹傛枃妗?md)
- [鏅鸿兘瀹ǹV7鍘熷瀷](../01-闇€姹傚垎鏋?鏅鸿兘瀹ǹV7.html)
- [浜戝師鐢熷紑鍙戣<EFBFBD>鑼僝(../../04-寮€鍙戣<E98D99>鑼?08-浜戝師鐢熷紑鍙戣<E98D99>鑼?md)
- [鐜版湁绯荤粺鎶€鏈<EFBFBD>懜搴曟姤鍛奭(../../00-椤圭洰姒傝堪/鐜版湁绯荤粺鎶€鏈<E282AC>懜搴曟姤鍛?md)
---
**文档版本:** v2.1
**鏂囨。鐗堟湰锛?* v2.1
**鏈€鍚庢洿鏂帮細** 2026-01-07
**涓嬩竴姝ワ細**<><E7BAAD>鍚庡紑濮婸hase 1