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

1.9 KiB
Raw Blame History

Change: 调整资产同步状态与同步轨迹入口

Why

运营需要通过统一审计查看资产业务事件、运营商回调和周期轮询的同步轨迹。新需求明确资产信息页只保留已有手动刷新和轮询展示,不新增用于推断轮询计划的状态字段。

What Changes

  • 保留卡和设备资产信息页现有的手动刷新按钮、接口契约和轮询状态展示,不新增第二个同步或刷新按钮。
  • 不展示活跃级别、最后活跃场景或下次轮询时间,也不根据事件轨迹推算新的周期轮询时间。
  • 增加“查看同步轨迹”入口,跳转全局审计外部集成页并带入当前资产的 resource_typeresource_key 筛选参数。
  • 约定审计查询支持 resource_typeresource_keycorrelation_id以供目标页连续展示立即、3分钟、5分钟的同步结果以及运营商回调和周期轮询的 Integration Log。
  • rate_limited 手动刷新结果仅展示本次失败,不展示自动退避倒计时。
  • 全局审计外部集成页面自身暂不在本提案中开发或改造。

Impact

  • Affected specs: asset-information
  • Related active changes: update-asset-realtime-sync-timestamps-display(共享资产同步信息展示)
  • Affected code:
    • src/views/asset-management/asset-information/components/BasicInfoCard.vue
    • src/views/asset-management/asset-information/index.vue
    • 资产信息页到全局审计外部集成页的路由跳转参数
  • API contracts:
    • POST /api/admin/assets/{identifier}/refresh(保持既有契约)
    • GET /api/admin/audit/integrations(复用 resource_typeresource_keycorrelation_id 查询参数)
  • Out of scope:
    • 全局审计外部集成页面自身的开发或改造
    • 审计轨迹结果页的加载、空记录和失败状态界面实现
    • 新增轮询活跃级别、最后活跃场景、下次轮询时间或自动退避倒计时展示