From b2efe3bac8e7cf154028647496195ef21646f83c Mon Sep 17 00:00:00 2001 From: break Date: Thu, 23 Jul 2026 12:29:33 +0900 Subject: [PATCH] =?UTF-8?q?ur47issues=E5=88=9B=E5=BB=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../issues/01-保障设备当前绑卡唯一性.md | 12 ++++++++++++ .../02-建立限速gateway渠道适配与受控映射.md | 13 +++++++++++++ .../issues/03-提供统一资产手动限速接口与审计.md | 15 +++++++++++++++ .../issues/04-提供资产详情限速能力展示契约.md | 13 +++++++++++++ 4 files changed, 53 insertions(+) create mode 100644 .scratch/ur47-manual-card-speed-limit/issues/01-保障设备当前绑卡唯一性.md create mode 100644 .scratch/ur47-manual-card-speed-limit/issues/02-建立限速gateway渠道适配与受控映射.md create mode 100644 .scratch/ur47-manual-card-speed-limit/issues/03-提供统一资产手动限速接口与审计.md create mode 100644 .scratch/ur47-manual-card-speed-limit/issues/04-提供资产详情限速能力展示契约.md diff --git a/.scratch/ur47-manual-card-speed-limit/issues/01-保障设备当前绑卡唯一性.md b/.scratch/ur47-manual-card-speed-limit/issues/01-保障设备当前绑卡唯一性.md new file mode 100644 index 0000000..4c1a39a --- /dev/null +++ b/.scratch/ur47-manual-card-speed-limit/issues/01-保障设备当前绑卡唯一性.md @@ -0,0 +1,12 @@ +# 01 — 保障设备当前绑卡唯一性 + +**What to build:** 为设备当前有效绑卡建立可发布的数据完整性保障：发布前发现存量重复时中止并交由人工修复，发布后同一设备最多保留一条当前有效绑定，且不自动删除任何绑定事实。 + +**Blocked by:** None — can start immediately. + +**Status:** ready-for-agent + +- [ ] 迁移门禁能检测存量重复的当前有效绑定，并在发现异常时阻止发布而不改写数据。 +- [ ] PostgreSQL 部分唯一索引仅约束未软删除、有效且当前的绑定记录，且不引入外键。 +- [ ] 集成测试证明唯一绑定可写入，重复绑定被拒绝，软删除或非当前记录不受误伤。 + diff --git a/.scratch/ur47-manual-card-speed-limit/issues/02-建立限速gateway渠道适配与受控映射.md b/.scratch/ur47-manual-card-speed-limit/issues/02-建立限速gateway渠道适配与受控映射.md new file mode 100644 index 0000000..14bb691 --- /dev/null +++ b/.scratch/ur47-manual-card-speed-limit/issues/02-建立限速gateway渠道适配与受控映射.md @@ -0,0 +1,13 @@ +# 02 — 建立限速 Gateway 渠道适配与受控映射 + +**What to build:** 让中国电信和中国广电卡可按逻辑账号、运营商及稳定业务档位，安全解析出经核实的上游编码，并通过一次 `/flow-card/speedLimit` 调用得到规范化的成功、明确失败或结果未知结论；任何缺失或不支持的映射均在调用前拒绝。 + +**Blocked by:** None — can start immediately. + +**Status:** ready-for-agent + +- [ ] 渠道配置以非敏感逻辑账号、运营商和 `speed_level` 唯一解析编码；不得以凭据为映射键、回退默认编码或记录凭据。 +- [ ] Adapter 将卡号和编码封装为渠道所需请求，分别规范化明确成功、明确失败、格式异常、超时和连接中断。 +- [ ] 此操作每个请求最多产生一次上游调用尝试；网络结果不明必须返回未知，不能使用共享客户端的自动重试。 +- [ ] 假渠道契约测试覆盖请求包装、响应解析、映射缺失与敏感信息脱敏；生产发布前具备两家运营商真实账号映射及协议核实记录。 + diff --git a/.scratch/ur47-manual-card-speed-limit/issues/03-提供统一资产手动限速接口与审计.md b/.scratch/ur47-manual-card-speed-limit/issues/03-提供统一资产手动限速接口与审计.md new file mode 100644 index 0000000..901f412 --- /dev/null +++ b/.scratch/ur47-manual-card-speed-limit/issues/03-提供统一资产手动限速接口与审计.md @@ -0,0 +1,15 @@ +# 03 — 提供统一资产手动限速接口与审计 + +**What to build:** 后台人员可通过统一资产标识向卡或设备提交固定语义档位。卡直接使用自身 ICCID；设备仅可使用唯一当前有效绑卡的 ICCID。系统在上游调用前完成权限、资产、运营商和映射校验，并向前端返回可安全展示的操作结果及真实目标卡号。 + +**Blocked by:** 01 — 保障设备当前绑卡唯一性；02 — 建立限速 Gateway 渠道适配与受控映射。 + +**Status:** ready-for-agent + +- [ ] `POST /api/admin/assets/{identifier}/speed-limit` 仅接受十个约定的 `speed_level` 枚举；非法值不泄露校验细节，前端不能提交任意速率或上游编码。 +- [ ] 卡、设备、无当前卡、多当前卡、软删除绑定和越权资产均被正确处理，且渠道 `cardNo` 从不使用 IMEI、序列号或虚拟号。 +- [ ] 响应包含资产类型与 ID、实际 ICCID、语义档位、实际编码、`applied_speed` 和 `channel_raw_value`，且不得把目标描述成当前实际限速。 +- [ ] 每次成功、明确失败或未知尝试均留下以同一请求 ID 关联的 Integration Log 与 Audit Event；卡号、凭据和响应敏感字段均脱敏。 +- [ ] 中国联通、中国移动、未知运营商和缺失映射在调用前明确拒绝；旧设备限速路由及错误的 IMEI 渠道调用在同批发布中下线。 +- [ ] HTTP 集成测试穿过认证、权限、Application、假渠道及统一错误处理，覆盖成功、拒绝、明确失败和未知结果。 + diff --git a/.scratch/ur47-manual-card-speed-limit/issues/04-提供资产详情限速能力展示契约.md b/.scratch/ur47-manual-card-speed-limit/issues/04-提供资产详情限速能力展示契约.md new file mode 100644 index 0000000..ae905f3 --- /dev/null +++ b/.scratch/ur47-manual-card-speed-limit/issues/04-提供资产详情限速能力展示契约.md @@ -0,0 +1,13 @@ +# 04 — 提供资产详情限速能力展示契约 + +**What to build:** 卡和设备详情为前端提供可直接驱动“手动限速”交互的能力信息：是否支持、不可用的中文原因和可选择的语义档位；设备还提供本次操作实际作用的当前 ICCID。该数据只表达操作能力，不声称渠道当前实际限速。 + +**Blocked by:** 01 — 保障设备当前绑卡唯一性；02 — 建立限速 Gateway 渠道适配与受控映射。 + +**Status:** ready-for-agent + +- [ ] 卡、设备详情返回由后端权限、运营商、当前绑卡和映射共同判定的 `speed_limit_capability`。 +- [ ] 支持时返回固定业务档位及中文标签，供前端渲染和提交；不返回可编辑速率或渠道编码。 +- [ ] 不支持、无当前卡或映射缺失时返回可展示的中文原因，前端可据此禁用入口，但操作接口仍会独立重新校验。 +- [ ] 设备详情返回实际当前 ICCID，供前端在二次确认和未知结果提示中准确展示。 +- [ ] 接口契约与集成测试验证能力字段、当前 ICCID、权限过滤及“不展示当前实际限速”的语义。