Files
junhong_cmp_fiber/openspec/changes/add-realname-time-history/tasks.md

3.0 KiB
Raw Blame History

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/ 前端对接说明(实名记录、二次实名接口与权限)