AIclinicalresearch/docs/08-项目管理/下一阶段行动计划-V2.1-务实版.md

# 下一阶段行动计划 V2.1 - 10个Schema完整版

> **计划周期：** 2025-11-07 至 2025-12-06（4周）  
> **核心目标：** 10个Schema隔离完整实施 + 代码分层 + ASL核心功能  
> **制定时间：** 2025-11-07  
> **版本：** V2.1（10个Schema完整版）  
> **最后更新：** 2025-11-09

---

## 💡 核心变化亮点

> **🎯 决定：直接实施10个Schema，不分阶段！**

**为什么？**
- ✅ 额外成本仅6小时（5个空Schema无数据迁移）
- ✅ 现在是测试系统，最佳实施时机
- ✅ 架构一次到位，避免二次迁移
- ✅ Week 1有7天，时间完全够用

**变化：**
- 从"5个核心+5个预留" → **10个全部实施**
- 从"分阶段迁移" → **一次性完成**
- 新增SSA（智能统计分析）和ST（统计分析工具）两个Schema

---

## 🎯 V2.1 vs V2.0 的关键调整

| 项目 | V2.0 | V2.1（完整版）| 原因 |
|------|------|--------------|------|
| Schema数量 | 8个全做 | ✅ **10个全部实施** ⭐ | 额外成本仅6小时，一次到位 |
| 独立部署 | Week 2实施 | ❌ 暂不实施 | 当前重点是云端系统 |
| Docker化 | Week 2做 | ❌ 暂不做 | 不是当前重点 |
| Monorepo | 未提及 | ❌ 暂不采用 | 目录分层已够用 |
| 总时长 | 5周 | 4周 ⭐ | 去掉独立部署实施，节省1周 |

---

## 📊 整体规划 - 四周四阶段

```
Week 1（Schema基础）      Week 2（代码架构）      Week 3-4（ASL开发）
10个Schema全部隔离  →  代码分层+LLM网关  →  标题摘要初筛+全文复筛
```

| 阶段 | 时间 | 核心任务 | 交付成果 | 优先级 |
|------|------|---------|---------|--------|
| **阶段1** | Week 1 | **10个Schema全部隔离** ⭐ | 10个Schema完成 | P0 ⭐⭐⭐ |
| **阶段2** | Week 2 | 代码分层+LLM网关 | 三层架构+LLM网关 | P0 ⭐⭐⭐ |
| **阶段3** | Week 3 | ASL标题摘要初筛 | 双模型筛选功能 | P0 ⭐⭐ |
| **阶段4** | Week 4 | ASL全文复筛+测试 | 完整筛选流程 | P0 ⭐⭐ |

---

## 🚀 阶段1：10个Schema完整隔离（Week 1）

> **时间：** 2025-11-07 至 2025-11-13（7天）  
> **目标：** 一次性完成10个Schema的完整隔离，架构一步到位

### 核心原则：一次到位 ⭐⭐⭐

**全部创建的Schema（10个）：**

### 详细设计+迁移（3个）⭐ Week 1重点

**1. platform_schema** - 平台基础
- 迁移现有的users表（~10条数据）
- 为平台基础服务预留

**2. aia_schema** - AI智能问答 ⭐ 现有功能
- 迁移5个表：projects, conversations, messages, general_conversations, general_messages
- 数据量：~20个项目，~50条对话，~500条消息

**3. pkb_schema** - 个人知识库 ⭐ 现有功能
- 迁移2个表：knowledge_bases, documents
- 数据量：~5个知识库，~30个文档

---

### 只创建空Schema（7个）📋 命名空间预留

**4. asl_schema** - AI智能文献
- 📋 Week 3开发前再详细设计
- 避免现在过度设计，需求更明确时再做

**5. common_schema** - 通用能力
- 📋 需要时再创建表（LLM使用记录、Feature Flags）

**6. dc_schema** - 数据清洗
**7. rvw_schema** - 审稿系统
**8. admin_schema** - 运营管理
**9. ssa_schema** - 智能统计分析 ✨
**10. st_schema** - 统计分析工具 ✨

---

### 为什么采用"3详细+7空"策略？⭐⭐⭐

**核心原则：聚焦当前，架构预留**

**成本分析：**
- Week 1只处理3个Schema的迁移
- 其余7个只是`CREATE SCHEMA`（几秒钟）
- 总工作量从2天降低到**1.5天** ✅

**收益分析：**
1. ✅ **聚焦当前需求** - Week 1专注架构和迁移
2. ✅ **避免过度设计** - ASL等模块需求未最终确定
3. ✅ **Just-in-time设计** - 开发前再详细设计，更准确
4. ✅ **架构完整** - 10个命名空间已预留，随时扩展
5. ✅ **降低返工风险** - Week 3需求可能调整

---

### Day 1-2：Schema迁移准备（聚焦3个）

#### Day 1上午：10个Schema架构规划

**任务：规划完整的10个Schema架构**
- [ ] 绘制10个Schema的完整架构图（架构层面）
- [ ] 明确3个需要迁移的Schema
- [ ] 明确7个空Schema的用途
- [ ] 编写Schema架构文档

**输出文档：**
- `09-架构实施/01-Schema隔离架构设计（10个）.md`

**Schema依赖关系：**
```
业务模块Schema（AIA/PKB/ASL/DC/RVW/ADMIN/SSA/ST）
    ↓ 引用
Common Schema（通用数据，暂为空）
    ↓ 引用  
Platform Schema（用户、权限）
```

---

#### Day 1下午-Day 2上午：3个Schema详细设计 ⭐ 核心工作

**只详细设计需要迁移的3个Schema：**

**1. platform_schema（平台基础）**
```sql
CREATE SCHEMA platform_schema;

-- 用户表（从public.users迁移）
CREATE TABLE platform_schema.users (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    email VARCHAR(255) UNIQUE NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    name VARCHAR(255),
    avatar_url VARCHAR(500),
    role VARCHAR(50) NOT NULL DEFAULT 'user',
    status VARCHAR(50) DEFAULT 'active',
    kb_quota INT DEFAULT 3, -- 知识库配额
    kb_used INT DEFAULT 0,  -- 已使用
    trial_ends_at TIMESTAMP,
    is_trial BOOLEAN DEFAULT true,
    last_login_at TIMESTAMP,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```

**说明：** 用户表是所有Schema的基础，其他Schema的user_id都引用platform_schema.users。

---

**2. aia_schema（AI智能问答）** ⭐ 现有功能迁移
```sql
CREATE SCHEMA aia_schema;

-- 项目管理（从public.projects迁移）
CREATE TABLE aia_schema.projects (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL, -- 引用platform_schema.users
    name VARCHAR(255) NOT NULL,
    background TEXT DEFAULT '',
    research_type VARCHAR(50) DEFAULT 'observational',
    conversation_count INT DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);

-- 对话（从public.conversations迁移）
CREATE TABLE aia_schema.conversations (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL,
    project_id UUID REFERENCES aia_schema.projects(id) ON DELETE CASCADE,
    agent_id VARCHAR(100) NOT NULL,
    title VARCHAR(255) NOT NULL,
    model_name VARCHAR(50) DEFAULT 'deepseek-v3',
    message_count INT DEFAULT 0,
    total_tokens INT DEFAULT 0,
    metadata JSONB,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);

-- 消息（从public.messages迁移）
CREATE TABLE aia_schema.messages (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    conversation_id UUID REFERENCES aia_schema.conversations(id) ON DELETE CASCADE,
    role VARCHAR(20) NOT NULL, -- user/assistant
    content TEXT NOT NULL,
    model VARCHAR(50),
    metadata JSONB,
    tokens INT,
    is_pinned BOOLEAN DEFAULT false,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 通用对话（从public.general_conversations迁移）
CREATE TABLE aia_schema.general_conversations (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL,
    title VARCHAR(255) NOT NULL,
    model_name VARCHAR(50),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMP
);

-- 通用消息（从public.general_messages迁移）
CREATE TABLE aia_schema.general_messages (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    conversation_id UUID REFERENCES aia_schema.general_conversations(id) ON DELETE CASCADE,
    role VARCHAR(20) NOT NULL,
    content TEXT NOT NULL,
    model VARCHAR(50),
    metadata JSONB,
    tokens INT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```

**3. pkb_schema（个人知识库）** ⭐ 现有功能迁移
```sql
CREATE SCHEMA pkb_schema;

-- 知识库（从public.knowledge_bases迁移）
CREATE TABLE pkb_schema.knowledge_bases (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL, -- 引用platform_schema.users
    name VARCHAR(255) NOT NULL,
    description TEXT,
    dify_dataset_id VARCHAR(255) NOT NULL, -- Dify知识库ID
    file_count INT DEFAULT 0,
    total_size_bytes BIGINT DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 文档（从public.documents迁移）
CREATE TABLE pkb_schema.documents (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    kb_id UUID REFERENCES pkb_schema.knowledge_bases(id) ON DELETE CASCADE,
    user_id UUID NOT NULL,
    filename VARCHAR(255) NOT NULL,
    file_type VARCHAR(50) NOT NULL,
    file_size_bytes BIGINT NOT NULL,
    file_url TEXT NOT NULL,
    dify_document_id VARCHAR(255) NOT NULL, -- Dify文档ID
    status VARCHAR(50) DEFAULT 'uploading', -- uploading/processing/completed/failed
    progress INT DEFAULT 0,
    error_message TEXT,
    segments_count INT,
    tokens_count INT,
    -- Phase 2: 全文阅读模式字段
    extraction_method VARCHAR(50), -- pymupdf/nougat/mammoth/direct
    extraction_quality FLOAT, -- 0-1质量分数
    char_count INT,
    language VARCHAR(20), -- chinese/english
    extracted_text TEXT,
    uploaded_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    processed_at TIMESTAMP
);
```

---

#### Day 2下午：7个空Schema创建SQL 📋

**只需创建空Schema，不设计表结构：**

```sql
-- 创建7个空Schema（命名空间预留）
CREATE SCHEMA IF NOT EXISTS asl_schema;     -- AI智能文献，Week 3开发前再设计
CREATE SCHEMA IF NOT EXISTS common_schema;  -- 通用能力，需要时再创建表
CREATE SCHEMA IF NOT EXISTS dc_schema;      -- 数据清洗
CREATE SCHEMA IF NOT EXISTS rvw_schema;     -- 审稿系统
CREATE SCHEMA IF NOT EXISTS admin_schema;   -- 运营管理
CREATE SCHEMA IF NOT EXISTS ssa_schema;     -- 智能统计分析
CREATE SCHEMA IF NOT EXISTS st_schema;      -- 统计分析工具
```

**说明：**
- ✅ 只需几秒钟执行完成
- ✅ 命名空间已预留，不会冲突
- ✅ 需要时随时可以在对应Schema中创建表
- ✅ Prisma配置中可以先预留，暂不定义模型

---

---

#### Day 2下午：迁移脚本编写 ⭐

**任务：**
- [ ] 编写创建10个Schema的SQL脚本（3个详细+7个空）
- [ ] 编写3个Schema的数据迁移脚本
- [ ] 编写数据验证脚本
- [ ] 在本地测试环境验证

**迁移策略：**
1. 创建10个新Schema（3个详细+7个空，一次性）
2. 在3个Schema中创建表结构并迁移数据
3. 验证数据完整性
4. 清理public schema旧表（可选，因为是测试系统）

**输出脚本（5个）：**

| 脚本 | 说明 | 工作量 |
|------|------|--------|
| `001-create-all-10-schemas.sql` | 创建10个Schema ⭐ | 5分钟 |
| `002-migrate-platform.sql` | 迁移users表到platform_schema | 15分钟 |
| `003-migrate-aia.sql` | 迁移5个表到aia_schema | 30分钟 |
| `004-migrate-pkb.sql` | 迁移2个表到pkb_schema | 20分钟 |
| `005-validate-all.sql` | 验证数据完整性 | 10分钟 |

**总工作量：** ~1.5小时 ✅

---

### Day 3：执行3个Schema迁移 ⭐

**上午：执行迁移**
- [ ] 备份当前数据库（虽然是测试数据，但还是备份）
- [ ] 执行001脚本：创建10个Schema（3详细+7空）
- [ ] 执行002-004脚本：迁移3个Schema的数据（platform/aia/pkb）
- [ ] 执行005脚本：验证数据完整性

**下午：验证现有功能**
- [ ] 测试AI智能问答功能（使用aia_schema）
- [ ] 测试知识库功能（使用pkb_schema）
- [ ] 验证10个Schema全部创建
- [ ] 修复发现的问题

**验收标准：**
- [ ] ✅ 10个Schema全部创建成功
- [ ] ✅ 7个空Schema验证通过（ASL/Common/DC/RVW/ADMIN/SSA/ST）
- [ ] ✅ 现有功能（AIA、PKB）正常运行
- [ ] ✅ 数据迁移100%成功（~10条用户 + 50+对话 + 30+文档）

**预计时间：** 2-3小时 ✅

---

### Day 4-5：Prisma Schema更新 + 补充文档

#### Day 4上午：Prisma多Schema配置（3个详细+7个预留）

**任务：**
- [ ] 更新Prisma配置支持10个Schema
- [ ] 为3个Schema创建完整的Prisma模型（Platform/AIA/PKB）
- [ ] 为7个空Schema预留配置（只配置Schema名，无模型）
- [ ] 生成Prisma Client
- [ ] 单元测试

**Prisma配置示例：**
```prisma
// schema.prisma
generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["multiSchema"]
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
  schemas  = [
    "platform_schema",     // ✅ 已迁移，有模型
    "aia_schema",          // ✅ 已迁移，有模型
    "pkb_schema",          // ✅ 已迁移，有模型
    "asl_schema",          // 📋 空Schema，Week 3再定义模型
    "common_schema",       // 📋 空Schema，需要时再定义
    "dc_schema",           // 📋 空Schema
    "rvw_schema",          // 📋 空Schema
    "admin_schema",        // 📋 空Schema
    "ssa_schema",          // 📋 空Schema
    "st_schema"            // 📋 空Schema
  ]
}

// ===== 1. Platform Schema（平台基础）=====
model User {
  id           String   @id @default(uuid())
  email        String   @unique
  passwordHash String   @map("password_hash")
  name         String?
  avatarUrl    String?  @map("avatar_url")
  role         String   @default("user")
  status       String   @default("active")
  kbQuota      Int      @default(3) @map("kb_quota")
  kbUsed       Int      @default(0) @map("kb_used")
  trialEndsAt  DateTime? @map("trial_ends_at")
  isTrial      Boolean  @default(true) @map("is_trial")
  lastLoginAt  DateTime? @map("last_login_at")
  createdAt    DateTime @default(now()) @map("created_at")
  updatedAt    DateTime @updatedAt @map("updated_at")
  
  @@map("users")
  @@schema("platform_schema")
}

// ===== 2. AIA Schema（AI智能问答 - 迁移现有表）=====
model Project {
  id          String   @id @default(uuid())
  userId      String   @map("user_id")
  name        String
  description String?
  createdAt   DateTime @default(now()) @map("created_at")
  
  conversations Conversation[]
  
  @@map("projects")
  @@schema("aia_schema")
}

// ... 其他AIA模型

// ===== 3. PKB Schema（个人知识库 - 迁移现有表）=====
model KnowledgeBase {
  id             String   @id @default(uuid())
  userId         String   @map("user_id")
  name           String
  description    String?
  difyDatasetId  String   @map("dify_dataset_id")
  fileCount      Int      @default(0) @map("file_count")
  totalSizeBytes BigInt   @default(0) @map("total_size_bytes")
  createdAt      DateTime @default(now()) @map("created_at")
  updatedAt      DateTime @updatedAt @map("updated_at")
  
  documents Document[]
  
  @@map("knowledge_bases")
  @@schema("pkb_schema")
}

model Document {
  id                 String   @id @default(uuid())
  kbId               String   @map("kb_id")
  userId             String   @map("user_id")
  filename           String
  fileType           String   @map("file_type")
  fileSizeBytes      BigInt   @map("file_size_bytes")
  fileUrl            String   @map("file_url")
  difyDocumentId     String   @map("dify_document_id")
  status             String   @default("uploading")
  progress           Int      @default(0)
  errorMessage       String?  @map("error_message") @db.Text
  segmentsCount      Int?     @map("segments_count")
  tokensCount        Int?     @map("tokens_count")
  // Phase 2: 全文阅读字段
  extractionMethod   String?  @map("extraction_method")
  extractionQuality  Float?   @map("extraction_quality")
  charCount          Int?     @map("char_count")
  language           String?
  extractedText      String?  @map("extracted_text") @db.Text
  uploadedAt         DateTime @default(now()) @map("uploaded_at")
  processedAt        DateTime? @map("processed_at")
  
  knowledgeBase      KnowledgeBase @relation(fields: [kbId], references: [id], onDelete: Cascade)
  
  @@map("documents")
  @@schema("pkb_schema")
}
```

**说明：**
- ✅ 只为3个已迁移的Schema定义模型
- 📋 7个空Schema已在schemas列表中，但暂无模型
- 📋 ASL模型将在Week 3开发前定义
- 📋 Common模型需要时再添加

---

#### Day 4下午：补充AIA和PKB设计文档 ⭐ 新增任务

**任务：为已迁移的2个模块补充完整设计文档**

**1. 创建AIA数据库设计文档**
- [ ] 创建 `03-业务模块/AIA-AI智能问答/02-技术设计/01-数据库设计.md`
- [ ] 基于已迁移的5个表编写完整文档
- [ ] 包括：表结构、字段说明、索引设计、关系说明

**2. 创建PKB数据库设计文档**
- [ ] 创建 `03-业务模块/PKB-个人知识库/02-技术设计/01-数据库设计.md`
- [ ] 基于已迁移的2个表编写完整文档
- [ ] 重点说明Phase 2全文阅读相关字段

**工作量估算：** 各1小时，共2小时 ✅

**为什么现在补充？**
- ✅ 趁着对表结构熟悉，立即文档化
- ✅ 为Week 2代码重构提供文档支持
- ✅ 与ASL保持一致的文档结构

---

#### Day 5上午：代码适配 + API文档补充

**任务1：更新代码以使用新Schema**
- [ ] 更新所有数据库查询代码
- [ ] 使用新的Prisma Client
- [ ] 更新API路由
- [ ] 运行集成测试

**任务2：补充API设计文档**
- [ ] 创建 `03-业务模块/AIA-AI智能问答/02-技术设计/02-API设计规范.md`
- [ ] 创建 `03-业务模块/PKB-个人知识库/02-技术设计/02-API设计规范.md`
- [ ] 基于现有API routes整理文档

**验收标准：**
- [ ] ✅ 所有API正常工作
- [ ] ✅ 测试通过
- [ ] ✅ 现有功能无回归
- [ ] ✅ AIA和PKB模块文档完整（数据库+API）

---

#### Day 5下午：Week 1总结 + Week 2准备

**任务：**
- [ ] 验证10个Schema全部创建
- [ ] 验证3个详细Schema数据迁移完整
- [ ] 更新文档：记录迁移过程和结果
- [ ] 编写Week 1总结报告
- [ ] 规划Week 2代码重构细节

**Week 1交付物检查清单：**
- [ ] ✅ 10个Schema全部创建（3详细+7空）
- [ ] ✅ Platform/AIA/PKB数据100%迁移
- [ ] ✅ Prisma模型更新完成（3个详细Schema）
- [ ] ✅ 现有功能正常运行
- [ ] ✅ AIA和PKB完整文档（数据库+API）
- [ ] ✅ 迁移脚本文档化

---

## Week 2：代码分层重构（2025-11-14 至 2025-11-20）

> **重点：** 建立清晰的代码分层架构，为模块化开发打好基础

### 目标
- 建立3层代码结构（Platform/Common/Business）
- 完成现有代码重构
- 建立代码规范和最佳实践

### Day 6-7：Platform层和Common层重构

**任务：**
- [ ] 提取平台基础服务（认证、权限）
- [ ] 提取通用能力（LLM调用、文件处理）
- [ ] 建立统一的错误处理
- [ ] 建立统一的日志系统

**代码结构：**
```
backend/src/
├── platform/
│   ├── auth/           # 认证服务
│   ├── permissions/    # 权限管理
│   └── users/          # 用户管理
├── common/
│   ├── llm/            # LLM网关
│   ├── files/          # 文件处理
│   └── utils/          # 工具函数
└── modules/
    ├── aia/            # AI智能问答
    ├── pkb/            # 个人知识库
    └── asl/            # AI智能文献（准备）
```

### Day 8-10：Business模块重构

**任务：**
- [ ] 重构AIA模块代码
- [ ] 重构PKB模块代码
- [ ] 建立模块间调用规范
- [ ] 完善单元测试

**验收标准：**
- [ ] ✅ 代码分层清晰
- [ ] ✅ 模块边界明确
- [ ] ✅ 测试覆盖率 > 80%
- [ ] ✅ 现有功能无回归

---

## Week 3-4：ASL模块开发（2025-11-21 至 2025-12-04）

> **重点：** 完成AI智能文献核心功能

### Week 3 Day 1-2：ASL详细设计 ⭐ 此时再设计

**任务：**
- [ ] 详细设计asl_schema表结构
- [ ] 编写ASL数据库设计文档
- [ ] 编写ASL API设计文档
- [ ] 创建ASL表结构
- [ ] 更新Prisma模型（添加ASL模型）

**为什么Week 3再设计？**
- ✅ Week 1-2架构已搭好，有了清晰的参考
- ✅ 需求经过Week 1-2的思考更加明确
- ✅ 避免Week 1过度设计和返工
- ✅ Just-in-time设计，更高效

### Week 3 Day 3-5：ASL Phase 1核心功能

**功能1：文献项目管理**
- [ ] 创建/编辑/删除项目
- [ ] PICO配置
- [ ] 项目列表展示

**功能2：文献导入**
- [ ] CSV导入
- [ ] 批量导入
- [ ] 数据验证

**功能3：AI双模型筛选**
- [ ] 集成2个大模型
- [ ] 并行筛选
- [ ] 结果对比

### Week 4：ASL Phase 1完善

**功能4：筛选结果管理**
- [ ] 结果展示
- [ ] 人工复核
- [ ] 导出功能

**功能5：测试和优化**
- [ ] 完整功能测试
- [ ] 性能优化
- [ ] 用户体验优化

---

## Week 5-6：DC和RVW模块规划（2025-12-05 至 2025-12-18）

> **重点：** 根据ASL开发经验，规划后续模块

### 数据清洗模块（DC）设计

**此时根据需求再设计dc_schema：**
- 清洗任务管理
- 规则引擎
- 清洗结果

### 审稿系统模块（RVW）设计

**此时根据需求再设计rvw_schema：**
- 审稿项目管理
- 审稿任务分配
- 审稿意见管理

**说明：** 这两个模块的详细Schema设计推迟到开发前，避免现在过度设计。

---

## 后续规划（Week 7+）

### ADMIN模块（运营管理）
- 设计admin_schema
- 组织管理
- 订阅管理
- 使用统计

### SSA和ST模块（智能统计）
- 根据需求设计ssa_schema和st_schema
- 统计分析引擎
- 分析工具集成

---

## 📊 工作量总结（务实版）

| 阶段 | 原计划 | 新计划 | 节省 |
|------|--------|--------|------|
| Week 1 Schema迁移 | 2天（5个详细） | **1.5天（3个详细）** | ✅ 0.5天 |
| Week 1 文档补充 | 0 | **0.5天（AIA/PKB文档）** | 新增 |
| Prisma模型 | 5个详细 | **3个详细** | ✅ 简化 |
| ASL设计 | Week 1 | **Week 3**（推迟） | ✅ 避免返工 |
| 总Week 1工作量 | 2天 | **2天** | 相同，但更合理 |

**关键优势：**
1. ✅ Week 1聚焦架构和迁移，不做新设计
2. ✅ ASL设计推迟到开发前，需求更明确
3. ✅ AIA和PKB文档补充，与ASL保持一致
4. ✅ 7个空Schema预留，随时可扩展
5. ✅ 降低返工风险，提高开发效率

---

## 🎯 下一步行动

1. **立即开始Week 1 Day 1**：规划10个Schema架构
2. **Day 1-2**：编写3个Schema的详细设计和迁移脚本
3. **Day 3**：执行迁移，验证功能
4. **Day 4**：更新Prisma，补充AIA/PKB数据库文档
5. **Day 5**：代码适配，补充AIA/PKB API文档，Week 1总结

**记住：架构预留 + Just-in-time设计 = 高效务实！** ⭐⭐⭐

---

## 附录：Week 1详细交付物清单

**交付物：**
1. ✅ 10个Schema全部创建（3详细+7空）
2. ✅ 完整的Schema架构设计文档
3. ✅ Prisma Schema更新完成（3个详细Schema模型）
4. ✅ 现有功能（AIA、PKB）迁移完成（7个表）
5. ✅ AIA和PKB完整文档（数据库+API）
6. ✅ 7个空Schema创建完成（ASL/Common/DC/RVW/ADMIN/SSA/ST）

**验收标准：**
- [ ] ✅ **10个Schema全部创建成功**
- [ ] ✅ 数据迁移100%成功（platform/aia/pkb三个Schema）
- [ ] ✅ 现有功能正常运行（AI智能问答、知识库）
- [ ] ✅ Prisma Client正常工作（支持10个Schema）
- [ ] ✅ AIA和PKB文档完整
- [ ] ✅ 7个空Schema验证通过（架构预留）

---

## 🔧 阶段2：代码分层 + LLM网关（Week 2）

> **时间：** 2025-11-14 至 2025-11-20（7天）  
> **目标：** 建立三层代码架构 + 实现LLM网关

### 务实策略：只做云端统一系统 ⭐

**做什么：**
- ✅ 三层目录结构（platform/common/modules）
- ✅ 代码迁移和重构
- ✅ LLM网关实现
- ✅ 模块化API路由

**暂不做：**
- ❌ 模块独立部署配置
- ❌ Docker文件
- ❌ 独立运行脚本

**原因：** 当前重点是云端系统开发，独立部署在Week 7+再考虑

---

### Day 6-7：三层目录重构

**任务：**
1. 创建三层目录结构
2. 迁移现有代码到新结构
3. 重构为清晰的分层

**目录结构：**
```
backend/src/
├── platform/           # L1：平台基础层
│   ├── auth/          # 认证（JWT、Session）
│   ├── permissions/   # 权限管理（RBAC）
│   └── users/         # 用户服务
├── common/            # L2：通用能力层
│   ├── llm/           # LLM网关
│   ├── files/         # 文件处理
│   └── utils/         # 工具函数
└── modules/           # L3：业务模块层
    ├── aia/           # AI智能问答
    ├── pkb/           # 个人知识库
    └── asl/           # AI智能文献（准备）
```

---

### Day 8-9：LLM网关实现

**核心功能：**
1. **多模型支持**
   - DeepSeek
   - OpenAI
   - Claude
   - 统一接口

2. **Feature Flags**
   - 模型开关
   - 功能开关
   - 配额管理

3. **使用记录**
   - Token统计
   - 费用计算
   - 日志记录

**交付：**
- LLM网关核心代码
- 配置文件
- 使用文档

---

### Day 10：Week 2验收

**验收标准：**
- [ ] ✅ 三层代码架构清晰
- [ ] ✅ LLM网关稳定可用
- [ ] ✅ API路由模块化
- [ ] ✅ ASL可以开始开发

---

## 🎯 阶段3-4：ASL核心功能开发（Week 3-4）

> **时间：** 2025-11-21 至 2025-12-04（2周）  
> **目标：** 完成ASL Phase 1 - 文献初筛功能

### Week 3 Day 1-2：ASL详细设计 ⭐

**任务：**
- [ ] 详细设计asl_schema表结构
- [ ] 编写ASL数据库设计文档
- [ ] 编写ASL API设计文档
- [ ] 创建ASL表结构
- [ ] 更新Prisma模型

**为什么Week 3再设计？**
- Week 1-2架构已搭好
- 需求更加明确
- 避免过度设计

### Week 3 Day 3-5：ASL Phase 1核心功能

**功能1：文献项目管理**
- 创建/编辑/删除项目
- PICO配置
- 项目列表

**功能2：文献导入**
- CSV导入
- 批量导入
- 数据验证

**功能3：AI双模型筛选**
- 集成2个大模型
- 并行筛选
- 结果对比

### Week 4：ASL Phase 1完善

**功能4：筛选结果管理**
- 结果展示
- 人工复核
- 导出功能

**功能5：测试和优化**
- 完整功能测试
- 性能优化
- 用户体验优化

---

## 📊 关键调整总结

**V2.1版（3详细+7空）vs V2.0版（5详细+5空）：**

| 项目 | V2.0 | V2.1 | 变化 |
|------|------|------|------|
| 详细Schema | 5个 | **3个** | ✅ 聚焦现有 |
| 空Schema | 5个 | **7个** | ✅ 更完整预留 |
| Week 1工作量 | 2天 | **1.5天** | ✅ 降低 |
| ASL设计时机 | Week 1 | **Week 3** | ✅ 推迟 |
| 文档补充 | 无 | **AIA/PKB** | ✅ 新增 |

**核心策略：**
1. ✅ 聚焦当前（只迁移现有数据）
2. ✅ 架构预留（10个命名空间）
3. ✅ Just-in-time设计（开发前再详细设计）
4. ✅ 文档完整（与ASL保持一致）

---

## 🎯 成功标准

### Week 1成功标准
- [ ] ✅ 10个Schema全部创建（3详细+7空）
- [ ] ✅ Platform/AIA/PKB数据100%迁移
- [ ] ✅ Prisma模型更新（3个详细）
- [ ] ✅ 现有功能正常运行
- [ ] ✅ AIA和PKB文档完整

### Week 2成功标准
- [ ] ✅ 三层代码架构清晰
- [ ] ✅ LLM网关稳定可用
- [ ] ✅ API路由模块化
- [ ] ✅ ASL可以开始开发

### Week 3-4成功标准
- [ ] ✅ ASL标题摘要初筛完成
- [ ] ✅ ASL全文复筛完成
- [ ] ✅ 用户可以完整使用ASL功能

---

## 📝 关于Monorepo的决策

**决定：暂不采用Monorepo** ✅

**理由：**
1. 目录分层已经足够清晰（platform/common/modules）
2. Monorepo工具（lerna、nx）增加复杂度
3. 单人开发，收益不明显
4. 等未来真正需要独立部署时再考虑

---

**制定人：** AI助手  
**版本：** V2.1（3详细+7空 - 务实版）  
**最后更新：** 2025-11-09  
**核心调整：** 
- ✅ 3个Schema详细迁移（Platform/AIA/PKB）
- ✅ 7个空Schema预留（ASL/Common/DC/RVW/ADMIN/SSA/ST）
- ✅ ASL设计推迟到Week 3
- ✅ 补充AIA/PKB完整文档
- ✅ 架构预留 + Just-in-time设计 = 高效务实 ⭐