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

@@ -15,7 +15,7 @@
**Non-Goals:**
- 不迁移 `real_name_status`,不删除 `first_realname_at`。
- 不为联通、电信做二次实名(无实名时间无法区分新旧)。
- 不为上游不返回 `archiveTime` 的卡做二次实名(无实名时间无法区分新旧)。
- 不重算已判定的沉默期套餐。
- 不改实名逆转阈值、停复机规则。
@@ -49,7 +49,7 @@
### 6. 二次实名执行
导入接口同步解析与校验(≤1000 行),逐卡独立事务执行清除;清除复用 `ApplyCardObservation` 的人工纠偏通道(Source=manual_override,置未实名)以保持实名变化事件、审计与停复机评估一致,并在同事务写 `tb_iot_card_realname` 的 pending 字段与历史。运营商是否支持按卡所属运营商 `carrier_type = CMCC` 判定(常量白名单,后续确认其他运营商返回时间后再放开);同时要求当前实名时间非空作为基准。
导入接口同步解析与校验(≤1000 行),逐卡独立事务执行清除;清除复用 `ApplyCardObservation` 的人工纠偏通道(Source=manual_override,置未实名)以保持实名变化事件、审计与停复机评估一致,并在同事务写 `tb_iot_card_realname` 的 pending 字段与历史。是否支持只看该卡 `upstream_realname_at` 是否非空(上游返回过 `archiveTime`),不按运营商写死;基准取 `upstream_realname_at`。
### 7. 权限与接口
@@ -58,7 +58,6 @@
## Risks / Trade-offs
- [仅抽样一个移动账户返回 `archiveTime`] → 白名单按运营商类型 CMCC;导入时额外要求卡当前实名时间来源为 upstream 或有上游最近返回时间,否则跳过并提示,避免对不返回时间的账户误清。
- [清除后实名管控账户会停机] → 用户已确认按普通未实名处理;测试环境网关只读,不会真实下发。
- [上游 `archiveTime` 时区或格式变化] → 解析失败视为空,不影响状态,日志告警。
- [迁移补录数据量大] → 分批插入、可重复执行。
@@ -70,8 +69,3 @@
2. 部署 api / worker:开始解析 `archiveTime` 并写当前记录与历史;沉默期与展示切换读取源。
3. 管理端前端上线实名记录与二次实名页面,分配权限 `iot_card:realname_reset`。
4. 回滚:回滚 api / worker 镜像即可恢复旧读取(`first_realname_at` 一直保留且仍按旧规则写入);新表可保留。
## Open Questions
- 其他移动账户是否都返回 `archiveTime`、联通 / 电信能否提供实名时间,需与网关确认;确认后扩充二次实名支持白名单。
- 上游对已实名过的卡是否仍能正常生成实名链接,需上线后用一张测试卡验证。