3.0 KiB
3.0 KiB
1. 数据模型与迁移
- 1.1 新增迁移:
tb_iot_card_realname(card_id 唯一)、tb_iot_card_realname_history(索引 card_id,id desc)、tb_iot_card_realname_reset_batch,含 down 迁移 - 1.2 新增 model 与常量(时间来源、变化类型、二次实名状态、权限码
iot_card:realname_reset),scan 结构显式 gorm column 标签 - 1.3 迁移补录:已实名且
first_realname_at非空的卡按 id 分批插入当前记录(migrated)与迁移历史,可重复执行;补测试验证幂等
2. 上游实名时间解析
- 2.1
RealnameStatusResp增加archiveTime,解析为北京时间*time.Time,null/空/格式错视为空;表驱动测试覆盖移动、联通、电信三种响应 - 2.2
RealnameObservation增加UpstreamRealnameAt,轮询、观测序列、手动刷新入口透传
3. 当前实名时间与历史
- 3.1 领域纯函数
DecideRealnameTime:上游优先 → 保持 → 首次读到;相同不写;未实名不写;二次实名新旧判定;表驱动测试覆盖 spec 全部场景 - 3.2
ApplyCardObservation事务内锁定 / 创建当前实名记录,按决定更新并追加历史;二次实名 pending 时拦截旧实名观测 - 3.3 集成测试:重复轮询不写历史、上游更正 migrated 时间、逆转后再实名不写历史
4. 沉默期与展示切换
- 4.1
packagesilence/resolve.go卡实名时间改取当前实名时间;已实名无时间时写当前记录(first_observed)并写历史,不再补写first_realname_at - 4.2 资产详情、卡列表、导出"实名时间"改取当前实名时间;设备聚合口径不变
- 4.3 新增
GET /api/admin/iot-cards/:id/realname-history分页查询,返回来源与变化类型中文名 - 4.4 回归测试:沉默期期内 / 截止后实名、已判定不重算
5. 二次实名
- 5.1 导入接口:解析 ICCID / 虚拟号 / IMEI(设备取全部绑定卡),逐行校验(不存在、未实名、运营商不支持、已在等待、无基准时间),形成批次与行结果
- 5.2 清除执行:每卡独立事务,经人工纠偏通道置未实名,写 pending 基准与清除历史;不改
first_realname_at、不回退套餐 - 5.3 撤销接口:等待中的卡恢复已实名与基准时间,写撤销历史
- 5.4 批次列表、详情接口;路由注册、文档生成器 DTO 与权限
- 5.5 测试:读到旧实名不覆盖、新实名完成、撤销、电信卡被跳过、设备展开为全部卡;确认 C 端接口无二次实名字段
6. 验证与部署
- 6.1
go build ./...、go vet、相关包测试通过 - 6.2 部署测试环境(网关只读保持开启),用 89860885192590574640 验证当前实名时间被更正为 2026-07-16 19:43:39 且只写一条历史
- 6.3 测试环境演练二次实名清除与撤销,确认 C 端显示未实名、无二次实名字样
- 6.4 更新
docs/前端对接说明(实名记录、二次实名接口与权限)