Files
one-pipe-system/openspec/changes/add-asset-batch-realname-policy/proposal.md
luo 830476d49d
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 5m48s
H5实名购买顺序与后台批量配置
2026-07-21 16:13:40 +08:00

1.8 KiB

Change: 新增资产批量实名认证策略配置

Why

运营需要一次性为多个卡或设备配置实名认证顺序。现有后台仅支持单资产设置实名认证策略,无法满足列表多选后的批量配置需求。

What Changes

  • 在后台卡列表和设备列表分别增加“批量修改实名顺序”入口,基于当前勾选资产执行配置。
  • 批量配置弹框展示已选资产数量,并提供“无需实名”“先实名后购买”“先购买后实名”三种互斥策略。
  • 卡列表调用 POST /api/admin/iot-cards/batch-update-realname-policy;设备列表调用 POST /api/admin/devices/batch-update-realname-policy
  • 批量请求传递 asset_idsrealname_policy;前端限制单次提交至多 500 条,并在超限时阻止提交并明确提示。
  • 设备批量配置弹框提示“实际H5流程由设备策略决定”。
  • 后端批量接口按全成全败处理;前端在失败时展示明确的后端业务错误,成功后刷新当前列表。
  • 前端不根据资产类型、卡类型或其他字段自行覆盖或推导实名认证策略。
  • 本提案不包含任何 H5 初始化、购买流程或 effective_realname_policy 的处理。

Impact

  • Affected specs:
    • iot-card-management
    • device-management
  • Affected code:
    • src/api/modules/asset.ts 或对应卡、设备 API 模块
    • src/types/api/asset.ts 或对应卡、设备 API 类型
    • src/views/asset-management/iot-card-management/index.vue
    • src/views/asset-management/device-list/index.vue
  • API contracts:
    • POST /api/admin/iot-cards/batch-update-realname-policy
    • POST /api/admin/devices/batch-update-realname-policy
  • Out of scope:
    • H5 初始化返回字段和购买流程
    • 单资产实名认证策略设置接口 PATCH /api/admin/assets/{identifier}/realname-mode