Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(rvw): complete journal config center MVP and tenant login routing

Browse Source 
Deliver the RVW V4.0 journal configuration center across backend, frontend, migration, and docs with zh/en editorial baseline support and tenant-level prompt/template overrides. Unify tenant login to /:tenantCode/login and auto-enable RVW module when tenant type is JOURNAL to prevent post-login access gaps.

Made-with: Cursor
This commit is contained in:
HaHafeng
2026-03-15 11:51:35 +08:00
parent 16179e16ca
commit 83e395824b
44 changed files with 2555 additions and 312 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/05-部署文档/03-待部署变更清单.md
View File

@@ -19,6 +19,7 @@
| DB-1 | SSA Agent 执行记录新增分步执行与种子审计字段（`step_results/current_step/seed_audit`） | `20260311_add_ssa_agent_step_seed_fields` | 高 | 按数据库规范生成；Shadow DB 失败后采用降级流程产出 SQL，并已人工收敛为仅本次字段变更 |
| DB-2 | RVW V4.0：新增 `platform_schema.tenant_rvw_configs` 表（每期刊独立审稿配置，含4维提示词+Handlebars模板） | `20260314_add_tenant_rvw_configs` | 高 | ⚠️ 部署前无需前置条件；使用降级流程手动创建迁移SQL，需执行 `prisma migrate resolve --applied 20260314_add_tenant_rvw_configs` 标记为已应用 |
| DB-3 | RVW V4.0：`rvw_schema.review_tasks` 新增 `tenant_id` 字段 + 索引（历史数据平滑回填两步走） | `20260314_add_tenant_id_to_review_tasks` | 高 | ⚠️ **部署前必须先确认** `platform_schema.tenants` 中存在 `code='yanjiu'` 的主站默认租户；迁移会自动将历史记录回填为该租户ID；需执行 `prisma migrate resolve --applied 20260314_add_tenant_id_to_review_tasks` 标记为已应用 |
| DB-4 | RVW V4.0：期刊配置中心 MVP 一次性补齐字段（`tenants` 新增期刊字段；`tenant_rvw_configs` 升级为 4 维 Prompt+Template；`TenantType` 新增 `JOURNAL`） | `20260315_journal_config_center_mvp` | 高 | ⚠️ `prisma migrate dev` 因历史 shadow DB 迁移失败触发降级流程，已按规范收敛手工 SQL；部署后执行 `prisma migrate resolve --applied 20260315_journal_config_center_mvp` |
### 后端变更 (Node.js)
@@ -30,7 +31,9 @@
| BE-4 | R 代码语法修复器纠正 `} else` 处理策略，避免引入 `unexpected 'else'` | `backend/src/modules/ssa/services/CodeRunnerService.ts` | 重新构建镜像 | 修复线上语法错误噪声，减少重试失败 |
| BE-5 | RVW 审稿通道改造：4 通道 Prompt 动静分离（业务提示词可编辑 + 系统协议固化）+ 方法学/稿约 JSON 结构化修复兜底 + DataForensics 默认切换为 LLM-only（规则验证默认关闭） | `backend/src/modules/rvw/services/promptProtocols.ts`, `backend/src/modules/rvw/services/editorialService.ts`, `backend/src/modules/rvw/services/methodologyService.ts`, `backend/src/modules/rvw/services/clinicalService.ts`, `backend/src/modules/rvw/skills/library/DataForensicsSkill.ts`, `backend/src/modules/rvw/skills/core/types.ts`, `backend/src/common/document/ExtractionClient.ts`, `backend/src/common/prompt/prompt.fallbacks.ts` | 重新构建镜像 | 解决运营端改 Prompt 导致 JSON 解析失败；数据侦探默认仅“表格提取+LLM判断”，规则代码保留可回切 |
| BE-6 | RVW V4.0 Phase 1：Prisma Schema 新增 TenantRvwConfig 模型 + ReviewTask.tenantId 字段 + RVW租户中间件（rvwTenantMiddleware，slug到UUID解析+tenant_members校验+缓存）+ FastifyRequest 扩展 tenantId/tenant 字段 | `backend/prisma/schema.prisma`, `backend/src/modules/rvw/middleware/rvwTenantMiddleware.ts`, `backend/src/common/auth/auth.middleware.ts` | 重新构建镜像 + 执行 DB-2/DB-3 迁移 | 与 DB-2/DB-3 配套上线；Prisma Client 已重新生成 |
|| BE-7 | RVW V4.0 Phase 2：RVW Config CRUD API（GET/PUT `/api/admin/tenants/:id/rvw-config`）+ Handlebars 渲染引擎（Zod 校验 + 默认模板）+ SkillExecutor 按租户装配 Hybrid Prompt | `backend/src/modules/admin/rvw-config/rvwConfigController.ts`, `backend/src/modules/admin/rvw-config/rvwConfigService.ts`, `backend/src/modules/admin/rvw-config/rvwConfigRoutes.ts`, `backend/src/modules/rvw/services/rvwReportRenderer.ts`, `backend/src/modules/rvw/workers/reviewWorker.ts`, `backend/src/index.ts` | 重新构建镜像 | 与 BE-6/DB-2/DB-3 配套上线 |
| BE-7 | RVW V4.0 Phase 2：RVW Config CRUD API（GET/PUT `/api/admin/tenants/:id/rvw-config`）+ Handlebars 渲染引擎（Zod 校验 + 默认模板）+ SkillExecutor 按租户装配 Hybrid Prompt | `backend/src/modules/admin/rvw-config/rvwConfigController.ts`, `backend/src/modules/admin/rvw-config/rvwConfigService.ts`, `backend/src/modules/admin/rvw-config/rvwConfigRoutes.ts`, `backend/src/modules/rvw/services/rvwReportRenderer.ts`, `backend/src/modules/rvw/workers/reviewWorker.ts`, `backend/src/index.ts` | 重新构建镜像 | 与 BE-6/DB-2/DB-3 配套上线 |
| BE-8 | RVW V4.0 Phase 3：后端 CORS 配置新增 x-tenant-id 白名单（多租户 Header 跨域支持） | `backend/src/index.ts` | 重新构建镜像 | ⚠️ 缺少此项会导致浏览器预检请求拦截 x-tenant-id，整个多租户功能失效 |
| BE-9 | RVW V4.0 Phase 4（期刊配置中心 MVP）：新增 `/api/admin/journal-configs` 专用 API；租户模型扩展期刊字段；RVW 执行链路接入最小配置适配（`tenantCustom ?? systemDefault`），Editorial 支持 `zh/en` 基线路由；创建/更新为 `JOURNAL` 时自动兜底开通 `RVW` 模块 | `backend/src/modules/admin/journal-config/*`, `backend/src/modules/admin/services/tenantService.ts`, `backend/src/modules/admin/types/tenant.types.ts`, `backend/src/modules/admin/rvw-config/*`, `backend/src/modules/rvw/workers/reviewWorker.ts`, `backend/src/modules/rvw/skills/library/*`, `backend/src/modules/rvw/services/editorialService.ts`, `backend/src/modules/rvw/services/clinicalService.ts`, `backend/src/common/prompt/prompt.fallbacks.ts`, `backend/src/index.ts` | 重新构建镜像 + 执行 DB-4 迁移 | 与 FE-7 联动上线，满足「独立一级菜单 + 中英文基线 + 继承/覆盖」MVP 范围，并避免新期刊用户登录后无 RVW 模块权限 |
### 前端变更
@@ -39,10 +42,11 @@
| FE-1 | Agent 通道接入 step_* SSE 事件并展示分步执行状态（兼容旧 code_* 事件） | `frontend-v2/src/modules/ssa/hooks/useSSAChat.ts`, `frontend-v2/src/modules/ssa/components/AgentCodePanel.tsx`, `frontend-v2/src/modules/ssa/types/index.ts`, `frontend-v2/src/modules/ssa/stores/ssaStore.ts` | 重新构建镜像 | 右侧工作区可见每步状态/错误/耗时，便于排障 |
| FE-2 | Agent 计划阶段复用 QPER 变量编辑控件（单变量/多变量）并接入保存、确认前自动保存 | `frontend-v2/src/modules/ssa/components/AgentCodePanel.tsx`, `frontend-v2/src/modules/ssa/components/WorkflowTimeline.tsx`, `frontend-v2/src/modules/ssa/components/SSAWorkspacePane.tsx` | 重新构建镜像 | 对接 `PATCH /agent-executions/:executionId/plan-params`，实现 5A.5 前后端闭环 |
| FE-3 | Agent 工作区增强：在分步状态下可展开查看每步已生成结果（`reportBlocks`），并兼容严格分步模式下的 `code_pending` 空代码预览 | `frontend-v2/src/modules/ssa/components/AgentCodePanel.tsx`, `frontend-v2/src/modules/ssa/hooks/useSSAChat.ts` | 重新构建镜像 | 修复“有结果但代码下方不可见”与状态显示误导问题 |
|| FE-4 | RVW V4.0 Phase 2：TenantDetailPage 新增「智能审稿配置」Tab（4 Panel：稿约规范占位 / 方法学Prompt+Handlebars模板 / 数据验证深度L1-L3 / 临床FINER权重）+ tenantApi 新增 fetchRvwConfig/saveRvwConfig | `frontend-v2/src/pages/admin/tenants/TenantDetailPage.tsx`, `frontend-v2/src/pages/admin/tenants/api/tenantApi.ts` | 重新构建镜像 | 与 BE-7/DB-2/DB-3 配套上线 |
|| BE-8 | RVW V4.0 Phase 3：后端 CORS 配置新增 x-tenant-id 白名单（多租户 Header 跨域支持） | `backend/src/index.ts` | 重新构建镜像 | ⚠️ 缺少此项会导致浏览器预检请求拦截 x-tenant-id，整个多租户功能失效 |
|| FE-5 | RVW V4.0 Phase 3：新增 TenantPortalLayout 极简期刊门户布局 + App.tsx 新增 /:tenantSlug/rvw/* 路由（期刊专属 URL）+ LoginPage.tsx 修复跳转逻辑（读取 ?redirect= 查询参数 + 租户默认落地页 /:tenantSlug/rvw） | `frontend-v2/src/framework/layout/TenantPortalLayout.tsx`, `frontend-v2/src/App.tsx`, `frontend-v2/src/pages/LoginPage.tsx` | 重新构建镜像 | 与 BE-6/BE-7/BE-8 配套上线；实现期刊租户完整访问路径 /jtim → /jtim/rvw |
| FE-6 | RVW V4.0 租户门户体验收敛：上传按钮稳定触发（原生文件选择器 API + input 回退）、执行审稿后跳转旧版过程页（复用 `TaskDetail`）、列表四维状态图标修复（完成态正确显示绿勾/警告） | `frontend-v2/src/modules/rvw/pages/TenantDashboard.tsx`, `frontend-v2/src/modules/rvw/pages/TenantTaskDetail.tsx` | 重新构建镜像 | 已本地联调通过；上线后重点回归 `/t/:tenant/login -> /:tenant/rvw` 主流程 |
| FE-4 | RVW V4.0 Phase 2：TenantDetailPage 新增「智能审稿配置」Tab（4 Panel：稿约规范占位 / 方法学Prompt+Handlebars模板 / 数据验证深度L1-L3 / 临床FINER权重）+ tenantApi 新增 fetchRvwConfig/saveRvwConfig | `frontend-v2/src/pages/admin/tenants/TenantDetailPage.tsx`, `frontend-v2/src/pages/admin/tenants/api/tenantApi.ts` | 重新构建镜像 | 与 BE-7/DB-2/DB-3 配套上线 |
| FE-5 | RVW V4.0 Phase 3：新增 TenantPortalLayout 极简期刊门户布局 + App.tsx 新增 /:tenantSlug/rvw/* 路由（期刊专属 URL）+ LoginPage.tsx 修复跳转逻辑（读取 ?redirect= 查询参数 + 租户默认落地页 /:tenantSlug/rvw） | `frontend-v2/src/framework/layout/TenantPortalLayout.tsx`, `frontend-v2/src/App.tsx`, `frontend-v2/src/pages/LoginPage.tsx` | 重新构建镜像 | 与 BE-6/BE-7/BE-8 配套上线；实现期刊租户完整访问路径 /jtim → /jtim/rvw |
| FE-6 | RVW V4.0 租户门户体验收敛：上传按钮稳定触发（原生文件选择器 API + input 回退）、执行审稿后跳转旧版过程页（复用 `TaskDetail`）、列表四维状态图标修复（完成态正确显示绿勾/警告） | `frontend-v2/src/modules/rvw/pages/TenantDashboard.tsx`, `frontend-v2/src/modules/rvw/pages/TenantTaskDetail.tsx` | 重新构建镜像 | 已本地联调通过；上线后重点回归 `/:tenant/login -> /:tenant/rvw` 主流程 |
| FE-7 | RVW V4.0 期刊配置中心 MVP：ADMIN 新增独立一级菜单“期刊配置中心”，新增列表页/详情页（基础信息 + 4 维审稿配置），并对齐新 API DTO（`journalLanguage`、`editorialBaseStandard`、Prompt/Handlebars 字段） | `frontend-v2/src/framework/layout/AdminLayout.tsx`, `frontend-v2/src/App.tsx`, `frontend-v2/src/pages/admin/journal-configs/*`, `frontend-v2/src/pages/admin/tenants/api/tenantApi.ts`, `frontend-v2/src/pages/admin/tenants/TenantDetailPage.tsx` | 重新构建镜像 | 与 BE-9/DB-4 配套上线；MVP 阶段先跑通配置闭环，品牌视觉字段先存储后逐步渲染 |
| FE-8 | 登录路径策略统一为单一路径：仅保留 `/:tenantCode/login`，未登录重定向与退出登录统一 `/:tenant/login`，开发/生产同路径仅域名不同 | `frontend-v2/src/App.tsx`, `frontend-v2/src/framework/router/RouteGuard.tsx`, `frontend-v2/src/framework/layout/TenantPortalLayout.tsx`, `frontend-v2/src/pages/TenantLoginPage.tsx`, `frontend-v2/src/pages/LoginPage.tsx` | 重新构建镜像 | 对齐生产目标链接 `review.xunzhengyixue.com/test-qikan01`；不再保留 `/t/:tenantCode/login` 路径，需同步更新测试文档/书签 |
### Python 微服务变更
@@ -66,7 +70,8 @@
| # | 变更内容 | 范围 | 备注 |
|---|---------|------|------|
| — | *暂无* | | |
| INF-1 | 前端 Nginx 增加 SPA 深链回退（`try_files $uri /index.html`），并确保 `/api/` 路由优先反代后端（不能被 index.html 吞掉） | frontend-nginx-service / ingress | ⚠️ 否则直接访问 `review.xunzhengyixue.com/test-qikan01` 或 `.../test-qikan01/login` 会 404；部署后需在无缓存浏览器验证 |
| INF-2 | 前端 Docker 构建与发布注意：确认镜像内 Nginx 配置已包含深链规则、并清理旧静态资源缓存（CDN/浏览器）后再灰度 | frontend-v2 build/deploy pipeline | 建议发布后先执行硬刷新（Ctrl+F5）与隐身窗口验证，避免旧 bundle 缓存导致仍跳旧路径 |
---