Files
邹进 25c081fe60
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Failing after 8h37m36s
fix: 第1批 M2、M3、M16、M23 导入与展示类缺陷
- M2 批量换绑表头改为“平台登录账号”,只认手机号,细分格式、不存在、多匹配、非平台、已禁用失败原因
- M3 后台订单列表与详情返回 C 端在线购买的交易流水号、支付渠道、商户名称,详情新增全部支付单 payments
- M16 预警规则不再返回 real_data_mb,预警列表/详情新增 threshold_mb,导出末列追加“阈值流量(MB)”
- M23 设备导入 IMEI 必填,空 IMEI 行记为失败
- OpenSpec Change fix-august-iteration-follow-up-gaps:13/18,导入任务、导出任务的 Worker 端到端验证与前端/运营通知待部署后完成
2026-10-11 23:49:29 +09:00

3.3 KiB
Raw Permalink Blame History

Why

8-9 月迭代第 1 批中有四项导入与展示类缺陷,行为变化小、互不依赖:批量换绑业务员因只认用户名而整批失败;后台订单看不到 C 端在线购买的原始支付信息;真流量预警规则页显示的套餐额度与预警列表汇总口径对不上,且列表缺阈值对应流量;设备导入允许 IMEI 为空,产生的设备在 H5 设备卡列表、实名页报错。依据为《第1批-8-9月迭代缺陷修复技术方案》第 1、2、9、10 节。

本 Change 改写自 2026-09-29 的旧内容:原 M1(修改密码提示)、M4~M6(订单、IoT 卡、设备导出列)移到同属第 1 批的 fix-august-iteration-export-and-password-hints;原“业务员登录账号支持用户名或手机号”的方案作废,改为只认手机号。

What Changes

  • BREAKING 店铺负责人 CSV 导入的固定表头改为「店铺编码、操作类型、平台登录账号、备注」,旧表头整批失败。“平台登录账号”只接受手机号:格式不合法(须为 11 位数字)、不存在、匹配多个账号、不是平台用户、已禁用分别给出行级失败原因(M2)。
  • 后台订单列表与详情始终返回 third_party_trade_no、payment_channel、payment_merchant_name 三个字符串字段,只对个人客户用微信或支付宝支付、状态为已支付或已退款的套餐订单给值,其余为空串;订单详情新增 payments 数组,列出该订单全部支付单(任何状态),不含二维码、商户号、路由等敏感或内部字段(M3)。
  • BREAKING 真流量预警规则列表与详情不再返回 real_data_mb;预警列表、详情、导出新增 threshold_mb(阈值对应流量,按触发快照计算,口径含加油包),导出新列追加在最后一列;判定口径不变(M16)。
  • 设备导入中 IMEI 为空(含仅空白)的行记为失败,原因“设备IMEI(imei)不能为空”;只校验非空,不校验格式与唯一性(M23)。

Capabilities

New Capabilities

无。

Modified Capabilities

  • business-user-group:店铺负责人 CSV 导入表头改为“平台登录账号”、只认手机号,并细分行级失败原因。
  • order-refund-exchange:后台订单列表与详情返回 C 端在线购买的交易流水号、支付渠道、商户名称,详情返回全部支付单。
  • package-traffic-alert:规则不再返回套餐真流量额度;预警查询与导出增加阈值流量。
  • asset-device:设备导入 IMEI 必填。

Impact

  • 代码:internal/task/shop_business_owner_import.go、pkg/constants/shop_business_owner_import.go、internal/routes/business_user_group.go;internal/service/order/service.go 及订单 DTO、支付记录批量读取;internal/query/packagetrafficalert/、internal/model/dto/package_traffic_alert_dto.go、预警导出数据源;pkg/utils/excel.go、internal/routes/device.go。
  • 接口:后台订单列表与详情新增字段;预警规则接口删除 real_data_mb,测试环境前端须在同一次交付中去掉对该字段的使用;导入接口说明更新;重新生成接口文档。
  • 运营:批量换绑须改用新模板;设备导入文件须填 IMEI。
  • 不涉及数据库迁移、Redis 结构、第三方渠道调用,不改变预警判定与支付写入。