feat: 新增卡视角以及设备视角的实名同步时间,卡状态同步时间,流量同步时间

openspec/changes/update-asset-realtime-sync-timestamps-display/proposal.md

@@ -0,0 +1,40 @@
+# Change: 更新后台资产信息同步时间展示
+
+## Why
+
+当前后台“资产信息”页虽然已经展示卡状态、实名状态和部分实时信息，但还缺少运营判断数据新鲜度所需的三个时间字段：实名同步时间、卡状态同步时间、流量同步时间。
+
+- 卡资产的 `GET /api/admin/assets/:identifier/realtime-status` 已在顶层返回 `last_real_name_check_at`、`last_card_status_check_at`、`last_data_check_at`，但前端未展示。
+- 设备资产的同一接口会在 `cards` 列表中按绑定卡返回这三个字段；当前“设备实时信息”区块只消费 `device_realtime`，无法展示当前使用卡的同步时间。
+
+如果不补齐这三个字段，后台在卡页和设备页都无法快速确认上游同步是否及时，也不利于定位实名、停复机和流量状态的延迟问题。
+
+## What Changes
+
+- 更新后台“资产信息”的卡资产“卡信息”区域：
+  - 新增 `实名同步时间`，映射 `last_real_name_check_at`
+  - 新增 `卡状态同步时间`，映射 `last_card_status_check_at`
+  - 新增 `流量同步时间`，映射 `last_data_check_at`
+- 更新后台“资产信息”的设备资产“设备实时信息”区域：
+  - 直接读取设备实时接口 `data` 顶层的 `last_real_name_check_at`、`last_card_status_check_at`、`last_data_check_at`
+  - 当对应字段为空时，显示稳定占位内容
+- 更新前端资产实时状态契约和数据合并逻辑：
+  - 支持卡资产顶层这三个同步时间字段
+  - 支持设备绑定卡记录中的这三个同步时间字段
+  - 刷新后合并绑定卡实时数据时，不得丢失这三个字段
+
+## Impact
+
+- Affected specs:
+  - `asset-information`
+- Affected code:
+  - `src/types/api/asset.ts`
+  - `src/views/asset-management/asset-information/types.ts`
+  - `src/views/asset-management/asset-information/composables/useAssetInfo.ts`
+  - `src/views/asset-management/asset-information/components/BasicInfoCard.vue`
+- Dependencies:
+  - 与活跃变更 `update-admin-asset-device-signal-and-audit-logs` 共享 `asset-information` 能力和 `BasicInfoCard.vue` / `useAssetInfo.ts` 文件范围
+  - 与活跃变更 `update-order-upload-and-device-switch-mode` 共享设备实时信息区块
+  - 依赖后端继续按当前接口返回这三个时间字段，无需新增接口
+- Breaking changes:
+  - 无外部接口 breaking change；本次仅为前端展示契约和页面展示的增量调整

openspec/changes/update-asset-realtime-sync-timestamps-display/specs/asset-information/spec.md

@@ -0,0 +1,64 @@
+## ADDED Requirements
+
+### Requirement: Admin Asset Card Sync Timestamp Display
+
+The admin asset information view SHALL display realtime sync timestamps for card assets within the card information section.
+
+#### Scenario: Show card sync timestamps on card asset page
+
+- **GIVEN** 用户正在查看后台“资产信息”中的卡资产详情
+- **AND** `GET /api/admin/assets/:identifier/realtime-status` 或 `POST /api/admin/assets/:identifier/refresh` 返回了卡资产实时数据
+- **WHEN** 页面渲染“卡信息”区域或完成实时刷新后的状态更新
+- **THEN** 页面 MUST 显示 `实名同步时间`，并映射 `last_real_name_check_at`
+- **AND** 页面 MUST 显示 `卡状态同步时间`，并映射 `last_card_status_check_at`
+- **AND** 页面 MUST 显示 `流量同步时间`，并映射 `last_data_check_at`
+- **AND** 这三个字段的时间格式 MUST 与页面其他时间字段保持一致
+
+#### Scenario: Card sync timestamps show placeholders when unavailable
+
+- **GIVEN** 用户正在查看后台“资产信息”中的卡资产详情
+- **WHEN** 任一同步时间字段为 `null`、空字符串或接口未返回对应值
+- **THEN** 页面 MUST 保留对应字段标签
+- **AND** 页面 MUST 为该字段显示稳定的占位内容
+
+### Requirement: Admin Device Realtime Sync Timestamp Display
+
+The admin asset information view SHALL display device realtime sync timestamps from top-level realtime response fields within the device realtime information section for device assets.
+
+#### Scenario: Show device realtime sync timestamps in device realtime information
+
+- **GIVEN** 用户正在查看后台“资产信息”中的设备资产详情
+- **AND** `GET /api/admin/assets/:identifier/realtime-status` 或 `POST /api/admin/assets/:identifier/refresh` 返回了设备资产实时数据
+- **WHEN** 页面渲染“设备实时信息”区域或完成实时刷新后的状态更新
+- **THEN** 页面 MUST 显示 `实名同步时间`，并映射顶层 `last_real_name_check_at`
+- **AND** 页面 MUST 显示 `卡状态同步时间`，并映射顶层 `last_card_status_check_at`
+- **AND** 页面 MUST 显示 `流量同步时间`，并映射顶层 `last_data_check_at`
+- **AND** 页面 MUST NOT 要求这三个字段必须存在于 `device_realtime` 中才可展示
+
+#### Scenario: Device realtime section keeps stable placeholders when top-level timestamps are empty
+
+- **GIVEN** 用户正在查看后台“资产信息”中的设备资产详情
+- **WHEN** 顶层 `last_real_name_check_at`、`last_card_status_check_at`、`last_data_check_at` 中任一字段为空
+- **THEN** 页面 MUST 保留 `实名同步时间`、`卡状态同步时间`、`流量同步时间` 这三个字段标签
+- **AND** 页面 MUST 为缺失值显示稳定的占位内容
+
+### Requirement: Admin Asset Realtime Sync Timestamp Contract Compatibility
+
+The admin asset information integration SHALL accept and preserve additive sync timestamp fields from realtime responses for card assets and device bound cards.
+
+#### Scenario: Card realtime contract accepts additive sync timestamp fields
+
+- **GIVEN** `GET /api/admin/assets/:identifier/realtime-status` 或 `POST /api/admin/assets/:identifier/refresh` 返回卡资产实时数据
+- **WHEN** 前端解析实时状态响应
+- **THEN** 前端类型契约 MUST 支持顶层 `last_data_check_at`
+- **AND** 前端类型契约 MUST 支持顶层 `last_real_name_check_at`
+- **AND** 前端类型契约 MUST 支持顶层 `last_card_status_check_at`
+
+#### Scenario: Device bound-card merge preserves sync timestamp fields
+
+- **GIVEN** `GET /api/admin/assets/:identifier/realtime-status` 或 `POST /api/admin/assets/:identifier/refresh` 返回设备资产实时数据
+- **AND** `cards` 列表中的绑定卡记录包含 `last_data_check_at`、`last_real_name_check_at`、`last_card_status_check_at`
+- **WHEN** 前端将实时绑定卡数据与已有设备绑定卡状态合并
+- **THEN** 每条绑定卡记录 MUST 保留各自的三个同步时间字段
+- **AND** 绑定卡同步时间字段 MAY 被其他设备卡展示或后续状态使用
+- **AND** 合并过程 MUST NOT 因刷新而无故丢失已返回的同步时间值

openspec/changes/update-asset-realtime-sync-timestamps-display/tasks.md

@@ -0,0 +1,20 @@
+# Tasks: Update Asset Realtime Sync Timestamps Display
+
+## 1. Contract And State
+
+- [x] 1.1 扩展资产实时状态相关类型，支持卡资产顶层和设备绑定卡记录中的 `last_data_check_at`、`last_real_name_check_at`、`last_card_status_check_at`。
+- [x] 1.2 调整资产实时状态合并逻辑，确保设备绑定卡刷新后保留上述三个同步时间字段。
+- [x] 1.3 为设备页补充设备实时状态顶层同步时间的读取逻辑，避免“设备实时信息”仅依赖 `device_realtime`。
+
+## 2. UI Display
+
+- [x] 2.1 在卡资产“卡信息”区域新增 `实名同步时间`、`卡状态同步时间`、`流量同步时间` 三个展示项。
+- [x] 2.2 在设备资产“设备实时信息”区域新增同名三个展示项，并展示设备实时状态顶层返回的对应时间。
+- [x] 2.3 当字段为空或实时接口未返回对应值时，统一显示稳定占位内容。
+
+## 3. Verification
+
+- [ ] 3.1 验证卡资产 `GET /api/admin/assets/:identifier/realtime-status` 返回的三个同步时间可正确展示在“卡信息”区域。
+- [ ] 3.2 验证设备资产 `GET /api/admin/assets/:identifier/realtime-status` 返回的顶层三个同步时间可正确展示在“设备实时信息”区域。
+- [ ] 3.3 验证 `POST /api/admin/assets/:identifier/refresh` 后卡页和设备页的三个同步时间展示保持一致。
+- [x] 3.4 运行 `openspec validate update-asset-realtime-sync-timestamps-display --strict`。