幸福家园-提Bug

提Bug

所属产品

所属模块

影响版本

所有

当前指派

加载所有

截止日期

Bug标题

Bug类型

严重程度

优先级

重现步骤

[步骤]车辆管理需要新增批量导入/导出功能，后端功能接口已经实现，前端进行对接即可<img src="/zentao/file-read-8949.png" alt="file-read-8949.png" /><img src="/zentao/file-read-8950.png" alt="file-read-8950.png" />[前端对接方案] 接口链路 1. 前置检查 GET /parking/vehicle/initial-import/pre-check?communityId=xxx 用途：打开导入弹窗时调用。展示车场、默认收费规则、网关配置等检查结果。 如果返回有 ERROR 且 passed=false，不允许继续导入。 2. 下载模板 GET /parking/vehicle/initial-import/template?communityId=xxx 用途：下载 原始车辆导入模板.xlsx。 模板里包含车场、收费标准、车位参考页。 3. 上传解析 POST /parking/vehicle/initial-import/parse Content-Type: multipart/form-data file=Excel文件 communityId=xxx 用途：选择 Excel 后上传解析。 返回预览结果：总数、通过数、警告数、错误数、每行校验信息。 4. 预览后再校验 POST /parking/vehicle/initial-import/validate 请求体： { "communityId": 203, "rowList": [ { "rowNum": 2, "plateNo": "粤B12345", "vehicleTypeName": "业主车", "ownerName": "张三", "roomFullName": "1-1-101", "ownerPhone": "13800000000", "lotName": "易停空间", "feeStandardName": "月租规则", "spaceNo": "A-001", "validityStart": "2026-06-01", "validityEnd": "2027-05-31", "remark": "" } ] } 用途：前端允许用户在预览表格里修正数据后，重新校验。 5. 确认导入 POST /parking/vehicle/initial-import/confirm 请求体： { "communityId": 203, "batchNo": "IMPORT-VEHICLE-20260608-XXXX", "rowList": [] } rowList 传当前预览表格里最终确认的数据。 如果还有错误行，后端会拒绝导入。确认后会入库、写导入日志，并触发下发。 页面建议 按钮入口放在车辆管理页： - 新增车辆 - 登记访客 - 批量导入 - 批量下发 - 加入黑名单 导入弹窗建议分 4 步： 1. 前置检查 2. 下载模板 3. 上传解析 4. 预览确认 预览表格字段： - 行号 - 车牌号 - 车辆类型 - 业主姓名 - 房屋全称 - 联系电话 - 所属车场 - 收费标准 - 绑定车位 - 有效期起 - 有效期止 - 状态：PASS / WARN / ERROR - 错误/警告说明 展示规则： - ERROR 行红色，不允许确认导入。 - WARN 行黄色，可以确认，但要提示用户确认。 - PASS 行正常。 - 确认导入按钮：errorCount > 0 时禁用。 前端 API 封装建议 export const parkingVehicleInitialImportApi = { preCheck: (communityId) => getRequest('/parking/vehicle/initial-import/pre-check', { communityId }), downloadTemplate: (communityId) => getDownload('/parking/vehicle/initial-import/template', { communityId }, '原始车辆导入模板.xlsx'), parse: (formData) => postRequest('/parking/vehicle/initial-import/parse', formData), validate: (param) => postRequest('/parking/vehicle/initial-import/validate', param), confirm: (param) => postRequest('/parking/vehicle/initial-import/confirm', param), }; 注意：parse 是 multipart/form-data，需要带 file 和 communityId。 旧接口处理 /parking/vehicle/import 不建议继续接。 前端新停车车辆管理页面只接 initial-import，老接口最多保留在接口文档里标记“废弃”。[期望]

附件

所属项目

所属执行

所属计划

来源用例