From da8aedc96bf459b55ff180996dd8e2d28aca876a Mon Sep 17 00:00:00 2001 From: huang Date: Sat, 28 Mar 2026 13:42:29 +0800 Subject: [PATCH] docs(phase-03.1): evolve PROJECT.md after phase completion --- .planning/PROJECT.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 0959465..f07c0e3 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -14,6 +14,15 @@ *以下功能已在代码库中实现，视为已验证的基础能力：* +**Validated in Phase 03.1: 设备 sync-info 读取链路修复** +- ✓ 设备管理列表/详情返回 online_status/last_online_time/software_version/switch_mode/last_gateway_sync_at — DEVICE-02/03 +- ✓ 设备绑卡列表（ListBindings）返回 is_current 字段 — DEVICE-03 +- ✓ 资产 Resolve/Refresh BoundCardInfo 包含 is_current（isCurrentMap 模式） — DEVICE-03 +- ✓ admin 资产解析接口（AssetResolveResponse）返回 5 个 DB 缓存字段 — DEVICE-02/03 +- ✓ GetRealtimeStatus device 类型实时调用 Gateway sync-info，返回 DeviceGatewayInfo — DEVICE-04 +- ✓ C 端 GetAssetInfo device_realtime 从真实 Gateway 数据填充（删除 buildMockDeviceRealtime）— DEVICE-04 +- ✓ Gateway 失败降级：IMEI 为空不发起调用，失败只记 Warn，device_realtime 返回 null — DEVICE-04 + **Validated in Phase 2: PERM/FIN/REALNAME/POLL 修复** - ✓ 企业账号 Resolve 接口移除错误拦截，Refresh 接口新增拦截（只读）— PERM-01/02 - ✓ 提现审批人字段补全（approved_by/approved_at）— FIN-01 @@ -77,11 +86,12 @@ - [x] C-2：提现拒绝 remark 必填校验（Reject 缺少 Validate 调用） - [x] C-3：激活配置并发保护（两步 UPDATE 无锁，可出现两条 active=true） -**方案 D — 设备体系完善** ✅ *Validated in Phase 3* +**方案 D — 设备体系完善** ✅ *Validated in Phase 3 + Phase 03.1* - [x] D-0：设备模型字段扩展（online_status / last_online_time / software_version 等） - [x] D-1：Gateway sync-info 同步接口对接（CurrentIccid 预留结构待填充） - [x] D-2：device_sim_binding 新增 is_current 字段（当前使用卡标识） - [x] D-3：设备 Refresh + 详情接入 sync-info（在线状态/固件版本/当前卡实时更新） +- [x] D-读取侧：DTO 字段映射补全（5个DB缓存字段 + 2处IsCurrent）+ GetRealtimeStatus Gateway 实时调用 + C端 mock 替换 **方案 E — 流量体系改革（破坏性，低峰期）** - [ ] E-1：流量详单改为日粒度缓冲（新建 tb_card_daily_usage，Redis 增量缓存） @@ -157,7 +167,7 @@ | 流量体系改革独立发布 | 破坏性变更（DB 迁移 + Redis 架构），风险隔离 | — Pending | --- -*Last updated: 2026-03-28 after Phase 3 (device-system) completion — DEVICE-01/02/03/04 all validated* +*Last updated: 2026-03-28 after Phase 03.1 (sync-info-phase-3-dto) completion — device reading-side gap fully closed* ## Evolution