one-pipe-system/openspec/changes/update-asset-start-realname-validation-feedback/proposal.md

Change: 适配复机实名校验结果提示

Why

复机是否允许取决于运营商的实名能力和后端实名规则，不能以行业卡类别作为前端放行依据。当前复机失败不会向运营清晰呈现后端返回的中文业务原因，无法区分同为行业卡但实名能力不同的放行或拦截结果。

What Changes

• 复用资产信息页现有复机入口和确认框，继续调用 POST /api/admin/assets/{identifier}/start。
• 补齐复机成功响应类型，读取最新的 status、status_name、real_name_status、real_name_status_name。
• 复机提交期间禁用入口，避免重复提交。
• 复机被后端实名规则或其他业务规则拦截时，在当前复机操作上下文直接展示后端返回的中文业务原因，不以通用前端文案替代，也不只记录到控制台。
• 复机成功后重新拉取资产详情，以最新资产数据更新页面。
• 前端不得读取或根据 card_category 判断是否需要实名、是否允许复机，所有放行或拦截均以后端结果为准。

Impact

• Affected specs: asset-information
• Affected code:
  • src/types/api/asset.ts
  • src/api/modules/asset.ts
  • src/views/asset-management/asset-information/composables/useAssetOperations.ts
  • src/views/asset-management/asset-information/components/BasicInfoCard.vue
• API contract:
  • POST /api/admin/assets/{identifier}/start