# 电子数据接口迁移对照表 > 源项目:`clueAnalysis-JW/xly-file`,包 `com.xly.eds.controller`(20 个 Controller、112 个有效接口)。 > 目标项目:`zsjz-ai/ai-server`,包 `com.zsjz.ai.module.eds`。 > 本文档用于前端迁移时逐条查找旧接口与新接口的对应关系。 ## 一、全局变化 | 项目 | 旧 | 新 | |---|---|---| | 后端上下文 | 旧项目根路径 | `/js/a`(Spring Boot `server.servlet.context-path`) | | 路由前缀 | `/electronic/**` | `/eds/**`(去掉 `/electronic`) | | 返回体 | `R{code,msg,data}` | `Result{code,message,data}`,`msg` 改名为 `message` | | 案件上下文 | 请求头 `x-custom-header` | 登录后打开案件,后端从 `CaseContextHolder` 读取;不再需要请求头 | | 分页请求 | `current` / `size` | `page` / `limit`(默认 1 / 10;浏览器、邮箱、社交应用等接口沿用旧默认 -1 表示全部) | | 分页响应 | MyBatis-Plus `Page` | 不变:`records/total/size/current/pages` | | 字典名称 | 旧库 `eds_dict`(`bmlx_py/bmsz/bmmc`) | 新案件 DuckDB `eds_dict`(`code_type_code/code_value/code_name`),按案件加载,未导入数据时回退原始编码 | | 导出 | `dataScope` 触发 Excel 下载 | 本批不迁移,普通分页查询保留 | | 鉴权 | 旧登录态 | Sa-Token,`x-token` 请求头;新接口默认要求登录 | ## 二、新旧接口对照表 地址均相对上下文 `/js/a`。 | # | 模块 | 方法 | 原地址 | 新地址 | 状态 | 说明 | |---:|---|---|---|---|---|---| | 1 | 账号 | GET | /electronic/account/list/{cid} | /eds/account/list/{cid} | 迁移 | 分页参数 page/limit | | 2 | 基本信息 | GET | /electronic/baseInfo/caseInfo/{cid} | /eds/baseInfo/caseInfo/{cid} | 迁移 | 字典名称经 eds_dict 翻译 | | 3 | 基本信息 | GET | /electronic/baseInfo/systemAccount/{cid} | /eds/baseInfo/systemAccount/{cid} | 迁移 | | | 4 | 基本信息 | GET | /electronic/baseInfo/application/{cid} | /eds/baseInfo/application/{cid} | 迁移 | 分页参数 page/limit | | 5 | 基本信息 | GET | /electronic/baseInfo/operationRecord/{cid} | /eds/baseInfo/operationRecord/{cid} | 迁移 | 分页参数 page/limit;动作类型安全解析 | | 6 | 基本信息 | GET | /electronic/baseInfo/getRelevancyPage/{cid} | — | 不迁移 | @Deprecated,依赖 bd_platform,原实现 NPE | | 7 | 浏览器 | GET | /electronic/browser/getBrowseAccount/{collectTargetId}/{browseType} | /eds/browser/getBrowseAccount/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 8 | 浏览器 | GET | /electronic/browser/getBrowseHistory/{collectTargetId}/{browseType} | /eds/browser/getBrowseHistory/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 9 | 浏览器 | GET | /electronic/browser/getBrowseHistoryByStat/{collectTargetId} | /eds/browser/getBrowseHistoryByStat/{collectTargetId} | 迁移 | 分页参数 page/limit | | 10 | 浏览器 | GET | /electronic/browser/getBrowseFavorites/{collectTargetId}/{browseType} | /eds/browser/getBrowseFavorites/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 11 | 浏览器 | GET | /electronic/browser/getBrowseCookie/{collectTargetId}/{browseType} | /eds/browser/getBrowseCookie/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 12 | 浏览器 | GET | /electronic/browser/getBrowseSearch/{collectTargetId}/{browseType} | /eds/browser/getBrowseSearch/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 13 | 即时通信 | POST | /electronic/chat/getAccountInfo | /eds/chat/getAccountInfo | 迁移 | | | 14 | 即时通信 | POST | /electronic/chat/getFriendInfoGroup | /eds/chat/getFriendInfoGroup | 迁移 | | | 15 | 即时通信 | POST | /electronic/chat/getFriendMsgGroup | /eds/chat/getFriendMsgGroup | 迁移 | | | 16 | 即时通信 | POST | /electronic/chat/getFriendDynamicGroup | /eds/chat/getFriendDynamicGroup | 迁移 | | | 17 | 即时通信 | POST | /electronic/chat/getFriendInfoList | /eds/chat/getFriendInfoList | 迁移 | 分页参数 page/limit | | 18 | 即时通信 | POST | /electronic/chat/getFriendMsgList | /eds/chat/getFriendMsgList | 迁移 | 分页参数 page/limit | | 19 | 即时通信 | POST | /electronic/chat/getFriendDynamicList | /eds/chat/getFriendDynamicList | 迁移 | 分页参数 page/limit | | 20 | 即时通信 | POST | /electronic/chat/getFriendInfo | /eds/chat/getFriendInfo | 迁移 | | | 21 | 即时通信 | POST | /electronic/chat/getGroupInfoList | /eds/chat/getGroupInfoList | 迁移 | | | 22 | 即时通信 | POST | /electronic/chat/getGroupMsgList | /eds/chat/getGroupMsgList | 迁移 | | | 23 | 即时通信 | POST | /electronic/chat/getGroupPersonInfo | /eds/chat/getGroupPersonInfo | 迁移 | | | 24 | 即时通信 | POST | /electronic/chat/getMsgInfo | /eds/chat/getMsgInfo | 迁移 | 分页参数 page/limit | | 25 | 即时通信 | POST | /electronic/chat/getDynamicInfo | /eds/chat/getDynamicInfo | 迁移 | 分页参数 page/limit | | 26 | 即时通信 | POST | /electronic/chat/getSearchInfo | /eds/chat/getSearchInfo | 迁移 | 分页参数 page/limit | | 27 | 检查项 | GET | /electronic/checkItem/getHitTargetType | — | 不迁移 | 目标库无 wa_mforensics_777777 | | 28 | 检查项 | GET | /electronic/checkItem/getCheckItemTree | — | 不迁移 | 目标库无 wa_mforensics_777777 | | 29 | 检查项 | GET | /electronic/checkItem/getCheckItemDetail | — | 不迁移 | 目标库无 wa_mforensics_777777 | | 30 | 电商 | GET | /electronic/commerce/account/{cid}/{type}/{account} | /eds/commerce/account/{cid}/{type}/{account} | 迁移 | | | 31 | 电商 | GET | /electronic/commerce/tradeRecord/{cid}/{type}/{account} | /eds/commerce/tradeRecord/{cid}/{type}/{account} | 迁移 | 分页参数 page/limit | | 32 | 电商 | GET | /electronic/commerce/searchRecord/{cid}/{type}/{account} | /eds/commerce/searchRecord/{cid}/{type}/{account} | 迁移 | 分页参数 page/limit | | 33 | 电商 | POST | /electronic/commerce/getGroupRedEnvelopeList | /eds/commerce/getGroupRedEnvelopeList | 迁移 | | | 34 | 电商 | POST | /electronic/commerce/getGroupRedEnvelopeInfo | /eds/commerce/getGroupRedEnvelopeInfo | 迁移 | 分页参数 page/limit | | 35 | 通话短信 | GET | /electronic/callSms/contacts/{cid} | /eds/callSms/contacts/{cid} | 迁移 | 分页参数 page/limit | | 36 | 通话短信 | GET | /electronic/callSms/smsStat/{cid} | /eds/callSms/smsStat/{cid} | 迁移 | | | 37 | 通话短信 | GET | /electronic/callSms/callStat/{cid} | /eds/callSms/callStat/{cid} | 迁移 | | | 38 | 通话短信 | POST | /electronic/callSms/smsDetail | /eds/callSms/smsDetail | 迁移 | 分页参数 page/limit | | 39 | 通话短信 | POST | /electronic/callSms/callDetail | /eds/callSms/callDetail | 迁移 | 分页参数 page/limit | | 40 | 通话短信 | POST | /electronic/callSms/callAndSmsDetail | /eds/callSms/callAndSmsDetail | 迁移 | 分页参数 page/limit | | 41 | 数据统计 | GET | /electronic/dataStat/latestConnectUsb/{cid} | /eds/dataStat/latestConnectUsb/{cid} | 迁移 | | | 42 | 数据统计 | GET | /electronic/dataStat/smsTop10/{cid} | /eds/dataStat/smsTop10/{cid} | 迁移 | | | 43 | 数据统计 | GET | /electronic/dataStat/callNumTop10/{cid} | /eds/dataStat/callNumTop10/{cid} | 迁移 | | | 44 | 数据统计 | GET | /electronic/dataStat/callTimeTop10/{cid} | /eds/dataStat/callTimeTop10/{cid} | 迁移 | | | 45 | 数据统计 | GET | /electronic/dataStat/QQTop10/{cid} | /eds/dataStat/QQTop10/{cid} | 迁移 | | | 46 | 数据统计 | GET | /electronic/dataStat/weChatTop10/{cid} | /eds/dataStat/weChatTop10/{cid} | 迁移 | | | 47 | 数据统计 | GET | /electronic/dataStat/emailTop10/{cid} | /eds/dataStat/emailTop10/{cid} | 迁移 | | | 48 | 数据统计 | GET | /electronic/dataStat/websiteTop10/{cid} | /eds/dataStat/websiteTop10/{cid} | 迁移 | | | 49 | 数据统计 | GET | /electronic/dataStat/nonPhone/{cid} | /eds/dataStat/nonPhone/{cid} | 迁移 | | | 50 | 数据统计 | GET | /electronic/dataStat/getRecentlyAccessedFile/{cid}/{id} | /eds/dataStat/getRecentlyAccessedFile/{cid}/{id} | 迁移 | 分页参数 page/limit | | 51 | 数据统计 | GET | /electronic/dataStat/getRecentlyAccessedSoft/{cid}/{id} | /eds/dataStat/getRecentlyAccessedSoft/{cid}/{id} | 迁移 | 分页参数 page/limit | | 52 | 数据统计 | GET | /electronic/dataStat/getHotDownSoft/{cid}/{name} | /eds/dataStat/getHotDownSoft/{cid}/{name} | 迁移 | name 先按字典反查编码 | | 53 | 数据统计 | GET | /electronic/dataStat/getRecentlyLinkUSB/{cid}/{name} | /eds/dataStat/getRecentlyLinkUSB/{cid}/{name} | 迁移 | name 先按字典反查编码 | | 54 | 银行交易 | POST | /electronic/bankTrade/jinjiCount | — | 不迁移 | 目标库无 eds_bank_trade | | 55 | 银行交易 | POST | /electronic/bankTrade/jinjiXinxi | — | 不迁移 | 目标库无 eds_bank_trade | | 56 | 银行交易 | POST | /electronic/bankTrade/dingwei | /eds/bankTrade/dingwei | 迁移 | 请求体 caseId 忽略 | | 57 | 银行交易 | GET | /electronic/bankTrade/edsList?caseId= | /eds/bankTrade/edsList | 迁移 | 去掉 caseId;返回 EdsBankTradeFileDTO | | 58 | 图片分类 | POST | /pices/test | — | 不迁移 | 依赖 demo.exe/main.exe + ES | | 59 | 共群分析 | POST | /edsGroup/edsGroupList | /eds/group/edsGroupList | 迁移 | 导出分支不迁移 | | 60 | 共群分析 | POST | /edsGroup/memberMsgContext | /eds/group/memberMsgContext | 迁移 | 分页参数 page/limit | | 61 | 共群分析 | POST | /edsGroup/memberMsgPageChange | /eds/group/memberMsgPageChange | 迁移 | 分页参数 page/limit;导出展开分支不迁移 | | 62 | 邮件 | GET | /electronic/email/getAccountInfo/{collectTargetId}/{mailToolType}/{account} | /eds/email/getAccountInfo/{collectTargetId}/{mailToolType}/{account} | 迁移 | | | 63 | 邮件 | GET | /electronic/email/getFriendGroup/{collectTargetId}/{mailToolType}/{account} | /eds/email/getFriendGroup/{collectTargetId}/{mailToolType}/{account} | 迁移 | | | 64 | 邮件 | GET | /electronic/email/getFriend/{collectTargetId}/{mailToolType}/{account} | /eds/email/getFriend/{collectTargetId}/{mailToolType}/{account} | 迁移 | 分页参数 page/limit | | 65 | 邮件 | GET | /electronic/email/getFriendInfo/{collectTargetId}/{mailToolType}/{account}/{friendAccount} | /eds/email/getFriendInfo/{collectTargetId}/{mailToolType}/{account}/{friendAccount} | 迁移 | | | 66 | 邮件 | GET | /electronic/email/getEmailRecord/{collectTargetId}/{mailToolType}/{account} | /eds/email/getEmailRecord/{collectTargetId}/{mailToolType}/{account} | 迁移 | | | 67 | 邮件 | GET | /electronic/email/getEmailRecordInfo/{collectTargetId}/{mailToolType}/{account}/{mailSaveFolder} | /eds/email/getEmailRecordInfo/{collectTargetId}/{mailToolType}/{account}/{mailSaveFolder} | 迁移 | 分页参数 page/limit | | 68 | 邮件 | GET | /electronic/email/getEmailRecordInfoByStat/{collectTargetId} | /eds/email/getEmailRecordInfoByStat/{collectTargetId} | 迁移 | 分页参数 page/limit | | 69 | 邮件 | GET | /electronic/email/getEmailSearchInfo/{collectTargetId}/{mailToolType}/{account} | /eds/email/getEmailSearchInfo/{collectTargetId}/{mailToolType}/{account} | 迁移 | 分页参数 page/limit | | 70 | 地理 | GET | /electronic/geography/getAccountInfo/{collectTargetId}/{browseType} | /eds/geography/getAccountInfo/{collectTargetId}/{browseType} | 迁移 | | | 71 | 地理 | GET | /electronic/geography/getGeographyLocation/{collectTargetId}/{browseType} | /eds/geography/getGeographyLocation/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 72 | 地理 | GET | /electronic/geography/getGeographyNavigation/{collectTargetId}/{browseType} | /eds/geography/getGeographyNavigation/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 73 | 地理 | GET | /electronic/geography/getGeographyFavorites/{collectTargetId}/{browseType} | /eds/geography/getGeographyFavorites/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 74 | 地理 | GET | /electronic/geography/getGeographySearch/{collectTargetId}/{browseType} | /eds/geography/getGeographySearch/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 75 | 地理 | GET | /electronic/geography/getHotelInfo/{collectTargetId}/{browseType} | /eds/geography/getHotelInfo/{collectTargetId}/{browseType} | 迁移 | 分页参数 page/limit | | 76 | 输入法 | POST | /electronic/inputMethod/getAccountInfo | /eds/inputMethod/getAccountInfo | 迁移 | | | 77 | 输入法 | POST | /electronic/inputMethod/getLexiconInfo | /eds/inputMethod/getLexiconInfo | 迁移 | 分页参数 page/limit | | 78 | 检材 | GET | /materialInfo/page | — | 不迁移 | 目标已有 GET /eds/list | | 79 | 检材 | GET | /materialInfo/getDirTree/{caseId}/{collectTargetId} | /eds/materialInfo/getDirTree/{collectTargetId} | 迁移 | 去掉 caseId | | 80 | 检材 | GET | /materialInfo/downloadFile?edsPath= | /eds/materialInfo/downloadFile?edsPath= | 迁移 | 仅校验文件存在 | | 81 | 检材 | DELETE | /materialInfo/{caseId}/{collectTargetId} | — | 不迁移 | 缺 excel_file/sksj/case_obj | | 82 | 检材 | GET | /materialInfo/getExtendFiles/{collectTargetId}/{type} | — | 不迁移 | 缺 wa_xly_091000/091100 | | 83 | 媒体 | GET | /electronic/media/getMediaType/{collectTargetId}/{mediaType} | /eds/media/getMediaType/{collectTargetId}/{mediaType} | 迁移 | 仅标准 eds_media_file | | 84 | 媒体 | GET | /electronic/media/getMediaDetail/{collectTargetId}/{mediaType} | /eds/media/getMediaDetail/{collectTargetId}/{mediaType} | 迁移 | 分页参数 page/limit;mediaPath/mediaSmallPath 用 mediaUrl | | 85 | 媒体 | POST | /electronic/media/isClassifyComplete/{collectTargetId} | — | 不迁移 | 分类标记未迁移 | | 86 | 媒体 | POST | /electronic/media/pictureClassificationQuery | — | 不迁移 | 缺 eds_classfic_picture | | 87 | 网络 | GET | /electronic/network/getAccountInfo/{collectTargetId}/{networkApp}/{account} | /eds/network/getAccountInfo/{collectTargetId}/{networkApp}/{account} | 迁移 | | | 88 | 网络 | GET | /electronic/network/getNetworkFile/{collectTargetId}/{networkApp}/{account} | /eds/network/getNetworkFile/{collectTargetId}/{networkApp}/{account} | 迁移 | 分页参数 page/limit | | 89 | 网络 | GET | /electronic/network/getNetworkRecordInfo/{collectTargetId}/{networkApp}/{account} | /eds/network/getNetworkRecordInfo/{collectTargetId}/{networkApp}/{account} | 迁移 | 分页参数 page/limit | | 90 | 社交应用 | GET | /electronic/socialApplication/account/{cid}/{type}/{account} | /eds/socialApplication/account/{cid}/{type}/{account} | 迁移 | | | 91 | 社交应用 | GET | /electronic/socialApplication/groupStat/{cid}/{type}/{account} | /eds/socialApplication/groupStat/{cid}/{type}/{account} | 迁移 | | | 92 | 社交应用 | GET | /electronic/socialApplication/groupFiendList/{cid}/{type}/{account} | /eds/socialApplication/groupFiendList/{cid}/{type}/{account} | 迁移 | 分页参数 page/limit | | 93 | 社交应用 | GET | /electronic/socialApplication/friendDetail/{cid}/{type}/{account}/{friendAccount} | /eds/socialApplication/friendDetail/{cid}/{type}/{account}/{friendAccount} | 迁移 | | | 94 | 社交应用 | GET | /electronic/socialApplication/blogGroupStat/{cid}/{type}/{account} | /eds/socialApplication/blogGroupStat/{cid}/{type}/{account} | 迁移 | | | 95 | 社交应用 | GET | /electronic/socialApplication/blogGroupFiendList/{cid}/{type}/{account} | /eds/socialApplication/blogGroupFiendList/{cid}/{type}/{account} | 迁移 | 分页参数 page/limit | | 96 | 社交应用 | GET | /electronic/socialApplication/blogList/{cid}/{type}/{account}/{friendAccount} | /eds/socialApplication/blogList/{cid}/{type}/{account}/{friendAccount} | 迁移 | 分页参数 page/limit | | 97 | 社交应用 | GET | /electronic/socialApplication/privateLetterGroupStat/{cid}/{type}/{account} | /eds/socialApplication/privateLetterGroupStat/{cid}/{type}/{account} | 迁移 | | | 98 | 社交应用 | GET | /electronic/socialApplication/privateLetterGroupFiendList/{cid}/{type}/{account} | /eds/socialApplication/privateLetterGroupFiendList/{cid}/{type}/{account} | 迁移 | 分页参数 page/limit | | 99 | 社交应用 | POST | /electronic/socialApplication/privateLetterDetail | /eds/socialApplication/privateLetterDetail | 迁移 | 分页参数 page/limit | | 100 | 社交应用 | GET | /electronic/socialApplication/searchRecord/{cid}/{type}/{account} | /eds/socialApplication/searchRecord/{cid}/{type}/{account} | 迁移 | 分页参数 page/limit | | 101 | 社会关系 | POST | /socialRelationship/mutualContext | /eds/socialRelationship/mutualContext | 迁移 | 分页参数 page/limit | | 102 | 社会关系 | POST | /socialRelationship/mutualInfoChange | /eds/socialRelationship/mutualInfoChange | 迁移 | 分页参数 page/limit;导出展开分支不迁移 | | 103 | 系统痕迹 | GET | /electronic/systemTrace/calendar/{cid} | /eds/systemTrace/calendar/{cid} | 迁移 | | | 104 | 系统痕迹 | GET | /electronic/systemTrace/alarmClock/{cid} | /eds/systemTrace/alarmClock/{cid} | 迁移 | repeat 字典翻译 | | 105 | 系统痕迹 | GET | /electronic/systemTrace/deviceConnectRecord/{cid} | /eds/systemTrace/deviceConnectRecord/{cid} | 迁移 | | | 106 | 系统痕迹 | GET | /electronic/systemTrace/usbConnectRecord/{cid} | /eds/systemTrace/usbConnectRecord/{cid} | 迁移 | | | 107 | 系统痕迹 | GET | /electronic/systemTrace/usbConnectRecordByStat/{cid} | /eds/systemTrace/usbConnectRecordByStat/{cid} | 迁移 | 分页参数 page/limit | | 108 | 系统痕迹 | GET | /electronic/systemTrace/bluetoothRecord/{cid} | /eds/systemTrace/bluetoothRecord/{cid} | 迁移 | bluetoothType 字典翻译 | | 109 | 系统痕迹 | GET | /electronic/systemTrace/wifiConnectRecord/{cid} | /eds/systemTrace/wifiConnectRecord/{cid} | 迁移 | encryptAlgorithm 字典翻译 | | 110 | 系统痕迹 | GET | /electronic/systemTrace/baseStationConnectRecord/{cid} | /eds/systemTrace/baseStationConnectRecord/{cid} | 迁移 | | | 111 | 系统痕迹 | GET | /electronic/systemTrace/accessFileRecord/{cid} | /eds/systemTrace/accessFileRecord/{cid} | 迁移 | 分页参数 page/limit | | 112 | 系统痕迹 | GET | /electronic/systemTrace/useSoftwareRecord/{cid} | /eds/systemTrace/useSoftwareRecord/{cid} | 迁移 | 分页参数 page/limit | **统计:迁移 100 个,不迁移 12 个。** ## 三、不迁移清单 | 原接口 | 原因 | 后续建议 | |---|---|---| | `GET /electronic/baseInfo/getRelevancyPage/{cid}` | `@Deprecated`;依赖 `bd_platform` 跨库;原实现 principal 类型不匹配会 NPE | 由平台案件关联功能替代 | | `GET /electronic/checkItem/getHitTargetType` | 目标库无 `wa_mforensics_777777` | 如需检查项,先补该表及 ETL | | `GET /electronic/checkItem/getCheckItemTree` | 同上 | 同上 | | `GET /electronic/checkItem/getCheckItemDetail` | 同上 | 同上 | | `POST /pices/test` | 依赖外部 `demo.exe/main.exe`、ES、`eds_classfic_picture` | 接入新的分类服务后单独实现 | | `POST /electronic/bankTrade/jinjiCount` | 目标库无 `eds_bank_trade` | 补银行交易派生表后实现 | | `POST /electronic/bankTrade/jinjiXinxi` | 同上 | 同上 | | `POST /electronic/media/isClassifyComplete/{collectTargetId}` | 依赖图片分类完成标记 | 分类链路迁移后实现 | | `POST /electronic/media/pictureClassificationQuery` | 依赖 `eds_classfic_picture` | 同上 | | `GET /materialInfo/page` | 目标已有 `GET /eds/list`(`eds_material_process`),语义不同 | 前端使用现有上传/进度列表 | | `DELETE /materialInfo/{caseId}/{collectTargetId}` | 依赖 `excel_file`/`sksj`/`case_obj`,目标删除策略未设计 | 后续单独设计数据包删除 | | `GET /materialInfo/getExtendFiles/{collectTargetId}/{type}` | 目标库无 `wa_xly_091000/091100` | 如需报告/镜像,先补表 | ## 四、前端改造要点 1. 请求地址按上表替换;不要忘记统一上下文 `/js/a`。 2. 响应成功判断从 `code === 200` 不变,但提示文案字段由 `msg` 改为 `message`。 3. 所有请求不再需要 `x-custom-header`;但必须先打开案件,否则后端返回 400「请先打开案件后再操作数据」。 4. 分页参数由 `current`/`size` 改为 `page`/`limit`;响应分页字段不变。 5. `getDirTree` 去掉路径中的 `{caseId}`。 6. `bankTrade/edsList` 去掉 `caseId` 参数。 7. 媒体详情:`mediaPath`/`mediaSmallPath` 使用后端返回的 `mediaUrl`(完整地址),其余字段不变。 8. 字典名称:后端已按 `eds_dict` 翻译;若字典尚未导入,会返回原始编码,前端可按编码兜底显示。 9. 导出按钮暂时不可用(`dataScope` 分支未迁移),后续单独补。 10. 好友详情:好友账号可能为空,空路径段会被容器归一化后 404;前端统一改用 `GET /eds/socialApplication/friendDetail/{cid}/{type}/{account}?friendAccount=&friendNickname=`, 后端同时兼容原 4 段路径,空账号按 `friend_account is null` 匹配,并可用好友昵称缩小范围。 ## 五、类名对照 | 旧类 | 新类 | |---|---| | `AccountController` / `AccountService` | `EdsAccountController` / `EdsAccountService` | | `BaseInfoController` / `IBaseInfoService` | `EdsBaseInfoController` / `EdsBaseInfoService` | | `BrowserController` / `BrowserService` | `EdsBrowserController` / `EdsBrowserService` | | `ChatController` / `ChatEdsService` | `EdsChatController` / `EdsChatService` | | `CommerceController` / `CommerceService` | `EdsCommerceController` / `EdsCommerceService` | | `ContactRecordController` / `ContactRecordService` | `EdsContactRecordController` / `EdsContactRecordService` | | `DataStatController` / `DataStatService` | `EdsDataStatController` / `EdsDataStatService` | | `EdsBankTradeController` / `EdsBankTradeService` | `EdsBankTradeController` / `EdsBankTradeService` | | `EdsGroupController` / `EdsGroupService` | `EdsGroupController` / `EdsGroupService` | | `EmailController` / `IEmailService` | `EdsEmailController` / `EdsEmailService` | | `GeographyController` / `GeographyService` | `EdsGeographyController` / `EdsGeographyService` | | `InputMethodController` / `InputMethodService` | `EdsInputMethodController` / `EdsInputMethodService` | | `MaterialInfoController` / `IMaterialInfoService` | `EdsMaterialInfoController` / `EdsMaterialInfoService` | | `MediaController` / `MediaService` | `EdsMediaController` / `EdsMediaService` | | `NetworkController` / `NetworkService` | `EdsNetworkController` / `EdsNetworkService` | | `SocialApplicationController` / `ISocialApplicationService` | `EdsSocialApplicationController` / `EdsSocialApplicationService` | | `SocialRelationshipController` / `SocialRelationshipService` | `EdsSocialRelationshipController` / `EdsSocialRelationshipService` | | `SystemTraceController` / `ISystemTraceService` | `EdsSystemTraceController` / `EdsSystemTraceService` | 命名规则:源 `*Dto` → `Eds*DTO`,源 `*Param` → `Eds*Query`,源 `*VO` → `Eds*VO`;查询 Mapper 统一 `Eds*QueryMapper`。 ## 六、后端落位 - Controller:`com.zsjz.ai.module.eds.controller`,统一 `/eds/**`。 - Service:`com.zsjz.ai.module.eds.service`,全部为具体 `@Service`,无接口层。 - Mapper/XML:`com.zsjz.ai.module.eds.mapper` + `ai-server/src/main/resources/mappers/eds/`。 - DTO/Query/VO:`com.zsjz.ai.module.eds.dto` / `.query` / `.vo`。 - 字典表:`sql/eds_dict.sql`(案件 DuckDB),`EdsDictStore` 按案件 ID 加载并缓存;未导入数据时名称回退原始编码。 ## 七、迁移中修复的问题 1. 媒体类型“全部”的数量由“分组个数”改为累加各后缀数量,避免总数偏小。 2. `downloadFile` 保持原下载语义:按前端传入路径读取,仅校验文件是否存在,不额外限制目录。 3. 操作记录动作类型、输入法删除状态/性别改为安全解析,脏数据回退“未知/未删除”。 4. 所有 `locate`、`LIKE` 拼接改为 `strpos`/`#{}` 参数化,消除 SQL 注入面。 5. 邮件、即时通信、社交应用的空分组与“默认分组”合并逻辑修正,避免分组丢失。 6. 社会关系上下文关键词为空时返回原文;空时间按未知时间兜底,避免 NPE。 7. 聊天动态分组保持数据库倒序,聊天详情分组保持时间正序。 8. 删除源项目中未调用的 ES/Feign/JobRunner/自定义媒体表/导出等死代码,不携带无用依赖。 9. 所有 SQL 适配 DuckDB:去案件字段、`coalesce`、`string_agg`、`strftime`、`try_cast`、`list_slice/string_split` 等。 ## 八、验证结果 - `mvn -pl ai-server -am clean compile` 通过。 - `EdsQuerySmokeTest` 在仓库演示案件库副本上逐条执行新增 Mapper 语句,全部通过。 - 新代码无 `com.xly`、`WebUtils`、旧 `R`、`x-custom-header` 引用;新 XML 无旧表名和 `case_id`。