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

RVW V4.0 期刊租户配置中心开发需求

模块定位： 依托现有 ADMIN 运营端 TenantDetailPage，为每个期刊客户建立独立的配置中枢。

核心目标： 实现期刊 SaaS 的“千刊千面”。

架构原则：

1. 配置继承模式 (Config Inheritance)：系统提供【标准默认配置】。期刊默认继承系统标准；需要个性化时，可开启【自定义覆盖】。
2. 中英双轨基线 (Dual-Baseline)：针对稿约规范，系统提供“英文期刊”与“中文期刊”两套底层标准，供租户自主选择绑定。
3. 全面 Prompt 化 (All-in-Prompt)：取消细颗粒度表单，采用“专家评判标准 (Prompt) + 报告展示模板 (Handlebars)”的开放式极简架构。

🎯 一、 前端 UI 与功能分区要求

在现有的 ADMIN 租户详情页（TenantDetailPage）中，构建两大核心配置区块：

区块 1：期刊基础信息与门户配置 (Basic Info & Portal)

用于定义该期刊的对外面貌和访问入口。

配置项名称	阶段	字段类型	UI 组件	功能说明
期刊全称	[P0]	String	文本输入框	如：Journal of Translational Internal Medicine。显示在登录页及工作台顶部。
访问路径(Slug)	[P0]	String	文本输入框(需正则)	极重要：用于生成 review.xunzhengyixue.com/{slug}。仅允许小写字母、数字和连字符。
期刊 Logo	[P1]	String	图片上传组件	上传至 OSS 后保存 URL。用于替换默认的系统 Logo。
品牌主色调	[P1]	String	颜色拾取器	支持 HEX 色值。用于动态渲染按钮和高亮文字。
登录页背景图	[P2]	String	图片上传组件	(暂不开发) 替换登录页的默认背景。

区块 2：智能审稿配置 (RVW Skills Config) —— 【全维度 Prompt 架构】

这是该模块的核心。对于 4 个配置面板，顶部必须增加一个全局切换组件：

• 🔘 选项 A: 继承系统默认配置 (Inherit System Default) [P0] —— 选中时，下方大文本框置灰只读。
• 🔘 选项 B: 启用个性化自定义 (Custom Override) [P0] —— 选中时，解锁下方大文本框，允许大面积修改。

Panel A: 稿约规范评估 (Editorial) —— 【支持中英标准选择】

作为特殊的规范模块，当选择 “继承系统默认配置” 时，必须提供一个下拉单选框供运营人员选择：

• 🔘 标准版英文期刊规范 (English Standard) [P0]：自动绑定英文 SCI 级审查标准（严查伦理声明等）。
• 🔘 标准版中文稿约规范 (Chinese Standard) [P0]：自动绑定中文核心期刊审查标准（查中英文摘要对照等）。

当选择 “启用个性化自定义” 时，展示下方的通用组件。

统一的面板配置项（适用于 Panel B / C / D 及自定义状态下的 Panel A）

• 1. 专家评判标准 (Expert Prompt) [P0]：大文本框。自由输入该期刊特有的审查要求（大模型读取）。
• 2. 报告展示模板 (Handlebars Template) [P0]：大文本框。用于配置最终输出给责编的 Markdown 格式。
• ⚠️ 3. 测试渲染 (Test Render) [P1]：在模板编辑区提供“预览”按钮。使用假 JSON 数据在右侧实时渲染 Markdown 结果，防语法写错导致线上白屏。(MVP 阶段若来不及，可由运营人员去前台真实传 PDF 测试兜底)。

💾 二、 数据库 Schema 设计 (Prisma) [P0]

DB 要求：即便 UI 是分阶段开发，数据库字段必须在 [P0] 阶段一次性建好，避免后续频繁 Migrate。

利用数据库的 null 语义表达“继承”。取消原有的 JSON 数组，统一为 Text 类型的 Prompt 和 Template 字段。

重点新增 editorialBaseStandard 字段，用于持久化期刊的中英文基线选择。

model TenantRvwConfig {
id String @id @default(uuid())
tenantId String @unique
tenant Tenant @relation(fields: [tenantId], references: [id])

// Panel A: 稿约规范评估
// 'en' 代表选用标准英文规范，'zh' 代表选用标准中文规范。
editorialBaseStandard String @default("en")
editorialExpertPrompt String? @db.Text
editorialHandlebarsTemplate String? @db.Text

// Panel B: 方法学评估
methodologyExpertPrompt String? @db.Text
methodologyHandlebarsTemplate String? @db.Text

// Panel C: 数据验证评估
dataForensicsExpertPrompt String? @db.Text
dataForensicsHandlebarsTemplate String? @db.Text

// Panel D: 临床专业评估
clinicalExpertPrompt String? @db.Text
clinicalHandlebarsTemplate String? @db.Text

createdAt DateTime @default(now())
updatedAt DateTime @updatedAt

@@schema("platform_schema")
}

🔌 三、 后端 API 与底层引擎继承逻辑 (核心)

1. 内部 ADMIN 配置接口 (需要 ops:user-ops 权限) [P0]

• PUT /api/admin/tenants/:id/basic-info：更新期刊名称、Slug (P1阶段再接 Logo 等)。
• GET /api/admin/tenants/:id/rvw-config：获取指定期刊的 Skills 配置（若不存在，返回 {}）。
• PUT /api/admin/tenants/:id/rvw-config：UPSERT 期刊 Skills 配置。若前端选择“继承系统默认”，对应的 ExpertPrompt 和 Template 传 null，但 editorialBaseStandard 必须传选中的值（'en'或'zh'）。

2. 底层引擎运行时的“降级合并 (Fallback Merge)”逻辑 [P0]

后端重构 SkillExecutor 时，实施深度合并策略。以 稿约规范 (EditorialSkill) 为例：

async function executeEditorialSkill(manuscript, tenantConfig) {
let promptToApply;

// 1\. 如果租户自定义了稿约 Prompt，直接使用租户的开放式配置 (优先级最高)  
if (tenantConfig && tenantConfig.editorialExpertPrompt) {  
    promptToApply \= tenantConfig.editorialExpertPrompt;  
}   
// 2\. 租户未自定义（为 null），触发系统默认降级逻辑  
else {  
    // 2.1 读取该期刊在后台配置的“标准语言基线”  
    const baseStandard \= tenantConfig?.editorialBaseStandard || 'en';   
      
    // 2.2 根据基线拉取对应的【系统标准版规范】Prompt  
    if (baseStandard \=== 'en') {  
        promptToApply \= await promptService.get('SYSTEM\_DEFAULT\_EDITORIAL\_EN');  
    } else if (baseStandard \=== 'zh') {  
        promptToApply \= await promptService.get('SYSTEM\_DEFAULT\_EDITORIAL\_ZH');  
    }  
}

// 3\. 将 promptToApply 喂给 LLM 执行，并使用对应 Handlebars 模板渲染...  

}

方法学、数据验证和临床评估的逻辑同理：最终提示词 = 租户自定义 Prompt ?? 系统默认 Prompt。

👥 四、 实施 SOP：用户与期刊绑定（无需开发）

1. 客户在主站注册账号（或由超管分配账号）。
2. 内部超管在 ADMIN 端的 【用户管理 -> 租户成员管理】 页面，将该用户的账号添加到目标期刊租户（如 JTIM）下。
3. 确保该用户拥有 RVW 模块的使用权限。
4. 验证：此后该用户访问 review.xunzhengyixue.com/jtim 时，JWT 中会自动带上该租户身份，接口方可放行。

✅ 五、 验收标准 (Definition of Done - P0 阶段)

1. ADMIN 后台成功渲染出只包含大文本框（Textarea）的极简配置界面。
2. 中英基线验证：
   • 将 JTIM 的【稿约规范】设置为“继承系统默认”并选择**【标准版英文期刊规范】**，上传稿件时，系统严格核查伦理声明等英文规则。
   • 将 CMJ 设置为“继承系统默认”并选择**【标准版中文稿约规范】**，系统重点核查中英文摘要对应等中文规则。
3. 当某期刊在【临床专业评估】开启自定义后，运营人员在大文本框中修改提示词并保存，新上传的稿件严格按该设定执行评估。

🚀 六、 分阶段实施与 MVP 裁剪指南 (给 PM 与研发团队)

为了保证项目快速上线，坚决执行 Managed SaaS (代运营) 和 All-in-Prompt 的裁剪策略。

🔴 第一阶段：MVP 必做清单 (P0) —— 目标：系统能跑通双语及个性化

• 数据库：一次性建好所有 Schema 字段（包含全部 Text 和 BaseStandard 字段）。
• 核心引擎：必须完成 SkillExecutor 的降级合并逻辑（?? 合并）和中英文 Prompt 的自动路由。
• ADMIN 前端：只要最基础、最“丑”的表单输入框。实现“继承/自定义”的单选切换，并暴露 Textarea。不做任何复杂的花哨控件。
• 业务前端：根据 URL 中的 /:tenantId 成功拦截并获取对应的【期刊名称】（纯文本展示即可）。

🟡 第二阶段：视觉与防呆增强 (P1) —— 目标：上线后 1-2 周内快反

• 模板预览 (Test Render)：复用底层 PromptService 补齐预览按钮，防止运营在纯文本框写错 Handlebars 语法导致线上白屏。
• 品牌视觉提升：补齐期刊 Logo、主色调配置，并在客户端动态渲染，提升 SaaS 专属感。
• 接口安全：为公开的品牌信息拉取接口增加 Redis 缓存与 Rate Limiting 限流防刷。

🟢 第三阶段：暂缓或砍掉的伪需求 (P2) —— 目标：避免过度工程

• 细颗粒度表单控件：既然已经全面 Prompt 化，坚决不再开发滑块（如权重分配）、下拉枚举（如验证级别）等细分 UI 控件。全部用 Prompt 解决。
• 客户自助配置后台：坚决不做。坚持代运营模式，期刊主编提需求，内部运营人员在 ADMIN 端修改，规避复杂的 B 端权限开发。
• 登录页背景图定制：暂不开发，统一使用系统默认干净纯色底即可。