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

1.8 KiB
Raw Blame History

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_typeresource_keycorrelation_id 查询参数)
  • Out of scope:
    • 全局审计外部集成页面自身的开发或改造
    • 新增第二个同步或刷新按钮
    • rate_limited 的自动退避倒计时展示