docs: 实名时间以 archiveTime 为准,二次实名按是否返回 archiveTime 判定

This commit is contained in:
邹进
2026-11-08 18:47:52 +09:00
parent 76d0f38b9e
commit 94f86ab217
5 changed files with 11 additions and 17 deletions

View File

@@ -2,7 +2,7 @@
### Requirement: 二次实名批次导入
有 `iot_card:realname_reset` 权限的运营 SHALL 可导入二次实名名单(xlsx / csv,一列:ICCID、虚拟号或 IMEI,单批最多 1000 行),填写原因后提交形成一个二次实名批次。系统逐行解析:ICCID 直接定位卡;虚拟号或 IMEI 定位设备,取设备当前全部绑定卡。以下行 MUST 跳过并记录原因,不影响其他行:资产不存在、卡未实名、卡所属运营商不返回实名时间(不支持二次实名)、该卡从未读到过上游实名时间、卡已处于等待二次实名、卡当前实名时间为空(无法确定新旧基准)。批次记录导入文件、总条数、成功数、跳过数及每行结果、操作人与时间。
有 `iot_card:realname_reset` 权限的运营 SHALL 可导入二次实名名单(xlsx / csv,一列:ICCID、虚拟号或 IMEI,单批最多 1000 行),填写原因后提交形成一个二次实名批次。系统逐行解析:ICCID 直接定位卡;虚拟号或 IMEI 定位设备,取设备当前全部绑定卡。以下行 MUST 跳过并记录原因,不影响其他行:资产不存在、卡未实名、该卡上游从未返回过实名时间 `archiveTime`(无法区分新旧实名,不支持二次实名)、卡已处于等待二次实名。是否支持只以上游是否返回过 `archiveTime` 为准,不按运营商写死。批次记录导入文件、总条数、成功数、跳过数及每行结果、操作人与时间。
#### Scenario: 导入设备
@@ -11,8 +11,8 @@
#### Scenario: 导入不支持的运营商
- **WHEN** 名单中有一张电信已实名卡
- **THEN** 该行跳过,原因"该运营商不返回实名时间,不支持二次实名",其他行照常处理
- **WHEN** 名单中有一张上游从未返回过 `archiveTime` 的已实名卡
- **THEN** 该行跳过,原因"上游未返回实名时间,不支持二次实名",其他行照常处理
### Requirement: 二次实名清除
@@ -25,7 +25,7 @@
### Requirement: 二次实名新旧判定
卡处于等待二次实名时,读到"已实名"观测 SHALL 按上游实名时间判定:上游实名时间晚于基准时间 → 二次实名完成,卡置为已实名,当前实名时间取上游时间(来源 upstream),清除等待状态,写"二次实名完成"历史;上游实名时间不晚于基准时间、或未返回上游实名时间 → MUST NOT 改实名状态、MUST NOT 写当前实名时间与历史,仅更新最近检查时间。卡处于等待二次实名时读到未实名观测按现有逻辑处理(保持未实名)。
卡处于等待二次实名时,读到"已实名"观测 SHALL 以上游 `archiveTime` 为准判定:上游实名时间晚于基准时间(清除前的上游实名时间) → 二次实名完成,卡置为已实名,当前实名时间取上游时间(来源 upstream),清除等待状态,写"二次实名完成"历史;上游实名时间不晚于基准时间、或未返回上游实名时间 → MUST NOT 改实名状态、MUST NOT 写当前实名时间与历史,仅更新最近检查时间。卡处于等待二次实名时读到未实名观测按现有逻辑处理(保持未实名)。
#### Scenario: 读到旧实名