Files
one-pipe-system/openspec/changes/update-asset-sync-status-trail/proposal.md
luo eddfd157ad
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 4m43s
feat: 资产同步状态与同步轨迹入口
2026-07-21 09:57:14 +08:00

33 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Change: 资产同步状态与同步轨迹入口
## Why
当前资产信息页虽保留了手动刷新能力和部分同步时间展示,但运营无法直观看到资产当前轮询策略、最近活跃情况及下次轮询时间,也没有可直接进入该资产同步轨迹的入口。
## What Changes
- 在资产信息页的卡和设备详情中新增同步状态区域,展示轮询启用状态、活跃级别、最后活跃时间、最后活跃场景和下次轮询时间。
- 复用 `GET /api/admin/assets/resolve/{identifier}` 的新增 `polling` 响应对象;无下次轮询时间时展示 `-`
- 保留现有手动刷新按钮及其接口契约,不新增第二个同步或刷新按钮。
- 新增“查看同步轨迹”入口,跳转全局审计外部集成页并带入当前资产的筛选参数。
- 同步轨迹由目标页面按立即、3分钟、5分钟连续结果展示本提案不改造全局审计外部集成页面本身。
-`rate_limited` 手动刷新结果仅展示本次失败,不展示自动退避倒计时。
## Impact
- Affected specs: `asset-information`
- Related active changes: `update-asset-realtime-sync-timestamps-display`(共享资产同步展示区域)
- Affected code:
- `src/types/api/asset.ts`
- `src/api/modules/asset.ts`
- `src/views/asset-management/asset-information/**`
- 资产信息页到全局审计外部集成页的路由跳转参数
- API contracts:
- `GET /api/admin/assets/resolve/{identifier}`
- `POST /api/admin/assets/{identifier}/refresh`(保持既有契约)
- `GET /api/admin/audit/integrations`(复用 `resource_type``resource_key``correlation_id` 查询参数)
- Out of scope:
- 全局审计外部集成页面自身的开发或改造
- 新增第二个同步或刷新按钮
- `rate_limited` 的自动退避倒计时展示