changelog(v2): 导入模板示例行内嵌占位示例图(端点契约不变·前端无需改动) (PR #3790)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
这个提交包含在:
父节点
1da3b00fba
当前提交
38e1eaa76c
@ -0,0 +1,19 @@
|
|||||||
|
# 【模板优化·管理后台】车辆/司机导入模板示例行图片列内嵌占位示例图
|
||||||
|
|
||||||
|
> 服务:hl-fleet-service(8087/8187) | 分支:dev-v3 | PR:#3790 | 工单:#3789 | 已部署测试服并下载实测通过(2026-06-13)
|
||||||
|
> 背景:wx——「下载模板应该有示例图片」。导入模板末 8 列为内联图列(#3769 起支持格内插图),但下载下来的模板示例行(黄色「示例-」行)这些图列是空白格,用户不知道要往这些格里插图、也不知道插完长什么样。
|
||||||
|
|
||||||
|
## ⚠️ 关键说明(前端)
|
||||||
|
|
||||||
|
**前端无需任何改动。** 模板下载端点(`GET /admin/fleet/vehicles/import/template`、`GET /admin/fleet/drivers/import/template`)契约/响应类型/调用方式完全不变——只是后端生成的 .xlsx 内容更友好了:示例行的图片列现在各内嵌一张「占位示例图」。
|
||||||
|
|
||||||
|
## 改了什么
|
||||||
|
|
||||||
|
- **车辆模板**(20 列,末 8 图列:行驶证正面照/副页照/外观照/内饰照/保险单据照/年检单据照/营运证照/其他附件照):黄色示例行的这 8 个图列各内嵌一张占位示例图。
|
||||||
|
- **司机模板**(23 列,末 8 图列:身份证照/驾驶证照/肖像照/健康证照/培训证书照/荣誉奖励照/从业资格证照/其他附件照):同样内嵌。
|
||||||
|
- 占位图是一张通用「图片占位」图标(灰色边框 + 太阳 + 远山,无文字),提示用户「这一列要在格内插入对应证件照片,插完就是覆盖这张占位图的样子」。
|
||||||
|
- **解析行为零变化**:示例行整行仍由首列「示例-」前缀在导入时自动跳过,内嵌的占位图既不会被回导成数据、也不会被抽取入库(双重隔离);用户照常从下一行开始填真实数据、在图列格内插真实照片。
|
||||||
|
|
||||||
|
## 实测(测试服)
|
||||||
|
|
||||||
|
下载车辆/司机模板各得 8 张占位图,锚定在示例行(第 2 行)的图片列上;占位图视觉正常(无乱码)。端点契约不变,零 DDL、零路由、零新端点。
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户