25c081fe60
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 8h37m36s
- 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 端到端验证与前端/运营通知待部署后完成
33 lines
3.3 KiB
Markdown
33 lines
3.3 KiB
Markdown
## 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 结构、第三方渠道调用，不改变预警判定与支付写入。
|