docs: complete documentation system (250+ files)
- System architecture and design documentation - Business module docs (ASL/AIA/PKB/RVW/DC/SSA/ST) - ASL module complete design (quality assurance, tech selection) - Platform layer and common capabilities docs - Development standards and API specifications - Deployment and operations guides - Project management and milestone tracking - Architecture implementation reports - Documentation templates and guides
This commit is contained in:
829
docs/08-项目管理/下一阶段行动计划-V2.0-模块化架构优先.md
Normal file
829
docs/08-项目管理/下一阶段行动计划-V2.0-模块化架构优先.md
Normal file
@@ -0,0 +1,829 @@
|
||||
# 下一阶段行动计划 V2.0 - 模块化架构优先
|
||||
|
||||
> **计划周期：** 2025-11-07 至 2025-12-13（5周）
|
||||
> **核心目标：** 建立可独立部署的模块化架构 + 完成ASL核心功能
|
||||
> **制定时间：** 2025-11-07
|
||||
> **版本：** V2.0（架构优先版）
|
||||
|
||||
---
|
||||
|
||||
## 🎯 战略调整说明
|
||||
|
||||
### 为什么要调整？
|
||||
|
||||
**原计划（V1.0）：** 快速启动ASL开发，暂缓Schema隔离
|
||||
|
||||
**新计划（V2.0）：** 先打好架构基础，再开发业务功能
|
||||
|
||||
### 核心变化
|
||||
|
||||
| 项目 | V1.0 | V2.0 | 原因 |
|
||||
|------|------|------|------|
|
||||
| Schema隔离 | ❌ 暂缓 | ✅ 必做 | 独立部署的前提 |
|
||||
| 模块独立性 | 📋 计划中 | ⭐ 最高优先级 | 90%独立部署需求 |
|
||||
| 开发重点 | ASL单模块 | ASL+DC+RVW三模块 | 统一架构标准 |
|
||||
| 时间分配 | 1周基础+3周开发 | 2周基础+3周开发 | 架构投入增加 |
|
||||
|
||||
---
|
||||
|
||||
## 📊 整体规划 - 五周五阶段
|
||||
|
||||
```
|
||||
Week 1-2（架构基础） Week 3-4（核心功能） Week 5（测试优化）
|
||||
Schema隔离+模块化架构 → ASL标题摘要初筛+全文复筛 → 多模块联调+测试
|
||||
```
|
||||
|
||||
| 阶段 | 时间 | 核心任务 | 交付成果 | 优先级 |
|
||||
|------|------|---------|---------|--------|
|
||||
| **阶段1** | Week 1 | Schema隔离方案 | 8个Schema设计+迁移计划 | P0 ⭐⭐⭐ |
|
||||
| **阶段2** | Week 2 | 模块化架构实施 | 代码分层+独立部署能力 | P0 ⭐⭐⭐ |
|
||||
| **阶段3** | Week 3 | ASL标题摘要初筛 | 双模型筛选功能 | P0 ⭐⭐ |
|
||||
| **阶段4** | Week 4 | ASL全文复筛 | PDF全文分析功能 | P0 ⭐⭐ |
|
||||
| **阶段5** | Week 5 | 多模块联调测试 | 三模块协同工作 | P1 ⭐ |
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 核心架构设计
|
||||
|
||||
### 三大独立模块
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 云端统一平台 │
|
||||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||||
│ │ ASL │ │ DC │ │ RVW │ │
|
||||
│ │AI智能文献│ │ 数据清洗 │ │ 审稿系统 │ │
|
||||
│ └──────────┘ └──────────┘ └──────────┘ │
|
||||
│ ↓ ↓ ↓ │
|
||||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||||
│ │asl_schema│ │dc_schema │ │rvw_schema│ │
|
||||
│ └──────────┘ └──────────┘ └──────────┘ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
每个模块都可以独立部署 90%
|
||||
```
|
||||
|
||||
### 模块独立性设计原则
|
||||
|
||||
**独立的（90%）：**
|
||||
- ✅ 独立的数据库Schema
|
||||
- ✅ 独立的API路由（/api/asl/*, /api/dc/*, /api/rvw/*）
|
||||
- ✅ 独立的前端页面
|
||||
- ✅ 独立的部署包
|
||||
- ✅ 独立的配置文件
|
||||
|
||||
**共享的（10%）：**
|
||||
- 🔗 用户认证（platform_schema.users）
|
||||
- 🔗 LLM网关（common层）
|
||||
- 🔗 基础UI组件
|
||||
- 🔗 部署基础设施
|
||||
|
||||
---
|
||||
|
||||
## 🚀 阶段1：Schema隔离方案（Week 1）
|
||||
|
||||
> **时间：** 2025-11-07 至 2025-11-13（7天）
|
||||
> **目标：** 完成8个Schema设计和数据库迁移
|
||||
|
||||
### 核心目标
|
||||
|
||||
**为什么这是Week 1的重中之重？**
|
||||
1. Schema隔离是独立部署的前提条件
|
||||
2. 影响后续所有代码的数据访问方式
|
||||
3. 越早做，后续改动成本越低
|
||||
4. 为三大模块（ASL、DC、RVW）建立清晰边界
|
||||
|
||||
---
|
||||
|
||||
### Day 1-2：Schema设计
|
||||
|
||||
#### 8个Schema划分方案
|
||||
|
||||
| Schema名称 | 用途 | 核心表 | 优先级 |
|
||||
|-----------|------|--------|--------|
|
||||
| **platform_schema** | 平台基础 | users, roles, permissions | P0 ⭐ |
|
||||
| **aia_schema** | AI问答 | projects, conversations, messages | P1 |
|
||||
| **asl_schema** | AI智能文献 | literature_projects, literature_items, screening_results | P0 ⭐⭐⭐ |
|
||||
| **dc_schema** | 数据清洗 | cleaning_projects, datasets, cleaning_rules | P0 ⭐⭐ |
|
||||
| **rvw_schema** | 审稿系统 | manuscripts, reviews,评估标准 | P0 ⭐⭐ |
|
||||
| **pkb_schema** | 知识库 | knowledge_bases, documents | P1 |
|
||||
| **admin_schema** | 运营管理 | system_logs, statistics | P2 |
|
||||
| **common_schema** | 通用数据 | llm_usage, feature_flags | P1 |
|
||||
|
||||
#### 重点关注三大模块
|
||||
|
||||
**ASL（AI智能文献）Schema：**
|
||||
```sql
|
||||
-- asl_schema
|
||||
CREATE SCHEMA asl_schema;
|
||||
|
||||
-- 文献项目表
|
||||
CREATE TABLE asl_schema.literature_projects (
|
||||
id UUID PRIMARY KEY,
|
||||
user_id UUID REFERENCES platform_schema.users(id),
|
||||
name VARCHAR(200) NOT NULL,
|
||||
description TEXT,
|
||||
status VARCHAR(50),
|
||||
created_at TIMESTAMP,
|
||||
updated_at TIMESTAMP
|
||||
);
|
||||
|
||||
-- PICO配置表
|
||||
CREATE TABLE asl_schema.pico_configs (
|
||||
id UUID PRIMARY KEY,
|
||||
project_id UUID REFERENCES asl_schema.literature_projects(id) ON DELETE CASCADE,
|
||||
population TEXT NOT NULL,
|
||||
intervention TEXT NOT NULL,
|
||||
comparison TEXT NOT NULL,
|
||||
outcome TEXT NOT NULL,
|
||||
study_design TEXT NOT NULL
|
||||
);
|
||||
|
||||
-- 文献条目表
|
||||
CREATE TABLE asl_schema.literature_items (
|
||||
id UUID PRIMARY KEY,
|
||||
project_id UUID REFERENCES asl_schema.literature_projects(id) ON DELETE CASCADE,
|
||||
title TEXT NOT NULL,
|
||||
abstract TEXT,
|
||||
authors TEXT,
|
||||
journal VARCHAR(200),
|
||||
year INTEGER,
|
||||
doi VARCHAR(200),
|
||||
-- 筛选结果
|
||||
screening_status VARCHAR(50) DEFAULT 'pending',
|
||||
final_decision VARCHAR(50),
|
||||
ai_model1_decision VARCHAR(50),
|
||||
ai_model2_decision VARCHAR(50),
|
||||
ai_reason TEXT,
|
||||
-- 全文
|
||||
fulltext_path TEXT,
|
||||
fulltext_extracted TEXT,
|
||||
created_at TIMESTAMP,
|
||||
updated_at TIMESTAMP
|
||||
);
|
||||
```
|
||||
|
||||
**DC（数据清洗）Schema：**
|
||||
```sql
|
||||
-- dc_schema
|
||||
CREATE SCHEMA dc_schema;
|
||||
|
||||
CREATE TABLE dc_schema.cleaning_projects (
|
||||
id UUID PRIMARY KEY,
|
||||
user_id UUID REFERENCES platform_schema.users(id),
|
||||
name VARCHAR(200) NOT NULL,
|
||||
dataset_type VARCHAR(100),
|
||||
status VARCHAR(50),
|
||||
created_at TIMESTAMP
|
||||
);
|
||||
|
||||
CREATE TABLE dc_schema.datasets (
|
||||
id UUID PRIMARY KEY,
|
||||
project_id UUID REFERENCES dc_schema.cleaning_projects(id) ON DELETE CASCADE,
|
||||
file_name VARCHAR(500),
|
||||
file_path TEXT,
|
||||
row_count INTEGER,
|
||||
column_count INTEGER,
|
||||
created_at TIMESTAMP
|
||||
);
|
||||
|
||||
CREATE TABLE dc_schema.cleaning_rules (
|
||||
id UUID PRIMARY KEY,
|
||||
project_id UUID REFERENCES dc_schema.cleaning_projects(id) ON DELETE CASCADE,
|
||||
rule_type VARCHAR(100),
|
||||
rule_config JSONB,
|
||||
apply_order INTEGER
|
||||
);
|
||||
```
|
||||
|
||||
**RVW（审稿系统）Schema：**
|
||||
```sql
|
||||
-- rvw_schema
|
||||
CREATE SCHEMA rvw_schema;
|
||||
|
||||
CREATE TABLE rvw_schema.manuscripts (
|
||||
id UUID PRIMARY KEY,
|
||||
user_id UUID REFERENCES platform_schema.users(id),
|
||||
title TEXT NOT NULL,
|
||||
abstract TEXT,
|
||||
fulltext_path TEXT,
|
||||
journal_target VARCHAR(200),
|
||||
status VARCHAR(50),
|
||||
created_at TIMESTAMP
|
||||
);
|
||||
|
||||
CREATE TABLE rvw_schema.reviews (
|
||||
id UUID PRIMARY KEY,
|
||||
manuscript_id UUID REFERENCES rvw_schema.manuscripts(id) ON DELETE CASCADE,
|
||||
review_type VARCHAR(100), -- methodology, journal_requirements
|
||||
score DECIMAL(5,2),
|
||||
comments TEXT,
|
||||
suggestions TEXT,
|
||||
created_at TIMESTAMP
|
||||
);
|
||||
|
||||
CREATE TABLE rvw_schema.evaluation_criteria (
|
||||
id UUID PRIMARY KEY,
|
||||
type VARCHAR(100), -- methodology, journal
|
||||
criteria_name VARCHAR(200),
|
||||
criteria_content TEXT
|
||||
);
|
||||
```
|
||||
|
||||
#### Day 1任务清单
|
||||
|
||||
- [ ] 绘制完整的Schema关系图
|
||||
- [ ] 设计8个Schema的表结构
|
||||
- [ ] 重点：详细设计ASL、DC、RVW三个Schema
|
||||
- [ ] 设计跨Schema的外键引用规则
|
||||
- [ ] 编写Schema设计文档
|
||||
|
||||
**输出文档：**
|
||||
- `09-架构实施/01-Schema隔离详细设计.md`
|
||||
|
||||
---
|
||||
|
||||
#### Day 2：数据迁移计划
|
||||
|
||||
**现有表分类：**
|
||||
|
||||
| 现有表 | 迁移到 | 优先级 |
|
||||
|--------|--------|--------|
|
||||
| users, roles | platform_schema | P0 |
|
||||
| projects, conversations, messages | aia_schema | P1 |
|
||||
| knowledge_bases, documents | pkb_schema | P1 |
|
||||
| （新建）literature_* | asl_schema | P0 |
|
||||
| （新建）cleaning_* | dc_schema | P0 |
|
||||
| （新建）manuscripts, reviews | rvw_schema | P0 |
|
||||
|
||||
**迁移策略：**
|
||||
|
||||
1. **阶段性迁移**
|
||||
- Phase 1：创建所有Schema（5分钟）
|
||||
- Phase 2：迁移platform核心表（30分钟）
|
||||
- Phase 3：迁移AIA和PKB表（1小时）
|
||||
- Phase 4：创建ASL/DC/RVW新表（30分钟）
|
||||
|
||||
2. **零停机迁移**
|
||||
- 使用数据库视图作为过渡
|
||||
- 逐步切换应用代码
|
||||
- 保留旧表作为备份
|
||||
|
||||
**Day 2任务清单：**
|
||||
- [ ] 编写SQL迁移脚本
|
||||
- [ ] 设计数据验证方案
|
||||
- [ ] 准备回滚方案
|
||||
- [ ] 在测试环境验证
|
||||
|
||||
**输出文档：**
|
||||
- `09-架构实施/02-数据库迁移计划.md`
|
||||
- `09-架构实施/migration-scripts/`
|
||||
|
||||
---
|
||||
|
||||
### Day 3-4：执行Schema迁移
|
||||
|
||||
#### Day 3：测试环境迁移
|
||||
|
||||
**上午：准备工作**
|
||||
- [ ] 备份测试数据库
|
||||
- [ ] 创建8个Schema
|
||||
- [ ] 运行迁移脚本（Platform + AIA + PKB）
|
||||
|
||||
**下午：验证和测试**
|
||||
- [ ] 数据完整性验证
|
||||
- [ ] 现有功能测试（AI问答、知识库）
|
||||
- [ ] 修复发现的问题
|
||||
|
||||
#### Day 4：生产环境迁移 + 新Schema创建
|
||||
|
||||
**上午：生产环境迁移**
|
||||
- [ ] 备份生产数据库
|
||||
- [ ] 执行Schema迁移
|
||||
- [ ] 数据验证
|
||||
|
||||
**下午：创建ASL/DC/RVW Schema**
|
||||
- [ ] 创建asl_schema及所有表
|
||||
- [ ] 创建dc_schema及所有表
|
||||
- [ ] 创建rvw_schema及所有表
|
||||
- [ ] 创建必要的索引
|
||||
|
||||
**验收标准：**
|
||||
- [ ] 8个Schema全部创建完成
|
||||
- [ ] 现有功能正常运行
|
||||
- [ ] 三大模块Schema准备就绪
|
||||
|
||||
---
|
||||
|
||||
### Day 5：Prisma Schema更新
|
||||
|
||||
**核心任务：**
|
||||
- [ ] 更新Prisma Schema配置（支持多Schema）
|
||||
- [ ] 为ASL、DC、RVW创建Prisma模型
|
||||
- [ ] 生成Prisma Client
|
||||
- [ ] 更新现有代码的数据库查询
|
||||
|
||||
**Prisma多Schema配置示例：**
|
||||
```prisma
|
||||
// schema.prisma
|
||||
generator client {
|
||||
provider = "prisma-client-js"
|
||||
previewFeatures = ["multiSchema"]
|
||||
}
|
||||
|
||||
datasource db {
|
||||
provider = "postgresql"
|
||||
url = env("DATABASE_URL")
|
||||
schemas = ["platform_schema", "aia_schema", "asl_schema", "dc_schema", "rvw_schema", "pkb_schema", "admin_schema", "common_schema"]
|
||||
}
|
||||
|
||||
// Platform Schema
|
||||
model User {
|
||||
id String @id @default(uuid())
|
||||
email String @unique
|
||||
password String
|
||||
role String
|
||||
createdAt DateTime @default(now())
|
||||
|
||||
@@map("users")
|
||||
@@schema("platform_schema")
|
||||
}
|
||||
|
||||
// ASL Schema
|
||||
model LiteratureProject {
|
||||
id String @id @default(uuid())
|
||||
userId String
|
||||
name String
|
||||
description String?
|
||||
status String @default("active")
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
picoConfig PICOConfig?
|
||||
items LiteratureItem[]
|
||||
|
||||
@@map("literature_projects")
|
||||
@@schema("asl_schema")
|
||||
}
|
||||
|
||||
model PICOConfig {
|
||||
id String @id @default(uuid())
|
||||
projectId String @unique
|
||||
population String
|
||||
intervention String
|
||||
comparison String
|
||||
outcome String
|
||||
studyDesign String
|
||||
|
||||
project LiteratureProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
|
||||
|
||||
@@map("pico_configs")
|
||||
@@schema("asl_schema")
|
||||
}
|
||||
|
||||
// ... 其他模型
|
||||
```
|
||||
|
||||
**验收标准：**
|
||||
- [ ] Prisma Schema支持8个Schema
|
||||
- [ ] 生成的Client可以正确访问所有Schema
|
||||
- [ ] 类型定义完整
|
||||
|
||||
---
|
||||
|
||||
### Week 1 总结
|
||||
|
||||
**交付成果：**
|
||||
1. ✅ 8个Schema设计完成
|
||||
2. ✅ 数据库迁移完成
|
||||
3. ✅ Prisma Schema更新完成
|
||||
4. ✅ ASL、DC、RVW三大模块数据库就绪
|
||||
|
||||
**验收标准：**
|
||||
- [ ] 所有现有功能正常运行
|
||||
- [ ] 数据库完整性100%
|
||||
- [ ] Prisma Client正常工作
|
||||
- [ ] 三大模块可以开始开发
|
||||
|
||||
---
|
||||
|
||||
## 🔧 阶段2：模块化架构实施（Week 2）
|
||||
|
||||
> **时间：** 2025-11-14 至 2025-11-20（7天）
|
||||
> **目标：** 建立清晰的代码分层 + 实现模块独立部署能力
|
||||
|
||||
### 核心目标
|
||||
|
||||
**建立三层架构 + 模块独立性**
|
||||
|
||||
```
|
||||
backend/
|
||||
├── platform/ # 平台基础层
|
||||
│ ├── auth/ # 认证授权（共享）
|
||||
│ ├── permission/ # 权限管理
|
||||
│ └── storage/ # 存储服务
|
||||
│
|
||||
├── common/ # 通用能力层
|
||||
│ ├── llm/ # LLM网关 ⭐ 核心
|
||||
│ ├── document/ # 文档处理
|
||||
│ └── utils/ # 工具函数
|
||||
│
|
||||
├── modules/ # 业务模块层（独立）
|
||||
│ ├── asl/ # AI智能文献 ⭐⭐⭐
|
||||
│ │ ├── api/
|
||||
│ │ ├── services/
|
||||
│ │ ├── types/
|
||||
│ │ └── standalone.config.ts # 独立部署配置
|
||||
│ │
|
||||
│ ├── dc/ # 数据清洗 ⭐⭐
|
||||
│ │ └── standalone.config.ts
|
||||
│ │
|
||||
│ ├── rvw/ # 审稿系统 ⭐⭐
|
||||
│ │ └── standalone.config.ts
|
||||
│ │
|
||||
│ ├── aia/ # AI问答
|
||||
│ └── pkb/ # 知识库
|
||||
│
|
||||
└── shared/ # 共享代码
|
||||
├── types/
|
||||
└── interfaces/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Day 1-2：代码重构 + LLM网关
|
||||
|
||||
#### Day 1：目录重构
|
||||
|
||||
**任务：**
|
||||
- [ ] 创建三层目录结构
|
||||
- [ ] 迁移现有代码到对应目录
|
||||
- [ ] 为ASL、DC、RVW创建模块骨架
|
||||
- [ ] 更新import路径
|
||||
|
||||
**ASL模块目录结构：**
|
||||
```
|
||||
modules/asl/
|
||||
├── api/
|
||||
│ ├── projects.ts # 项目管理API
|
||||
│ ├── screening.ts # 筛选API
|
||||
│ └── exports.ts # 导出API
|
||||
├── services/
|
||||
│ ├── project.service.ts
|
||||
│ ├── screening.service.ts
|
||||
│ └── llm.service.ts # 封装LLM网关调用
|
||||
├── types/
|
||||
│ └── index.ts
|
||||
├── config/
|
||||
│ └── standalone.config.ts # 独立部署配置
|
||||
└── index.ts # 模块入口
|
||||
```
|
||||
|
||||
#### Day 2：LLM网关实现 ⭐ 核心
|
||||
|
||||
**为什么LLM网关如此重要？**
|
||||
- ASL的标题摘要初筛完全依赖它
|
||||
- DC的智能清洗建议需要它
|
||||
- RVW的审稿评估需要它
|
||||
- 统一管理所有AI调用
|
||||
|
||||
**实现任务：**
|
||||
- [ ] 实现BaseLLMAdapter抽象类
|
||||
- [ ] 实现DeepSeekAdapter
|
||||
- [ ] 实现QwenAdapter
|
||||
- [ ] 实现LLMGateway主服务
|
||||
- [ ] Feature Flag集成
|
||||
- [ ] 配额检查
|
||||
|
||||
**核心代码：**
|
||||
```typescript
|
||||
// common/llm/LLMGateway.ts
|
||||
export class LLMGateway {
|
||||
async call(
|
||||
userId: string,
|
||||
model: string,
|
||||
messages: Message[],
|
||||
options?: LLMOptions
|
||||
): Promise<LLMResponse> {
|
||||
// 1. Feature Flag检查
|
||||
// 2. 配额检查
|
||||
// 3. 调用适配器
|
||||
// 4. 记录使用量
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**验收标准：**
|
||||
- [ ] 可以调用DeepSeek和Qwen3
|
||||
- [ ] Feature Flag正常工作
|
||||
- [ ] 配额检查正常
|
||||
|
||||
---
|
||||
|
||||
### Day 3-5：模块独立部署能力
|
||||
|
||||
#### Day 3：独立部署配置
|
||||
|
||||
**为每个模块创建独立配置：**
|
||||
|
||||
```typescript
|
||||
// modules/asl/config/standalone.config.ts
|
||||
export const ASLStandaloneConfig = {
|
||||
moduleName: 'ASL',
|
||||
moduleId: 'asl',
|
||||
version: '1.0.0',
|
||||
|
||||
// 独立部署模式
|
||||
standalone: {
|
||||
enabled: process.env.ASL_STANDALONE === 'true',
|
||||
port: process.env.ASL_PORT || 3001,
|
||||
apiPrefix: '/api/asl',
|
||||
},
|
||||
|
||||
// 依赖的共享服务
|
||||
dependencies: {
|
||||
auth: {
|
||||
required: true,
|
||||
endpoint: process.env.AUTH_SERVICE_URL || 'http://localhost:3000/api/auth',
|
||||
},
|
||||
llm: {
|
||||
required: true,
|
||||
endpoint: process.env.LLM_SERVICE_URL || 'http://localhost:3000/api/llm',
|
||||
},
|
||||
},
|
||||
|
||||
// 数据库配置
|
||||
database: {
|
||||
schema: 'asl_schema',
|
||||
url: process.env.ASL_DATABASE_URL || process.env.DATABASE_URL,
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
**任务清单：**
|
||||
- [ ] 为ASL创建standalone.config.ts
|
||||
- [ ] 为DC创建standalone.config.ts
|
||||
- [ ] 为RVW创建standalone.config.ts
|
||||
- [ ] 创建模块启动脚本
|
||||
|
||||
#### Day 4：API路由隔离
|
||||
|
||||
**统一API路由规范：**
|
||||
```
|
||||
/api/asl/* - AI智能文献
|
||||
/api/dc/* - 数据清洗
|
||||
/api/rvw/* - 审稿系统
|
||||
/api/aia/* - AI问答
|
||||
/api/pkb/* - 知识库
|
||||
```
|
||||
|
||||
**任务：**
|
||||
- [ ] 重构API路由，按模块划分
|
||||
- [ ] 实现路由级别的权限检查
|
||||
- [ ] 为每个模块创建独立的API文档
|
||||
|
||||
#### Day 5：Docker化 + 独立部署测试
|
||||
|
||||
**为每个模块创建Dockerfile：**
|
||||
|
||||
```dockerfile
|
||||
# modules/asl/Dockerfile
|
||||
FROM node:18-alpine
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# 只复制ASL模块需要的文件
|
||||
COPY package*.json ./
|
||||
COPY tsconfig.json ./
|
||||
COPY platform/ ./platform/
|
||||
COPY common/ ./common/
|
||||
COPY modules/asl/ ./modules/asl/
|
||||
COPY shared/ ./shared/
|
||||
|
||||
RUN npm install
|
||||
RUN npm run build
|
||||
|
||||
ENV ASL_STANDALONE=true
|
||||
ENV ASL_PORT=3001
|
||||
|
||||
EXPOSE 3001
|
||||
|
||||
CMD ["node", "dist/modules/asl/index.js"]
|
||||
```
|
||||
|
||||
**任务：**
|
||||
- [ ] 为ASL创建Dockerfile
|
||||
- [ ] 为DC创建Dockerfile
|
||||
- [ ] 为RVW创建Dockerfile
|
||||
- [ ] 创建docker-compose配置
|
||||
- [ ] 测试独立部署
|
||||
|
||||
**docker-compose.yml示例：**
|
||||
```yaml
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
# 统一部署模式
|
||||
platform:
|
||||
build: .
|
||||
ports:
|
||||
- "3000:3000"
|
||||
environment:
|
||||
- DATABASE_URL=postgresql://...
|
||||
|
||||
# 独立部署模式
|
||||
asl-standalone:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: modules/asl/Dockerfile
|
||||
ports:
|
||||
- "3001:3001"
|
||||
environment:
|
||||
- ASL_STANDALONE=true
|
||||
- ASL_DATABASE_URL=postgresql://...
|
||||
- AUTH_SERVICE_URL=http://platform:3000/api/auth
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Week 2 总结
|
||||
|
||||
**交付成果：**
|
||||
1. ✅ 三层代码架构建立完成
|
||||
2. ✅ LLM网关实现完成
|
||||
3. ✅ ASL、DC、RVW三模块支持独立部署
|
||||
4. ✅ Docker化完成
|
||||
|
||||
**验收标准：**
|
||||
- [ ] 代码结构清晰，依赖关系正确
|
||||
- [ ] LLM网关可以正常调用
|
||||
- [ ] 三大模块可以独立启动和运行
|
||||
- [ ] Docker镜像可以正常构建
|
||||
|
||||
---
|
||||
|
||||
## 🎯 阶段3-4：ASL核心功能开发（Week 3-4）
|
||||
|
||||
> **时间：** 2025-11-21 至 2025-12-04（2周）
|
||||
> **目标：** 完成ASL标题摘要初筛 + 全文复筛
|
||||
|
||||
**详细内容参考原计划，核心任务：**
|
||||
- Week 3：项目管理 + CSV导入 + 标题摘要初筛
|
||||
- Week 4：全文复筛 + PDF处理
|
||||
|
||||
---
|
||||
|
||||
## 🔗 阶段5：多模块联调（Week 5）
|
||||
|
||||
> **时间：** 2025-12-05 至 2025-12-13（9天）
|
||||
> **目标：** 验证三大模块的协同工作能力
|
||||
|
||||
### 核心测试场景
|
||||
|
||||
**场景1：用户跨模块使用**
|
||||
- 用户登录 → 使用ASL筛选文献 → 使用DC清洗数据 → 使用RVW审稿
|
||||
|
||||
**场景2：数据共享测试**
|
||||
- ASL筛选出的文献 → 导出到DC进行数据提取
|
||||
- DC清洗的数据 → 用于RVW的稿件准备
|
||||
|
||||
**场景3：独立部署测试**
|
||||
- ASL独立部署 → 调用平台认证服务 → 正常工作
|
||||
- DC独立部署 → 调用LLM网关 → 正常工作
|
||||
|
||||
**任务清单：**
|
||||
- [ ] 端到端测试
|
||||
- [ ] 性能测试
|
||||
- [ ] 独立部署验证
|
||||
- [ ] 文档完善
|
||||
|
||||
---
|
||||
|
||||
## 📊 关键决策记录
|
||||
|
||||
### 决策001：Schema隔离必须执行 ✅
|
||||
|
||||
**决策：** Week 1必须完成Schema隔离
|
||||
|
||||
**理由：**
|
||||
1. 独立部署的前提条件
|
||||
2. 模块边界清晰
|
||||
3. 数据库级别的隔离
|
||||
4. 支持未来独立销售
|
||||
|
||||
**影响：** Week 1全部用于架构改造
|
||||
|
||||
---
|
||||
|
||||
### 决策002：三大模块优先 ✅
|
||||
|
||||
**决策：** 重点投入ASL、DC、RVW三大模块
|
||||
|
||||
**理由：**
|
||||
1. 90%独立部署需求
|
||||
2. 核心差异化产品
|
||||
3. 统一架构标准
|
||||
|
||||
**优先级：** ASL > DC = RVW
|
||||
|
||||
---
|
||||
|
||||
### 决策003：LLM网关Week 2实现 ✅
|
||||
|
||||
**决策：** LLM网关在Week 2实现，不是Week 1
|
||||
|
||||
**理由：**
|
||||
1. Week 1专注Schema隔离
|
||||
2. LLM网关需要Schema完成后才能正确配置
|
||||
3. Week 2有充足时间实现
|
||||
|
||||
---
|
||||
|
||||
## 📈 进度跟踪
|
||||
|
||||
### 关键指标
|
||||
|
||||
| 指标 | 目标 | Week 1 | Week 2 | Week 3-4 | Week 5 |
|
||||
|------|------|--------|--------|----------|--------|
|
||||
| Schema隔离 | 100% | 100% | - | - | - |
|
||||
| 模块化架构 | 100% | 0% | 100% | - | - |
|
||||
| LLM网关 | 100% | 0% | 100% | - | - |
|
||||
| ASL功能 | 100% | 0% | 0% | 100% | - |
|
||||
| 独立部署 | 100% | 0% | 80% | 80% | 100% |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 成功标准
|
||||
|
||||
### 技术标准
|
||||
|
||||
- [ ] 8个Schema全部创建并正常工作
|
||||
- [ ] 三大模块（ASL、DC、RVW）可以独立部署
|
||||
- [ ] LLM网关稳定可靠
|
||||
- [ ] ASL核心功能完整
|
||||
- [ ] 模块间可以协同工作
|
||||
|
||||
### 业务标准
|
||||
|
||||
- [ ] ASL可以完成文献筛选全流程
|
||||
- [ ] 筛选准确率 > 85%
|
||||
- [ ] 支持独立部署并对外销售
|
||||
- [ ] 用户体验流畅
|
||||
|
||||
---
|
||||
|
||||
## 🔄 风险管理
|
||||
|
||||
### 风险1：Schema迁移复杂度高
|
||||
|
||||
**风险等级：** 高
|
||||
**缓解措施：**
|
||||
- 在测试环境充分验证
|
||||
- 准备完善的回滚方案
|
||||
- 分阶段迁移，降低风险
|
||||
|
||||
### 风险2：模块独立部署调试困难
|
||||
|
||||
**风险等级：** 中
|
||||
**缓解措施：**
|
||||
- 先实现统一部署，再实现独立部署
|
||||
- 充分的日志和监控
|
||||
- 详细的部署文档
|
||||
|
||||
### 风险3：时间延长到5周
|
||||
|
||||
**风险等级：** 中
|
||||
**缓解措施：**
|
||||
- 架构投入是必要的
|
||||
- 长期来看节省时间
|
||||
- Week 3-4可以并行多人开发
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [里程碑4 - 架构改造](./02-里程碑规划/04-里程碑4-架构改造.md)
|
||||
- [Schema隔离方案](../00-系统总体设计/05-Schema隔离方案与成本分析.md)
|
||||
- [模块独立部署方案](../00-系统总体设计/06-模块独立部署与单机版方案.md)
|
||||
- [ASL快速上下文](../03-业务模块/ASL-AI智能文献/[AI对接]%20ASL快速上下文.md)
|
||||
|
||||
---
|
||||
|
||||
**制定人：** AI助手
|
||||
**审核人：** 待审核
|
||||
**批准人：** 待批准
|
||||
**最后更新：** 2025-11-07
|
||||
**版本：** V2.0
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user