Files
junhong_cmp_fiber/openspec/changes/add-realname-time-history/specs/card-realname-reset/spec.md

4.5 KiB
Raw Blame History

ADDED Requirements

Requirement: 二次实名批次导入

有 iot_card:realname_reset 权限的运营 SHALL 可导入二次实名名单(xlsx / csv,一列:ICCID、虚拟号或 IMEI,单批最多 1000 行),填写原因后提交形成一个二次实名批次。系统逐行解析:ICCID 直接定位卡;虚拟号或 IMEI 定位设备,取设备当前全部绑定卡。以下行 MUST 跳过并记录原因,不影响其他行:资产不存在、卡未实名、卡所属运营商不返回实名时间(不支持二次实名)、该卡从未读到过上游实名时间、卡已处于等待二次实名、卡当前实名时间为空(无法确定新旧基准)。批次记录导入文件、总条数、成功数、跳过数及每行结果、操作人与时间。

Scenario: 导入设备

  • WHEN 导入一台绑定 3 张移动已实名卡的设备 IMEI
  • THEN 3 张卡都进入等待二次实名

Scenario: 导入不支持的运营商

  • WHEN 名单中有一张电信已实名卡
  • THEN 该行跳过,原因"该运营商不返回实名时间,不支持二次实名",其他行照常处理

Requirement: 二次实名清除

批次中每张合格卡 SHALL 在独立事务内执行清除:将卡 real_name_status 置为未实名;当前实名记录的二次实名状态置为"等待二次实名",记录清除时间、所属批次与清除前实名时间(基准);当前实名时间置空;写一条"二次实名清除"历史;按现有实名状态变化流程发出实名变化事件。已激活的套餐 MUST NOT 回退;first_realname_at MUST NOT 修改。

Scenario: 清除后资产显示未实名

  • WHEN 卡(实名时间 07-16 19:43:39)被二次实名清除
  • THEN 卡显示未实名、实名时间为空,历史有一条清除记录(原 07-16 19:43:39 → 空),已生效套餐不受影响

Requirement: 二次实名新旧判定

卡处于等待二次实名时,读到"已实名"观测 SHALL 按上游实名时间判定:上游实名时间晚于基准时间 → 二次实名完成,卡置为已实名,当前实名时间取上游时间(来源 upstream),清除等待状态,写"二次实名完成"历史;上游实名时间不晚于基准时间、或未返回上游实名时间 → MUST NOT 改实名状态、MUST NOT 写当前实名时间与历史,仅更新最近检查时间。卡处于等待二次实名时读到未实名观测按现有逻辑处理(保持未实名)。

Scenario: 读到旧实名

  • WHEN 基准 07-16 19:43:39,清除后轮询返回 realStatus=true, archiveTime=2026-07-16 19:43:39
  • THEN 卡仍为未实名,不写历史

Scenario: 用户完成二次实名

  • WHEN 基准 07-16 19:43:39,用户 11-09 10:00 重新实名,轮询返回 archiveTime=2026-11-09 10:00:00
  • THEN 卡变为已实名,当前实名时间 11-09 10:00:00,写一条二次实名完成历史,触发现有实名后续流程(沉默期判定、激活等)

Requirement: 二次实名撤销

有 iot_card:realname_reset 权限的运营 SHALL 可对仍处于等待二次实名的卡撤销(单张或整批):卡恢复为已实名、当前实名时间恢复为基准时间,清除等待状态,写"二次实名撤销"历史。已完成二次实名的卡不能撤销。

Scenario: 导错撤销

  • WHEN 运营撤销一张等待二次实名的卡
  • THEN 卡恢复已实名、实名时间恢复为清除前时间

Requirement: C 端无感办理

C 端 MUST 按普通未实名卡展示等待二次实名的卡(显示"未实名"、正常发放实名链接),任何接口与页面 MUST NOT 出现"二次实名"相关字样或标记。

Scenario: 用户进入 C 端

  • WHEN 等待二次实名卡的用户进入 H5 首页
  • THEN 显示未实名,可点击去实名,与普通未实名卡一致

Requirement: 等待二次实名卡的停复机口径

等待二次实名的卡 SHALL 与普通未实名卡同等参与现有实名停复机判定:所属运营商账户开启实名管控且套餐有效时按现有逻辑停机。系统 MUST NOT 为二次实名新增停复机路径;enable_polling = false 的卡 MUST NOT 被任何入口停机或复机。测试环境网关只读开关保持开启。

Scenario: 实名管控账户下的二次实名卡

  • WHEN 卡所属账户开启实名管控、套餐有效,卡被二次实名清除
  • THEN 按现有未实名停机逻辑处理,与普通未实名卡一致

Scenario: 关闭轮询的卡

  • WHEN 被清除的卡 enable_polling = false
  • THEN 不发起任何停机或复机