生成时间: 2026-08-02 · 数据来源: xnybw平台需求及工作计划.xlsx(南网在线绿能云缺陷跟踪表)· 仅针对 backup730/730backup 分支代码

① 基本信息

问题描述调度材料补录,点击查阅按钮进去之后显示空白
一级模块调度材料补录
二级模块调度材料补录
涉及类型全部类型
严重性严重
当前状态5.1.已关闭
研发处理人陈键泽
复测情况复测通过

② 问题截图

调度材料补录-在途历史补录列表
调度材料补录 > 在途历史补录 列表页(可正常查询到项目)
点击查阅后空白页面
点击"处理/查阅"跳转后的详情页整页空白,地址栏可见路由为 project-form?...&isHistoryRecord=1&...

③ 旧代码涉及的项目文件及行数(backup730/730backup 分支)

经在 xnybw5f(backup730)全仓库范围内检索 history-recordHistoryRecord、"调度材料补录"、"在途历史补录" 等关键词,均无任何命中src/router 下全部路由模块(base.js / projectMaintain.js / anziEquipment.js / test.js)中也没有以 project-history-record-list 为前缀的路由定义。即:backup730 前端分支中不存在"调度材料补录/历史补录"这一模块的任何页面代码
xnybw5f / src/router/modules/base.js 全文件(共 8 个业务路由)未包含 project-history-record-list 相关配置

与之相反,后端 xnybw5b(730backup)已经具备该功能对应的接口实现:

xnybw5b / src/main/java/cn/csg/so/oms/in/newenergy/project/controller/HistoryProjectController.java 全文件,接口:/newenergy/history/getProjectListByPhone、/newenergy/history/validateAccess
xnybw5b / src/main/java/cn/csg/so/oms/in/newenergy/project/appservice/HistoryProjectAppService.java 历史项目补录业务逻辑
xnybw5b / src/main/resources/cn/csg/so/oms/in/newenergy/project/dbconfig/HistoryProjectVOSQL_dm.xml、HistoryProjectVOSQL_mysql.xml 达梦 / MySQL 双方言 SQL 配置

④ 修复代码涉及的项目文件及行数

前后端进度不同步是本缺陷的根因:后端接口已就绪,但 backup730 快照对应的前端版本尚未接入该模块的列表页与详情页,因此路由匹配不到组件、页面渲染为空白。修复需要在前端补齐以下内容(backup730 分支当前缺失,属于新增,而非修改现有文件):

xnybw5f / src/router/modules/base.js 新增路由(建议追加在第 44 行 OperationLogsSearchList 定义之后)
{
+  path: '/project-history-record-list/project-list/:type',
+  name: 'ProjectHistoryRecordList',
+  props: true,
+  component: () => import('@/views/projectNew/historyRecord/projectHistoryList.vue'),
+  meta: { title: '调度材料补录 - 在途历史补录列表' }
},
{
+  path: '/project-history-record-list/project-form',
+  name: 'ProjectHistoryRecordForm',
+  component: () => import('@/views/projectNew/ProjectTabs.vue'),  // 复用现有详情组件,isHistoryRecord=1 时走只读/补录态
+  meta: { title: '调度材料补录 - 详情' }
}
xnybw5f / src/views/projectNew/historyRecord/projectHistoryList.vue 新增文件:调用后端 /newenergy/history/getProjectListByPhone 渲染列表
xnybw5f / src/views/projectNew/ProjectTabs.vue 复核该组件在 isHistoryRecord=1 场景下能否正确解析 query 参数并加载数据(对照实际线上已修复效果)

⑤ 修复方案

后端接口
已就绪
backup730 前端
路由/页面缺失
点击查阅
白屏

1. 在前端补充"调度材料补录"(在途历史补录)模块的列表页与详情页路由,列表页调用已有的 POST /newenergy/history/getProjectListByPhone 接口(后端已按当前登录人手机号做了归属过滤,符合项目安全基线,不需要前端再传 userId/phone 等身份参数)。

2. 详情页复用现有 ProjectTabs.vueProjectForm.vue 组件体系,通过 isHistoryRecord=1 查询参数区分"历史补录"场景,进入前先调用 POST /newenergy/history/validateAccess(传 planId)校验当前登录人是否有权限查看/补录该历史项目,无权限时提示而非空白。

3. 由于该问题在缺陷单中标记为"5.1.已关闭 / 复测通过",说明线上环境已经补齐了上述前端页面(backup730 快照落后于线上发布版本);本方案给出的是与后端既有接口对齐、可在 backup730 基线上原样落地的实现路径,供后续分支同步或回溯核对使用。

补充说明:row37(Excel第37行)与本行同属"新能源并网调度管理相关的存量数据回填"功能演进的一部分,二者均与 8.2 版本发布计划相关,建议合并排期验证。