AIclinicalresearch/docs/08-项目管理/PKB和RVW功能迁移计划.md

PKB（个人知识库）和 RVW（审稿功能）迁移计划

创建日期： 2025-12-28
维护者： 技术团队
目标： 将已开发的PKB和RVW功能迁移到最新的模块化架构上

---

📋 执行摘要

迁移目标

将旧版本（frontend + backend/src/legacy）中的**个人知识库（PKB）和审稿功能（RVW）**迁移到新架构（frontend-v2 + backend/src/modules），使其符合最新的模块化、云原生设计规范。

当前状态

功能	旧架构位置	完成度	数据库Schema	前端UI
PKB 个人知识库	backend/src/legacy + frontend/src	✅ 100%	pkb_schema	✅ 完整UI
RVW 审稿功能	backend/src/legacy + frontend/src	✅ 100%	public.ReviewTask	✅ 完整UI

迁移优先级

1. P0（最高优先级）: PKB个人知识库 - 已100%完成，迁移风险低
2. P1（高优先级）: RVW审稿功能 - 已100%完成，迁移风险低

---

🔍 已有功能深度分析

一、PKB（个人知识库）功能详情

1.1 功能特性

核心能力：

• ✅ 知识库CRUD：创建、查看、编辑、删除知识库
• ✅ 配额管理：每用户3个知识库，每库50个文档
• ✅ 文档上传：支持PDF、Word、TXT、Markdown
• ✅ 文档状态追踪：uploading → parsing → indexing → completed/error
• ✅ Dify RAG集成：基于Dify平台的向量检索
• ✅ 语义检索：支持多知识库联合检索，top_k=15
• ✅ 统计信息：文档数、Token数、段落数统计
• ✅ 全文阅读模式（Phase2）：Token限制、智能文档选择

技术亮点：

• 🏆 Python微服务集成：调用extraction_service提取文档文本
• 🏆 Dify Dataset管理：每个知识库对应一个Dify Dataset
• 🏆 Token精确计算：使用tiktoken计算Token数，双重限制（50文件 + 980K tokens）
• 🏆 智能文档选择：基于Token容量的智能推荐算法

1.2 数据库结构

PKB Schema（pkb_schema）：

model KnowledgeBase {
  id             String   @id @default(uuid())
  userId         String
  name           String
  description    String?
  difyDatasetId  String   // 映射到Dify
  fileCount      Int      @default(0)
  totalSizeBytes BigInt   @default(0)
  createdAt      DateTime @default(now())
  updatedAt      DateTime @updatedAt
  
  documents      Document[]
  batchTasks     BatchTask[]
}

model Document {
  id                String    @id @default(uuid())
  kbId              String
  userId            String
  filename          String
  fileType          String
  fileSizeBytes     BigInt
  fileUrl           String
  difyDocumentId    String
  status            String    // uploading/parsing/indexing/completed/error
  progress          Int       @default(0)
  errorMessage      String?
  segmentsCount     Int?
  tokensCount       Int?
  extractionMethod  String?   // nougat/pymupdf/mammoth
  extractionQuality Float?
  charCount         Int?
  language          String?   // chinese/english
  extractedText     String?   // Phase2：全文存储
  uploadedAt        DateTime  @default(now())
  processedAt       DateTime?
}

model BatchTask {
  id              String    @id @default(uuid())
  userId          String
  kbId            String
  name            String
  templateType    String
  templateId      String?
  prompt          String
  status          String
  totalDocuments  Int
  completedCount  Int       @default(0)
  failedCount     Int       @default(0)
  modelType       String
  concurrency     Int       @default(3)
  startedAt       DateTime?
  completedAt     DateTime?
  durationSeconds Int?
  
  results         BatchResult[]
}

1.3 后端代码结构

服务层（backend/src/legacy/services/）：

knowledgeBaseService.ts (365行)
├── createKnowledgeBase()      // 创建知识库（Dify Dataset）
├── getKnowledgeBases()        // 获取列表
├── getKnowledgeBaseById()     // 获取详情
├── updateKnowledgeBase()      // 更新
├── deleteKnowledgeBase()      // 删除（级联删除Dify Dataset）
├── searchKnowledgeBase()      // 语义检索（调用Dify API）
├── getKnowledgeBaseStats()    // 统计信息
└── getDocumentSelection()     // 智能文档选择（Phase2）

documentService.ts
├── uploadDocument()           // 上传文档
├── getDocuments()             // 获取文档列表
├── deleteDocument()           // 删除文档
├── reprocessDocument()        // 重新处理
└── pollDocumentStatus()       // 轮询状态

tokenService.ts (243行)
├── calculateDocumentTokens()  // 计算Token
├── selectDocumentsForFullText() // 智能选择
└── TOKEN_LIMITS 常量

控制器层（backend/src/legacy/controllers/）：

knowledgeBaseController.ts (341行)
├── POST   /knowledge-bases
├── GET    /knowledge-bases
├── GET    /knowledge-bases/:id
├── PUT    /knowledge-bases/:id
├── DELETE /knowledge-bases/:id
├── GET    /knowledge-bases/:id/search
├── GET    /knowledge-bases/:id/stats
└── GET    /knowledge-bases/:id/document-selection

documentController.ts
├── POST   /knowledge-bases/:kbId/documents
├── GET    /knowledge-bases/:kbId/documents
├── GET    /documents/:id
├── GET    /documents/:id/full-text
├── DELETE /documents/:id
└── POST   /documents/:id/reprocess

1.4 前端代码结构

主页面（frontend/src/pages/KnowledgePage.tsx）： 281行

• 知识库列表视图
• 知识库详情视图（Tabs：文档管理 + 统计信息）
• 双进度条容量显示（文件数 + Token数）

组件（frontend/src/components/knowledge/）：

KnowledgeBaseList.tsx      // 知识库卡片列表
CreateKBDialog.tsx         // 创建对话框
EditKBDialog.tsx           // 编辑对话框
DocumentList.tsx           // 文档列表（含状态徽章）
DocumentUpload.tsx         // 文件上传（拖拽支持）

状态管理（frontend/src/stores/useKnowledgeBaseStore.ts）：

• Zustand状态管理
• API调用封装
• 实时状态轮询（5秒间隔）

---

二、RVW（审稿功能）功能详情

2.1 功能特性

核心能力：

• ✅ 稿件上传：支持Word文档（.doc/.docx），最大5MB
• ✅ 双维度评估：
  • 稿约规范性评估（11项标准）
  • 方法学评估（3大部分）
• ✅ 基于真实期刊标准：《中华医学超声杂志》稿约
• ✅ 智能分析：使用LLM进行结构化评估
• ✅ 完整报告：JSON格式结果，支持导出PDF/复制文本
• ✅ 模型选择：DeepSeek-V3 / Qwen3-72B / Qwen-Long
• ✅ 任务管理：任务列表、状态追踪、进度显示

评估标准：

稿约规范性评估（11项）：

1. 文题（Title）
2. 作者（Authors）
3. 中文摘要（Chinese Abstract）
4. 英文摘要（English Abstract）
5. 中文关键词（Chinese Keywords）
6. 英文关键词（English Keywords）
7. 正文（Main Text）
8. 参考文献（References）
9. 图表（Figures and Tables）
10. 利益冲突（Conflict of Interest）
11. 伦理审查（Ethics Approval）

方法学评估（3部分）：

1. 科研设计（Research Design）
2. 统计方法（Statistical Methods）
3. 统计分析（Statistical Analysis）

2.2 数据库结构

ReviewTask表（当前在public schema，需迁移到rvw_schema）：

model ReviewTask {
  id                 String    @id @default(uuid())
  userId             String
  fileName           String
  fileSize           BigInt
  extractedText      String?
  wordCount          Int?
  status             String    // pending/extracting/reviewing_editorial/reviewing_methodology/completed/failed
  modelUsed          String
  overallScore       Float?
  editorialReview    Json?     // 稿约规范性评估结果
  methodologyReview  Json?     // 方法学评估结果
  errorMessage       String?
  startedAt          DateTime?
  completedAt        DateTime?
  durationSeconds    Int?
  createdAt          DateTime  @default(now())
}

2.3 后端代码结构

服务层（backend/src/legacy/services/reviewService.ts）： 453行

reviewManuscript()           // 主入口（异步执行）
processReviewTask()          // 后台处理任务
reviewEditorialStandards()   // 稿约规范性评估
reviewMethodology()          // 方法学评估
parseJSONFromLLMResponse()   // 容错JSON解析
getReviewTask()              // 获取任务状态
getReviewTasks()             // 获取任务列表（分页）
deleteReviewTask()           // 删除任务
getReviewReport()            // 获取完整报告

Prompt设计（backend/prompts/）：

review_editorial_system.txt (210行)
└── 11个评估维度的详细标准

review_methodology_system.txt (231行)
└── 3个部分的评估标准

控制器层（backend/src/legacy/controllers/reviewController.ts）： 265行

POST   /review/upload                 // 上传稿件并开始审查
GET    /review/tasks/:taskId           // 获取任务状态
GET    /review/tasks/:taskId/report    // 获取审查报告
GET    /review/tasks                   // 获取任务列表（分页）
DELETE /review/tasks/:taskId           // 删除任务

2.4 前端代码结构

主页面（frontend/src/pages/ReviewPage.tsx）： 625行

• 渐变色标题卡片
• 3步流程：上传稿件 → 选择模型 → 开始审查
• 5步进度展示：上传 → 提取文本 → 稿约评估 → 方法学评估 → 生成报告
• 报告展示（Tabs切换）
• 导出功能（PDF生成 + 文本复制）

组件（frontend/src/components/review/）：

ScoreCard.tsx              // 分数卡片（颜色编码）
EditorialReview.tsx        // 稿约规范性评估详情
MethodologyReview.tsx      // 方法学评估详情

视觉设计：

• 渐变色主题：linear-gradient(135deg, #667eea 0%, #764ba2 100%)
• 分数颜色编码：≥90优秀（绿）、≥80良好（蓝）、≥70中等（黄）、<70需改进（红）
• 拖拽上传支持
• 响应式布局

---

🎯 迁移策略

迁移原则

1. 保持功能完整性：100%保留现有功能，不做删减
2. 遵循新架构规范：符合模块化、Schema隔离、云原生设计
3. 复用平台能力：使用common层的存储、日志、LLM、文档处理服务
4. 渐进式迁移：先后端再前端，确保每步可测试
5. 保持数据兼容：数据库表结构平滑迁移，不丢失数据

---

📋 迁移任务清单

Phase 1: PKB个人知识库迁移（优先）

Task 1.1：后端代码迁移 ⏱️ 预计2-3小时

目标目录： backend/src/modules/pkb/

迁移步骤：

1. 创建模块结构 (30分钟)

   backend/src/modules/pkb/
   ├── README.md                      # 模块说明
   ├── controllers/
   │   ├── knowledgeBaseController.ts # 从legacy迁移
   │   └── documentController.ts      # 从legacy迁移
   ├── services/
   │   ├── knowledgeBaseService.ts    # 从legacy迁移
   │   ├── documentService.ts         # 从legacy迁移
   │   └── tokenService.ts            # 从legacy迁移
   ├── routes/
   │   └── index.ts                   # 路由注册
   └── types/
       └── index.ts                   # 类型定义
   

2. 复制并更新服务层 (60分钟)

   • 从backend/src/legacy/services/复制文件
   • 更新导入路径：

     // ❌ 旧代码
     import { prisma } from '../../config/database.js';
     import { difyClient } from '../../common/rag/DifyClient.js';
     
     // ✅ 新代码
     import { prisma } from '@/config/database';
     import { difyClient } from '@/common/rag/DifyClient';
     

   • 使用平台能力：

     // ✅ 使用storage抽象层（如果需要文件存储）
     import { storage } from '@/common/storage';
     
     // ✅ 使用logger（替换console.log）
     import { logger } from '@/common/logging';
     
     // ✅ 使用extractionClient（已有）
     import { extractionClient } from '@/common/document/ExtractionClient';
     

3. 复制并更新控制器层 (30分钟)

   • 从backend/src/legacy/controllers/复制文件
   • 更新导入路径
   • 移除MOCK_USER_ID，从request.user获取（待实现认证中间件）

4. 创建路由文件 (30分钟)

   // backend/src/modules/pkb/routes/index.ts
   import type { FastifyInstance } from 'fastify';
   import * as knowledgeBaseController from '../controllers/knowledgeBaseController';
   import * as documentController from '../controllers/documentController';
   
   export default async function pkbRoutes(fastify: FastifyInstance) {
     // 知识库管理
     fastify.post('/api/v1/pkb/knowledge-bases', knowledgeBaseController.createKnowledgeBase);
     fastify.get('/api/v1/pkb/knowledge-bases', knowledgeBaseController.getKnowledgeBases);
     fastify.get('/api/v1/pkb/knowledge-bases/:id', knowledgeBaseController.getKnowledgeBaseById);
     fastify.put('/api/v1/pkb/knowledge-bases/:id', knowledgeBaseController.updateKnowledgeBase);
     fastify.delete('/api/v1/pkb/knowledge-bases/:id', knowledgeBaseController.deleteKnowledgeBase);
     fastify.get('/api/v1/pkb/knowledge-bases/:id/search', knowledgeBaseController.searchKnowledgeBase);
     fastify.get('/api/v1/pkb/knowledge-bases/:id/stats', knowledgeBaseController.getKnowledgeBaseStats);
     fastify.get('/api/v1/pkb/knowledge-bases/:id/document-selection', knowledgeBaseController.getDocumentSelection);
   
     // 文档管理
     fastify.post('/api/v1/pkb/knowledge-bases/:kbId/documents', documentController.uploadDocument);
     fastify.get('/api/v1/pkb/knowledge-bases/:kbId/documents', documentController.getDocuments);
     fastify.get('/api/v1/pkb/documents/:id', documentController.getDocumentById);
     fastify.get('/api/v1/pkb/documents/:id/full-text', documentController.getDocumentFullText);
     fastify.delete('/api/v1/pkb/documents/:id', documentController.deleteDocument);
     fastify.post('/api/v1/pkb/documents/:id/reprocess', documentController.reprocessDocument);
   }
   

5. 在主入口注册路由 (10分钟)

   // backend/src/index.ts
   import pkbRoutes from './modules/pkb/routes';
   
   // 注册PKB路由
   await fastify.register(pkbRoutes);
   

6. 创建模块README (20分钟)

   # PKB 个人知识库模块
   
   ## 功能概述
   - 知识库CRUD
   - 文档上传与管理
   - Dify RAG检索
   - 批处理任务
   
   ## API端点
   ...
   
   ## 数据库Schema
   - pkb_schema.knowledge_bases
   - pkb_schema.documents
   - pkb_schema.batch_tasks
   - pkb_schema.batch_results
   

Task 1.2：前端代码迁移 ⏱️ 预计2-3小时

目标目录： frontend-v2/src/modules/pkb/

迁移步骤：

1. 创建模块结构 (30分钟)

   frontend-v2/src/modules/pkb/
   ├── index.tsx                # 模块入口（路由配置）
   ├── api/
   │   └── index.ts             # API封装
   ├── pages/
   │   ├── KnowledgeBasePage.tsx  # 知识库列表页
   │   └── KnowledgeBaseDetail.tsx # 知识库详情页
   ├── components/
   │   ├── KnowledgeBaseList.tsx
   │   ├── CreateKBDialog.tsx
   │   ├── EditKBDialog.tsx
   │   ├── DocumentList.tsx
   │   └── DocumentUpload.tsx
   ├── hooks/
   │   └── useKnowledgeBase.ts  # 状态管理
   └── types/
       └── index.ts             # 类型定义
   

2. 复制并更新API层 (30分钟)

   • 从frontend/src/api/knowledgeBaseApi.ts复制
   • 更新API路径：/api/knowledge-bases → /api/v1/pkb/knowledge-bases

3. 复制并更新组件 (90分钟)

   • 从frontend/src/components/knowledge/复制所有组件
   • 更新导入路径
   • 使用新的request实例（如果有）
   • 保持Ant Design 6.0组件兼容性

4. 复制并更新主页面 (60分钟)

   • 从frontend/src/pages/KnowledgePage.tsx复制
   • 拆分为两个页面：列表页 + 详情页（可选）
   • 更新状态管理：Zustand → React Query或保持Zustand

5. 创建模块入口 (30分钟)

   // frontend-v2/src/modules/pkb/index.tsx
   import { lazy } from 'react';
   import { ModuleConfig } from '@/framework/modules/types';
   
   const KnowledgeBasePage = lazy(() => import('./pages/KnowledgeBasePage'));
   
   const pkbModule: ModuleConfig = {
     id: 'pkb',
     name: '个人知识库',
     icon: 'FileTextOutlined',
     routes: [
       {
         path: '/pkb',
         element: <KnowledgeBasePage />,
         permission: 'pkb:view',
       },
     ],
   };
   
   export default pkbModule;
   

6. 在框架中注册模块 (10分钟)

   // frontend-v2/src/framework/modules/moduleRegistry.ts
   import pkbModule from '@/modules/pkb';
   
   registerModule(pkbModule);
   

Task 1.3：数据库Schema验证 ⏱️ 预计30分钟

检查事项：

• ✅ pkb_schema.knowledge_bases 表结构完整
• ✅ pkb_schema.documents 表结构完整
• ✅ pkb_schema.batch_tasks 表结构完整
• ✅ pkb_schema.batch_results 表结构完整
• ✅ 外键关系正确
• ✅ 索引齐全

Prisma Schema已存在，无需修改。

Task 1.4：集成测试 ⏱️ 预计1小时

测试清单：

1. ✅ 创建知识库
2. ✅ 上传文档（PDF/Word）
3. ✅ 文档状态轮询
4. ✅ 语义检索
5. ✅ 删除文档
6. ✅ 删除知识库
7. ✅ Token计算和智能选择
8. ✅ 批处理任务创建和执行

---

Phase 2: RVW审稿功能迁移

Task 2.1：后端代码迁移 ⏱️ 预计2-3小时

目标目录： backend/src/modules/rvw/

迁移步骤：

1. 创建模块结构 (30分钟)

   backend/src/modules/rvw/
   ├── README.md
   ├── controllers/
   │   └── reviewController.ts
   ├── services/
   │   └── reviewService.ts
   ├── routes/
   │   └── index.ts
   ├── prompts/
   │   ├── editorial_system.txt   # 从backend/prompts/复制
   │   └── methodology_system.txt # 从backend/prompts/复制
   └── types/
       └── index.ts
   

2. 复制并更新服务层 (60分钟)

   • 从backend/src/legacy/services/reviewService.ts复制
   • 更新导入路径
   • 使用平台能力：

     import { logger } from '@/common/logging';
     import { extractionClient } from '@/common/document/ExtractionClient';
     import { LLMFactory } from '@/common/llm/adapters/LLMFactory';
     

   • 移动Prompt文件到模块内部

3. 复制并更新控制器层 (30分钟)

   • 从backend/src/legacy/controllers/reviewController.ts复制
   • 更新导入路径

4. 创建路由文件 (30分钟)

   // backend/src/modules/rvw/routes/index.ts
   import type { FastifyInstance } from 'fastify';
   import * as reviewController from '../controllers/reviewController';
   
   export default async function rvwRoutes(fastify: FastifyInstance) {
     fastify.post('/api/v1/rvw/upload', reviewController.uploadManuscript);
     fastify.get('/api/v1/rvw/tasks/:taskId', reviewController.getTaskStatus);
     fastify.get('/api/v1/rvw/tasks/:taskId/report', reviewController.getTaskReport);
     fastify.get('/api/v1/rvw/tasks', reviewController.getTaskList);
     fastify.delete('/api/v1/rvw/tasks/:taskId', reviewController.deleteTask);
   }
   

5. 在主入口注册路由 (10分钟)

   // backend/src/index.ts
   import rvwRoutes from './modules/rvw/routes';
   
   await fastify.register(rvwRoutes);
   

Task 2.2：数据库Schema迁移 ⏱️ 预计1小时

当前问题： ReviewTask表在public schema，需迁移到rvw_schema

迁移步骤：

1. 更新Prisma Schema (20分钟)

   // backend/prisma/schema.prisma
   model ReviewTask {
     id                 String    @id @default(uuid())
     userId             String    @map("user_id")
     fileName           String    @map("file_name")
     fileSize           BigInt    @map("file_size")
     extractedText      String?   @map("extracted_text")
     wordCount          Int?      @map("word_count")
     status             String    @default("pending")
     modelUsed          String    @map("model_used")
     overallScore       Float?    @map("overall_score")
     editorialReview    Json?     @map("editorial_review")
     methodologyReview  Json?     @map("methodology_review")
     errorMessage       String?   @map("error_message")
     startedAt          DateTime? @map("started_at")
     completedAt        DateTime? @map("completed_at")
     durationSeconds    Int?      @map("duration_seconds")
     createdAt          DateTime  @default(now()) @map("created_at")
   
     @@index([userId], map: "idx_rvw_tasks_user_id")
     @@index([status], map: "idx_rvw_tasks_status")
     @@index([createdAt], map: "idx_rvw_tasks_created_at")
     @@map("review_tasks")
     @@schema("rvw_schema")  // ⭐ 迁移到rvw_schema
   }
   

2. 创建迁移脚本 (20分钟)

   -- backend/prisma/migrations/migrate_review_to_rvw_schema.sql
   
   -- 1. 创建rvw_schema（如果不存在）
   CREATE SCHEMA IF NOT EXISTS rvw_schema;
   
   -- 2. 在rvw_schema中创建新表
   CREATE TABLE rvw_schema.review_tasks (
     -- 复制public.ReviewTask表结构
     -- 添加蛇形命名（user_id, file_name等）
   );
   
   -- 3. 迁移数据
   INSERT INTO rvw_schema.review_tasks
   SELECT * FROM public."ReviewTask";
   
   -- 4. 创建索引
   CREATE INDEX idx_rvw_tasks_user_id ON rvw_schema.review_tasks(user_id);
   CREATE INDEX idx_rvw_tasks_status ON rvw_schema.review_tasks(status);
   CREATE INDEX idx_rvw_tasks_created_at ON rvw_schema.review_tasks(created_at);
   
   -- 5. 验证数据
   SELECT COUNT(*) FROM rvw_schema.review_tasks;
   
   -- 6. 备份后删除旧表（可选）
   -- DROP TABLE public."ReviewTask";
   

3. 运行迁移 (20分钟)

   # 生成Prisma Client
   cd backend
   npx prisma generate
   
   # 运行手动迁移脚本
   psql $DATABASE_URL < prisma/migrations/migrate_review_to_rvw_schema.sql
   
   # 验证
   npm run test:db
   

Task 2.3：前端代码迁移 ⏱️ 预计2-3小时

目标目录： frontend-v2/src/modules/rvw/

迁移步骤：

1. 创建模块结构 (30分钟)

   frontend-v2/src/modules/rvw/
   ├── index.tsx
   ├── api/
   │   └── index.ts
   ├── pages/
   │   ├── ReviewPage.tsx
   │   └── ReviewList.tsx (可选)
   ├── components/
   │   ├── ScoreCard.tsx
   │   ├── EditorialReview.tsx
   │   └── MethodologyReview.tsx
   ├── hooks/
   │   └── useReviewTask.ts
   └── types/
       └── index.ts
   

2. 复制并更新API层 (30分钟)

   • 从frontend/src/api/reviewApi.ts复制
   • 更新API路径：/api/review → /api/v1/rvw

3. 复制并更新组件 (60分钟)

   • 从frontend/src/components/review/复制所有组件
   • 保持视觉设计（渐变色、颜色编码）

4. 复制并更新主页面 (90分钟)

   • 从frontend/src/pages/ReviewPage.tsx复制
   • 保持完整UI流程
   • 更新CSS导入（如果需要）

5. 创建模块入口 (30分钟)

   // frontend-v2/src/modules/rvw/index.tsx
   import { lazy } from 'react';
   import { ModuleConfig } from '@/framework/modules/types';
   
   const ReviewPage = lazy(() => import('./pages/ReviewPage'));
   
   const rvwModule: ModuleConfig = {
     id: 'rvw',
     name: '稿件审查',
     icon: 'FileTextOutlined',
     routes: [
       {
         path: '/rvw',
         element: <ReviewPage />,
         permission: 'rvw:view',
       },
     ],
   };
   
   export default rvwModule;
   

6. 在框架中注册模块 (10分钟)

Task 2.4：集成测试 ⏱️ 预计1小时

测试清单：

1. ✅ 上传Word稿件
2. ✅ 状态轮询（5个步骤）
3. ✅ 稿约规范性评估（11项）
4. ✅ 方法学评估（3部分）
5. ✅ 总体评分计算
6. ✅ 报告展示（Tabs切换）
7. ✅ 导出PDF
8. ✅ 复制报告文本
9. ✅ 任务列表查询
10. ✅ 删除任务

---

🔧 技术细节补充

关键依赖复用

已有平台能力（可直接复用）：

// ✅ 文档提取服务（已有）
import { extractionClient } from '@/common/document/ExtractionClient';
// 支持：PDF、Word、TXT，已集成Python微服务

// ✅ LLM网关（已有）
import { LLMFactory } from '@/common/llm/adapters/LLMFactory';
// 支持：DeepSeek-V3, Qwen-Max, GPT-5-Pro, Claude-4.5

// ✅ 存储服务（已有）
import { storage } from '@/common/storage';
// 支持：LocalAdapter ↔ OSSAdapter零代码切换

// ✅ 日志系统（已有）
import { logger } from '@/common/logging';

// ✅ RAG服务（已有，PKB需要）
import { difyClient } from '@/common/rag/DifyClient';

外部依赖

PKB模块额外依赖：

• ✅ Dify平台：已部署，提供RAG检索能力
• ✅ tiktoken：Token计算，已安装（@dqbd/tiktoken）
• ✅ Python微服务：文档提取，已部署

RVW模块额外依赖：

• ✅ html2canvas：PDF导出（前端），需安装
• ✅ jspdf：PDF生成（前端），需安装

API路径规范

新架构API路径：

PKB模块：
  /api/v1/pkb/knowledge-bases/*
  /api/v1/pkb/documents/*

RVW模块：
  /api/v1/rvw/upload
  /api/v1/rvw/tasks/*

旧架构API路径（需向后兼容）：

/api/knowledge-bases/*  （可保留，重定向到新路径）
/api/review/*           （可保留，重定向到新路径）

---

📝 数据迁移与向后兼容

PKB模块

• ✅ 无需数据迁移：pkb_schema已存在且结构完整
• ✅ API向后兼容：保留旧路径/api/knowledge-bases，内部转发到新路径

RVW模块

• ⚠️ 需要数据迁移：public.ReviewTask → rvw_schema.review_tasks
• ⚠️ 字段名调整：驼峰命名 → 蛇形命名（userId → user_id）
• ✅ API向后兼容：保留旧路径/api/review，内部转发到新路径

迁移脚本模板：

-- 创建新Schema
CREATE SCHEMA IF NOT EXISTS rvw_schema;

-- 创建新表（蛇形命名）
CREATE TABLE rvw_schema.review_tasks AS
SELECT
  id,
  "userId" AS user_id,
  "fileName" AS file_name,
  "fileSize" AS file_size,
  "extractedText" AS extracted_text,
  "wordCount" AS word_count,
  status,
  "modelUsed" AS model_used,
  "overallScore" AS overall_score,
  "editorialReview" AS editorial_review,
  "methodologyReview" AS methodology_review,
  "errorMessage" AS error_message,
  "startedAt" AS started_at,
  "completedAt" AS completed_at,
  "durationSeconds" AS duration_seconds,
  "createdAt" AS created_at
FROM public."ReviewTask";

-- 创建索引
CREATE INDEX idx_rvw_tasks_user_id ON rvw_schema.review_tasks(user_id);
CREATE INDEX idx_rvw_tasks_status ON rvw_schema.review_tasks(status);
CREATE INDEX idx_rvw_tasks_created_at ON rvw_schema.review_tasks(created_at);

---

✅ 验收标准

PKB模块迁移完成标准

1. ✅ 后端代码在backend/src/modules/pkb/
2. ✅ 前端代码在frontend-v2/src/modules/pkb/
3. ✅ API路径为/api/v1/pkb/*
4. ✅ 所有功能测试通过（知识库CRUD、文档上传、检索、批处理）
5. ✅ 前端UI完全迁移（列表、详情、上传、对话框）
6. ✅ 复用平台能力（logger、storage、extractionClient、difyClient）
7. ✅ 文档完整（README.md、API文档）

RVW模块迁移完成标准

1. ✅ 后端代码在backend/src/modules/rvw/
2. ✅ 前端代码在frontend-v2/src/modules/rvw/
3. ✅ API路径为/api/v1/rvw/*
4. ✅ 数据已迁移到rvw_schema.review_tasks
5. ✅ 所有功能测试通过（上传、评估、报告、导出）
6. ✅ 前端UI完全迁移（上传、进度、报告、导出）
7. ✅ 复用平台能力（logger、extractionClient、LLMFactory）
8. ✅ Prompt文件在模块内部（modules/rvw/prompts/）

---

📚 文档更新清单

需要更新的文档

1. 系统当前状态与开发指南

   • 文件：docs/00-系统总体设计/00-系统当前状态与开发指南.md
   • 更新：PKB和RVW模块状态从"已完成（旧架构）"改为"✅ 100%（新架构）"

2. 模块README创建

   • backend/src/modules/pkb/README.md
   • backend/src/modules/rvw/README.md

3. 前端模块文档

   • frontend-v2/src/modules/pkb/README.md
   • frontend-v2/src/modules/rvw/README.md

4. API文档更新

   • docs/04-开发规范/04-API路由总览.md
   • 添加PKB和RVW的API端点清单

5. 迁移完成报告

   • 新建：docs/08-项目管理/PKB和RVW迁移完成报告.md
   • 记录：迁移时间、遇到的问题、解决方案、测试结果

---

🎯 总结

迁移优势

1. ✅ 架构统一：所有模块遵循相同的模块化结构
2. ✅ 易于维护：代码组织清晰，职责明确
3. ✅ 复用平台能力：减少重复代码，提升代码质量
4. ✅ 支持独立部署：每个模块可独立打包、部署、销售
5. ✅ Schema隔离：数据库层面模块独立，降低耦合

预计总耗时

• PKB模块迁移：6-8小时
• RVW模块迁移：7-9小时（含数据迁移）
• 总计：13-17小时（约2个工作日）

风险评估

• ✅ 风险低：功能已100%完成，代码质量高
• ✅ 测试覆盖：有完整的手动测试流程
• ✅ 向后兼容：保留旧API路径，不影响现有前端

---

文档维护者： 技术团队
最后更新： 2025-12-28
下一步： 执行迁移任务，按TODO清单逐项完成