# RVW V4.0 期刊配置中心 MVP 开发计划

> 文档版本: v1.0  
> 创建日期: 2026-03-15  
> 适用范围: RVW 多租户期刊配置中心（ADMIN 运营管理端）  
> 约束前提: 严格遵循 `docs/04-开发规范/09-数据库开发规范.md`

---

## 1. 目标与范围

本计划用于落地 RVW V4.0 的「期刊配置中心」MVP，满足以下目标：

1. 在运营管理端新增独立一级模块「期刊配置中心」（类似 IIT 项目管理入口形态）。
2. 系统默认配置支持区分：
   - 中文-稿约规范性
   - 英文-稿约规范性
   - 方法学、数据验证、临床专业评估（通用默认）
3. 期刊（如 AAA、BBB）可选择：
   - 继承系统默认配置
   - 在默认基础上进行覆盖
4. 期刊基础信息新增字段：`期刊语言`（中文/英文/其他）。
5. MVP 阶段功能可精简，但数据库字段一次性补齐（覆盖 P0/P1/P2 + 期刊语言）。

---

## 2. 关键输入文档

1. 需求基线  
`docs/03-业务模块/RVW-稿件审查系统/00-系统设计/V3.0/RVW V4.0 期刊租户配置中心开发需求0315.md`

2. 英文稿约默认规则（系统默认 EN 基线）  
`docs/03-业务模块/RVW-稿件审查系统/00-系统设计/V3.0/通用英文期刊稿约审查提示词.md`

3. 数据库规范（强制约束）  
`docs/04-开发规范/09-数据库开发规范.md`

4. 既有总计划参考  
`docs/03-业务模块/RVW-稿件审查系统/04-开发计划/RVW V4.0 期刊SaaS版开发计划.md`

---

## 3. 架构策略（MVP 版）

### 3.1 配置分层

- 第 1 层（系统默认层）
  - Editorial: `ZH` / `EN` 双基线
  - Methodology / DataForensics / Clinical: 通用基线
- 第 2 层（期刊继承层）
  - 默认继承系统配置
- 第 3 层（期刊覆盖层）
  - 租户填入自定义 Prompt/Template 后覆盖系统默认

### 3.2 运行时合并规则

对任一技能维度，统一采用：

`最终配置 = 期刊自定义值 ?? 系统默认值`

Editorial 额外规则：

- 若 `editorialExpertPrompt` 为空，则按 `editorialBaseStandard` 路由：
  - `zh` -> 中文稿约默认 Prompt
  - `en` -> 英文稿约默认 Prompt
- 若期刊未显式设置 `editorialBaseStandard`，按 `期刊语言` 映射默认值：
  - 中文 -> `zh`
  - 英文/其他 -> `en`

---

## 4. 数据模型设计（一次性补齐）

## 4.1 设计原则

- MVP 功能可分阶段启用，但字段一次性建完，避免重复迁移。
- 使用 `null` 表达“继承系统默认”。
- 严格使用 Prisma migration，不允许手工 DDL 改库。

## 4.2 表结构调整

### A. `platform_schema.tenants`（期刊基础信息）

新增/补齐字段（若已有同义字段，统一命名后保留兼容映射）：

- `journal_language` (`ZH` | `EN` | `OTHER`)  // P0
- `journal_full_name` (String)               // P0
- `logo_url` (String?)                       // P1
- `brand_color` (String?)                    // P1
- `login_background_url` (String?)           // P2

### B. `platform_schema.tenant_rvw_configs`（期刊审稿配置）

一次性补齐四维 Prompt + Template：

- `editorial_base_standard` (`zh` | `en`) default `en`
- `editorial_expert_prompt` (Text?)
- `editorial_handlebars_template` (Text?)
- `methodology_expert_prompt` (Text?)
- `methodology_handlebars_template` (Text?)
- `data_forensics_expert_prompt` (Text?)
- `data_forensics_handlebars_template` (Text?)
- `clinical_expert_prompt` (Text?)
- `clinical_handlebars_template` (Text?)

> 兼容说明：历史结构化字段（如 `editorialRules`/`dataForensicsLevel`/`finerWeights`）如需保留，先保留读兼容；MVP 写入统一走 Prompt/Template 字段。

---

## 5. 数据库实施规范（必须执行）

严格按 `09-数据库开发规范.md` 三条铁律执行：

1. 所有变更通过 `npx prisma migrate dev --name xxx` 生成迁移。
2. 禁止 `prisma db push`（含任何变体）。
3. 每次迁移后，立即更新 `docs/05-部署文档/03-待部署变更清单.md`。

推荐本次迁移命名：

- `20260315_add_journal_fields_to_tenants`
- `20260315_expand_tenant_rvw_configs_for_all_prompt_templates`

Shadow DB 失败时，按规范第 10 章降级流程处理并 `migrate resolve --applied` 标记。

---

## 6. 可执行任务清单

## 6.1 后端任务

### BE-1 Schema 与迁移
- 修改 `backend/prisma/schema.prisma`
- 生成并审查迁移 SQL
- 更新 Prisma Client

交付物：
- `backend/prisma/migrations/*/migration.sql`
- `backend/prisma/schema.prisma`

### BE-2 系统默认配置路由
- 在 Prompt 默认库中明确：
  - `SYSTEM_DEFAULT_EDITORIAL_EN` 使用英文默认规则（来源于指定文档）
  - `SYSTEM_DEFAULT_EDITORIAL_ZH` 使用中文默认规则
  - 其余 3 个技能保留通用默认

### BE-3 管理端 API（期刊配置中心）
- 新增/扩展 API：
  - `GET /api/admin/journal-configs`
  - `GET /api/admin/journal-configs/:tenantId`
  - `PUT /api/admin/journal-configs/:tenantId/basic-info`
  - `PUT /api/admin/journal-configs/:tenantId/rvw-config`
- 权限：`authenticate + requirePermission('ops:user-ops')`

### BE-4 RVW 执行链路接线
- 在 Worker/Skill 装配处接入期刊配置
- 按 `??` 规则完成 4 维配置合并
- Editorial 增加 `zh/en` 基线路由

### BE-5 安全校验
- `slug` 正则校验（小写字母/数字/连字符）
- `journalLanguage`、`editorialBaseStandard` 枚举校验
- 日志记录配置来源（system/custom）

---

## 6.2 前端任务

### FE-1 新增左侧一级模块
- ADMIN 左侧导航新增 `期刊配置中心`
- 路由挂载与权限控制

### FE-2 列表页
- 期刊列表（名称、slug、语言、状态、更新时间、操作）
- 支持搜索/筛选/分页

### FE-3 详情配置页
- 基础信息区：
  - 期刊全称
  - 访问路径 slug
  - 期刊语言（中文/英文/其他）
  - Logo/主色/背景图字段（先存储，MVP 可不渲染）
- 审稿配置区（4 Skills）：
  - 继承/自定义切换
  - Editorial 继承态支持 `zh/en` 基线选择
  - 每个维度 Prompt + Handlebars Template 文本框

### FE-4 API 类型对齐
- 更新 TypeScript DTO 与后端一致
- `null` 语义统一为“继承默认”

---

## 6.3 联调任务

### INT-1 中英文默认稿约验证
- JTIM 配置为 `en` 继承，触发英文稿约规则
- CMJ 配置为 `zh` 继承，触发中文稿约规则

### INT-2 继承与覆盖验证
- AAA 继承默认
- BBB 在临床维度自定义 Prompt
- 对比两者结果差异应符合预期

### INT-3 兼容性验证
- 历史任务查询不受影响
- 现有租户登录/访问链路不回归

---

## 7. 验收标准（DoD）

1. ADMIN 出现独立一级菜单「期刊配置中心」。
2. 可在期刊维度配置并保存 `期刊语言`。
3. 系统可明确区分中英文稿约默认规则。
4. 期刊支持“继承默认 + 局部覆盖”两种模式。
5. 数据库字段一次性补齐（P0/P1/P2 + 期刊语言）。
6. 所有迁移已入库并追加到待部署变更清单。

---

## 8. 排期建议（MVP）

- Day 1: BE-1 + BE-2（Schema/迁移/默认配置）
- Day 2: BE-3 + FE-1/FE-2（管理端骨架）
- Day 3: FE-3 + FE-4（配置页面联通）
- Day 4: BE-4 + 联调（INT-1/2/3）
- Day 5: 验收、文档补充、部署清单复核

---

## 9. 风险与规避

1. **风险：数据库 drift**  
   规避：禁止 db push，迁移前后执行 status 与 SQL 审查。

2. **风险：字段多但 UI 尚未全部启用**  
   规避：字段先入库，前端按阶段开放；未启用字段保持可空。

3. **风险：中英文规则路由错误**  
   规避：加运行时日志（language/baseStandard/promptSource）与双租户回归用例。

---

## 10. 审查报告对齐结论（含 TenantType 现状）

针对以下两份审查报告：

- `docs/03-业务模块/RVW-稿件审查系统/08-技术架构建议/期刊配置中心MVP计划审查报告.md`
- `docs/03-业务模块/RVW-稿件审查系统/08-技术架构建议/ADMIN多业态租户架构演进评估 (1).md`

本计划采用如下对齐结论：

### 10.1 认可并吸收的观点

1. **前端独立模块方向正确**：在 ADMIN 左侧建立独立一级菜单“期刊配置中心”是正确演进方向。  
2. **后端数据层保持统一**：继续复用 `platform_schema.tenants`，不拆分新的“期刊主租户表”。  
3. **配置中心必须可运营**：Handlebars 模板能力应保留，避免后续“千刊千面”报告格式无法落地。  
4. **跨表一致性要求**：涉及 tenants 与 tenant_rvw_configs 同步修改的场景，应使用事务保证原子性。  

### 10.2 需要修正的审查结论（以代码现状为准）

两份报告中“系统当前没有 TenantType”的表述不准确。当前系统**已存在 TenantType**：

- 后端 `backend/prisma/schema.prisma` 中已有 `enum TenantType` 与 `tenants.type`
- 当前枚举值：`HOSPITAL` / `PHARMA` / `INTERNAL` / `PUBLIC`

因此，本项目不需要“从 0 引入 TenantType 机制”，而是需要在现有机制上评估扩展：

- 方案 A（推荐）：新增 `JOURNAL` 枚举值，用于期刊配置中心过滤与治理
- 方案 B（兼容）：暂不新增枚举，短期用 `INTERNAL` 或约定标签过渡（不推荐长期使用）

本计划采用：**方案 A（新增 JOURNAL）**。

---

## 11. 最低成本实施策略（先跑通，不做大重构）

### 11.1 决策原则

针对“当前 Prompt 是否硬编码、是否立刻大重构”的问题，本计划明确：

1. **不做大重构**（避免阻塞交付）  
2. **必须做最小配置适配**（保证配置中心不是“假配置”）  
3. **Handlebars 保留并最小启用**（保留未来扩展能力，当前成本可控）

### 11.2 最小配置适配（必须）

在现有 RVW 链路上增加一层“薄适配”即可，不推翻当前实现：

- 统一规则：`finalPrompt = tenantCustomPrompt ?? systemDefaultPrompt`
- Editorial 特殊规则：
  - 租户未自定义时，按 `editorialBaseStandard` 选择 `zh/en` 默认 Prompt
  - 若未显式设置 `editorialBaseStandard`，则按 `journalLanguage` 映射（`ZH -> zh`，其他 -> `en`）
- 目标：让“期刊配置中心”的保存结果立即影响审稿行为

### 11.3 Handlebars 最小启用策略

当前阶段不做复杂重构，但必须保留模板层：

1. 字段保留：四维模板字段全部入库（已在第 4 章定义）
2. 运行时策略：模板为空时走系统默认模板
3. 失败兜底：模板渲染失败时降级返回原始报告内容，防止线上中断
4. MVP 可选项：测试渲染可先后置到 P1，但预留接口与校验能力

### 11.4 为什么不建议“完全按写死先跑”

若只做 UI 不接运行时，配置中心会变成“可编辑但不生效”，风险更高：

- 运营以为已生效，实际审稿仍走旧规则
- 期刊 AAA/BBB 差异化配置无法验证
- 后续回补执行链路时会引入二次返工和信任成本

因此本计划采用“**小步接线，先真生效**”策略，而非“先写死跑通”。

---

## 12. 本计划执行前检查清单

- [ ] 已确认英文默认稿约规则文本（指定文档）
- [ ] 已确认中文默认稿约规则文本（对应文档）
- [ ] 已同步研发团队数据库铁律（09 规范）
- [ ] 已确认 TenantType 扩展策略（新增 JOURNAL）
- [ ] 已确认“先最小适配，不做大重构”的实施口径
- [ ] 已创建本次迁移命名并分配负责人
- [ ] 已约定联调样例租户（至少 JTIM + CMJ）