七月迭代短暂完结,还有很多后端的关键东西没有弄,这是一版赶时间做的东西

docs/7月迭代/7月迭代禅道研发需求逐条录入稿.md

@@ -784,29 +784,28 @@
 **标题**
 
 ```text
-[FE][UR#47] 卡设备手动设置与取消限速
+[FE][UR#47] IoT 卡手动设置固定限速档位
 ```
 
 **描述**
 
 ```markdown
-目标：在卡和设备详情提供统一的手动限速入口，不展示自动限速规则。
+目标：仅在 IoT 卡详情提供手动固定档位限速入口，不展示自动限速规则。
 
 预计工时：前端1～2小时。
 
-页面入口：卡详情、设备详情。
+页面入口：IoT 卡详情；设备详情不提供限速入口。
 
 页面结构：
-1. “手动限速”弹框只展示后端返回的固定语义档位，不允许输入任意速率或上游code。
-2. “恢复不限速”提交speed_level=unlimited；“限到0kbps”提交speed_level=zero_kbps，两者严格区分。
-3. 设备详情必须显示本次实际作用的当前卡ICCID；无当前卡时禁用操作并展示原因。
-4. 不展示“Gateway当前实际限速”，除非接口未来明确返回查询结果。
+1. “手动限速”弹框只展示 `code=-1..8` 固定档位，不允许输入任意速率。
+2. “恢复不限速”提交 `code=-1`；“限到0kbps”提交 `code=0`，两者严格区分。
+3. 不展示“Gateway当前实际限速”，除非接口未来明确返回查询结果。
 
-接口约定：POST /api/admin/assets/{identifier}/speed-limit，body={speed_level:string}；返回asset_type、asset_identifier、card_no、speed_level、channel_code、applied_speed、channel_raw_value、result、message。
+接口约定：`PUT /api/admin/iot-cards/{iccid}/speed-tier`，`body={code:int}`；返回 `iot_card_id/iccid/code/speed_tier_name/integration_id`。
 
-交互规则：提交中禁用按钮；失败保留所选档位；中国电信/广电按后端能力展示，联通/移动或映射缺失时禁用并展示原因；结果未知不能显示成功。
+交互规则：提交中禁用按钮；失败保留所选档位；结果未知不能显示成功，并提示按 ICCID 核对 Gateway 实际档位。
 
-完成标准：卡限速、设备解析当前卡、取消限速和无当前卡四类场景完整。
+完成标准：卡固定档位、恢复不限速、越权卡、明确失败和结果未知场景完整；设备无入口。
 ```
 
 ### 后端研发需求
@@ -814,23 +813,23 @@
 **标题**
 
 ```text
-[BE][UR#47] Gateway按cardNo统一限速接口
+[BE][UR#47] Gateway按卡ICCID设置固定限速档位
 ```
 
 **描述**
 
 ```markdown
-目标：只开放一个手动限速接口，最终始终按卡ICCID调用Gateway。
+目标：只开放 IoT 卡手动限速接口，按卡 ICCID 调用 Gateway。
 
 预计工时：后端2～3小时。
 
-接口：POST /api/admin/assets/{identifier}/speed-limit，入参为固定语义枚举speed_level；恢复不限速与限到0kbps是不同值，前端和业务层不得接触渠道code。
+接口：`PUT /api/admin/iot-cards/{iccid}/speed-tier`，入参为固定整数档位 `code=-1..8`；恢复不限速与限到0kbps分别使用 `-1` 和 `0`。
 
-规则：资产为卡时读取ICCID；资产为设备时解析is_current=true的唯一有效当前卡；不存在或多条当前卡都拒绝；绝不把设备号传给Gateway。仅中国电信和中国广电直连POST /flow-card/speedLimit；Adapter按Gateway账号+运营商+speed_level映射code，缺失映射不猜测。外部副作用关闭自动重试，超时等结果不明记录unknown。
+规则：按 ICCID 查询 IoT 卡并沿用现有数据权限；只向 `POST /flow-card/speedLimit` 发送 `cardNo + code`。设备没有限速入口，也不得解析设备当前绑定卡间接调用。外部副作用关闭盲目自动重试，超时等结果不明记录 `unknown`。
 
 非目标：不建立套餐固定限速，不因激活、到期、停机或切卡自动限速，不增加自动补偿Worker。
 
-完成标准：返回最终card_no、语义档位和规范化调用结果；电信、广电、联通、移动、映射缺失、明确失败和结果未知均有正确行为；每次请求记录操作审计及Integration Log。
+完成标准：返回卡 ID、ICCID、固定档位和 Integration Log ID；明确失败和结果未知均有正确行为；每次请求记录操作审计及 Integration Log。
 ```
 
 ## UR#46 资产信息详情字段新增
@@ -1914,7 +1913,7 @@
 
 进入条件：统一限速接口、卡和设备详情入口、Gateway联调配置完成。
 
-联调范围：单卡固定speed_level、设备解析当前卡、恢复不限速与限到0kbps区分、设备无当前卡、电信/广电档位映射、联通/移动不支持、Gateway失败/结果未知及审计记录。
+联调范围：单卡固定 `code`、恢复不限速与限到0kbps区分、越权卡、Gateway 明确失败/结果未知及审计记录；确认设备端没有限速入口。
 
 完成标准：Gateway收到的cardNo始终为卡ICCID，设备号不会被发送，上游结果在页面和审计中可追踪。
 ```